WS
Docs /Démarrage/Directives

Directives Blade

Wirestack UI expose deux directives Blade à placer dans votre layout principal : @wsStyles et @wsScripts.

@wsStyles

À placer dans le <head>. Injecte un bloc <style> contenant toutes les variables CSS (design tokens) définies dans config/ws.php.

<head>
    <meta charset="UTF-8">
    @wsStyles
    @vite(['resources/css/app.css'])
    @livewireStyles
</head>

Exemple de sortie générée par @wsStyles :

<style>
    :root {
        --ws-primary-h: 221;
        --ws-primary-s: 83%;
        --ws-primary-l: 53%;
        --ws-radius-sm: 0.25rem;
        --ws-radius-md: 0.375rem;
        --ws-radius-lg: 0.5rem;
        --ws-radius-xl: 0.75rem;
        --ws-radius-2xl: 1rem;
        --ws-radius-full: 9999px;
        --ws-font-sans: "Instrument Sans", ui-sans-serif, system-ui, sans-serif;
        --ws-transition-fast: 100ms ease;
        --ws-transition-normal: 180ms ease;
        --ws-transition-slow: 300ms ease;
        --ws-shadow-sm: 0 1px 2px 0 rgb(0 0 0 / 0.05);
        --ws-shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1), ...;
        --ws-shadow-lg: 0 10px 15px -3px rgb(0 0 0 / 0.1), ...;
    }
</style>

@wsScripts

À placer juste avant </body>. Injecte les helpers JavaScript globaux du package et configure le raccourci clavier ⌘K pour la palette de commandes.

<body>
    {{ $slot }}

    @wsScripts
    @livewireScripts
</body>

Helpers disponibles après injection :

Objet global Description
DsToastDéclencher des notifications flottantes
DsModalOuvrir / fermer une modale par son ID
DsDrawerOuvrir / fermer un drawer par son ID
DsCommandPaletteOuvrir / fermer la palette de commandes
DsCopyCopier du texte dans le presse-papiers

Exemple de layout complet

Exemple de layout Blade minimal avec toutes les directives nécessaires :

<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Mon App</title>

    @wsStyles
    @vite(['resources/css/app.css', 'resources/js/app.js'])
    @livewireStyles
</head>
<body class="bg-white dark:bg-zinc-950 text-zinc-900 dark:text-zinc-100">

    <livewire:ws::toast />

    {{ $slot }}

    @wsScripts
    @livewireScripts
</body>
</html>

Important : @wsStyles doit être placé avant @vite pour que les variables CSS soient disponibles dès le rendu. De même, @wsScripts doit être placé avant @livewireScripts.