Operation Manual

649
USING DREAMWEAVER
Building forms
Last updated 3/28/2012
Insert ColdFusion file fields
You can visually insert a ColdFusion file field into your form and set its properties. Use a file field to let users select a
file from their computer, such as a word processing document or a graphics file, and upload it to the server. A
ColdFusion file field looks like other text fields, except it also has a Browse button. Users can manually enter the path
to the file they want to upload, or use the Browse button to locate and select the file.
File fields require that you use the POST method to transmit files from the browser to the server. The file is posted to
the address that you specify in the form’s Action box. Contact your server administrator to confirm that anonymous
file uploads are allowed before using a file field in your form.
File fields also require that the form encoding be set to multipart/form. Dreamweaver sets this automatically when you
insert a file field control.
Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
1 In Design view, select the CFForm to display its Property inspector.
To quickly select the form, click anywhere in the form outline and click the <cfform> tag in the tag selector at the
bottom of the Document window.
2 In the Property inspector, set the form method to POST.
3 From the Enctype pop-up menu, select multipart/form-data.
4 Position the insertion point inside the form outline where you want to file field to appear.
5 Select Insert > ColdFusion Objects > CFForm > CFfilefield.
A file field appears in the document.
6 Select the file field on the page and set any of the following properties in the Property inspector:
Cffilefield Lets you specify a unique name for the control.
Max Length Lets you specify the maximum number of characters that the path to the file can have.
Validate Specifies the type of validation for the field.
Validate At Specifies when the field is validated: onSubmit, onBlur, or onServer.
Label Lets you specify a label for the field.
Pattern Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes.
For more information, see the ColdFusion documentation.
Height Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Width Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run time.
Size Lets you specify the size of the control.
Required Lets you specify whether the file field must contain data before the form is submitted to the server.
Display Tag Editor Lets you edit properties not listed in the Property inspector.
More Help topics
“Modify ColdFusion form controls” on page 650
“Validate ColdFusion form data” on page 651