cnbugs/uni-halo
1
0
Fork 0
mirror of https://github.com/ialley-workshop-open/uni-halo.git synced 2026-09-12 16:40:40 +08:00
Code Issues Activity
Files
ba5b77568b1d1b2a8cbb69c0b284ae2c0782d316
uni-halo/.agents/skills/uniapp-project/references/components/uni-ui/uni-segmented-control.md
T
小莫唐尼 ba5b77568b refactor: 架构升级
2026-08-31 07:58:23 +08:00

360 lines
8.8 KiB
Markdown
Raw Blame History

# uni-segmented-control
## Instructions
组件名：uni-segmented-control
代码块： uSegmentedControl
点击下载&安装
### Syntax
- 使用 `<uni-segmented-control />`（或 `<uni-segmented-control></uni-segmented-control>`，当需要包裹子节点时）。
- 遇到平台差异时，建议使用条件编译（`#ifdef / #endif`）显式处理。
#### Properties
| 属性名 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| current | Number | 0 | 当前选中的tab索引值，从0计数 |
| styleType | String | button | 分段器样式类型，可选值：button（按钮类型），text（文字类型） |
| activeColor | String | #007aff | 选中的标签背景色与边框颜色 |
| inActiveColor | String | transparent | 未激活时的颜色 |
| values | Array | - | 选项数组 |
#### Events
| 事件名 | 说明 | 返回值 |
| --- | --- | --- |
| @clickItem | 组件触发点击事件时触发 | e={currentIndex} |
#### Platform Compatibility
See official docs for platform support table: `https://uniapp.dcloud.net.cn/component/uniui/uni-segmented-control.html`
### Examples
### Example (Example 1)
```vue
<template>
<view>
<uni-segmented-control :current="current" :values="items" @clickItem="onClickItem" styleType="button" activeColor="#4cd964"></uni-segmented-control>
<view class="content">
<view v-show="current === 0">
选项卡1的内容
</view>
<view v-show="current === 1">
选项卡2的内容
</view>
<view v-show="current === 2">
选项卡3的内容
</view>
</view>
</view>
</template>
<script>
export default {
data() {
return {
...
items: ['选项1', '选项2', '选项3'],
current: 0
};
},
methods: {
...
onClickItem(e) {
if (this.current != e.currentIndex) {
this.current = e.currentIndex;
}
}
}
};
</script>
```
### Example (Example 2)
```html
<template>
<view>
<uni-segmented-control :current="current" :values="items" @clickItem="onClickItem" styleType="button" activeColor="#4cd964"></uni-segmented-control>
<view class="content">
<view v-show="current === 0">
选项卡1的内容
</view>
<view v-show="current === 1">
选项卡2的内容
</view>
<view v-show="current === 2">
选项卡3的内容
</view>
</view>
</view>
</template>
<script>
export default {
data() {
return {
...
items: ['选项1', '选项2', '选项3'],
current: 0
};
},
methods: {
...
onClickItem(e) {
if (this.current != e.currentIndex) {
this.current = e.currentIndex;
}
}
}
};
</script>
```
### Example (Example 3)
```vue
<template>
<view>
<uni-card is-full>
<text class="uni-h6">标签组件多用于商品分类、重点内容显示等场景。</text>
</uni-card>
<uni-section title="实心标签" type="line">
<view class="uni-padding-wrap uni-common-mt">
<uni-segmented-control :current="current" :values="items" :style-type="styleType"
:active-color="activeColor" @clickItem="onClickItem" />
</view>
<view class="content">
<view v-if="current === 0"><text class="content-text">选项卡1的内容</text></view>
<view v-if="current === 1"><text class="content-text">选项卡2的内容</text></view>
<view v-if="current === 2"><text class="content-text">选项卡3的内容</text></view>
</view>
</uni-section>
<uni-section title="Style" type="line"></uni-section>
<view class="example-body">
<radio-group class="uni-list" @change="styleChange">
<view v-for="(item, index) in styles" :key="index" class="uni-list-item">
<view class="uni-list-item__container">
<view class="uni-list-item__content">
<text class="uni-list-item__content-title">{{ item.text }}</text>
</view>
<view class="uni-list-item__extra">
<radio :value="item.value" :checked="item.checked" />
</view>
</view>
</view>
</radio-group>
</view>
<uni-section title="Color" type="line"></uni-section>
<view class="example-body">
<radio-group class="uni-list" @change="colorChange">
<view v-for="(item, index) in colors" :key="index" class="uni-list-item">
<view class="uni-list-item__container">
<view class="uni-list-item__content">
<view :style="{ backgroundColor: item }" class="color-tag" />
</view>
<view class="uni-list-item__extra">
<radio :value="item" :checked="index === colorIndex" />
</view>
</view>
</view>
</radio-group>
</view>
</view>
</template>
```
### Example (Example 4)
```html
<template>
<view>
<uni-card is-full>
<text class="uni-h6">标签组件多用于商品分类、重点内容显示等场景。</text>
</uni-card>
<uni-section title="实心标签" type="line">
<view class="uni-padding-wrap uni-common-mt">
<uni-segmented-control :current="current" :values="items" :style-type="styleType"
:active-color="activeColor" @clickItem="onClickItem" />
</view>
<view class="content">
<view v-if="current === 0"><text class="content-text">选项卡1的内容</text></view>
<view v-if="current === 1"><text class="content-text">选项卡2的内容</text></view>
<view v-if="current === 2"><text class="content-text">选项卡3的内容</text></view>
</view>
</uni-section>
<uni-section title="Style" type="line"></uni-section>
<view class="example-body">
<radio-group class="uni-list" @change="styleChange">
<view v-for="(item, index) in styles" :key="index" class="uni-list-item">
<view class="uni-list-item__container">
<view class="uni-list-item__content">
<text class="uni-list-item__content-title">{{ item.text }}</text>
</view>
<view class="uni-list-item__extra">
<radio :value="item.value" :checked="item.checked" />
</view>
</view>
</view>
</radio-group>
</view>
<uni-section title="Color" type="line"></uni-section>
<view class="example-body">
<radio-group class="uni-list" @change="colorChange">
<view v-for="(item, index) in colors" :key="index" class="uni-list-item">
<view class="uni-list-item__container">
<view class="uni-list-item__content">
<view :style="{ backgroundColor: item }" class="color-tag" />
</view>
<view class="uni-list-item__extra">
<radio :value="item" :checked="index === colorIndex" />
</view>
</view>
</view>
</radio-group>
</view>
</view>
</template>
```
### Example (Example 5)
```html
<script>
export default {
components: {},
data() {
return {
items: ['选项卡1', '选项卡2', '选项卡3'],
styles: [{
value: 'button',
text: '按钮',
checked: true
},
{
value: 'text',
text: '文字'
}
],
colors: ['#007aff', '#4cd964', '#dd524d'],
current: 0,
colorIndex: 0,
activeColor: '#007aff',
styleType: 'button'
}
},
methods: {
onClickItem(e) {
if (this.current !== e.currentIndex) {
this.current = e.currentIndex
}
},
styleChange(e) {
if (this.styleType !== e.detail.value) {
this.styleType = e.detail.value
}
},
colorChange(e) {
if (this.styleType !== e.detail.value) {
console.log(e.detail.value);
this.activeColor = e.detail.value
}
}
}
}
</script>
```
### Example (Example 6)
```html
<style lang="scss">
.example-body {
/* #ifndef APP-NVUE */
display: flex;
/* #endif */
flex-direction: row;
padding: 0;
}
.uni-common-mt {
margin-top: 30px;
}
.uni-padding-wrap {
// width: 750rpx;
padding: 0px 30px;
}
.content {
/* #ifndef APP-NVUE */
display: flex;
/* #endif */
justify-content: center;
align-items: center;
height: 150px;
text-align: center;
}
.content-text {
font-size: 14px;
color: #666;
}
.color-tag {
width: 25px;
height: 25px;
}
.uni-list {
flex: 1;
}
.uni-list-item {
/* #ifndef APP-NVUE */
display: flex;
/* #endif */
flex: 1;
flex-direction: row;
background-color: #FFFFFF;
}
.uni-list-item__container {
padding: 12px 15px;
width: 100%;
flex: 1;
position: relative;
/* #ifndef APP-NVUE */
display: flex;
box-sizing: border-box;
/* #endif */
flex-direction: row;
justify-content: space-between;
align-items: center;
border-bottom-style: solid;
border-bottom-width: 1px;
border-bottom-color: #eee;
}
.uni-list-item__content-title {
font-size: 14px;
}
</style>
```
Reference:
- [Official Documentation](https://uniapp.dcloud.net.cn/component/uniui/uni-segmented-control.html)
- [Plugin Marketplace](https://ext.dcloud.net.cn/plugin?name=segmented-control)
- [Local Example](examples/uni-ui/uni-segmented-control.vue)
Reference in New Issue View Git Blame Copy Permalink