1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
---
title: lang
slug: Web/HTML/Global_attributes/lang
tags:
- Atributos globais
- Referencia
- lang
translation_of: Web/HTML/Global_attributes/lang
---
<div>{{HTMLSidebar("Global_attributes")}}</div>
<p>O <a href="/pt-BR/docs/Web/HTML/Global_attributes">atributo global</a> <strong><code>lang</code></strong> ajuda a definir o idioma de um elemento: a língua em que elementos não-editáveis são escritos, ou a língua em que elementos editáveis devem ser escritos pelo usuário. O atributo contém uma uma única “tag de idioma” em um formato definido em <a class="external" href="https://www.ietf.org/rfc/bcp/bcp47.txt"><em>Tags para identificar linguagens(BCP47)</em></a>.</p>
<div>{{EmbedInteractiveExample("pages/tabbed/attribute-lang.html","tabbed-shorter")}}</div>
<p class="hidden">O código-fonte para este exemplo interativo está armazenado em um repositório do GitHub. Se você gosta de contribuir para projetos de exemplos interativos, por favor clone <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> e envie-nos um pull request.</p>
<p>Se o valor do atributo é uma <em>string vazia</em> (<code>lang=""</code>), o idioma é definido como <em>unknown (desconhecido)</em>; se a tag de idioma não é válida conforme o BCP47, ela é definida como<em> invalid (invalida)</em>.</p>
<div class="note">
<h2 id="Sintaxe_da_tag_de_idioma">Sintaxe da tag de idioma</h2>
<p>A sintaxe completa do BCP47 é profunda o suficente para caracterizar dialetos de linguagem extremamente expecíficos, mas a maioria dos usos são bem mais simples.</p>
<p>Uma tag de idioma é feita de <em>subtags de idioma </em>separadas por hífen, onde cada subtag indica uma certa propriedade da língua. As três subtags mais comuns são:</p>
<dl>
<dt>Subtag de idioma</dt>
<dd>Necessária. Um código de 2 ou 3 caracteres que define o idioma base, tipicamente escrita em letras minúsculas. Por exemplo, o código para Inglês é <code>en</code> e o código para Português é <code>pt</code>.</dd>
<dt>Subtag de script</dt>
<dd>Opcional. Essa subtag define o sistema de escrita usado para a linguagem, e sempre tem 4 caracteres, com a primeira letra maiúscula. Por exemplo, Francês em Braile é <code>fr-Brai</code> e <code>ja-Kana</code> é Japonês escrito no alfabeto Katakana. Se a língua é escrita em uma maneira tipicamente comum, como Inglês no alfabeto Latino, não é necessário o uso da subtag.</dd>
<dt>Subtag de região</dt>
<dd>Opcional. Essa subtag define um dialeto do idioma base em uma localização particular e tem um código de duas letras maiúsculas referentes ao país, ou um código de três números referentes à uma área fora do país. Por exemplo, <code>es-ES</code> é para espanhol falado na Espanha, e <code>es-013</code> é o espanhol falado na America Central. “Espanhol Internacional” seria <code>es</code>.</dd>
</dl>
<p>A subtag de script precede a região da subtag quando ambos estão presentes— <code>ru-Cyrl-BY</code> é Russo, escrito no alfabeto Cyrillic, falado em Belarus.</p>
<p>Para encontrar os códigos corretos para uma subtag de idioma, acesse <a href="https://r12a.github.io/app-subtags/" rel="external">Language Subtag Lookup</a>.</p>
</div>
<p>Mesmo que o atributo <strong>lang</strong> esteja bem definido ele ainda pode ser ignorado, pois o atributo <a href="/en-US/docs/Web/HTML/Global_attributes/xml:lang"><strong>xml:lang</strong></a> tem prioridade.</p>
<p>Para as pseudo-classes CSS {{cssxref(":lang")}}, dois nomes de idiomas inválidos são diferentes se seus nomes forem diferentes. Por tanto, enquanto <code>:lang(es)</code> corresponde a ambos <code>lang="es-ES"</code> e <code>lang="es-419"</code>, <code>:lang(xyzzy)</code> não corresponde a <code>lang="xyzzy-Zorp!"</code>.</p>
<h2 id="Especificações">Especificações</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('HTML WHATWG', "dom.html#the-lang-and-xml:lang-attributes", "lang")}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td>Sem mudança até o último registro, {{SpecName('HTML5.1')}}</td>
</tr>
<tr>
<td>{{SpecName('HTML5.1', "dom.html#the-lang-and-xml:lang-attributes", "lang")}}</td>
<td>{{Spec2('HTML5.1')}}</td>
<td>Registro de {{SpecName('HTML WHATWG')}}, sem mudança para {{SpecName('HTML5 W3C')}}</td>
</tr>
<tr>
<td>{{SpecName('HTML5 W3C', "dom.html#the-lang-and-xml:lang-attributes", "lang")}}</td>
<td>{{Spec2('HTML5 W3C')}}</td>
<td>Registro de {{SpecName('HTML WHATWG')}}, comportamento com <code>xml:lang</code> e algoritmo de determinação definido. Ele também é um atributo global.</td>
</tr>
<tr>
<td>{{SpecName('HTML4.01', 'struct/dirlang.html#h-8.1', 'lang')}}</td>
<td>{{Spec2('HTML4.01')}}</td>
<td>Suportado em todos os elementos, mas {{HTMLElement("applet")}}, {{HTMLElement("base")}}, {{HTMLElement("basefont")}}, {{HTMLElement("br")}}, {{HTMLElement("frame")}}, {{HTMLElement("frameset")}}, {{HTMLElement("iframe")}}, {{HTMLElement("param")}} e {{HTMLElement("script")}}.</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
<p>{{Compat("html.global_attributes.lang")}}</p>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li>Todos <a href="/pt-BR/docs/Web/HTML/Global_attributes">atributos globais</a>.</li>
</ul>
|
