HTMLFencedFrameElement

Limited availability

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

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 <fencedframe> 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 <fencedframe>, 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 <fencedframe>, 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 <fencedframe>, 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 <fencedframe>, qui définit la largeur de l'élément.

Pour définir le contenu affiché dans un <fencedframe>, 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 <fencedframe>.

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 <fencedframe> :

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

const frame = document.createElement("fencedframe");
frame.config = frameConfig;

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 <iframe>.