Тег embed в HTML: что это и какие у него атрибуты

Тег embed (от английского embed, «встроить») подключает к странице внешний файл: картинку, страницу, PDF, видео или звук. Это пустой тег без содержимого и без закрывающей части. Когда-то через него запускали Flash и другие плагины, а сегодня плагинов в браузерах нет, и embed остаётся коротким способом показать файл, который браузер открывает сам.

Дальше разобраны атрибуты, то, что открывает src, роль type, размер, использование для видео и звука, судьба плагинов в HTML5, работа из JavaScript, сравнение с object и iframe и причины, по которым файл не открывается. Другие теги группы собраны в шпаргалке по тегам.

HTML
<embed src="guide.pdf" type="application/pdf"
       width="600" height="400" title="Руководство">

Тег embed в HTML: что это и для чего нужен

Сначала о том, что embed делает на странице и почему им пользуются редко.

Тег embed резервирует на странице место и открывает в нём файл по адресу из src. Как именно файл будет показан, решает браузер: картинку он выводит как картинку, страницу и PDF открывает в окне внутри тега, видео и звук показывает во встроенном плеере. Отдельных атрибутов управления, как у video, у тега нет.

Запасного содержимого у embed нет: у него не бывает вложенных элементов. Запись <embed src="a.png">Текст</embed> даёт тег без детей, а слово «Текст» остаётся обычным текстом рядом с ним и видно всегда. Закрывающий тег </embed> браузер игнорирует. Без src и без type тег занимает 0 на 0 пикселей и не показывает ничего.

Пример: что открывает тег embed в HTML

Результат

Каждая кнопка создаёт embed с другим файлом. Строки показывают размер, появилось ли внутри окно и какое событие пришло. Для Flash браузер показывает заглушку.

Почему embed используют редко: для каждого вида файла есть более точный тег. Картинку лучше показывать через тег img, страницу — через тег iframe, ролик — через тег video, звук — через тег audio. embed удобен, когда нужен короткий способ открыть PDF или SVG, и ради этого он сохранён в стандарте.

Атрибуты тега embed: src, type, width и height

У тега четыре основных атрибута, а остальное либо общее для всех тегов, либо устарело.

HTML
<embed src="map.svg" type="image/svg+xml"
       width="400" height="300" title="Схема проезда">
АтрибутЧто делаетПример записи
srcАдрес файла. Нужен, если нет type<embed src="guide.pdf">
typeMIME-тип файла. Влияет на то, как браузер откроет его<embed type="application/pdf">
width, heightРазмер в пикселях. Без них документ получает 300 на 150, а картинка свой размер<embed width="600" height="400">
titleНазвание содержимого. MDN советует указывать его, чтобы читатель со скринридером понимал, что внутри<embed title="Руководство">
nameНазвание окна. Ссылка с target на это название открывает страницу внутри embed. По стандарту атрибут устарел, для такой задачи берут iframe<embed name="okno">
Общие атрибутыid, class, style, hidden и остальные работают как у любого тега<embed class="doc">

Атрибутов sandbox, allow и referrerpolicy, как у iframe, у embed нет. Записанные на нём, они ничего не меняют: страница внутри всё равно выполняет скрипты при sandbox="", а заголовок Referer уходит при referrerpolicy="no-referrer". Если нужны ограничения, берут iframe.

Устаревшие атрибуты остались от времён плагинов. Их встречают в старом коде:

АтрибутЧто делалЧем заменить
alignОбтекание и выравнивание рядом с текстомfloat или vertical-align
hspace, vspaceОтступы вокруг тега по горизонтали и вертикалиmargin: 8px;
pluginspageАдрес страницы, где скачать нужный плагинНичем, плагины больше не устанавливаются
hidden (в значении «скрыть плагин»)Прятал плагин, не отключая егоdisplay: none;, но файл тогда не загружается

Атрибут src тега embed: что можно открыть

Что именно покажет тег, зависит от файла по адресу src: у каждого вида свой размер и своё поведение.

Адрес в src записывают как у ссылки: полный с https:// или относительный. Файл открывается по-разному, и это видно по двум признакам: какой размер получил тег и появилось ли внутри отдельное окно со своим документом.

