JSF構成 - <description>要素

親要素を説明するメタデータを宣言します。この要素では、<description>の複数のインスタンスを使用できますが、各インスタンスで一意のxml:lang値を使用する必要があります。

構文

<description [xml:lang="lang"]>description</description>    

descriptionの値は任意の長さのテキストになります。必要に応じて、XMLエスケープ文字を使用できます。

属性

xml:lang
使用方法: 説明の言語を宣言します。
値: ISO言語識別子。

子要素

なし。

次の例では、カスタム・コンポーネントSliderの英語の説明テキストを定義します。アプリケーション開発ツールでは、この定義を読み取り、コンポーネントが使用される際に選択されると説明を表示します。

<component>
  <description xml:lang="en">
    This component displays a slider control that you can use to
    control relative values such as audio volume or display brightness. The slider properties 
    allow you to set the slider's orientation, minimum and maximum values, length, and initial
    value.
  </description>
  <component-type>com.component.Slider</component-type>
  <component-class>com.jsf.components.Slider</component-class>
</component>    

<display-name>要素
JSF構成メタデータについて
リファレンス: JSF構成要素