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

Статья :: Reset

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

Reset

Копка восстановления данных по умолчанию элементов HTML-формы.

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

Реализован в

JavaScript 1.0

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

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

Создание

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

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

Описание

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

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

Обработчик onClick кнопки reset не может предотвратить восстановление данных формы; если кнопка нажата, восстановление не может быть отменено.

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

Свойство	Описание
`form`	Специфицирует форму, содержащую объект `Reset`.
`name`	Отражает атрибут `NAME`.
`type`	Отражает атрибут `TYPE`.
`value`	Отражает атрибут `VALUE`.

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

Метод	Описание
`blur`	Убирает фокус с кнопки reset.
`click`	Симулирует щелчок мыши по кнопке reset.
`focus`	Передаёт фокус кнопке reset.
`handleEvent`	Вызывает обработчик для специфицированного события.

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

Примеры

Пример 1. Здесь отображается Text-объект со значением по умолчанию "CA" и кнопка reset с текстом "Clear Form" на поверхности. Если пользователь печатает аббревиатуру штата в объекте Text и щёлкает кнопку Clear Form, восстанавливается оригинальное значение "CA".

<B>State: </B><INPUT TYPE="text" NAME="state" VALUE="CA" SIZE="2">
<P><INPUT TYPE="reset" VALUE="Clear Form">

Пример 2. Здесь имеются два объекта Text, объект Select и три радио-кнопки; все эти объекты имеют значения по умолчанию. На форме имеется также кнопка reset с текстом "Defaults" на ней. Если пользователь изменяет значение любого из этих объектов и щёлкает кнопку Defaults, восстанавливаются начальные значения.

<HTML>
<HEAD>
<TITLE>Reset object example</TITLE>
</HEAD>
<BODY>
<FORM NAME="form1">
<BR><B>City: </B><INPUT TYPE="text" NAME="city" VALUE="Santa Cruz" SIZE="20">
<B>State: </B><INPUT TYPE="text" NAME="state" VALUE="CA" SIZE="2">
<P><SELECT NAME="colorChoice">
   <OPTION SELECTED> Blue
   <OPTION> Yellow
   <OPTION> Green
   <OPTION> Red
</SELECT>

<P><INPUT TYPE="radio" NAME="musicChoice" VALUE="soul-and-r&b"
   CHECKED> Soul and R&B
<BR><INPUT TYPE="radio" NAME="musicChoice" VALUE="jazz">
   Jazz
<BR><INPUT TYPE="radio" NAME="musicChoice" VALUE="classical">
   Classical
<P><INPUT TYPE="reset" VALUE="Defaults" NAME="reset1">
</FORM>
</BODY>
</HTML>

См. также

Button, Form, onReset, Form.reset, Submit

blur

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

Метод из	`Reset`
Реализован в	JavaScript 1.0

Синтаксис

blur()

Параметры

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

Примеры

Здесь убирается фокус с reset-кнопки userReset:

userReset.blur()

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

<INPUT TYPE="reset" NAME="userReset">

См. также

Reset.focus

click

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

Метод из	`Reset`
Реализован в	JavaScript 1.0

Синтаксис

click()

Параметры

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

focus

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

Метод из	`Reset`
Реализован в	JavaScript 1.0

Синтаксис

focus()

Параметры

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

См. также

Reset.blur

form

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

Свойство из	`Reset`
Только для чтения
Реализовано в	JavaScript 1.0

Описание

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

См. также

Form

handleEvent

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

Метод из	`Reset`
Реализован в	JavaScript 1.2

Синтаксис

handleEvent(event)

Параметр

event

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

name

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

Свойство из	`Reset`
Реализовано в	JavaScript 1.0

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

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

Описание

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

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

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

См. также

Reset.value

type

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

Свойство из	`Reset`
Только для чтения
Реализовано в	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 кнопки reset.

Свойство из	`Reset`
Только для чтения
Реализовано в	JavaScript 1.0

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

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

Описание

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

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

См. также

Reset.name

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

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

Reset
страницы в данном разделе
> 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	>