dom

Este repositório hospeda o padrão DOM.

Código de Conduta

Temos o compromisso de fornecer um ambiente amigável, seguro e acolhedor para todos. Por favor, leia e respeite o Código de Conduta.

Oportunidades de contribuição

As pessoas percebem problemas menores e maiores com o padrão DOM o tempo todo e adoraríamos sua ajuda para corrigi-los. Solicitações pull para erros tipográficos e gramaticais também são bem-vindas.

Edições rotuladas como "boa primeira edição" são um bom lugar para experimentar a edição do padrão DOM. Observe que não atribuímos problemas e também não há motivo para solicitar disponibilidade, apenas forneça uma solicitação pull.

Se você está pensando em sugerir um novo recurso, leia os documentos FAQ e Modo de Trabalho para se familiarizar com o processo.

Teremos prazer em ajudá-lo com tudo isso no Chat.

Solicitações pull

Resumindo, altere dom.bs e envie seu patch, com uma boa mensagem de commit.

Adicione seu nome à seção Agradecimentos em sua primeira solicitação pull, mesmo para correções triviais. Os nomes são classificados lexicograficamente.

Para garantir que seu patch atenda a todos os requisitos necessários, consulte também as Diretrizes para Colaboradores. Espera-se que os editores do padrão DOM sigam as Diretrizes do Mantenedor.

Testes

Os testes são uma parte essencial do processo de padronização e precisarão ser criados ou ajustados à medida que forem feitas alterações no padrão. Os testes para o padrão DOM podem ser encontrados no diretório dom/ de web-platform-tests/wpt .

Um painel mostrando os testes em execução nos mecanismos do navegador pode ser visto em wpt.fyi/results/dom.

Construindo "localmente"

Para iteração local rápida, execute make ; isso usará um serviço web para construir o padrão, para que você não precise instalar nada. Veja mais nas Diretrizes para Colaboradores.

Formatação

Use uma largura de coluna de 100 caracteres.

Não use novas linhas dentro de elementos "inline", mesmo que isso signifique exceder o requisito de largura da coluna.

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

está tudo bem e

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

não é.

O uso de novas linhas entre nomes de tags de elementos "inline" e seu conteúdo também é proibido. (Isso na verdade altera o conteúdo, adicionando espaços.) Isso é

 < a > token </ a >

está bem e

 < a > token
</ a >

não é.

Um elemento <li> sempre possui um elemento <p> dentro dele, a menos que seja filho de <ul class=brief> .

Se um elemento "bloco" contiver um único elemento "bloco", não o coloque em uma nova linha.

Não recue nada, exceto um novo elemento "bloco". Por exemplo

 < 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ão está recuado, mas

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

é.

As tags finais podem ser incluídas (se feitas de forma consistente) e os atributos podem ser colocados entre aspas (usando aspas duplas), embora o tema predominante seja omitir as tags finais e não citar os atributos (a menos que contenham um espaço).

Coloque uma nova linha entre os parágrafos (incluindo os elementos da lista). Coloque três novas linhas antes de <h2> e duas novas linhas antes de outros títulos. Isto não se aplica quando um título aninhado segue o título pai.

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

Use camel-case para nomes de variáveis ​​e nomes "espaçados" para definições, algoritmos, 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 > .