扩展组件(uni-ui)之uni-segmented-control

559 阅读1分钟

uni-segmented-control 是 uni-app 的 uni-ui 组件库中的一个分段控制器组件,用于在多个分段之间进行选择。它通常用于展示多个相互排斥的选项,用户可以选择其中之一,类似于传统界面中的标签页或分段选择器。

基本用法

在使用 uni-segmented-control 之前,你需要确保已经正确安装了 uni-ui 库,并在页面中引入了 uni-segmented-control 组件。

引入组件

<template>
    <uni-segmented-control :values="items" @clickItem="onClickItem" />
</template>

<script>
    import uniSegmentedControl from '@dcloudio/uni-ui/lib/uni-segmented-control/uni-segmented-control.vue'
    export default {
        components: { uniSegmentedControl },
        data() {
            return {
                items: ['选项一', '选项二', '选项三']
            }
        },
        methods: {
            onClickItem(index) {
                console.log('选择的是:', this.items[index]);
            }
        }
    }
</script>

属性

  • values:一个数组,定义分段控制器的所有选项。
  • current:当前选中项的索引,从 0 开始。
  • styleType:样式类型,可以是 buttontext,默认为 text
  • activeColor:激活选项的颜色。

事件

  • clickItem:点击某个选项时触发的事件,返回被点击选项的索引。

示例

以下是 uni-segmented-control 组件的一个基本示例,包含三个选项:

<uni-segmented-control :values="['选项一', '选项二', '选项三']" @clickItem="onClickItem" />

注意事项

  • uni-segmented-control 组件适用于展示少量的分段选项。如果选项过多,可能需要考虑其他的UI设计方案。
  • 通过监听 clickItem 事件来处理用户的选择,并根据需要更新页面的显示内容或执行相应的操作。

更多关于 uni-segmented-control 组件的使用细节,可以查阅 uni-ui 官方文档 或 uni-ui 库的相关文档。