Skip to content

Segmented 分段选择 ​

在少量互斥视图间切换,选中状态由 v-model 管理

交互示例 ​

使用要点 ​

每项使用稳定的 value,控件 aria-label 向辅助技术说明用途

查看用法代码
vue
<script setup lang="ts">
import { ZSegmented } from '@codex-proxy/ui'
import { ref } from 'vue'

const view = ref('installed')
const options = [
  { label: '已安装', value: 'installed' },
  { label: '扩展页', value: 'extensions' },
]
</script>

<template>
  <ZSegmented v-model="view" aria-label="插件视图" :options="options" />
</template>

API ​

属性 ​

属性类型默认值说明
v-modelstring必填当前选项值
aria-labelstring必填选项组的可访问名称
optionsSegmentedOption[]必填选项包含 label、value,可选 icon、disabled
display'label' | 'icon''label'显示文本或图标
size'small' | 'default' | 'large''default'尺寸
disabledbooleanfalse禁用整组

事件 ​

事件说明
update:modelValuestring,绑定值变化