diff --git a/files/ru/web/html/element/input/file/index.md b/files/ru/web/html/element/input/file/index.md index fc058f2caea779..6e39fedd17fefa 100644 --- a/files/ru/web/html/element/input/file/index.md +++ b/files/ru/web/html/element/input/file/index.md @@ -5,26 +5,15 @@ slug: Web/HTML/Element/input/file {{HTMLSidebar}} -{{HTMLElement("input")}} элемент с атрибутом **`type="file"`** позволяет пользователю выбрать один файл или более из файлового хранилища своего устройства. После выбора эти файлы могут быть загружены на сервер при помощи [формы](/ru/docs/Learn/HTML/Forms), или обработаны JavaScript и [File API](/ru/docs/Using_files_from_web_applications). +{{HTMLElement("input")}} элемент с атрибутом **`type="file"`** позволяет пользователю выбрать один файл или более из файлового хранилища своего устройства. После выбора эти файлы могут быть загружены на сервер при помощи [формы](/ru/docs/Learn/Forms), или обработаны JavaScript и [File API](/ru/docs/Web/API/File_API/Using_files_from_web_applications). -```html - -``` - -{{EmbedLiveSample('file-example', 650, 40)}} +{{EmbedInteractiveExample("pages/tabbed/input-file.html", "tabbed-shorter")}} -| **[Value](#value)** | {{domxref("DOMString")}} представляет собой путь до выбранного файла. | -| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **Действия** | {{event("change")}} и{{event("input")}} | -| **Поддерживаемые атрибуты** | [`accept`](/ru/docs/Web/HTML/Element/input#accept), [`multiple`](/ru/docs/Web/HTML/Element/input#multiple), [`required`](/ru/docs/Web/HTML/Element/input#required) | -| **IDL атрибуты** | `files` and `value` | -| **Методы** | {{domxref("HTMLInputElement.select", "select()")}} | +## Значение -## Value +Атрибут [`value`](/ru/docs/Web/HTML/Element/input#value) элемента `input` содержит строку, представляющую путь к выбранному файлу или файлам. Если пользователь выбрал несколько файлов, `value` представляет первый файл из списка. Остальные файлы можно определить используя [свойство `HTMLInputElement.files` элемента `input`](/ru/docs/Web/API/File_API/Using_files_from_web_applications#getting_information_about_selected_files). -Атрибут [`value`](/ru/docs/Web/HTML/Element/input#value) элемента input содержит {{domxref("DOMString")}}, который представляет путь к выбранным файлам. Если пользователь выбрал несколько файлов, `value` представляет первый файл из списка. Остальные файлы можно определить используя {{domxref("HTMLInputElement.files")}} свойство элемента input. - -> **Примечание:**1. Если выбрано несколько файлов, строка представляет собой первый выбранный файл. JavaScript предоставляет доступ к остальным файлам через свойство [`FileList`](). 2. Если не выбрано ни одного файла, .строка равна `""` (пустая). 3. Строка [начинается с `C:\fakepath\`](https://html.spec.whatwg.org/multipage/input.html#fakepath-srsly), для предотвращения определения файловой структуры пользователя вредоносным ПО. +> **Примечание:** Значение [всегда представляет собой имя файла, начинающееся с `C:\fakepath\`](https://html.spec.whatwg.org/multipage/input.html#fakepath-srsly) и не является настоящим расположением файла. Это сделано для того, чтобы вредоносное ПО не могло получить информацию о файловой структуре пользователя. ## Additional attributes @@ -57,7 +46,7 @@ div { This produces the following output: -{{EmbedLiveSample('A_basic_example', 650, 60)}} +{{EmbedLiveSample('A_basic_example', 650, 90)}} > **Примечание:** You can find this example on GitHub too — see the [source code](https://github.com/mdn/learning-area/blob/master/html/forms/file-examples/simple-file.html), and also [see it running live](https://mdn.github.io/learning-area/html/forms/file-examples/simple-file.html). @@ -69,7 +58,7 @@ When the form is submitted, each selected file's name will be added to URL param ### Getting information on selected files -The selected files' are returned by the element's {{domxref("HTMLElement.files", "files")}} property, which is a {{domxref("FileList")}} object containing a list of {{domxref("File")}} objects. The `FileList` behaves like an array, so you can check its `length` property to get the number of selected files. +The selected files' are returned by the element's `HTMLInputElement.files` property, which is a {{domxref("FileList")}} object containing a list of {{domxref("File")}} objects. The `FileList` behaves like an array, so you can check its `length` property to get the number of selected files. Each `File` object contains the following information: @@ -90,7 +79,7 @@ Each `File` object contains the following information: ### Limiting accepted file types -Often you won't want the user to be able to pick any arbitrary type of file; instead, you often want them to select files of a specific type or types. For example, if your file input lets users upload a profile picture, you probably want them to select web-compatible image formats, such as [JPEG](/ru/docs/Glossary/jpeg) or [PNG](/ru/docs/Glossary/PNG). +Often you won't want the user to be able to pick any arbitrary type of file; instead, you often want them to select files of a specific type or types. For example, if your file input lets users upload a profile picture, you probably want them to select web-compatible image formats, such as [JPEG](/ru/docs/Glossary/JPEG) or [PNG](/ru/docs/Glossary/PNG). Acceptable file types can be specified with the [`accept`](/ru/docs/Web/HTML/Element/input#accept) attribute, which takes a comma-separated list of allowed file extensions or MIME types. Some examples: @@ -125,7 +114,7 @@ div { This produces a similar-looking output to the previous example: -{{EmbedLiveSample('Limiting_accepted_file_types', 650, 60)}} +{{EmbedLiveSample('Limiting_accepted_file_types', 650, 90)}} > **Примечание:** You can find this example on GitHub too — see the [source code](https://github.com/mdn/learning-area/blob/master/html/forms/file-examples/file-with-accept.html), and also [see it running live](https://mdn.github.io/learning-area/html/forms/file-examples/file-with-accept.html). @@ -337,6 +326,49 @@ The example looks like this; have a play: {{EmbedLiveSample('Examples', '100%', 200)}} +## Техническое резюме + +
Значение | +Строка, содержащая путь к файлу | +
События | +{{domxref("HTMLElement/change_event", "change")}} и {{domxref("HTMLElement/input_event", "input")}} | +
Поддерживаемые общие атрибуты | +required |
+
Дополнительные атрибуты | +
+ accept ,
+ capture ,
+ multiple
+ |
+
IDL-атрибуты | +files и value |
+
DOM-интерфейс | +{{domxref("HTMLInputElement")}} | +
Методы | +{{domxref("HTMLInputElement.select", "select()")}} | +
Неявная ARIA-роль | +нет соответствующей роли |
+