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
|
---
title: Przedmowa
slug: conflicting/Web/API/Document_Object_Model
tags:
- DOM
- Dokumentacja_Gecko_DOM
- Gecko
- Wszystkie_kategorie
translation_of: Web/API/Document_Object_Model
translation_of_original: Web/API/Document_Object_Model/Preface
original_slug: Dokumentacja_Gecko_DOM/Przedmowa
---
<p>{{ ApiRef() }}</p>
<h3 id="O_dokumentacji" name="O_dokumentacji">O dokumentacji</h3>
<p>Ten rozdział opisuje przewodnik jaki czytasz: czyli czym jest, jakie informacje są w nim zaprezentowane i w jaki sposób można użyć przykładów zawartych w dokumentacji do własnego programowania.</p>
<p>Uwaga, bo ten dokument nie służy do programowania i nie jest aktualnie pełną listą metod DOM i własności zaimplementowanych w Gecko. Każdy indywidualny rozdział dokumentu (np., <a href="pl/DOM/document">Obiekt document</a>) są w pełni opisanym obiektem(ami). Jako informacje dokumentacji dla rozmaitych użytkowników wraz z odnośnikami do poszczególnych części API będą zintegrowane z tym dokumentem.</p>
<h3 id="Kto_powinien_j.C4.85_przeczyta.C4.87" name="Kto_powinien_j.C4.85_przeczyta.C4.87">Kto powinien ją przeczytać</h3>
<p>Czytelnik <a href="pl/Dokumentacja_Gecko_DOM">dokumentacji Gecko DOM</a> jest programista piszący strony internetowe lub wprawny użytkownik sieci, który wie trochę o pisaniu stron oraz zna ich budowę. W dokumentacji nie tworzy się założeń, że czytelnik posiada wiedzę z DOM, z <a href="pl/XML">XML</a>, z tematyki serwerów sieciowych lub standardów sieciowych, czy nawet z <a href="pl/JavaScript">JavaScriptu</a>, bo język, w którym DOM został stworzony, jest dostępny dla czytającego tą dokumentację. Natomiast w tym dokumencie założono, że czytelnik ma obycie z <a href="pl/HTML">HTML</a>, ze znacznikami, z podstawową strukturą stron internetowych, z przeglądarkami i z arkuszami stylów.</p>
<p>We wstępnym materiale, znajduje się wiele przykładów i ich wykorzystanie na bardzo wysokim poziomie, dokument jest dla "początkujących" programistów sieciowych. Ogólnie, kiedykolwiek, dokumentacja API powinna być wartościowa zarówno dla doświadczonych jak i niedoświadczonych deweloperów.</p>
<h3 id="Czym_jest_Gecko.3F" name="Czym_jest_Gecko.3F">Czym jest Gecko?</h3>
<p>Mozilla, Firefox, Netscape 6+, i inne oparte o Mozillę przeglądarki posiadają identyczną implementację DOM. Dzieje się tak ponieważ używają tej samej technologii. <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, komponent oprogramowania w tych przeglądarkach, który obsługuje przetwarzanie kodu HTML, rozmieszczenie elementów na stronach, model obiektowy dokumentu (DOM), a nawet tworzenie całego interfejsu aplikacji, jest szybkim, zgodnym ze standardami silnikiem renderowania, który implementuje standard W3C DOM i podobny do DOM (ale niestandardowy) model obiektowy przeglądarki (np., <a href="pl/DOM/window"><code>window</code></a> i inne) w kontekście stron WWW i interfejsu aplikacji.</p>
<p>Mimo, że interfejs aplikacji i zawartość wyświetlana przez przeglądarkę różnią się w wielu praktycznych aspektach, DOM reprezentuje je jednorodnie jako hierarchię węzłów. <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="Sk.C5.82adnia_API" name="Sk.C5.82adnia_API">Składnia API</h3>
<p>Każdy opis w dokumentacji API zawiera przykłady składni, parametry wejścia - wyjścia (gdzie podawany jest również typ zmiennej), przykład, dodatkowe uwagi i link do odpowiedniego tematu w specyfikacji.</p>
<p>Normalnie właściwości tylko do odczytu posiadają tylko jedna linię składni, gdyż mogą być one tylko odczytane a nie zapisane. Na przykład własność <code>availHeight</code> obiektu <code>screen</code> zawiera następująca informacje:</p>
<div>
<img alt="Grafika:Preface2.gif"></div>
<p>Oznacza to, że można używać tylko własności z prawej strony wyrażenia; dla własności typu odczyt/zapis można je wykorzystywać po obydwu stronach wyrażenia jak ilustruje poniższy przykład:</p>
<div>
<img alt="Grafika:Prefacea.gif"></div>
<p>Ogólnie, dla obiektów opisanych powyżej jest podana prosta składnia, np. <code>element</code> dla wszystkich elementów, <code>document</code> dla głównych dokumentów obiektu, table dla obiektu <code>TABLE</code> itd. (zobacz <a href="pl/Dokumentacja_Gecko_DOM/Wprowadzenie#Wa.C5.BCne_typy_danych">Ważne typy danych</a> dla różnych typów danych).</p>
<h3 id="Korzystanie_z_przyk.C5.82ad.C3.B3w" name="Korzystanie_z_przyk.C5.82ad.C3.B3w">Korzystanie z przykładów</h3>
<p>Wiele przykładów w tej dokumentacji jest pełnymi plikami, które możemy wykorzystać poprzez skopiowanie i wklejenie do nowego pliku i następnie otworzenie w swojej przeglądarce. Reszta jest tylko fragmentami kodu. Taki fragment możesz uruchomić poprzez umieszczenie go w wewnątrz funkcji JavaScript zwracającej nazwę. Na przykład własność <a href="pl/DOM/window.document">window.document</a> może być testowana wewnątrz funkcji takiej jak ta poniżej, która jest wywołana za pomocą przycisku:</p>
<pre><html>
<script>
function testWinDoc() {
doc= window.document;
alert(doc.title);
}
</script>
<button onclick="testWinDoc();">Test własności dokumentu</button>
</html>
</pre>
<p>Podobne funkcje i strony można wymyślić dla wszystkich składników obiektów, które jeszcze nie znajdują się w pakiecie. Zobacz temat <a href="pl/Dokumentacja_Gecko_DOM/Wprowadzenie#Testowanie_DOM_API">Testowanie DOM API</a> we wprowadzeniu dla "test harness", który będziesz mógł użyć do testowania liczby wszystkich API na raz.</p>
<div class="noinclude">
</div>
<p>{{ languages( { "en": "en/Gecko_DOM_Reference/Preface", "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", "zh-cn": "cn/Gecko_DOM_\u53c2\u8003/Preface" } ) }}</p>
|
