ビジュアルデザイナーで編集中のページでファイルアップロードコンポーネント
を選択すると、そのプロパティーが「プロパティー」ウィンドウに表示されます。
このコンポーネントのプロパティーの大部分は、ページ Bean では Upload Java コンポーネントの JSP 属性およびプロパティーの両方になります。
この JavaServer Faces 1.2 コンポーネントには、次のプロパティーがあります。
型: String型: intstyle」プロパティーで幅を設定していると、この設定がオーバーライドされます。たとえば、Internet Explorer は幅設定に従いますが、Mozilla は従いません。また、通常、このコンポーネントは Web ブラウザのときよりビジュアルデザイナーのときの方が多きくなり、正しく整列されていないように見えることがあるため、必ず、Web ブラウザでコンポーネントの外観をテストし、必要に応じて、ビジュアルデザイナーでコンポーネントを調整してください。 型: Stringlabel」プロパティーはラベルコンポーネントほど柔軟ではありません。コンポーネントに対するラベルの位置など、ラベルの外観をより制御したい場合は、ラベルコンポーネントを使用できます。型: int型: String position: absolute; left: 288px; top: 312px
値を直接入力するか、省略符号ボタン (...) をクリックしてスタイルエディタを使用して入力します。
CSS2 スタイル属性の一覧は、次の Web ページを参照してください。
型: Stringstyle」プロパティーの注を参照してください。 型: booleanfor」プロパティーをこのコンポーネントにリンクする場合、値を入力せずにページを送信しようとするとエラーメッセージが表示されます。型: UploadedFilecom.sun.webui.jsf.model.UploadedFile 型のオブジェクトになる式です。このプロパティーは読み取り専用で、プロパティーウィンドウでは設定できません。対応する Java Upload コンポーネントの getUploadedFile() メソッドを使用して、アップロードしたファイルの内容にアクセスすることができます。型: MethodExpressionドロップダウンリストからバリデータを選択します。空白 (null) を選択すると、バリデータは呼び出されません。バリデータを選択する場合、「required」プロパティーを選択して、ユーザーが必ず値を入力するようにできます。
型: booleandisabled」プロパティーを使用したときの働きと「readOnly」プロパティーを使用したときの働きについては、「readOnly」プロパティーの注を参照してください。型: booleandisabled」プロパティーを使用した場合、JavaServer Faces は値が送信されたことを検出しません。型: Stringtitle 属性になります。スクリーンリーダーで読み取ることができ、ツールチップとして表示できます。
型: booleanrendered」プロパティーを選択解除します。型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: String型: booleanimmediate アクションの最も一般的な例は、「取消し」ボタンです。「取消し」ボタンを immediate にして通常の妥当性検査や更新を飛ばすことができますが、アクションハンドラは引き続き必要なことをすべて行うことができます。一般には、アクションハンドラは前のページに戻ります。デザインによっては、アクションハンドラが「トランザクションが取り消されました」などの情報メッセージをキューに入れるものもあります。より多くのことを行うことも可能です。たとえば、ユーザーが現在の操作を取り消した事実を記録することもできます。
型: boolean preservePath が選択されると (true)、コンポーネントはクライアントのユーザーによって設定されたファイル入力要素のリテラル値を保持します。このプロパティーが提供されている理由は、ブラウザが HTML の file タイプの入力要素の値とは別に処理するためです。一部のブラウザは、入力要素のリテラル値を要求の multipart/form-data の部分で送信しますが、ファイル名の部分のみを送信し、ディレクトリの部分を送信しないブラウザもあります。
このプロパティーが選択されると、リテラル値 (通常はユーザーによって明示的に入力されたフルパス名、またはファイルを選択するダイアログで選択された設定のいずれか) は非表示フィールドに格納されて送信されます。UploadRenderer は対応する UploadFilterFileItem インスタンスにファイルのフルパスを保持します。これは、UploadedFile インスタンスによってカプセル化されます。UploadedFile オブジェクトの getClientFilePath メソッドを使用して、保存されたパスを取得できます。
たとえば、fileUpload1 という名前のファイルアップロードコンポーネントがあり、その preservePath プロパティーが確認されます。また、ページにはボタンおよびメッセージグループコンポーネントもあります。ボタンコンポーネントのアクションメソッドに次のコードを追加すると、メッセージグループコンポーネントのクライアントのファイルパスが表示されます。
UploadedFile uploadedFile1 = fileUpload1.getUploadedFile();
info("Uploaded file's client file path: '" +
uploadedFile1.getClientFilePath() + "'");
型: booleanこのプロパティーは、ファイルのアップロードをいつ描画するかを決定する JavaBean プロパティーにバインドできます。たとえば航空機の予約フォームで、頻繁に利用する顧客にはファイルのアップロードを表示し、一般の利用客には表示しないようにできます。このプロパティーをバインドするには、プロパティーの右側にある省略符号ボタン (...) をクリックし、ダイアログで「バインドを使用」を選択します。
ビジュアルデザイナーでコンポーネントを右クリックして、「イベントハンドラを編集」>「<イベント名>」選択することによってイベントのプロパティーを設定できます。
validatorExpression」プロパティーに JavaServer Faces バリデータを選択するのではなく、バリデータメソッドをコーディングする場合は、コンポーネントを右クリックして「イベントハンドラを編集」>「validate」を選択します。このメソッドのデフォルト名は component-id_validate で、component-id はコンポーネントの「id」プロパティーの値です。この方法でメソッドを定義すると、「validator」プロパティーと「validate」プロパティーは自動的に設定されます。バリデータを定義する場合は、「required」プロパティーを選択して、ユーザーが必ず値を入力するようにできます。
validatorExpression」プロパティーの値も設定されます。独自のバリデータメソッドを定義する場合は、「validatorExpression」プロパティーの値を変更しないでください。変更した場合、定義したバリデータメソッドとの関連付けが失われる可能性があります。component-id_processValueChange で、component-id はコンポーネントの「id」プロパティーの値です。