param 要素

4.7.5 param 要素

カテゴリー:
なし
この要素を使うことができるコンテキスト:
object 要素の子として。ただし、フロー・コンテントの前。
コンテントモデル:
コンテント属性:
グローバル属性
name - パラメーターの名前
value - パラメーターの値
text/html におけるタグの省略:
終了タグはありません
指定可能な ARIA role 属性 の値:
なし
指定可能な ARIA ステートとプロパティ属性:
グローバル aria-* 属性
DOM インタフェース:
interface HTMLParamElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString value;
};

param 要素は、object 要素によって呼び出されるプラグイン向けのパラメータを定義します。これは、それ自身で何かを表すことはありません。

name 属性は、パラメーターの名前を与えます。

value 属性は、パラメーターの値を与えます。

この両方の属性が存在しなければいけません。それらはどんな値でも持つことができます。

もし両方の属性が存在し、param 要素の親要素が object 要素なら、その要素は指定の name-value ペアを伴うパラメーターを定義します。

もし、インスタンス化されたプラグイン表す object 要素の子となる param 要素によって定義されたパラメーターの名前か値のいずれかが変更されたら、そして、そのプラグインが、パラメーターの名前と値が変更されたときに、そのプラグインを更新する能力を担う API を使ってユーザーエージェントと通信するなら、ユーザーエージェントは、その変更をプラグインに通知するためのその能力を適切に実行しなければいけません。

IDL 属性 namevalue は、それぞれ同じ名前の対応するコンテンツ属性を反映しなければいけません。

次の例は、param 要素を使ってプラグインにパラメータを引き渡す方法を示しています。これは O3D プラグインの場合です。

<!DOCTYPE HTML>
<html lang="en">
  <head>
   <title>O3D Utah Teapot</title>
  </head>
  <body>
   <p>
    <object type="application/vnd.o3d.auto">
     <param name="o3d_features" value="FloatingPointTextures">
     <img src="o3d-teapot.png"
          title="3D Utah Teapot illustration rendered using O3D."
          alt="When O3D renders the Utah Teapot, it appears as a squat
          teapot with a shiny metallic finish on which the
          surroundings are reflected, with a faint shadow caused by
          the lighting.">
     <p>To see the teapot actually rendered by O3D on your
     computer, please download and install the <a
     href="http://code.google.com/apis/o3d/docs/gettingstarted.html#install">O3D plugin</a>.</p>
    </object>
    <script src="o3d-teapot.js"></script>
   </p>
  </body>
</html>

※ 原文:http://www.w3.org/TR/2014/REC-html5-20141028/embedded-content-0.html#the-param-element