Welcome to mirror list, hosted at ThFree Co, Russian Federation.

tabs_section.vue « components « default « frontend « content - gitlab.com/gitlab-org/gitlab-docs.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: 9a6f5cd49aed6769d1580f373ff86e2b54a79a90 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<script>
import {
  GlAccordion,
  GlAccordionItem,
  GlIcon,
  GlTabs,
  GlTab,
  GlSafeHtmlDirective as SafeHtml,
} from '@gitlab/ui';

/**
 * If the screen size is above or equal to this width,
 * this component renders as Tabs.
 * For smaller screens, it renders as Accordions.
 */
const TABS_BREAKPOINT = 990;

export default {
  components: {
    GlTabs,
    GlTab,
    GlIcon,
    GlAccordion,
    GlAccordionItem,
  },
  directives: {
    SafeHtml,
  },
  props: {
    tabTitles: {
      type: Array,
      required: true,
    },
    tabContents: {
      type: Array,
      required: true,
    },
  },
  data() {
    return {
      // Allows GitLab SVGs to render through v-safe-html
      // https://gitlab.com/groups/gitlab-org/-/epics/4273#svgs
      safe_html_config: { ADD_TAGS: ['use'] },
      isWideScreen: window.innerWidth >= TABS_BREAKPOINT,
    };
  },
  computed: {
    // Validate that the tabset has an equal number of tab titles and tab content sections.
    // We won't render the content if this is false.
    hasValidContent() {
      return this.tabTitles.filter(Boolean).length === this.tabContents.filter(Boolean).length;
    },
  },
  mounted() {
    window.addEventListener('resize', this.handleResize);
  },
  beforeDestroy() {
    window.removeEventListener('resize', this.handleResize);
  },
  methods: {
    handleResize() {
      this.isWideScreen = window.innerWidth >= TABS_BREAKPOINT;
    },
  },
};
</script>

<template>
  <div>
    <gl-tabs
      v-if="hasValidContent && isWideScreen"
      :sync-active-tab-with-query-params="true"
      class="gl-border-b"
    >
      <gl-tab
        v-for="(title, key) in tabTitles"
        :key="key"
        v-safe-html:[safe_html_config]="tabContents[key]"
        :query-param-value="title.titleText"
      >
        <template #title>
          <gl-icon v-if="title.icon" :name="title.icon" class="gl-mr-2" />
          <span>{{ title.titleText }}</span>
        </template>
      </gl-tab>
    </gl-tabs>

    <gl-accordion v-else :auto-collapse="false" :header-level="2" class="gl-my-5">
      <gl-accordion-item
        v-for="(title, key) in tabTitles"
        :key="key"
        :title="title.titleText"
        :class="title.icon"
      >
        <div v-safe-html:[safe_html_config]="tabContents[key]"></div>
      </gl-accordion-item>
    </gl-accordion>
  </div>
</template>