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'unetechnologie expérimentale.
Vérifiez attentivement letableau de compatibilité des navigateurs avant de l'utiliser en production.

L'interfaceHTMLFencedFrameElement 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.allowExpérimental: Obtient et définit la valeur de l'attributallow correspondant sur<fencedframe>, qui représente une politique d'autorisations appliquée au contenu lors de sa première intégration.
HTMLFencedFrameElement.configExpérimental: Un objet FencedFrameConfig, qui représente la navigation d'un<fencedframe>, c'est-à-dire le contenu qui y sera affiché. UnFencedFrameConfig est renvoyé par une source telle que l'API Protected Audience.
HTMLFencedFrameElement.heightExpérimental: Obtient et définit la valeur de l'attributheight correspondant sur<fencedframe>, qui définit la hauteur de l'élément.
HTMLFencedFrameElement.widthExpérimental: Obtient et définit la valeur de l'attributwidth 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 (commeProtected Audience ouShared Storage) génère un objetFencedFrameConfig, qui est ensuite affecté à la propriétéconfig du<fencedframe>.

L'exemple suivant récupère unFencedFrameConfig 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 passerresolveToConfig: true à l'appel derunAdAuction() pour obtenir un objetFencedFrameConfig. Si ce n'est pas le cas, laPromise résultante renverra un URN qui ne peut être utilisé que dans un<iframe>.