1.0.0.0以上

説明

仮想ファイルを登録する。

仮想ファイルは、ユーザーのローカルPC上に存在せず、実体のない仮想のファイルをいう。一般的に、仮想ファイルは既にアップロードされたファイルに関する情報を残す目的で使用したりする。つまりサーバーに存在するファイルと呼ばれる表示として使用される。実際にローカルに存在しないファイルなので、ファイルのアップロード先ではない。

仮想ファイルを登録するには、addVirtualFile関数を使用するかaddVirtualFileList関数を使用する。

function onDX5Created(id) {
    // 仮想ファイルは、一般的にコンポーネントが作成された時点で登録をする。
    var dx = dx5.get(id);

    // 개별로 등록할 때
    dx.addVirtualFile({ vindex: "IDX0001", name: "virtual_file.txt", size: 12345 });
    dx.addVirtualFile({ vindex: "IDX0002", name: "locked-virtual_file.txt", size: 45678, lock: true });
    dx.addVirtualFile({ vindex: "IDX0003", name: "cosmos.jpg", size: 195779 });
    dx.addVirtualFile({ vindex: "IDX0004", name: "rose.jpg", size: 83560, meta: { type: "flower", color: "red" } });

    // 複数のを一度に登録するとき
    dx.addVirtualFileList([
        { vindex: "IDX0005", name: "virtual_file.txt", size: 12345 },
        { vindex: "IDX0006", name: "locked-virtual_file.txt", size: 45678, lock: true },
        { vindex: "IDX0007", name: "cosmos.jpg", size: 195779 }
    ]);
}

仮想ファイルが登録されるときonDX5BeforeItemsAdd、onDX5BeforeItemAdding、onDX5ItemsAddedコールバック関数を呼び出していない。

形式

component.addVirtualFile(vf);

パラメータ

1.0.0.0以上

説明

配列を使用して、一度に仮想ファイルを登録する。

function onDX5Created(id) {
  // 仮想ファイルは、一般的にコンポーネントが作成された時点で登録をする。
  var dx = dx5.get(id);
  dx.addVirtualFileList([
    { vindex: "IDX0004", name: "virtual_file.txt", size: 12345 },
    { vindex: "IDX0005", name: "locked-virtual_file.txt", size: 45678, lock: true },
    { vindex: "IDX0006", name: "cosmos.jpg", size: 195779 }
  ]);
}

仮想ファイルが登録されるときonDX5BeforeItemsAdd、onDX5BeforeItemAdding、onDX5ItemsAddedコールバック関数を呼び出していない。

形式

component.addVirtualFileList(vfs);

パラメータ

1.0.0.0以上

説明

アップロードするファイルを追加するためのファイル選択ダイアログウィンドウを表示し。

DEXTUploadX5は、コンポーネント自体にファイルを追加するボタンやGUI要素がない。

代わりに、スクリプトを使用してファイルを追加することができるように関数を提供している。

ファイル選択ダイアログウィンドウで選択したターゲットがある場合はウィンドウを閉じた後、trueの値を返します。

<button type="button" onclick="addFiles();">ボタン</button>
<script>
function addFiles() {
  var dx = dx5.get("component-id");
  dx.openFileDialog();
}
</script>

openFileDialog関数の戻り値を処理するコードがない場合は、コンポーネントの作成時にbtnFile属性値を使用して自動的にバインドして使用することができる。

<button id="btn-add-files" type="button">ボタン</button>
<script>
  dx5.create({
    ...,
    // ファイルの追加機能が自動的に接続される。
    btnFile: "btn-add-files"
  });
</script>

形式

component.openFileDialog();

3.6.0.0以上

説明

フォルダー ダイアログ ウィンドウを開いて、アップロードするファイルとフォルダーを追加します。

DEXTUploadX5 には、コンポーネント自体にフォルダーを追加するためのボタンや GUI 要素はありません。 代わりに、スクリプトを使用してフォルダーを追加できる機能を提供します。

<button type="button" onclick="addFolder();">ボタン</button>
<script>
function addFolder() {
    var dx = dx5.get("component-id");
    dx.openFolderDialog();
}
</script>

コンポーネントの作成時に「btnFolder」プロパティを使用して、ボタンに自動的にバインドできます。

<button id="btn-add-folder" type="button">ボタン</button>
<script>
    dx5.create({
        ...,
        // フォルダの追加機能が自動的に接続される。
        btnFolder: "btn-add-folder"
    });
</script>

形式

component.openFolderDialog();