JSF 1.2 ツリーノードコンポーネントの「プロパティー」ウィンドウ

「一般」

id。型: String
ページ Bean および JSP ファイルでのツリーノードコンポーネントの名前。

Appearance

expanded。型: boolean
選択した場合、ツリーノードはツリーを最初に表示したときにデフォルトで展開され、ノードの子ノードが表示されます。このプロパティーは、ツリーノードに子ノードがある場合にのみ視覚的効果があります。このプロパティーは、ビジュアルデザイナーでノードを開いたり、閉じたりすことによって設定、設定解除することもできます。
style。型: String
コンポーネントに適用する階層式スタイルシートの規則 (CSS レベル 2)。例:
position: absolute; left: 288px; top: 312px

値を直接入力するか、省略符号ボタン (...) をクリックしてスタイルエディタを使用して入力します。
- このプロパティーは、このコンポーネントのテーマまたはプロジェクトの CSS ファイルの設定をオーバーライドします。コンポーネントの一部が、別のスタイル設定の子コンポーネントによって隠されていると、このプロパティーに指定されているスタイルが適用されていないように見えることがあります。
CSS2 スタイル属性の一覧は、次の Web ページを参照してください。
styleClass。 型: String
コンポーネントの生成時に適用する CSS スタイルクラスの空白区切りのリスト。スタイルクラスは、プロジェクトのスタイルシートまたはテーマの CSS ファイル内で定義されている必要があります。省略符号ボタン (...) を押すと、このプロパティーに追加できるすべてのスタイルが表示されます。プロジェクトの階層式スタイルシートに CSS のクラスや規則を追加する方法については、CSS エディタを参照してください。
- このプロパティーに追加されたクラスが、コンポーネントに対して効果がないように見えることがあります。このように見える理由については、上記の「style」プロパティーの注を参照してください。
- 現在のテーマからプロジェクトの CSS ファイルに CSS スタイルクラスを追加し、そのスタイルクラスの定義を変更した場合、その変更は、そのスタイルクラスを使用しているすべてのコンポーネントに作用します。ただし、プロジェクトの CSS ファイルには、デフォルトのスタイルクラスの定義を変更する独自のスタイルクラスを追加することができ、このプロパティーにその独自のクラスを追加した場合、その変更は、このコンポーネントのこのインスタンスにのみ作用します
text。型: String
このツリーノードを表すラベル。

動作

target。型: String
現在のページで、「 url 」プロパティーで指定されているリンクを開くフレーム。この名前を持つフレームが存在しない場合は、ユーザーによって無効にされない限り、応答は新しいウィンドウに描画されます。次のフレーム名は特別な意味を持ちます。
- _blank - 名前のない新しいウィンドウに応答を描画します。
- _self - 現在のフレームに応答を描画します。
- _parent - 接しているフレームセットの親に応答を描画します。
- _top - フレームのない完全なウィンドウに応答を描画します。
toolTip。型: String
コンポーネントの HTML の title 属性になります。スクリーンリーダーで読み取ることができ、ツールチップとして表示できます。
- コンポーネントが使用不可にされていると、ほとんどのブラウザでツールチップが表示されません。
url。型: String
ターゲットドキュメントまたはリソースの URL。HTML の href 属性に相当します。このプロパティーの値を設定した場合は、ツリーノードをクリックしてもページは送信されません。通常、このプロパティーを設定しない場合は、アクションメソッドまたはアクションリスナーメソッドを使用してユーザーがハイパーリンクをクリックしたときの動作を定義します。詳細は、上記の「action」プロパティーか下記の「actionListener」プロパティーを参照してください。
visible。型: boolean
描画される HTML ページでコンポーネントをユーザーに見えるようにするかどうかを指定します。このプロパティーはデフォルトで選択されています。このプロパティーを選択解除した場合、コンポーネントの HTML コードはページに描画されますが、スタイルの設定で非表示になっているので、コンポーネントをブラウザでは見ることができません。HTML コードが描画されているためコンポーネントはフォーム送信時に処理され、ブラウザでソース表示すると HTML コードを見ることができます。このほか、Web アプリケーションはクライアント側の JavaScript を使用して、コンポーネントを表示/非表示にできます。
- たとえば特定のユーザーには見せない情報が含まれているなど、コンポーネントを完全に非表示にする必要がある場合は、「rendered」プロパティーを選択解除します。

詳細

actionListenerExpression。 型: MethodExpression
ユーザーがコンポーネントをアクティブにした場合に通知される、アクションリスナーメソッドを表すメソッド式。値は #{Page1.action_method} といった有効な JSF メソッド式である必要があり、この式では、戻り値の型が void である ActionEvent パラメータを受け取る public メソッドの名前を評価する必要があります。
rendered。型: boolean
選択した場合、ページが送信されるたびに、ツリーノードが描画され、処理されます。選択しなかった場合、ツリーノードがページに表示されることはなく、非表示コンポーネントとしても描画されません。このプロパティーは、ツリーノードをいつ描画するかを決定する JavaBean プロパティーにバインドできます。たとえば航空機の予約フォームで、頻繁に利用する顧客にはツリーノードを表示し、一般の利用客には表示しないようにできます。このプロパティーをバインドするには、ビジュアルデザイナーでコンポーネントを右クリックして、「バインドを使用」を選択し、「すべて」ラジオボタンを選択します。これで、すべてのプロパティーが表示され、「rendered」プロパティーをバインドできます。

イベント

action。ユーザーがノードを選択したときに呼び出すメソッドの名前を指定します。「action」プロパティーがアクションメソッドにバインドされている場合、ノードを選択すると、現在のページが送信されます。
- このプロパティーの JSP タグは actionExpression です。
ビジュアルデザイナーでコンポーネントを右クリックして、「イベントハンドラ action を編集」を選択することによってイベントのプロパティーを設定できます。現在のページ用の Java エディタが開き、アクションメソッドにカーソルが置かれます。このメソッドの名前は、デフォルトでは、component-id_action です。たとえば、treeNode1 という ID のツリーノードの場合、メソッド名は treeNode1_action になります。

関連項目: ツリーノードコンポーネント; コンポーネントの手順; コンポーネント関連の手順早見表

著作権と商標について