For AI agents: the complete documentation index is available at https://docs.halo.run/llms.txt, the full documentation bundle is available at https://docs.halo.run/llms-full.txt, and this page is available as Markdown at https://docs.halo.run/developer-guide/plugin/api-reference/ui/base-components/tabs.md.

VTabs 选项卡

选项卡用于在同一区域切换不同的内容。VTabs 组合 VTabItem 使用,VTabbar 则适合只需要标签栏的场景。

引入

import { VTabs, VTabItem, VTabbar } from "@halo-dev/components";

示例

基础用法

<script lang="ts" setup>
import { ref } from "vue";
import { VTabItem, VTabs } from "@halo-dev/components";

const activeId = ref("general");
</script>

<template>
  <VTabs v-model:active-id="activeId">
    <VTabItem id="general" label="基本设置">
      在这里配置站点的基本信息。
    </VTabItem>
    <VTabItem id="seo" label="SEO"> 在这里配置搜索引擎优化选项。 </VTabItem>
    <VTabItem id="advanced" label="高级">
      高级设置仅供有经验的用户使用。
    </VTabItem>
  </VTabs>
</template>

不同样式

<script lang="ts" setup>
import { ref } from "vue";
import { VTabItem, VTabs } from "@halo-dev/components";

const activeId = ref("a");
</script>

<template>
  <VTabs v-model:active-id="activeId" type="pills">
    <VTabItem id="a" label="文章">文章列表</VTabItem>
    <VTabItem id="b" label="页面">页面列表</VTabItem>
    <VTabItem id="c" label="评论">评论列表</VTabItem>
  </VTabs>
</template>

垂直排列

<script lang="ts" setup>
import { ref } from "vue";
import { VTabItem, VTabs } from "@halo-dev/components";

const activeId = ref("profile");
</script>

<template>
  <VTabs v-model:active-id="activeId" direction="column">
    <VTabItem id="profile" label="个人资料">个人资料内容</VTabItem>
    <VTabItem id="security" label="安全">安全设置内容</VTabItem>
    <VTabItem id="notifications" label="通知">通知设置内容</VTabItem>
  </VTabs>
</template>

仅使用标签栏

<script lang="ts" setup>
import { ref } from "vue";
import { VTabbar } from "@halo-dev/components";

const activeId = ref("all");

const items = [
  { id: "all", label: "全部" },
  { id: "published", label: "已发布" },
  { id: "draft", label: "草稿" },
];
</script>

<template>
  <VTabbar v-model:active-id="activeId" :items="items" type="outline" />
</template>

VTabs Props

属性类型默认值说明
activeIdnumber | stringundefined当前选中的标签 ID,支持 v-model:active-id
type"default" | "pills" | "outline""default"标签栏样式
direction"row" | "column""row"标签栏排列方向
idKeystring"id"从 VTabItem 中读取 ID 的属性名
labelKeystring"label"从 VTabItem 中读取标签文字的属性名

VTabItem Props

属性类型默认值说明
idstringundefined标签 ID
labelstringundefined标签文字

VTabbar Props

属性类型默认值说明
activeIdnumber | stringundefined当前选中的标签 ID,支持 v-model:active-id
itemsArray<Record<string, string>>undefined标签数据,每项至少包含 id 和 label
type"default" | "pills" | "outline""default"标签栏样式
direction"row" | "column""row"标签栏排列方向
idKeystring"id"读取 ID 的属性名
labelKeystring"label"读取标签文字的属性名

Emits

组件事件参数说明
VTabsupdate:activeIdnumber | string选中的标签变化时触发
VTabschangenumber | string选中的标签变化时触发
VTabbarupdate:activeIdnumber | string选中的标签变化时触发
VTabbarchangenumber | string选中的标签变化时触发

Slots

组件插槽说明
VTabsdefaultVTabItem 列表
VTabItemdefault标签内容