vant/tree-select.md at 12fef85d3a3851f61ade3741b475c5266f00baa4

ui/vant

mirror of https://github.com/youzan/vant.git synced 2025-10-18 17:51:54 +00:00

Files

陈嘉涵 12fef85d3a [Doc] add english document of all basic components

2017-10-20 15:20:11 +08:00

3.5 KiB

Raw Blame History

TreeSelect 分类选择

使用指南

import { TreeSelect } from 'vant';

Vue.component(TreeSelect.name, TreeSelect);

代码演示

基础用法

:::demo 基础用法

<van-tree-select
  :items="items"
  :main-active-index="mainActiveIndex"
  :active-id="activeId"
  @navclick="onNavClick"
  @itemclick="onItemClick"
></van-tree-select>

export default {
  data() {
    return {
      items: items,
      // 左侧高亮元素的index
      mainActiveIndex: 0,
      // 被选中元素的id
      activeId: 1001
    };
  },
  methods: {
    onNavClick(index) {
      this.mainActiveIndex = index;
    },
    onItemClick(data) {
      console.log(data);
      this.activeId = data.id;
    }
  }
}

:::

API

传入参数

参数	说明	类型	默认值	必须
items	分类显示所需的数据，具体数据结构可看数据结构	Array	[]	-
mainActiveIndex	左侧导航高亮的索引	Number	0	-
activeId	右侧选择项，高亮的数据id	Number	0	-

事件

事件名	说明	参数
navclick	左侧导航点击时，触发的事件	index：被点击的导航的索引
itemclick	右侧选择项被点击时，会触发的事件	data: 该点击项的数据

数据格式

items 分类显示所需数据的数据结构

items 整体为一个数组，数组内包含一系列描述分类的 object。

每个分类里，text表示当前分类的名称。children 表示分类里的可选项，为数组结构，id被用来唯一标识每个选项

[
  {
    // 导航名称
    text: '所有城市',
    // 该导航下所有的可选项
    children: [
      {
        // 可选项的名称
        text: '温州',
        // 可选项的id，高亮的时候是根据id是否和选中的id是否相同进行判断的
        id: 1002
      },
      {
        // 可选项的名称
        text: '杭州',
        // 可选项的id，高亮的时候是根据id是否和选中的id是否相同进行判断的
        id: 1001
      }
    ]
  }
]

3.5 KiB Raw Blame History Unescape Escape