format field

Vector field

Lists the file formats an application can work with, for transfers between applications.

TODO: this page is incomplete.

Applies to...

• transferAbility tag
• requestTransfer tag

Sample usage

• format={txt:Text file}: plain text files.
• format={jpg;jpeg:JPEG image},{png:PNG image}: two formats, the first preferred.
• format={*}: a single file of any format.

Behaviour

Each value describes one file format, as text in the form extensions:description:

• extensions is the filename extension usually associated with the format, in lowercase and without a dot, such as txt or pdf. Where a format has several common extensions, separate them with semicolons: jpg;jpeg.
• description is a short description that may be shown to the user.

List the preferred format first. A single * on its own means one file of any format. (It doesn't match filename patterns, and can't be combined with other text.)

Extensions are used only to identify formats; the application at the other end does not have to store files with those extensions.

See also

• transferAbility tag
• requestTransfer tag