Skip to content

Commit 52d79d9

Browse files
committed
docs: add theme breaking changes to v5 upgrade guide
1 parent aabe84b commit 52d79d9

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

packages/docs/src/pages/en/getting-started/upgrade-guide.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -235,6 +235,27 @@ export default createVuetify({
235235

236236
Theme colors now support transparency. `rgb(var(--v-theme-color))` will continue to work the same as before, but `rgba(var(--v-theme-color), 0.8)` should be changed to either `color-mix(in srgb, rgb(var(--v-theme-color)) 80%, transparent)` or `rgb(from rgb(var(--v-theme-color)) / 0.8)` when used with a transparent theme color.
237237

238+
The theme system now uses `@vuetify/v0` under the hood. The consumer API (`useTheme`, `VThemeProvider`) is unchanged for most users.
239+
240+
### Removed: `isDisabled`, `isSystem`, `styles`
241+
242+
These refs are no longer available on the theme instance.
243+
244+
### Runtime theme changes
245+
246+
Direct assignment of new themes via `themes.value` is replaced by `register()`:
247+
248+
```diff
249+
- theme.themes.value.custom = { dark: true, colors: { primary: '#ff5722' } }
250+
+ theme.register({ id: 'custom', dark: true, colors: { primary: '#ff5722' } })
251+
```
252+
253+
Mutating existing theme colors continues to work:
254+
255+
```ts
256+
theme.themes.value.light.colors.primary = '#ff0000'
257+
```
258+
238259
## Components
239260

240261
### VBtn display

0 commit comments

Comments
 (0)