apex:tabPanel
タブのセットとして表示されるページの領域です。ユーザがタブのヘッダーをクリックすると、タブの関連コンテンツが表示され、他のタブのコンテンツは非表示になります。
このコンポーネントでは、「html-」プレフィックスを使用した HTML パススルー属性がサポートされています。パススルー属性は、すべてのタブを含む生成された <table> タグに適用されます。
単純な例
1<!-- Page: -->
2<apex:page id="thePage">
3 <apex:tabPanel switchType="client" selectedTab="name2" id="theTabPanel">
4 <apex:tab label="One" name="name1" id="tabOne">content for tab one</apex:tab>
5 <apex:tab label="Two" name="name2" id="tabTwo">content for tab two</apex:tab>
6 </apex:tabPanel>
7</apex:page>高度な例
1<!-- For this example to render properly, you must associate the Visualforce page
2with a valid account record in the URL.
3For example, if 001D000000IRt53 is the account ID, the resulting URL should be:
4https://Salesforce_instance/apex/myPage?id=001D000000IRt53
5See the Visualforce Developer's Guide Quick Start Tutorial for more information. -->
6
7<!-- This example shows how to use the tabClass and inactiveTabClass attributes to
8change the default styling of the tab bar. Note that in the style definitions,
9'background-image:none' is required to override the default image with the
10specified color. You can also provide your own image with .css styles. -->
11
12<apex:page standardController="Account" showHeader="true">
13 <!-- Define Tab panel .css styles -->
14 <style>
15 .activeTab {background-color: #236FBD; color:white; background-image:none}
16 .inactiveTab { background-color: lightgrey; color:black; background-image:none}
17 </style>
18
19 <!-- Create Tab panel -->
20 <apex:tabPanel switchType="client" selectedTab="name2" id="AccountTabPanel"
21 tabClass='activeTab' inactiveTabClass='inactiveTab'>
22 <apex:tab label="One" name="name1" id="tabOne">content for tab one</apex:tab>
23 <apex:tab label="Two" name="name2" id="tabTwo">content for tab two</apex:tab>
24 </apex:tabPanel>
25</apex:page>属性
| 属性名 | 属性型 | 説明 | 必須かどうか | API バージョン | 通用範囲 |
|---|---|---|---|---|---|
| activeTabClass | String | tabPanel が選択されたときのタブのヘッダーの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| contentClass | String | tabPanel コンポーネントのタブのコンテンツの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| contentStyle | String | tabPanel コンポーネントのタブのコンテンツの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 | 10.0 | グローバル | |
| dir | String | 生成された HTML コンポーネントの読み取り方向。使用可能な値には「RTL」 (右から左) または「LTR」 (左から右) があります。 | 10.0 | グローバル | |
| disabledTabClass | String | tabPanel が無効にされたときのタブのヘッダーの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| headerAlignment | String | タブのヘッダーが整列する基準となる tabPanel の側面。使用できる値には、「left」または「right」があります。指定されていない場合、この値はデフォルトの「left」に設定されます。 | 10.0 | グローバル | |
| headerClass | String | 選択されているかどうかに関係なく、すべてのタブヘッダーの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 11.0 | グローバル | |
| headerSpacing | String | 隣り合わせの 2 つのタブヘッダー間の距離 (ピクセル単位)。指定されていない場合、この値はデフォルトの 0 に設定されます。 | 10.0 | グローバル | |
| height | String | タブバーの高さ。利用可能な縦方向のスペースのパーセント (height="50%" など)、またはピクセル数 (height="200px" など) のいずれかで表されます。指定されていない場合、この値はデフォルトの 100% に設定されます。 | 10.0 | グローバル | |
| id | String | ページの他のコンポーネントが tabBar コンポーネントを参照できるようにする識別子。 | 10.0 | グローバル | |
| immediate | Boolean | ページの項目に関連付けられている入力規則を処理することなく、このコンポーネントに関連付けられているアクションをすぐに実行するかどうかを指定する boolean 値。true に設定すると、アクションがすぐに実行され、入力規則はスキップされます。指定されていない場合、この値はデフォルトの false に設定されます。 | 11.0 | グローバル | |
| inactiveTabClass | String | tabPanel が選択されていないときのタブのヘッダーの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| lang | String | 「en」または「en-US」など、生成された HTML 出力の基本言語。この属性についての詳細は、W3C 仕様を参照してください。 | 10.0 | グローバル | |
| onclick | String | onclick イベントが発生した場合 (ユーザが tabPanel をクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| ondblclick | String | ondblclick イベントが発生した場合 (ユーザが tabPanel をダブルクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeydown | String | onkeydown イベントが発生した場合 (ユーザがキーボードのキーを押した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeypress | String | onkeypress イベントが発生した場合 (ユーザがキーボードのキーを押したか、押したままにした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onkeyup | String | onkeyup イベントが発生した場合 (ユーザがキーボードのキーを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousedown | String | onmousedown イベントが発生した場合 (ユーザがマウスボタンをクリックした場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmousemove | String | onmousemove イベントが発生した場合 (ユーザがマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseout | String | onmouseout イベントが発生した場合 (ユーザが tabPanel コンポーネントからマウスポインタを移動した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseover | String | onmouseover イベントが発生した場合 (ユーザが tabPanel コンポーネントにマウスポインタを重ねた場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| onmouseup | String | onmouseup イベントが発生した場合 (ユーザがマウスボタンを放した場合) に呼び出される JavaScript。 | 10.0 | グローバル | |
| rendered | Boolean | コンポーネントをページに表示するかどうかを指定する boolean 値。指定されていない場合、この値はデフォルトの true に設定されます。 | 10.0 | グローバル | |
| reRender | Object | AJAX 更新要求の結果がクライアントに返されるときに再作成される 1 つ以上のコンポーネントの ID。この値には、単一の ID、ID のカンマ区切りのリスト、または ID のリストまたはコレクションの差し込み項目の式を使用できます。この値は、switchType 属性が「ajax」に設定されている場合にのみ適用されます。 | 10.0 | グローバル | |
| selectedTab | Object | ページが読み込まれたときに、デフォルトで選択されるタブの名前。この値は、子のタブコンポーネントの name 属性と一致している必要があります。value 属性が定義されている場合、selectedTab 属性は無視されます。 | 10.0 | グローバル | |
| style | String | tabPanel コンポーネントの表示に使用されるスタイル。主に、インライン CSS スタイルを追加するために使用されます。 | 10.0 | グローバル | |
| styleClass | String | tabPanel コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| switchType | String | タブ間の切り替えに使用される実装メソッド。使用できる値には、「client」、「server」、および「ajax」があります。指定されていない場合、この値はデフォルトの「server」に設定されます。 | 10.0 | グローバル | |
| tabClass | String | tabPanel コンポーネントの表示に使用されるスタイルクラス。主に、外部 CSS スタイルシートを使用するときに適用される CSS スタイルを指定するために使用されます。 | 10.0 | グローバル | |
| title | String | ユーザがコンポーネントにマウスポインタを重ねたときにツールチップとして表示されるテキスト。 | 10.0 | グローバル | |
| value | Object | 現在有効なタブ。式を使用してこれを指定し、有効なタブを動的に制御できます。たとえば、value="{!TabInFocus}" とします。TabInFocus はカスタムコントローラによって設定される変数です。この属性の値は、selectedTab に設定されている値より優先されます。 | 10.0 | グローバル | |
| width | String | tabPanel の幅。利用可能な横方向のスペースのパーセント (width="50%" など)、またはピクセル数 (width="800px" など) のいずれかで表されます。指定されていない場合、この値はデフォルトの 100% に設定されます。 | 10.0 | グローバル |