CKTIS / JavaScript
Syntaxe šablonových literálů
Šablonové literály umožňují zapisovat víceřádkový text a vkládat výsledky výrazů. Funkce tagu dostává úseky textu a dosazované hodnoty odděleně.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
`text`
`first line
second line`
`text ${expression} more text`
tag`text ${expression} more text`Šablonové literály se zapisují mezi zpětné apostrofy (backticky), nikoli mezi jednoduché či dvojité uvozovky. Běžná zalomení řádků a odsazení v textu se stanou součástí výsledku. Chceš-li zapsat samotný zpětný apostrof, přidej před něj zpětné lomítko. Zápis \${ vloží ${, aniž zahájí dosazení.
V literálu bez tagu JavaScript vyhodnocuje výrazy v ${expression} zleva doprava. Každou hodnotu převede na řetězec, než přejde k dalšímu výrazu. Výsledkem je řetězec. Přímé vložení hodnoty typu Symbol vyvolá TypeError; pokud potřebuješ její textovou podobu, použij výslovně String(value).
V šabloně s tagem zápis tag`...` volá funkci bez závorek. První argument, parts, je zmrazené pole zpracovaných úseků textu, včetně prázdných: při n dosazeních vznikne n + 1 úseků. Další argumenty jsou dosazované hodnoty bez automatického převodu na řetězce. Výsledkem výrazu je hodnota vrácená funkcí tagu. Při opakovaném vyhodnocení na stejném místě zdrojového kódu v témže realmu JavaScriptu se použije stejné pole.
Zmrazené pole parts.raw obsahuje úseky bez interpretace únikových sekvencí. Konce řádků CRLF a CR ve zdrojovém kódu se v obou podobách mění na LF. Neplatná úniková sekvence jako \xG způsobí bez tagu SyntaxError; s tagem má příslušný zpracovaný úsek hodnotu undefined a nezpracovaný úsek sekvenci zachová.
Jde o syntaxi JavaScriptu, ne o API DOM; ověř podporu v cílovém běhovém prostředí. Interpolace v hodnotách automaticky neošetřuje speciální znaky HTML. Pro zobrazení nedůvěryhodného textu v běžném prvku stránky použij textContent, nikoli innerHTML.
Příklady
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`));Výsledek
Total: 3 Ready [true,true,"number"]
Literál bez tagu vypíše dva řádky. První `true` ve výsledku tagu znamená, že zpracovaný úsek začíná znakem nového řádku; druhé znamená, že nezpracovaný úsek začíná dvěma znaky: zpětným lomítkem a `n`. `"number"` potvrzuje, že tag dostal číslo.
Související lekce
- JavaScript · Lekce 23 · Pokročilá · Verze: 4
- JavaScript · Lekce 24 · Pokročilá · Verze: 4
- JavaScript · Lekce 25 · Pokročilá · Verze: 4
- JavaScript · Lekce 31 · Pokročilá · Verze: 4
- JavaScript · Lekce 32 · Pokročilá · Verze: 4
- JavaScript · Lekce 35 · Pokročilá · Verze: 4
- JavaScript · Lekce 40 · Pokročilá · Verze: 4
- JavaScript · Lekce 41 · Pokročilá · Verze: 4
- JavaScript · Lekce 42 · Pokročilá · Verze: 4
- JavaScript · Lekce 43 · Pokročilá · Verze: 4