Файл в srcКак показанРазмер без CSSОкно внутри
Картинка PNG или JPEGКак обычная картинкаСвой, например 200 на 100Нет
SVGКак документ SVGСвой размер из файлаЕсть
Страница HTMLСтраница с прокруткой300 на 150Есть
Текстовый файлТекст в окне300 на 150Есть
PDFВстроенный просмотрщик PDF, если он есть в браузере300 на 150Есть
Видео, звукПлеер с панелью управления300 на 150Есть
Flash (.swf)Заглушка «плагин не поддерживается»300 на 150Нет
Файла нет по адресуНичего0 на 0Нет

Кнопки в примере выше показывают те же случаи на практике. Пустой размер 0 x 0 означает, что показывать нечего: файла нет, адрес неверный или не указано ни src, ни type. Если у тега display: none, файл вообще не загружается: сервер не получает обращения.

Файл с сервера открывается так, как его описывает ответ сервера. Поэтому за PDF, видео и звук отвечает правильный MIME-тип на сервере, об этом следующий раздел.

Атрибут type тега embed: MIME-тип и поведение файла

Атрибут type подсказывает браузеру вид файла, но решает не он один: ответ сервера тоже важен.

В type записывают MIME-тип, то есть пару «вид/подвид»: image/png, image/svg+xml, text/html, application/pdf, video/webm, audio/mpeg. Без type браузер определяет вид сам по содержимому и по ответу сервера. С type тег получает подсказку ещё до загрузки: картинка открывается как картинка, остальные виды как документ в окне.

ЗаписьЧто получилось
<embed src="a.png">Картинка 200 на 100, окна нет
<embed src="a.png" type="image/png">То же самое: тип совпал с файлом
<embed src="a.png" type="text/html">Картинка открыта как документ: окно 300 на 150, картинка в углу
<embed src="page.html" type="image/png">Страница не показана, пришло событие error
<embed type="image/png">Адреса нет, размер 0 на 0
<embed type="text/html">Адреса нет, но появилось пустое окно 300 на 150

Пример: атрибут type тега embed и открытие файла

Результат

Кнопки меняют type у одного и того же файла. Видно, что type=text/html превращает картинку в документ в окне, а type=image/png у страницы даёт ошибку.

Ответ сервера (заголовок Content-Type) важнее атрибута type, если файл отдан неправильно. PDF, отданный как text/plain, показан обычным текстом даже при type="application/pdf". PDF и страница, отданные как application/octet-stream, не показаны вовсе и события load нет. Страница, отданная как image/png, не показана: тег занимает 0 на 0 и приходит событие error. Картинка PNG, отданная как text/plain, всё равно показана как картинка. Поэтому для PDF, видео и звука на сервере должен стоять верный тип.

Размер тега embed: width, height и CSS

Размер задают атрибутами width и height или стилями, а у тега нет ни рамки, ни отступов по умолчанию.

Без размеров документ в embed получает 300 на 150 пикселей, а картинка остаётся своего размера. Атрибуты width="400" height="200" дают ровно 400 на 200. Проценты в атрибуте стандарт не описывает (в справочниках сказано о пикселях), но width="50%" работает и берёт половину ширины контейнера, поэтому надёжнее задавать процентные размеры в CSS. Рамки у тега нет: в отличие от iframe, у которого рамка по умолчанию 2px inset.

CSS
embed {
  display: block;
  width: 100%;
  max-width: 640px;
  aspect-ratio: 16 / 9;
}

Записанные одновременно width и height у картинки растягивают её без сохранения пропорций: картинка 200 на 100 в окне 300 на 200 растягивается и искажается. Свойство object-fit: cover у такой картинки срабатывает и обрезает её по рамке тега, хотя в справочнике MDN указано, что на embed оно не действует, поэтому полагаться на него не стоит. Как и iframe, тег строчный: под ним остаётся зазор в несколько пикселей, который убирает display: block. Рамку, заданную стилем, например border: 3px solid red, браузер прибавляет к размеру: получается окно 306 на 156 вместо 300 на 150.

Пример: размер и CSS тега embed

Результат

Кнопки задают размер атрибутами и стилями. Строки показывают итоговый размер и ширину контейнера. У картинки при width и height разных пропорций изображение растянуто, а object-fit обрезает его.

Тег embed для видео и звука

Для видео и звука embed показывает встроенный плеер, но без возможностей, которые есть у video и audio.

Файл видео или звука в embed открывается плеером в окне 300 на 150 с панелью управления. Это самый короткий способ показать ролик: достаточно src и, при желании, размера.

HTML
<embed src="film.webm" type="video/webm"
       width="480" height="270" title="Ролик">

Атрибутов controls, autoplay, loop, muted, poster и preload у embed нет, как нет и вложенных source для нескольких форматов и track для субтитров. Если браузер не умеет формат, запасного варианта не будет. Поэтому ролики на сайт обычно показывают тегом video, а звук тегом audio, а embed используют для случая, когда нужно просто показать файл.

HTML
<video controls width="480" poster="cover.jpg">
  <source src="film.webm" type="video/webm">
  <source src="film.mp4" type="video/mp4">
</video>

Тег embed в HTML5: плагины и Flash больше не работают

В HTML5 тег embed признан стандартным, но плагины, ради которых он был нужен, из браузеров ушли.

Раньше embed был нестандартным тегом, который придумали браузеры. Он запускал плагины: Flash, Java-апплеты, QuickTime. Спецификация HTML5 описывает его как точку подключения внешнего приложения или интерактивного содержимого. Поддерживается он всеми основными браузерами, по данным MDN с июля 2015 года.

Плагины сегодня не поддерживаются. Файл .swf в embed не запускается: тег занимает 300 на 150, браузер показывает заглушку, окна со страницей нет и события load не приходит. Старый код с Flash работать не будет, его заменяют на video, canvas или обычный скрипт.

HTML
<!-- старая запись, больше не работает -->
<embed src="intro.swf" type="application/x-shockwave-flash"
       width="400" height="300">

Старые руководства советуют вкладывать embed внутрь object, чтобы запасным путём сработал тот тег, который понимает браузер. Сегодня этот приём не нужен: object сам умеет запасное содержимое, а плагины не используются. Сравнение тегов дано ниже в отдельном разделе.

Тег embed в JavaScript: load, error и getSVGDocument

Из JavaScript у embed есть события load и error и метод getSVGDocument(), а свойств contentWindow и contentDocument нет.

Событие load приходит, когда файл загружен, а error при ошибке: нет файла по адресу или тип не подходит. Для Flash и для файла с типом application/octet-stream не приходит ни то ни другое. Событие load не гарантирует, что файл показан: страница, запрещённая для встраивания заголовком сервера, тоже вызывает load.

JavaScript
const doc = document.querySelector("embed");

doc.addEventListener("load", () => console.log("загружено"));
doc.addEventListener("error", () => console.log("ошибка"));

У iframe документ доступен через contentWindow и contentDocument, у embed таких свойств нет, а есть src, type, width, height, name, align и getSVGDocument(). Страница внутри embed доступна как окно под номером: window.frames[0]. Для страницы того же источника читается window.frames[0].document, для чужого браузер выдаёт SecurityError, как и у iframe. Сообщения postMessage из страницы внутри embed доходят до родителя.

Метод getSVGDocument() возвращает документ SVG, если файл с того же источника, и null, если источник чужой или файл не SVG. Через него можно менять картинку: в примере кнопка перекрашивает прямоугольник из SVG.

JavaScript
const svgDoc = document.querySelector("embed").getSVGDocument();

svgDoc.getElementById("r").setAttribute("fill", "#2E8B57");

Пример: тег embed в JavaScript и getSVGDocument

Результат

Страница и SVG с того же источника читаются из родителя, страница с адресом data: закрыта. Четвёртая кнопка перекрашивает прямоугольник в SVG через getSVGDocument.

Тег embed, object или iframe: чем отличаются

Три тега открывают внешние файлы, но различаются запасным содержимым, ограничениями и тем, как показывают картинку.

