Тег embed (от английского embed, «встроить») подключает к странице внешний файл: картинку, страницу, PDF, видео или звук. Это пустой тег без содержимого и без закрывающей части. Когда-то через него запускали Flash и другие плагины, а сегодня плагинов в браузерах нет, и embed остаётся коротким способом показать файл, который браузер открывает сам.
Дальше разобраны атрибуты, то, что открывает src, роль type, размер, использование для видео и звука, судьба плагинов в HTML5, работа из JavaScript, сравнение с object и iframe и причины, по которым файл не открывается. Другие теги группы собраны в шпаргалке по тегам.
<embed src="guide.pdf" type="application/pdf"
width="600" height="400" title="Руководство">
В этой статье
- Тег embed в HTML: что это и для чего нужен
- Атрибуты тега embed: src, type, width и height
- Атрибут src тега embed: что можно открыть
- Атрибут type тега embed: MIME-тип и поведение файла
- Размер тега embed: width, height и CSS
- Тег embed для видео и звука
- Тег embed в HTML5: плагины и Flash больше не работают
- Тег embed в JavaScript: load, error и getSVGDocument
- Тег embed, object или iframe: чем отличаются
- Почему тег embed не работает
Тег 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
У тега четыре основных атрибута, а остальное либо общее для всех тегов, либо устарело.
<embed src="map.svg" type="image/svg+xml"
width="400" height="300" title="Схема проезда">
| Атрибут | Что делает | Пример записи |
|---|---|---|
src | Адрес файла. Нужен, если нет type | <embed src="guide.pdf"> |
type | MIME-тип файла. Влияет на то, как браузер откроет его | <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 |
hspacevspace | Отступы вокруг тега по горизонтали и вертикали | 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, если он есть в браузере | 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.
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 и, при желании, размера.
<embed src="film.webm" type="video/webm"
width="480" height="270" title="Ролик">
Атрибутов controls, autoplay, loop, muted, poster и preload у embed нет, как нет и вложенных source для нескольких форматов и track для субтитров. Если браузер не умеет формат, запасного варианта не будет. Поэтому ролики на сайт обычно показывают тегом video, а звук тегом audio, а embed используют для случая, когда нужно просто показать файл.
<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 или обычный скрипт.
<!-- старая запись, больше не работает -->
<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.
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.
const svgDoc = document.querySelector("embed").getSVGDocument();
svgDoc.getElementById("r").setAttribute("fill", "#2E8B57");
Пример: тег embed в JavaScript и getSVGDocument
Страница и SVG с того же источника читаются из родителя, страница с адресом data: закрыта. Четвёртая кнопка перекрашивает прямоугольник в SVG через getSVGDocument.
Тег embed, object или iframe: чем отличаются
Три тега открывают внешние файлы, но различаются запасным содержимым, ограничениями и тем, как показывают картинку.
| Свойство | embed | object | iframe |
|---|---|---|---|
| Закрывающий тег | Не нужен | Нужен | Нужен |
| Адрес файла | src | data | src |
| Запасное содержимое | Нет | Есть: если файл не открылся, показан вложенный текст или тег | Нет: вложенное не показывается |
| Картинка | Как обычная, свой размер | Как обычная, свой размер | В окне, размер 304 на 154 с рамкой |
| Рамка по умолчанию | Нет | Нет | 2px inset |
Атрибут sandbox | Не действует | Не действует | Действует |
Атрибут referrerpolicy | Не действует | Не действует | Действует |
| Запрет встраивания заголовком сервера | Действует | Действует | Действует |
Значение Sec-Fetch-Dest у обращения | embed | object | iframe |
Выбор простой. Если нужны ограничения (sandbox), ленивая загрузка или управление разрешениями, берут iframe. Если нужно запасное содержимое на случай, когда файл не открылся, берут object: при неверном data показан вложенный текст, а при верном он скрыт. Если нужно просто и коротко показать файл, подходит embed.
Почему тег embed не работает
Если файл не открывается, причину ищут в трёх местах: в самом теге, в ответе сервера и в возможностях браузера.
| Причина | Что видно | Что делать |
|---|---|---|
Нет src и type | Тег занимает 0 на 0 | Записать src |
| Файла нет по адресу | Размер 0 на 0, событие error | Проверить адрес, открыть его отдельно |
Сервер отдал неверный Content-Type | PDF показан текстом или не показан совсем | Настроить правильный 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 |