Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Składnia literałów szablonowych

Literały szablonowe pozwalają zapisywać tekst wielowierszowy i wstawiać wyniki wyrażeń. Funkcja tagująca otrzymuje fragmenty tekstu i wartości podstawień osobno.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

`text`
`first line
second line`
`text ${expression} more text`
tag`text ${expression} more text`

Literał szablonowy zapisuje się między znakami akcentu odwrotnego (backtickami), a nie między apostrofami ani cudzysłowami. Zwykłe podziały wierszy i wcięcia w części tekstowej trafiają do wyniku. Aby zapisać dosłowny backtick, poprzedź go ukośnikiem odwrotnym. Zapis \${ wstawia ${ bez rozpoczynania podstawienia.

W literałach bez tagu wyrażenia w ${expression} są obliczane od lewej do prawej, a każda wartość jest konwertowana na ciąg znaków przed przejściem do następnego wyrażenia. Wynikiem jest ciąg znaków. Bezpośrednie podstawienie wartości typu Symbol powoduje TypeError; jeśli potrzebujesz jej zapisu tekstowego, użyj jawnie String(value).

W szablonie z tagiem zapis tag`...` wywołuje funkcję bez nawiasów. Pierwszy argument, parts, to zamrożona tablica przetworzonych fragmentów tekstu, również pustych; przy n podstawieniach jest ich n + 1. Kolejne argumenty to wartości podstawień, bez automatycznej konwersji na tekst. Wynikiem wyrażenia jest dowolna wartość zwrócona przez tag. To samo miejsce w kodzie w tym samym realmie JavaScript ponownie używa tej samej tablicy.

Zamrożona tablica parts.raw zawiera fragmenty bez interpretowania sekwencji ucieczki. Zarówno w postaci przetworzonej, jak i surowej podziały wierszy CRLF i CR w kodzie źródłowym stają się LF. Niepoprawna sekwencja ucieczki, np. \xG, powoduje SyntaxError bez tagu; z tagiem odpowiedni przetworzony fragment ma wartość undefined, a surowy zachowuje tę sekwencję.

To składnia JavaScript, nie API DOM; sprawdź, czy obsługuje ją docelowe środowisko. Interpolacja nie zabezpiecza automatycznie danych na potrzeby HTML. Aby wyświetlić niezaufany tekst w zwykłym elemencie strony, użyj textContent, nie innerHTML.

Przykłady

const count = 2;
const message = `Total: ${count + 1}
Ready`;

function inspect(parts, value) {
  return [parts[1].startsWith("\n"), parts.raw[1].startsWith("\\n"), typeof value];
}

console.log(message);
console.log(JSON.stringify(inspect`Total: ${count + 1}\nReady`));

Wynik

Total: 3
Ready
[true,true,"number"]

Zwykły literał wypisuje dwa wiersze. W wyniku tagu pierwsze `true` oznacza, że przetworzony fragment zaczyna się od znaku nowego wiersza, a drugie — że surowy fragment zaczyna się od dwóch znaków: ukośnika odwrotnego i `n`. `"number"` potwierdza, że tag otrzymał liczbę.

Powiązane lekcje

  • JavaScript · Lekcja 23 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 24 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 25 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 31 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 32 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 40 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 41 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 42 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 43 · Zaawansowany · Wersja: 4

Źródła