[ Pobierz całość w formacie PDF ]

HTML oraz dwóch znaków ukośnika, aż do napotkania znacznika zamykającego ko-
mentarz (wkrótce dowiemy się, dlaczego).
Zatem, jeżeli umieścimy komentarze HTML pomiędzy znacznikami oraz
, to nasz kod będzie działał normalnie i jednocześnie zabezpieczymy się przed
ewentualnym wyświetleniem kodu na stronie.
Wielokrotne wykorzystywanie kodu
Zanim przeanalizujemy przykład kodu JavaScript, przyjrzyjmy się powodom, dla których
warto zapisywać kod JavaScript w zewnętrznych plikach .js, które potem włączamy
do strony.
Dla niewielkich fragmentów kodu, które są typowe dla osobistych stron WWW, praw-
dopodobnie lepiej jest zapisywać kod JavaScript w samej treści strony. Jeśli fragmenty
kodu są krótkie, przechowywanie wszystkiego w jednym pliku powoduje, że odszukanie
kodu i pielęgnacja skryptu są łatwiejsze.
Jeżeli jednak istnieje prawdopodobieństwo, że ten sam fragment kodu może być wy-
korzystany nie tylko w jednym dokumencie, lepiej zapisać kod JavaScript w pliku
zewnętrznym.
44 JavaScrIpt dIa każdego f& Część I
Pierwszą korzyścią płynącą z umieszczenia kodu na zewnątrz jest fakt, że w sytuacji,
kiedy trzeba zmodyfikować skrypt (jest niemal pewne, że w pewnym momencie taka
potrzeba nastąpi), nie będzie konieczne, by wprowadzać wiele razy te same zmiany na
każdej stronie, która korzysta ze skryptu. Dzięki temu zyskujemy wiele czasu, który
pochłonęłoby nam otwieranie każdego pliku, wklejanie zmian, zapisywanie, a następnie
kopiowanie każdego pliku na serwer. Ponadto, nie musimy martwić się o to, aby zmiany
na każdej ze stron zostały wykonane dokładnie tak samo.
Druga zaleta nie jest tak oczywista. Niektóre przeglądarki na czas trwania sesji z prze-
glądarką buforują zewnętrzne pliki .js, zatem poprzez umieszczenie kodu w zewnętrz-
nym pliku .js. powodujemy, że odwiedzający nasze strony goście muszą pobrać pliki
.js tylko raz, na czas trwania sesji. Tak więc, na przykład, jeżeli mamy w katalogu kilka
plików wykorzystujących menu nawigacyjne, napisane w języku JavaScript, to pobieramy
kod tylko raz i mamy możliwość jego wielokrotnego wykorzystania na kilku stronach.
Ponieważ większość użytkowników Internetu w dalszym ciągu do nawiązania połącze-
nia wykorzystuje modemy, skrócenie czasu pobierania stron jest bardzo istotne.
Dokumentowanie kodu
Kiedy zaczniemy tworzyć bardziej zaawansowane aplikacje JavaScript, wówczas za-
uważymy, że kod stopniowo będzie stawał się coraz bardziej rozbudowany i złożony.
Jeżeli nie będziemy dokumentować naszego kodu, zrozumienie go przez kogoś innego,
bez analizowania wiersz po wierszu sposobu jego działania, będzie bardzo trudne. Nawet
sam autor kodu może mieć trudności w jego zrozumieniu, kiedy po jakimś czasie po-
trzebne stanie się wprowadzenie zmian. Wpisywanie komentarzy w najważniejszych
miejscach kodu może okazać się bardzo pomocne dla lepszego zrozumienia kodu i może
uchronić nas przed frustracją oraz stratą czasu.
W języku JavaScript istnieją dwie metody wprowadzania komentarzy w kodzie; po-
zwalają one na dokumentowanie czynności wykonywanych przez kod. Pierwsza me-
toda polega na utworzeniu komentarza będącego pojedynczym wierszem, natomiast
druga umożliwia utworzenie komentarzy składających się z wielu wierszy.
Aby utworzyć komentarz obejmujący pojedynczy wiersz, wystarczy wprowadzić dwa
kolejne ukośniki ( ). Interpreter języka JavaScript zignoruje wszystkie znaki, które
następują po dwóch znakach ukośnika, aż do końca wiersza. Ukośniki zapowiadające
komentarz można umieścić na początku wiersza lub w dowolnym jego miejscu, po frag-
mencie kodu. Oto przykłady zastosowania tego sposobu wprowadzania komentarzy:
Czasami, dla odpowiedniego skomentowania fragmentu kodu, potrzeba więcej niż
tylko jednego wiersza lub nawet dwóch wierszy. Moglibyśmy oczywiście wprowa-
dzać dwa ukośniki na początku każdego wiersza komentarza, ale jest to trochę uciąż-
liwe. W języku JavaScript istnieje inny, nieco mniej kłopotliwy sposób oznaczania
dłuższego komentarza.
RozdzIał 1. f& Podstawy45 [ Pobierz całość w formacie PDF ]