diff --git a/docs/en-US/component/select.md b/docs/en-US/component/select.md index 23f40d96a1..63868d0317 100644 --- a/docs/en-US/component/select.md +++ b/docs/en-US/component/select.md @@ -114,39 +114,41 @@ If the binding value of Select is an object, make sure to assign `value-key` as | Attribute | Description | Type | Accepted Values | Default | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------------------- | ---------------- | | model-value / v-model | binding value | array / string / number / boolean / object | — | — | -| multiple | whether multiple-select is activated | boolean | — | false | -| disabled | whether Select is disabled | boolean | — | false | +| multiple | whether multiple-select is activated | boolean | true / false | false | +| disabled | whether Select is disabled | boolean | true / false | false | | value-key | unique identity key name for value, required when value is an object | string | — | value | | size | size of Input | string | large/default/small | default | -| clearable | whether select can be cleared | boolean | — | false | -| collapse-tags | whether to collapse tags to a text when multiple selecting | boolean | — | false | +| clearable | whether select can be cleared | boolean | true / false | false | +| collapse-tags | whether to collapse tags to a text when multiple selecting | boolean | true / false | false | | collapse-tags-tooltip | whether show all selected tags when mouse hover text of collapse-tags. To use this, `collapse-tags` must be true | boolean | true / false | false | | multiple-limit | maximum number of options user can select when `multiple` is `true`. No limit when set to 0 | number | — | 0 | | name | the name attribute of select input | string | — | — | | effect | Tooltip theme, built-in theme: `dark` / `light` | string | string | light | | autocomplete | the autocomplete attribute of select input | string | — | off | | placeholder | placeholder | string | — | Select | -| filterable | whether Select is filterable | boolean | — | false | -| allow-create | whether creating new items is allowed. To use this, `filterable` must be true | boolean | — | false | +| filterable | whether Select is filterable | boolean | true / false | false | +| allow-create | whether creating new items is allowed. To use this, `filterable` must be true | boolean | true / false | false | | filter-method | custom filter method | function | — | — | -| remote | whether options are loaded from server | boolean | — | false | +| remote | whether options are loaded from server | boolean | true / false | false | | remote-method | custom remote search method | function | — | — | -| loading | whether Select is loading data from server | boolean | — | false | +| remote-show-suffix | in remote search method show suffix icon | boolean | true / false | false | +| loading | whether Select is loading data from server | boolean | true / false | false | | loading-text | displayed text while loading data from server | string | — | Loading | | no-match-text | displayed text when no data matches the filtering query, you can also use slot `empty` | string | — | No matching data | | no-data-text | displayed text when there is no options, you can also use slot `empty` | string | — | No data | | popper-class | custom class name for Select's dropdown | string | — | — | -| reserve-keyword | when `multiple` and `filter` is true, whether to reserve current keyword after selecting an option | boolean | — | true | -| default-first-option | select first matching option on enter key. Use with `filterable` or `remote` | boolean | - | false | -| popper-append-to-body(deprecated) | whether to append the popper menu to body. If the positioning of the popper is wrong, you can try to set this prop to false | boolean | - | true | +| reserve-keyword | when `multiple` and `filter` is true, whether to reserve current keyword after selecting an option | boolean | true / false | true | +| default-first-option | select first matching option on enter key. Use with `filterable` or `remote` | boolean | true / false | false | +| popper-append-to-body(deprecated) | whether to append the popper menu to body. If the positioning of the popper is wrong, you can try to set this prop to false | boolean | true / false | true | | teleported | whether select dropdown is teleported to the body | boolean | true / false | true | | persistent | when select dropdown is inactive and `persistent` is `false`, select dropdown will be destroyed | boolean | true / false | true | -| automatic-dropdown | for non-filterable Select, this prop decides if the option menu pops up when the input is focused | boolean | - | false | +| automatic-dropdown | for non-filterable Select, this prop decides if the option menu pops up when the input is focused | boolean | true / false | false | | clear-icon | Custom clear icon component | `string \| Component` | — | CircleClose | -| fit-input-width | whether the width of the dropdown is the same as the input | boolean | — | false | -| suffix-icon | Custom suffix icon component | `string \| Component` | — | ArrowUp | +| fit-input-width | whether the width of the dropdown is the same as the input | boolean | true / false | false | +| suffix-icon | Custom suffix icon component | `string \| Component` | — | ArrowDown | +| suffix-transition | animation when dropdown appears/disappears icon | boolean | true / false | true | | tag-type | tag type | string | success/info/warning/danger | info | -| validate-event | whether to trigger form validation | boolean | - | true | +| validate-event | whether to trigger form validation | boolean | true / false | true | | placement | position of dropdown | string | top/top-start/top-end/bottom/bottom-start/bottom-end/left/left-start/left-end/right/right-start/right-end | bottom-start | ## Select Events diff --git a/docs/examples/select/remote-search.vue b/docs/examples/select/remote-search.vue index 465106bba7..9b3d50c3c6 100644 --- a/docs/examples/select/remote-search.vue +++ b/docs/examples/select/remote-search.vue @@ -1,21 +1,67 @@