Visualforce 開発者ガイド
jフォームの項目のタブ順序の設定
Visualforce フォームには入力項目をタブで移動する場合の「自然な順序」(左から右および上から下) が用意されています。一部のフォームでは、この順序が必ずしも最も効率が良い配置方法、あるいはアクセスしやい配置方法ではない場合があります。ページの入力コンポーネントおよびその他のコンポーネントに tabIndex 属性を設定してこのタブ順序を任意の順序に変更できます。次に例を示します。
1<apex:page standardController="Account">
2 <apex:form>
3 <apex:pageBlock title="Edit Account: {!Account.Name}">
4 <apex:pageBlockSection title="Account Details" columns="1">
5 <apex:inputField value="{!Account.Name}" tabIndex="4"/>
6 <apex:inputField value="{!Account.Website}" tabIndex="3"/>
7 <apex:inputField value="{!Account.Industry}" tabIndex="2"/>
8 <apex:inputField value="{!Account.AnnualRevenue}" tabIndex="1"/>
9 </apex:pageBlockSection>
10 </apex:pageBlock>
11 </apex:form>
12</apex:page>このページを表示して Tab キーを押すと、通常期待する順序とは逆順に有効な項目が変わります。
tabIndex 属性は 0 ～ 32767 の整数、または評価結果がこの範囲の整数値になる式である必要があります。タブ順序は、ユーザが Tab キーを押すと選択される最初のコンポーネントであるコンポーネント 0 から始まります。
tabIndex 属性は次の Visualforce コンポーネントで設定できます。
- <apex:commandButton>
- <apex:commandLink>
- <apex:inputCheckbox>
- <apex:inputField>
- <apex:inputFile>
- <apex:inputSecret>
- <apex:inputText>
- <apex:inputTextarea>
- <apex:outputLabel>
- <apex:outputLink>
- <apex:selectCheckboxes>
- <apex:selectList>
- <apex:selectRadio>
反復内のコンポーネントに対する tabIndex の設定
<apex:dataTable> または <apex:repeat> の内部などで反復コンポーネントによって繰り返し処理されるコンポーネントに tabIndex 属性を設定できます。ただし、この場合、必要な作業が若干増えます。
アクセスされると自動的に増分を行う Apex の getter メソッドを使用して tabIndex を設定するというソリューションは、明解に見えますが、機能しません。Visualforce は getter メソッドの結果をキャッシュするため、ページを使用するたびに getter メソッドがコールされるとは限りません。Visualforce の getter メソッドの実装方法についての詳細は、「Visualforce ページ内の実行順序」を参照してください。
代わりに、反復処理されるコレクションの各要素でオブジェクト参照または項目参照と共に tabIndex 値を指定できます。次に、Visualforce ページ内にこれがどのように表示されるかを示します。
1<apex:page controller="OppsController">
2 <apex:form>
3 <apex:dataTable value="{!OpportunitiesWithIndex}" var="oppWrapped">
4 <apex:column>
5 <apex:facet name="header">Opportunity</apex:facet>
6 <apex:outputField value="{!oppWrapped.opp.name}"/>
7 </apex:column>
8 <apex:column>
9 <apex:facet name="header">Amount</apex:facet>
10 <apex:inputField value="{!oppWrapped.opp.amount}"
11 tabindex="{!oppWrapped.tabIndex}"/>
12 </apex:column>
13 </apex:dataTable>
14 </apex:form>
15</apex:page><apex:dataTable> コンポーネントは商談レコードのリストを反復処理しません。ただし、{!oppWrapped.opp} として参照される商談と、{!oppWrapped.tabIndex} として参照されるその tabIndex をラップするオブジェクトのリストは反復処理します。次に、このコレクションを提供するコントローラを示します。
1public class OppsController {
2
3 // Get a set of Opportunities
4 public ApexPages.StandardSetController setCon {
5 get {
6 if(setCon == null) {
7 setCon = new ApexPages.StandardSetController(Database.getQueryLocator(
8 [SELECT name, type, amount, closedate FROM Opportunity]));
9 setCon.setPageSize(5);
10 }
11 return setCon;
12 }
13 set;
14 }
15
16 public List<Opportunity> getOpportunities() {
17 return (List<Opportunity>) setCon.getRecords();
18 }
19
20 public List<OppWrapper> getOpportunitiesWithIndex() {
21 List<Opportunity> opps = this.getOpportunities();
22 List<OppWrapper> oppsWrapped = new List<OppWrapper>();
23 Integer idex = 1;
24 for (Opportunity opp : opps) {
25 oppsWrapped.add(new OppWrapper(opp, idex));
26 idex++;
27 }
28 return oppsWrapped;
29 }
30
31 public class OppWrapper {
32 public Opportunity opp { get; set; }
33 public Integer tabIndex { get; set; }
34 public OppWrapper(Opportunity opp, Integer tabIndex) {
35 this.opp = opp;
36 this.tabIndex = tabIndex;
37 }
38 }
39}- 内部クラス OppWrapper は商談への参照とインデックス番号を組み合わせます。
- getOpportunitesWithIndex メソッドは、それぞれの OppWrapper の tabIndex の位置を計算して OppWrapper のリストを作成します。