lightning:formattedText
テキストを表示し、改行を禁則処理で置き換え、要求された場合は linkify で表示します。このコンポーネントでは、API バージョン 41.0 以降が必要です。
lightning:formattedText コンポーネントは、アンカータグ (「linkify」とも呼ばれる) でテキスト、ラッピング URL、およびメールアドレスを参照のみで表示します。また、\r または \n 文字を <br /> タグに変換します。
アンカータグでテキストブロックに URL とメールアドレスを表示するには、linkify="true" を設定します。設定されていない場合、URL とメールアドレスはプレーンテキストで表示されます。linkify="true" を設定すると、format="html" scope="external" type="new-window:HTML" のアンカータグで URL とメールアドレスがラップされます。URL とメールアドレスには、それぞれ http:// と mailto:// が追加されます。
1<aura:component>
2 <lightning:formattedText linkify="true" value="I like salesforce.com and trailhead.salesforce.com." />
3</aura:component>前の例は次のように表示されます。
1I like <a format="html" scope="external" type="new-window:HTML" href="http://salesforce.com">salesforce.com</a>
2and <a format="html" scope="external" type="new-window:HTML" href="http://trailhead.salesforce.com">trailhead.salesforce.com</a>.使用上の考慮事項
lightning:formattedText では、http、https、ftp、mailto プロトコルがサポートされています。
ハイパーリンクを操作していて target 値を指定する必要がある場合は、代わりに lightning:formattedURL を使用します。メールアドレスのみを操作する場合は、lightning:formattedEmail を使用します。
アンカータグ以外のタグを使用するリッチテキストの場合は、代わりに lightning:formattedRichText を使用します。
属性
| 属性名 | 属性型 | 説明 | 必須項目 |
|---|---|---|---|
| body | Component[] | コンポーネントのボディ。マークアップでは、これはタグのボディに含まれるすべてを指します。 | |
| class | String | コンポーネントの基本クラスに加え、外部要素の CSS クラス。 | |
| title | String | マウスポインタが要素に重ねられたときにツールチップテキストを表示します。 | |
| value | String | 出力するテキスト。 | |
| linkify | Boolean | テキストをリンクに変換するかどうかを指定します。true に設定した場合、URL とメールアドレスがアンカータグで表示されます。 |