# A @source direktíva

A `@source` a bemeneti CSS-ban szerepel. A `inline()` formái osztályjelölteket adnak hozzá vagy távolítanak el, és mindenhol működnek. Az útvonalas formák megadják, mely sablonfájlokat kell átvizsgálni az osztálynevekért; fájlokat csak a [CLI](https://tailwindphp.inline0.dev/hu/docs/cli) vizsgál át, de jelenleg még nem alkalmazza a megadott útvonalakat (lásd: [Az útvonalak használata](#how-paths-are-used)).

```css
@import "tailwindcss";
@source "./templates";
```

A `@source` direktívák fordítás közben beolvasásra kerülnek, majd eltávolítódnak a kimenetből; a létrehozott CSS-ban soha nem jelennek meg. Az útvonalakat idézőjelek közé kell tenni; egyszeres és dupla idézőjel is használható.

## Útvonalak, globminták és kizárás

Az útvonalas forma könyvtárat, globmintát vagy kizáró útvonalat fogad el; a direktívák halmozódnak:

```css
@source "./templates";              /* a directory */
@source "./components/**/*.php";    /* a glob */
@source not "./templates/legacy";   /* an exclusion */
```

### Az útvonalak használata

A fordító minden útvonalas direktívát rögzít a `TailwindPHP\compile()` által visszaadott tömb `sources` listájába, `['base' => …, 'pattern' => …, 'negated' => …]` formájában, ahol a `base` értéke a `base` fordítási beállításból származik. Maga soha nem olvassa be a fájlokat.

- A `tw::generate()`, a `tw::compile()` és a `TailwindCompiler` csak az átadott tartalmat fordítja le. Az útvonalas direktívák itt hatástalanok.
- A [CLI](https://tailwindphp.inline0.dev/hu/docs/cli) beolvassa a `sources` fájlt, de a jelenlegi kiadásban a bemeneti fájl könyvtárát rekurzívan vizsgálja át minden kizárás nélküli útvonal esetén, függetlenül attól, mit ír elő az útvonal vagy a globminta; a `not` útvonalakat pedig teljesen kihagyja, így azok semmit sem zárnak ki ([#8](https://github.com/inline0/tailwindphp/issues/8)). A [Mit vizsgál át a CLI](https://tailwindphp.inline0.dev/hu/docs/cli#what-the-cli-scans) rész ismerteti a részleteket és a jelenleg működő fájlszerkezetet.

## Beágyazott jelöltek

A `@source inline(...)` akkor is belekényszeríti az osztályokat a kimenetbe, ha azok egyetlen átvizsgált fájlban sem szerepelnek — ez hasznos a futásidőben dinamikusan összeállított osztályneveknél:

```css
@source inline("flex p-4 m-2");
```

A beágyazott jelöltek változatokat is támogatnak:

```css
@source inline("hover:bg-blue-500 focus:ring-2");
```

### Kapcsos zárójeles kibontás

A beágyazott minták kibontják a kapcsos zárójelek közé írt csoportokat, így tömören felsorolhat sok jelöltet:

```css
@source inline("p-{1,2,4}");
/* Generates p-1, p-2, and p-4 */

@source inline("text-{red,blue}-500");
/* Generates text-red-500 and text-blue-500 */
```

## Kizárt beágyazott jelöltek

A `@source not inline(...)` a `inline()` ellentettjét teszi: eltávolítja a találatokat a kimenetből akkor is, ha a tartalomban szerepelnek. Itt is használható a kapcsos zárójeles kibontás:

```css
@source not inline("legacy");
@source not inline("p-{1,2}");
```

## Érvényesítési szabályok

A `@source` utasítás, nem blokk. A fordító elutasítja a következőket:

- Törzzsel rendelkező direktíva — `@source cannot have a body.`
- Beágyazott direktíva (például egy `@media` belsejében) — `@source cannot be nested.`
- Idézőjelek közé nem tett útvonal — `@source paths must be quoted.`

```css
/* Invalid — throws "`@source` cannot have a body." */
@source "./src" {
    .some-style { color: red; }
}

/* Invalid — throws "`@source` paths must be quoted." */
@source ./src;
```

A fájlalapú fordításokhoz tekintse meg a [CLI](https://tailwindphp.inline0.dev/hu/docs/cli) részt, az `@import` és a virtuális modulok feloldásáról pedig az [Imports](https://tailwindphp.inline0.dev/hu/docs/usage/imports) részt.