На главную страницу
Форум txt.version   




Статья :: Submit
Оглавление | Назад | Вперёд | Индекс

Submit

Кнопка submit на HTML-форме. Кнопка submit отправляет форму на сервер.

Клиентский объект

Реализован в

JavaScript 1.0

JavaScript 1.1: добавлено свойство type; добавлены обработчики onBlur и onFocus; добавлены методы blur и focus.

JavaScript 1.2: добавлен метод handleEvent.

Создание

HTML-тэгом INPUT с "submit" в качестве значения атрибута TYPE. Для данной формы машина выполнения JavaScript создаёт соответствующий объект Submit и помещает его в массив elements соответствующего объекта Form. Вы получаете доступ к к объекту Submit по индексу в этом массиве. Можно индексировать массив цифрами или, если имеются, по значениям атрибута NAME.

Обработчики событий

Безопасность

Отправка формы по URL mailto: или news: требует привилегии UniversalSendMail. О безопасности см. книгу Клиентский JavaScript. Руководство.

Описание

Объект Submit на форме выглядит так:

Объект Submit является элементом формы и обязан быть определён в тэге FORM.

Щелчок по кнопке submit отправляет форму по URL, специфицированному в свойстве action формы. Эта акция всегда загружает клиенту новую страницу; это может быть та же страница, что и текущая, если action это специфицирует или если не специфицирует.

Обработчик onClick кнопки submit не может предотвратить отправку формы; используйте вместо этого обработчика обработчик onSubmit или метод submit вместо объекта Submit. См. примеры для объекта Form.

Свойства. Резюме.

Свойство Описание
form

Специфицирует форму, содержащую Submit-объект.

name

Отражает атрибут NAME.

type

Отражает атрибут TYPE.

value

Отражает атрибут VALUE.

Методы. Резюме.

Метод Описание
blur

Убирает фокус с кнопки submit.

click

Симулирует щелчок мыши по кнопке submit.

focus

Передаёт фокус кнопке submit.

handleEvent

Вызывает обработчик для специфицированного события.

Кроме того, этот объект наследует методы watch и unwatch из объекта Object.

Пример

Создаётся объект Submit по имени submitButton. Текст "Done" отображается на поверхности кнопки.

<INPUT TYPE="submit" NAME="submitButton" VALUE="Done">

См. примеры для Form.

См. также

Button, Form, Reset, Form.submit, onSubmit

blur


Убирает фокус с кнопки submit.

Метод из

Submit

Реализован в

JavaScript 1.0

Синтаксис

blur()

Параметры

Отсутствуют.

См. также

Submit.focus

click


Симулирует щелчок мыши по кнопке submit, но не запускает обработчик onClick объекта.

Метод из

Submit

Реализован в

JavaScript 1.0

Синтаксис

click()

Параметры

Отсутствуют.

focus


Переходит к кнопке submit и передаёт ей фокус.

Метод из

Submit

Реализован в

JavaScript 1.0

Синтаксис

focus()

Параметры

Отсутствуют.

См. также

Submit.blur

form


Ссылка объекта, специфицирующая форму, содержащую кнопку submit.

Свойство из

Submit

Только для чтения

Реализовано в

JavaScript 1.0

Описание

Каждый элемент формы имеет свойство form которое является ссылкой на родительскую форму элемента. Это свойство используется в основном с обработчиками событий, где может понадобиться обратиться к другому элементу текущей формы.

Пример

В этом примере показана форма с несколькими элементами. Если пользователь щёлкает на кнопке button2, функция showElements выводит alert-диалог с именами всех элементов формы myForm.

<SCRIPT>
function showElements(theForm) {
   str = "Form Elements of form " + theForm.name + ": \n "
   for (i = 0; i < theForm.length; i++)
      str += theForm.elements[i].name + "\n"
   alert(str)
}
</SCRIPT>
<FORM NAME="myForm">
Form name:<INPUT TYPE="text" NAME="text1" VALUE="Beluga">
<P>
<INPUT NAME="button1" TYPE="button" VALUE="Show Form Name"
   onClick="this.form.text1.value=this.form.name">
<INPUT NAME="button2" TYPE="submit" VALUE="Show Form Elements"
   onClick="showElements(this.form)">
</FORM>

Диалог alert выведет следующий текст:

Form Elements of form myForm:
text1
button1
button2

См. также

Form

handleEvent


Вызывает обработчик для специфицированного события.

Метод из

Submit

Реализован в

JavaScript 1.2

Синтаксис

handleEvent(event)

Параметр

event

Имя события, для которого специфицированный объект имеет обработчик.

Описание

Об обработке событий см. книгу Клиентский JavaScript. Руководство.

name


Строка, специфицирующая имя submit-кнопки.

Свойство из

Submit

Реализовано в

JavaScript 1.0

Безопасность

JavaScript 1.1. Это свойство разрушено по умолчанию. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Свойство name первоначально отражает значение атрибута NAME. Изменение свойства name переопределяет значение атрибута.

Не путайте свойство name с текстом, отображаемым на поверхности Submit-кнопки. Свойство value специфицирует текст на кнопке. Свойство name не выводится на экран; оно используется для программного обращения к кнопке.

