From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../pref\303\241cio/index.html" | 51 ++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 "files/pt-pt/refer\303\252ncia_do_dom_gecko/pref\303\241cio/index.html" (limited to 'files/pt-pt/referência_do_dom_gecko') diff --git "a/files/pt-pt/refer\303\252ncia_do_dom_gecko/pref\303\241cio/index.html" "b/files/pt-pt/refer\303\252ncia_do_dom_gecko/pref\303\241cio/index.html" new file mode 100644 index 0000000000..f026443d93 --- /dev/null +++ "b/files/pt-pt/refer\303\252ncia_do_dom_gecko/pref\303\241cio/index.html" @@ -0,0 +1,51 @@ +--- +title: Prefácio +slug: Referência_do_DOM_Gecko/Prefácio +tags: + - Referência_do_DOM_Gecko +--- +

{{ ApiRef() }}

+

Sobre Esta Referência

+

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.

+

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 DOM Document Reference) 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.

+

Quem Deveria Ler Este Guia

+

O leitor do Gecko DOM Reference é 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 XML, com servidores web ou padrões web, e mesmo com JavaScript, a linguagem na qual o DOM se torna acessível para o leitor. Mas o documento pressupõe familiaridade com HTML, com marcações, com a estrutura básica de páginas de internet, com navegadores e com folhas de estilo.

+

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.

+

O Que É Gecko?

+

Mozilla, Firefox, Netscape 6+, e outros navegadores baseados no Mozilla tem implementações idênticas do DOM. Isto é porque eles usam a mesma tecnologia.naturally, it applies only to products based on the same version of Gecko, but it's tricky to explain

+

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, window et al) no contexto de páginas de internet e interfaces de aplicações, ou + + chrome + , do navegador.

+

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. (commenting this incomplete sentence out for now...) The tree structure of the DOM (which in its application to the user

+

Sintaxe da API

+

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.

+

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 availHeight do objeto screen tem a seguinte a seguinte informação de sintaxe:

+
+ Image:Preface2.gif
+

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:

+
+ Image:Prefacea.gif
+

Em geral, o objeto cujo membro está sendo descrito é dado na sentença sintática por um tipo simples, por exemplo, element para todos os elementos, document para o objeto de documento de nível mais alto, table para o objeto tabela, e assim por diante (veja Tipos de dados importantes para maiores informações sobre os tipos de dados).

+

Usando os exemplos

+

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 window.document pode ser testada dentro de uma função como seguinte, que é chamada pelo botão:

+
<html>
+
+<script>
+function testWinDoc() {
+
+  doc= window.document;
+
+  alert(doc.title);
+
+}
+</script>
+
+<button onclick="testWinDoc();">Testar propriedade do document</button>
+
+</html>
+
+

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 Testando a API do DOM para uma bateria de testes que você pode usar para testar de uma vez uma série de APIs.

+
+  
+

{{ 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" } ) }}

-- cgit v1.2.3-54-g00ecf