ShadowRoot.mode

La propriété mode, rattachée à l'interface ShadowRoot, indique son mode. Celui-ci peut valoir open ou closed et indique si les fonctionnalités internes de la racine sont accessibles en JavaScript.

Lorsque le mode d'une racine shadow vaut closed, les détails d'implémentation internes sont inaccessibles et inchangeables avec JavaScript (de la même façon que les détails du fonctionnement de l'élément <video> sont inaccessibles et inchangeables en JavaScript).

Syntaxe

var mode = shadowRoot.mode

Valeur

Une valeur définie via l'énumération ShadowRootMode : soit open, soit closed.

Exemples

let customElem = document.querySelector('mon-element-shadow-dom');
let shadow = customElem.shadowRoot;

// Une autre façon de vérifier si la racine est ouverte :
// on obtiendra null si elle est fermée
if(shadow) {
  // Si elle est ouverte, on ferme la racine pour 
  // cacher ce qu'il y a à l'intérieur.
  shadow.mode = 'closed';
}

Spécifications

Spécification État Commentaires
DOM
La définition de 'ShadowRoot.mode' dans cette spécification.
Standard évolutif

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
mode
Expérimentale
Chrome Support complet 57Edge Aucun support Non
Notes
Aucun support Non
Notes
Notes In Development
Firefox Support complet 63
Support complet 63
Aucun support 59 — 63
Désactivée
Désactivée From version 59 until version 63 (exclusive): this feature is behind the dom.webcomponents.shadowdom.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Aucun support NonOpera Support complet 40Safari Support complet 10.1WebView Android Support complet 57Chrome Android Support complet 57Firefox Android Support complet 63
Support complet 63
Aucun support 59 — 63
Désactivée
Désactivée From version 59 until version 63 (exclusive): this feature is behind the dom.webcomponents.shadowdom.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Support complet 41Safari iOS Support complet 10.3Samsung Internet Android Support complet 6.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.