@nextcloud/vue-select
v4.1.0
Published
Everything you wish the HTML <select> element could do, wrapped up into a lightweight, extensible Vue component.
Keywords
Readme
@nextcloud/vue-select
Lightweight, accessible select/dropdown/typeahead component for Vue 3.
This package was originally forked from vue-select to implement accessibility improvements and is actively maintained by Nextcloud.
- Tagging
- Filtering / Searching
- AJAX Support
- SSR Support
- Accessible
- Select Single/Multiple Options
- Customizable with slots and CSS variables
- Zero dependencies
Documentation
For props, slots, and events refer to the upstream vue-select documentation. Note that this fork may diverge — CSS theming uses custom properties instead of SCSS.
Compatibility
| Version | Vue | |---------|------| | 4.x | ^3.0 | | 3.x | ^2.6 |
Install
npm i @nextcloud/vue-selectUsage
Import and register the component:
import { VueSelect } from '@nextcloud/vue-select'CSS is included automatically via the JS import. All styling is done via CSS custom properties (--vs-*), making it easy to theme without a preprocessor.
Contributing
- Check or create an issue and discuss the change
- Fork the repository and create a new branch
- Make your changes and add tests where possible
- Follow Conventional Commits for commit messages
- Submit a pull request
Please read the Code of Conduct.
