@carbon/ibm-security
Version:
Carbon for Cloud & Cognitive IBM Security UI components
225 lines (224 loc) • 11 kB
JavaScript
;
var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
var _typeof = require("@babel/runtime/helpers/typeof");
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.namespace = exports.default = void 0;
var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutProperties"));
var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime/helpers/possibleConstructorReturn"));
var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime/helpers/getPrototypeOf"));
var _inherits2 = _interopRequireDefault(require("@babel/runtime/helpers/inherits"));
var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
var _classnames = _interopRequireDefault(require("classnames"));
var _propTypes = _interopRequireDefault(require("prop-types"));
var _react = _interopRequireWildcard(require("react"));
var _throttleDebounce = require("throttle-debounce");
var _namespace = require("../../globals/namespace");
var _capabilities = require("../../globals/utils/capabilities");
var _excluded = ["className", "children", "direction", "color", "onScroll", "scrollElementClassName", "getScrollElementRef", "hideStartGradient"];
var _ScrollGradient;
/**
* @file Scroll gradient.
* @copyright IBM Security 2019 - 2021
*/
function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2.default)(o), (0, _possibleConstructorReturn2.default)(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], (0, _getPrototypeOf2.default)(t).constructor) : o.apply(t, e)); }
function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
var namespace = exports.namespace = (0, _namespace.getComponentNamespace)('scroll-gradient');
var scrollDirection = {
X: 'X',
Y: 'Y'
};
var ScrollGradient = /*#__PURE__*/function (_Component) {
function ScrollGradient() {
var _this;
(0, _classCallCheck2.default)(this, ScrollGradient);
for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
args[_key] = arguments[_key];
}
_this = _callSuper(this, ScrollGradient, [].concat(args));
(0, _defineProperty2.default)(_this, "state", {
position: ScrollGradient.ScrollStates.NONE
});
/**
* Saves references of scroll DOM element.
* @param {HTMLElement} element Scroll DOM element.
*/
(0, _defineProperty2.default)(_this, "setRefs", function (element) {
_this.scrollContainer = element;
_this.props.getScrollElementRef(element);
});
/**
* Handles scrolling event of scroll element.
* @param {Event} event Scroll event generated by user.
*/
(0, _defineProperty2.default)(_this, "scrollHandler", function (event) {
_this.props.onScroll(event);
_this.updateHandler();
});
/**
* Updates the scroll state of component.
*/
(0, _defineProperty2.default)(_this, "updateScrollState", function () {
return _this.setState({
position: ScrollGradient.getScrollState(_this.scrollContainer, _this.props.direction)
});
});
/**
* @type {Function} Debounces the execution of scroll state update.
*/
(0, _defineProperty2.default)(_this, "updateHandler", (0, _throttleDebounce.throttle)(150, _this.updateScrollState));
/** @type {HTMLElement} Scrollable element reference. */
(0, _defineProperty2.default)(_this, "scrollContainer", null);
return _this;
}
(0, _inherits2.default)(ScrollGradient, _Component);
return (0, _createClass2.default)(ScrollGradient, [{
key: "componentDidMount",
value: function componentDidMount() {
if (this.scrollContainer) {
this.updateScrollState();
}
if ((0, _capabilities.isClient)()) {
// https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver
this.resizeObserver = new ResizeObserver(this.updateHandler);
this.resizeObserver.observe(this.scrollContainer);
}
}
}, {
key: "componentDidUpdate",
value: function componentDidUpdate() {
if (this.state.position !== ScrollGradient.getScrollState(this.scrollContainer, this.props.direction)) {
this.updateScrollState();
}
}
}, {
key: "componentWillUnmount",
value: function componentWillUnmount() {
this.resizeObserver.disconnect();
}
}, {
key: "render",
value: function render() {
var _this$props = this.props,
className = _this$props.className,
children = _this$props.children,
direction = _this$props.direction,
color = _this$props.color,
_ = _this$props.onScroll,
scrollElementClassName = _this$props.scrollElementClassName,
__ = _this$props.getScrollElementRef,
hideStartGradient = _this$props.hideStartGradient,
other = (0, _objectWithoutProperties2.default)(_this$props, _excluded);
var position = this.state.position;
var gradientRotation = direction === ScrollGradient.ScrollDirection.X ? -90 : 0;
return /*#__PURE__*/_react.default.createElement("div", (0, _extends2.default)({
className: (0, _classnames.default)(namespace, "".concat(namespace, "--").concat(position.toLowerCase()), "".concat(namespace, "--").concat(direction.toLowerCase()), className),
role: "presentation"
}, other), !hideStartGradient && /*#__PURE__*/_react.default.createElement("div", {
className: "".concat(namespace, "__before"),
style: {
backgroundImage: "linear-gradient(".concat(gradientRotation, "deg, rgba(0,0,0,0), ").concat(color, " 90%)")
},
role: "presentation",
"aria-hidden": true
}), /*#__PURE__*/_react.default.createElement("div", {
onScroll: this.scrollHandler,
ref: this.setRefs,
className: (0, _classnames.default)("".concat(namespace, "__content"), scrollElementClassName)
}, children), /*#__PURE__*/_react.default.createElement("div", {
className: "".concat(namespace, "__after"),
style: {
backgroundImage: "linear-gradient(".concat(gradientRotation, "deg, ").concat(color, " 10%, rgba(0,0,0,0))")
},
role: "presentation",
"aria-hidden": true
}));
}
}]);
}(_react.Component);
_ScrollGradient = ScrollGradient;
(0, _defineProperty2.default)(ScrollGradient, "propTypes", {
/** @type {string} Scroll area children */
children: _propTypes.default.oneOfType([_propTypes.default.arrayOf(_propTypes.default.node), _propTypes.default.node]),
/** @type {string} Optional classname */
className: _propTypes.default.string,
/** @type {string} Fade out color. Any valid CSS color value works */
color: _propTypes.default.string.isRequired,
/** @type {string} Scroll direction */
direction: _propTypes.default.oneOf(['X', 'Y']),
/** @type {(element: HTMLElement) => {}} Optional function to get reference to scrollable DOM element */
getScrollElementRef: _propTypes.default.func,
/** @type {boolean} Set to true if you want to hide gradient on the start side (top or left) of scrollable element. */
hideStartGradient: _propTypes.default.bool,
/** @type {Function} Optional scroll handler */
onScroll: _propTypes.default.func,
/** @type {string} Optional classname for scroll element. */
scrollElementClassName: _propTypes.default.string
});
(0, _defineProperty2.default)(ScrollGradient, "defaultProps", {
className: undefined,
children: undefined,
scrollElementClassName: undefined,
direction: scrollDirection.Y,
hideStartGradient: false,
onScroll: function onScroll() {},
getScrollElementRef: function getScrollElementRef() {}
});
/**
* Gets the scroll state position of a given element.
* @param {HTMLElement} element The element to get scroll state of.
* @param {string} scrollDirection The scroll direction to get the state of.
* @returns {string} State of scroll position.
* @static
*/
(0, _defineProperty2.default)(ScrollGradient, "getScrollState", function (element, scrollDirection) {
switch (scrollDirection) {
case _ScrollGradient.ScrollDirection.X:
{
if (element.scrollWidth === element.clientWidth) {
return _ScrollGradient.ScrollStates.NONE;
}
if (element.scrollLeft === 0) {
return _ScrollGradient.ScrollStates.INITIAL;
}
if (element.scrollLeft + element.clientWidth === element.scrollWidth) {
return _ScrollGradient.ScrollStates.END;
}
return _ScrollGradient.ScrollStates.STARTED;
}
case _ScrollGradient.ScrollDirection.Y:
default:
{
if (element.scrollHeight === element.clientHeight) {
return _ScrollGradient.ScrollStates.NONE;
}
if (element.scrollTop === 0) {
return _ScrollGradient.ScrollStates.INITIAL;
}
if (element.scrollTop + element.clientHeight === element.scrollHeight) {
return _ScrollGradient.ScrollStates.END;
}
return _ScrollGradient.ScrollStates.STARTED;
}
}
});
/** @enum Possible scroll directions */
(0, _defineProperty2.default)(ScrollGradient, "ScrollDirection", scrollDirection);
/** @enum Scroll position states */
(0, _defineProperty2.default)(ScrollGradient, "ScrollStates", {
// No scrolling required because content fits within container.
NONE: 'NONE',
// Scroll position is a the start of the scrollable content.
INITIAL: 'INITIAL',
// Scroll position is neither at start or end of scrollable content.
STARTED: 'STARTED',
// Scroll position is a the end of the scrollable content.
END: 'END'
});
var _default = exports.default = ScrollGradient;