cfimport

Description

You can use the cfimport tag to import either of the following:

History

ColdFusion MX: Added this tag.

Syntax

<cfimport  
    prefix = "custom" 
    taglib = "tag library location">

Attributes

Attribute	Description	Required	Default
prefix	Prefix by which to access the imported custom CFML tags JSP tags. If you import a CFML custom tag directory and specify an empty value, "", for this attribute, you can call the custom tags without using a prefix. Specify and use a prefix for a JSP tag library.	Required
taglib	Tag library URI. The path must be relative to the web root (and start with /), the current page location, or a directory specified in the Administrator ColdFusion mappings page. A directory in which custom ColdFusion tags are stored. In this case, all the cfm pages in this directory are treated as custom tags in a tag library. A path to a JAR in a web-application, for example, "/WEB-INF/lib/sometags.jar" A path to a tag library descriptor, for example, "/sometags.tld" Note: You must put JSP custom tag libraries in the /WEB-INF/lib directory. This limitation does not apply to ColdFusion pages.	Required

Usage

The following example imports the tags from the directory myCustomTags:
<cfimport prefix="mytags" taglib="myCustomTags"> You can import multiple tag libraries using one prefix. If there are duplicate tags in a library, the first one takes precedence.
JSP tags have fixed attributes; however, if the tag supports runtime attribute expressions, most tag libraries support the use of the syntax #expressions#.
To reference a JSP tag in a CFML page, use the syntax <prefix:tagname>. Set the prefix value in the prefix attribute.

Example

<h3>cfimport example</h3> 
This example uses the random JSP tag library that is available from the 
    Jakarta Taglibs project, at http://jakarta.apache.org/taglibs/</p> 
 
<cfimport taglib="/WEB-INF/lib/taglibs-random.jar" prefix="randomnum"> 
 
<randomnum:number id="randPass" range="000000-999999" algorithm="SHA1PRNG" provider="SUN"/> 
<cfset myPassword = randPass.random> 
<cfoutput> 
    Your password is #myPassword#<br> 
</cfoutput>

cfmldocs