@enact/ui
Version:
A collection of simplified unstyled cross-platform UI components for Enact
276 lines (271 loc) • 9.45 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.Scroller = void 0;
Object.defineProperty(exports, "ScrollerBasic", {
enumerable: true,
get: function get() {
return _ScrollerBasic["default"];
}
});
exports["default"] = void 0;
var _util = require("@enact/core/util");
var _propTypes = _interopRequireDefault(require("prop-types"));
var _Resizable = require("../Resizable");
var _useScroll2 = _interopRequireDefault(require("../useScroll"));
var _Scrollbar = _interopRequireDefault(require("../useScroll/Scrollbar"));
var _ScrollerBasic = _interopRequireDefault(require("./ScrollerBasic"));
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 _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); } /**
* Unstyled scroller components and behaviors to be customized by a theme or application.
*
* @module ui/Scroller
* @exports Scroller
* @exports ScrollerBasic
*/
var nop = function nop() {};
var scrollerDefaultProps = {
cbScrollTo: nop,
direction: 'both',
horizontalScrollbar: 'auto',
noScrollByDrag: false,
noScrollByWheel: false,
onScroll: nop,
onScrollStart: nop,
onScrollStop: nop,
overscrollEffectOn: {
drag: false,
pageKey: false,
wheel: false
},
scrollMode: 'translate',
verticalScrollbar: 'auto'
};
/**
* An unstyled scroller.
*
* Example:
* ```
* <Scroller>Scroll me.</Scroller>
* ```
*
* @class Scroller
* @memberof ui/Scroller
* @extends ui/Scroller.ScrollerBasic
* @ui
* @public
*/
var Scroller = exports.Scroller = function Scroller(props) {
// Hooks
var scrollerProps = (0, _util.setDefaultProps)(props, scrollerDefaultProps);
var _useScroll = (0, _useScroll2["default"])(scrollerProps),
scrollContentHandle = _useScroll.scrollContentHandle,
ScrollContentWrapper = _useScroll.scrollContentWrapper,
isHorizontalScrollbarVisible = _useScroll.isHorizontalScrollbarVisible,
isVerticalScrollbarVisible = _useScroll.isVerticalScrollbarVisible,
resizeContextProps = _useScroll.resizeContextProps,
scrollContainerProps = _useScroll.scrollContainerProps,
scrollInnerContainerProps = _useScroll.scrollInnerContainerProps,
scrollContentWrapperProps = _useScroll.scrollContentWrapperProps,
scrollContentProps = _useScroll.scrollContentProps,
verticalScrollbarProps = _useScroll.verticalScrollbarProps,
horizontalScrollbarProps = _useScroll.horizontalScrollbarProps;
// Return
return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Resizable.ResizeContext, _objectSpread(_objectSpread({}, resizeContextProps), {}, {
children: /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", _objectSpread(_objectSpread({}, scrollContainerProps), {}, {
children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)("div", _objectSpread(_objectSpread({}, scrollInnerContainerProps), {}, {
children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(ScrollContentWrapper, _objectSpread(_objectSpread({}, scrollContentWrapperProps), {}, {
children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ScrollerBasic["default"], _objectSpread(_objectSpread({}, scrollContentProps), {}, {
ref: scrollContentHandle
}))
})), isVerticalScrollbarVisible ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Scrollbar["default"], _objectSpread({}, verticalScrollbarProps)) : null]
})), isHorizontalScrollbarVisible ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Scrollbar["default"], _objectSpread({}, horizontalScrollbarProps)) : null]
}))
}));
};
Scroller.displayName = 'ui:Scroller';
Scroller.propTypes = /** @lends ui/Scroller.Scroller.prototype */{
/**
* A callback function that receives a reference to the `scrollTo` feature.
*
* Once received, the `scrollTo` method can be called as an imperative interface.
*
* - {position: {x, y}} - Pixel value for x and/or y position
* - {align} - Where the scroll area should be aligned. Values are:
* `'left'`, `'right'`, `'top'`, `'bottom'`,
* `'topleft'`, `'topright'`, `'bottomleft'`, and `'bottomright'`.
* - {node} - Node to scroll into view
* - {animate} - When `true`, scroll occurs with animation. When `false`, no
* animation occurs.
* - {focus} - When `true`, attempts to focus item after scroll. Only valid when scrolling
* by `node`.
* > Note: Only specify one of: `position`, `align`, `node`
*
* Example:
* ```
* // If you set cbScrollTo prop like below;
* cbScrollTo: (fn) => {this.scrollTo = fn;}
* // You can simply call like below;
* this.scrollTo({align: 'top'}); // scroll to the top
* ```
*
* @type {Function}
* @public
*/
cbScrollTo: _propTypes["default"].func,
/**
* Direction of the scroller.
*
* Valid values are:
* * `'both'`,
* * `'horizontal'`, and
* * `'vertical'`.
*
* @type {String}
* @default 'both'
* @public
*/
direction: _propTypes["default"].string,
/**
* Specifies how to show horizontal scrollbar.
*
* Valid values are:
* * `'auto'`,
* * `'visible'`, and
* * `'hidden'`.
*
* @type {String}
* @default 'auto'
* @public
*/
horizontalScrollbar: _propTypes["default"].oneOf(['auto', 'visible', 'hidden']),
/**
* Prevents scroll by dragging or flicking on the scroller.
*
* @type {Boolean}
* @default false
* @private
*/
noScrollByDrag: _propTypes["default"].bool,
/**
* Prevents scroll by wheeling on the scroller.
*
* @type {Boolean}
* @default false
* @public
*/
noScrollByWheel: _propTypes["default"].bool,
/**
* Called when scrolling.
*
* Passes `scrollLeft`, `scrollTop`.
* It is not recommended to set this prop since it can cause performance degradation.
* Use `onScrollStart` or `onScrollStop` instead.
*
* @type {Function}
* @param {Object} event
* @param {Number} event.scrollLeft Scroll left value.
* @param {Number} event.scrollTop Scroll top value.
* @public
*/
onScroll: _propTypes["default"].func,
/**
* Called when scroll starts.
*
* Passes `scrollLeft` and `scrollTop`.
*
* Example:
* ```
* onScrollStart = ({scrollLeft, scrollTop}) => {
* // do something with scrollLeft and scrollTop
* }
*
* render = () => (
* <Scroller
* ...
* onScrollStart={this.onScrollStart}
* ...
* />
* )
* ```
*
* @type {Function}
* @param {Object} event
* @param {Number} event.scrollLeft Scroll left value.
* @param {Number} event.scrollTop Scroll top value.
* @public
*/
onScrollStart: _propTypes["default"].func,
/**
* Called when scroll stops.
*
* Passes `scrollLeft` and `scrollTop`.
*
* Example:
* ```
* onScrollStop = ({scrollLeft, scrollTop}) => {
* // do something with scrollLeft and scrollTop
* }
*
* render = () => (
* <Scroller
* ...
* onScrollStop={this.onScrollStop}
* ...
* />
* )
* ```
*
* @type {Function}
* @param {Object} event
* @param {Number} event.scrollLeft Scroll left value.
* @param {Number} event.scrollTop Scroll top value.
* @public
*/
onScrollStop: _propTypes["default"].func,
/**
* Specifies overscroll effects shows on which type of inputs.
*
* @type {Object}
* @default {drag: false, pageKey: false, wheel: false}
* @private
*/
overscrollEffectOn: _propTypes["default"].shape({
drag: _propTypes["default"].bool,
pageKey: _propTypes["default"].bool,
wheel: _propTypes["default"].bool
}),
/**
* Specifies how to scroll.
*
* Valid values are:
* * `'translate'`,
* * `'native'`.
*
* @type {String}
* @default 'translate'
* @public
*/
scrollMode: _propTypes["default"].string,
/**
* Specifies how to show vertical scrollbar.
*
* Valid values are:
* * `'auto'`,
* * `'visible'`, and
* * `'hidden'`.
*
* @type {String}
* @default 'auto'
* @public
*/
verticalScrollbar: _propTypes["default"].oneOf(['auto', 'visible', 'hidden'])
};
Scroller.defaultPropValues = scrollerDefaultProps;
var _default = exports["default"] = Scroller;