1 | # bee-cascader
|
2 |
|
3 | [![npm version](https://img.shields.io/npm/v/bee-cascader.svg)](https://www.npmjs.com/package/bee-cascader)
|
4 | [![Build Status](https://img.shields.io/travis/tinper-bee/bee-cascader/master.svg)](https://travis-ci.org/tinper-bee/bee-cascader)
|
5 | [![Coverage Status](https://coveralls.io/repos/github/tinper-bee/bee-cascader/badge.svg?branch=master)](https://coveralls.io/github/tinper-bee/bee-cascader?branch=master)
|
6 |
|
7 |
|
8 | ## Browser Support
|
9 |
|
10 | |![IE](https://raw.github.com/alrra/browser-logos/master/internet-explorer/internet-explorer_48x48.png) | ![Chrome](https://raw.github.com/alrra/browser-logos/master/chrome/chrome_48x48.png) | ![Firefox](https://raw.github.com/alrra/browser-logos/master/firefox/firefox_48x48.png) | ![Opera](https://raw.github.com/alrra/browser-logos/master/opera/opera_48x48.png) | ![Safari](https://raw.github.com/alrra/browser-logos/master/safari/safari_48x48.png)|
|
11 | | --- | --- | --- | --- | --- |
|
12 | | IE 9+ ✔ | Chrome 31.0+ ✔ | Firefox 31.0+ ✔ | Opera 30.0+ ✔ | Safari 7.0+ ✔ |
|
13 |
|
14 |
|
15 | react bee-cascader component for tinper-bee
|
16 |
|
17 | #### 组件引入
|
18 | 先进行下载cascader包
|
19 | ```
|
20 | npm install --save bee-cascader
|
21 | ```
|
22 | 组件调用
|
23 | ```js
|
24 | import { Cascader } from 'bee-cascader';
|
25 | React.render(<div>
|
26 | <div>
|
27 | <Cascader />
|
28 | </div>
|
29 | </div>, document.getElementById('target'));
|
30 | ```
|
31 | #### 样式引入
|
32 | - 可以使用link引入dist目录下cascader
|
33 | ```
|
34 | <link rel="stylesheet" href="./node_modules/build/bee-cascader.css">
|
35 | ```
|
36 | - 可以在js中import样式
|
37 | ```js
|
38 | import "./node_modules/src/cascader"
|
39 | //或是
|
40 | import "./node_modules/build/bee-cascader.css"
|
41 | ```
|
42 |
|
43 |
|
44 |
|
45 | ## API
|
46 |
|
47 | |参数|说明|类型|默认值|
|
48 | |:---|:----|:---|:------|
|
49 | |placeholder |input提示信息| string |""|
|
50 | |options |下拉列表数据 |json| 必填,无默认值|
|
51 | |defaultValue|默认的选中项| string[]|[]|
|
52 | |changeOnSelect|当此项为 true 时,点选每级菜单选项值都会发生变化| boolean|false|
|
53 | |disabled|禁用| boolean|false|
|
54 | |expandTrigger|次级菜单的展开方式,可选 'click' 和 'hover'| string|'click'|
|
55 | |size|输入框大小,可选 lg md sm| string|'md'|
|
56 | |onChange |选择完成后的回调| Function(value, selectedOptions)| -|
|
57 | |onClick |选中节点的钩子函数,返回array选中的节点| function | -|
|
58 |
|
59 |
|
60 | options格式如下:
|
61 | ```bash
|
62 | const options = [
|
63 | label: '浙江',
|
64 | value: 'zj',
|
65 | children: [{
|
66 | label: '杭州',
|
67 | value: 'hz',
|
68 | children: [{
|
69 | label: '西湖',
|
70 | value: 'xh',
|
71 | children: [{
|
72 | label: '白娘子',
|
73 | value: 'bnz'
|
74 | },{
|
75 | label: '许仙',
|
76 | value: 'xx'
|
77 | }]
|
78 | }]
|
79 | }]
|
80 | },
|
81 | {
|
82 | label: '江苏',
|
83 | value: 'js',
|
84 | children: [{
|
85 | label: '南京',
|
86 | value: 'nj',
|
87 | children: [{
|
88 | label: '中华门',
|
89 | value: 'zhm'
|
90 | }]
|
91 | }]
|
92 | },
|
93 | {
|
94 | label: '山东',
|
95 | value: 'sd'
|
96 | }
|
97 | ];
|
98 | ```
|
99 |
|
100 | #### setup develop environment
|
101 |
|
102 | ```sh
|
103 | $ git clone https://github.com/tinper-bee/bee-cascader
|
104 | $ cd bee-cascader
|
105 | $ npm install
|
106 | $ npm run dev
|
107 | ```
|
108 | ### TODO
|
109 | - test
|
110 |
|
111 |
|