Gets or sets an image displayed on the upload pane when it is empty.

Syntax

JavaScript

Initialize

$au.uploader({
    uploadPane: {
        //...other params...
        dropFilesHereImageFormat: "",
        //...other params...
    }
})

Get/Set Value at Runtime

$au.uploader('uploaderID').uploadPane().dropFilesHereImageFormat(value);
value = $au.uploader('uploaderID').uploadPane().dropFilesHereImageFormat();

Property Value

Type: String

The image displayed on the upload pane when it is empty. If an empty string is specified, a standard Drop Files Here label is displayed.

See the Remarks section for more details about syntax of this string.

Default value is "".

Remarks

The string which specifies settings of this image has the following syntax:

variable1=value1;variable2=value2;...

The following variables are supported:

VariableDescription
UrlURL to the image. Mandatory.
WidthWidth of the image. Optional.
HeightHeight of the image. Optional.
Position

Image position. Optional. It can take one of the following values:

  • TopLeft - image will be displayed in the top left corner of the upload pane.
  • TopCenter - image will be displayed in the center of the top of the upload pane.
  • TopRight - image will be displayed in the right top corner of the upload pane.
  • CenterLeft - image will be displayed in the center of the left edge of the upload pane.
  • Center - image will be displayed in the center of the upload pane.
  • CenterRight - image will be displayed in the center of the right edge of the upload pane.
  • BottomLeft - image will be displayed in the bottom left corner of the upload pane.
  • BottomCenter - image will be displayed in the center of the bottom of the upload pane.
  • BottomRight - image will be displayed in the bottom right corner of the upload pane.

Default value is Center.

Note

The image format string is case insensitive.

You can use images of all formats recognized by Image Uploader as images. If you load animated GIF files, only the first frame will be displayed.

Image URLs can be both absolute (e.g. http://domain.com/images/image.png) and relative to the current page (e.g. /images/image.png).

For example, if Image Uploader is inserted to the http://domain.com/ImageUploader/index.html page, the relative URLs specified via this property will correspond to the following locations.

Specified URLExpected Location
"/images/image.png"http://domain.com/images/image.png
"./images/image.png"http://domain.com/ImageUploader/images/image.png
"images/image.png"http://domain.com/ImageUploader/images/image.png
"image.png"http://domain.com/ImageUploader/image.png