dom

Ce référentiel héberge le standard DOM.

Code de conduite

Nous nous engageons à offrir un environnement convivial, sûr et accueillant à tous. Veuillez lire et respecter le code de conduite.

Possibilités de contribution

Les gens remarquent tout le temps des problèmes mineurs et plus importants avec le standard DOM et nous aimerions que vous nous aidiez à les résoudre. Les demandes de tirage pour les erreurs typographiques et grammaticales sont également les bienvenues.

Les numéros étiquetés « bon premier numéro » sont un bon endroit pour avoir un avant-goût de l'édition du standard DOM. Notez que nous n'attribuons pas de problèmes et qu'il n'y a aucune raison non plus de demander la disponibilité, il suffit de fournir une pull request.

Si vous envisagez de suggérer une nouvelle fonctionnalité, lisez les documents FAQ et Mode de travail pour vous familiariser avec le processus.

Nous serions heureux de vous aider avec tout cela sur le chat.

Demandes de tirage

Bref, changez dom.bs et soumettez votre patch, avec un bon message de commit.

Veuillez ajouter votre nom à la section Remerciements dans votre première demande d'extraction, même pour des correctifs triviaux. Les noms sont triés lexicographiquement.

Pour vous assurer que votre correctif répond à toutes les exigences nécessaires, veuillez également consulter les directives des contributeurs. Les éditeurs du standard DOM sont censés suivre les directives du responsable.

Essais

Les tests constituent une partie essentielle du processus de normalisation et devront être créés ou ajustés à mesure que des modifications seront apportées à la norme. Les tests pour la norme DOM peuvent être trouvés dans le répertoire dom/ de web-platform-tests/wpt .

Un tableau de bord montrant les tests exécutés sur les moteurs de navigateur peut être consulté sur wpt.fyi/results/dom.

Construire « localement »

Pour une itération locale rapide, exécutez make ; cela utilisera un service Web pour créer le standard, afin que vous n'ayez rien à installer. Pour en savoir plus, consultez les directives des contributeurs.

Formatage

Utilisez une largeur de colonne de 100 caractères.

N'utilisez pas de nouvelles lignes à l'intérieur d'éléments « en ligne », même si cela signifie dépasser la largeur de colonne requise.

 < p > The
< dfn method for = DOMTokenList lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > &hellip;) </ code > </ dfn >
method, when invoked, must run these steps:

ça va et

 < p > The < dfn method for = DOMTokenList
lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > &hellip;) </ code > </ dfn > method, when
invoked, must run these steps:

ne l'est pas.

L'utilisation de nouvelles lignes entre les noms de balises d'éléments "inline" et leur contenu est également interdite. (Cela modifie en fait le contenu en ajoutant des espaces.) C'est-à-dire

 < a > token </ a >

ça va et

 < a > token
</ a >

ne l'est pas.

Un élément <li> contient toujours un élément <p> , sauf s'il s'agit d'un enfant de <ul class=brief> .

Si un élément "block" contient un seul élément "block", ne le placez pas sur une nouvelle ligne.

Ne mettez rien en retrait sauf un nouvel élément "block". Par exemple

 < li > < p > For each < var > token </ var > in < var > tokens </ var > , in given order, that is not in
 < a > tokens </ a > , append < var > token </ var > to < a > tokens </ a > .

n'est pas en retrait, mais

 < ol >
 < li >
  < p > For each < var > token </ var > in < var > tokens </ var > , run these substeps:

  < ol >
   < li > < p > If < var > token </ var > is the empty string, < a > throw </ a > a {{SyntaxError}} exception.

est.

Les balises de fin peuvent être incluses (si cela est fait de manière cohérente) et les attributs peuvent être cités (à l'aide de guillemets doubles), bien que le thème dominant soit d'omettre les balises de fin et de ne pas citer les attributs (sauf s'ils contiennent un espace).

Placez une nouvelle ligne entre les paragraphes (y compris les éléments de liste). Placez trois nouvelles lignes avant <h2> et deux nouvelles lignes avant les autres titres. Cela ne s'applique pas lorsqu'un titre imbriqué suit le titre parent.

 < ul >
 < li > < p > Do not place a newline above.

 < li > < p > Place a newline above.
</ ul >

< p > Place a newline above.


< h3 > Place two newlines above. </ h3 >

< h4 > Placing one newline is OK here. </ h4 >


< h4 > Place two newlines above. </ h4 >

Utilisez camel-case pour les noms de variables et les noms "espacés" pour les définitions, les algorithmes, etc.

 < p > A < a for = / > request </ a > has an associated
< dfn export for = request id = concept-request-redirect-mode > redirect mode </ dfn > ,...

 < p > Let < var > redirectMode </ var > be < var > request </ var > 's < a for = request > redirect mode </ a > .