@gitlab/ui 36.7.0 → 37.1.0

package/src/components/base/tabs/tabs/tabs.stories.js

@@ -1,8 +1,36 @@
-import { withKnobs, boolean } from '@storybook/addon-knobs';
 import { range } from 'lodash';
-import { documentedStoriesOf } from '../../../../../documentation/documented_stories';
 import { GlTabs, GlTab, GlScrollableTabs } from '../../../../index';
-import docs from './tabs.md';
+import readme from './tabs.md';
+
+const components = {
+  GlTabs,
+  GlTab,
+};
+
+const defaultValue = (prop) => GlTabs.props[prop].default;
+
+const generateProps = ({
+  justified = defaultValue('justified'),
+  actionPrimary = null,
+  actionSecondary = null,
+  actionTertiary = null,
+} = {}) => ({
+  justified,
+  actionPrimary,
+  actionSecondary,
+  actionTertiary,
+});
+
+const wrap = (template) => `
+  <gl-tabs
+    :justified="justified"
+    :action-primary="actionPrimary"
+    :action-secondary="actionSecondary"
+    :action-tertiary="actionTertiary"
+  >
+    ${template}
+  </gl-tabs>
+`;
 
 const ScrollableTabsGenerator = {
   components: {
@@ -33,167 +61,199 @@ const ScrollableTabsGenerator = {
   `,
 };
 
-const createBaseStory = () => ({
-  components: {
-    GlTabs,
-    GlTab,
+export const Default = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components,
+  template: wrap(`
+    <gl-tab title="Tab 1">
+      Tab panel 1
+    </gl-tab>
+    <gl-tab title="Tab 2">
+      Tab panel 2
+    </gl-tab>
+    <gl-tab title="Tab 3">
+      Tab panel 3
+    </gl-tab>
+    <gl-tab title="Tab 4">
+      Tab panel 4
+    </gl-tab>
+    <gl-tab title="Tab 5">
+      Tab panel 5
+    </gl-tab>
+    <gl-tab title="Tab 6">
+      Tab panel 6
+    </gl-tab>
+    <gl-tab title="Tab 7">
+      Tab panel 7
+    </gl-tab>
+    <gl-tab title="Tab 8">
+      Tab panel 8
+    </gl-tab>
+    <gl-tab title="Tab 9">
+      Tab panel 9
+    </gl-tab>
+    <gl-tab title="Tab 10">
+      Tab panel 10
+    </gl-tab>
+    <gl-tab title="Tab 11">
+      Tab panel 11
+    </gl-tab>
+    <gl-tab title="Tab 12">
+      Tab panel 12
+    </gl-tab>
+    <gl-tab title="Tab 13" query-param-value="thirteenth">
+      Tab panel 13
+    </gl-tab>
+    <gl-tab title="Tab 14">
+      Tab panel 14
+    </gl-tab>`),
+});
+Default.args = generateProps();
+
+export const ContentlessTab = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components,
+  template: wrap(`
+    <gl-tab title="Regular tab">
+      <p>Regular tab content.</p>
+      <p>The contentless tab is not selectable, as it has no content. This is useful for displaying things that aren't really tabs after the list of tabs.</p>
+    </gl-tab>
+    <gl-tab title="Another tab">
+      <p>Another tab's content.</p>
+    </gl-tab>
+    <template #tabs-end>
+      <li class="gl-tab-nav-item">
+        Contentless tab
+      </li>
+    </template>`),
+});
+
+export const EmptyState = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components,
+  template: wrap(`
+    <template #empty>
+      This content is only displayed when there are no tabs. Useful for dynamically added/removed tabs.
+    </template>`),
+});
+
+export const JustifiedTabs = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components,
+  template: wrap(`
+    <gl-tab title="Tab 1">
+      <p>Tab panel 1</p>
+    </gl-tab>
+    <gl-tab title="Tab 2">
+      <p>Tab panel 2</p>
+    </gl-tab>`),
+});
+JustifiedTabs.args = generateProps({ justified: true });
+
+export const WithCounterBadges = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components,
+  template: wrap(`
+    <gl-tab>
+      <template #title>
+        <span>Tab</span>
+        <gl-badge size="sm" class="gl-tab-counter-badge">500</gl-badge>
+        <span class="sr-only">items</span>
+      </template>
+      Tab panel 1
+    </gl-tab>
+    <gl-tab>
+      <template #title>
+        <span>Tab</span>
+        <gl-badge size="sm" class="gl-tab-counter-badge">250</gl-badge>
+        <span class="sr-only">items</span>
+      </template>
+      Tab panel 2
+    </gl-tab>
+    <gl-tab>
+      <template #title>
+        <span>Tab</span>
+      </template>
+      Tab panel 3
+    </gl-tab>`),
+});
+
+export const WithActions = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components,
+  template: wrap(`
+    <gl-tab title="Tab 1">
+      Tab panel 1
+    </gl-tab>`),
+});
+WithActions.args = generateProps({
+  actionPrimary: {
+    attributes: {
+      variant: 'danger',
+    },
+    text: 'Primary action',
   },
-  props: {
-    syncActiveTabWithQueryParams: {
-      type: Boolean,
-      default: boolean('sync-active-tab-with-query-params', false),
+  actionSecondary: {
+    attributes: {
+      variant: 'success',
+    },
+    text: 'Secondary action',
+  },
+  actionTertiary: {
+    attributes: {
+      variant: 'default',
     },
+    text: 'Tertiary action',
   },
 });
 
-documentedStoriesOf('base/tabs/tabs', docs)
-  .addDecorator(withKnobs)
-  .add('default', () => ({
-    ...createBaseStory(),
-    template: `
-      <gl-tabs :sync-active-tab-with-query-params="syncActiveTabWithQueryParams">
-        <gl-tab title="Tab 1">
-          Tab panel 1
-        </gl-tab>
-        <gl-tab title="Tab 2">
-          Tab panel 2
-        </gl-tab>
-        <gl-tab title="Tab 3">
-          Tab panel 3
-        </gl-tab>
-        <gl-tab title="Tab 4">
-          Tab panel 4
-        </gl-tab>
-        <gl-tab title="Tab 5">
-          Tab panel 5
-        </gl-tab>
-        <gl-tab title="Tab 6">
-          Tab panel 6
-        </gl-tab>
-        <gl-tab title="Tab 7">
-          Tab panel 7
-        </gl-tab>
-        <gl-tab title="Tab 8">
-          Tab panel 8
-        </gl-tab>
-        <gl-tab title="Tab 9">
-          Tab panel 9
-        </gl-tab>
-        <gl-tab title="Tab 10">
-          Tab panel 10
-        </gl-tab>
-        <gl-tab title="Tab 11">
-          Tab panel 11
-        </gl-tab>
-        <gl-tab title="Tab 12">
-          Tab panel 12
-        </gl-tab>
-        <gl-tab title="Tab 13" query-param-value="thirteenth">
-          Tab panel 13
-        </gl-tab>
-        <gl-tab title="Tab 14">
-          Tab panel 14
-        </gl-tab>
-      </gl-tabs>
-    `,
-  }))
-  .add('contentless tab', () => ({
-    ...createBaseStory(),
-    template: `
-      <gl-tabs>
-        <gl-tab title="Regular tab">
-          <p>Regular tab content.</p>
-          <p>The contentless tab is not selectable, as it has no content. This is useful for displaying things that aren't really tabs after the list of tabs.</p>
-        </gl-tab>
-        <gl-tab title="Another tab">
-          <p>Another tab's content.</p>
-        </gl-tab>
-        <template #tabs-end>
-          <li class="gl-tab-nav-item">
-            Contentless tab
-          </li>
-        </template>
-      </gl-tabs>
-    `,
-  }))
-  .add('empty state', () => ({
-    ...createBaseStory(),
-    template: `
-      <gl-tabs>
-        <template #empty>
-          This content is only displayed when there are no tabs. Useful for dynamically added/removed tabs.
-        </template>
-      </gl-tabs>
-    `,
-  }))
-  .add('justified tabs', () => ({
-    ...createBaseStory(),
-    template: `
-      <gl-tabs justified>
-        <gl-tab title="Tab 1">
-          <p>Tab panel 1</p>
-        </gl-tab>
-        <gl-tab title="Tab 2">
-          <p>Tab panel 2</p>
-        </gl-tab>
-      </gl-tabs>
-    `,
-  }))
-  .add('with counter badges', () => ({
-    ...createBaseStory(),
-    template: `
-      <gl-tabs>
-        <gl-tab>
-          <template #title>
-            <span>Tab</span>
-            <gl-badge size="sm" class="gl-tab-counter-badge">500</gl-badge>
-            <span class="sr-only">items</span>
-          </template>
-          Tab panel 1
-        </gl-tab>
-        <gl-tab>
-          <template #title>
-            <span>Tab</span>
-            <gl-badge size="sm" class="gl-tab-counter-badge">250</gl-badge>
-            <span class="sr-only">items</span>
-          </template>
-          Tab panel 2
-        </gl-tab>
-        <gl-tab>
-          <template #title>
-            <span>Tab</span>
-          </template>
-          Tab panel 3
-        </gl-tab>
-      </gl-tabs>
-    `,
-  }))
-  .add('with scroll', () => ({
-    ...createBaseStory(),
-    components: {
-      ScrollableTabsGenerator,
-    },
-    template: '<scrollable-tabs-generator :count="50" />',
-  }))
-  .add(
-    'with scroll and growing',
-    () => ({
-      ...createBaseStory(),
-      components: {
-        ScrollableTabsGenerator,
-      },
-      data() {
-        return {
-          count: 2,
-          intervalId: 0,
-        };
-      },
-      mounted() {
-        this.intervalId = setInterval(() => {
-          this.count += 1;
-        }, 2000);
+export const WithScroll = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components: {
+    ScrollableTabsGenerator,
+  },
+  template: '<scrollable-tabs-generator :count="50" />',
+});
+
+export const WithScrollAndGrowing = (_args, { argTypes }) => ({
+  props: Object.keys(argTypes),
+  components: {
+    ScrollableTabsGenerator,
+  },
+  data() {
+    return {
+      count: 2,
+      intervalId: 0,
+    };
+  },
+  mounted() {
+    this.intervalId = setInterval(() => {
+      this.count += 1;
+    }, 2000);
+  },
+  template: '<scrollable-tabs-generator :count="count" />',
+});
+WithScrollAndGrowing.parameters = {
+  storyshots: { disable: true },
+};
+
+export default {
+  title: 'base/tabs/tabs',
+  component: GlTabs,
+  subcomponents: { GlTab, GlScrollableTabs },
+  parameters: {
+    bootstrapComponent: 'b-tabs',
+    docs: {
+      description: {
+        component: readme,
       },
-      template: '<scrollable-tabs-generator :count="count" />',
-    }),
-    { storyshots: false }
-  );
+    },
+  },
+  argTypes: {
+    contentClass: { control: { disable: true } },
+    navClass: { control: { disable: true } },
+    syncActiveTabWithQueryParams: { control: { disable: true } },
+    queryParamName: { control: { disable: true } },
+    value: { control: { disable: true } },
+  },
+};

package/src/components/base/tabs/tabs/tabs.vue

@@ -46,11 +46,17 @@ export default {
       required: false,
       default: false,
     },
+    /**
+     * Sync active tab with query string parameters. Allows for deep linking into specific tabs.
+     */
     syncActiveTabWithQueryParams: {
       type: Boolean,
       required: false,
       default: false,
     },
+    /**
+     * Name to use for query string parameter.
+     */
     queryParamName: {
       type: String,
       required: false,

package/src/components/base/toggle/toggle.stories.js

@@ -1,5 +1,6 @@
 import { GlToggle } from '../../../index';
 import { toggleLabelPosition } from '../../../utils/constants';
+import { disableControls } from '../../../utils/stories_utils';
 import readme from './toggle.md';
 
 const defaultValue = (prop) => GlToggle.props[prop].default;
@@ -53,6 +54,7 @@ export default {
     },
   },
   argTypes: {
+    ...disableControls(['name']),
     labelPosition: {
       control: {
         type: 'select',
@@ -69,8 +71,5 @@ export default {
         type: 'text',
       },
     },
-    name: {
-      control: { disable: true },
-    },
   },
 };

package/src/components/charts/area/area.documentation.js

@@ -1,8 +1,3 @@
-import description from './area.md';
-import examples from './examples';
-
 export default {
   followsDesignSystem: false,
-  description,
-  examples,
 };