CKTIS / JavaScript
Sintassi dei letterali di template
I letterali di template permettono di scrivere testo su più righe e interpolare espressioni. Una funzione tag riceve separatamente i segmenti di testo e i valori da inserire.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
`text`
`first line
second line`
`text ${expression} more text`
tag`text ${expression} more text`I letterali di template si delimitano con gli accenti gravi (backtick), anziché con virgolette singole o doppie. Le normali interruzioni di riga e i rientri del testo fanno parte del risultato. Per scrivere un backtick letterale, anteponi una barra inversa. Scrivi \${ per includere ${ senza avviare una sostituzione.
In un letterale senza tag, JavaScript valuta le espressioni in ${expression} da sinistra a destra e converte ciascun valore in una stringa prima di passare all’espressione successiva. Il risultato è una stringa. Interpolare direttamente un valore di tipo Symbol genera TypeError; se ti serve la sua rappresentazione testuale, usa esplicitamente String(value).
In un template con tag, tag`...` chiama una funzione senza parentesi. Il suo primo argomento, parts, è un array congelato dei segmenti di testo elaborati, compresi quelli vuoti: n sostituzioni danno n + 1 segmenti. Gli altri argomenti sono i valori delle sostituzioni, senza conversione automatica in stringhe. Il valore restituito dal tag è il risultato dell’espressione. Valutare più volte lo stesso punto del codice sorgente nello stesso realm JavaScript riutilizza lo stesso array.
L’array congelato parts.raw contiene i segmenti senza interpretare le sequenze di escape. Le terminazioni di riga CRLF e CR del sorgente diventano LF in entrambe le forme. Una sequenza di escape non valida come \xG causa SyntaxError senza tag; con un tag, il segmento elaborato interessato vale undefined e il segmento grezzo conserva la sequenza.
È sintassi JavaScript, non un’API del DOM; verifica che l’ambiente di esecuzione di destinazione la supporti. L’interpolazione non esegue l’escape dei valori per HTML. Per mostrare testo non attendibile in un normale elemento della pagina, usa textContent, non innerHTML.
Esempi
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`));Risultato
Total: 3 Ready [true,true,"number"]
Il letterale senza tag stampa due righe. Nel risultato del tag, il primo `true` indica che il segmento elaborato inizia con un carattere di nuova riga; il secondo indica che il segmento grezzo inizia con due caratteri: una barra inversa e `n`. `"number"` conferma che il tag ha ricevuto un numero.
Lezioni correlate
- JavaScript · Lezione 23 · Avanzato · Versione: 4
- JavaScript · Lezione 24 · Avanzato · Versione: 4
- JavaScript · Lezione 25 · Avanzato · Versione: 4
- JavaScript · Lezione 31 · Avanzato · Versione: 4
- JavaScript · Lezione 32 · Avanzato · Versione: 4
- JavaScript · Lezione 35 · Avanzato · Versione: 4
- JavaScript · Lezione 40 · Avanzato · Versione: 4
- JavaScript · Lezione 41 · Avanzato · Versione: 4
- JavaScript · Lezione 42 · Avanzato · Versione: 4
- JavaScript · Lezione 43 · Avanzato · Versione: 4