diff options
Diffstat (limited to 'files/pt-pt/orphaned/referência_do_dom_gecko/prefácio/index.html')
| -rw-r--r-- | files/pt-pt/orphaned/referência_do_dom_gecko/prefácio/index.html | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/files/pt-pt/orphaned/referência_do_dom_gecko/prefácio/index.html b/files/pt-pt/orphaned/referência_do_dom_gecko/prefácio/index.html new file mode 100644 index 0000000000..f026443d93 --- /dev/null +++ b/files/pt-pt/orphaned/referência_do_dom_gecko/prefácio/index.html @@ -0,0 +1,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> |