fileUpload NN 3   IE 4   DOM 1

Объект fileUpload - элемент формы, сгенерированный элементом INPUT, чей атрибут TYPE установлен на "file". "fileUpload" обычно не используется в сценариях. Без сервера, принимающего файл, элемент не производит никаких действий. кроме того, для элемента form должны быть установлены следующие атрибуты:

METHOD=POST ENCTYPE="multipart/form-data"

Общие свойства, методы и обработчики событий перечислены в разделе "Все злементы HTML"

 
Эквивалент HTML

<INPUT TYPE="file">

 
Объектно-ориентированная модель
NN [window.]document.formName.elementName
[window.]document.forms[i].elements[i]
IE [window.]document.formName.elementName
[window.]document.forms[i].elements[i]
[window.]document.all.elementID
NN 6/IE5+ [window.]document.getElementById("elementID")

Свойства:


accessKey NN n/a  IE 4   DOM 1
  Чтение/Изменение
 

Клавиша, которая передаёт фокус объекту с клавиатуры. Броузер и операционная система определяют, должен ли пользователь нажать клавишу-модификатор (например, Ctrl, Alt, или Command(Mac)) с клавишей активации, чтобы "нажать" элемент. В IE 4/Windows требуется клавиша Alt и клавиша, не чувствительная к регистру. Не работает в IE 4/Mac.

 
Пример:

document.entryForm.myFileUpload.accessKey = "n"

 
Возвращаемое значение:
Отдельный алфавитно-цифровой или пунктуационный символ клавиатуры.
 
Значение по умолчанию: Ничего.

defaultValue NN 2   IE 3   DOM 1
  Только чтение
 

Заданный по умолчанию текст для элемента, как установлено атрибутом VALUE.

 
 
 
Возвращаемое значение:
Любое строковое значение.
 
Значение по умолчанию: Ничего.

disabled NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

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

 
Пример:

document.forms[0].myFileUpload.disabled = true

 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

form NN 3   IE 4   DOM n/a
 Только чтение
 

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

 
Пример:

<INPUT TYPE="file" VALUE="Send File" onClick="doValidate(this.form)">

 
Возвращаемое значение:
Ссылка на объект.
 
Значение по умолчанию: Ничего.

name NN 2   IE 3   DOM 1
 Чтение/Изменение
 

Идентификатор, связанный с именем элемента формы. Значение этого свойства представлено как половина пары "имя/значение", когда форма отправлена на сервер. Имена скрыты от пользователя, так как метки элементов управления назначены через другие средства в зависимости от типа последних. Имена элементов формы могут также использоваться ссылками сценария на объекты.

 
Пример:

document.orderForm.myCheckbox.name = "Win32"

 
Возвращаемое значение:
Чувствительный к регистру идентификатор, который подчиняется правилам именования: не может содержать никаких пробелов, не может начинаться с цифры и не должен содержать пунктуационных символов кроме символа подчеркивания.
 
Значение по умолчанию: Ничего.

readOnly NN 6  IE 4   DOM n/a
  Только чтение
 

Может ли элемент формы быть отредактирован пользователем на странице. Элемент формы, чьё свойство readOnly true, все еще может изменяться сценариями, даже при том, что пользователь не может изменять содержание.

 
 
 
Возвращаемое значение:
Булево значение: true | false.
 
Значение по умолчанию: false

size NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Грубо говоря, ширина в символах изменяемой части поля text элемента fileUpload. Практически, браузер не всегда точно предсказывает надлежащую ширину, когда используемый шрифт - пропорциональный. Нет никакого взаимодействия между свойствами size и maxLength для этого объекта. Это свойство не доступно для IE 4 на Macintosh

 
Пример:

document.forms[0].myFileUpload.size = 20

 
Возвращаемое значение:
Положительное целое число.
 
Значение по умолчанию: 20

tabIndex NN n/a  IE 4   DOM 1
 Чтение/Изменение
 

Номер, который указывает последовательность этого элемента в пределах порядка размещения всех форматируемых элементов в документе. Порядок форматирования строго подчиняется набору правил. Элементы, которые имеют отличные от нуля значения свойства tabIndex, находятся первые в строке, когда пользователь начинает форматирование страницы. Отсчёт начинается с элемента с самым низким значением tabIndex и заканчивается самым высоким значением, независимо от физического местоположения объекта на странице или в документе. Если два элемента имеют одни и те же значения tabIndex, элемент, который загружается в документ раньше , получает фокус первым. Затем идут все элементы что, или не поддерживающие свойство tabIndex , или имеющие нулевое значение. Эти элементы получают фокус в том порядке, в котором они загружаются в документ. Значение -1 ,в целом, удаляет элемент из порядка форматирования.

Обратите внимание, что интерфейс Macintosh не обеспечивает предоставление фокуса элементам, отличным от text и password поля INPUT.

 
Пример:

document.forms[0].myFileUpload.tabIndex = 6

 
Возвращаемое значение:
Целое число.
 
Значение по умолчанию: Ничего.

type NN 3   IE 4   DOM 1
 Только чтение
 

Возвращает тип элемента формы. Значение возвращается в символах нижнего регистра. Может быть необходимо циклически перебрать все элементы формы в поиске определенных типов, чтобы сделать некоторую обработку (например, освобождение всех элементов управления формы "text" при оставлении других элементов нетронутыми).

 
Пример:

if (document.forms[0].elements[3].type == "text") { ... }

 
Возвращаемое значение:
Любая из следующих констант (как строка): button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.
 
Значение по умолчанию: file

value NN 2   IE 3   DOM 1
 Только чтение
 

Текущее значение, связанное с элементом формы, который представлен парой "имя/значение" для элемента. Для объекта fileUpload, это значение - полный URL к местному файлу. Это истинно даже для версий браузеров Macintosh, которые имеют тенденцию отображать только имя файла.

 
Возвращаемое значение: Строка.
 
Значение по умолчанию: Ничего.

Методы:


blur( ) NN n/a  IE 4   DOM n/a

Удаляет фокус из текущего элемента и обрабатывает событие onBlur (в IE). Никакой другой элемент в результате не получает фокус (обязательно).

 
Возвращаемое значение
None.
 
Параметры
None.

focus( ) NN n/a  IE 4   DOM n/a

Дает фокус текущему элементу и обрабатывает событие onFocus (в IE). Если другой элемент имел фокус в то время, он получает событие onBlur.

 
Возвращаемое значение
None.
 
Параметры
None.

handleEvent( ) NN 4   IE n/a  DOM n/a

handleEvent(event)

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

 
Возвращаемое значение
None.
 
Параметры
event Объекты событий Navigator 4

select() NN 3   IE 4   DOM n/a

Выбирает весь текст, отображенный в элементе формы.

 
Возвращаемое значение
None.
 
Параметры
None.

Определённые обработчики событий:




HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека