diff options
Diffstat (limited to 'files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html')
| -rw-r--r-- | files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html | 145 |
1 files changed, 145 insertions, 0 deletions
diff --git a/files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html b/files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html new file mode 100644 index 0000000000..15a49af1cc --- /dev/null +++ b/files/pl/archive/mozilla/firefox/zastosowanie_mikroformatów/index.html @@ -0,0 +1,145 @@ +--- +title: Zastosowanie mikroformatów +slug: Archive/Mozilla/Firefox/Zastosowanie_mikroformatów +tags: + - Firefox 3 +translation_of: Archive/Mozilla/Firefox/Using_microformats +--- +<p>{{ Fx_minversion_header(3) }} +{{ Draft() }} +Mikroformaty umożliwiają przekazywanie przez witryny internetowe do przeglądarek danych o określonej strukturze semantycznej. Umożliwia to zaprezentowanie podsumowania informacji na stronie bez wiedzy na temat tego, jak należy przetwarzać sam przekazywany dokument. W Firefoksie 3 zaimplementowano globalny obiekt <code>Microformats</code>, pozwalający na dostęp do mikroformatów. Interfejs API tego obiektu umożliwia łatwe wykrywanie i odczytywanie mikroformatów. +</p> +<h2 id=".C5.81adowanie_interfejsu_API_mikroformat.C3.B3w" name=".C5.81adowanie_interfejsu_API_mikroformat.C3.B3w">Ładowanie interfejsu API mikroformatów</h2> +<p>Obiekt <code>Microformats</code> można utworzyć za pomocą nowego mechanizmu ładowania skryptów dostępnego w programie Firefox 3. Aby skorzystać z interfejsu API, należy najpierw załadować obiekt: +</p> +<pre class="eval"><span class="nowiki">Components.utils.import("resource://gre/modules/Microformats.js");</span> +</pre> +<p>Po załadowaniu interfejsu API można korzystać z mikroformatów, używając podanych poniżej metod. Informacje na temat przetwarzania mikroformatów znajdują się artykule <a href="pl/Przetwarzanie_mikroformat%c3%b3w_w_j%c4%99zyku_JavaScript">Przetwarzanie mikroformatów w języku JavaScript</a>. +</p> +<h2 id="Wst.C4.99pnie_zdefiniowane_mikroformaty" name="Wst.C4.99pnie_zdefiniowane_mikroformaty">Wstępnie zdefiniowane mikroformaty</h2> +<p>W programie Firefox 3 zaimplementowano definicje kilku popularnych mikroformatów: +</p> +<dl><dt><code><a href="pl/Mikroformat_adr">adr</a></code> +</dt><dd>Reprezentuje adres (np. zamieszkania lub korespondencyjny). +</dd><dt><code><a href="pl/Mikroformat_geo">geo</a></code> +</dt><dd>Reprezentuje lokalizację geograficzną (określaną za pomocą długości i szerokości geograficznej). +</dd><dt><code><a href="pl/Mikroformat_hCard">hCard</a></code> +</dt><dd>Reprezentuje informacje kontaktowe dotyczące osób. +</dd><dt><code><a href="pl/Mikroformat_hCalendar">hCalendar</a></code> +</dt><dd>Reprezentuje pozycję w kalendarzu (np. spotkanie). +</dd><dt><code><a href="pl/Mikroformat_tag">tag</a></code> +</dt><dd>Używany w celu dodawania znaczników do innych mikroformatów. +</dd></dl> +<h2 id="Metody" name="Metody">Metody</h2> +<h3 id="add.28.29" name="add.28.29">add()</h3> +<p>Dodaje nowy mikroformat do modułu mikroformatu. +</p><p>{{ Note("Jeżeli mikroformat o danej nazwie istnieje, jest zastępowany przez nowy mikroformat.") }} +</p> +<pre class="eval">add(nazwa, definicja); +</pre> +<h6 id="Parametry" name="Parametry">Parametry</h6> +<dl><dt><tt>nazwa</tt> +</dt><dd>Nazwa mikroformatu, który ma zostać dodany do modułu mikroformatu. +</dd><dt><tt>definicja</tt> +</dt><dd>Struktura języka JavaScript opisująca mikroformat. Aby uzyskać szczegółowe informacje, patrz <a href="pl/Opisywanie_mikroformat%c3%b3w_w_j%c4%99zyku_JavaScript">Opisywanie mikroformatów w języku JavaScript</a>. +</dd></dl> +<h3 id="count.28.29" name="count.28.29">count()</h3> +<p>Zwraca liczbę istniejących w dokumencie mikroformatów, które spełniają podane kryteria. +</p> +<pre class="eval">liczbaMikroformatow = Microformats.count(nazwa, element_główny, uwzględniaj_rekurencyjnie_ramki); +</pre> +<h6 id="Parametry_2" name="Parametry_2">Parametry</h6> +<dl><dt><tt>nazwa</tt> +</dt><dd>Nazwa mikroformatu, którego egzemplarze są liczone. +</dd><dt><tt>element_główny</tt> +</dt><dd>Argument opcjonalny. Element DOM, od którego ma być rozpoczęte przeszukiwanie. Domyślnie jest to element <code>content.document</code> (innymi słowy, cały dokument). +</dd><dt><tt>uwzględniaj_rekurencyjnie_ramki</tt> +</dt><dd>Argument opcjonalny. W przypadku podania wartości <code>true</code> w przeszukiwaniu uwzględnione będą ramki potomne. Wartością domyślną jest <code>true</code>. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87" name="Zwracana_warto.C5.9B.C4.87">Zwracana wartość</h6> +<p>Liczba całkowita określająca liczbę mikroformatów, które spełniają podane kryteria. +</p> +<h3 id="debug.28.29" name="debug.28.29">debug()</h3> +<p>Zwraca ciąg znaków określający obiekt mikroformatu. +</p><p>{{ Note("Zamiast stosowania metody <code>debug()</code> można po prostu skorzystać z metody obiektu mikroformatu o tej samej nazwie: <code>microformatObject.debug()</code>.") }} +</p> +<pre class="eval">zrzucanyCiag = debug(obiekt_mikroformatu) +</pre> +<h6 id="Parametry_3" name="Parametry_3">Parametry</h6> +<dl><dt><tt>obiekt_mikroformatu</tt> +</dt><dd>Obiekt mikroformatu, którego zrzut jest wykonywany. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_2" name="Zwracana_warto.C5.9B.C4.87_2">Zwracana wartość</h6> +<p>Ciąg znaków opisujący zawartość podanego obiektu mikroformatu. +</p> +<h3 id="get.28.29" name="get.28.29">get()</h3> +<p>Zwraca tablicę z obiektami mikroformatów, odpowiadającymi znalezionym mikroformatom spełniającym podane kryteria. +</p> +<pre class="eval">tablicaMikroformatow = Microformats.count(nazwa, element_główny, opcje, tablica_docelowa); +</pre> +<h6 id="Parametry_4" name="Parametry_4">Parametry</h6> +<dl><dt><tt>nazwa</tt> +</dt><dd>Nazwa poszukiwanego mikroformatu. +</dd><dt><tt>element_główny</tt> +</dt><dd>Element DOM, od którego ma być rozpoczęte przeszukiwanie. +</dd><dt><tt>opcje</tt> +</dt><dd>Argument opcjonalny. Obiekt JavaScript zawierający zero lub więcej następujących wskaźników: +</dd></dl> +<blockquote> +<dl><dt><tt>recurseFrames</tt> +</dt><dd>W przypadku podania wartości <code>true</code> w przeszukiwaniu uwzględnione będą ramki potomne. Wartością domyślną jest <code>true</code>. +</dd><dt><tt>showHidden</tt> +</dt><dd>W przypadku podania wartości <code>true</code> dodawane są ukryte mikroformaty; w przeciwnym przypadku są one ignorowane. Wartością domyślną jest <code>false</code>. +</dd><dt><tt>debug</tt> +</dt><dd>W przypadku korzystania z trybu debugowania należy podać wartość <code>true</code>; w przeciwnym przypadku należy podać wartość <code>false</code>. Wartością domyślną jest <code>false</code>. +</dd></dl> +</blockquote> +<dl><dt><tt>tablica_docelowa</tt> +</dt><dd>Argument opcjonalny. Tablica zawierająca obiekty mikroformatów, do której dodawane będą rezultaty wyszukiwania. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_3" name="Zwracana_warto.C5.9B.C4.87_3">Zwracana wartość</h6> +<p>Nowa tablica zawierająca obiekty mikroformatów, które spełniały podane kryteria, lub tablica określona w obiekcie <tt>microformats</tt>, do której dodano nowe, znalezione obiekty mikroformatów. +</p> +<h3 id="getNamesFromNode.28.29" name="getNamesFromNode.28.29">getNamesFromNode()</h3> +<p>Zwraca listę rozdzielonych znakami spacji nazw mikroformatów, które odpowiadały podanemu węzłowi mikroformatu. +</p> +<pre class="eval">listaNazw = Microformats.getNamesFromNode(węzeł); +</pre> +<h6 id="Parametry_5" name="Parametry_5">Parametry</h6> +<dl><dt><tt>węzeł</tt> +</dt></dl> +<dl><dd>Węzeł, z którego ma zostać pobrana lista nazw mikroformatów. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_4" name="Zwracana_warto.C5.9B.C4.87_4">Zwracana wartość</h6> +<p>Jeżeli podany <tt>węzeł</tt> jest mikroformatem, zwracany jest ciąg znaków stanowiący listę rozdzielonych znakami spacji nazw mikroformatów, które odpowiadały podanemu węzłowi. Jeżeli węzeł nie jest mikroformatem, nie jest zwracana żadna wartość. +</p> +<h3 id="getParent.28.29" name="getParent.28.29">getParent()</h3> +<p>Zwraca nadrzędny węzeł podanego mikroformatu lub węzła potomnego mikroformatu. +</p><p>wezelNadrzedny = Microformats.getParent(węzeł); +</p> +<h6 id="Parametry_6" name="Parametry_6">Parametry</h6> +<dl><dt><tt>węzeł</tt> +</dt><dd>Węzeł, którego węzeł nadrzędny ma być pobrany. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_5" name="Zwracana_warto.C5.9B.C4.87_5">Zwracana wartość</h6> +<p>Węzeł nadrzędny podanego węzła. Jeżeli podany <tt>węzeł</tt> nie jest mikroformatem ani węzłem potomnym mikroformatu, nie jest zwracana żadna wartość. +</p> +<h3 id="isMicroformat.28.29" name="isMicroformat.28.29">isMicroformat()</h3> +<p>Określa, czy podany węzeł DOM jest mikroformatem. +</p> +<pre class="eval">wskaznik = Microformats.isMicroformat(węzeł); +</pre> +<h6 id="Parametry_7" name="Parametry_7">Parametry</h6> +<dl><dt><tt>węzeł</tt> +</dt><dd>Węzeł DOM, który ma zostać sprawdzony. +</dd></dl> +<h6 id="Zwracana_warto.C5.9B.C4.87_6" name="Zwracana_warto.C5.9B.C4.87_6">Zwracana wartość</h6> +<p><code>true</code>, jeżeli węzeł jest mikroformatem; w przeciwnym przypadku zwracana jest wartość <code>false</code>. +{{ Note("Metoda <i>nie</i> zwraca wartości <code>true</code>, jeżeli węzeł jest węzłem potomnym mikroformatu.") }} +</p><p><br> +</p><p><br> +</p><p><br> +</p> +<div class="noinclude"> +</div> +{{ languages( { "en": "en/Using_microformats", "es": "es/El_uso_de_microformatos", "fr": "fr/Utilisation_de_microformats", "ja": "ja/Using_microformats", "ko": "ko/Using_microformats" } ) }} |