Просмотр кода страницы Шаблон:Звук/док

{{Документация/Шапка}}
<!-- Документацию следует размещать здесь -->
{{Lua}}
Этот шаблон используется для создания кнопки проигрывания звукового эффекта. Если JavaScript не доступен в браузере, используется запасной вариант — HTML-аудиопроигрыватель. Этот шаблон предназначен в первую очередь для коротких звуковых файлов, так как не поддерживает возможность перехода на конкретную точку времени.

Сценарий и стили для шаблона предоставляются гаджетом ([[MediaWiki:Gadget-sound.js]], [[MediaWiki:Gadget-sound.css]], [[MediaWiki:Gadget-sound-styles.css]]), а в качестве запасного варианта используются глобальные стили ([[MediaWiki:Common-all.css]]).

== Применение ==
* {{п|1}} — отображаемый вики-текст. После текста отображается иконка громкоговорителя, указывающая на статус файла (остановлен/проигрывается). При щелчке по тексту (если текст не ссылка) или по иконке все остальные звуки будут остановлены, а указанный звук начнёт или завершит воспроизведение.
* {{п|2}} — название проигрываемого аудиофайла.
* {{п|3}}, {{п|4}} и т. д. — названия дополнительных проигрываемых аудиофайлов.
* {{п|nofallback}} скрывает запасной аудиоплеер, при этом звук может быть проигран, только если доступны и включены JavaScript и гаджет звука. Этот параметр следует применять, когда кнопка звука встроена в текст, поскольку запасной аудиоплеер не внутритекстовый и слишком большой, чтобы вставить его в предложение. При использовании этого параметра следует задать отображаемый текст как ссылку на проигрываемых файл, чтобы пользователи, у которых нет JavaScript или которые отключили гаджет аудио, могли проигрывать этот файл.
* {{п|fallback_all}} показывает запасной аудиоплеер для всех приведённых звуков. Не рекомендуется использовать, но иначе шаблон никак не покажет, что файл отсутствует.

== Примеры ==
(Отключите [[Special:Preferences#mw-prefsection-gadgets|гаджет звука]], чтобы посмотреть, как выглядит запасной аудиоплеер.)
;Базовое использование
<pre>{{Звук|Зажигай! 🔥|Calm4.ogg}}</pre>
{{Звук|Зажигай! 🔥|Calm4.ogg}}


;Внутритекстовый вариант со ссылкой вместо запасного проигрывателя
<pre>Деревянный топор с {{Звук|'''[[Медиа:Плеск воды.ogg|громким плеском]]'''|Плеск воды.ogg|nofallback=1}} потонул в реке.</pre>
Деревянный топор с {{Звук|'''[[Медиа:Плеск воды.ogg|громким плеском]]'''|Плеск воды.ogg|nofallback=1}} потонул в реке.

;В карточке (также демонстрирует несколько файлов)

<pre>
{{Сущность
|звуки=
* {{Звук|'''Получение урона'''|CreeperHurt1.ogg|CreeperHurt2.ogg|CreeperHurt3.ogg|CreeperHurt4.ogg}}
* {{Звук|'''Подготовка к взрыву'''|Fuse.ogg}}
* {{Звук|'''Взрыв'''|Explosion1.ogg|Explosion2.ogg|Explosion3.ogg|Explosion4.ogg}}
* {{Звук|'''Смерть'''|CreeperDeath1.ogg}}
}}
</pre>
<div style="float:left">
{{Сущность
|звуки=
* {{Звук|'''Получение урона'''|CreeperHurt1.ogg|CreeperHurt2.ogg|CreeperHurt3.ogg|CreeperHurt4.ogg}}
* {{Звук|'''Подготовка к взрыву'''|Fuse.ogg}}
* {{Звук|'''Взрыв'''|Explosion1.ogg|Explosion2.ogg|Explosion3.ogg|Explosion4.ogg}}
* {{Звук|'''Смерть'''|CreeperDeath1.ogg}}
|инвизображение=нет
}}
</div>

<includeonly><!--
Здесь следует размещать категории и интервики шаблона -->
[[Категория:Шаблоны форматирования]]
[[en:Template:Sound]]
[[fr:Modèle:Son]]
</includeonly><noinclude><!--
Здесь следует размещать категории и интервики документации -->
[[en:Template:Sound/doc]]
[[fr:Modèle:Son/doc]]
</noinclude>