Skip to content

SegmentedControl 分段器 ​

在多个互斥选项之间切换,支持按钮和文字两种样式。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓✓✓✓✓✓✓✓✓✓

基础用法 ​

vue
<!-- 分段选项 -->
<fui-segmented-control :values="['全部', '进行中', '已完成']" @click="handleSegmentClick" />

在 handleSegmentClick 中读取返回的 index 并更新页面内容。

属性 ​

尺寸和间距单位为 rpx。

属性类型说明官网默认值
valuesArray选项数组,支持字符串或对象[]
nameKeyString对象中显示名称的字段name
disabledKeyString对象中禁用标记的字段disabled
currentNumber当前选中索引0
typeString外观:button 或 textbutton
colorString边框、未选中文字及选中背景颜色#465CFF
activeColorString选中文字颜色#fff
boldBoolean选中文字是否加粗false
heightNumber / String高度64
sizeNumber / String字号28
radiusNumber / String圆角8
disabledBoolean是否禁用所有选项false
marginTopNumber / String上外边距0
marginBottomNumber / String下外边距0

事件 ​

事件说明回调参数
click切换分段选项包含 index 和当前选项字段的对象

平台说明 ​

非 nvue 的 color 默认由 --fui-color-primary 控制。

插槽 ​

插槽说明
—官网未列出该组件的插槽