CKTIS / JavaScript
Literały szablonowe w JavaScript
Twórz wielowierszowe napisy i wstawiaj wyniki wyrażeń. Dowiedz się, kiedy powstaje napis, a kiedy fragmenty i wartości trafiają do funkcji tagującej.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
`text`
`text ${expression} more text`
tag`text ${expression} more text`
String.raw`text ${expression} more text`Literał szablonowy zapisuje się między znakami akcentu grawisowego (backtickami), a nie między cudzysłowami. Wstawki ${expression} zawierają wyrażenia. W literałach bez tagu JavaScript oblicza je od lewej do prawej, zamienia każdy wynik na napis i łączy go z tekstem. Bezpośrednia wstawka z wartością typu Symbol powoduje TypeError. Podziały wierszy i wcięcia w tekście literału stają się częścią napisu. Użyj \`, aby wstawić backtick, oraz \${, aby zapisać ${ bez rozpoczynania wstawki.
Umieszczenie funkcji bezpośrednio przed otwierającym backtickiem wywołuje ją jako tag. Pierwszy argument to zamrożona tablica przetworzonych fragmentów tekstu, również pustych; kolejne argumenty to wartości wyrażeń bez automatycznej konwersji na napisy. Wynikiem całego wyrażenia jest to, co zwróci tag — nie musi to być napis. Wielokrotne wykonanie tego samego wystąpienia literału w tym samym środowisku globalnym (realm) przekazuje tę samą tablicę, nie nową kopię.
W przetworzonym fragmencie \n oznacza znak nowego wiersza. Zamrożona tablica parts.raw zachowuje w tym miejscu ukośnik odwrotny i literę n. Niepoprawna sekwencja ucieczki, np. \xZ, powoduje SyntaxError bez tagu; z tagiem odpowiadający jej fragment przetworzonej tablicy ma wartość undefined, a surowy zapis pozostaje dostępny. Wbudowany tag String.raw łączy surowe fragmenty z wartościami wstawek przekonwertowanymi na napisy.
Interpolacja nie zabezpiecza danych na potrzeby HTML, a sam tag nie gwarantuje bezpieczeństwa. Aby wyświetlić niezaufane dane jako zwykły tekst w elemencie przeznaczonym do wyświetlania tekstu, takim jak <p> lub <span>, użyj textContent, nie innerHTML. W elemencie <script> właściwość textContent ustawia treść źródłową skryptu, a nie tekst do wyświetlenia. Literały szablonowe należą do ECMAScript i nie wymagają DOM; obsługę sprawdź w docelowym środowisku uruchomieniowym.
Przykłady
{
const count = 5;
const report = `Items: ${count}
Status: ready`;
function inspect(parts, value) {
return [parts[0], parts.raw[0], value];
}
console.log(JSON.stringify(report));
console.log(JSON.stringify(inspect`Items:\n${count}`));
}Wynik
"Items: 5\nStatus: ready" ["Items:\n","Items:\\n",5]
Pierwszy wiersz pokazuje wielowierszowy napis. Drugi porównuje fragment przetworzony i surowy. `JSON.stringify` uwidacznia różnicę między znakiem nowego wiersza a dosłownym zapisem `\n`; liczba `5` pozostaje bez cudzysłowu.
Powiązane lekcje
- JavaScript · Lekcja 1 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 4 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 6 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 7 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 8 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 10 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 11 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 14 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 16 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 17 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 18 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 17 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 19 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 20 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 21 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 22 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 23 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 25 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 30 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 31 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 33 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 35 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 38 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 42 · Średniozaawansowany · Wersja: 3