Visualforce 開発者ガイド
j入力項目の表示ラベルの追加とカスタマイズ
Visualforce 入力コンポーネントおよびいくつかの出力コンポーネントは、<apex:pageBlockSection> コンポーネント内で使用されている場合、項目のフォーム表示ラベルを自動的に表示します。標準またはカスタムオブジェクト項目に対応付けられているコンポーネントでは、表示されるラベルは、デフォルトでは、オブジェクト項目表示ラベルです。このデフォルト値を上書きする場合、およびオブジェクト項目に直接対応付けされていないコンポーネントの場合は、コンポーネントの label 属性を使用して表示ラベルを設定できます。次に例を示します。
1<apex:page standardController="Contact">
2 <apex:form>
3 <apex:pageBlock title="Quick Edit: {!Contact.Name}">
4 <apex:pageBlockSection title="Contact Details" columns="1">
5 <apex:inputField value="{!Contact.Phone}"/>
6 <apex:outputField value="{!Contact.MobilePhone}"
7 label="Mobile #"/>
8 <apex:inputText value="{!Contact.Email}"
9 label="{!Contact.FirstName + '’s Email'}"/>
10 </apex:pageBlockSection>
11 <apex:pageBlockButtons >
12 <apex:commandButton action="{!save}" value="Save"/>
13 </apex:pageBlockButtons>
14 </apex:pageBlock>
15 </apex:form>
16</apex:page>
label 属性には、文字列、または評価結果が文字列になる式を指定できます。label を空の文字列に設定すると、その項目のフォーム表示ラベルは表示されません。
label 属性は次の Visualforce コンポーネントで設定できます。
- <apex:inputCheckbox>
- <apex:inputField>
- <apex:inputSecret>
- <apex:inputText>
- <apex:inputTextarea>
- <apex:outputField>
- <apex:outputText>
- <apex:selectCheckboxes>
- <apex:selectList>
- <apex:selectRadio>
カスタム表示ラベルとエラーメッセージ
label 属性が設定されている場合、項目が必須であるときまたは一意になっている必要があるときなどに、この属性はコンポーネントレベルのエラーメッセージで使用されます。カスタム表示ラベルはカスタムエラーメッセージでは使用されません。デフォルトのオブジェクト項目の表示ラベルが代わりに使用されます。label 属性を空の文字列に設定すると、デフォルトのオブジェクト項目の表示ラベルはすべてのエラーメッセージで使用されます。