ファイル・アップロード

サーバーにファイルを送信します。 ファイル・アップロード・コンポーネントは、 通常はデータベースまたは Bean などのデータ・ストレージにバインドされます。 ファイル・アップロード・コントロールを持つページが実行されると、 そのファイルは指定された場所 (例えば、データベース内の列、あるいは Bean のプロパティー) に保管されます。

設計時のコンポーネント

「ファイル・ アップロード」 コンポーネントを、 ページ上にドラッグ・アンド・ドロップします。

「ファイル・アップロード」コンポーネントのボタン

「ファイル・ アップロード」コンポーネントは、 ページ上でこのように表示されます。

デザイン時の「ファイル・アップロード」

実行時のコンポーネント

実行時 の「ファイル・アップロード」 コンポーネントは、 ページ上でこのように表示されます。

実行時の「ファイル・アップロード」

「プロパティー」ビューと「すべての属性」ビュー

コンポーネントの「プロパティー」ビューには、 コンポーネントに設定できる最も一般的な属性のセットが表示されます。 コンポーネントによっては、制御、アクション、 または他のコンポーネントの追加に関するオプションが 表示される場合もあります。 「プロパティー」ビューを開くには、 「ウィンドウ」 > 「ビューの表示」 > 「プロパティー」とクリックします。

「ファイル・アップロード」コンポーネントの共通属性は、 「プロパティー」ビューの「hx:fileupload」タブ、 「妥当性検査」タブ、 および「アクセシビリティー」タブに表示されます。 属性の完全なリストについては、「ファイル・アップロード」のすべての属性 の 表を参照してください。 入力データの妥当性検査を行い、ファイルを制限するための 追加の構成オプションは、「hx:fileupload」タブ および「hx:fileupload>妥当性検査」タブにあります。

表 1. 「ファイル・アップロード」構成オプション

構成オプション

説明

カスタム検証コードを作成/編集するには、ここをクリック

「クイック編集」ビューに切り替えて、 さまざまなユーザー開始イベント用に、 コードのスクリプトまたはスニペットを入力できるようにします。

エラー・メッセージ・コントロールに検証エラー・メッセージを表示

選択されたコンポーネントに関連付けられたエラー・メッセージ・ コンポーネントを挿入します。 これによって、妥当性検査が失敗すると、エラー・メッセージが表示されるようになります。

ファイル名

コンポーネントが使用するファイルの名前を指定します。 静的に定義することもできますし、 データ・ストレージにリンクさせることもできます。

ファイル・タイプ

コンポーネントが使用するファイルのタイプを指定します。 静的に定義することもできますし、 データ・ストレージにリンクさせることもできます。

「すべての属性」ビューには、コンポーネントで設定できるすべての属性の表が表示されます。 この表には、「プロパティー」ビューからアクセスできる属性も含まれます。 「すべての属性」ビューに切り替えるには、 「プロパティー」ビューの右上隅にある「すべての属性」アイ コン「すべての属性」
アイコンをクリックします。

表 2. 「ファイル・アップロード」のすべての属性

属性名

「プロパティー」ビューでの表示

説明

accept

次のタイプのファイルを許可

コンポーネントで許可されるファイルのタイプを、 コンマで区切って指定します。

accesskey

「アクセシビリティ」>「アクセス・キー」

アクセス・キーとして、単一のキーボード・キーを指定します。 実行時に指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます。実行時に Alt (前面) キーと 指定されたアクセス・キーを押すと、 このコンポーネントがフォーカスされます (コンポーネントが ボタンの一種である場合は、そのコンポーネントが実行されます)。

alt

非表示

コンポーネントの代替テキストを指定します。 この代替テキストが表示されるのは、 要素が正常にレンダリングされない場合です。 例えば、ブラウザーがフォームをサポートしていない場合や、 ブラウザーがイメージを表示しないように 設定されている場合などです。

binding

非表示

コンポーネントの インスタンス (通常はユーザー・インターフェース・ コンポーネント) を、Bean プロパティー (通常は バッキング・ファイル内にあります) にバインドする式です。

disabled

非表示

disabled が true に設定されると、 コンポーネントは実行時に表示されますが、機能しません。 ブランクのままにした場合のデフォルト値は false です。

exclude

次のタイプのファイルを不許可

コンポーネントで除外するファイルのタイプを、コンマで区切って 指定します。

id

ID

コンポーネントに名前を割り当てます。JSP 内で固有の名前にする必要があります。

maxlength

非表示

ファイル名およびロケーションの文字の最大長を指定します。

readonly

非表示

コンポーネントの値を、初期値から変更できなくさせるように指定します。

rendered

非表示

true または false に設定できます。
  • false - コンポーネントは、実行時にブラウザーにレンダリングされません。
  • true - コンポーネントがレンダリングされます。これはデフォルト値です。

required

値を必須にする

コンポーネントを指定する必要があります。 これをチェックして、ユーザーからの値の入力を要求します。

size

サイズ: 幅

コンポーネントの初期幅を指定します。 幅はピクセル単位で指定します。ただし、値が文字数を参照するテキスト入力コンポーネントの場合は除きます。

style

スタイル: プロパティー

コンポーネントに対して CSS スタイル情報を指定します (例えば、style="font-size : 8pt ; color : red")。 選択されたコンポーネントのプロパティー (例えば、フォントおよび色) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なプロパティーを選択してください。

styleClass

スタイル: クラス

この要素がレンダリングされるときに適用される、 CSS スタイル・クラスのリスト (スペース区切り)。 この値は、生成されたマークアップの クラス属性として渡されなければなりません。 選択されたコンポーネントのクラス (例えば、スタイルシート) を定義します。 これは手動で行うか、またはボタンをクリックして、 ウィンドウ内から必要なクラスを選択してください。

tabindex

「アクセシビリティ」>「タブ順序インデックス」

JSP 内のタブ順序でコンポーネントの位置を指定します。 この値は、0 から 32767 までの数値でなければなりません。

title

「アクセシビリティ」>「タイトル」

実行時にツールチップとしてブラウザーに表示される、タイトル・テキストを指定します。 コンポーネントの代替テキストが指定されていない場合、 ブラウザーはこのテキストを代替テキストとして使用します。

value

ファイル

コンポーネントが使用するファイルを指定します。 この値はストリング (ファイル・コンテンツ は Base64 エンコードになります)、byte[]、 またはオブジェクトにすることができます。

関連タスク
入力フィールドのカスタム・パターンの定義
ファイル・アップロード・コンポーネントの使用
関連資料
データ・テーブル
入力
入力 - 非表示
入力 - パスワード
入力 - テキスト領域
リッチ・テキスト領域

フィードバック