[Содержание] [Предыдущая] [Следующая] [Индекс]

Submit

Представляющая на рассмотрение кнопка в форме HTML. Представляющаяся на рассмотрение кнопка заставляет форму быть представленной на рассмотрение.

Объект client-side
Реализовано в Navigator 2.0
Navigator 3.0: добавлено свойство type; добвлены обработчики событий onBlur и onFocus; добавлены методы blur и focus
Navigator 4.0: добавлен метод handleEvent.

Создание

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

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

onBlur

onClick

onFocus

Защита

Navigator 4.0: Передача на рассмотрение формы как URL mailto: или news: требует привилегии UniversalSendMail. Для информации о защите в Navigator 4.0, смотрите Главу 7, "Защита JavaScript," в Руководстве по JavaScript.

Описание

Объект Submit в форме выглядит следующим образом:

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

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

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

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

form
Определяет форму, содержащую объект Submit.

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

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

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

Резюме Методов

blur
Удаляет фокус из представляющей на рассмотрение кнопки.

click
Эмулирует нажатие кнопки мыши на представляющей на рассмотрение кнопке.

focus
Дает фокус представляющей на рассмотрение кнопке.

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

Примеры

Следующий пример создает объект Submit с именем submitButton. Текст "Выполнить" отображается на поверхности кнопки.

<INPUT TYPE="submit" NAME="submitButton" VALUE="Выполнить">

Смотрите так же примеры для Form.

Смотрите также

Button, Form, Reset, Form.submit, onSubmit

Свойства

form

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

Свойство объекта Submit
Только для чтения
Реализовано в Navigator 2.0

Описание

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

Примеры

Следующий пример показывает форму с несколькими элементами. Когда пользователь нажимает button2, функция showElements показывает предупреждающее диалоговое окно, содержащее имена каждого элемента в форме myForm.

<SCRIPT>
function showElements(theForm) {
   str = "Элементы формы " + theForm.name + ": \n "
   for (i = 0; i < theForm.length; i++) 
      str += theForm.elements[i].name + "\n"
   alert(str)
}
</SCRIPT>
<FORM NAME="myForm">
Имя формы:<INPUT TYPE="text" NAME="text1" VALUE="Beluga">
<P>
<INPUT NAME="button1" TYPE="button" VALUE="Показать Имя Формы"
   onClick="this.form.text1.value=this.form.name">
<INPUT NAME="button2" TYPE="submit" VALUE="Показать Элементы Формы"
   onClick="showElements(this.form)">
</FORM>

Предупреждающее диалоговое окно показывает следующий текст:

Элементы формы myForm:
text1
button1
button2

Смотрите также

name

Строка, определяющая имя представляющей на рассмотрение кнопки.

Свойство объекта Submit
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита 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>")
   }
}

Смотрите также

type

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

Свойство объекта Submit
Только для чтения
Реализовано в Navigator 3.0

Примеры

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

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

value

Строка, которая отражает аттрибут VALUE представляющей на рассмотрение кнопки.

Свойство объекта Submit
Только для чтения
Реализовано в Navigator 2.0

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита 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 равно " +
      document.valueTest.submitButton.value + "<BR>")
   msgWindow.document.write("resetButton.value равно " +
      document.valueTest.resetButton.value + "<BR>")
   msgWindow.document.write("helpButton.value равно " +
      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">

Смотрите также

Методы

blur

Удаляет фокус из представляющей на рассмотрение кнопки.

Метод объекта Submit
Реализовано в Navigator 2.0

Синтаксис

blur()

Параметры

Смотрите также

click

Эмулирует нажатие кнопки мыши на представляющей на рассмотрение кнопке, но не вызывает обработчик события onClick объекта.

Метод объекта Submit
Реализовано в Navigator 2.0

Синтаксис

click()

Параметры

focus

Передает управление представляющей на рассмотрение кнопке и передает ей фокус.

Метод объекта Submit
Реализовано в Navigator 2.0

Синтаксис

focus()

Параметры

Смотрите также

handleEvent

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

Метод объекта Submit
Реализовано в Navigator 4.0

Синтаксис

handleEvent(event)

Параметры

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

Описание

Для информации об обработке событий, смотрите "Общая Информация о Событиях".

[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 12:32:12

Права © 1997 Netscape Communications Corporation

Все мессаги сюда:yanich@inbox.ru