В этом документе перечислены атрибуты тегов OBJECT и EMBED, используемые для публикации содержимого SWF (с поддержкой возможностей Flash) на HTML-страницах для просмотра в веб-браузерах. Атрибуты позволяют задавать определенные параметры, которые определяют, как и где во Flash Player отображается файл SWF в браузере.

Информация о добавлении содержимого Flash (SWF-файла) на веб-страницы также доступна в технической заметке Синтаксис тега OBJECT | Flash (tn_4150).

Требуемые атрибуты

Следующие атрибуты внутри тегов OBJECT и EMBED требуются при добавлении файла SWF на HTML-страницу. При использовании команды «Опубликовать» в проигрывателе Flash Professional создаются файлы HTML с указанными требуемыми атрибутами. 

Примечание. Значения в скобках и курсивом указывают на то, что значение выбирается разработчиком.

Требуется и для OBJECT, и для EMBED:

  • width — определяет ширину содержимого SWF в пикселях или в виде процентного значения для окна браузера.
  • height — определяет высоту содержимого SWF в пикселях или в виде процентного значения для окна браузера.

Требуется только для тега OBJECT:

  • classid — определяет элемент управления ActiveX для браузера. Пример правильного значения кода приведен в разделе Синтаксис тега OBJECT | Flash (tn_4150).
  • codebase — указывает местоположение элемента управления ActiveX проигрывателя Flash Player, благодаря чему браузер может автоматически загрузить его, если этот элемент управления не установлен на компьютере. Пример правильного значения кода приведен в разделе Синтаксис тега OBJECT | Flash (tn_4150).
  • movie (param) — определяет исходное местоположение (URL) загружаемого файла SWF.

Требуется только для тега EMBED

  • src — определяет исходное местоположение (URL) загружаемого файла SWF.
  • pluginspage — указывает на местоположение внешнего модуля Flash Player, что позволяет пользователю автоматически загрузить его, если модуль не установлен.

Дополнительные атрибуты