Свойствоembedobjectiframe
Закрывающий тегНе нуженНуженНужен
Адрес файлаsrcdatasrc
Запасное содержимоеНетЕсть: если файл не открылся, показан вложенный текст или тегНет: вложенное не показывается
КартинкаКак обычная, свой размерКак обычная, свой размерВ окне, размер 304 на 154 с рамкой
Рамка по умолчаниюНетНет2px inset
Атрибут sandboxНе действуетНе действуетДействует
Атрибут referrerpolicyНе действуетНе действуетДействует
Запрет встраивания заголовком сервераДействуетДействуетДействует
Значение Sec-Fetch-Dest у обращенияembedobjectiframe

Выбор простой. Если нужны ограничения (sandbox), ленивая загрузка или управление разрешениями, берут iframe. Если нужно запасное содержимое на случай, когда файл не открылся, берут object: при неверном data показан вложенный текст, а при верном он скрыт. Если нужно просто и коротко показать файл, подходит embed.

Почему тег embed не работает

Если файл не открывается, причину ищут в трёх местах: в самом теге, в ответе сервера и в возможностях браузера.

ПричинаЧто видноЧто делать
Нет src и typeТег занимает 0 на 0Записать src
Файла нет по адресуРазмер 0 на 0, событие errorПроверить адрес, открыть его отдельно
Сервер отдал неверный Content-TypePDF показан текстом или не показан совсемНастроить правильный MIME-тип на сервере
type не совпадает с файломСтраница с type="image/png" не показана, событие errorУбрать type или записать верный
Файл Flash или другой плагинЗаглушка, события load нетЗаменить на video, canvas или скрипт
Страница запретила встраиваниеПустое окно, но load приходитВзять официальный код для встраивания или дать ссылку
В браузере нет просмотрщика PDFОкно пустое, события load нет, файл с сервера не запрашиваетсяДобавить рядом ссылку на файл
У тега display: noneФайл не загружаетсяПоказать тег или не скрывать его стилем

Заголовки X-Frame-Options и frame-ancestors, запрещающие встраивание, действуют на embed так же, как на iframe: DENY закрывает страницу даже для своего сайта, SAMEORIGIN пускает только свой, а frame-ancestors со списком адресов пускает перечисленные. Подробнее об этом в статье про тег iframe.

Частые ошибки с тегом embed

Основные ошибки связаны с ожиданием запасного содержимого, неверным типом файла и надеждой на плагины.

ОшибкаЧто происходитКак исправить
</embed>Закрывающий тег не нужен, браузер его игнорируетЗаписать <embed src="a.pdf">
Текст внутри embedЗапасного содержимого у тега нет: слова «Нет PDF» видны всегда, рядом с файломДать ссылку на файл рядом или взять object
Нет width и heightНет размера: окно 300 на 150, читать PDF неудобноДобавить width и height
src="a.swf"Flash не запускается, видна заглушкаЗаменить на video или скрипт
type="image/png" у страницыТип не совпадает с файлом, пришла ошибкаУбрать type или записать text/html
sandbox=""Атрибут не действует, скрипты страницы выполняютсяВзять iframe с sandbox
embed.contentDocumentУ embed такого свойства нет, значение не определеноВзять window.frames[0] или getSVGDocument()
Ролик через embed с ожиданием controls и posterТаких атрибутов у тега нет, они ничего не делаютВзять тег video
Вывод «load пришёл, значит файл показан»Событие приходит и для страницы, запрещённой к встраиваниюПроверять результат глазами или через postMessage
Сервер отдаёт PDF как text/plainВместо просмотрщика виден текст файлаНастроить Content-Type: application/pdf
Категория
Поделиться в социальных сетях
Основные HTML-теги
Семантические теги HTML
Заголовки и абзацы
Теги для форматирования текста
Тег гиперссылки HTML
HTML-теги таблицы
Списки в HTML
Теги для форм
Мультимедиа и изображения
Интерактивные и служебные теги
Устаревшие HTML-теги

Отправить комментарий

0 Комментарии

Отправить комментарий (0)

#buttons=(Хорошо) #days=(20)

Мы используем файлы cookie для улучшения работы сайта. Подробнее
Хорошо
×