Skip to content

useCustomTheme ​

Composable pour injecter des variables CSS personnalisees au runtime. Permet de surcharger les tokens du design system pour un composant ou une section specifique.

Utilisation basique ​

vue
<script setup>
import { useCustomTheme } from '@surgeui/ds-vue'

const { setVariable, setVariables, removeVariable, clearAll } = useCustomTheme()

// Surcharger un token
setVariable('--su-primary-default', '#e11d48')

// Surcharger plusieurs tokens
setVariables({
  '--su-primary-default': '#e11d48',
  '--su-primary-hover': '#be123c',
  '--su-primary-text': '#ffffff',
})
</script>

Cas d'usage ​

Branding dynamique ​

vue
<script setup>
import { useCustomTheme } from '@surgeui/ds-vue'

const { setVariables } = useCustomTheme()

// Appliquer les couleurs de marque du client
function applyBranding(brand) {
  setVariables({
    '--su-primary-default': brand.primaryColor,
    '--su-primary-hover': brand.primaryHover,
    '--su-bg-canvas': brand.backgroundColor,
  })
}
</script>

Reinitialisation ​

vue
<script setup>
import { useCustomTheme } from '@surgeui/ds-vue'

const { removeVariable, clearAll } = useCustomTheme()

// Retirer une surcharge
removeVariable('--su-primary-default')

// Retirer toutes les surcharges
clearAll()
</script>

API ​

MethodeDescription
setVariable(name, value)Definir une variable CSS sur :root
setVariables(vars)Definir plusieurs variables CSS
removeVariable(name)Retirer une surcharge
clearAll()Retirer toutes les surcharges

Publié sous licence MIT.