DEV Community

Cover image for What exactly is JavaScript Tagged Template Literal?
Tapas Adhikary
Tapas Adhikary

Posted on • Originally published at blog.greenroots.info

What exactly is JavaScript Tagged Template Literal?

Before ES6(ECMAScript 2015), we have used single quotes('...') and double quotes("...") to wrap string literals. A simple example is,

var msg = "Hello, I'm Joe and my favorite color is purple";
Enter fullscreen mode Exit fullscreen mode

There were limitations when we had to concatenate multiple strings and the string literal has dynamic values. The readability of these concatenations used to be a challenge as well.

var frag1 = "Hello, I'm";
var val1= "Joe";
var frag2 = "and my favorite color is";
var val2 = "purple";

var msg = frag1 + ' ' + val1 + ' ' + frag2 + ' ' + val2;
Enter fullscreen mode Exit fullscreen mode

Do you see another problem? If someone only reading the line where the concatenation takes place, he/she doesn't have much idea of the resultant string.

With ES6 we have got template literals which are string literals that allow embedding expressions. Template literals are enclosed by the backtick (` `) characters instead of single or double-quotes.

Template literals can contain placeholders that are specified by the dollar sign($) and curly braces(${expression}). The above example can be written with template literals as,

const name = 'Joe';
const color = 'purple';

const message = `Hello, I'm ${name} and my favorite color is ${color}`;
console.log(message);
Enter fullscreen mode Exit fullscreen mode

Output,

Hello, I'm Joe and my favorite color is purple
Enter fullscreen mode Exit fullscreen mode

This is much better and favorable for developers to use.

What is the Tagged Template Literal?

A Tagged Template Literal is usually a function that precedes a template literal to help you in manipulating the output. It's fine if you find it confusing. We will understand it in a few simple steps.

Let us take an example of this template literal again,

`Hello, I'm ${name} and my favorite color is ${color}`
Enter fullscreen mode Exit fullscreen mode

We want to manipulate the output such that, it returns a string like the below when we pass the name as, Joe and color as, green.

Hello Joe, Have a Nice Day! We know your favorite color is green
Enter fullscreen mode Exit fullscreen mode

How about, displaying this message in the color that is passed as an expression to the template literal? Like this when the color value is green,

image.png

Welcome Tag function

Let us first create a tag function. This is a regular JavaScript function that should return a value as per your needs. This return value is usually a manipulated output based on the template literal strings and expressions.

function introduce() {                
    return 'introduce...';
}
Enter fullscreen mode Exit fullscreen mode

Next, We mention the tag function before the template literal so that, the tag function gets associated with it.

const name = 'Joe';
const color = 'green';

const message = introduce`Hello, I'm ${name} and my favorite color is ${color}`;
Enter fullscreen mode Exit fullscreen mode

Please note the tag function introduce before the template literal.

Tag function takes arguments

The first argument of a tag function contains an array of string values. The remaining arguments are related to the expressions.

function introduce(strings, arg0, arg1) {
  console.log('strings', strings);
  console.log('arg0', arg0);
  console.log('arg1', arg1);

  return 'introduce...';
}

const name = 'Joe';
const color = 'purple';

const message = introduce`Hello, I'm ${name} and ${color} is my favorite color!`;
Enter fullscreen mode Exit fullscreen mode

The argument strings is an array of all the strings in the template literals and both arg0 and arg1 represent the name and color values here.

split_1.png

Output,

screen_1.png

Passing the expressions as individual arguments is not so great. Think about it, if there are 10 expressions in a template literal. We can make use of JavaScript rest operator(...values) to collect the arguments as an array.

function introduce(strings, ...values) {
  console.log('strings', strings);
  console.log('values', values);

  return 'introduce...';
}

const name = 'Joe';
const color = 'purple';

const message = introduce`Hello, I'm ${name} and ${color} is my favorite color!`;
Enter fullscreen mode Exit fullscreen mode

In this case, both strings and values are arrays. The strings argument contains all the strings where the values argument contains all the expression values.

split_2.png

Output,

screen_2.png

Now, we can do everything possible with these strings and expression values to manipulate them.

The desired output

To get the desired output after the string manipulation, we will write a small logic inside the introduce function.

 function introduce(strings, ...values) {                                                        
   let msg = 
     `<span style="color:${values[1]}">
           Hello ${values[0]}, Have a Nice Day! We know your favorite color is <u>${values[1]}</u>
      </span>`;

   return msg;
}

const name = 'Joe';
const color = 'green';

const message = introduce`Hello, I'm ${name} and ${color} is my favorite color!`;

console.log(message);

Enter fullscreen mode Exit fullscreen mode

We create a new template literal using the expression values and wrap it with the span element. Please notice, we have added a style to the span element to color the text as well.

Output,

<span style="color:green">
    Hello Joe, Have a Nice Day! We know your favorite color is <u>green</u>
</span>
Enter fullscreen mode Exit fullscreen mode

Now, if you use the above output to add as innerHTML you can render it in the browser.

document.body.innerHTML = message;
Enter fullscreen mode Exit fullscreen mode

Output,

image.png

The text color will change as and when you change the color variable value in your code.

Did you know πŸ’…?

If you are familiar with reactjs, you probably know about the styled-component. But, did you know, styled-components are created using tagged template literals?

Yes true. Notice the syntax of a button created with the styled-component,

const Button = styled.button`
  background-color: papayawhip;
  border-radius: 3px;
  color: palevioletred;
`
Enter fullscreen mode Exit fullscreen mode

Does it look familiar to the tagged template literal we learned? Read this awesome article The magic behind πŸ’… styled-components to know more about it.

Conclusion

Tagged Template Literals are powerful and the usage will vary from one application to another. If you are using it already, please let us know in the comment section below.

At the same time, if you were new to it before reading the article, lookout for opportunities to use it.

I have updated the js-tips-tricks project in GitHub with code examples. You may want to have a look.

GitHub logo atapas / js-tips-tricks

List of JavaScript tips and tricks I am learning everyday!

You may also like,




If it was useful to you, please Like/Share so that, it reaches others as well. You can @ me on Twitter (@tapasadhikary) with comments, or feel free to follow me.

Top comments (2)

Collapse
 
gr3g profile image
Greg Motyl

You have managed to put things in clear and consistent way. Very good article, thank you for sharing!

Collapse
 
atapas profile image
Tapas Adhikary

Thanks Greg!