Skip to content

2.1 HTML

Jump to bottom
Davi Ramos edited this page Jul 28, 2016 · 4 revisions

As regras de estilo estabelecidas para HTML são baseadas no guia de estilo para HTML da Google.

Tipo de Documento

Use HTML5. O HTML5 é o preferido para todos os documentos HTML. Recomenda-se utilizar o HTML como text/html. Não use XHTML. XHTML, como application/xhtml+xml, pois carece de suporte ao navegador e infraestrutura, além de oferecer menos espaço para sua otimização. Ao definir o tipo de documento utilize a tag que expresse que a versão utilizada será o HTML5.

<!-- Recomendado -->
<!DOCTYPE html>

Escrita

Utilize sempre letras minúsculas para representar tags e atributos.

<!-- Não recomendado -->
<A HREF="/">Home</A>

<!-- Recomendado -->
<a href="/">Home</a>

Use o HTML de acordo com sua finalidade

Use os elementos(“tags”) para designar a função que você tem preferência. Por exemplo, p, que serve para parágrafos, a, para links, e etc. A utilização do HTML de acordo com sua finalidade é importante por razões de acessibilidade, reutilização e eficiência do código.

<!-- Não Recomendado -->
<p><button>Algo</button></p>

<!-- Recomendado -->
<div class="btn-group">
    <button>Algo</button>
</div>

Aspas

Use aspas duplas para os atributos html.

<!-- Não Recomendado -->
<input type='text' name='user[name]' id='user_name'>

<!-- Recomendado -->
<input type="text" name="user[name]" id="user_name">

Conteúdo alternativo para multimídia

Para multimídia, como por exemplo imagens e vídeos, procure fornecer conteúdo alternativo para acessibilidade.

Imagem com proposito puramente decorativo, que por algum motivo não pode ser atribuída por CSS, não deve ter acesso alternativo.

<!-- Recomendado -->
<img src="info.png" alt="Logo InfoJr">

Atributo type

Omitir o atributo type para elementos link para CSS e script para JavaScript. Os valores text/css e text/javascript já são usados por padrão.

<!-- Não recomendado -->
<link rel="stylesheet" href="main.css" type="text/css">
<script src="main.js" type="text/javascript"></script>

<!-- Recomendado -->
<link rel="stylesheet" href="main.css">
<script src="main.js"></script>

Codificação de Caracteres

Verifique se o seu editor utiliza UTF-8 como codificação de caracteres. É importante que especifique a codificação em templates HTML e documentos via <meta charset="utf-8">.

Comentários

Para comentários em HTML, utilize a seguinte marcação <!-- -->

<!--Isto é um comentário. Comentários não são exibidos no navegador-->

Valide sua página

Sempre que possível verifique se sua página HTML segue os padrões estabelecidos pelo W3C.

Clone this wiki locally