@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-select

Usage

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

1. Check or create an issue and discuss the change
2. Fork the repository and create a new branch
3. Make your changes and add tests where possible
4. Follow Conventional Commits for commit messages
5. Submit a pull request

Please read the Code of Conduct.

License

MIT