Steps 步骤条


步骤条组件,建议步骤在2~3之内

使用指南

Taro-UI 版本需要在 v1.4.0 以上,在 Taro 文件中引入组件

  1. import { AtSteps } from 'taro-ui'

组件依赖的样式文件(仅按需引用时需要)

  1. @import "~taro-ui/dist/style/components/steps.scss";
    @import "~taro-ui/dist/style/components/icon.scss";

一般用法

说明:

  • 该组件为受控组件,开发者需要通过 onChange 事件来更新 current 值变化,current 与 onChange 函数必填
  1. import Taro from '@tarojs/taro'
    import { AtSteps } from 'taro-ui'
    export default class TimelinePage extends Taro.Component {
    constructor () {
    super(...arguments)
    this.state = {
    current: 0,
    }
    }
    onChange (current) {
    this.setState({
    current
    })
    }
    render () {
    const items = [
    { 'title': '步骤一', 'desc': '这里是额外的信息,最多两行' },
    { 'title': '步骤二', 'desc': '这里是额外的信息,最多两行' },
    { 'title': '步骤三', 'desc': '这里是额外的信息,最多两行' }
    ]
    return (
    <AtSteps
    items={items}
    current={this.state.current}
    onChange={this.onChange.bind(this)}
    />
    )
    }
    }

自定义图标

  1. import Taro from '@tarojs/taro'
    import { AtSteps } from 'taro-ui'
    export default class TimelinePage extends Taro.Component {
    constructor () {
    super(...arguments)
    this.state = {
    current: 0,
    }
    }
    onChange (current) {
    this.setState({
    current
    })
    }
    render () {
    const items = [
    {
    'title': '步骤一',
    'desc': '这里是额外的信息,最多两行',
    'icon': {
    value: 'sound',
    activeColor: '#fff',
    inactiveColor: '#78A4FA',
    size: '14',
    }
    },
    {
    'title': '步骤二',
    'desc': '这里是额外的信息,最多两行',
    'icon': {
    value: 'shopping-cart',
    activeColor: '#fff',
    inactiveColor: '#78A4FA',
    size: '14',
    }
    },
    {
    'title': '步骤三',
    'desc': '这里是额外的信息,最多两行',
    'icon': {
    value: 'camera',
    activeColor: '#fff',
    inactiveColor: '#78A4FA',
    size: '14',
    }
    }
    ]
    return (
    <AtSteps
    items={items}
    current={this.state.current}
    onChange={this.onChange.bind(this)}
    />
    )
    }
    }

状态步骤条

  1. import Taro from '@tarojs/taro'
    import { AtSteps } from 'taro-ui'
    export default class TimelinePage extends Taro.Component {
    constructor () {
    super(...arguments)
    this.state = {
    current: 0,
    }
    }
    onChange (current) {
    this.setState({
    current
    })
    }
    render () {
    const items = [
    {
    title: '步骤一',
    desc: '这里是额外的信息,最多两行',
    status: 'success'
    },
    {
    title: '步骤二',
    desc: '这里是额外的信息,最多两行'
    },
    {
    title: '步骤三',
    desc: '这里是额外的信息,最多两行',
    status: 'error'
    }
    ]
    return (
    <AtSteps
    items={items}
    current={this.state.current}
    onChange={this.onChange.bind(this)}
    />
    )
    }
    }

AtSteps 参数

参数微信小程序h5说明类型可选值默认值
current必填,当前步骤索引值,开发者需要通过 onChange 事件来更新 current 值Number-0
items步骤条数据列表, 具体字段详见下表Item[]--

AtSteps 事件

事件名称说明返回参数
onChange点击触发事件,开发者需要通过 onChange 事件来更新 current,onChange 函数必填current,步骤索引值

items object 字段说明

参数说明类型可选值默认值
title步骤标题String--
desc步骤说明文字String--
status步骤的状态,只允许 'success' 或 'error'String'success', 'error'-
icon图标信息,value: 图标类型,activeColor: 激活态颜色,inactiveColor: 非激活态颜色,size: 大小Object--

Steps步骤条 - 图1