Pot.Text.br

{String} Pot.Text.br ({Object} string [, {Boolean} useXML [, {Boolean} all = false]])

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>
//