Случай использования
В этом документе перечислены атрибуты тегов 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
Вход в учетную запись