Pot.js で利用可能。 PotLite.js では利用できません。
行末に <br> を挿入して返します。
Pot.br() は、HTML 文章として適切な箇所に <br> 要素を挿入して返します。
挿入されるのは、改行文字の前です。
デフォルトでは、すべての改行の前に <br> 要素を挿入するのではなく、
インライン要素の終わり、テキスト内などに挿入されます。
引数 string は、対象の HTML 文字列 を渡します。
任意に、引数 useXML を 真 (true) として指定すると、<br> の代わりに <br /> を使用します。
useXML が省略され、文章内で XML と判断した場合は <br /> が使用されます。
明示的に useXML を省略する場合は、null を渡します。
任意に、引数 all を 真 (true) として渡すと、すべての改行の前に挿入します。
Pot.globalize() が適応されている場合、Pot.br() が br() で実行できます。
<br> を挿入した文字列が返ります。
var string = '1. foo.\n2. bar.\n3. baz.'; var result = Pot.br(string); debug(result); // '1. foo.<br>\n2. bar.<br>\n3. baz.'
var string = ' - foo.\n - bar.\n - baz.'; var result = Pot.br(string, true); debug(result); // ' - foo.<br />\n - bar.<br />\n - baz.'
var string = '<ul><li>foo<br />fooo</li><li>bar\nbaaar</li></ul>'; var result = Pot.br(string); debug(result); // '<ul><li>foo<br />fooo</li><li>bar<br />\nbaaar</li></ul>'
var string = [
'<div>',
'<h1>Hoge</h1>',
'<p>',
'foo',
'bar',
'</p>',
'<span>baz</span>',
'<b>qux</b>',
'<pre>',
'function hoge() {',
' return this;',
'}',
'</pre>',
'<hr>',
'</div>'
].join('\n');
var result = Pot.br(string);
debug(result);
//
// result:
//
// <div>
// <h1>Hoge</h1>
// <p>
// foo<br>
// bar<br>
// </p>
// <span>baz</span><br>
// <b>qux</b><br>
// <pre>
// function hoge() {
// return this;
// }
// </pre>
// <hr>
// </div>
//
var string = [
'<div>',
'<div>foo</div>',
'<div>bar</div>',
'<div>baz</div>',
'</div>'
].join('\n');
var result = Pot.br(string, false, true);
debug(result);
//
// result:
//
// <div><br>
// <div>foo</div><br>
// <div>bar</div><br>
// <div>baz</div><br>
// </div>
//