Если несколько объектов на одной форме имеют одинаковые значения атрибута NAME, автоматически создаётся массив с данным именем. Каждый элемент этого массива представляет отдельный Form-объект. Элементы индексируются в порядке расположения в исходном коде, начиная с 0. Например, если два элемента Text и элемент Submit на одной форме имеют в своих атрибутах NAME значение "myField", создаётся массив из элементов myField[0], myField[1] и myField[2]. Вы должны знать о такой ситуации в Вашем коде и знать, ссылается ли myField на единственный элемент или на массив элементов.

Пример

Здесь функция valueGetter использует цикл for для итерации по массиву элементов формы valueTest. Окно msgWindow отображает имена всех элементов формы:

newWindow=window.open("http://home.netscape.com")
function valueGetter() {
   var msgWindow=window.open("")
   for (var i = 0; i < newWindow.document.valueTest.elements.length; i++) {
      msgWindow.document.write(newWindow.document.valueTest.elements[i].name + "<BR>")
   }
}

См. также

Submit.value

type


Для всех Submit-объектов значение свойства type будет "submit". Это свойство специфицирует тип элемента формы.

Свойство из

Submit

Только для чтения

Реализовано в

JavaScript 1.1

Пример

Записываются значения свойства type каждого элемента формы.

for (var i = 0; i < document.form1.elements.length; i++) {
   document.writeln("<BR>type is " + document.form1.elements[i].type)
}

value


Строка, отражающая значение атрибута VALUE кнопки submit.

Свойство из

Submit

Только для чтения

Реализовано в

JavaScript 1.0

Безопасность

JavaScript 1.1. Это свойство разрушено по умолчанию. О разрушении данных см. книгу Клиентский JavaScript. Руководство.

Описание

Если атрибут VALUE специфицируется в HTML, свойство value будет содержать эту же строку, и она будет отображаться на поверхности кнопки. Если атрибут VALUE не специфицируется в HTML, свойство value кнопки будет иметь значение "Submit Query".

Не путайте свойство value со свойством name. Свойство name не отображается на экране; оно используется для программного обращения к кнопке.

Пример

Следующая функция вычисляет свойство value группы кнопок и выводит его в окне msgWindow:

function valueGetter() {
   var msgWindow=window.open("")
   msgWindow.document.write("submitButton.value is " +
      document.valueTest.submitButton.value + "<BR>")
   msgWindow.document.write("resetButton.value is " +
      document.valueTest.resetButton.value + "<BR>")
   msgWindow.document.write("helpButton.value is " +
      document.valueTest.helpButton.value + "<BR>")
   msgWindow.document.close()
}

Будут выведены следующие значения:

Query Submit
Reset
Help

Предполагается, что кнопки были определены так:

<INPUT TYPE="submit" NAME="submitButton">
<INPUT TYPE="reset" NAME="resetButton">
<INPUT TYPE="button" NAME="helpButton" VALUE="Help">

См. также

Submit.name
Оглавление | Назад | Вперёд | Индекс

Дата последнего обновления: 28 мая 1999 года.
Copyright (c) 1999
Netscape Communications Corporation

Submit

страницы в данном разделе 
 ancor  applet
 area.htm  array
 Индекс  Boolean
 button  Checkbox
 Классы, Конструкторы и Методы Java  Значения Цветов
 Оглавление  Куки Netscape
 date.htm  document
 event  FileUpload
 form.htm  Frame
 Function  Обработчики Событий
 Hidden  History
 Image  Оглавление
 java.htm  JavaArray
 JavaClass  JavaObject
 JavaPackage  Приложение A. Зарезервированные Слова
 Layer  JSException
 JSObject  Plugin
 link.htm  Location
 math.htm  MimeType
 navigator  netscape
 Number  Object
 Объекты, Методы и Свойства  Операции
 Option  Packages
 Приложения  Справочник по Классам LiveConnect
 Элементы Языка  Объекты. Справочник.
 Password  Plugin
 Об Этой Книге  Radio
 RegExp  Reset
 screen  Select
 Операторы  String
 Style  Submit
 sun.htm  text.htm
 Textarea  toc.htm
 Свойства и Функции Верхнего Уровня  Новые Возможности в Этой Версии
 window   


Разделы
Околокомпьютерная литература (375)
Программирование (102)
Программы (75)
ОС и Сети (49)
Интернет (29)
Аппаратное обеспечение (16)
Базы данных (6)

Содержание сайта (выборка)
Apache
Протоколы TCP/IP (принципы, протоколы и архитектура)

PHP, PELR, JSP
PHP
JavaServer Pages (JSP)

Базы данных
Основы mysql
СУБД INFORMIX
СУБД POSTGRES
Основы проектирования реляционных баз данных

HTML, javascript
Спецификация HTML 4.01
Каскадные Таблицы Стилей, Уровень 2
Клиентский JavaScript. Справочник.
JavaScript руководство пользователя
Серверный JavaScript 1.4. Руководство по Использованию.

Паскаль, C, C++, C#
GCC (примеры)
FAQ Валентинa Озеровa DELPHI
C





 
©  programming-lang.com  справочник программиста