param 要素

4.8.5 param 要素

カテゴリー
なし
この要素を使うことができるコンテキスト：
object 要素の子として。ただし、フローコンテンツの前。
コンテンツモデル：
空
コンテンツ属性：
グローバル属性
name
value
DOMインタフェース：
interface HTMLParamElement : HTMLElement {
           attribute DOMString name;
           attribute DOMString value;
};

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

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

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

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

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

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

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

次の例は、どうやって 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/2011/WD-html5-20110525/the-iframe-element.html#the-param-element