Przejdź do głównej zawartości

Składnia Astro

Jeśli znasz HTML to wiesz już wystarczająco dużo, aby napisać swój pierwszy komponent Astro.

Składnia komponentu Astro jest nadzbiorem HTML. Została zaprojektowana tak, aby była znajoma dla każego, kto ma doświadczenie w pisaniu HTML lub JSX, i dodaje wsparcie dla włączania komponentów oraz wyrażeń JavaScript.

Możesz zdefiniować zmienne lokalne JavaScript w środku skryptu modułu frontmatter pomiędzy dwoma znacznikami kodu komponentu Astro (---). Możesz wstawić te zmienne do szablonu HTML komponentu za pomocą wyrażeń JSX-podobnych!

Zmienne lokalne mogą zostać dodane do kodu HTML poprzez użycie składni nawiasów klamrowych:

src/components/Variables.astro
---
const name = "Astro";
---
<div>
<h1>Witaj {name}!</h1> <!-- Wyświetli się <h1>Witaj Astro!</h1> -->
</div>

Zmienne lokalne mogą być użyte w nawiasach klamrowych do przekazywania wartości atrybutów zarówno do elementów HTML jak i komponentów:

src/components/DynamicAttributes.astro
---
import MyComponent from "./MyComponent.astro";
const name = "Astro";
---
<h1 class={name}>Wyrażenia atrybutów są wspierane</h1>
<MyComponent templateLiteralNameAttribute={`MyNameIs${name}`} />

Zmienne lokalne mogą zostać użyte w funkcjach JSX-podobnych do stworzenia dynamicznie generowanych elementów HTML:

src/components/DynamicHtml.astro
---
const items = ["Pies", "Kot", "Dziobak"];
---
<ul>
{items.map((item) => (
<li>{item}</li>
))}
</ul>

Astro może warunkowo wyświetlać HTML używając operatorów logicznych JSX oraz wyrażeń warunkowych.

src/components/ConditionalHtml.astro
---
const visible = true;
---
{visible && <p>Pokaż mnie!</p>}
{visible ? <p>Pokaż mnie!</p> : <p>W innym przypadku pokaż mnie!</p>}

Możesz również używać dynamicznych tagów przypisując nazwę tagu HTML do zmiennej lub poprzez ponowne przypisanie importu komponentu:

src/components/DynamicTags.astro
---
import MyComponent from "./MyComponent.astro";
const Element = 'div'
const Component = MyComponent;
---
<Element>Cześć!</Element> <!-- Renderuje się jako <div>Cześć!</div> -->
<Component /> <!-- Renderuje się jako <MyComponent /> -->

Kiedy używasz dynamicznych tagów, pamiętaj o kilku rzeczach:

  • Nazwy zmiennych pisz z dużej litery. Na przykład, użyj Element, a nie element. W przeciwnym razie Astro wyrenderuje Twoją nazwę zmiennej jako zwykły tag HTML.

  • Dyrektywy nawadniania nie są wspierane Jeśli korzystasz z dyrektyw nawadniania client:* (EN), Astro musi wiedzieć, który komponent zapakować na produkcję, a wzór dynamicznego tagu zapobiega jemu działaniu.

  • Dyrektywa define:vars (EN) nie jest wspierana. Jeśli nie możesz owinąć elementów potomnych dodatkowym elementem (np. <div>), możesz ręcznie dodać style={`--myVar:${value}`} do swojego elementu.

Astro wspiera używanie <Fragment> </Fragment> bądź skróconej formy <> </>.

Fragmenty mogą być użyte do uniknięcia dodawania elementów pakujących, kiedy dodajesz dyrektywy set:* (EN), jak w poniższym przykładzie:

src/components/SetHtml.astro
---
const htmlString = '<p>Surowa zawartość HTML</p>';
---
<Fragment set:html={htmlString} />

Składnia komponentu Astro jest nadzbiorem HTML. Została zaprojektowana tak, aby była znajoma dla każdego, kto ma doświadczenie w HTML lub JSX, jednak istnieje kilka kluczowych różnic między plikami .astro a JSX.

W Astro używasz standardowego formatu kebab-case dla wszystkich atrybutów HTML zamiast camelCase używanego w JSX. Działa to nawet dla klas, które nie są obsługiwane przez React.

example.astro
<div className="box" dataValue="3" />
<div class="box" data-value="3" />

