diff --git a/apps/docs/stories/usage/dsfr-scss.mdx b/apps/docs/stories/usage/dsfr-scss.mdx index 87ab404..f492441 100644 --- a/apps/docs/stories/usage/dsfr-scss.mdx +++ b/apps/docs/stories/usage/dsfr-scss.mdx @@ -4,7 +4,7 @@ import { Source } from '@storybook/blocks'; import ViteTab from '@dsfrc/docs/stories/usage/dsfr-scss-vite.mdx'; import WebpackTab from '@dsfrc/docs/stories/usage/dsfr-scss-webpack.mdx'; -Mais comme notre fichier `.scss` importe des variables directement depuis le DSFR, vous devez installer leur librairie : +Mais comme le fichier `.scss` du thème importe des variables directement depuis le DSFR, vous devez installer leur librairie : -Et comme la librairie DSFR utilise des alias lors de ces imports de style, nous somme obligés de définir d'en définir un minimum pour que la compilation SCSS fonctionne dans votre "module bundler" : +Et comme la librairie DSFR utilise des alias lors de ces imports de style, nous somme obligés d'en définir un minimum pour que la compilation SCSS fonctionne dans le préprocesseur : # vuetify-v3 @@ -7,19 +12,20 @@ import { Meta } from '@storybook/blocks'; Personnaliser Vuetify se fait en 2 temps : 1. on utilise un thème JavaScript pour définir les couleurs principales -2. on utilise un thème SASS/CSS pour modifier la composition de l'application et des composants +2. on utilise un thème SASS/SCSS pour modifier la composition de l'application et des composants Tout d'abord, adaptez votre initialisation du plugin Vuetify : ```ts import '@mdi/font/css/materialdesignicons.css'; -import { getVuetifyOptions } from 'dsfr-connect/src/vuetify-v3'; import { createVuetify } from 'vuetify'; import * as components from 'vuetify/components'; import * as directives from 'vuetify/directives'; import * as labsComponents from 'vuetify/labs/components'; import 'vuetify/styles'; +import { getVuetifyOptions } from 'dsfr-connect/dist/vuetify-v3'; + export default createVuetify({ components: { components, labsComponents }, directives, @@ -29,18 +35,15 @@ export default createVuetify({ Si besoin, se référer à la documentation officielle : [https://v3.vuetifyjs.com/en/getting-started/installation/](https://v3.vuetifyjs.com/en/getting-started/installation/) -Ensuite la partie plus compliqué est que le style des composants est géré différemment de celui de l'application. Il faut modifier le préprocesseur que vous utilisez (Vite/Webpack) afin de lui dire d'utiliser une feuille de style spécifique pour compiler les composants Vuetify. Cela devrait ressembler à : - -```ts -// Vite/Nuxt -vuetify({ - styles: { configFile: 'dsfr-connect/src/vuetify-v3/settings.scss' }, -}); +Ensuite il faut modifier le préprocesseur que vous utilisez afin de lui dire d'utiliser une feuille de style spécifique pour compiler les composants Vuetify. -// Webpack/Vue CLI -new VuetifyPlugin({ - styles: { configFile: 'dsfr-connect/src/vuetify-v3/settings.scss' }, -}); -``` + }, + { label: 'Projet utilisant Vite', isDefault: false, content: }, + ]} +/> Les démarches pour importer ces helpers sont détaillées sur [https://vuetifyjs.com/en/features/sass-variables/#component-specific-variables](https://vuetifyjs.com/en/features/sass-variables/#component-specific-variables). + +