|
CF_PleaseWait was designed to be easy to implement and to take care of over-anxious users who insist on repeatively clicking hyperlinks and submit buttons because they don't see an immediate result.
To implement this tag, simply insert the tag to the very top of your script or application.cfm file.
For example:
<CF_PleaseWait>
All of the following attributes are optional.
| DISPLAY | Specify whether you want to use the HTML or the JavaScript interface. Using the JavaScript interface will give the user the option to cancel their request, however it does require that the browser support JavaScript. Defaults to "HTML". |
| JAVASCRIPT | Specify whether or not you want JavaScript on the output page. If set to "YES," JavaScript will be used to reload the current page as well as re-submiting form variables. Defaults to "NO". |
| TITLE | The default title for the page. |
| MESSAGE | The default wait message. |
| BGCOLOR | The background color for the page. This is inserted into the <BODY> tag. |
| FONTFACE | The font type/style to use on the page. Only valid for HTML messages. |
| FONTSIZE | The font size to use on the page. Only valid for HTML messages. |
| CHECKFOR | The URL variable name to use. Defaults to "PleaseWait". |
| RequestTimeout | Allows you to set the variable URL.ReguestTimeout. This is useful for scripts that may take several minutes to execute. |
| SERVER_NAME* | Allows you to set the name of the server. Defaults to CGI.SERVER_NAME. |
| PROTOCOL* | Allows you to set the default protocol (i.e. HTTP or HTTPS) By default it reads the CGI.SERVER_PORT variable to determine whether or not the protocol should be "HTTP" or "HTTPS". If the port being used is "443", the protocol is set to "HTTPS", otherwise it's set to "HTTP". |
| FIELDNAMES* | Allows you customize the list of form field names to be passed to CF_PleaseWait. By default, the tag uses the FORM.fieldnames variable. |
How can I get Cold Fusion Studio/HomeSite to work with CF_PleaseWait?
Copy the file "cf_PleaseWait.vtm" to your "..\Templates\TagEditors" directory.
The "..\Templates\TagEditors" directory can be found in the directory in which you installed
either Cold Fusion Studio 3.1 or HomeSite 3.0. (For example:
After the files have been copied, you'll be able to right-click on the tag and select the "Edit Tag..." option. You may also access this dialog box by pressing [F4] from when the cursor is inside the tag.
If you have any questions, comments or bugs to report—please e-mail me at dswitzer@pengoworks.com.