npm 包 cascaderpicker 使用教程

阅读时长 6 分钟读完

简介

CascaderPicker 是一个基于 Vue.js 2.0 的级联选择器组件,它支持多级联动,可以应用于省市区、商品分类等选择场景。

安装

你可以通过 npm 来安装 CascaderPicker,命令如下:

使用

在 Vue 组件中,使用以下代码来引入 CascaderPicker 组件:

-- -------------------- ---- -------
----------
  -----
    ---------------- ------------ ----------------------------------
  ------
-----------

--------
------ -------------- ---- ----------------

------ ------- -
  ----------- -
    --------------
  --
  ---- -- -
    ------ -
      ----- -
        - ------ ----- ------ ------ --------- -
          - ------ ------ ------ ----- --
          - ------ ------ ------ ----- --
          - ------ ------ ------ ----- --
          - ------ ------ ------ ----- --
          - ------ ------ ------ ------ --
          - ------ ------ ------ ----- --
          - ------ ------- ------ ------ --
          - ------ ------- ------ ----- -
        ---
        - ------ ----- ------ ------ --------- -
          - ------ ------- ------ ----- --
          - ------ ------- ------ ----- --
          - ------ ------- ------ ----- --
          - ------ ------ ------ ----- --
          - ------ ------- ------ ----- --
          - ------ ------- ------ ----- -
        --
      --
      ------ --
    -
  -
-
---------

在以上代码中,我们引入了 CascaderPicker 组件,并在 data 中写了一个简单的选项数据结构。我们将 data 和 value 绑定到了 CascaderPicker 上,即我们的选项显示会根据 data 内容动态渲染,并且我们选择的数据也会双向绑定到 value 变量上。

API

CascaderPicker 组件支持以下属性:

props

属性 描述 类型 默认值
data 选项数据源(含子级) Array<object> []
title 标题(顶部) String ''
placeholder 占位提示语 String '请选择'
disabled 是否禁用 Boolean false
separator 选项连接字符串 String '-'
focus 是否自动聚焦 Boolean false
hideSelected 是否隐藏已选选项 Boolean false
clearable 是否可清空 Boolean true
multiple 是否多选 Boolean false
collapseTags 多选时是否将选中值按文字方式展示 Boolean false
showAllLevels 是否展示所有层级 Boolean | Number false
maxHeight 可视高度 Number | String 'auto'
transitionName 过渡动画 String 'slide'
changeOnSelect 当此项为 true 时,选中后立即隐藏父级选项 Boolean false
value 组件的值(支持双向绑定) Array<string|number|object> []

events

事件 描述 参数
change 当选择项变化的时候触发 [选中的值数组]
expand 当展开子级的时候触发 [选中的值数组], 点击的选项
collapse 当隐藏子级的时候触发 [选中的值数组], 点击的选项
blur 当失去焦点的时候触发 event
focus 当获取焦点的时候触发 event

总结

CascaderPicker 是一个轻量级、易于使用和扩展的级联选择器组件,支持多级联动和双向绑定,对前端工程师来说,这是一个不可多得的好工具。我们希望你能够使用 CascaderPicker 解决你的问题,如果你想深入了解该组件的实现原理,可以到官方文档页面查阅更多资料。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005739581e8991b448e9858

纠错
反馈