「ファイル・ アップロード」 コンポーネントを、 ページ上にドラッグ・アンド・ドロップします。
「ファイル・ アップロード」コンポーネントは、 ページ上でこのように表示されます。
実行時 の「ファイル・アップロード」 コンポーネントは、 ページ上でこのように表示されます。
コンポーネントの「プロパティー」ビューには、 コンポーネントに設定できる最も一般的な属性のセットが表示されます。 コンポーネントによっては、制御、アクション、 または他のコンポーネントの追加に関するオプションが 表示される場合もあります。 「プロパティー」ビューを開くには、
とクリックします。「ファイル・アップロード」コンポーネントの共通属性は、 「プロパティー」ビューの「hx:fileupload」タブ、 「妥当性検査」タブ、 および「アクセシビリティー」タブに表示されます。 属性の完全なリストについては、「ファイル・アップロード」のすべての属性 の 表を参照してください。 入力データの妥当性検査を行い、ファイルを制限するための 追加の構成オプションは、「hx:fileupload」タブ および「hx:fileupload>妥当性検査」タブにあります。
構成オプション |
説明 |
---|---|
カスタム検証コードを作成/編集するには、ここをクリック |
「クイック編集」ビューに切り替えて、 さまざまなユーザー開始イベント用に、 コードのスクリプトまたはスニペットを入力できるようにします。 |
エラー・メッセージ・コントロールに検証エラー・メッセージを表示 |
選択されたコンポーネントに関連付けられたエラー・メッセージ・ コンポーネントを挿入します。 これによって、妥当性検査が失敗すると、エラー・メッセージが表示されるようになります。 |
ファイル名 |
コンポーネントが使用するファイルの名前を指定します。 静的に定義することもできますし、 データ・ストレージにリンクさせることもできます。 |
ファイル・タイプ |
コンポーネントが使用するファイルのタイプを指定します。 静的に定義することもできますし、 データ・ストレージにリンクさせることもできます。 |
「すべての属性」ビューには、コンポーネントで設定できるすべての属性の表が表示されます。
この表には、「プロパティー」ビューからアクセスできる属性も含まれます。
「すべての属性」ビューに切り替えるには、
「プロパティー」ビューの右上隅にある「すべての属性」アイ
コンをクリックします。
属性名 |
「プロパティー」ビューでの表示 |
説明 |
---|---|---|
accept |
次のタイプのファイルを許可 |
コンポーネントで許可されるファイルのタイプを、 コンマで区切って指定します。 |
accesskey |
「アクセシビリティ」>「アクセス・キー」 |
アクセス・キーとして、単一のキーボード・キーを指定します。 実行時に指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます。実行時に Alt (前面) キーと 指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます (コンポーネントが ボタンの一種である場合は、そのコンポーネントが実行されます)。 |
alt |
非表示 |
コンポーネントの代替テキストを指定します。 この代替テキストが表示されるのは、 要素が正常にレンダリングされない場合です。 例えば、ブラウザーがフォームをサポートしていない場合や、 ブラウザーがイメージを表示しないように 設定されている場合などです。 |
binding |
非表示 |
コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。 |
disabled |
非表示 |
disabled が true に設定されると、 コンポーネントは実行時に表示されますが、機能しません。 ブランクのままにした場合のデフォルト値は false です。 |
exclude |
次のタイプのファイルを不許可 |
コンポーネントで除外するファイルのタイプを、コンマで区切って 指定します。 |
id |
ID |
コンポーネントに名前を割り当てます。JSP 内で固有の名前にする必要があります。 |
maxlength |
非表示 |
ファイル名およびロケーションの文字の最大長を指定します。 |
readonly |
非表示 |
コンポーネントの値を、初期値から変更できなくさせるように指定します。 |
rendered |
非表示 |
true または false に設定できます。
|
required |
値を必須にする |
コンポーネントを指定する必要があります。 これをチェックして、ユーザーからの値の入力を要求します。 |
size |
サイズ: 幅 |
コンポーネントの初期幅を指定します。 幅はピクセル単位で指定します。ただし、値が文字数を参照するテキスト入力コンポーネントの場合は除きます。 |
style |
スタイル: プロパティー |
コンポーネントに対して CSS スタイル情報を指定します (例えば、style="font-size : 8pt ; color : red")。 選択されたコンポーネントのプロパティー (例えば、フォントおよび色) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なプロパティーを選択してください。 |
styleClass |
スタイル: クラス |
この要素がレンダリングされるときに適用される、 CSS スタイル・クラスのリスト (スペース区切り)。 この値は、生成されたマークアップの クラス属性として渡されなければなりません。 選択されたコンポーネントのクラス (例えば、スタイルシート) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なクラスを選択してください。 |
tabindex |
「アクセシビリティ」>「タブ順序インデックス」 |
JSP 内のタブ順序でコンポーネントの位置を指定します。 この値は、0 から 32767 までの数値でなければなりません。 |
title |
「アクセシビリティ」>「タイトル」 |
実行時にツールチップとしてブラウザーに表示される、タイトル・テキストを指定します。 コンポーネントの代替テキストが指定されていない場合、 ブラウザーはこのテキストを代替テキストとして使用します。 |
value |
ファイル |
コンポーネントが使用するファイルを指定します。 この値はストリング (ファイル・コンテンツ は Base64 エンコードになります)、byte[]、 またはオブジェクトにすることができます。 |