Спецификация HTML 4.01, рекомендации W3C от 24 декабря 1999 года

18 Сценарии (скрипты)

18.1  Введение

   Скрипты, таким образом, позволяют авторам расширить возможности документов HTML, как активные, так и интерактивные. Например:

• Сценарии могут выполняться по мере загрузки документа для динамической модификации содержимого этого документа.
• Сценарии могут находиться в форме и обрабатывать ввод данных пользователем. Части формы могут динамически заполняться на основе значений других полей. Можно также проверять соответствие введенных данных значениям определенного диапазона, эти поля могут быть взаимосвязаны и т.д.
• Скрипты могу запускаться событиями, происходящими в документе: загрузка документа, выгрузка, передача фокуса элементу, движение мыши и т.д.
• Скрипты могут быть связаны с ЭУ (напр., кнопками) для создания графического интерфейса пользователя.

   Есть два вида скриптов, которые могут быть включены в документ HTML:

• выполняемые однократно при загрузке документа ПА. Скрипты внутри элемента SCRIPT выполняются при загрузке документа. Для ПА, которые не могут или "не хотят" выполнять скрипты, авторы могут включить альтернативное содержание с помощью элемента NOSCRIPT.
• выполняемые каждый раз при возникновении определенного события. Эти скрипты могут быть подключены к нескольким элементам с помощью атрибутов внутренних событий.

18.2 Дизайн документов для ПА, поддерживающих скрипты

   В следующем разделе обсуждаются вопросы, касающиеся ПА, поддерживающих скрипты.

18.2.1  Элемент SCRIPT

<!ELEMENT SCRIPT - - %Script; -- операторы скрипта -->
<!ATTliST SCRIPT
 charset %Charset; #ПРЕДПОЛАГАЕТСЯ -- набор символов связанного ресурса --
 type %ContentType; #НЕОБХОДИМ -- тип содержимого языка скрипта --
 src %URI; #ПРЕДПОЛАГАЕТСЯ -- URI внешнего скрипта --
 defer (defer) #ПРЕДПОЛАГАЕТСЯ -- ПА могут отложить исполнение скрипта --
 >

   Начальный тег: необходим, Конечный тег: необходим

   Элемент SCRIPT помещает скрипт в документ. Этот элемент может появляться любое число раз в HEAD и BODY документа HTML.

   Скрипт может быть определен внутри элемента SCRIPT или во внешнем файле. Если атрибут src не установлен, ПА должен интерпретировать содержимое элемента как скрипт. Если src имеет значение URI, ПА должен игнорировать содержимое элемента и затребовать скрипт по URI.
Обратите внимание, что атрибут charset относится к кодировке символов скрипта, обозначенного атрибутом src; он не касается содержимого элемента SCRIPT.

   Скрипты выполняются машиной скриптов, которая должна быть известна пользовательскому агенту.

   Синтаксис данных скрипта зависит от языка скриптов.

18.2.2  Установка языка скриптов

   Поскольку HTML не соотносится с определенным языком сценариев, авторы документа должны однозначно указать ПА язык каждого скрипта. Это можно сделать, объявив значение по умолчанию или локально.

Язык сценариев по умолчанию

   Авторы должны определить язык скриптов по умолчанию для всех скриптов в документе, включив следующее META объявление в HEAD:

<META http-equiv="Content-Script-Type" content="type">

   где "type"  - это content type/тип содержимого, называющий язык скриптов. Примеры - "text/tcl", "text/javascript", "text/vbscript".

   В отсутствие META объявления, значение по умолчанию может быть установлено заголовком "Content-Script-Type" HTTP:

 Content-Script-Type: type

   где "type" это опять же content type/тип содержимого, называющий язык скриптов.

   ПА должны определить язык скрипта по умолчанию в такой последовательности (приоритет от высшего к низшему):

1. Если есть какое-либо объявление META, определяющее "Content-Script-Type", последний определяет в потоке символов язык скриптов по умолчанию.
2. Иначе, если какой-либо заголовок HTTP определяет "Content-Script-Type", последний определяет в потоке символов язык скриптов по умолчанию.

   Документы, в которых язык скриптов по умолчанию не определен, и которые содержат элементы со скриптами внутренних событий, являются некорректными. ПА могут попытаться интерпретировать некорректно определенные скрипты, но это не обязательно. Авторские утилиты должны генерировать информацию о языке скриптов по умолчанию, чтобы помочь избежать создания некорректных документов.

Локальное объявление языка скриптов

   Атрибут type должен быть определен для каждого элемента SCRIPT в документе. Значение атрибута type элемента SCRIPT переопределяет язык скриптов по умолчанию для данного элемента.

<!DOCTYPE HTML PUBLIC "-//W3C//Dtd HTML 4.01//EN"
 "http://www.w3.org/tr/html4/strict.dtd">
<HTML>
<HEAD>
<TITLE>A document with SCRIPT</TITLE>
<META http-equiv="Content-Script-Type" content="text/tcl">
<SCRIPT type="text/vbscript" src="http://someplace.com/progs/vbcalc">
</SCRIPT>
</HEAD>
<BODY>
<SCRIPT type="text/javascript">
...сценарий JavaScript...
</SCRIPT>
</BODY>
</HTML>

Ссылки на элементы HTML из скрипта

   У каждого языка скриптов есть свой набор соглашений о том, как ссылаться на объекты HTML из скрипта. Эта спецификация не определяет стандартный механизм ссылки на объекты HTML.

   В то же время, скрипты должны ссылаться на элемент в соответствии с его установленным именем. Машины скриптов должны соблюдать правило старшинства при идентификации элемента: атрибут name имеет преимущество перед атрибутом id, если оба установлены. Иначе тот или другой могут быть использованы.

