UNPKG

carbon-components

Version:

The Carbon Design System is IBM’s open-source design system for products and experiences.

429 lines (361 loc) • 14.3 kB
function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); } function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } } function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; } function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); } function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); } function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; } function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); } function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; } function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } } function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); } function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; } function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; } function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; } /** * Copyright IBM Corp. 2016, 2018 * * This source code is licensed under the Apache-2.0 license found in the * LICENSE file in the root directory of this source tree. */ import settings from '../../globals/js/settings'; import mixin from '../../globals/js/misc/mixin'; import createComponent from '../../globals/js/mixins/create-component'; import initComponentByEvent from '../../globals/js/mixins/init-component-by-event'; import eventedShowHideState from '../../globals/js/mixins/evented-show-hide-state'; import handles from '../../globals/js/mixins/handles'; import FloatingMenu, { DIRECTION_LEFT, DIRECTION_TOP, DIRECTION_RIGHT, DIRECTION_BOTTOM } from '../floating-menu/floating-menu'; import getLaunchingDetails from '../../globals/js/misc/get-launching-details'; import on from '../../globals/js/misc/on'; /** * @param {Element} menuBody The menu body with the menu arrow. * @param {string} menuDirection Where the floating menu menu should be placed relative to the trigger button. * @returns {FloatingMenu~offset} The adjustment of the floating menu position, upon the position of the menu arrow. * @private */ var getMenuOffset = function getMenuOffset(menuBody, menuDirection) { var _DIRECTION_LEFT$DIREC, _DIRECTION_LEFT$DIREC2; var arrowStyle = menuBody.ownerDocument.defaultView.getComputedStyle(menuBody, ':before'); var arrowPositionProp = (_DIRECTION_LEFT$DIREC = {}, _defineProperty(_DIRECTION_LEFT$DIREC, DIRECTION_LEFT, 'right'), _defineProperty(_DIRECTION_LEFT$DIREC, DIRECTION_TOP, 'bottom'), _defineProperty(_DIRECTION_LEFT$DIREC, DIRECTION_RIGHT, 'left'), _defineProperty(_DIRECTION_LEFT$DIREC, DIRECTION_BOTTOM, 'top'), _DIRECTION_LEFT$DIREC)[menuDirection]; var menuPositionAdjustmentProp = (_DIRECTION_LEFT$DIREC2 = {}, _defineProperty(_DIRECTION_LEFT$DIREC2, DIRECTION_LEFT, 'left'), _defineProperty(_DIRECTION_LEFT$DIREC2, DIRECTION_TOP, 'top'), _defineProperty(_DIRECTION_LEFT$DIREC2, DIRECTION_RIGHT, 'left'), _defineProperty(_DIRECTION_LEFT$DIREC2, DIRECTION_BOTTOM, 'top'), _DIRECTION_LEFT$DIREC2)[menuDirection]; var values = [arrowPositionProp, 'border-bottom-width'].reduce(function (o, name) { return _objectSpread(_objectSpread({}, o), {}, _defineProperty({}, name, Number((/^([\d-.]+)px$/.exec(arrowStyle.getPropertyValue(name)) || [])[1]))); }, {}); var margin = 0; if (menuDirection !== DIRECTION_BOTTOM) { var style = menuBody.ownerDocument.defaultView.getComputedStyle(menuBody); margin = Number((/^([\d-.]+)px$/.exec(style.getPropertyValue('margin-top')) || [])[1]); } values[arrowPositionProp] = values[arrowPositionProp] || -6; // IE, etc. if (Object.keys(values).every(function (name) { return !isNaN(values[name]); })) { var arrowPosition = values[arrowPositionProp], borderBottomWidth = values['border-bottom-width']; return _defineProperty({ left: 0, top: 0 }, menuPositionAdjustmentProp, Math.sqrt(Math.pow(borderBottomWidth, 2) * 2) - arrowPosition + margin * (menuDirection === DIRECTION_TOP ? 2 : 1)); } return undefined; }; /** * Key codes for allowed keys that will trigger opening a tooltip * @type {Integer[]} * @private */ var allowedOpenKeys = [32, 13]; var Tooltip = /*#__PURE__*/function (_mixin) { _inherits(Tooltip, _mixin); var _super = _createSuper(Tooltip); /** * Tooltip. * @extends CreateComponent * @extends InitComponentBySearch * @extends Handles */ /** * Tooltip. * @extends CreateComponent * @extends InitComponentBySearch * @extends Handles */ function Tooltip(element, options) { var _this; _classCallCheck(this, Tooltip); _this = _super.call(this, element, options); _this._hasContextMenu = false; _this._hookOn(element); return _this; } /** * A flag to detect if `oncontextmenu` event is fired right before `focus`/`blur` events. * @type {boolean} */ /** * A flag to detect if `oncontextmenu` event is fired right before `focus`/`blur` events. * @type {boolean} */ _createClass(Tooltip, [{ key: "createdByEvent", value: /** * A method called when this widget is created upon events. * @param {Event} event The event triggering the creation. */ function createdByEvent(event) { var relatedTarget = event.relatedTarget, type = event.type, which = event.which; if (type === 'click' || allowedOpenKeys.includes(which)) { this._handleClick({ relatedTarget: relatedTarget, type: type, details: getLaunchingDetails(event) }); } } /** * Changes the shown/hidden state. * @param {string} state The new state. * @param {object} detail The detail of the event trigging this action. * @param {Function} callback Callback called when change in state completes. */ }, { key: "changeState", value: function changeState(state, detail, callback) { if (!this.tooltip) { var tooltip = this.element.ownerDocument.querySelector(this.element.getAttribute(this.options.attribTooltipTarget)); if (!tooltip) { throw new Error('Cannot find the target tooltip.'); } // Lazily create a component instance for tooltip // Lazily create a component instance for tooltip this.tooltip = FloatingMenu.create(tooltip, { refNode: this.element, classShown: this.options.classShown, offset: this.options.objMenuOffset, contentNode: tooltip.querySelector(this.options.selectorContent) }); this._hookOn(tooltip); this.children.push(this.tooltip); } // Delegates the action of changing state to the tooltip. // (And thus the before/after shown/hidden events are fired from the tooltip) // Delegates the action of changing state to the tooltip. // (And thus the before/after shown/hidden events are fired from the tooltip) this.tooltip.changeState(state, Object.assign(detail, { delegatorNode: this.element }), callback); } /** * Attaches event handlers to show the tooltip. * @param {Element} element The element to attach the events to. * @private */ }, { key: "_hookOn", value: function _hookOn(element) { var _this2 = this; /** * Setup the _handleClick function for displaying a tooltip * @param {Event} evt - user initiated event * @param {Integer[]} [allowedKeys] - allowed key codes the user may press to open the tooltip * @private */ /** * Setup the _handleClick function for displaying a tooltip * @param {Event} evt - user initiated event * @param {Integer[]} [allowedKeys] - allowed key codes the user may press to open the tooltip * @private */ var handleClickContextMenu = function handleClickContextMenu(evt, allowedKeys) { var relatedTarget = evt.relatedTarget, type = evt.type, which = evt.which; // Allow user to use `space` or `enter` to open tooltip // Allow user to use `space` or `enter` to open tooltip if (typeof allowedKeys === 'undefined' || allowedKeys.includes(which)) { var hadContextMenu = _this2._hasContextMenu; _this2._hasContextMenu = type === 'contextmenu'; _this2._handleClick({ relatedTarget: relatedTarget, type: type, hadContextMenu: hadContextMenu, details: getLaunchingDetails(evt) }); } }; this.manage(on(element, 'click', handleClickContextMenu, false)); if (this.element.tagName !== 'BUTTON') { this.manage(on(this.element, 'keydown', function (event) { handleClickContextMenu(event, allowedOpenKeys); }, false)); } } /** * Handles click/focus events. * @param {object} params The parameters. * @param {Element} params.relatedTarget The element that focus went to. (For `blur` event) * @param {string} params.type The event type triggering this method. * @param {boolean} params.hadContextMenu * @param {object} params.details The event details. * @private */ }, { key: "_handleClick", value: function _handleClick(_ref2) { var relatedTarget = _ref2.relatedTarget, type = _ref2.type, hadContextMenu = _ref2.hadContextMenu, details = _ref2.details; var state = { click: 'shown', keydown: 'shown', blur: 'hidden', touchleave: 'hidden', touchcancel: 'hidden' }[type]; var shouldPreventClose; if (type === 'blur') { // Note: SVGElement in IE11 does not have `.contains()` var wentToSelf = relatedTarget && this.element.contains && this.element.contains(relatedTarget) || this.tooltip && this.tooltip.element.contains(relatedTarget); shouldPreventClose = hadContextMenu || wentToSelf; } if (!shouldPreventClose) { this.changeState(state, details); } } }], [{ key: "options", get: function get() { var prefix = settings.prefix; return { selectorInit: '[data-tooltip-trigger]', selectorContent: ".".concat(prefix, "--tooltip__content"), classShown: "".concat(prefix, "--tooltip--shown"), attribTooltipTarget: 'data-tooltip-target', objMenuOffset: getMenuOffset, initEventNames: ['click', 'keydown'] }; } }]); Tooltip.components = new WeakMap(); return Tooltip; }(mixin(createComponent, initComponentByEvent, eventedShowHideState, handles)); export default Tooltip;