• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

Audio ショートコード

提供: WordPress Codex 日本語版
移動先: 案内検索

この項目「Audio ショートコード」は、翻訳チェック待ちの項目です。加筆、訂正などを通して、Codex ドキュメンテーションにご協力下さい。

オーディオ機能を使うとシンプルなショートコードでオーディオファイルを埋め込んで再生できます。これは WordPress 3.6 で導入されました。次のように使います:

[audio]

また組み込みの embed 機能を利用してメディアファイルだけの行を入れる方法もあります:

  My cool content

  http://my.mp3s.com/cool/songs/coolest.mp3

  More cool content

昔の投稿にメディアライブラリー内のオーディオファイルを添付してあり、新しくショートコードを使いたい場合:

[audio]

メディアライブラリー内または外部の MP3 オーディオファイルの URL を指定して再生する場合:

[audio src="audio-source.mp3"]

ソースの URL の他に HTML5 でサポートされるファイルタイプをフォールバックとする場合:

[audio mp3="source.mp3" ogg="source.ogg" wav="source.wav"]

オプション

以下の基本的なオプションがサポートされます:

src
文字列) (オプション) オーディオファイルのソース。省略すると投稿へ添付されている先頭のオーディオファイルが自動的に使われます。フォールバック用に特定のファイルタイプを定義する場合、次のオプションを利用できます:
  • 'mp3', 'm4a', 'ogg', 'wav', 'wma'
初期値: 投稿へ添付されている先頭のオーディオファイル
loop
文字列) (オプション) メディアのループ再生を有効にします。デフォルトは "off" です。
  • "off" - (デフォルト) ループ再生しない
  • "on" - 完了すると最初へ戻って自動的に再生を続ける
初期値: "off"
autoplay
文字列) (optional) メディアファイルが用意できたら自動的に再生します。デフォルトは "off" です。
  • "off" - (デフォルト) 自動再生しない
  • "on" - メディアの準備ができ次第すぐ再生する
初期値: "off"
preload
文字列) (オプション) ページを読み込む時にオーディオも読み込むかどうかと読み込み方法を指定します。デフォルトは "none" です。
  • "none" - (デフォルト) ページ読み込み時にオーディオを読み込まない
  • "auto" - ページ読み込み時にオーディオ全体を読み込む
  • "metadata" - ページ読み込み時にメタデータだけを読み込む
初期値: "none"

ソースファイル

audio ショートコードは wp-includes/media.php にあります。

wp_audio_shortcode()

ショートコード: [audio] /en, [caption] /en, [embed] /en, [gallery] /en, [playlist] /en, [video] /en

最新英語版: WordPress Codex » Audio Shortcode最新版との差分