re:re:actable
Урок 061 минута чтения

Как добавить в форму загрузку картинки в HTML?

На этой странице
Кратко

Для загрузки картинки в HTML используют <input type="file">. Если файл отправляется обычной HTML-формой, у формы должен быть method="post" и enctype="multipart/form-data".

Вопрос

Как добавить в форму загрузку файла или картинки? Как показать превью перед отправкой?

Главное

<form action="/upload" method="post" enctype="multipart/form-data">
  <label for="avatar">Фото профиля</label>
  <input id="avatar" name="avatar" type="file" accept="image/*">
 
  <button type="submit">Загрузить</button>
</form>

accept="image/*" подсказывает браузеру, что нужны изображения.

Почему нужен enctype

Файлы нельзя отправить как обычные текстовые поля. Для этого используется multipart/form-data.

enctype="multipart/form-data"

Без него сервер может не получить файл корректно.

Ограничение типов файлов

<input type="file" accept=".png,.jpg,.jpeg,image/webp">

accept помогает пользователю выбрать подходящий файл, но не является защитой. Сервер все равно должен проверить тип и размер файла.

Несколько файлов

<input type="file" name="photos" accept="image/*" multiple>

multiple позволяет выбрать несколько изображений.

Получение файла в JavaScript

const input = document.querySelector('input[type="file"]');
 
input.addEventListener("change", () => {
  const file = input.files[0];
  console.log(file.name, file.type, file.size);
});

Что важно помнить

  • Превью делают через URL.createObjectURL(file); после использования освобождайте память URL.revokeObjectURL.
  • capture="environment" на мобильных открывает камеру напрямую.
  • При отправке через fetch передавайте FormData и не задавайте Content-Type вручную.
  • Большие файлы загружают напрямую в объектное хранилище по presigned URL, минуя свой сервер.
  • Нативный input file плохо стилизуется — его прячут визуально и стилизуют связанный label.

Мини-шпаргалка

  • Для файла используют input type="file".
  • Для картинки добавляют accept="image/*".
  • Для обычной отправки формы нужен enctype="multipart/form-data".
  • multiple разрешает несколько файлов.
  • Клиентские ограничения не заменяют серверную проверку.

Документация

MDN: input type="file", MDN: Использование файлов в веб-приложениях.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам