Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLFencedFrameElement

Limited availability

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

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

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

EventTarget Node Element HTMLElement HTMLFencedFrameElement

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.

Exemples

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

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

Spécifications

Specification
Fenced Frame
# htmlfencedframeelement

Compatibilité des navigateurs

Voir aussi