@gitlab/ui 113.6.0 → 114.0.0

package/CHANGELOG.md

@@ -1,3 +1,28 @@
+# [114.0.0](https://gitlab.com/gitlab-org/gitlab-ui/compare/v113.7.0...v114.0.0) (2025-05-15)
+
+
+### Features
+
+* **GlButton:** remove BButton from GlButton ([fcdca4e](https://gitlab.com/gitlab-org/gitlab-ui/commit/fcdca4ee51ed98d71d93a94a2ffa741cf720c4db))
+
+
+### BREAKING CHANGES
+
+* **GlButton:** support for following props have been dropped:
+- pressed
+- router-component-name
+- exact
+- exact-path
+- exact-path-active-class (replaced with exact-active-class)
+- no-prefetch (use prefetch instead)
+
+# [113.7.0](https://gitlab.com/gitlab-org/gitlab-ui/compare/v113.6.0...v113.7.0) (2025-05-15)
+
+
+### Features
+
+* **CSS:** define basic styles for <kbd> element ([730ddb2](https://gitlab.com/gitlab-org/gitlab-ui/commit/730ddb2dc1a5912c1fa33fbb1db16aa70b044828))
+
 # [113.6.0](https://gitlab.com/gitlab-org/gitlab-ui/compare/v113.5.2...v113.6.0) (2025-05-14)
 
 

package/dist/components/base/button/button.js

@@ -1,74 +1,213 @@
-import { BButton } from '../../../vendor/bootstrap-vue/src/components/button/button';
-import { buttonCategoryOptions, buttonVariantOptions, buttonSizeOptions } from '../../../utils/constants';
-import { logWarning } from '../../../utils/utils';
+import GlLink from '../link/link';
+import { buttonCategoryOptions, buttonVariantOptions, buttonSizeOptions, linkVariantUnstyled } from '../../../utils/constants';
+import { logWarning, stopEvent } from '../../../utils/utils';
 import { isSlotEmpty } from '../../../utils/is_slot_empty';
 import { SafeLinkMixin } from '../../mixins/safe_link_mixin';
+import { isEvent } from '../../../vendor/bootstrap-vue/src/utils/inspect';
 import GlIcon from '../icon/icon';
 import GlLoadingIcon from '../loading_icon/loading_icon';
+import { SPACE, ENTER } from '../new_dropdowns/constants';
 import __vue_normalize__ from 'vue-runtime-helpers/dist/normalize-component.js';
 
 //
 var script = {
   name: 'GlButton',
   components: {
-    BButton,
     GlIcon,
     GlLoadingIcon
   },
   mixins: [SafeLinkMixin],
   props: {
+    /**
+     * Set the category of the button.
+     */
     category: {
       type: String,
       required: false,
       default: buttonCategoryOptions.primary,
       validator: value => Object.keys(buttonCategoryOptions).includes(value)
     },
+    /**
+     * Set the variant of the button.
+     */
     variant: {
       type: String,
       required: false,
       default: buttonVariantOptions.default,
       validator: value => Object.keys(buttonVariantOptions).includes(value)
     },
+    /**
+     * Specify the size of the button. Options are `small` and `medium`.
+     */
     size: {
       type: String,
       required: false,
       default: 'medium',
       validator: value => Object.keys(buttonSizeOptions).includes(value)
     },
+    /**
+     * Style the button as selected.
+     */
     selected: {
       type: Boolean,
       required: false,
       default: false
     },
+    /**
+     * Specify an icon to render in the button.
+     */
     icon: {
       type: String,
       required: false,
       default: ''
     },
+    /**
+     * Render a non-interactive label button, a `span` styled as a button.
+     */
     label: {
       type: Boolean,
       required: false,
       default: false
     },
+    /**
+     * Set the loading state of the button.
+     */
     loading: {
       type: Boolean,
       required: false,
       default: false
     },
+    /**
+     * CSS classes to add to the button text.
+     */
     buttonTextClasses: {
       type: String,
       required: false,
       default: ''
     },
+    /**
+     * Renders a 100% width button (expands to the width of its parent container).
+     */
     block: {
       type: Boolean,
       required: false,
       default: false
     },
+    /**
+     * Specify the HTML tag to render instead of the default tag.
+     */
+    tag: {
+      type: String,
+      required: false,
+      default: 'button'
+    },
+    /**
+     * The value to set the button's `type` attribute to. Can be one of `button`, `submit`, or `reset`.
+     */
+    type: {
+      type: String,
+      required: false,
+      default: 'button',
+      validator: value => ['button', 'submit', 'reset'].includes(value)
+    },
+    /**
+     * Disables the component's functionality and places it in a disabled state.
+     */
     disabled: {
       type: Boolean,
       required: false,
       default: false
+    },
+    /**
+     * Denotes the target URL of the link for standard links.
+     */
+    href: {
+      type: String,
+      required: false,
+      default: undefined
+    },
+    /**
+     * Skips sanitization of href if true. This should be used sparingly.
+     * Consult security team before setting to true.
+     */
+    isUnsafeLink: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    /**
+     * Sets the 'rel' attribute on the rendered link.
+     */
+    rel: {
+      type: String,
+      required: false,
+      default: null
+    },
+    /**
+     * Sets the 'target' attribute on the rendered link.
+     */
+    target: {
+      type: String,
+      required: false,
+      default: null
+    },
+    /**
+     * Places the component in the active state with active styling
+     */
+    active: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    /**
+     * <router-link> prop: Denotes the target route of the link.
+     * When clicked, the value of the to prop will be passed to `router.push()` internally,
+     * so the value can be either a string or a Location descriptor object.
+     */
+    to: {
+      type: [Object, String],
+      required: false,
+      default: undefined
+    },
+    /**
+     * <router-link> prop: Configure the active CSS class applied when the link is active.
+     */
+    activeClass: {
+      type: String,
+      required: false,
+      default: undefined
+    },
+    /**
+     * <router-link> prop: Configure the active CSS class applied when the link is active with exact match.
+     */
+    exactActiveClass: {
+      type: String,
+      required: false,
+      default: undefined
+    },
+    /**
+     * <router-link> prop: Setting the replace prop will call `router.replace()` instead of `router.push()`
+     * when clicked, so the navigation will not leave a history record.
+     */
+    replace: {
+      type: Boolean,
+      required: false,
+      default: false
+    },
+    /**
+     * <nuxt-link> prop: To improve the responsiveness of your Nuxt.js applications, when the link will be displayed within the viewport,
+     * Nuxt.js will automatically prefetch the code splitted page. Setting `prefetch` to `true` or `false` will overwrite the default value of `router.prefetchLinks`
+     */
+    prefetch: {
+      type: Boolean,
+      required: false,
+      // Must be `null` to fall back to the value defined in the
+      // `nuxt.config.js` configuration file for `router.prefetchLinks`
+      // We convert `null` to `undefined`, so that Nuxt.js will use the
+      // compiled default
+      // Vue treats `undefined` as default of `false` for Boolean props,
+      // so we must set it as `null` here to be a true tri-state prop
+      default: null
     }
   },
   computed: {
@@ -82,17 +221,19 @@ var script = {
       return this.disabled || this.loading;
     },
     buttonClasses() {
-      const classes = ['gl-button'];
+      const classes = ['btn', 'gl-button', `btn-${this.variant}`, `btn-${this.buttonSize}`];
       if (this.category !== buttonCategoryOptions.primary) {
         classes.push(`btn-${this.variant}-${this.category}`);
       }
       classes.push({
         'btn-icon': this.hasIconOnly,
         'button-ellipsis-horizontal': this.hasIconOnly && this.icon === 'ellipsis_h',
-        selected: this.selected
+        selected: this.selected,
+        'btn-block': this.displayBlock,
+        disabled: this.disabled
       });
       if (this.label) {
-        classes.push('btn', 'btn-label', `btn-${this.buttonSize}`);
+        classes.push('btn', 'btn-label');
       }
       return classes;
     },
@@ -101,6 +242,84 @@ var script = {
     },
     displayBlock() {
       return !this.label && this.block;
+    },
+    isLink() {
+      return this.href || this.to;
+    },
+    isHashLink() {
+      return this.isLink && this.href === '#';
+    },
+    isButton() {
+      return this.componentIs === 'button';
+    },
+    isNonStandardTag() {
+      if (this.label) {
+        return false;
+      }
+      return !this.isLink && !this.isButton;
+    },
+    tabindex() {
+      // When disabled remove links and non-standard tags from tab order
+      if (this.disabled) {
+        return this.isLink || this.isNonStandardTag ? '-1' : this.$attrs.tabindex;
+      }
+
+      // Add hash links and non-standard tags to tab order
+      return this.isNonStandardTag || this.isHashLink ? '0' : this.$attrs.tabindex;
+    },
+    computedPropsAndAttributes() {
+      var _this$$attrs;
+      const base = {
+        // Type only used for "real" buttons
+        type: this.isButton ? this.type : null,
+        // Disabled only set on "real" buttons
+        disabled: this.isButton ? this.isButtonDisabled : null,
+        // We add a role of button when the tag is not a link or button or when link has `href` of `#`
+        role: this.isNonStandardTag || this.isHashLink ? 'button' : (_this$$attrs = this.$attrs) === null || _this$$attrs === void 0 ? void 0 : _this$$attrs.role,
+        // We set the `aria-disabled` state for non-standard tags
+        ...(this.isNonStandardTag ? {
+          'aria-disabled': String(this.disabled)
+        } : {}),
+        tabindex: this.tabindex
+      };
+      if (this.isLink) {
+        return {
+          ...this.$attrs,
+          ...base,
+          variant: linkVariantUnstyled,
+          disabled: this.disabled,
+          href: this.href,
+          isUnsafeLink: this.isUnsafeLink,
+          rel: this.rel,
+          target: this.target,
+          active: this.active,
+          to: this.to,
+          activeClass: this.activeClass,
+          exactActiveClass: this.exactActiveClass,
+          replace: this.replace,
+          prefetch: this.prefetch
+        };
+      }
+      return {
+        ...this.$attrs,
+        ...base
+      };
+    },
+    computedListeners() {
+      return {
+        click: this.onClick,
+        keydown: this.onKeydown,
+        ...this.$listeners
+      };
+    },
+    componentIs() {
+      if (this.label) {
+        return 'span';
+      }
+      if (this.isLink) {
+        return GlLink;
+      }
+      return this.tag;
     }
   },
   mounted() {
@@ -108,6 +327,30 @@ var script = {
     if (!this.$slots.default && !this.$attrs['aria-label'] && !this.$props.label) {
       logWarning('[gl-button]: Accessible name missing. Please add inner text or aria-label.', this.$el);
     }
+  },
+  methods: {
+    onKeydown(event) {
+      // Skip if disabled
+      // Add SPACE keydown handler for link has `href` of `#`
+      // Add ENTER handler for non-standard tags
+      if (!this.disabled && (this.isNonStandardTag || this.isHashLink)) {
+        const {
+          code
+        } = event;
+        if (code === SPACE || code === ENTER && this.isNonStandardTag) {
+          const target = event.currentTarget || event.target;
+          stopEvent(event, {
+            propagation: false
+          });
+          target.click();
+        }
+      }
+    },
+    onClick(event) {
+      if (this.disabled && isEvent(event)) {
+        stopEvent(event);
+      }
+    }
   }
 };
 
@@ -115,7 +358,7 @@ var 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(_vm.label ? 'span' : 'b-button',_vm._g(_vm._b({directives:[{name:"safe-link",rawName:"v-safe-link:[safeLinkConfig]",arg:_vm.safeLinkConfig}],tag:"component",class:_vm.buttonClasses,attrs:{"block":_vm.displayBlock,"target":_vm.target,"variant":_vm.variant,"size":_vm.buttonSize,"disabled":_vm.isButtonDisabled}},'component',_vm.$attrs,false),_vm.$listeners),[(_vm.loading)?_c('gl-loading-icon',{staticClass:"gl-button-icon gl-button-loading-indicator",attrs:{"inline":""}}):_vm._e(),_vm._v(" "),(_vm.hasIcon && !(_vm.hasIconOnly && _vm.loading))?_c('gl-icon',{staticClass:"gl-button-icon",attrs:{"name":_vm.icon}}):_vm._e(),_vm._v(" "),_vm._t("emoji"),_vm._v(" "),(!_vm.hasIconOnly)?_c('span',{staticClass:"gl-button-text",class:_vm.buttonTextClasses},[_vm._t("default")],2):_vm._e()],2)};
+var __vue_render__ = function () {var _vm=this;var _h=_vm.$createElement;var _c=_vm._self._c||_h;return _c(_vm.componentIs,_vm._g(_vm._b({directives:[{name:"safe-link",rawName:"v-safe-link:[safeLinkConfig]",arg:_vm.safeLinkConfig}],tag:"component",class:_vm.buttonClasses},'component',_vm.computedPropsAndAttributes,false),_vm.computedListeners),[(_vm.loading)?_c('gl-loading-icon',{staticClass:"gl-button-icon gl-button-loading-indicator",attrs:{"inline":""}}):_vm._e(),_vm._v(" "),(_vm.hasIcon && !(_vm.hasIconOnly && _vm.loading))?_c('gl-icon',{staticClass:"gl-button-icon",attrs:{"name":_vm.icon}}):_vm._e(),_vm._v(" "),_vm._t("emoji"),_vm._v(" "),(!_vm.hasIconOnly)?_c('span',{staticClass:"gl-button-text",class:_vm.buttonTextClasses},[_vm._t("default")],2):_vm._e()],2)};
 var __vue_staticRenderFns__ = [];
 
   /* style */