Prawidłowo skomentowane HTML znaczniki są ważną częścią dobrze zbudowanej strony internetowej. Te komentarze są łatwe do dodania, a każdy, kto będzie musiał pracować nad kodem tej witryny w przyszłości (w tym Ty lub członkowie dowolnego zespołu, z którym współpracujesz) podziękuje Ci za te komentarze.
Jak dodawać komentarze HTML
HTML można tworzyć za pomocą standardowego edytora tekstu, takiego jak Notepad ++ dla Windows lub TextEdit dla Mac. Możesz także użyć programu do projektowania stron internetowych, takiego jak Adobe Dreamweaver, a nawet platformy CMS, takiej jak Wordpress lub ExpressionEngine. Niezależnie od narzędzia, którego używasz do tworzenia kodu HTML, jeśli pracujesz bezpośrednio z kodem, możesz dodać komentarze HTML w następujący sposób:
Dodaj pierwszą część tagu komentarza HTML:
Po tym otwierającym fragmencie komentarza napisz dowolny tekst, który chcesz umieścić w tym komentarzu. W przyszłości prawdopodobnie będą to instrukcje dla Twojego lub innego programisty. Na przykład, jeśli chcesz określić, gdzie dana sekcja na stronie zaczyna się lub kończy w znaczniku, możesz użyć komentarza, aby to szczegółowo opisać.
Gdy tekst komentarza będzie gotowy, zamknij tag komentarza w następujący sposób:
W sumie Twój komentarz będzie wyglądał mniej więcej tak:
To naprawdę takie proste.
Wyświetlanie komentarzy
Wszelkie komentarze dodane do kodu HTML pojawią się w tym kodzie, gdy ktoś wyświetla źródło strony internetowej lub otwiera kod HTML w edytorze, aby wprowadzić pewne zmiany. Ten tekst komentarza nie pojawi się jednak w przeglądarce internetowej, gdy zwykli użytkownicy odwiedzą witrynę. W przeciwieństwie do innych elementów HTML, w tym akapitów, nagłówków lub list, które faktycznie wpływają na stronę w tych przeglądarkach, komentarze są tak naprawdę fragmentami strony „za kulisami”.
Komentarze do celów testowych
Ponieważ komentarze nie pojawiają się w przeglądarce internetowej, można ich użyć do „wyłączenia” części strony podczas testowania lub tworzenia strony. Jeśli dodasz otwierającą część komentarza bezpośrednio przed częścią strony/kodem, którą chcesz ukryć, a następnie dodasz zamykająca część na końcu tego kodu (komentarze HTML mogą obejmować wiele wierszy, więc możesz otworzyć komentarz powiedzmy w 50 wierszu kodu i zamknij go w wierszu 75 bez żadnych problemów), wtedy wszelkie elementy HTML, które mieszczą się w tym komentarzu, nie będą już wyświetlane w przeglądarka. Pozostaną one w kodzie, ale nie wpłyną na wizualne wyświetlanie strony. Jeśli chcesz przetestować stronę, aby sprawdzić, czy dana sekcja nie powoduje problemów itp., komentowanie tego obszaru jest lepsze niż jego usuwanie. W przypadku komentarzy, jeśli dany fragment kodu okaże się nie być problemem, możesz łatwo usunąć fragmenty komentarza, a kod zostanie wyświetlony ponownie. Tylko upewnij się, że te komentarze, które są używane do testowania, nie trafiają do witryn produkcyjnych. Jeśli jakiś obszar strony nie powinien być wyświetlany, chcesz usunąć kod, a nie tylko skomentować go przed uruchomieniem tej witryny.
Jednym ze świetnych zastosowań komentarzy HTML podczas programowania jest budowanie responsywna strona internetowa. Ponieważ różne części tej witryny zmienią swój wygląd w zależności od różne rozmiary ekranu, w tym niektóre obszary, które mogą w ogóle nie być wyświetlane, używanie komentarzy do włączania i wyłączania sekcji strony może być szybką i łatwą sztuczką podczas tworzenia.
Jeśli chodzi o wydajność
Widziałem, jak niektórzy profesjonaliści sieciowi sugerują, że komentarze powinny zostać usunięte z plików HTML i CSS, aby zmniejszyć rozmiar tych plików i stworzyć szybciej ładujące się strony. Chociaż zgadzam się, że strony powinny być zoptymalizowany pod kątem wydajności i powinien ładować się szybko, wciąż jest miejsce na sprytne wykorzystanie komentarzy w kodzie. Pamiętaj, że te komentarze mają na celu ułatwienie pracy w witrynie w przyszłości, o ile nie przesadzasz z komentarze dodawane do każdej linii kodu, mały rozmiar pliku dodany do strony z powodu komentarzy powinien być większy niż do przyjęcia.
Wskazówki dotyczące korzystania z komentarzy
Kilka rzeczy, o których należy pamiętać lub pamiętać podczas korzystania z komentarzy HTML:
- Komentarze mogą składać się z wielu wierszy.
- Użyj komentarzy, aby udokumentować rozwój swojej strony.
- Komentarze mogą również dokumentować treść, wiersze lub kolumny tabeli, śledzić zmiany lub cokolwiek innego.
- Komentarze, które „wyłączają” obszary witryny, nie powinny trafiać do produkcji, chyba że ta zmiana jest tymczasowy, który zostanie odwrócony w krótkim czasie (np. włączenie lub wyłączenie komunikatu ostrzegawczego, gdy potrzebne).