73 Часть V. Разработка программ и написание скриптов
что делает данная процедура. Другими словами, при написании комментариев можно считать, что процедура для вас является черным ящиком. Вы описываете входные данные для черного ящика, а также получаемый результат или изменение состояния Web-страницы, происшедшее в результате работы процедуры. Не заботьтесь о том, как это произойдет;все, что требуется описать, это результат работы процедуры.
В табл. 29.15 показаны разделы, которые следует включать в блок комментариев для каждой процедуры. Из перечисленных разделов рекомендуется всегда включать первый раздел — назначение. Остальные разделы можно опустить.
Таблица 29.15
Раздел блока комментариев Описание
Назначение Краткое описание того, что делает процедура (но не как она работает)
Использование внешних эле- Список внешних переменных, элементов управ-ментов ления или иных элементов, состояние которых влияет на выполнение данной процедуры
Изменение внешних элементов Описание воздействий данной процедуры на
внешние переменные, элементы управления или иные элементы
Входные параметры Описание всех параметров процедуры Возвращаемое значение Описание возвращаемого функцией значения
Примеры составления скриптов
Приведем несколько законченных примеров записи скриптов на языке VBScript. Первый пример показывает, как можно выполнять проверку данных в форме. Второй пример показывает возможность использования таймера для создания бегущего сообщения в строке состояния. В последнем примере скрипт используется для реализации клиентского варианта изображения-карты.
Проверка данных в форме
Этот пример показывает возможность выполнения проверки данных в форме до отсылки ее на сервер. Вместо использования стандартной кнопки отправки Submit, вы создаете свою собственную кнопку, для которой разрабатываете процедуру-обработчик события ondick. Эта процедура контролирует правильность введенных данных. Затем, если данные в форме правильны, вы используете метод submit формы для отправки данных на сервер. В листинге 29.1 приведен исходный код.