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

FileUpload

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

Создание

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

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

• onBlur
• onChange
• onFocus

Описание

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

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

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

form

name

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>

См. также

blur

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

Синтаксис

blur()

Параметры

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

См. также

focus

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

Синтаксис

focus()

Параметры

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

См. также

form

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

Описание

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

handleEvent

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

Синтаксис

handleEvent(event)

Параметры

event

Описание

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

name

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

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

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

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

Синтаксис

select()

Параметры

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

Описание

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

См. также

type

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

Примеры

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

for (var i = 0; i < document.form1.elements.length; i++) {

   document.writeln("<BR>type is " + document.form1.elements[i].type)
}

value

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

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

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

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

Описание

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

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

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