From a0bbda7193b7a517a8f3a36f3ec10c3151f8a1d3 Mon Sep 17 00:00:00 2001 From: baiyaaaaa Date: Sun, 28 Aug 2016 00:14:05 +0800 Subject: [PATCH] fixed autocomplete --- examples/docs/autocomplete.md | 332 ---------- examples/docs/input.md | 654 ++++++++++++++++---- examples/nav.config.json | 5 - packages/autocomplete/src/autocomplete.vue | 82 ++- packages/theme-default/src/autocomplete.css | 25 +- 5 files changed, 578 insertions(+), 520 deletions(-) delete mode 100644 examples/docs/autocomplete.md diff --git a/examples/docs/autocomplete.md b/examples/docs/autocomplete.md deleted file mode 100644 index 026990a6b..000000000 --- a/examples/docs/autocomplete.md +++ /dev/null @@ -1,332 +0,0 @@ - - - -## 基础使用 - -
- -
- -```html - - -``` - -## 自定义模板 - -
- -
- -```html - - - -``` - -## 服务端数据 - -
- -
- -```html - - -``` - -## API -| 参数 | 说明 | 类型 | 可选值 | 默认值 | -|------------- |---------------- |---------------- |---------------------- |-------- | -| placeholder | 输入框占位文本 | string | | | -| disabled | 禁用 | boolean | true, false | false | -| value | 必填值输入绑定值 | string | | | -| showOnUpDown | 是否通过键盘上下键控制建议列表 | boolean | | | -| fetch-suggestions | 返回输入建议的方法,组件内部通过调用该方法来获得输入建议的数据,在该方法中,仅当你的输入建议数据 resolve 时再通过调用 callback(data:[]) 来返回它 | Function(queryString, callback) | | | diff --git a/examples/docs/input.md b/examples/docs/input.md index 5afbd0b20..96b3444cb 100644 --- a/examples/docs/input.md +++ b/examples/docs/input.md @@ -1,5 +1,19 @@ -## 基本用法 +## Input 输入框 -
- - - - -
+通过鼠标或键盘输入字符 +### 基础用法 + +::: demo ```html - - + v-model="input"> ``` +::: -## 禁用状态 -
- - -
+### 禁用状态 +::: demo 通过 `disabled` 属性指定是否禁用 input 组件 ```html + v-model="input1" + :disabled="true"> ``` +::: -## Input 图标 +### 带 icon 的输入框 -
- - -
+带有图标标记输入类型 +::: demo 可以通过 `icon` 属性在 input 组件尾部增加显示图标。 ```html + v-model="input2"> ``` +::: -## Input Group +### 文本域 -### 后置元素 - -
- - - -
+可调整大小,用于输入多行文本信息 +::: demo 通过将 `type` 属性的值指定为 textarea。 ```html - - + ``` +::: -### 前置元素 -
- - - -
+### 复合型输入框 +可前置或后置元素,一般为标签或按钮 + +::: demo 可通过 slot 来指定在 input 中前置或者后置内容。 ```html - + -``` - -### 前置和后置元素 -
- - - - - - - - -
- -```html - + + + + @@ -155,81 +256,370 @@ ``` +::: -## 尺寸 -### large +### 尺寸 -
+::: demo 可通过 `size` 属性指定输入框的尺寸,除了默认的大小外,还提供了 large、small 和 mini 三种尺寸。 +```html +
+ v-model="input6"> -
- -### normal - -
+ v-model="input7"> -
- -### small - -
+ v-model="input8"> -
- -### mini - -
+ v-model="input9">
- -```html - - - - - - - - ``` +::: + +### 带输入建议 + +根据输入内容提供对应的输入建议 + +::: demo autocomplete 是一个可带输入建议的输入框组件,`fetch-suggestions` 是一个返回输入建议的方法属性,如 querySearch(queryString, cb),在该方法中你可以在你的输入建议数据准备好时通过 cb(data) 返回到 autocomplete 组件中。 +```html + + +
激活即列出输入建议
+ +
+ +
输入后匹配输入建议
+ +
+
+ +``` +::: + +### 自定义模板 + +可自定义输入建议的显示 + +::: demo +```html + + + +``` +::: + +### 远程搜索 + +从服务端搜索数据 + +::: demo +```html + + +``` +::: + +### Input API -## API | 参数 | 说明 | 类型 | 可选值 | 默认值 | |------------- |---------------- |---------------- |---------------------- |-------- | -| type | 同原生的 input 的 type 属性,如果为textarea则显示为extarea | string | | | -| name | 同原生的 input 的 name 属性 | string | | | -| model | 绑定值 | string, number | | | -| maxlength | 最大输入长度 | number | | | -| minlength | 最小输入长度 | number | | | -| placeholder | 输入框占位文本 | string | | | -| disabled | 禁用 | boolean | true, false | false | -| readonly | 禁用 | boolean | true, false | false | -| size | 输入框尺寸 | string | large, small, mini | | -| icon | 输入框尾部图标 | string | | | -| number | 指定model值为number类型 | boolean | | false | +| type | 同原生的 input 的 type 属性,如果为textarea则显示为extarea | string | — | — | +| value | 绑定值 | string, number | — | — | +| maxlength | 最大输入长度 | number | — | — | +| minlength | 最小输入长度 | number | — | — | +| placeholder | 输入框占位文本 | string | — | — | +| disabled | 禁用 | boolean | — | false | +| size | 输入框尺寸 | string | large, small, mini | — | +| icon | 输入框尾部图标 | string | — | — | +| number | 指定model值为number类型 | boolean | — | false | + +### Autocomplete API + +| 参数 | 说明 | 类型 | 可选值 | 默认值 | +|------------- |---------------- |---------------- |---------------------- |-------- | +| placeholder | 输入框占位文本 | string | — | — | +| disabled | 禁用 | boolean | — | false | +| value | 必填值输入绑定值 | string | — | — | +| custom-item | 通过该参数指定自定义的输入建议列表项的组件名 | string | — | — | +| fetch-suggestions | 返回输入建议的方法,仅当你的输入建议数据 resolve 时,通过调用 callback(data:[]) 来返回它 | Function(queryString, callback) | — | — | + diff --git a/examples/nav.config.json b/examples/nav.config.json index 7c89fffa1..d0465dad8 100644 --- a/examples/nav.config.json +++ b/examples/nav.config.json @@ -137,11 +137,6 @@ "title": "Form 表单", "description": "一个多功能的并带有字段验证的表单组件" }, - { - "path": "/autocomplete", - "name": "自动完成 (autocomplete)", - "title": "Autocomplete 自动完成" - }, { "path": "/rate", "name": "评分 (rate)", diff --git a/packages/autocomplete/src/autocomplete.vue b/packages/autocomplete/src/autocomplete.vue index b7e453843..f8a333ef9 100644 --- a/packages/autocomplete/src/autocomplete.vue +++ b/packages/autocomplete/src/autocomplete.vue @@ -13,35 +13,31 @@ >
    -
  • - {{item.display}} -
  • - - +
  • +
- -
- -
-