Papildiniai

TailwindPHP pateikia PHP oficialių TailwindCSS papildinių prievadus ir savąjį PHP papildinio API. Papildiniai registruoja paslaugas, komponentus ir variantus; jie įkeliami direktyva @plugin jūsų įvesties CSS. Integruotieji papildiniai yra oficialių JavaScript atitikmenų prievadai santykiu 1:1 – tie patys parinkikliai ir išvestis, įgyvendinti PHP, o ne vykdomi per Node. Šiandien yra viena išimtis: tipografijos papildinio elementų modifikatoriai (prose-headings:, prose-a:, …) priklauso nuo papildinių variantų, kurie dar netaikomi (#10).

@plugin naudojimas

Nurodykite papildinį vardu naudodami @plugin. Integruotieji papildiniai naudoja savo npm paketo pavadinimą. Kartu su direktyva naudokite @import "tailwindcss/utilities.css";, kad papildinio klasės būtų įtrauktos į paslaugų sluoksnį:

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";
    ',
]);

Vienu metu galima įkelti kelis papildinius, o jų tvarka nesvarbi:

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

@plugin negalima įdėti į kitą at-rule, pavyzdžiui, @media; neregistruotas papildinio pavadinimas sukelia klaidą.

Papildinio parinktys

Perduokite papildiniui parinktis naudodami CSS bloko sintaksę po pavadinimo. Raktai atitinka papildinio parinkčių masyvą:

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

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

Papildinys @tailwindcss/forms priima strategy (base arba class); @tailwindcss/typography priima className, kuria galima pervadinti sugeneruotą klasę prose. Visą parinkčių sąrašą rasite atskiro papildinio puslapyje.

Integruotieji papildiniai

Tinkinti papildiniai

Sukurkite savo papildinį įgyvendindami PluginInterface ir naudodami PluginAPI metodus (addUtilities, matchUtilities, addComponents, addVariant, theme ir kitus). Užregistruokite jį naudodami registerPlugin(new MyPlugin()), kad getName() grąžintas pavadinimas būtų atpažįstamas direktyvoje @plugin "my-plugin":

use function TailwindPHP\registerPlugin;

registerPlugin(new MyCustomPlugin());

Sąsają, visą pavyzdį ir išsamų metodų PluginAPI aprašą rasite skiltyje Tinkinti papildiniai.