@enact/ui
Version:
A collection of simplified unstyled cross-platform UI components for Enact
181 lines (179 loc) • 9.5 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", {
value: true
});
exports["default"] = exports.ResolutionDecorator = void 0;
var _react = require("react");
var _propTypes = _interopRequireDefault(require("prop-types"));
var _hoc = _interopRequireDefault(require("@enact/core/hoc"));
var _resolution = require("./resolution");
var _jsxRuntime = require("react/jsx-runtime");
function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
function _classCallCheck(a, n) { if (!(a instanceof n)) throw new TypeError("Cannot call a class as a function"); }
function _defineProperties(e, r) { for (var t = 0; t < r.length; t++) { var o = r[t]; o.enumerable = o.enumerable || !1, o.configurable = !0, "value" in o && (o.writable = !0), Object.defineProperty(e, _toPropertyKey(o.key), o); } }
function _createClass(e, r, t) { return r && _defineProperties(e.prototype, r), t && _defineProperties(e, t), Object.defineProperty(e, "prototype", { writable: !1 }), e; }
function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
function _possibleConstructorReturn(t, e) { if (e && ("object" == typeof e || "function" == typeof e)) return e; if (void 0 !== e) throw new TypeError("Derived constructors may only return object or undefined"); return _assertThisInitialized(t); }
function _assertThisInitialized(e) { if (void 0 === e) throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); return e; }
function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
function _getPrototypeOf(t) { return _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function (t) { return t.__proto__ || Object.getPrototypeOf(t); }, _getPrototypeOf(t); }
function _inherits(t, e) { if ("function" != typeof e && null !== e) throw new TypeError("Super expression must either be null or a function"); t.prototype = Object.create(e && e.prototype, { constructor: { value: t, writable: !0, configurable: !0 } }), Object.defineProperty(t, "prototype", { writable: !1 }), e && _setPrototypeOf(t, e); }
function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); } /*
* Exports the {@link ui/resolution.ResolutionDecorator} higher-order component (HOC).
*
* not jsdoc module on purpose
*/ /**
* Default config for `ResolutionDecorator`.
*
* @memberof ui/resolution.ResolutionDecorator
* @hocconfig
*/
var defaultConfig = {
/**
* Attaches an event listener to the window to listen for resize events.
*
* @type {Boolean}
* @default true
* @public
* @memberof ui/resolution.ResolutionDecorator.defaultConfig
*/
dynamic: true,
/**
* Determines how to calculate font-size.
* When set to `scale` and the screen is in `landscape` orientation,
* calculates font-size linearly based on screen resolution.
* When set to `normal`, the font-size will be the pxPerRem value of the best match screen type.
*
* @type {('normal'|'scale')}
* @default 'normal'
* @private
* @memberof ui/resolution.ResolutionDecorator.defaultConfig
*/
intermediateScreenHandling: 'normal',
/**
* Determines how to get the best match screen type of current resolution.
* When set to `true`, the matched screen type will be the one that is smaller and
* the closest to the screen resolution.
* When set to `false`, the matched screen type will be the one that is greater and
* the closest to the screen resolution.
*
* @type {Boolean}
* @private
* @memberof ui/resolution.ResolutionDecorator.defaultConfig
*/
matchSmallerScreenType: false,
/**
* An array of objects containing declarations for screen types to add to the list of known
* screen types.
*
* @type {Object[]}
* @default null
* @public
* @memberof ui/resolution.ResolutionDecorator.defaultConfig
*/
screenTypes: null
};
/**
* A higher-order component that configures resolution support for its wrapped component tree.
*
* Configuration options:
* * `dynamic: true` - when `true`, updates the resolution classes when the window resizes
* * `screenTypes: null` - defines a set of screen types to support
*
* Example:
* ```
* // Will have the resolution classes and will be updated when the window resizes
* const AppWithResolution = ResolutionDecorator(App);
* // Will have the resolution classes for the screen at the time of render only
* const AppWithStaticResolution = ResolutionDecorator({dynamic: false}, App);
* const AppWithScreenTypes = ResolutionDecorator({screenTypes: [
* {name: 'hd', pxPerRem: 16, width: 1280, height: 720, aspectRatioName: 'hdtv', base: true}
* ]}, App);
* ```
* @class ResolutionDecorator
* @memberof ui/resolution
* @hoc
* @public
*/
var ResolutionDecorator = exports.ResolutionDecorator = (0, _hoc["default"])(defaultConfig, function (config, Wrapped) {
var _Class;
if (config.screenTypes) {
(0, _resolution.defineScreenTypes)(config.screenTypes);
}
return _Class = /*#__PURE__*/function (_Component) {
function _Class(props) {
var _this;
_classCallCheck(this, _Class);
_this = _callSuper(this, _Class, [props]);
_this.handleResize = function () {
var classNames = _this.didClassesChange();
if (classNames) {
_this.setState({
resolutionClasses: classNames
});
}
};
_resolution.config.intermediateScreenHandling = config.intermediateScreenHandling;
_resolution.config.matchSmallerScreenType = config.matchSmallerScreenType;
(0, _resolution.init)({
measurementNode: typeof window !== 'undefined' && window
});
_this.state = {
resolutionClasses: ''
};
return _this;
}
_inherits(_Class, _Component);
return _createClass(_Class, [{
key: "componentDidMount",
value: function componentDidMount() {
var _document$getElements;
if (config.dynamic) window.addEventListener('resize', this.handleResize);
this.rootNode = ((_document$getElements = document.getElementsByClassName((0, _resolution.getResolutionClasses)())) === null || _document$getElements === void 0 ? void 0 : _document$getElements[0]) || null;
}
}, {
key: "componentWillUnmount",
value: function componentWillUnmount() {
if (config.dynamic) window.removeEventListener('resize', this.handleResize);
}
}, {
key: "didClassesChange",
value:
/*
* Compare our current version of the resolved resolution class names with a fresh
* initialization of RI.
*
* @returns {String|undefined} A string of new class names or undefined when there is no change.
* @private
*/
function didClassesChange() {
var prevClassNames = (0, _resolution.getResolutionClasses)();
(0, _resolution.init)({
measurementNode: this.rootNode
});
var classNames = (0, _resolution.getResolutionClasses)();
if (prevClassNames !== classNames) {
return classNames;
}
}
}, {
key: "render",
value: function render() {
// Check if the classes are different from our previous classes
var classes = (0, _resolution.getResolutionClasses)();
if (this.props.className) classes += (classes ? ' ' : '') + this.props.className;
return /*#__PURE__*/(0, _jsxRuntime.jsx)(Wrapped, _objectSpread(_objectSpread({}, this.props), {}, {
className: classes
}));
}
}]);
}(_react.Component), _Class.displayName = 'ResolutionDecorator', _Class.propTypes = /** @lends ui/resolution.ResolutionDecorator.prototype */{
className: _propTypes["default"].string
}, _Class;
});
var _default = exports["default"] = ResolutionDecorator;