<portal>: ポータル要素

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

<portal>HTML の要素で、他の HTML ページを現在のページに埋め込み、新しいページへの移動がスムーズにできるようにします。

<portal><iframe> に似ています。 <iframe> では独立した閲覧コンテキストを作成して埋め込みます。しかし、 <portal> で埋め込まれるコンテンツは <iframe> の場合よりも制限されます。これを操作することはできませんので、文書にウィジェットを埋め込むには適していません。その代わり、 <portal> は他のページのコンテンツのプレビューとして動作します。そのため、埋め込まれたコンテンツへのシームレスな遷移により移動を行うことができます。

属性

この要素にはグローバル属性があります。

referrerpolicy

リファラーポリシーを設定します。これは、 src 属性の値で指定された URL のページをリクエストする際に使用されます。

src

埋め込むページの URL です。

基本的な例

以下の例は https://example.com のコンテンツをプレビューとして埋め込みます。

html
<portal id="exampleportal" src="https://example.com/"></portal>

アクセシビリティの考慮

<portal> が表示するプレビューは、操作が可能ではないため、入力イベントやフォーカスを受けません。そのため、ポータルの埋め込みコンテンツは、アクセシビリティツリーの要素として公開されません。ポータルは、ボタンのように移動してアクティブにすることができ、クリックしたときの既定の動作は、ポータルを有効にすることです。

ポータルには、埋め込まれたページのタイトルが既定のラベルが与えられます。タイトルがない場合は、プレビューで表示されるテキストが結合されてラベルが作成されます。aria-label 属性を使用すると、これを上書きすることができます。

事前レンダリングのためにポータルを使用する場合は、 HTML の hidden 属性または CSS の display プロパティの値を none にして非表示にしてください。

ポータルがアクティブ化している間にアニメーションを使用する場合は、 prefers-reduced-motion メディア特性を尊重してください。

技術的概要

暗黙の ARIA ロール button
DOM インターフェイス HTMLPortalElement

仕様書

Specification
Portals
# the-portal-element

ブラウザーの互換性

BCD tables only load in the browser