Document: pictureInPictureElement プロパティ

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

pictureInPictureElement は Document インターフェイスの読み取り専用プロパティで、 この文書内のピクチャインピクチャモードで現在表示されている Element を返します。ピクチャインピクチャモードが現在使用されていない場合は null を返します。

このプロパティは読み取り専用ですが、（厳格モードであっても）変更されても例外は発生しません。セッターは何もせず、無視されます。

値

現在ピクチャインピクチャモードになっている Element オブジェクトへの参照です。現在この document でピクチャインピクチャモードが使用されていない場合、返される値は null です。

例

この例では pictureInPictureElement が返す値を検査する関数 exitPictureInPicture() を表示しています。現在の文書がピクチャインピクチャモードでない（pictureInPictureElement が null である）場合、 Document.exitPictureInPicture() を実行してピクチャインピクチャモードを終了します。

js
function exitPictureInPicture() {
  if (document.pictureInPictureElement) {
    document.exitPictureInPicture();
  }
}

仕様書

Specification
Picture-in-Picture
# ref-for-dom-documentorshadowroot-pictureinpictureelement①⑤

ブラウザーの互換性

BCD tables only load in the browser

関連情報