Szablon komponentu Astro może renderować wiele elementów bez potrzeby zawarcia wszystkiego w jednym tagu <div> lub <>, inaczej niż w JavaScript czy JSX.

src/components/RootElements.astro
---
// Szablon z wieloma elementami
---
<p>Nie ma potrzeby zawierania elementów w jednym kontenerze.</p>
<p>Astro wspiera wiele elementów root w szablonie.</p>

W Astro możesz używać standardowych komentarzy HTML lub komentarza w stylu JavaScript.

example.astro
---
---
<!-- Składnia komentarza HTML jest prawidłowa dla plików .astro -->
{/* Tak samo jak i składnia JS */}

Astro.slots zawiera funkcje pomocnicze do modyfikowania dzieci przekazanych do slotów komponentu Astro.

Typ: (slotName: string) => boolean

Za pomocą Astro.slots.has() możesz sprawdzić, czy istnieje treść dla slotu o podanej nazwie. Przydaje się to, gdy chcesz wrappować zawartość slotu, ale renderować elementy wrappera tylko wtedy, gdy slot jest używany.

src/pages/index.astro
---
---
<slot />
{Astro.slots.has('more') && (
<aside>
<h2>Więcej</h2>
<slot name="more" />
</aside>
)}

Typ: (slotName: string, args?: any[]) => Promise<string>

Za pomocą Astro.slots.render() możesz asynchronicznie wyrenderować zawartość slotu do ciągu HTML.

---
const html = await Astro.slots.render('default');
---
<Fragment set:html={html} />

Astro.slots.render() przyjmuje opcjonalnie drugi argument: tablicę parametrów przekazywanych do dzieci będących funkcjami. Przydaje się to w niestandardowych komponentach pomocniczych.

Na przykład ten komponent <Shout /> zamienia prop message na wielkie litery i przekazuje go do domyślnego slotu:

src/components/Shout.astro
---
const message = Astro.props.message.toUpperCase();
let html = '';
if (Astro.slots.has('default')) {
html = await Astro.slots.render('default', [message]);
}
---
<Fragment set:html={html} />

Funkcja zwrotna przekazana jako dziecko <Shout /> otrzyma parametr message zapisany wielkimi literami:

src/pages/index.astro
---
import Shout from "../components/Shout.astro";
---
<Shout message="slots!">
{(message: string) => <div>{message}</div>}
</Shout>
<!-- renderuje się jako <div>SLOTS!</div> -->

Funkcje zwrotne można przekazać do nazwanych slotów wewnątrz otaczającego tagu HTML z atrybutem slot. Ten element służy wyłącznie do przekazania funkcji do nazwanego slotu i nie zostanie wyrenderowany na stronie.

<Shout message="slots!">
<fragment slot="message">
{(message: string) => <div>{message}</div>}
</fragment>
</Shout>

Jako tagu otaczającego użyj zwykłego elementu HTML albo dowolnego tagu pisanego małymi literami (np. <fragment> zamiast <Fragment />), który nie zostanie zinterpretowany jako komponent. Nie używaj elementu HTML <slot>, ponieważ zostanie on zinterpretowany jako slot Astro.

Astro.self pozwala wywoływać komponenty Astro rekurencyjnie. Dzięki temu możesz wyrenderować komponent Astro wewnątrz niego samego, używając <Astro.self> w szablonie komponentu. Pomaga to przechodzić przez duże zbiory danych i zagnieżdżone struktury.

src/components/NestedList.astro
---
type Props = {
items: (string | string[])[];
};
const { items } = Astro.props;
---
<ul class="nested-list">
{
items.map((item) => (
<li>
{/* Jeśli dane są zagnieżdżone, renderujemy `<Astro.self>` */}
{/* i możemy przekazać propy w wywołaniu rekurencyjnym */}
{Array.isArray(item) ? <Astro.self items={item} /> : item}
</li>
))
}
</ul>

Tego komponentu można następnie użyć w ten sposób:

---
import NestedList from './NestedList.astro';
---
<NestedList items={['A', ['B', 'C'], 'D']} />

Wyrenderuje on taki HTML:

<ul class="nested-list">
<li>A</li>
<li>
<ul class="nested-list">
<li>B</li>
<li>C</li>
</ul>
</li>
<li>D</li>
</ul>
Pomóż nam Społeczność Zostań sponsorem
⌂ 换网址