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