Skip to content

Latest commit

 

History

History
175 lines (130 loc) · 6.49 KB

astro-syntax.mdx

File metadata and controls

175 lines (130 loc) · 6.49 KB
title description i18nReady
Składnia Astro
Wstęp do składni .astro komponentów.
true

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.

Wyrażenia JSX-podobne

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!

:::note[Dynamiczne vs Reaktywne] Używając tego podejścia, możesz włączyć dynamiczne wartości, które są obliczane w frontmatter. Ale raz zawarte, te wartości nie są reaktywne i nigdy się nie zmienią. Komponenty Astro to szablony, które uruchamiają się tylko raz, podczas renderowania.

Poniżej zobaczysz więcej przykładów różnic między Astro a JSX. :::

Zmienne

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

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

Atrybuty Dynamiczne

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:

---
const name = "Astro";
---
<h1 class={name}>Wyrażenia atrybutów są wspierane</h1>

<MyComponent templateLiteralNameAttribute={`MyNameIs${name}`} />

:::caution Atrybuty HTML zostaną przekonwertowane na stringi, więc nie jest możliwe przekazywanie funkcji i obiektów do elementów HTML. Na przykład, nie możesz przypisać obsługi zdarzeń do elementu HTML w komponencie Astro:

---
function handleClick () {
    console.log("Przycisk został kliknięty!");
}
---
<!-- ❌ To nie zadziała! ❌ -->
<button onClick={handleClick}>Nic się nie stanie, gdy mnie klikniesz!</button>

Zamiast tego, użyj skryptu po stronie klienta, aby dodać obsługę zdarzeń. Zupełnie jakbyś to zrobił w czystym JavaScript:

---
---
<button id="button">Click Me</button>
<script>
  function handleClick () {
    console.log("Przycisk został kliknięty!");
  }
  document.getElementById("button").addEventListener("click", handleClick);
</script>

:::

Dynamiczny HTML

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

---
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.

---
const visible = true;
---
{visible && <p>Pokaż mnie!</p>}

{visible ? <p>Pokaż mnie!</p> : <p>W innym przypadku pokaż mnie!</p>}

Dynamiczne Tagi

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

---
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. {/* TODO: Gdy pojawi się tłumaczenie trzeba zmienić ścieżkę */}

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

  • Dyrektywa define:vars 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.

Fragmenty

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:*, jak w poniższym przykładzie:

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

Różnice między Astro a JSX

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.

Atrybuty

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.

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

Wiele Elementów

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

---
// 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>

Komentarze

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

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

:::caution Komentarze w stylu HTML zostaną dołączone do DOM przeglądarki, podczas gdy te w stylu JS zostaną pominięte. Aby zostawić wiadomości TODO lub inne wyjaśnienia tylko dla deweloperów, możesz użyć komentarzy w stylu JavaScript. :::