Skip to content

DanielWeiner/multiline

 
 

Repository files navigation

multiline Build Status

Multiline strings in JavaScript

No more string concatenation or array join!

Note that ES6 will have template string which can be multiline, but time...

Before

var str = '' +
'<!doctype html>' +
'<html>' +
'	<body>' +
'		<h1>Hello world</h1>' +
'	</body>' +
'</html>' +
'';

After

var str = multiline(function(){/*
<!doctype html>
<html>
	<body>
		<h1>Hello world!</h1>
	</body>
</html>
*/});

How

It works by wrapping the text in a block comment, anonymous function, and a function call. The anonymous function is passed into the function call and the contents of the comment extracted.

Even though it's slower than string concat, that shouldn't realistically matter as you can still do 2 million of those a second. Convenience over micro performance always.

Install

npm install --save multiline

Browser

Compatibility

  • Latest Chrome
  • Firefox >=17
  • Safari >=4
  • Opera >=9
  • Internet Explorer >=6

Make sure to use /*! instead of /* when minifying to prevent the comments from being stripped.

Download manually or with a package-manager.

bower install --save multiline
component install sindresorhus/multiline

Example

Everything after the first newline and before the last will be returned as seen below:

var str = multiline(function(){/*
<!doctype html>
<html>
	<body>
		<h1>Hello world!</h1>
	</body>
</html>
*/});

console.log(str);

Which outputs:

<!doctype html>
<html>
	<body>
		<h1>Hello world!</h1>
	</body>
</html>

And a real-world use-case.

String Interpolation

You can interpolate local variables and expressions by inserting them inside $[].

For example:

var name = 'Daniel';
var str = multiline(function(){/*
Hello, $[name]!
*/});

console.log(str);

Will output:

Hello, Daniel!

Experiment

I've also done an experiment where you don't need the anonymous function. It's too fragile and slow to be practical though.

It generates a callstack and extracts the contents of the comment in the function call.

var str = multiline(/*
<!doctype html>
<html>
	<body>
		<h1>Hello world!</h1>
	</body>
</html>
*/);

License

MIT © Sindre Sorhus

About

Multiline strings in JavaScript

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 100.0%