Upload Mode
Depending on the uploadMode you choose, the FileUploader widget uploads files using an HTML form or FormData interface and a series of Ajax requests. The uploadMode option accepts one of the following values:
"instantly" (default)
Ajax upload. Files are uploaded after they are selected."useButtons"
Ajax upload. Files are uploaded after a user clicks the Upload button."useForm"
HTML form upload. Files are uploaded when the HTML form is submitted.
The following examples show how to configure the FileUploader for uploading files using Ajax requests and an HTML form. Note that in both cases, the name option is specified to access the uploaded files on the server.
Ajax upload
HTMLTypeScript- <dx-file-uploader
- name="file"
- <!-- Uncomment the following line to allow a user to upload multiple files -->
- <!-- [multiple]="true" -->
- uploadMode="useButtons" <!-- or "instantly" -->
- uploadUrl="/upload.php">
- </dx-file-uploader>
- import { DxFileUploaderModule } from 'devextreme-angular';
- // ...
- export class AppComponent {
- // ...
- }
- @NgModule({
- imports: [
- // ...
- DxFileUploaderModule
- ],
- // ...
- })
HTML form upload
HTMLTypeScript- <form action="/upload.php" method="post" enctype="multipart/form-data">
- <dx-file-uploader
- name="file"
- <!-- Uncomment the following lines to allow a user to upload multiple files -->
- <!-- [multiple]="true" -->
- <!-- name="files[]" -->
- uploadMode="useForm">
- </dx-file-uploader>
- <input type="submit">
- </form>
- import { DxFileUploaderModule } from 'devextreme-angular';
- // ...
- export class AppComponent {
- // ...
- }
- @NgModule({
- imports: [
- // ...
- DxFileUploaderModule
- ],
- // ...
- })
See Also
Additional Parameters in a Request
If the uploadMode is "instantly" or "useButtons", you can add parameters to the URL by modifying the uploadUrl option. For example, the following code adds an employee ID and an office number:
- <dx-file-uploader
- name="file"
- (onValueChanged)="addIdParameter($event)"
- [uploadUrl]="uploadUrl"
- uploadMode="instantly"> <!-- or "useButtons" -->
- </dx-file-uploader>
- <dx-number-box
- [(value)]="employee.office"
- (onValueChanged)="addOfficeParameter($event)">
- </dx-number-box>
- import { DxFileUploaderModule, DxNumberBoxModule } from 'devextreme-angular';
- // ...
- export class AppComponent {
- employee = { id: 1, name: "John Heart", position: "CEO", office: 614 };
- uploadUrl = "/upload.php";
- addIdParameter (e) {
- this.uploadUrl = this.updateQueryStringParameter(this.uploadUrl, "id", this.employee.id);
- e.component.option("uploadUrl", this.uploadUrl);
- }
- addOfficeParameter (e) {
- if ( e.value !== e.previousValue ) {
- this.uploadUrl = this.updateQueryStringParameter(this.uploadUrl, "office", e.value);
- }
- }
- updateQueryStringParameter (uri, key, value) {
- var re = new RegExp("([?&])" + key + "=.*?(&|$)", "i");
- var separator = uri.indexOf('?') !== -1 ? "&" : "?";
- if (uri.match(re)) {
- return uri.replace(re, '$1' + key + "=" + value + '$2');
- }
- else {
- return uri + separator + key + "=" + value;
- }
- }
- }
- @NgModule({
- imports: [
- // ...
- DxFileUploaderModule,
- DxNumberBoxModule
- ],
- // ...
- })
When the uploadMode is "useForm", define the parameters within hidden inputs. They are sent to the server in an HTML form along with the files. Some DevExtreme widgets have underlying hidden inputs too. Use the widget's name option to specify the input's name
attribute.
- <form action="/upload.php" method="post" enctype="multipart/form-data">
- <input type="hidden" name="id" [value]="employeeId">
- <dx-file-uploader
- name="file"
- uploadMode="useForm"
- (onValueChanged)="addParameters()">
- </dx-file-uploader>
- <dx-number-box
- [(value)]="employeeOffice"
- name="office">
- </dx-number-box>
- <dx-button
- text="Update profile"
- [useSubmitBehavior]="true">
- </dx-button>
- </form>
- import { DxFileUploaderModule, DxButtonModule, DxNumberBoxModule } from 'devextreme-angular';
- // ...
- export class AppComponent {
- employee = { id: 1, name: "John Heart", position: "CEO", office: 614 };
- employeeId: any;
- employeeOffice = this.employee.office;
- addParameters () {
- this.employeeId = this.employee.id;
- }
- }
- @NgModule({
- imports: [
- // ...
- DxFileUploaderModule,
- DxButtonModule,
- DxNumberBoxModule
- ],
- // ...
- })
If you have technical questions, please create a support ticket in the DevExpress Support Center.