primevue-mirror/src/views/tabview/TabViewDoc.vue

377 lines
16 KiB
Vue
Raw Normal View History

2019-03-29 10:42:15 +00:00
<template>
<div class="content-section documentation">
<TabView>
<TabPanel header="Documentation">
2020-06-17 19:29:33 +00:00
<h5>Import</h5>
2019-03-29 10:42:15 +00:00
<CodeHighlight lang="javascript">
import TabView from 'primevue/tabview';
import TabPanel from 'primevue/tabpanel';
2019-03-29 10:42:15 +00:00
</CodeHighlight>
2020-06-17 19:29:33 +00:00
<h5>Getting Started</h5>
2019-03-29 10:42:15 +00:00
<p>Tabview element consists of one or more TabPanel elements. Header of the tab is defined using header attribute.</p>
<CodeHighlight>
&lt;TabView&gt;
2019-05-22 16:30:18 +00:00
&lt;TabPanel header="Header I"&gt;
2019-03-29 10:42:15 +00:00
Content I
&lt;/TabPanel&gt;
2019-05-22 16:30:18 +00:00
&lt;TabPanel header="Header II"&gt;
2019-03-29 10:42:15 +00:00
Content II
&lt;/TabPanel&gt;
2019-05-22 16:30:18 +00:00
&lt;TabPanel header="Header III"&gt;
2019-03-29 10:42:15 +00:00
Content III
&lt;/TabPanel&gt;
&lt;/TabView&gt;
</CodeHighlight>
2020-06-17 19:29:33 +00:00
<h5>Active</h5>
2019-05-23 13:52:22 +00:00
<p>Visibility of the content is specified with the active property that supports one or two-way binding.</p>
2019-03-29 10:42:15 +00:00
<CodeHighlight>
&lt;TabView&gt;
2019-05-23 13:52:22 +00:00
&lt;TabPanel header="Header I"&gt;
2019-03-29 10:42:15 +00:00
Content I
&lt;/TabPanel&gt;
2019-05-23 13:52:22 +00:00
&lt;TabPanel header="Header II" :active="true"&gt;
2019-03-29 10:42:15 +00:00
Content II
&lt;/TabPanel&gt;
2019-05-23 13:52:22 +00:00
&lt;TabPanel header="Header III"&gt;
2019-03-29 10:42:15 +00:00
Content III
&lt;/TabPanel&gt;
&lt;/TabView&gt;
</CodeHighlight>
2019-05-23 13:52:22 +00:00
<p>Two-way binding requires the sync operator.</p>
<CodeHighlight>
&lt;TabView&gt;
&lt;TabPanel header="Header I" :active.sync="active1"&gt;
Content I
&lt;/TabPanel&gt;
&lt;TabPanel header="Header II" :active.sync="active2"&gt;
Content II
&lt;/TabPanel&gt;
&lt;TabPanel header="Header III" :active.sync="active3"&gt;
Content III
&lt;/TabPanel&gt;
&lt;/TabView&gt;
2019-03-29 10:42:15 +00:00
</CodeHighlight>
2020-06-17 19:29:33 +00:00
<h5>Disabled</h5>
2019-03-29 10:42:15 +00:00
<p>A tab can be disabled to prevent the content to be displayed by setting the disabled property on a panel.</p>
<CodeHighlight>
&lt;TabView&gt;
2019-05-22 16:30:18 +00:00
&lt;TabPanel header="Header I"&gt;
2019-03-29 10:42:15 +00:00
Content I
&lt;/TabPanel&gt;
2019-05-22 16:30:18 +00:00
&lt;TabPanel header="Header II"&gt;
2019-03-29 10:42:15 +00:00
Content II
&lt;/TabPanel&gt;
2019-05-22 16:30:18 +00:00
&lt;TabPanel header="Header III" :disabled="true"&gt;
2019-03-29 10:42:15 +00:00
Content III
&lt;/TabPanel&gt;
&lt;/TabView&gt;
</CodeHighlight>
2020-06-17 19:29:33 +00:00
<h5>Header Template</h5>
2019-05-23 09:01:41 +00:00
<p>Custom content for the title section of a panel is defined using the header template.</p>
2019-03-29 10:42:15 +00:00
<CodeHighlight>
2019-05-22 16:30:18 +00:00
&lt;TabView class="tabview-custom"&gt;
2019-03-29 10:42:15 +00:00
&lt;TabPanel&gt;
2019-05-22 16:30:18 +00:00
&lt;template slot="header"&gt;
&lt;i class="pi pi-calendar"&gt;&lt;/i&gt;
2019-03-29 10:42:15 +00:00
&lt;span&gt;Header I&lt;/span&gt;
&lt;/template&gt;
Content I
&lt;/TabPanel&gt;
&lt;TabPanel&gt;
2019-05-22 16:30:18 +00:00
&lt;template slot="header"&gt;
2019-03-29 10:42:15 +00:00
&lt;span&gt;Header II&lt;/span&gt;
2019-05-22 16:30:18 +00:00
&lt;i class="pi pi-user"&gt;&lt;/i&gt;
2019-03-29 10:42:15 +00:00
&lt;/template&gt;
Content II
&lt;/TabPanel&gt;
&lt;/TabView&gt;
2019-05-23 13:52:22 +00:00
</CodeHighlight>
2020-06-17 19:29:33 +00:00
<h5>Programmatic Control</h5>
2019-05-23 13:52:22 +00:00
<p>Tabs can be controlled programmatically using active property that defines the active tab.</p>
<CodeHighlight>
&lt;Button @click="activate(0)" class="p-button-secondary" label="Activate 1st" /&gt;
&lt;Button @click="activate(1)" class="p-button-secondary" label="Activate 2st" /&gt;
&lt;Button @click="activate(2)" class="p-button-secondary" label="Activate 3st" /&gt;
&lt;TabView&gt;
&lt;TabPanel header="Header I" :active.sync="active[0]"&gt;
Content I
&lt;/TabPanel&gt;
&lt;TabPanel header="Header II" :active.sync="active[1]"&gt;
Content II
&lt;/TabPanel&gt;
&lt;TabPanel header="Header III" :active.sync="active[2]"&gt;
Content III
&lt;/TabPanel&gt;
&lt;/TabView&gt;
</CodeHighlight>
<CodeHighlight lang="js">
export default {
2019-05-23 14:20:14 +00:00
data() {
2019-05-23 13:52:22 +00:00
return {
active: [true, false, false]
}
},
methods: {
activate(index) {
let activeArray = [...this.active];
for (let i = 0 ; i &lt; activeArray.length; i++) {
activeArray[i] = (i === index);
}
this.active = activeArray;
}
},
}
2019-03-29 10:42:15 +00:00
</CodeHighlight>
2020-06-17 19:29:33 +00:00
<h5>Properties of TabPanel</h5>
2019-03-29 10:42:15 +00:00
<div class="doc-tablewrapper">
<table class="doc-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Default</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>header</td>
<td>string</td>
<td>null</td>
<td>Orientation of tab headers.</td>
</tr>
<tr>
<td>active</td>
<td>boolean</td>
<td>null</td>
<td>Visibility of the content.</td>
</tr>
<tr>
<td>disabled</td>
<td>boolean</td>
<td>null</td>
<td>Whether the tab is disabled.</td>
</tr>
</tbody>
</table>
</div>
2020-06-17 19:29:33 +00:00
<h5>Properties of TabView</h5>
2020-01-13 09:04:50 +00:00
<p>Any property as style and class are passed to the main container element.</p>
2019-10-01 13:00:26 +00:00
2020-06-17 19:29:33 +00:00
<h5>Events</h5>
2019-03-29 10:42:15 +00:00
<div class="doc-tablewrapper">
<table class="doc-table">
<thead>
2019-05-23 09:01:41 +00:00
<tr>
<th>Name</th>
<th>Parameters</th>
<th>Description</th>
</tr>
2019-03-29 10:42:15 +00:00
</thead>
<tbody>
2019-05-23 09:01:41 +00:00
<tr>
<td>tab-change</td>
<td>event.originalEvent: Browser event <br/>
event.tab: Selected tab
</td>
<td>Callback to invoke when an active tab is changed.</td>
</tr>
2019-03-29 10:42:15 +00:00
</tbody>
</table>
</div>
2020-06-17 19:29:33 +00:00
<h5>Styling</h5>
2019-03-29 10:42:15 +00:00
<p>Following is the list of structural style classes, for theming classes visit <router-link to="/theming">theming</router-link> page.</p>
<div class="doc-tablewrapper">
<table class="doc-table">
<thead>
2019-05-23 09:01:41 +00:00
<tr>
<th>Name</th>
<th>Element</th>
</tr>
2019-03-29 10:42:15 +00:00
</thead>
<tbody>
2019-05-23 09:01:41 +00:00
<tr>
<td>p-tabview</td>
<td>Container element.</td>
</tr>
<tr>
<td>p-tabview-nav</td>
<td>Container of headers.</td>
</tr>
<tr>
<td>p-tabview-selected</td>
<td>Selected tab header.</td>
</tr>
<tr>
<td>p-tabview-panels</td>
<td>Container panels.</td>
</tr>
<tr>
<td>p-tabview-panel</td>
<td>Content of a tab.</td>
</tr>
2019-03-29 10:42:15 +00:00
</tbody>
</table>
</div>
2020-06-17 19:29:33 +00:00
<h5>Dependencies</h5>
2019-03-29 10:42:15 +00:00
<p>None.</p>
</TabPanel>
<TabPanel header="Source">
<a href="https://github.com/primefaces/primevue/tree/master/src/views/tabview" class="btn-viewsource" target="_blank" rel="noopener noreferrer">
<span>View on GitHub</span>
</a>
<CodeHighlight>
<template v-pre>
2020-06-18 09:24:46 +00:00
&lt;div class="card"&gt;
&lt;h5&gt;Default&lt;/h5&gt;
&lt;TabView&gt;
&lt;TabPanel header="Header I"&gt;
&lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation
ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel header="Header II"&gt;
&lt;p&gt;Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi
architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione
voluptatem sequi nesciunt. Consectetur, adipisci velit, sed quia non numquam eius modi.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel header="Header III"&gt;
&lt;p&gt;At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati
cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio.
Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;/TabView&gt;
2019-08-04 12:19:34 +00:00
&lt;/div&gt;
2019-03-29 10:42:15 +00:00
2020-06-18 09:24:46 +00:00
&lt;div class="card"&gt;
&lt;h5&gt;Programmatic&lt;/h5&gt;
&lt;div style="padding: .5rem 0 1rem 0"&gt;
&lt;Button @click="activate(0)" class="p-button-secondary" label="Activate 1st" /&gt;
&lt;Button @click="activate(1)" class="p-button-secondary" label="Activate 2nd" /&gt;
&lt;Button @click="activate(2)" class="p-button-secondary" label="Activate 3rd" /&gt;
&lt;/div&gt;
2019-03-29 10:42:15 +00:00
2020-06-18 09:24:46 +00:00
&lt;TabView&gt;
&lt;TabPanel header="Header I" :active.sync="active[0]"&gt;
&lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation
ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel header="Header II" :active.sync="active[1]"&gt;
&lt;p&gt;Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi
architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione
voluptatem sequi nesciunt. Consectetur, adipisci velit, sed quia non numquam eius modi.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel header="Header III" :active.sync="active[2]"&gt;
&lt;p&gt;At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati
cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio.
Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;/TabView&gt;
&lt;/div&gt;
2019-03-29 10:42:15 +00:00
2020-06-18 09:24:46 +00:00
&lt;div class="card"&gt;
&lt;h5&gt;Disabled&lt;/h5&gt;
&lt;TabView&gt;
&lt;TabPanel header="Header I"&gt;
&lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation
ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel header="Header II"&gt;
&lt;p&gt;Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi
architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione
voluptatem sequi nesciunt. Consectetur, adipisci velit, sed quia non numquam eius modi.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel header="Header III"&gt;
&lt;p&gt;At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati
cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio.
Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel header="Header IV" :disabled="true"&gt;&lt;/TabPanel&gt;
&lt;/TabView&gt;
&lt;/div&gt;
&lt;div class="card"&gt;
&lt;h5&gt;Custom Headers&lt;/h5&gt;
&lt;TabView class="tabview-custom"&gt;
&lt;TabPanel&gt;
&lt;template slot="header"&gt;
&lt;i class="pi pi-calendar"&gt;&lt;/i&gt;
&lt;span&gt;Header I&lt;/span&gt;
&lt;/template&gt;
&lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation
ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel&gt;
&lt;template slot="header"&gt;
&lt;span&gt;Header II&lt;/span&gt;
&lt;i class="pi pi-user"&gt;&lt;/i&gt;
&lt;/template&gt;
&lt;p&gt;Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi
architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione
voluptatem sequi nesciunt. Consectetur, adipisci velit, sed quia non numquam eius modi.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;TabPanel&gt;
&lt;template slot="header"&gt;
&lt;i class="pi pi-search"&gt;&lt;/i&gt;
&lt;span&gt;Header III&lt;/span&gt;
&lt;i class="pi pi-cog"&gt;&lt;/i&gt;
&lt;/template&gt;
&lt;p&gt;At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati
cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio.
Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus.&lt;/p&gt;
&lt;/TabPanel&gt;
&lt;/TabView&gt;
&lt;/div&gt;
2019-03-29 10:42:15 +00:00
</template>
</CodeHighlight>
<CodeHighlight lang="javascript">
export default {
2019-05-23 14:20:14 +00:00
data() {
2019-05-23 13:52:22 +00:00
return {
active: [true, false, false]
}
},
methods: {
activate(index) {
let activeArray = [...this.active];
for (let i = 0 ; i &lt; activeArray.length; i++) {
activeArray[i] = (i === index);
}
this.active = activeArray;
}
}
2019-03-29 10:42:15 +00:00
</CodeHighlight>
<CodeHighlight lang="css">
.tabview-custom {
i, span {
vertical-align: middle;
}
span {
2020-05-14 08:51:13 +00:00
margin: 0 .5rem;
2019-03-29 10:42:15 +00:00
}
}
</CodeHighlight>
</TabPanel>
</TabView>
</div>
</template>