UNPKG

@atlaskit/onboarding

Version:

An onboarding spotlight introduces new features to users through focused messages or multi-step tours.

199 lines (198 loc) 10 kB
"use strict"; var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault"); Object.defineProperty(exports, "__esModule", { value: true }); 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 _react = _interopRequireDefault(require("react")); var _exenv = require("exenv"); var _reactScrolllock = _interopRequireDefault(require("react-scrolllock")); var _scrollIntoViewIfNeeded = _interopRequireDefault(require("scroll-into-view-if-needed")); var _layering = require("@atlaskit/layering/layering"); var _exitingPersistence = _interopRequireDefault(require("@atlaskit/motion/exiting-persistence")); var _fadeIn = _interopRequireDefault(require("@atlaskit/motion/fade-in")); var _fg = require("@atlaskit/platform-feature-flags/fg"); var _portal = _interopRequireDefault(require("@atlaskit/portal/portal")); var _useElementBox = require("../utils/use-element-box"); var _clone = _interopRequireDefault(require("./clone")); var _nodeResolverSpotlightInner = _interopRequireDefault(require("./node-resolver-spotlight-inner")); var _spotlightDialog = _interopRequireDefault(require("./spotlight-dialog")); var _spotlightTransition = require("./spotlight-transition"); var _excluded = ["height", "left", "top", "width"]; 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) { (0, _defineProperty2.default)(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 _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; })(); } /** * __Spotlight inner__ * * Renders the spotlight target clone and dialog. * * @internal */ // eslint-disable-next-line @repo/internal/react/no-class-components var SpotlightInner = /*#__PURE__*/function (_React$Component) { function SpotlightInner() { var _this; (0, _classCallCheck2.default)(this, SpotlightInner); for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) { args[_key] = arguments[_key]; } _this = _callSuper(this, SpotlightInner, [].concat(args)); (0, _defineProperty2.default)(_this, "state", { // This is only used when targetReplacement is specified. // In this case, we have to render the targetReplacement component, // get a dom reference from that component, then render again passing // that reference into SpotlightDialog (Popper). replacementElement: null }); (0, _defineProperty2.default)(_this, "getTargetNodeStyle", function (box) { if (!_exenv.canUseDOM) { return {}; } var height = box.height, left = box.left, top = box.top, width = box.width, rest = (0, _objectWithoutProperties2.default)(box, _excluded); return _objectSpread(_objectSpread({}, rest), {}, { height: height, left: left, top: top, width: width, position: 'fixed' }, width === 0 && (0, _fg.fg)('scroll-lock-replacement') && { visibility: 'hidden' }); }); return _this; } (0, _inherits2.default)(SpotlightInner, _React$Component); return (0, _createClass2.default)(SpotlightInner, [{ key: "componentDidUpdate", value: function componentDidUpdate(prevProps) { if (prevProps.targetNode !== this.props.targetNode) { (0, _scrollIntoViewIfNeeded.default)(this.props.targetNode, { scrollMode: 'if-needed', block: this.props.scrollPositionBlock }); } } }, { key: "componentDidMount", value: function componentDidMount() { (0, _scrollIntoViewIfNeeded.default)(this.props.targetNode, { scrollMode: 'if-needed', block: this.props.scrollPositionBlock }); this.props.onOpened(); } }, { key: "componentWillUnmount", value: function componentWillUnmount() { this.props.onClosed(); } }, { key: "render", value: function render() { var _this2 = this; var _this$props = this.props, pulse = _this$props.pulse, shouldWatchTarget = _this$props.shouldWatchTarget, target = _this$props.target, targetNode = _this$props.targetNode, targetBgColor = _this$props.targetBgColor, targetOnClick = _this$props.targetOnClick, targetRadius = _this$props.targetRadius, testId = _this$props.testId, TargetReplacement = _this$props.targetReplacement; var replacementElement = this.state.replacementElement; return /*#__PURE__*/_react.default.createElement(_spotlightTransition.SpotlightTransitionConsumer, null, function (_ref) { var isOpen = _ref.isOpen, onExited = _ref.onExited; return /*#__PURE__*/_react.default.createElement(_portal.default, { zIndex: 701 }, TargetReplacement ? /*#__PURE__*/_react.default.createElement(_nodeResolverSpotlightInner.default, { hasNodeResolver: !(0, _fg.fg)('platform_design_system_team_onboarding_noderesolve'), innerRef: function innerRef(elem) { return _this2.setState({ replacementElement: elem }); } }, /*#__PURE__*/_react.default.createElement(_useElementBox.ElementBox, { element: targetNode, resizeUpdateMethod: shouldWatchTarget ? 'polling' : undefined }, function (box) { return /*#__PURE__*/_react.default.createElement(TargetReplacement, (0, _extends2.default)({ "data-testid": "".concat(testId, "--target") }, _this2.getTargetNodeStyle(box))); })) : /*#__PURE__*/_react.default.createElement(_useElementBox.ElementBox, { element: targetNode, resizeUpdateMethod: shouldWatchTarget ? 'polling' : undefined }, function (box) { return /*#__PURE__*/_react.default.createElement(_clone.default, { shouldWatch: shouldWatchTarget, testId: "".concat(testId, "--target"), pulse: pulse, target: target // eslint-disable-next-line @atlaskit/ui-styling-standard/enforce-style-prop -- Ignored via go/DSP-18766 , style: _this2.getTargetNodeStyle(box), targetBgColor: targetBgColor, targetNode: targetNode, targetOnClick: targetOnClick, targetRadius: targetRadius }); }), TargetReplacement && !replacementElement ? null : /*#__PURE__*/_react.default.createElement(_layering.Layering, { isDisabled: false }, /*#__PURE__*/_react.default.createElement(_exitingPersistence.default, { appear: true }, isOpen && /*#__PURE__*/_react.default.createElement(_fadeIn.default, { onFinish: function onFinish(state) { state === 'exiting' && onExited(); }, duration: "medium" }, function (_ref2) { var ref = _ref2.ref, className = _ref2.className, style = _ref2.style; return /*#__PURE__*/_react.default.createElement("div", { ref: ref // eslint-disable-next-line @atlaskit/ui-styling-standard/no-classname-prop , className: className, style: style }, /*#__PURE__*/_react.default.createElement(_spotlightDialog.default, { testId: "".concat(testId, "--dialog"), actions: _this2.props.actions, actionsBeforeElement: _this2.props.actionsBeforeElement, children: _this2.props.children, dialogPlacement: _this2.props.dialogPlacement, dialogWidth: _this2.props.dialogWidth, footer: _this2.props.footer, header: _this2.props.header, heading: _this2.props.heading, titleId: _this2.props.titleId, label: _this2.props.label, headingAfterElement: _this2.props.headingAfterElement, image: _this2.props.image, targetNode: replacementElement || targetNode })); }))), /*#__PURE__*/_react.default.createElement(_reactScrolllock.default, null)); }); } }]); }(_react.default.Component); // eslint-disable-next-line @repo/internal/react/require-jsdoc (0, _defineProperty2.default)(SpotlightInner, "defaultProps", { dialogWidth: 400, pulse: true }); var _default = exports.default = SpotlightInner;