级联菜单 Cascader
issue

级联选择框。

何时使用

  • 需要从一组相关联的数据集合进行选择,例如省市区,公司层级,事物分类等。

  • 从一个较大的数据集合中进行选择时,用多级分类进行分隔,方便选择。

  • 比起 Select 组件,可以在同一个浮层中完成选择,有较好的体验。

如何使用

import { Cascader } from 'tinper-bee';

or

import Cascader from 'bee-cascader';
import 'bee-cascader/build/Cascader.css';

能力特性

API

参数 说明 类型 默认值
placeholder input提示信息 string ""
options 下拉列表数据 json 必填,无默认值
defaultValue 默认的选中项 string[] []
changeOnSelect 当此项为 true 时,点选每级菜单选项值都会发生变化 boolean false
disabled 禁用 boolean false
expandTrigger 次级菜单的展开方式,可选 'click' 和 'hover' string 'click'
size 输入框大小,可选 lg md sm string 'md'
onChange 选择完成后的回调 Function(value, selectedOptions) -
onClick 选中节点的钩子函数,返回array选中的节点 function -
inputValue 自定义输入框展示内容 string -
separator 分隔符自定义 string '/ '

注意事项

暂无

更新日志

  • v2.1.8 2020-04-24 ( release地址 )

    Bug Fixes

  • v2.1.6 2019-09-10 ( release地址 )

    • bee-cascader @2.1.6
      • [Feature]新增 separator API,用于自定义分隔符。
  • v2.1.5 2019-09-04 ( release地址 )

    • bee-cascader @2.1.5
      • [ Fixbug ] 解决了点击清除按钮时,被包裹在form中的级联组件Cascader的值不会被清除。 #300
  • v2.1.4 2019-05-06 ( release地址 )

    • bee-cascader @2.1.4
      • [Feature]增加 inputValue API,支持自定义输入框展示内容
  • v2.1.3 2019-03-28 ( release地址 )

    • [Fixbug]解决Safari浏览器中下拉面板错位的问题
  • v2.1.2 2019-03-28 ( release地址 )

    • bee-cascader @2.1.2
      • [Fixbug]解决清空已选后,下拉面板中的状态未更新问题
      • [Feature]placeholder字体大小统一为12px,禁用图标色为#c1c7d0
  • v2.1.1 2019-03-19 ( release地址 )

    bee-cascader v2.1.1升级内容

    • [Feature]bee-cascader @2.1.1
      • 选中背景色统一为 #FFF7E7
      • 下拉面板去掉边框
  • v2.1.0 2019-03-15 ( release地址 )

    • bee-cascader @2.1.0,组件整体重构,按UI规范更新组件
      • [Fixbug]解决选择后,下拉面板中没有保留已选信息的问题
      • [Fixbug]解决选择一级选项并清空,再次选择同一选项时,值选不上的问题
      • [Feature]增加清空已选功能
      • [Feature]增加指定默认值
      • [Feature]增加expandTrigger参数,鼠标hover时展开菜单功能
      • [Feature]增加disabled禁用状态
      • [Feature]增加changeOnSelect属性,点选每级菜单选项值都会发生变化
      • [Feature]增加size属性,设置不同尺寸的级联菜单
  • v2.0.3 2019-03-07 ( release地址 )

    • [Feature]bee-cascader @2.0.3
      • 下拉面板hover样式调整
      • 输入框和form-control样式统一