При определении тегов OBJECT и EMBED следующие атрибуты являются необязательными. Для тега OBJECT все атрибуты определяются тегами param, если не указано иное:

  • id (атрибут для тега OBJECT) и name (атрибут для тега EMBED) — идентификатор файла SWF. Определяет файл SWF для веб-браузера, благодаря чему в браузере создается сценарий языка (например, JavaScript) для ссылки на содержимое SWF. Чтобы обеспечить совместимость с несколькими браузерами, убедитесь в том, что для параметров id и name установлено одно и то же значение.
  • play — возможные значения: true, false. Указывает на то, будет ли SWF-файл, находящийся на панели «Временная шкала», воспроизводиться немедленно при загрузке содержимого в браузере. Если этот атрибут не указан, то значение по умолчанию — true.
  • loop — возможные значения: true, false. Указывает на то, будет ли SWF-файл, находящийся на панели «Временная шкала», воспроизводиться непрерывно или воспроизведение остановится по достижении последнего кадра. Если этот атрибут не указан, то значение по умолчанию — true.
  • menu — возможные значения: true, false. Определяет, доступны ли элементы управления воспроизведением в контекстном меню Flash Player.
    • true — отображается полное меню с элементами расширенного управления воспроизведением (например, «Масштаб», «Качество», «Воспроизведение», «Цикл», «Перемотка», «Вперед», «Назад»).
    • false — отображается меню, в котором элементы управления воспроизведением (например, «Масштаб», «Качество», «Воспроизведение», «Цикл», «Перемотка», «Вперед», «Назад») скрыты. Данный атрибут можно использовать для SWF-содержимого, не зависящего от панели «Временная шкала», например содержимого, полностью контролируемого языком ActionScript. В коротком меню отображаются элементы «Настройки» и «О программе Flash Player».
  • quality — возможные значения: low, autolow, autohigh, medium, high, best. Определяет качество визуализации рабочей области в отображаемом списке. Если задать свойство Stage.quality с помощью ActionScript, это значение переопределяется.
    • low — поддерживает скорость воспроизведения за счет внешнего вида и не использует сглаживание.
    • autolow — поддерживает скорость, но по возможности улучшает внешний вид. Воспроизведение начинается с отключенным сглаживанием. Если Flash Player обнаружил, что процессор способен выполнять сглаживание, то оно будет включено автоматически.
    • autohigh — поддерживает в равной степени скорость и внешний вид, но при необходимости предпочтение отдается скорости воспроизведения. Воспроизведение начинается с включенным сглаживанием. Если действительная частота кадров падает ниже заданной, сглаживание отключается, чтобы повысить скорость воспроизведения. Используйте этот параметр, чтобы сымитировать настройку «Просмотр» > «Сглаживание» во Flash Professional.
    • medium — применяет некоторое сглаживание, но смягчает растровые изображения. Этот параметр дает качество выше, чем в режиме «Низкое», но ниже, чем в режиме «Высокое».
    • high — поддерживает внешний вид за счет скорости воспроизведения и всегда использует сглаживание. Если фильм не содержит анимации, то растровые изображения смягчаются. В противном случае растровые изображения не смягчаются.
    • best — обеспечивает самое высокое качество отображения, даже за счет скорости. Сглаживается весь вывод, и все растровые изображения смягчаются.
  • scale — возможные значения: showall, noborder, exactfit, noscale. Определяет, как SWF-содержимое масштабируется во Flash Player по размеру области пикселей, определенной тегом OBJECT или EMBED.
    • default — («Показать все») отображает все содержимое SWF-файла в заданной области без искажений, сохраняя исходное соотношение сторон фильма. С двух сторон от фильма могут появиться поля.
    • noborder масштабирует SWF-файл, чтобы заполнить заданную область, сохраняя исходное соотношение сторон фильма. Flash Player позволяет обрезать содержимое, не применяя искажения.
    • exactfit — отображает все содержимое SWF-файла в заданной области без искажений, не сохраняя исходного соотношения сторон. Может возникнуть искажение изображения.
    • noscale предотвращает масштабирование SWF-файла, чтобы вписать область тега OBJECT или EMBED. Может быть выполнена обрезка.
  • align (атрибут для тега Object) — возможные значения: l, t, r.
    • По умолчанию центрирует содержимое в окне браузера и обрезает края, если оно меньше окна с фильмом.
    • l (left — по левому краю), r (right — по правому краю) и t (top — по верхнему краю): выравнивает фильм по соответствующему краю окна браузера и при необходимости обрезает оставшиеся три стороны.
  • salign — возможные значения: l, t, r, tl и tr.
    • l, r и t: выравнивает фильм по левому, правому или верхнему краю окна браузера и по необходимости обрезает оставшиеся три стороны.
    • tl и tr: выравнивает фильм по верхнему левому и верхнему правому углам окна браузера, обрезает низ и, по необходимости, оставшиеся стороны.
  • wmode — возможные значения: window, direct, opaque, transparent, gpu. Устанавливает для свойства «Режим окна» значение «Прозрачность», «Слои», «Положение» и «Ренденриг» для файла SWF в браузере. Если этот атрибут не указан, то значение по умолчанию — window. Подробности приведены в разделе Использование значений «Режим окна» (wmode) ниже.
    • window — содержимое SWF воспроизводится на веб-странице в пределах собственного прямоугольника (окна). Браузер определяет слои содержимого SWF по отношению к другим элементам HTML. С таким значением невозможно ясно указать, где находится содержимое SWF на странице — над или под другими элементами HTML.  
    • direct — это значение используется для рендеринга пути. Этот атрибут позволяет обойти композицию в буфере экрана и вывести содержимое SWF напрямую на экран. Значение wmode рекомендуется использовать, чтобы оптимизировать воспроизведение содержимого. Оно обеспечивает отображение SWF-содержимого с аппаратным ускорением, для которого используется Stage Video или Stage 3D.
    • opaque — SWF-содержимое выстраивается по слоям вместе с другими элементами HTML на странице. Файл SWF непрозрачный, он скрывает все многослойное содержимое, находящееся под ним на странице. Этот параметр уменьшает производительность воспроизведения по сравнению с параметрами wmode=window или wmode=direct.
    • transparent — SWF-содержимое выстраивается по слоям вместе с другими элементами HTML на странице. Цвет фона SWF-файла (цвет рабочей области) становится прозрачным. Элементы HTML, расположенные под SWF-файлом, видно через любые прозрачные области файла SWF с наложением альфа-канала. Этот параметр уменьшает производительность воспроизведения по сравнению с параметрами wmode=window или wmode=direct.
    • gpu — можно использовать дополнительное аппаратное ускорение на некоторых мобильных устройствах и телевизорах, подключенных к Интернету. В отличие от других значений wmode не гарантируется четкое отображение пикселов в отображаемом списке графики. В противном случае это значение аналогично wmode=direct.
  • bgcolor — [шестнадцатеричное значение RGB] в формате #RRGGBB. Определяет цвет фона для содержимого SWF-файла. Этот атрибут используется, чтобы переопределить параметр цвета фона (цвета рабочей области), определенный в файле SWF. (Не влияет на цвет фона HTML-страницы.)
  • base[базовый каталог] или [URL]. Задает базовый каталог или URL-адрес для разрешения относительных путей в SWF-файле. Этот атрибут может оказаться полезным в тех случаях, когда SWF-файл хранится в другом каталоге, отдельно от остальных файлов.
  • allowFullScreen — возможные значения: true и false. Выбрав значение true для этого параметра, можно просматривать SWF-файл в режиме полного экрана посредством ActionScript. Дополнительная информация об этом приведена в разделе Знакомство с режимом полного экрана в проигрывателе Flash Player. Если этот атрибут не указан, то значение по умолчанию — false.
  • fullScreenAspectRatio — возможные значения: portrait и landscape. Используется для управления полноэкранным отображением SWF-содержимого на мобильных устройствах, поддерживающих автоматический поворот экрана, таких как телефоны и планшеты. Если этот атрибут определен, при просмотре SWF-файла в полноэкранном режиме в проигрывателе Flash Player используется указанная ориентация экрана (книжная или альбомная). Ориентация устройства не имеет значения. Если этот атрибут не определен, то ориентация содержимого полностью соответствует ориентации экрана в браузере.
  • flashvars — переменные, определенные в виде строки пар key=value, которые передаются в файл SWF.
    • С помощью flashvars можно определить в SWF-файле переменные корневого уровня. Формат строки представляет собой набор комбинаций key=value, которые разделены символом «&».
    • Браузеры поддерживают строки длиной до 64 кб (65 535 байт).
    • Дополнительная информация об использовании flashvars приведена в разделе Использование FlashVars для передачи переменных в файл SWF (tn_16417).
  • browserzoom — следующие теги OBJECT и EMBED доступны во Flash Player для изменения размера содержимого Flash в ответ на изменение коэффициента масштабирования в браузере:
    • scale: включение коэффициента масштабирования в браузере
    • noscale: отключение коэффициента масштабирования в браузере

Использование значений «Режим окна» (wmode) 

Разработчики могут установить свойство wmode («Режим окна») для содержимого SWF, чтобы контролировать слои и прозрачность содержимого в браузере. Вне зависимости от значения атрибута wmode во Flash Player отображается содержимое, просматриваемое в полноэкранном режиме при использовании прямого рендеринга пути. С помощью прямого рендеринга пути можно задействовать возможности представления с аппаратным ускорением, например Stage Video и Stage3D.

Чтобы обеспечить самое высокое качество воспроизведения содержимого Flash в браузере, используйте атрибут wmode=direct. С помощью этого атрибута можно задействовать возможности представления с аппаратным ускорением, в том числе Stage Video и Stage3D. Избегайте перекрывания областей SWF с элементами HTML (например, всплывающими меню на основе HTML), которые должны отображаться над SWF-файлом. Точный контроль слоев поддерживается только в некоторых современных браузерах (см. таблицу ниже). В других браузерах содержимое SWF всегда отображается над другими элементами HTML.

Если требуется более точное управление расположением слоев, прозрачностью или элементами HTML, отображаемыми над содержимым SWF, используйте атрибут wmode=opaque или wmode=transparent. Затем с помощью HTML можно управлять расположением слоев по отношению к другим элементам на странице. Однако при использовании этих режимов «без окон» уменьшается качество воспроизведения по сравнению с использованием атрибутов wmode=window (по умолчанию) и wmode=direct.

Случай использования Рекомендуемый атрибут wmode
Лучшая производительность, включая поддержку возможностей аппаратного ускорения Stage Video и Stage3D. wmode=direct
Требует отображения элементов HTML поверх содержимого SWF, прозрачности и точного расположения слоев по отношению к элементам HTML (во всех браузерах). wmode=opaque или wmode=transparent

Поддержка значений атрибута Window Mode (wmode) в браузере

В разных браузерах применяются разные подходы к отображению содержимого веб-страницы и обработке значений атрибута wmode. В таблице выше описаны ситуации использования разных значений wmode. На матрице ниже приведены подробности о конкретном поведении, которого можно ожидать в каждом из браузеров.

Wmode Преимущества IE 6, 7 и 8 Win IE 9 Win Firefox Win Chrome Win Firefox 3 Mac (OSX 10.5 и более поздние версии) Firefox 4 Mac (OSX 10.6 и более поздние версии) Safari 3 (OSX 10.5) Safari 4 (OSX 10.6 и более поздние версии) Chrome Mac (OSX 10.5) Chrome Mac (OSX 10.6 и более поздние версии)
window Самая обширная поддержка специальных возможностей -/-/A -/-/A -/-/A -/-/A -/-/- L/-/- -/-/- L/-/- -/-/- L/-/-
прозрачный Прозрачность и наложение альфа-канала над поддерживаемыми элементами HTML. Элементы HTML могут перекрывать содержимое SWF. Точный контроль над расположением слоев (все браузеры)  L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/-
Непрозрачный Элементы HTML могут перекрывать содержимое SWF. Точный контроль над расположением слоев (все браузеры). L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/- L/-/-
direct Наилучшая производительность. Возможности представления с аппаратным ускорением, в том числе Stage Video и Stage3D (все браузеры). -/H/A L/H/- -/H/A -/H/A -/H/- L/H/- -/H/- L/H/- -/H/- L/H/-
gpu Дополнительное аппаратное ускорение на некоторых мобильных устройствах и телевизорах, подключенных к Интернету. -/H/A L/H/- -/H/A -/H/A -/H/- L/H/- -/H/- L/H/- -/H/- L/H/-

L = поддерживается работа со слоями HTML. Элементы HTML могут перекрывать содержимое SWF. Обеспечивает точный контроль над расположением слоев по отношению к другим элементам HTML.

H = поддерживается аппаратное ускорение, в том числе Stage Video и Stage3D.

A = Поддерживается доступность.

Ключевые слова: код; значение; атрибут; теги; атрибуты; параметр; воспроизведение, цикл; качество; bgcolor; шкала; salign; база; меню; ширина; высота; src; pluginspage; фильм; classid; codebase; цвет фона; tn_12701

Эта работа лицензируется в соответствии с лицензией Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported  На посты, размещаемые в Twitter™ и Facebook, условия Creative Commons не распространяются.

Правовые уведомления   |   Политика конфиденциальности в сети Интернет