mirrors/vue-select
2
0
Fork 0
mirror of https://github.com/tenrok/vue-select.git synced 2026-06-13 08:32:26 +03:00
Code Activity

docs: customizing dropdown behaviour (#1520)

Browse Source
This commit is contained in:
Jeff Sagal
2021-10-17 13:38:36 -07:00
committed by GitHub
parent 14ea58b9e5
commit 3cf41402ef
3 changed files with 52 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/guide/opening.md
+22
View File
@@ -0,0 +1,22 @@
## Default Dropdown Behaviour
By default, the dropdown will open anytime the underlying search input has focus. The dropdown will
open when clicked, or when it has received focus when tabbing through inputs.
## Customizing Dropdown Behaviour <Badge text="v3.12.0+" />
The `dropdownShouldOpen` prop allows for full customization of the open/close behaviour. The prop
accepts a `function` that should return a `boolean` value. The returned boolean value will be used
to determine if the dropdown should be `open`/`true` or `false`/`closed`. The function receives the
instance of the component as the only argument.
#### Example: Open the dropdown when search text is present
---
In this example, we will wait to show the dropdown until the user has started typing. However, if a
country has already been selected, we will display the dropdown right away.
<OpenWhenSearchTextPresent />
<<< @/.vuepress/components/OpenWhenSearchTextPresent.vue