# tui-steps 步骤条 开源组件
介绍
Steps步骤条: 支持横向与纵向以及基本样式设置。
# 引入
# uni-app引入
第一种,手动引入(可全局引入)
import tuiSteps from "@/components/thorui/tui-steps/tui-steps.vue"
export default {
components:{
tuiSteps
}
}
第二种,开启easycom组件模式,如果不了解如何配置,可先查看 官网文档 (opens new window)。
# uni-app版本平台差异说明
App-Nvue | App-vue | H5 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|---|
升级中 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
# 微信小程序引入(可在app.json中全局引入)
{
"usingComponents": {
"tui-steps": "/components/thorui/tui-steps/tui-steps"
}
}
# 代码演示
部分功能演示,具体可参考示例程序以及文档API。
水平方向
通过 items
属性设置步骤项。 spacing
属性为间距,item项宽度。activeSteps
属性为当前进行至哪一步骤。
<!--uni-app-->
<tui-steps :items="items" spacing="180rpx" :activeSteps="activeSteps"></tui-steps>
// data 数据 及 方法
export default {
data() {
return {
items: [{
title: "步骤一",
desc: "2020-04-01"
}, {
title: "步骤二",
desc: "2020-04-01"
}, {
title: "步骤三",
desc: "2020-04-01"
}, {
title: "步骤四",
desc: "2020-04-01"
}],
activeSteps: 1
}
},
methods: {
}
}
<!--微信小程序-->
<tui-steps items="{{items}}" spacing="180rpx" activeSteps="{{activeSteps}}"></tui-steps>
// data 数据 及 方法
Page({
data: {
items: [{
title: "步骤一",
desc: "2020-04-01"
}, {
title: "步骤二",
desc: "2020-04-01"
}, {
title: "步骤三",
desc: "2020-04-01"
}, {
title: "步骤四",
desc: "2020-04-01"
}],
activeSteps: 1
}
})
// Make sure to add code blocks to your code group
数字步骤
通过 type
属性设置步骤条类型。1-默认步骤 ,2-数字步骤。
<!--uni-app-->
<tui-steps :type="2" :items="items" spacing="180rpx" :activeSteps="activeSteps"></tui-steps>
// data 数据 及 方法
export default {
data() {
return {
items: [{
title: "步骤一",
desc: "2020-04-01"
}, {
title: "步骤二",
desc: "2020-04-01"
}, {
title: "步骤三",
desc: "2020-04-01"
}, {
title: "步骤四",
desc: "2020-04-01"
}],
activeSteps: 1
}
},
methods: {
}
}
<!--微信小程序-->
<tui-steps type="{{2}}" items="{{items}}" spacing="180rpx" activeSteps="{{activeSteps}}"></tui-steps>
// data 数据 及 方法
Page({
data: {
items: [{
title: "步骤一",
desc: "2020-04-01"
}, {
title: "步骤二",
desc: "2020-04-01"
}, {
title: "步骤三",
desc: "2020-04-01"
}, {
title: "步骤四",
desc: "2020-04-01"
}],
activeSteps: 1
}
})
// Make sure to add code blocks to your code group
垂直方向步骤条
通过 direction
属性设置步骤条方向。row-水平方向 ,column-垂直方向。默认为 row
水平方向。
<!--uni-app-->
<tui-steps direction="column" :items="items" spacing="180rpx" :activeSteps="activeSteps"></tui-steps>
// data 数据 及 方法
export default {
data() {
return {
items: [{
title: "步骤一",
desc: "2020-04-01"
}, {
title: "步骤二",
desc: "2020-04-01"
}, {
title: "步骤三",
desc: "2020-04-01"
}, {
title: "步骤四",
desc: "2020-04-01"
}],
activeSteps: 1
}
},
methods: {
}
}
<!--微信小程序-->
<tui-steps direction="column" items="{{items}}" spacing="180rpx" activeSteps="{{activeSteps}}"></tui-steps>
// data 数据 及 方法
Page({
data: {
items: [{
title: "步骤一",
desc: "2020-04-01"
}, {
title: "步骤二",
desc: "2020-04-01"
}, {
title: "步骤三",
desc: "2020-04-01"
}, {
title: "步骤四",
desc: "2020-04-01"
}],
activeSteps: 1
}
})
// Make sure to add code blocks to your code group
# Slots
插槽名称 | 插槽说明 |
---|---|
- | - |
# Props
属性名 | 类型 | 说明 | 默认值 |
---|---|---|---|
type | Number | 1-默认步骤 2-数字步骤 | 1 |
spacing | String | 间距 | 160rpx |
direction | String | 方向 row column | row |
activeColor | String | 激活状态成功颜色 | #5677fc |
deactiveColor | String | 未激活状态颜色 | #999999 |
titleSize | Number | title字体大小 | 28 |
bold | Boolean | title是否粗体 | false |
descSize | Number | desc字体大小 | 24 |
activeSteps | Number | 当前步骤 | -1 |
lineStyle | String | 线条样式 同border线条样式 | solid |
items | Array | 步骤项 | [ ] |
backgroundColor | String | 自定义item内容时背景色 | #fff |
items 属性 Object对象参数说明
[{
title: "标题",
desc: "描述",
name:"字体图标name值,请查看tui-icon组件",
size:"字体图标大小,单位px",
icon:"图片图标地址",
activeIcon:"已完成步骤显示的图片图标地址"
}]
# Events
注:uni-app端绑定事件使用@前缀,如@click;微信小程序原生使用bind前缀,如bindclick
事件名 | 说明 | 回调参数 |
---|---|---|
click | 步骤点击事件 | {index: Number} //当前点击的步骤索引 |
# 预览
请以移动端效果为准,touch事件目前尚未在PC端做兼容。
# 特别说明
# 线上程序扫码预览
![]() | ![]() | ![]() |
---|---|---|
ThorUI组件库小程序码 | H5二维码 | ThorUI示例小程序码 |