18.2.3  Внутренние события

   Можно ассоциировать действие с определенным количеством событий, возникающих при взаимодействии пользователя с ПА. Каждое из "внутренних событий", перечисленных выше, имеет значение - скрипт. Скрипт выполняется , как только возникает событие в данном элементе. Синтаксис данных скрипта зависит от языка скрипта.

   ЭУ, такие как INPUT, SELECT, BUTTON, TEXTAREA и LABEL, все откликаются на определенные внутренние события. Если эти элементы находятся вне формы, они могут использоваться для расширения возможностей пользовательского интерфейса документа.

   К примеру, авторы могут вставить в документ кнопку, которая не отправляет форму, а взаимодействует с сервером при активации.

   Следующие примеры показывают некоторые ЭУ и действия пользовательского интерфейса на базе внутренних событий.

<INPUT NAME="userName" onblur="validUserName(this.value)">

<INPUT NAME="num"
 onchange="if (!checkNum(this.value, 1, 10))
 {this.focus();this.select();} else {thanks()}"
 VALUE="0">

 <INPUT name="edit1" size="50"> 
 <SCRIPT type="text/vbscript">
 Sub edit1_changed()
 If edit1.value = "abc" Then
 button1.enabled = True
 Else
 button1.enabled = False
 End If
 End Sub
 </SCRIPT>

 <INPUT name="edit1" size="50">
 <SCRIPT type="text/tcl">
 proc edit1_changed {} {
 if {[edit value] == abc} {
 button1 enable 1
 } else {
 button1 enable 0
 }
 }
 edit1 onChange edit1_changed
 </SCRIPT>

<BUTTON type="button" name="mybutton" value="10">
<SCRIPT type="text/javascript">
 function my_onclick() {
 . . .
 }
 document.form.mybutton.onclick = my_onclick
 </SCRIPT>
 </BUTTON>

<SCRIPT type="text/javascript">
 function my_onload() {
 . . .
 }

 var win = window.open("some/other/URI")
 if (win) win.onload = my_onload
</SCRIPT>

 <SCRIPT type="text/tcl">
 proc my_onload {} {
 . . .
 }
 set win [window open "some/other/URI"]
 if {$win != ""} {
 $win onload my_onload
 }
 </SCRIPT>

18.2.4 Динамическое изменение документов

   Динамическая модификация документа может быть смоделирована так:

1. Все элементы SCRIPT выполняются в том порядке, как они загружаются.
2. Все конструкции скриптов в данном элементе SCRIPT, генерирующем SGML CDATA, выполняются. Их комбинированный сгенерированный текст вставляется в документ вместо элемента SCRIPT.
3. Сгенерированные CDATA выполняется заново.

   Документы HTML должны соответствовать Определению Типа Данных (ОТД) HTML и до, и после обработки элемента SCRIPT.

 <TITLE>Test Document</TITLE>
 <SCRIPT type="text/javascript">
 document.write("<p><b>Hello World!<\/b>")
 </SCRIPT>

 <TITLE>Test Document</TITLE>
 <p><B>Hello World!</B>

18.3   Дизайн документов для ПА, не поддерживающих сценарии

   В данном разделе рассматривается, как авторы могут создать документ, работающий с ПА, не поддерживающими скрипты.

18.3.1   Элемент NOSCRIPT

<!ELEMENT NOSCRIPT - - (%block;)+
 -- контейнер для альтернативного содержимого при отображении
 без использования скриптов -->
<!ATTliST NOSCRIPT
 %attrs; -- %coreattrs, %i18n, %events --
 >

   Начальный тег: необходим, Конечный тег: необходим

• ПА сконфигурирован так, чтобы не выполнять скрипты;
• ПА не поддерживает язык скриптов, ранее заявленный в элементе SCRIPT в этом документе.

   ПА, не поддерживающие скрипты на стороне клиента, обязаны выводить содержимое этого элемента.

<SCRIPT type="text/tcl">
 ...некоторый скрипт Tcl для вставки данных...
</SCRIPT>
<NOSCRIPT>
 <p>Перейдите на <A href="http://someplace.com/data">data.</A>
</NOSCRIPT>

18.3.2  Скрытие данных скрипта от ПА

   Есть вероятность того, что ПА, не распознающие элемент SCRIPT, будут рассматривать его содержимое как текст. Некоторые машины скриптов, в том числе для языков JavaScript, VBScript и Tcl, разрешают включение операторов скрипта в комментарий SGML. ПА, не распознающие элемент SCRIPT, будут тогда игнорировать комментарий, в то время как более совершенные машины скриптов "поймут", что скрипт внутри комментария должен выполняться.

   Другим решением проблемы является сохранение скриптов во внешнем документе и ссылка на него с помощью атрибута src.

<SCRIPT type="text/javascript">
<!-- прячет содержимое скрипта от старых браузеров
 function square(i) {
 document.write("Вызов передан функции", i "<BR>")
 return i * i
 }
 document.write("Функция возвратила ",square(5),".")
// конец скрытия содержимого от старых браузеров -->
</SCRIPT>

 <SCRIPT type="text/vbscript">
 <!--
 Sub foo()
 ...
 End Sub
 ' -->
 </SCRIPT>

<SCRIPT type="text/tcl">
<!-- прячет содержимое скрипта от старых браузеров
 proc square {i} {
 document write "Вызов передан функции $i.<BR>"
 return [expr $i * $i]
 }
 document write "Функция вернула [square 5]."
# конец скрытия содержимого от старых браузеров -->
</SCRIPT>