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

FileUpload

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

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

Реализован в

JavaScript 1.0

JavaScript 1.1: добавлено свойство type.

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

Создание

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

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

Описание

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

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

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

Свойство	Описание
`form`	Специфицирует форму, содержащую объект `FileUpload`.
`name`	Отражает атрибут `NAME`.
`type`	Отражает атрибут `TYPE`.
`value`	Отражает текущее значение поля элемента загрузки файла; соответствует имени загружаемого файла.

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

Метод	Описание
`blur`	Убирает фокус с объекта.
`focus`	Передаёт фокус объекту.
`handleEvent`	Вызывает обработчик для специфицированного события.
`select`	Выбирает область ввода поля загрузки файла.

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

Пример

Здесь объект FileUpload помещается на форме и предоставляются две кнопки, которые дают возможность отобразить текущие значения свойств name и value.

<FORM NAME="form1">
File to send: <INPUT TYPE="file"
NAME="myUploadObject">
<P>Get properties<BR>
<INPUT TYPE="button" VALUE="name"

   onClick="alert('name: ' + document.form1.myUploadObject.name)">

<INPUT TYPE="button" VALUE="value"
   onClick="alert('value: '
+ document.form1.myUploadObject.value)"><BR>
</FORM>

См. также

Text

blur

Убирает фокус с объекта.

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

Синтаксис

blur()

Параметры

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

См. также

FileUpload.focus, FileUpload.select

focus

Переходит к полю FileUpload и передаёт ему фокус.

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

Синтаксис

focus()

Параметры

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

См. также

FileUpload.blur, FileUpload.select

form

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

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

Описание

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

handleEvent

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

Синтаксис

handleEvent(event)

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

Параметры

event

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

Описание

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

name

Строка - имя объекта.

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

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

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

Описание

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

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

select

Выделяет область ввода поля загрузки файла.

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

Синтаксис

select()

Параметры

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

Описание

Используйте метод select для выделения области ввода поля загрузки файла. Вы можете использовать метод select с методом focus для выделения поля и позиционирования курсора и замены всего текста поля.

См. также

FileUpload.blur, FileUpload.focus

type

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

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

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

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

Установка экземпляра загрузки файла требует привилегии UniversalFileRead. О безопасности см. книгу Клиентский JavaScript. Руководство.

Описание

Используйте свойство value для получения имени файла, которое пользователь печатает в объекте FileUpload.

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

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