@gitlab/ui 39.3.1 → 39.5.0

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+# [39.5.0](https://gitlab.com/gitlab-org/gitlab-ui/compare/v39.4.0...v39.5.0) (2022-05-02)
+
+
+### Bug Fixes
+
+* **Alert:** Change title heading level from 4 to 2 ([0d69125](https://gitlab.com/gitlab-org/gitlab-ui/commit/0d69125fd7ef23ef6fe8eeb2d5395b6dc5dbde09))
+
+
+### Features
+
+* Add gl--flex-center composite class ([d1b3153](https://gitlab.com/gitlab-org/gitlab-ui/commit/d1b315356dfb07e718d67df0c16d0e43c48c1f55))
+
+# [39.4.0](https://gitlab.com/gitlab-org/gitlab-ui/compare/v39.3.2...v39.4.0) (2022-04-28)
+
+
+### Features
+
+* **GlListbox:** create listbox component ([dcc7eae](https://gitlab.com/gitlab-org/gitlab-ui/commit/dcc7eae54db81de1c922857c990f89ceb0e1c694))
+
+## [39.3.2](https://gitlab.com/gitlab-org/gitlab-ui/compare/v39.3.1...v39.3.2) (2022-04-27)
+
+
+### Bug Fixes
+
+* **GlButton:** Fix button text color in dark mode ([61267e3](https://gitlab.com/gitlab-org/gitlab-ui/commit/61267e3ce3c80d0592e5fe7e6458c86ab6ff3979))
+
 ## [39.3.1](https://gitlab.com/gitlab-org/gitlab-ui/compare/v39.3.0...v39.3.1) (2022-04-26)
 
 

package/dist/components/base/alert/alert.js

@@ -185,7 +185,7 @@ var __vue_render__ = function () {var _vm=this;var _h=_vm.$createElement;var _c=
     { 'gl-alert-sticky': _vm.sticky },
     { 'gl-alert-not-dismissible': !_vm.dismissible },
     { 'gl-alert-no-icon': !_vm.showIcon },
-    _vm.variantClass ]},[(_vm.showIcon)?_c('gl-icon',{class:{ 'gl-alert-icon': true, 'gl-alert-icon-no-title': !_vm.title },attrs:{"name":_vm.iconName}}):_vm._e(),_vm._v(" "),_c('div',{staticClass:"gl-alert-content",attrs:{"role":"alert"}},[(_vm.title)?_c('h4',{staticClass:"gl-alert-title"},[_vm._v(_vm._s(_vm.title))]):_vm._e(),_vm._v(" "),_c('div',{staticClass:"gl-alert-body"},[_vm._t("default")],2),_vm._v(" "),(_vm.shouldRenderActions)?_c('div',{staticClass:"gl-alert-actions"},[_vm._t("actions",_vm._l((_vm.actionButtons),function(actionButton,index){return _c('gl-button',_vm._g(_vm._b({key:index,staticClass:"gl-alert-action"},'gl-button',actionButton.attrs,false),actionButton.listeners),[_vm._v("\n          "+_vm._s(actionButton.text)+"\n        ")])}))],2):_vm._e()]),_vm._v(" "),(_vm.dismissible)?_c('close-button',{ref:"dismiss",staticClass:"gl-dismiss-btn",attrs:{"label":_vm.dismissLabel},on:{"click":_vm.onDismiss}}):_vm._e()],1)};
+    _vm.variantClass ]},[(_vm.showIcon)?_c('gl-icon',{class:{ 'gl-alert-icon': true, 'gl-alert-icon-no-title': !_vm.title },attrs:{"name":_vm.iconName}}):_vm._e(),_vm._v(" "),_c('div',{staticClass:"gl-alert-content",attrs:{"role":"alert"}},[(_vm.title)?_c('h2',{staticClass:"gl-alert-title"},[_vm._v(_vm._s(_vm.title))]):_vm._e(),_vm._v(" "),_c('div',{staticClass:"gl-alert-body"},[_vm._t("default")],2),_vm._v(" "),(_vm.shouldRenderActions)?_c('div',{staticClass:"gl-alert-actions"},[_vm._t("actions",_vm._l((_vm.actionButtons),function(actionButton,index){return _c('gl-button',_vm._g(_vm._b({key:index,staticClass:"gl-alert-action"},'gl-button',actionButton.attrs,false),actionButton.listeners),[_vm._v("\n          "+_vm._s(actionButton.text)+"\n        ")])}))],2):_vm._e()]),_vm._v(" "),(_vm.dismissible)?_c('close-button',{ref:"dismiss",staticClass:"gl-dismiss-btn",attrs:{"label":_vm.dismissLabel},on:{"click":_vm.onDismiss}}):_vm._e()],1)};
 var __vue_staticRenderFns__ = [];
 
   /* style */

package/dist/components/base/new_dropdowns/base_dropdown/base_dropdown.js

@@ -0,0 +1,240 @@
+import { createPopper } from '@popperjs/core';
+import { buttonCategoryOptions, dropdownVariantOptions, buttonSizeOptions } from '../../../../utils/constants';
+import { POPPER_CONFIG, GL_DROPDOWN_SHOWN, GL_DROPDOWN_HIDDEN } from '../constants';
+import GlButton from '../../button/button';
+import GlIcon from '../../icon/icon';
+import { OutsideDirective } from '../../../../directives/outside/outside';
+import __vue_normalize__ from 'vue-runtime-helpers/dist/normalize-component.js';
+
+var script = {
+  components: {
+    GlButton,
+    GlIcon
+  },
+  directives: {
+    Outside: OutsideDirective
+  },
+  props: {
+    toggleText: {
+      type: String,
+      required: false,
+      default: ''
+    },
+    textSrOnly: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    category: {
+      type: String,
+      required: false,
+      default: buttonCategoryOptions.primary,
+      validator: value => Object.keys(buttonCategoryOptions).includes(value)
+    },
+    variant: {
+      type: String,
+      required: false,
+      default: dropdownVariantOptions.default,
+      validator: value => Object.keys(dropdownVariantOptions).includes(value)
+    },
+    size: {
+      type: String,
+      required: false,
+      default: buttonSizeOptions.medium,
+      validator: value => Object.keys(buttonSizeOptions).includes(value)
+    },
+    icon: {
+      type: String,
+      required: false,
+      default: ''
+    },
+    disabled: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    loading: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    toggleClass: {
+      type: [String, Array, Object],
+      required: false,
+      default: null
+    },
+    noCaret: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+
+    /**
+     * Right align dropdown menu with respect to the toggle button
+     */
+    right: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    // ARIA props
+    ariaHaspopup: {
+      type: [String, Boolean],
+      required: false,
+      default: false,
+      validator: value => {
+        return ['menu', 'listbox', 'tree', 'grid', 'dialog', true, false].includes(value);
+      }
+    },
+
+    /**
+     * Id that will be referenced by `aria-labelledby` attribute of the dropdown content`
+     */
+    toggleId: {
+      type: String,
+      required: true
+    },
+
+    /**
+     * The `aria-labelledby` attribute value for the  toggle `button`
+     */
+    ariaLabelledby: {
+      type: String,
+      required: false,
+      default: null
+    }
+  },
+
+  data() {
+    return {
+      visible: false
+    };
+  },
+
+  computed: {
+    isIconOnly() {
+      var _this$toggleText;
+
+      return Boolean(this.icon && (!((_this$toggleText = this.toggleText) !== null && _this$toggleText !== void 0 && _this$toggleText.length) || this.textSrOnly));
+    },
+
+    isIconWithText() {
+      var _this$toggleText2;
+
+      return Boolean(this.icon && ((_this$toggleText2 = this.toggleText) === null || _this$toggleText2 === void 0 ? void 0 : _this$toggleText2.length) && !this.textSrOnly);
+    },
+
+    toggleButtonClasses() {
+      return [this.toggleClass, {
+        'gl-dropdown-toggle': true,
+        'dropdown-toggle': true,
+        'dropdown-icon-only': this.isIconOnly,
+        'dropdown-icon-text': this.isIconWithText,
+        'dropdown-toggle-no-caret': this.noCaret
+      }];
+    },
+
+    toggleLabelledBy() {
+      return this.ariaLabelledby ? `${this.ariaLabelledby} ${this.toggleId}` : this.toggleId;
+    },
+
+    popperConfig() {
+      return {
+        placement: this.right ? 'bottom-end' : 'bottom-start',
+        ...POPPER_CONFIG
+      };
+    }
+
+  },
+
+  updated() {
+    if (this.visible) {
+      var _this$popper;
+
+      (_this$popper = this.popper) === null || _this$popper === void 0 ? void 0 : _this$popper.update();
+    }
+  },
+
+  mounted() {
+    this.$nextTick(() => {
+      this.popper = createPopper(this.$refs.toggle.$el, this.$refs.content, this.popperConfig);
+    });
+  },
+
+  beforeDestroy() {
+    this.popper.destroy();
+  },
+
+  methods: {
+    toggle() {
+      this.visible = !this.visible;
+
+      if (this.visible) {
+        this.popper.update();
+        this.$emit(GL_DROPDOWN_SHOWN);
+      } else {
+        this.$emit(GL_DROPDOWN_HIDDEN);
+      }
+    },
+
+    close() {
+      if (!this.visible) {
+        return;
+      }
+
+      this.toggle();
+    },
+
+    closeAndFocus() {
+      if (!this.visible) {
+        return;
+      }
+
+      this.toggle();
+      this.focusToggle();
+    },
+
+    focusToggle() {
+      this.$refs.toggle.$el.focus();
+    }
+
+  }
+};
+
+/* script */
+const __vue_script__ = script;
+
+/* template */
+var __vue_render__ = function () {var _vm=this;var _h=_vm.$createElement;var _c=_vm._self._c||_h;return _c('div',{directives:[{name:"outside",rawName:"v-outside",value:(_vm.close),expression:"close"}],staticClass:"gl-new-dropdown dropdown btn-group"},[_c('gl-button',{ref:"toggle",class:_vm.toggleButtonClasses,attrs:{"id":_vm.toggleId,"data-testid":"base-dropdown-toggle","icon":_vm.icon,"category":_vm.category,"variant":_vm.variant,"size":_vm.size,"disabled":_vm.disabled,"loading":_vm.loading,"aria-haspopup":_vm.ariaHaspopup,"aria-expanded":_vm.visible,"aria-labelledby":_vm.toggleLabelledBy},on:{"click":_vm.toggle}},[_c('span',{staticClass:"gl-new-dropdown-button-text",class:{ 'gl-sr-only': _vm.textSrOnly }},[_vm._v("\n      "+_vm._s(_vm.toggleText)+"\n    ")]),_vm._v(" "),(!_vm.noCaret)?_c('gl-icon',{staticClass:"gl-button-icon dropdown-chevron",attrs:{"name":"chevron-down"}}):_vm._e()],1),_vm._v(" "),_c('div',{ref:"content",staticClass:"dropdown-menu",class:{ show: _vm.visible },attrs:{"data-testid":"base-dropdown-menu"},on:{"keydown":function($event){if(!$event.type.indexOf('key')&&_vm._k($event.keyCode,"esc",27,$event.key,["Esc","Escape"])){ return null; }$event.stopPropagation();$event.preventDefault();return _vm.closeAndFocus($event)}}},[_c('div',{staticClass:"gl-new-dropdown-inner"},[_vm._t("default")],2)])],1)};
+var __vue_staticRenderFns__ = [];
+
+  /* style */
+  const __vue_inject_styles__ = undefined;
+  /* scoped */
+  const __vue_scope_id__ = undefined;
+  /* module identifier */
+  const __vue_module_identifier__ = undefined;
+  /* functional template */
+  const __vue_is_functional_template__ = false;
+  /* style inject */
+  
+  /* style inject SSR */
+  
+  /* style inject shadow dom */
+  
+
+  
+  const __vue_component__ = __vue_normalize__(
+    { render: __vue_render__, staticRenderFns: __vue_staticRenderFns__ },
+    __vue_inject_styles__,
+    __vue_script__,
+    __vue_scope_id__,
+    __vue_is_functional_template__,
+    __vue_module_identifier__,
+    false,
+    undefined,
+    undefined,
+    undefined
+  );
+
+export default __vue_component__;

package/dist/components/base/new_dropdowns/constants.js

@@ -0,0 +1,20 @@
+const POPPER_CONFIG = {
+  modifiers: [{
+    name: 'offset',
+    options: {
+      offset: [0, 4]
+    }
+  }]
+}; // base dropdown events
+
+const GL_DROPDOWN_SHOWN = 'shown';
+const GL_DROPDOWN_HIDDEN = 'hidden'; // KEY Codes
+
+const HOME = 'Home';
+const END = 'End';
+const ARROW_UP = 'ArrowUp';
+const ARROW_DOWN = 'ArrowDown';
+const ENTER = 'Enter';
+const SPACE = 'Space';
+
+export { ARROW_DOWN, ARROW_UP, END, ENTER, GL_DROPDOWN_HIDDEN, GL_DROPDOWN_SHOWN, HOME, POPPER_CONFIG, SPACE };

package/dist/components/base/new_dropdowns/listbox/listbox.js

@@ -0,0 +1,381 @@
+import _uniqueId from 'lodash/uniqueId';
+import _clamp from 'lodash/clamp';
+import { stopEvent } from '../../../../utils/utils';
+import { GL_DROPDOWN_SHOWN, GL_DROPDOWN_HIDDEN, HOME, END, ARROW_UP, ARROW_DOWN } from '../constants';
+import { buttonCategoryOptions, dropdownVariantOptions, buttonSizeOptions } from '../../../../utils/constants';
+import GlBaseDropdown from '../base_dropdown/base_dropdown';
+import GlListboxItem from './listbox_item';
+import __vue_normalize__ from 'vue-runtime-helpers/dist/normalize-component.js';
+
+const ITEM_SELECTOR = '[role="option"]';
+var script = {
+  events: {
+    GL_DROPDOWN_SHOWN,
+    GL_DROPDOWN_HIDDEN
+  },
+  components: {
+    GlBaseDropdown,
+    GlListboxItem
+  },
+  model: {
+    prop: 'selected',
+    event: 'select'
+  },
+  props: {
+    /**
+     * Items to display in the dropdown
+     */
+    items: {
+      type: Array,
+      required: false,
+      default: () => [],
+      validator: items => {
+        return items.every(_ref => {
+          let {
+            value
+          } = _ref;
+          return typeof value === 'string';
+        });
+      }
+    },
+
+    /**
+     * array of selected items values for multi-select and selected item value for single-select
+     */
+    selected: {
+      type: [Array, String, Number],
+      required: false,
+      default: () => []
+    },
+
+    /**
+     * Allow multi-selection
+     */
+    multiple: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+
+    /**
+     * Toggle button text
+     */
+    toggleText: {
+      type: String,
+      required: false,
+      default: ''
+    },
+
+    /**
+     * Toggle text to be read by screen readers only
+     */
+    textSrOnly: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+
+    /**
+     * Styling option - dropdown's toggle category
+     */
+    category: {
+      type: String,
+      required: false,
+      default: buttonCategoryOptions.primary,
+      validator: value => Object.keys(buttonCategoryOptions).includes(value)
+    },
+
+    /**
+     * Styling option - dropdown's toggle variant
+     */
+    variant: {
+      type: String,
+      required: false,
+      default: dropdownVariantOptions.default,
+      validator: value => Object.keys(dropdownVariantOptions).includes(value)
+    },
+
+    /**
+     * The size of the dropdown toggle
+     */
+    size: {
+      type: String,
+      required: false,
+      default: buttonSizeOptions.medium,
+      validator: value => Object.keys(buttonSizeOptions).includes(value)
+    },
+
+    /**
+     * Icon name that will be rendered in the toggle button
+     */
+    icon: {
+      type: String,
+      required: false,
+      default: ''
+    },
+
+    /**
+     * Set to "true" to disable the dropdown
+     */
+    disabled: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+
+    /**
+     * Set to "true" when dropdown content (items) is loading
+     */
+    loading: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+
+    /**
+     * Additional CSS classes to customize toggle appearance
+     */
+    toggleClass: {
+      type: [String, Array, Object],
+      required: false,
+      default: null
+    },
+
+    /**
+     * Set to "true" to hide the caret
+     */
+    noCaret: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+
+    /**
+     * Right align listbox menu with respect to the toggle button
+     */
+    right: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+
+    /**
+     * The `aria-labelledby` attribute value for the toggle button
+     */
+    ariaLabelledby: {
+      type: String,
+      required: false,
+      default: null
+    }
+  },
+
+  data() {
+    return {
+      selectedValues: [],
+      toggleId: _uniqueId('dropdown-toggle-btn-'),
+      nextFocusedItemIndex: null
+    };
+  },
+
+  computed: {
+    listboxToggleText() {
+      if (!this.toggleText) {
+        if (!this.multiple && this.selectedValues.length) {
+          var _this$items$find;
+
+          return (_this$items$find = this.items.find(_ref2 => {
+            let {
+              value
+            } = _ref2;
+            return value === this.selectedValues[0];
+          })) === null || _this$items$find === void 0 ? void 0 : _this$items$find.text;
+        }
+
+        return '';
+      }
+
+      return this.toggleText;
+    },
+
+    selectedIndices() {
+      return this.selectedValues.map(selected => this.items.findIndex(_ref3 => {
+        let {
+          value
+        } = _ref3;
+        return value === selected;
+      })).sort();
+    }
+
+  },
+  watch: {
+    selected: {
+      immediate: true,
+
+      handler(newSelected) {
+        if (Array.isArray(newSelected)) {
+          if (!this.multiple && newSelected.length) {
+            throw new Error('To allow multi-selection, please, set "multiple" property to "true"');
+          }
+
+          this.selectedValues = [...newSelected];
+        } else {
+          this.selectedValues = [newSelected];
+        }
+      }
+
+    }
+  },
+  methods: {
+    onShow() {
+      this.$nextTick(() => {
+        var _this$selectedIndices;
+
+        this.focusItem((_this$selectedIndices = this.selectedIndices[0]) !== null && _this$selectedIndices !== void 0 ? _this$selectedIndices : 0, this.getFocusableListItemElements());
+        /**
+         * Emitted when dropdown is shown
+         *
+         * @event shown
+         */
+
+        this.$emit(GL_DROPDOWN_SHOWN);
+      });
+    },
+
+    onHide() {
+      /**
+       * Emitted when dropdown is hidden
+       *
+       * @event hidden
+       */
+      this.$emit(GL_DROPDOWN_HIDDEN);
+      this.nextFocusedItemIndex = null;
+    },
+
+    onKeydown(event) {
+      const {
+        code
+      } = event;
+      const elements = this.getFocusableListItemElements();
+      if (elements.length < 1) return;
+      let stop = true;
+
+      if (code === HOME) {
+        this.focusItem(0, elements);
+      } else if (code === END) {
+        this.focusItem(elements.length - 1, elements);
+      } else if (code === ARROW_UP) {
+        this.focusNextItem(event, elements, -1);
+      } else if (code === ARROW_DOWN) {
+        this.focusNextItem(event, elements, 1);
+      } else {
+        stop = false;
+      }
+
+      if (stop) {
+        stopEvent(event);
+      }
+    },
+
+    getFocusableListItemElements() {
+      const items = this.$refs.list.querySelectorAll(ITEM_SELECTOR);
+      return Array.from(items);
+    },
+
+    focusNextItem(event, elements, offset) {
+      const {
+        target
+      } = event;
+      const currentIndex = elements.indexOf(target);
+
+      const nextIndex = _clamp(currentIndex + offset, 0, elements.length - 1);
+
+      this.focusItem(nextIndex, elements);
+    },
+
+    focusItem(index, elements) {
+      this.nextFocusedItemIndex = index;
+      this.$nextTick(() => {
+        var _elements$index;
+
+        (_elements$index = elements[index]) === null || _elements$index === void 0 ? void 0 : _elements$index.focus();
+      });
+    },
+
+    onSelect(_ref4, isSelected) {
+      let {
+        value
+      } = _ref4;
+
+      if (this.multiple) {
+        this.onMultiSelect(value, isSelected);
+      } else {
+        this.onSingleSelect(value, isSelected);
+      }
+    },
+
+    isSelected(item) {
+      return this.selectedValues.some(value => value === item.value);
+    },
+
+    onSingleSelect(value, isSelected) {
+      if (isSelected) {
+        /**
+         * Emitted when selection is changed
+         *
+         * @event select
+         */
+        this.$emit('select', value);
+      }
+
+      this.$refs.baseDropdown.closeAndFocus();
+    },
+
+    onMultiSelect(value, isSelected) {
+      if (isSelected) {
+        this.$emit('select', [...this.selectedValues, value]);
+      } else {
+        this.$emit('select', this.selectedValues.filter(selectedValue => selectedValue !== value));
+      }
+    }
+
+  }
+};
+
+/* script */
+const __vue_script__ = script;
+
+/* template */
+var __vue_render__ = function () {var _vm=this;var _h=_vm.$createElement;var _c=_vm._self._c||_h;return _c('gl-base-dropdown',{ref:"baseDropdown",attrs:{"aria-haspopup":"listbox","aria-labelledby":_vm.ariaLabelledby,"toggle-id":_vm.toggleId,"toggle-text":_vm.listboxToggleText,"toggle-class":_vm.toggleClass,"text-sr-only":_vm.textSrOnly,"category":_vm.category,"variant":_vm.variant,"size":_vm.size,"icon":_vm.icon,"disabled":_vm.disabled,"loading":_vm.loading,"no-caret":_vm.noCaret,"right":_vm.right},on:_vm._d({},[_vm.$options.events.GL_DROPDOWN_SHOWN,_vm.onShow,_vm.$options.events.GL_DROPDOWN_HIDDEN,_vm.onHide])},[_vm._t("header"),_vm._v(" "),_c('ul',{ref:"list",staticClass:"gl-new-dropdown-contents gl-list-style-none gl-pl-0 gl-mb-0",attrs:{"aria-labelledby":_vm.toggleId,"role":"listbox","tabindex":"-1"},on:{"keydown":_vm.onKeydown}},_vm._l((_vm.items),function(item,index){return _c('gl-listbox-item',{key:item.value,attrs:{"is-selected":_vm.isSelected(item),"is-focused":_vm.nextFocusedItemIndex === index},on:{"select":function($event){return _vm.onSelect(item, $event)}}},[_vm._t("list-item",[_vm._v("\n        "+_vm._s(item.text)+"\n      ")],{"item":item})],2)}),1),_vm._v(" "),_vm._t("footer")],2)};
+var __vue_staticRenderFns__ = [];
+
+  /* style */
+  const __vue_inject_styles__ = undefined;
+  /* scoped */
+  const __vue_scope_id__ = undefined;
+  /* module identifier */
+  const __vue_module_identifier__ = undefined;
+  /* functional template */
+  const __vue_is_functional_template__ = false;
+  /* style inject */
+  
+  /* style inject SSR */
+  
+  /* style inject shadow dom */
+  
+
+  
+  const __vue_component__ = __vue_normalize__(
+    { render: __vue_render__, staticRenderFns: __vue_staticRenderFns__ },
+    __vue_inject_styles__,
+    __vue_script__,
+    __vue_scope_id__,
+    __vue_is_functional_template__,
+    __vue_module_identifier__,
+    false,
+    undefined,
+    undefined,
+    undefined
+  );
+
+export default __vue_component__;
+export { ITEM_SELECTOR };