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
|
---
title: Prefácio
slug: Referência_do_DOM_Gecko/Prefácio
tags:
- Referência_do_DOM_Gecko
---
<p>{{ ApiRef() }}</p>
<h3 id="Sobre_Esta_Refer.C3.AAncia" name="Sobre_Esta_Refer.C3.AAncia">Sobre Esta Referência</h3>
<p>Esta seção descreve o próprio guia: a quem se destina, como a informação está representada, e como você pode usar os exemplos desta referência para seu próprio desenvolvimento de DOM.</p>
<p>Note que este documento está sob desenvolvimento, e atualmente não é uma listagem completa das propriedades e métodos do DOM implementados para o Gecko. No entanto, cada seção individual do documento (por exemplo, o <a href="pt/DOM/document">DOM Document Reference</a>) está completa para o(s) objeto(s) que descreve. Ao passo que as informações de referência para os vários membros das enormes APIs tornam-se disponíveis, elas são integradas neste documento.</p>
<h3 id="Quem_Deveria_Ler_Este_Guia" name="Quem_Deveria_Ler_Este_Guia">Quem Deveria Ler Este Guia</h3>
<p>O leitor do <a href="pt/Gecko_DOM_Reference">Gecko DOM Reference</a> é um desenvolvedor web ou um usuário entusiasta que sabe algo sobre como as páginas de internet são construídas. Esta referência evitar fazer presunções sobre a familiaridade do leitor com o DOM, com <a href="pt/XML">XML</a>, com servidores web ou padrões web, e mesmo com <a href="pt/JavaScript">JavaScript</a>, a linguagem na qual o DOM se torna acessível para o leitor. Mas o documento pressupõe familiaridade com <a href="pt/HTML">HTML</a>, com marcações, com a estrutura básica de páginas de internet, com navegadores e com folhas de estilo.</p>
<p>Aqui está presente o material introdutório, com muitos exemplos, e explicações de alto nível devem ser valiosas tanto para os desenvolvedores web inexperientes quanto para os experientes, e não é apenas um guia de desenvolvimento web para "iniciantes". Em geral, contudo, é um manual de referência da API que está evoluindo.</p>
<h3 id="O_Que_.C3.89_Gecko.3F" name="O_Que_.C3.89_Gecko.3F">O Que É Gecko?</h3>
<p>Mozilla, Firefox, Netscape 6+, e outros navegadores baseados no Mozilla tem implementações idênticas do DOM. Isto é porque eles usam a mesma tecnologia.<span class="comment">naturally, it applies only to products based on the same version of Gecko, but it's tricky to explain</span></p>
<p>Gecko, o componente de software destes navegadores que manipula a análise do HTML, o layout das páginas, o modelo de objeto do documento, e mesmo a renderização da interface da aplicação inteira, é um componente renderizador, rápido, condizente com padrões, que implementa os padrões da W3C e similares (mas não padronizados) para o modelo de objeto de navegador (por exemplo, <a href="pt/DOM/window"><code>window</code></a> et al) no contexto de páginas de internet e interfaces de aplicações, ou
<i>
chrome</i>
, do navegador.</p>
<p>Embora a interface de aplicação e o conteúdo mostrado na tela pelo navegador são diferentes de várias maneiras possíveis, o DOM os dispõe uniformemente como uma hierarquia de nós. <span class="comment">(commenting this incomplete sentence out for now...) The tree structure of the DOM (which in its application to the user</span></p>
<h3 id="Sintaxe_da_API" name="Sintaxe_da_API">Sintaxe da API</h3>
<p>Cada descrição na referência da API inclui a sintaxe, os parâmetros de entrada e saída (onde o tipo de retorno é dado), um exemplo, quaisquer notas adicionais, e um link para a especificação apropriada.</p>
<p>Tipicamente, propriedades somente para leitura têm uma única linha de sintaxe, porque não é possível atribuir-lhes valor, essas propriedades podem apenas ser acessadas. Por exemplo, a propriedade somente para leitura <code>availHeight</code> do objeto <code>screen</code> tem a seguinte a seguinte informação de sintaxe:</p>
<div>
<img alt="Image:Preface2.gif"></div>
<p>Isto significa que você somente pode usar a propriedade do lado direito da sentença; enquanto com propriedades de leitura e escrita, você pode atribuir um valor à propriedade, como o seguinte exemplo de sintaxe ilustra:</p>
<div>
<img alt="Image:Prefacea.gif"></div>
<p>Em geral, o objeto cujo membro está sendo descrito é dado na sentença sintática por um tipo simples, por exemplo, <code>element</code> para todos os elementos, <code>document</code> para o objeto de documento de nível mais alto, <code>table</code> para o objeto tabela, e assim por diante (veja <a href="pt/Gecko_DOM_Reference/Introduction#Important_Data_Types">Tipos de dados importantes</a> para maiores informações sobre os tipos de dados).</p>
<h3 id="Usando_os_exemplos" name="Usando_os_exemplos">Usando os exemplos</h3>
<p>Muitos dos exemplos que se encontram nesta referência são arquivos completos que você pode executar apenas copiando e colando em um novo arquivo e abrindo com o seu navegador. Outros são trechos de código. Você pode executar estes últimos colocando-os dentro de funções de chamada em JavaScript. Por exemplo, o exemplo para a propriedade <a href="pt/DOM/window.document">window.document</a> pode ser testada dentro de uma função como seguinte, que é chamada pelo botão:</p>
<pre><html>
<script>
function testWinDoc() {
doc= window.document;
alert(doc.title);
}
</script>
<button onclick="testWinDoc();">Testar propriedade do document</button>
</html>
</pre>
<p>Funções e páginas similares podem ser concebidas para todos os membros do objeto que todavia não estão prontos para uso imediato. Veja a introdução da seção <a href="pt/Gecko_DOM_Reference/Introduction#Testing_the_DOM_API">Testando a API do DOM</a> para uma bateria de testes que você pode usar para testar de uma vez uma série de APIs.</p>
<div class="noinclude">
</div>
<p>{{ languages( { "es": "es/Referencia_DOM_de_Gecko/Prefacio", "fr": "fr/R\u00e9f\u00e9rence_du_DOM_Gecko/Pr\u00e9face", "ja": "ja/Gecko_DOM_Reference/Preface", "ko": "ko/Gecko_DOM_Reference/Preface", "pl": "pl/Dokumentacja_Gecko_DOM/Przedmowa", "zh-cn": "cn/Gecko_DOM_\u53c2\u8003/Preface" } ) }}</p>
|
