Skip to main content

Visit Mozilla.org

HTML:Znaczenie poprawnego komentowania

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

Spis treści

[edytuj] Znaczenie poprawnego komentowania

Podczas tworzenia HTML w trybie standardów, niepoprawnie sformatowane komentarze mogą zepsuć twe strony, powodując wykomentowanie części lub całości ich treści. Podczas tworzenia XHTML lub XML, niepoprawne komentarze spowodują, że twoje dokumenty nie będą mogły w ogóle zostać wyświetlone.

[edytuj] HTML 4.01

Z Rekomendacji W3C dla HTML 4.01, Sekcji 3.2.4 - Komentarze:

Biała spacja nie jest dozwolona między otwierającym delimiterem deklaracji znacznika ("<!") a otwierającym delimiterem komentarza ("--"), ale jest dozwolona między zamykającym delimiterem komentarza ("--") i zamykającym delimiterem deklaracji znacznika (">"). Pospolitym błędem jest umieszczanie łańcucha kresek ("---") wewnątrz komentarza. Twórcy powinni unikać wstawiania wewnątrz komentarza dwóch lub więcej sąsiadujących kresek.

[edytuj] Przykłady

Poniżej przedstawiono prawidłowe komentarze HTML. 

<!-- poprawny komentarz HTML -->
<!-- poprawny komentarz HTML -- >

Poniżej przedstawiono nieprawidłowy komentarz HTML. 

<!-- niepoprawny -- komentarz HTML -->

[edytuj] XML

Z Rekomendacji W3C dla XML 1.0, Sekcji 2.5 - Komentarze:

Definicja: Komentarze mogą pojawiać się w dokumencie gdziekolwiek poza innymi znacznikami; ponadto mogą pojawiać się wewnątrz deklaracji typu dokumentu w miejscach dozwolonych przez gramatykę. Nie wchodzą w skład danych znakowych dokumentu; procesor XML może, choć nie musi, umożliwić aplikacji wydobywać tekst komentarzy. W celu zapewnienia kompatybilności, łańcuch "--" (podwójna kreska) nie może występować wewnątrz komentarzy. Odwołania do parametrów encji nie mogą być rozpoznawane wewnątrz komentarzy. 
[15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'

Zgodnie z opisem gramatyki komentarzy w XML, komentarz ma postać 

<!-- znaki bez sąsiadujących kresek -->

[edytuj] Przykłady

Poniżej przedstawiono prawidłowy komentarz XML i XHTML. 

<!-- poprawny komentarz xml/xhtml -->

Poniżej przedstawiono nieprawidłowe komentarze XML i XHTML. 

<!-- nieprawidłowy -- komentarz xml -->
<!-- nieprawidłowy komentarz xml --->
<!-- nieprawidłowy komentarz xml -- >

[edytuj] Lektury uzupełniające

[edytuj] Informacje o dokumencie

  • Ostatnia aktualizacja: 19 maj 2003
  • Copyright © 2001-2003 Netscape. All rights reserved.
  • Tłumaczenie: Krzysztof Jurewicz
Źródło: "http://developer.mozilla.org/pl/docs/HTML:Znaczenie_poprawnego_komentowania"