18. file-name-field

file-name-field(key, value, ..., key, value)

Inserts in generated content both a text field control and a button which can be used to browse files. These controls can be used to edit the value of the element which is the target of the CSS rule. If "attribute, attribute_name" is specified, these controls can be used to edit the value of an attribute of this target element.

KeyValueDefaultDescription
attributeQualified name of attribute to be editedNo defaultWithout this parameter, the control is used to edit the value of the element for which the control has been generated.
columnsPositive integer20Width of the text field in characters.
absoluteBoolean: yes|no, 1|0, "true"|"false", "on"|"off"no

Configures the file chooser dialog box.

yes

Dialog box returns an absolute path.

no

Dialog box returns a path which is relative to the entity containing the target element (when possible).

directoryBoolean: yes|no, 1|0, "true"|"false", "on"|"off"no

Configures the file chooser dialog box.

yes

Dialog box can only select directories.

no

Dialog box can only select files.

saveBoolean: yes|no, 1|0, "true"|"false", "on"|"off"no

Configures the file chooser dialog box.

yes

Dialog box can select existing files or directories, as well as files and directories to be created.

no

Dialog box can only select existing files or directories.

urlBoolean: yes|no, 1|0, "true"|"false", "on"|"off"yes

Configures the file chooser dialog box.

yes

Dialog box returns URLs

no

Dialog box returns file names.

Key, value, ..., key, value may also specify style parameters.

Examples:

file-name-field(attribute, value,
                columns, 40, 
                font-family, monospaced)

file-name-field(absolute, yes,
                directory, yes,
                save, yes,
                url, no,
                columns, 40, 
                font-family, monospaced)