JSF 1.2 タブセットコンポーネントの「プロパティー」ウィンドウ
関連項目
タブセットコンポーネント をページに追加したあと、ビジュアルデザイナーで編集中のページでコンポーネントを選択すると、そのプロパティーが「プロパティー」ウィンドウに表示されます。
この JavaServer Faces 1.2 コンポーネントには、次のプロパティーがあります。
「一般」
id。 型: String
ページ Bean および JSP ファイルでのコンポーネントの名前。JSP ファイルでは、この名前がコンポーネントの id 属性の値になります。ページ Bean では、このプロパティーの値が TabSet オブジェクトの名前になります。
外観
lite。 型: boolean
選択した場合、タブセットの表示が視覚的に軽くなるようにスタイルが変更されます。この効果を実現するには、「 mini 」プロパティーも選択する必要があります。
mini。 型: boolean
選択した場合、タブとそのラベルが標準よりも小さいサイズで表示されます。「 lite 」プロパティーも選択した場合、タブのサイズはさらに小さくなり、視覚的に軽い表示になります。
style。 型: String
コンポーネントに適用する階層式スタイルシートの規則 (CSS レベル 2)。例:
position: absolute; left: 288px; top: 312px
値を直接入力するか、省略符号ボタン (...) をクリックしてスタイルエディタ を使用して入力します。
このプロパティーは、このコンポーネントのテーマまたはプロジェクトの CSS ファイルの設定をオーバーライドします。コンポーネントの一部が、別のスタイル設定の子コンポーネントによって隠されていると、このプロパティーに指定されているスタイルが適用されていないように見えることがあります。
CSS2 スタイル属性の一覧は、次の Web ページを参照してください。
styleClass。 型: String コンポーネントの生成時に適用する CSS スタイルクラスの空白区切りのリスト。スタイルクラスは、プロジェクトのスタイルシートまたはテーマの CSS ファイル内で定義されている必要があります。省略符号ボタン (...) を押すと、このプロパティーに追加できるすべてのスタイルが表示されます。プロジェクトの階層式スタイルシートに CSS のクラスや規則を追加する方法については、CSS エディタ を参照してください。
このプロパティーに追加されたクラスが、コンポーネントに対して効果がないように見えることがあります。このように見える理由については、上記の「style」プロパティーの注を参照してください。
現在のテーマ からプロジェクトの CSS ファイルに CSS スタイルクラスを追加し、そのスタイルクラスの定義を変更した場合、その変更は、そのスタイルクラスを使用しているすべてのコンポーネントに作用します。ただし、プロジェクトの CSS ファイルには、デフォルトのスタイルクラスの定義を変更する独自のスタイルクラスを追加することができ、このプロパティーにその独自のクラスを追加した場合、その変更は、このコンポーネントのこのインスタンスにのみ作用します
Data
selected。 型: Object
選択されたタブの ID を示します。ビジュアルデザイナーでタブをクリックすると、そのタブは選択状態になります。このプロパティーは、タブセットをページナビゲータとして使用する場合に便利です。現在のページのタブが選択状態であると、ユーザーがどのページにいるのかがわかります。また、タブはリンクとして使用することはできず、背景色はページと同じです。
動作
visible。 型: boolean
描画される HTML ページでコンポーネントをユーザーに見えるようにするかどうかを指定します。このプロパティーはデフォルトで選択されています。このプロパティーを選択解除した場合、コンポーネントの HTML コードはページに描画されますが、スタイルの設定で非表示になっているので、コンポーネントをブラウザでは見ることができません。HTML コードが描画されているためコンポーネントはフォーム送信時に処理され、ブラウザでソース表示すると HTML コードを見ることができます。このほか、Web アプリケーションはクライアント側の JavaScript を使用して、コンポーネントを表示/非表示にできます。
たとえば特定のユーザーには見せない情報が含まれているなど、コンポーネントを完全に非表示にする必要がある場合は、「rendered」プロパティーを選択解除します。
詳細
actionListenerExpression。 型: MethodExpression
ユーザーがコンポーネントをアクティブにした場合に通知される、アクションリスナーメソッドを表すメソッド式。値は #{Page1.action_method} といった有効な JSF メソッド式である必要があり、この式では、戻り値の型が void である ActionEvent パラメータを受け取る public メソッドの名前を評価する必要があります。
immediate。 型: boolean
このプロパティーは、タブにバリデータを持つ入力コンポーネントが含まれている場合、タブの動作に影響を与えます。タブセットの「immediate」プロパティーを設定しない場合は、このプロパティーの設定は行わないでください。タブおよびタブセットのこのプロパティーの設定の相互作用について説明している、タブセットコンポーネント の最後の部分を参照してください。一般的に、ほかのコンポーネントの場合、このプロパティーを選択すると、ユーザーがコンポーネントをアクティブにしたとき、妥当性検査やモデル値の更新などの前にページ Bean 内のコードが実行されます。基本的には、コードの実行はサーバーでただちに行われ、ページが返されます。
rendered。 型: boolean
選択した場合、ページが送信されるたびにタブが描画され、処理されます。選択しなかった場合、タブがページに表示されることはなく、非表示コンポーネントとしても描画されません。
関連項目
タブセットコンポーネント
コンポーネントの手順
コンポーネント関連の手順早見表
著作権と商標について