Pluginer

TailwindPHP levereras med PHP portar av de officiella pluginen TailwindCSS och erbjuder ett inbyggt API för pluginer PHPAPI. Pluginer registrerar verktyg, komponenter och varianter. De laddas med direktivet @plugin i din indata CSS. De inbyggda pluginen är 1:1 portar av sina motsvarigheter i JavaScript – samma selektorer och utdata, men implementerade i PHP i stället för att köras via Node. Ett undantag just nu: typografipluginens elementmodifierare (prose-headings:, prose-a:, …) bygger på pluginvarianter, som ännu inte tillämpas (#10).

Använda @plugin

Ange ett plugin med namn via @plugin. Inbyggda pluginer använder paketnamnet npm. Kombinera direktivet med @import "tailwindcss/utilities.css"; så att pluginens klasser läggs till i verktygslagret:

use TailwindPHP\tw;

$css = tw::generate([
    'content' => '<article class="prose prose-lg"><h1>Hello</h1><p>Content here</p></article>',
    'css' => '
        @plugin "@tailwindcss/typography";
        @import "tailwindcss/utilities.css";
    ',
]);

Flera pluginer kan laddas tillsammans, och ordningen spelar ingen roll:

@plugin "@tailwindcss/typography";
@plugin "@tailwindcss/forms";
@import "tailwindcss/utilities.css";

@plugin får inte ligga inuti en annan at-regel (som @media), och ett oregistrerat plugin-namn ger ett fel.

Pluginalternativ

Ange alternativ för ett plugin med blocksyntaxen CSS efter namnet. Nycklarna motsvarar pluginens alternativarray:

@plugin "@tailwindcss/forms" {
    strategy: "class";
}

@plugin "@tailwindcss/typography" {
    className: "markdown";
}

Pluginen @tailwindcss/forms godtar strategy (base eller class); @tailwindcss/typography godtar className för att byta namn på den genererade klassen prose. Se sidorna för respektive plugin för hela listan med alternativ.

Inbyggda pluginer

Anpassade pluginer

Skriv ett eget plugin genom att implementera PluginInterface och använda metoderna på PluginAPI (addUtilities, matchUtilities, addComponents, addVariant, theme med flera). Registrera det med registerPlugin(new MyPlugin()) så att namnet som returneras av getName() kan hittas i ett @plugin "my-plugin"-direktiv:

use function TailwindPHP\registerPlugin;

registerPlugin(new MyCustomPlugin());

Se Anpassade pluginer för gränssnittet, ett fullständigt exempel och hela metodreferensen PluginAPI.