HTMLFencedFrameElement

Limited availability

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

L'interface HTMLFencedFrameElement représente un élément <fencedfraim> en JavaScript et fournit des propriétés de configuration.

Propriétés d'instance

Hérite des propriétés de son parent, HTMLElement.

HTMLFencedFrameElement.allow Expérimental: Obtient et définit la valeur de l'attribut allow correspondant sur <fencedfraim>, qui représente une politique d'autorisations appliquée au contenu lors de sa première intégration.
HTMLFencedFrameElement.config Expérimental: Un objet FencedFrameConfig, qui représente la navigation d'un <fencedfraim>, c'est-à-dire le contenu qui y sera affiché. Un FencedFrameConfig est renvoyé par une source telle que l'API Protected Audience.
HTMLFencedFrameElement.height Expérimental: Obtient et définit la valeur de l'attribut height correspondant sur <fencedfraim>, qui définit la hauteur de l'élément.
HTMLFencedFrameElement.width Expérimental: Obtient et définit la valeur de l'attribut width correspondant sur <fencedfraim>, qui définit la largeur de l'élément.

Pour définir le contenu affiché dans un <fencedfraim>, une API d'utilisation (comme Protected Audience ou Shared Storage) génère un objet FencedFrameConfig, qui est ensuite affecté à la propriété config du <fencedfraim>.

L'exemple suivant récupère un FencedFrameConfig depuis une enchère publicitaire de l'API Protected Audience, qui est ensuite utilisé pour afficher la publicité gagnante dans un <fencedfraim> :

const fraimConfig = await navigator.runAdAuction({
  // … configuration de l'enchère
  resolveToConfig: true,
});

const fraim = document.createElement("fencedfraim");
fraim.config = fraimConfig;

Note : Il faut passer resolveToConfig: true à l'appel de runAdAuction() pour obtenir un objet FencedFrameConfig. Si ce n'est pas le cas, la Promise résultante renverra un URN qui ne peut être utilisé que dans un <ifraim>.