级联下拉选择组件
安装 npm install @beisen-phoenix/cascader --save
组件简介:从一个较大的数据集合中进行选择时,用多级分类进行分隔,方便选择。
#change 在 3.X 版本以后将默认导出修改为了组合好的级联选择器,选来的使用者可以用 import {CascaderNomal} from "@beisen-phoenix/cascader" 来保持原来的使用方式
默认导出为组合好的级联下拉选择器,参数如下
参数 |
说明 |
默认值 |
类型 |
是否必填 |
options |
数据 |
无 |
OptionItemProps[] |
必填 |
text |
选择框里显示的文本 |
无 |
string |
非必填 |
value |
选择的value值 |
无 |
string[] |
非必填 |
onChange |
选择内容发生变化的change事件 |
无 |
OnChangeType |
非必填 |
placeHolder |
选择框的placeholder值 |
请选择 |
string |
非必填 |
error |
选择框的错误状态 |
false-->无错 |
boolean |
非必填 |
disabled |
选择框的禁用状态 |
false-->不禁用 |
boolean |
非必填 |
size |
选择框的大小 |
normal |
small|normal|large |
非必填 |
prefixCls |
下拉弹层的包裹层classname |
无 |
cascader |
非必填 |
blockContainer |
外层容器的显示类型(true 是 block 类型,false 则是 inline-block) |
false |
Boolean |
非必填 |
除了默认导出了组合好的,为了更加方便使用者调用,还导出了未组合的组件,使用者可以自行选择合适的方式组合,参数如下
使用方式 import {CascaderNomal} from "@beisen-phoenix/cascader"
参数 |
说明 |
默认值 |
类型 |
是否必填 |
options |
数据 |
无 |
OptionItemProps[] |
必填 |
value |
可以设置默认选中的值 |
无 |
string[] |
非必填 |
onChange |
选择内容发生变化的change事件 |
无 |
OnChangeType |
非必填 |
prefixCls |
下拉弹层的包裹层classname |
无 |
cascader |
非必填 |
// option的值类型
export interface OptionItemProps {
label?: string; //显示文本
value?: string; //value值
disabled?: Boolean; //是否禁选
isLeaf?: Boolean; //是否是子节点
children?: OptionItemProps[]; //子节点
[propName: string]: any;
}
//onChange事件的类型
export type OnChangeType = (
value: string[],
selectedOptions: OptionItemProps[]
) => void;