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