lightning:formattedUrl
URL をハイパーリンクとして表示します。このコンポーネントでは、API バージョン 41.0 以降が必要です。
lightning:formattedUrl コンポーネントは、href 属性を使用したハイパーリンクとして、URL を参照のみで表示します。リンクは相対 URL または絶対 URL で指定できます。絶対 URL は、http://、https://、ftp:// などのプロトコルを使用します。このコンポーネントは、href 値として絶対 URL、表示テキストとして label を使用してアンカーリンクを表示します。表示ラベルが指定されていない場合、絶対 URL が表示テキストとして使用されます。URL をクリックすると、クリックしたウィンドウと同じウィンドウでその URL にリダイレクトされます。
絶対 URL は、デフォルトで http:// プロトコルを使用して表示されます。
1<aura:component>
2 <lightning:formattedUrl value="www.salesforce.com" />
3</aura:component>前の例によって次の HTML が表示されます。
1<a href="http://www.salesforce.com">http://www.salesforce.com</a>相対 URL は、現在のサイト内のパスに移動します。
1<aura:component>
2 <!-- Resolves to http://current-domain/my/path -->
3 <lightning:formattedUrl value="/my/path" />
4</aura:component>使用上の考慮事項
リンクを開く場所を変更するには、target 属性を使用します。target を指定しない場合、ハイパーリンクは href 属性なしで表示されます。サポートされている target 値は、次のとおりです。
- _blank: 新しいウィンドウまたはタブでリンクが開きます。
- _self: クリックしたフレームと同じフレームでリンクが開きます。これがデフォルトの動作です。
- _parent: 親フレームでリンクが開きます。親がない場合、これは _self と同様です。
- _top: 最上位の参照コンテキストでリンクが開きます。親がない場合、これは _self と同様です。
属性
| 属性名 | 属性型 | 説明 | 必須項目 |
|---|---|---|---|
| body | Component[] | コンポーネントのボディ。マークアップでは、これはタグのボディに含まれるすべてを指します。 | |
| class | String | コンポーネントの基本クラスに加え、外部要素の CSS クラス。 | |
| title | String | マウスポインタが要素に重ねられたときにツールチップテキストを表示します。 | |
| value | String | 書式設定する URL。 | |
| target | String | リンクを開く場所を指定します。オプションは、_blank、_parent、_self、_top です。 | |
| label | String | リンクに表示するテキスト。 | |
| tooltip | String | リンクにマウスポインタが置かれたときに表示するテキスト。 | |
| onclick | Action | URL がクリックされたときにトリガされるアクション。 |