Skip to content

Commit 173ebd2

Browse files
authored
improve readme wording
1 parent c1c93ed commit 173ebd2

1 file changed

Lines changed: 11 additions & 3 deletions

File tree

README.md

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -180,11 +180,19 @@ methods: {
180180
}
181181
```
182182

183-
## ⚠️ Important: Options API Dependency
183+
## ⚠️ Build Tool Compatibility
184184

185-
vue-multiselect requires Vue's Options API to function properly. Do not disable the Options API in your build configuration.
185+
**vue-multiselect requires Vue's Options API to function properly.** There are known issues with certain versions of `@vitejs/plugin-vue` that may inadvertently disable the Options API.
186186

187-
If you're using Vite with @vitejs/plugin-vue, make sure your __VUE_OPTIONS_API__ is set to `true` in your configuration:
187+
### Known Issue with @vitejs/plugin-vue
188+
189+
If you're experiencing issues after updating `@vitejs/plugin-vue` to version 5.2.2 or later, consider downgrading to version 5.2.1:
190+
191+
```bash
192+
npm install @vitejs/plugin-vue@5.2.1
193+
```
194+
195+
This issue occurs because changes in the plugin's configuration handling can disable the Options API even when not explicitly configured. See [issue #1901](https://github.com/shentao/vue-multiselect/issues/1901) for more details.
188196

189197

190198
## Special Thanks

0 commit comments

Comments
 (0)