элемент <fieldset> в HTML-формах (Node, Element, FormControl)
Объект
FieldSet
представляет элемент
<fieldset>
в HTML-формах
<form>.
Объекты
FieldSet
реализуют многие, но не все свойства и методы интерфейса
FormControl
.
Свойства
boolean disabled
Значение true, если объект
FieldSet
находится в неактивном состоянии. Деактивация элемента
FieldSet
деактивирует содержащиеся в нем элементы форм.
readonly HTMLFormControlsCollection elements
Объект, подобный массиву, содержащий все элементы форм, имеющиеся внутри тега
<fieldset>.
File
файл в локальной файловой системе (Blob)
Тип
File
является подтипом
Blob
. Объект
File
имеет имя и, возможно, дату последнего изменения. Он представляет файл в локальной файловой системе. Получить выбранный пользователем файл можно из массива
files
элемента
<input type=file>
или из массива
files
объекта DataTransfer, связанного с объектом
Event
, который получает обработчик события «drop».
Имеется также возможность получить объекты
File
, представляющие файлы в закрытой, изолированной файловой системе, как описано в разделе 22.7. Однако на момент написания этих строк прикладной интерфейс доступа к файловой системе оставался нестабильным, поэтому он не описывается в этом справочнике.
Содержимое файла можно выгрузить на сервер с помощью объекта
FormData
или передав объект
File
методу
XMLHttpRequest.send,
однако непосредственно с объектом File можно выполнить не очень много операций. Чтобы прочитать содержимое файла, следует использовать объект
FileReader
(или любой объект
Blob
).
Свойства
readonly Date lastModifiedDate
Дата последнего изменения файла или null, если эта информация недоступна.
readonly string name
Имя файла (без пути к нему).
FileError
ошибка, возникшая во время чтения файла
Объект
FileError
представляет ошибку, возникшую при чтении файла с помощью объекта
FileReader
или
FileReaderSync
. Если использовался синхронный прикладной интерфейс, возбуждается непосредственно объект
FileError
. При использовании асинхронного прикладного интерфейса объект
FileError
передается обработчику в виде значения свойства
error
объекта
FileReader
.
Обратите внимание, что прикладной интерфейс объекта
FileWriter
(который описывается в разделе 22.7, но пока остается недостаточно стабильным, чтобы его можно было описать в этом справочнике) добавляет в этот объект новые константы с кодами ошибок.
Константы
Ниже перечислены коды ошибок в объекте
FileError
:
unsigned short N0T_F0UND_ERR = 1
Файл не существует. (Возможно, был удален после того, как пользователь выбрал его, но перед тем, как программа попыталась прочитать его.)
unsigned short SECURITY_ERR = 2
Неопределенная проблема, связанная с безопасностью, вынуждающая броузер запретить вашей программе читать файл,
unsigned short AB0RT_ERR = З
Операция чтения файла была прервана.
unsigned short NOT_READABLE_ERR = 4
Файл недоступен для чтения, возможно, потому что изменились права доступа к нему или другой процесс заблокировал файл.
unsigned short ENCODING_ERR = 5
Вызов
readAsDatallRL
потерпел неудачу, потому что файл оказался слишком длинным, чтобы представить его в виде URL-адреса data://.
Свойства
readonly unsigned short code
Это свойство определяет тип возникшей ошибки. Это свойство получает значение одной из констант, перечисленных выше.
FileReader
асинхронный интерфейс чтения объекта File или Blob (EventTarget)
Объект
FileReader
определяет асинхронный прикладной интерфейс чтения содержимого объекта
File
или любого объекта
Blob
. Чтобы прочитать файл, следует выполнить следующие действия: