В этом документе перечислены атрибуты тегов 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.

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

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

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

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

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

Родственная информация

• Синтаксис тега OBJECT
• Файл SWF игнорирует порядок размещения и воспроизводится поверх остальных слоев DHTML

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