naive-ui/demo/documentation/components/select/zhCN/index.md

76 lines
2.3 KiB
Markdown
Raw Normal View History

2020-02-04 20:32:03 +08:00
# 选择器 Select
选点啥!
## 演示
2019-09-25 12:19:57 +08:00
```demo
basic
2020-02-04 20:32:03 +08:00
size
multiple
events
filterable
tag
2020-02-04 20:32:03 +08:00
remote
remote-multiple
clearable
scroll-event
group
many-options
custom-option
action
2020-04-29 22:05:35 +08:00
fallback-option
change-debug
2019-09-25 12:19:57 +08:00
```
2020-02-04 20:32:03 +08:00
## V-model
|prop|event|
|-|-|
|value|change|
## Props
2020-02-07 23:40:07 +08:00
|名称|类型|默认值|说明|
2020-02-04 20:32:03 +08:00
|-|-|-|-|
|theme|`'light' \| 'dark'`|`null`||
2020-02-04 20:32:03 +08:00
|loading|`boolean`|`false`||
|clearable|`boolean`|`false`||
2020-04-29 22:05:35 +08:00
|value|`Array<string \| number> \| string \| number`|`false`||
2020-02-05 23:14:00 +08:00
|placeholder|`string`|`'请选择'`||
2020-02-04 20:32:03 +08:00
|multiple|`boolean`|`false`||
|size|`'small' \| 'medium' \| 'large'`|`'medium'`||
|disabled|`boolean`|`false`||
|options|`Array<SelectOption \| SelectOptionGroup>`|`[]`||
|remote|`boolean`|`false`|是否要异步获取选项。注意如果设定了,那么 `fitler``tag` 都不会对 `options` 生效。这个时候你在全权控制 `options`|
|filterable|`boolean`|`false`|是否可以过滤|
|filter|`(pattern: string, option: Object) => boolean`|一个简单的字符串搜索算法||
|tag|`boolean`|`false`|是否可以创建新的选项,需要和 `filterable` 一起使用|
|on-create|`(label: string) => SelectOption`|`label => ({ label, value: label })`|在输入内容时如何创建一个选项。注意 `filter` 对这个生成的选项同样会生效。同时确保这个选项和其他选项的 `value` 不要有重复|
|fallback-option|`false \| (value: string \| number) => SelectOption`|`value => ({ label: '' + value, value })`|在传入的选项中没有对应当前值的选项时,这个值应该对应的选项。如果设为 `false`,不会为找不到对应选项的值生成回退选项也不会显示它,未在选项中的值会被视为不合法,操作过程中会被组件清除掉|
### SelectOption Properties
|名称|类型|说明|
2020-02-04 20:32:03 +08:00
|-|-|-|
|class|`string`||
2020-02-04 20:32:03 +08:00
|disabled|`boolean`||
|label|`string`||
2020-02-04 20:32:03 +08:00
|render|`function`||
|style|`string`||
|value|`string \| number`|在选项中应该是唯一的|
2020-02-04 20:32:03 +08:00
### SelectOptionGroup Properties
|名称|类型|说明|
2020-02-04 20:32:03 +08:00
|-|-|-|
|children|`Array<SelectOption>`||
|name|`string`||
|type|`'group'`||
2020-02-04 20:32:03 +08:00
## Slots
2020-02-14 23:06:50 +08:00
|名称|参数|说明|
|-|-|-|
|action|`()`||
2020-02-04 20:32:03 +08:00
## Event
2020-02-14 23:06:50 +08:00
|名称|参数|说明|
2020-02-04 20:32:03 +08:00
|-|-|-|
|blur|`()`|选择器 Blur 时发出|
|change|`(value: Array \| string \| number \| null)`||
2020-02-04 20:32:03 +08:00
|scroll|`(e: Event)`|选择菜单在滚动|
|search|`(value: string)`||
2020-02-04 20:32:03 +08:00