UMD Web Site

Page Content Main Links Page Links Utility Links Search Footer Links

ColdFusion Development Project

cf_searchform

Description: Provides a customizable form to submit a search to the University's search engine. The form can be included in any ColdFusion Web page on the server and is to be used in combination with the cf_searchresult custom tag.

Syntax:

<cf_searchform
  actionURL = "url"
  searchURL = "url"
  fieldLength = "numeric"
  fieldText = "text string"
  fieldTextStyle = "font_style"
  buttonText = "text string"
  buttonImage = "image_url"
  buttonImageAlign = "HTML_alignment"

See also: cf_searchresult

Attributes:

Attribute Name	Required/Optional	Default	Description
actionURL	required		URL of the Web page that the search is submitted to. This Web page should contain a call to `cf_searchresult`.
searchURL	required		URL of the Web page(s) that the search is limited to. Multiple URLs must be delimited by `\|`. URLs must start with `http` or `https` and end with `/`. For example: `http://www.umassd.edu/engineering/\|http://www.atmc.umassd.edu/` would only search the engineering Web site and the ATMC Web site.
fieldLength	optional	20	Length of the text form field for the search keywords.
fieldText	optional		Text that appears in front of the text form field.
fieldTextStyle	optional		Font style defined in the Web site's style sheet to be used in `<font class="style">` where `style` is the name of the style. It can be used to format `fieldText`.
buttonText	required	Search!	Caption of the form submit button.
buttonImage	optional		URL of an optional form submit button image. If provided the image replaces the standard submit button and the value specified in `buttonText`.
buttonImageAlign	optional	middle	Alignment of the form submit button image. Possible values are: `LEFT, RIGHT, TOP, ABSMIDDLE, ABSBOTTOM, TEXTTOP, MIDDLE, BASELINE,` and `BOTTOM`.

Returns: Self-contained HTML form.

Example:

<cf_searchform actionURL="#cgi.script_name#" searchURL="http://www.umassd.edu/pce/"
               fieldLength="10" fieldText="Keyword(s):" fieldTextStyle="mb"
               buttonText="Go!"

Contact Info:

Email: webdevelopment@umassd.edu - Web Design & Development