Skip to content

About

Everything you wish the HTML <select> element could do, wrapped up into a lightweight, extensible Vue component.

Resources

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

 
 

Repository files navigation

@nextcloud/vue-select

npm last version REUSE status MIT License

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

About

Everything you wish the HTML <select> element could do, wrapped up into a lightweight, extensible Vue component.

Resources

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages