CKTIS / JavaScript
Literał szablonowy
Literał szablonowy (template literal) używa znaków ` jako ograniczników. Pozwala osadzać wyrażenia przez ${expression} i zapisywać tekst wielowierszowy. Wariant z funkcją tagującą przekazuje jej fragmenty tekstu oraz wartości wyrażeń.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
`text ${expression} text`
tag`text ${expression} text`Literał szablonowy (template literal) jest ograniczony znakami grawisu, a nie apostrofami lub cudzysłowami. W zwykłym wariancie tworzy ciąg znaków. Składnia ${expression} oblicza wyrażenie, przekształca jego wynik na tekst i wstawia go w danym miejscu; podstawienia są przetwarzane od lewej do prawej.
W zwykłym wariancie wcięcia oraz podziały wierszy, które nie są częścią kontynuacji wiersza, trafiają do wynikowego ciągu znaków. Odwrotny ukośnik bezpośrednio przed końcem wiersza w kodzie źródłowym tworzy kontynuację wiersza i nie wprowadza znaku nowego wiersza do wyniku. Sekwencje ucieczki, takie jak \n, są interpretowane. Aby zapisać dosłowne ${, użyj \${; znak grawisu poprzedź odwrotnym ukośnikiem. W zwykłych ciągach ograniczonych przez ' lub " zapis ${expression} nie wykonuje interpolacji.
Wariant tag bezpośrednio przed literałem wywołuje funkcję tagującą: otrzymuje ona tablicę przetworzonych fragmentów tekstu, a następnie wartości podstawień bez automatycznej zamiany na tekst. Właściwość raw tej tablicy udostępnia nieprzetworzone fragmenty. Wynikiem jest wartość zwrócona przez funkcję, niekoniecznie ciąg znaków.
Przykład łączy interpolację, obliczenie i podział wiersza. Sam literał nie zapewnia automatycznego kodowania HTML ani bezpiecznego budowania zapytań SQL; odpowiednie przetwarzanie trzeba zapewnić osobno.
Przykłady
const name = "Ada";
const count = 3;
const message = `Hello, ${name}!
Total: ${count * 2}`;
console.log(message);Wynik
Hello, Ada! Total: 6
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.