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




Статья :: FileUpload
Оглавление | Назад | Вперёд | Индекс

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. Руководство.

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

Описание

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

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

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

FileUpload

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


Разделы
Околокомпьютерная литература (375)
Программирование (102)
Программы (75)
ОС и Сети (49)
Интернет (29)
Аппаратное обеспечение (16)
Базы данных (6)

Содержание сайта (выборка)
Apache
Протоколы TCP/IP (принципы, протоколы и архитектура)

PHP, PELR, JSP
PHP
JavaServer Pages (JSP)

Базы данных
Основы mysql
СУБД INFORMIX
СУБД POSTGRES
Основы проектирования реляционных баз данных

HTML, javascript
Спецификация HTML 4.01
Каскадные Таблицы Стилей, Уровень 2
Клиентский JavaScript. Справочник.
JavaScript руководство пользователя
Серверный JavaScript 1.4. Руководство по Использованию.

Паскаль, C, C++, C#
GCC (примеры)
FAQ Валентинa Озеровa DELPHI
C





 
©  programming-lang.com  справочник программиста