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

Button

Командная кнопка в форме HTML.

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

Создание

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

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

onBlur

onClick

onFocus

onMouseDown

onMouseUp

Описание

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

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

Объект Button это заказная кнопка, которую Вы можете использовать, чтобы выполнить действие, которое Вы определяете. Кнопка выполняет сценарий, определенный в обработчике события onClick.

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

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

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

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

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

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

blur
Удаляет фокус с кнопки.

click
Эмулирует нажатие кнопки мыши на кнопке.

focus
Дает фокус кнопке.

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

Примеры

Следующий пример создает кнопку с именем calcButton. Текст "Вычислить" отображается на поверхности кнопки. Когда кнопка нажата, вызывается функция calcFunction.

<INPUT TYPE="button" VALUE="Вычислить" NAME="calcButton"
   onClick="calcFunction(this.form)">

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

Form, Reset, Submit

Свойства

form

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

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

Описание

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

Примеры

Пример 1. В следующем примере, форма myForm содержит объект Text и кнопку. Когда пользователь нажимает кнопку, значение объекта Text установливается равным имени формы. Обработчик события onClick кнопки использует this.form, чтобы сослаться к родительской форме myForm.

<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">
</FORM>

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

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="button" VALUE="Показать Элементы Формы"
   onClick="showElements(this.form)">
</FORM>

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

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

Пример 3. Следующий пример использует объектную ссылку, скорее чем ключевое this, чтобы обратиться к форме. Код возвращает ссылку на объект myForm, который является формой, содержащей myButton.

document.myForm.myButton.form

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

name

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

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

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

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

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

Если несколько объектов в одной и той же форме имеют одинаковый аттрибут NAME, автоматически создается массив данного имени. Каждый элемент в массиве представляет индивидуальный объект Form. Элементы индексируются в исходном порядке, начиная с 0. Например, если два элемента Text и элемент Button в одной и той же форме имеют аттрибут 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>")
   }
}

В следующем примере, первое выражение создает окно с именем netscapeWin. Второе выражение показывает значение "netscapeHomePage" в диалоговом окне Alert, потому что "netscapeHomePage" это значение параметра windowName объекта netscapeWin.

netscapeWin=window.open("http://home.netscape.com","netscapeHomePage")

alert(netscapeWin.name)

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

type

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

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

Примеры

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

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

value

Строка, которая отражает аттрибут VALUE кнопки.

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

Защита

Navigator 3.0: Это свойство заражено по умолчанию. Для информации о заражении данных, смотрите "Защита JavaScript".

Описание

Эта строка отображается на поверхности кнопки.

Свойство value только для чтения для Macintosh и UNIX систем. В Windows, Вы можете изменять это свойство.

Когда аттрибут VALUE не определен в HTML, свойство value равно пустой строке.

Не путайте свойство 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

Удаляет фокус с кнопки.

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

Синтаксис

blur()

Параметры

Примеры

Удаляет фокус с кнопки userButton:

userButton.blur()

Этот пример принимает, что кнопка определена как

<INPUT TYPE="button" NAME="userButton">

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

click

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

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

Синтаксис

click()

Параметры

Защита

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

focus

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

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

Синтаксис

focus()

Параметры

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

handleEvent

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

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

Синтаксис

handleEvent(event)

Параметры

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

Описание

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

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

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

Права © 1997 Netscape Communications Corporation

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