База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Шаблонни литерали в JavaScript

Създавайте многоредови низове и вмъквайте резултати от изрази. Научете кога JavaScript създава низ и кога предава текстовите части и стойностите на функция, използвана като таг.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

`text`
`text ${expression} more text`
tag`text ${expression} more text`
String.raw`text ${expression} more text`

Шаблонните литерали се ограждат с обратни апострофи (backticks) вместо с кавички. Маркерът ${expression} съдържа израз. Без таг JavaScript изчислява изразите отляво надясно, преобразува всеки резултат в низ и го съединява с текста. Директното вмъкване на стойност от тип Symbol предизвиква TypeError. Новите редове и отстъпите в текста на литерала стават част от низа. Използвайте \` за обратен апостроф и \${ за ${, без да отваряте маркер за вмъкване.

Функция непосредствено пред отварящия обратен апостроф се извиква като таг. Първият ѝ аргумент е замразен масив от обработени текстови части (cooked), включително празните. Останалите аргументи са стойностите на изразите без автоматично преобразуване в низове. Върнатата от тага стойност е резултатът от целия израз и не е задължително да е низ. При повторно изчисляване на същия литерал на същото място в кода и в същата глобална среда (realm) се използва същият масив, а не копие.

В обработена част \n означава знак за нов ред. Замразеният масив parts.raw запазва на това място обратната наклонена черта и буквата n. Невалидна екранираща последователност като \xZ предизвиква SyntaxError без таг; с таг съответната обработена част има стойност undefined, а необработеният запис остава достъпен. Вграденият таг String.raw съединява необработените части със стойностите за вмъкване, преобразувани в низове.

Интерполацията не екранира данните за HTML, а наличието на таг само по себе си не прави резултата безопасен. За да покажете ненадеждни данни като обикновен текст в елемент, предназначен за показване на текст, например <p> или <span>, използвайте textContent, а не innerHTML. При елемент <script> задаването на textContent определя изходния код на скрипта, а не текст за показване. Шаблонните литерали са част от синтаксиса на ECMAScript и не изискват DOM; проверете поддръжката в целевата среда за изпълнение.

Примери

{
  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}`));
}

Резултат

"Items: 5\nStatus: ready"
["Items:\n","Items:\\n",5]

Първият ред показва многоредов низ. Вторият сравнява обработената и необработената част. `JSON.stringify` показва разликата между знак за нов ред и буквално `\n`; числото `5` остава без кавички.

Свързани уроци

  • JavaScript · Урок 1 · Напреднало · Версия: 4
  • JavaScript · Урок 4 · Напреднало · Версия: 4
  • JavaScript · Урок 5 · Напреднало · Версия: 4
  • JavaScript · Урок 6 · Напреднало · Версия: 4
  • JavaScript · Урок 7 · Напреднало · Версия: 4
  • JavaScript · Урок 8 · Напреднало · Версия: 4
  • JavaScript · Урок 10 · Напреднало · Версия: 4
  • JavaScript · Урок 11 · Напреднало · Версия: 4
  • JavaScript · Урок 14 · Напреднало · Версия: 4
  • JavaScript · Урок 16 · Напреднало · Версия: 4
  • JavaScript · Урок 17 · Напреднало · Версия: 4
  • JavaScript · Урок 18 · Напреднало · Версия: 4
  • JavaScript · Урок 17 · Средно · Версия: 3
  • JavaScript · Урок 19 · Средно · Версия: 3
  • JavaScript · Урок 20 · Средно · Версия: 3
  • JavaScript · Урок 21 · Средно · Версия: 3
  • JavaScript · Урок 22 · Средно · Версия: 3
  • JavaScript · Урок 23 · Средно · Версия: 3
  • JavaScript · Урок 25 · Средно · Версия: 3
  • JavaScript · Урок 28 · Средно · Версия: 3
  • JavaScript · Урок 30 · Средно · Версия: 3
  • JavaScript · Урок 31 · Средно · Версия: 3
  • JavaScript · Урок 33 · Средно · Версия: 3
  • JavaScript · Урок 35 · Средно · Версия: 3
  • JavaScript · Урок 38 · Средно · Версия: 3
  • JavaScript · Урок 42 · Средно · Версия: 3

Източници