diff options
Diffstat (limited to 'files/pl/conflicting/web/api/document_object_model')
| -rw-r--r-- | files/pl/conflicting/web/api/document_object_model/index.html | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/files/pl/conflicting/web/api/document_object_model/index.html b/files/pl/conflicting/web/api/document_object_model/index.html new file mode 100644 index 0000000000..23866fd108 --- /dev/null +++ b/files/pl/conflicting/web/api/document_object_model/index.html @@ -0,0 +1,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> |