View Helpers

javaScriptIncludeTag()

Signature

javaScriptIncludeTag() — returns string

Available in: controller Category: Asset Functions

Description

Returns a script tag for a JavaScript file (or several) based on the supplied arguments.

Parameters

Name	Type	Required	Default	Description
`sources`	`string`	no	—	The name of one or many JavaScript files in the `javascripts` folder, minus the `.js` extension. Pass a full URL to access an external JavaScript file. Can also be called with the `source` argument.
`type`	`string`	no	`text/javascript`	The `type` attribute for the `script` tag.
`head`	`boolean`	no	`false`	Set to `true` to place the output in the `head` area of the HTML page instead of the default behavior (which is to place the output where the function is called from).
`delim`	`string`	no	`,`	The delimiter to use for the list of JavaScript files.
`encode`	`boolean`	no	`true`	When set to `true`, encodes tag content, attribute values, and URLs so that Cross Site Scripting (XSS) attacks can be prevented. Set to `attributes` to only encode attribute values and not tag content.

Examples

<!--- View Code --->
<head>
    <!--- Includes `javascripts/main.js` --->
    #javaScriptIncludeTag("main")#

    <!--- Includes `javascripts/blog.js` and `javascripts/accordion.js` --->
    #javaScriptIncludeTag("blog,accordion")#
    
    <!--- Includes external JavaScript file --->
    #javaScriptIncludeTag("https://ajax.googleapis.com/ajax/libs/jquery/1.4.4/jquery.min.js")#
</head>

<body>
    <!--- Will still appear in the `head` --->
    #javaScriptIncludeTag(source="tabs", head=true)#
</body>