label - ラベル (コントロール)

テキストを表示します。

カテゴリ

コアコントロール

構文

<xp:label attributes>content</xp:label>
表 1. 必須プロパティ
プロパティ 説明
id デフォルトは label1、label2 などです。
value ラベルの値を指定します。
for ユーザーがこのコントロールをクリックするかその他の方法でフォーカスした ときにフォーカスされるコントロールを指定します。
表 2. すべてのプロパティ
カテゴリ プロパティ
アクセシビリティ accesskey、role、readonly、title
basics attrs、binding、dir、for、htmlFilter、id、lang、loaded、rendered、rendererType
data converter、value
イベント onblur、onclick、ondblclick、onfocus、onkeydown、onkeypress、onkeyup、onmousedown、onmousemove、onmouseout、onmouseover、onmouseup
styling disableTheme、style、styleClass、themeId

使用法

実行時に、ラベルの値がページに 表示されます。 フォーカスは、指定されたとおりにリダイレクトされます。

収容側の XPage またはパネルが読み取り専用の場合、あるいはラベルの readonly プロパティが true の場合、ラベルコントロールは読み取り専用です。

例

下のラベルコントロールは、共通のユーザー名を青で 表示します。
<xp:label
	value="#{javascript:session.getCommonUserName()}"
	id="label1" style="color:rgb(0,0,255)" for="inputText1">
</xp:label>

アクセシビリティ準拠

アクセシビリティ標準に従ってラベルを適用するには、ラベルコントロールを使用し、for プロパティを以下に示すように指定します。
<xp:label value="foo" for="inputText1" />
&#160;
<xp:inputText id="inputText1" defaultValue="foo" />
別の方法としては、aria-labelledby 属性を以下に示すように適用します。 ただし、WAI-ARIA をサポートしていないブラウザでは、この属性はサポートされません。
<xp:label value="foo" id="label1">
	&#160;
	<xp:inputText id="inputText1" defaultValue="foo" >
		<xp:this.attrs>
				<xp:attr name="aria-labelledby" value="#{id:label1}"></xp:attr>
		</xp:this.attrs>
	</xp:inputText>
</xp:label>
もう 1 つの方法としては、aria-label 属性を以下に示すように適用します。 ただし、この属性は非表示ラベルを生成します。
<xp:label value="foo" id="label1">
	&#160;
	<xp:inputText id="inputText1" defaultValue="foo" >
		<xp:this.attrs>
				<xp:attr name="aria-label" value="bar"></xp:attr>
		</xp:this.attrs>
	</xp:inputText>
</xp:label>

この 2 つの代替方法はどちらの場合も、示されているように、属性値にはクライアントサイドの完全な識別子を使用します。

親トピック: コントロールの参照