PageRenderTime 35ms CodeModel.GetById 13ms RepoModel.GetById 1ms app.codeStats 0ms

/wheels/view/miscellaneous.cfm

http://cfwheels.googlecode.com/
ColdFusion | 471 lines | 433 code | 25 blank | 13 comment | 35 complexity | 7a0f2b9109c8e08b3788b000af756ccd MD5 | raw file
Possible License(s): Apache-2.0, CPL-1.0 
    

  1. <cffunction name="contentFor" returntype="void" access="public" output="false" hint="Used to store a section's output for rendering within a layout. This content store acts as a stack, so you can store multiple pieces of content for a given section."

    2. 

  2. 	examples=

    3. 

  3. 	'	

    4. 

  4. 		<!--- In your view --->

    5. 

  5. 		<cfsavecontent variable="mySidebar">

    6. 

  6. 		<h1>My Sidebar Text</h1>

    7. 

  7. 		</cfsavecontent>

    8. 

  8. 		<cfset contentFor(sidebar=mySidebar)>

    9. 

  9. 		

    10. 

  10. 		<!--- In your layout --->

    11. 

  11. 		<html>

    12. 

  12. 		<head>

    13. 

  13. 		    <title>My Site</title>

    14. 

  14. 		</head>

    15. 

  15. 		<body>

    16. 

  16. 		

    17. 

  17. 		<cfoutput>

    18. 

  18. 		##includeContent("sidebar")##

    19. 

  19. 		

    20. 

  20. 		##includeContent()##

    21. 

  21. 		</cfoutput>

    22. 

  22. 

    23. 

  23. 		</body>

    24. 

  24. 		</html>

    25. 

  25. 	'

    26. 

  26. 	categories="view-helper,miscellaneous" chapters="">

    27. 

  27. 	<cfargument name="position" type="any" required="false" default="last" hint="The position in the section's stack where you want the content placed. Valid values are `first`, `last`, or the numeric position.">

    28. 

  28. 	<cfargument name="overwrite" type="any" required="false" default="false" hint="Whether or not to overwrite any of the content. Valid values are `false`, `true`, or `all`.">

    29. 

  29. 	<cfset var loc = {}>

    30. 

  30. 	

    31. 

  31. 	<!--- position in the array for the content --->

    32. 

  32. 	<cfset loc.position = "last">

    33. 

  33. 	<!--- should we overwrite or insert into the array --->

    34. 

  34. 	<cfset loc.overwrite = "false">

    35. 

  35. 	

    36. 

  36. 	<!--- extract optional arguments --->

    37. 

  37. 	<cfif StructKeyExists(arguments, "position")>

    38. 

  38. 		<cfset loc.position = arguments.position>

    39. 

  39. 		<cfset StructDelete(arguments, "position", false)>

    40. 

  40. 	</cfif>

    41. 

  41. 	

    42. 

  42. 	<cfif StructKeyExists(arguments, "overwrite")>

    43. 

  43. 		<cfset loc.overwrite = arguments.overwrite>

    44. 

  44. 		<cfset StructDelete(arguments, "overwrite", false)>

    45. 

  45. 	</cfif>

    46. 

  46. 	

    47. 

  47. 	<!--- if no other arguments exists, exit --->

    48. 

  48. 	<cfif StructIsEmpty(arguments)>

    49. 

  49. 		<cfreturn>

    50. 

  50. 	</cfif>

    51. 

  51. 	

    52. 

  52. 	<!--- since we're not going to know the name of the section, we have to get it dynamically --->

    53. 

  53. 	<cfset loc.section = ListFirst(StructKeyList(arguments))>

    54. 

  54. 	<cfset loc.content = arguments[loc.section]>

    55. 

  55. 	

    56. 

  56. 	<cfif !IsBoolean(loc.overwrite)>

    57. 

  57. 		<cfset loc.overwrite = "all">

    58. 

  58. 	</cfif>

    59. 

  59. 	

    60. 

  60. 	<cfif !StructKeyExists(variables.$instance.contentFor, loc.section) OR loc.overwrite eq "all">

    61. 

  61. 		<!--- if the section doesn't exists, or they want to overwrite the whole thing --->

    62. 

  62. 		<cfset variables.$instance.contentFor[loc.section] = []>

    63. 

  63. 		<cfset ArrayAppend(variables.$instance.contentFor[loc.section], loc.content)>

    64. 

  64. 	<cfelse>

    65. 

  65. 		<cfset loc.size = ArrayLen(variables.$instance.contentFor[loc.section])>

    66. 

  66. 		<!--- they want to append, prepend or insert at a specific point in the array --->

    67. 

  67. 		<!--- make sure position is within range --->

    68. 

  68. 		<cfif !IsNumeric(loc.position) AND !ListFindNoCase("first,last", loc.position)>

    69. 

  69. 			<cfset loc.position = "last">

    70. 

  70. 		</cfif>

    71. 

  71. 		<cfif IsNumeric(loc.position)>

    72. 

  72. 			<cfif loc.position lte 1>

    73. 

  73. 				<cfset loc.position = "first">

    74. 

  74. 			<cfelseif loc.position gte loc.size>

    75. 

  75. 				<cfset loc.position = "last">

    76. 

  76. 			</cfif>

    77. 

  77. 		</cfif>

    78. 

  78. 

    79. 

  79. 		<cfif loc.overwrite>

    80. 

  80. 			<cfif loc.position is "last">

    81. 

  81. 				<cfset loc.position = loc.size>

    82. 

  82. 			<cfelseif loc.position is "first">

    83. 

  83. 				<cfset loc.position = 1>

    84. 

  84. 			</cfif>

    85. 

  85. 			<cfset variables.$instance.contentFor[loc.section][loc.position] = loc.content>

    86. 

  86. 		<cfelse>

    87. 

  87. 			<cfif loc.position is "last">

    88. 

  88. 				<cfset ArrayAppend(variables.$instance.contentFor[loc.section], loc.content)>

    89. 

  89. 			<cfelseif loc.position is "first">

    90. 

  90. 				<cfset ArrayPrepend(variables.$instance.contentFor[loc.section], loc.content)>

    91. 

  91. 			<cfelse>

    92. 

  92. 				<cfset ArrayInsertAt(variables.$instance.contentFor[loc.section], loc.position, loc.content)>

    93. 

  93. 			</cfif>

    94. 

  94. 		</cfif>			

    95. 

  95. 	</cfif>

    96. 

  96. </cffunction>

    97. 

  97. 

    98. 

  98. <cffunction name="includeLayout" returntype="string" access="public" output="false" hint="Includes the contents of another layout file. This is usually used to include a parent layout from within a child layout."

    99. 

  99. 	examples=

    100. 

  100. 	'

    101. 

  101. 		<!--- Make sure that the `sidebar` value is provided for the parent layout --->

    102. 

  102. 		<cfsavecontent variable="categoriesSidebar">

    103. 

  103. 			<cfoutput>

    104. 

  104. 				<ul>

    105. 

  105. 					##includePartial(categories)##

    106. 

  106. 				</ul>

    107. 

  107. 			</cfoutput>

    108. 

  108. 		</cfsavecontent>

    109. 

  109. 		<cfset contentFor(sidebar=categoriesSidebar)>

    110. 

  110. 		

    111. 

  111. 		<!--- Include parent layout at `views/layout.cfm` --->

    112. 

  112. 		<cfoutput>

    113. 

  113. 			##includeLayout("/layout.cfm")##

    114. 

  114. 		</cfoutput>

    115. 

  115. 	'

    116. 

  116. 	categories="view-helper,miscellaneous" chapters="using-layouts" functions="usesLayout,renderPage">

    117. 

  117. 	<cfargument name="name" type="string" required="false" default="layout" hint="Name of the layout file to include.">

    118. 

  118. 	<cfscript>

    119. 

  119. 		arguments.partial = arguments.name;

    120. 

  120. 		StructDelete(arguments, "name");

    121. 

  121. 		arguments.$prependWithUnderscore = false;

    122. 

  122. 		return includePartial(argumentCollection=arguments);

    123. 

  123. 	</cfscript>

    124. 

  124. </cffunction>

    125. 

  125. 

    126. 

  126. <cffunction name="includePartial" returntype="string" access="public" output="false" hint="Includes the specified partial file in the view. Similar to using `cfinclude` but with the ability to cache the result and use Wheels-specific file look-up. By default, Wheels will look for the file in the current controller's view folder. To include a file relative from the base `views` folder, you can start the path supplied to `name` with a forward slash."

    127. 

  127. 	examples=

    128. 

  128. 	'

    129. 

  129. 		<cfoutput>##includePartial("login")##</cfoutput>

    130. 

  130. 		-> If we''re in the "admin" controller, Wheels will include the file "views/admin/_login.cfm".

    131. 

  131. 

    132. 

  132. 		<cfoutput>##includePartial(partial="misc/doc", cache=30)##</cfoutput>

    133. 

  133. 		-> If we''re in the "admin" controller, Wheels will include the file "views/admin/misc/_doc.cfm" and cache it for 30 minutes.

    134. 

  134. 

    135. 

  135. 		<cfoutput>##includePartial(partial="/shared/button")##</cfoutput>

    136. 

  136. 		-> Wheels will include the file "views/shared/_button.cfm".

    137. 

  137. 	'

    138. 

  138. 	categories="view-helper,miscellaneous" chapters="pages,partials" functions="renderPartial">

    139. 

  139. 	<cfargument name="partial" type="any" required="true" hint="See documentation for @renderPartial.">

    140. 

  140. 	<cfargument name="group" type="string" required="false" default="" hint="If passing a query result set for the `partial` argument, use this to specify the field to group the query by. A new query will be passed into the partial template for you to iterate over.">

    141. 

  141. 	<cfargument name="cache" type="any" required="false" default="" hint="See documentation for @renderPage.">

    142. 

  142. 	<cfargument name="layout" type="string" required="false" hint="See documentation for @renderPage.">

    143. 

  143. 	<cfargument name="spacer" type="string" required="false" hint="HTML or string to place between partials when called using a query.">

    144. 

  144. 	<cfargument name="dataFunction" type="any" required="false" hint="Name of controller function to load data from.">

    145. 

  145. 	<cfargument name="$prependWithUnderscore" type="boolean" required="false" default="true">

    146. 

  146. 	<cfset $args(name="includePartial", args=arguments)>

    147. 

  147. 	<cfreturn $includeOrRenderPartial(argumentCollection=$dollarify(arguments, "partial,group,cache,layout,spacer,dataFunction"))>

    148. 

  148. </cffunction>

    149. 

  149. 

    150. 

  150. <cffunction name="cycle" returntype="string" access="public" output="false" hint="Cycles through list values every time it is called."

    151. 

  151. 	examples=

    152. 

  152. 	'

    153. 

  153. 		<!--- Alternating table row colors --->

    154. 

  154. 		<table>

    155. 

  155. 			<thead>

    156. 

  156. 				<tr>

    157. 

  157. 					<th>Name</th>

    158. 

  158. 					<th>Phone</th>

    159. 

  159. 				</tr>

    160. 

  160. 			</thead>

    161. 

  161. 			<tbody>

    162. 

  162. 				<cfoutput query="employees">

    163. 

  163. 					<tr class="##cycle("odd,even")##">

    164. 

  164. 						<td>##employees.name##</td>

    165. 

  165. 						<td>##employees.phone##</td>

    166. 

  166. 					</tr>

    167. 

  167. 				</cfoutput>

    168. 

  168. 			</tbody>

    169. 

  169. 		</table>

    170. 

  170. 		

    171. 

  171. 		<!--- Alternating row colors and shrinking emphasis --->

    172. 

  172. 		<cfoutput query="employees" group="departmentId">

    173. 

  173. 			<div class="##cycle(values="even,odd", name="row")##">

    174. 

  174. 				<ul>

    175. 

  175. 					<cfoutput>

    176. 

  176. 						<cfset rank = cycle(values="president,vice-president,director,manager,specialist,intern", name="position")>

    177. 

  177. 						<li class="##rank##">##categories.categoryName##</li>

    178. 

  178. 						<cfset resetCycle("emphasis")>

    179. 

  179. 					</cfoutput>

    180. 

  180. 				</ul>

    181. 

  181. 			</div>

    182. 

  182. 		</cfoutput>

    183. 

  183. 	'

    184. 

  184. 	categories="view-helper,miscellaneous" functions="resetCycle">

    185. 

  185. 	<cfargument name="values" type="string" required="true" hint="List of values to cycle through.">

    186. 

  186. 	<cfargument name="name" type="string" required="false" default="default" hint="Name to give the cycle. Useful when you use multiple cycles on a page.">

    187. 

  187. 	<cfscript>

    188. 

  188. 		var loc = {};

    189. 

  189. 		if (!StructKeyExists(request.wheels, "cycle"))

    190. 

  190. 			request.wheels.cycle = {};

    191. 

  191. 		if (!StructKeyExists(request.wheels.cycle, arguments.name))

    192. 

  192. 		{

    193. 

  193. 			request.wheels.cycle[arguments.name] = ListGetAt(arguments.values, 1);

    194. 

  194. 		}

    195. 

  195. 		else

    196. 

  196. 		{

    197. 

  197. 			loc.foundAt = ListFindNoCase(arguments.values, request.wheels.cycle[arguments.name]);

    198. 

  198. 			if (loc.foundAt == ListLen(arguments.values))

    199. 

  199. 				loc.foundAt = 0;

    200. 

  200. 			request.wheels.cycle[arguments.name] = ListGetAt(arguments.values, loc.foundAt + 1);

    201. 

  201. 		}

    202. 

  202. 		loc.returnValue = request.wheels.cycle[arguments.name]; 

    203. 

  203. 	</cfscript>

    204. 

  204. 	<cfreturn loc.returnValue>

    205. 

  205. </cffunction>

    206. 

  206. 

    207. 

  207. <cffunction name="resetCycle" returntype="void" access="public" output="false" hint="Resets a cycle so that it starts from the first list value the next time it is called."

    208. 

  208. 	examples=

    209. 

  209. 	'

    210. 

  210. 		<!--- alternating row colors and shrinking emphasis --->

    211. 

  211. 		<cfoutput query="employees" group="departmentId">

    212. 

  212. 			<div class="##cycle(values="even,odd", name="row")##">

    213. 

  213. 				<ul>

    214. 

  214. 					<cfoutput>

    215. 

  215. 						<cfset rank = cycle(values="president,vice-president,director,manager,specialist,intern", name="position")>

    216. 

  216. 						<li class="##rank##">##categories.categoryName##</li>

    217. 

  217. 						<cfset resetCycle("emphasis")>

    218. 

  218. 					</cfoutput>

    219. 

  219. 				</ul>

    220. 

  220. 			</div>

    221. 

  221. 		</cfoutput>

    222. 

  222. 	'

    223. 

  223. 	categories="view-helper,miscellaneous" functions="cycle"

    224. 

  224. 	>

    225. 

  225. 	<cfargument name="name" type="string" required="false" default="default" hint="The name of the cycle to reset.">

    226. 

  226. 	<cfscript>

    227. 

  227. 		if (StructKeyExists(request.wheels, "cycle") && StructKeyExists(request.wheels.cycle, arguments.name))

    228. 

  228. 			StructDelete(request.wheels.cycle, arguments.name);

    229. 

  229. 	</cfscript>

    230. 

  230. </cffunction>

    231. 

  231. 

    232. 

  232. <cffunction name="$tag" returntype="string" access="public" output="false" hint="Creates a HTML tag with attributes.">

    233. 

  233. 	<cfargument name="name" type="string" required="true" hint="The name of the HTML tag.">

    234. 

  234. 	<cfargument name="attributes" type="struct" required="false" default="#StructNew()#" hint="The attributes and their values">

    235. 

  235. 	<cfargument name="close" type="boolean" required="false" default="false" hint="Whether or not to close the tag (self-close) or just end it with a bracket.">

    236. 

  236. 	<cfargument name="skip" type="string" required="false" default="" hint="List of attributes that should not be placed in the HTML tag.">

    237. 

  237. 	<cfargument name="skipStartingWith" type="string" required="false" default="" hint="If you want to skip attributes that start with a specific string you can specify it here.">

    238. 

  238. 	<cfscript>

    239. 

  239. 		var loc = {};

    240. 

  240. 		

    241. 

  241. 		// start the HTML tag and give it its name

    242. 

  242. 		loc.returnValue = "<" & arguments.name;

    243. 

  243. 		

    244. 

  244. 		// if named arguments are passed in we add these to the attributes argument instead so we can handle them all in the same code below

    245. 

  245. 		if (StructCount(arguments) gt 5)

    246. 

  246. 		{

    247. 

  247. 			for (loc.key in arguments)

    248. 

  248. 			{

    249. 

  249. 				if (!ListFindNoCase("name,attributes,close,skip,skipStartingWith", loc.key))

    250. 

  250. 				{

    251. 

  251. 					arguments.attributes[loc.key] = arguments[loc.key];

    252. 

  252. 				}

    253. 

  253. 			}

    254. 

  254. 		}

    255. 

  255. 		

    256. 

  256. 		// add the names of the attributes and their values to the output string with a space in between (class="something" name="somethingelse" etc)

    257. 

  257. 		// since the order of a struct can differ we sort the attributes in alphabetical order before placing them in the HTML tag (we could just place them in random order in the HTML but that would complicate testing for example)

    258. 

  258. 		loc.sortedKeys = ListSort(StructKeyList(arguments.attributes), "textnocase");

    259. 

  259. 		loc.iEnd = ListLen(loc.sortedKeys);

    260. 

  260. 

    261. 

  261. 		for (loc.i=1; loc.i lte loc.iEnd; loc.i++)

    262. 

  262. 		{

    263. 

  263. 			loc.key = ListGetAt(loc.sortedKeys, loc.i);

    264. 

  264. 			// place the attribute name and value in the string unless it should be skipped according to the arguments or if it's an internal argument (starting with a "$" sign)

    265. 

  265. 			if (!ListFindNoCase(arguments.skip, loc.key) && (!Len(arguments.skipStartingWith) || Left(loc.key, Len(arguments.skipStartingWith)) != arguments.skipStartingWith) && Left(loc.key, 1) != "$")

    266. 

  266. 			{

    267. 

  267. 				// replace boolean arguments for the disabled and readonly attributs with the key (if true) or skip putting it in the output altogether (if false)

    268. 

  268. 				if (ListFindNoCase("disabled,readonly", loc.key) and IsBoolean(arguments.attributes[loc.key]))

    269. 

  269. 				{

    270. 

  270. 					if (arguments.attributes[loc.key])

    271. 

  271. 					{

    272. 

  272. 						loc.returnValue &= $tagAttribute(loc.key, LCase(loc.key));

    273. 

  273. 					}

    274. 

  274. 				}

    275. 

  275. 				else

    276. 

  276. 				{

    277. 

  277. 					loc.returnValue &= $tagAttribute(loc.key, arguments.attributes[loc.key]);

    278. 

  278. 				}

    279. 

  279. 			}

    280. 

  280. 		}

    281. 

  281. 

    282. 

  282. 		// close the tag (usually done on self-closing tags like "img" for example) or just end it (for tags like "div" for example)

    283. 

  283. 		if (arguments.close)

    284. 

  284. 		{

    285. 

  285. 			loc.returnValue &= " />";

    286. 

  286. 		}

    287. 

  287. 		else

    288. 

  288. 		{

    289. 

  289. 			loc.returnValue &= ">";

    290. 

  290. 		}		

    291. 

  291. 	</cfscript>

    292. 

  292. 	<cfreturn loc.returnValue>

    293. 

  293. </cffunction>

    294. 

  294. 

    295. 

  295. <cffunction name="$tagAttribute" returntype="string" access="public" output="false">

    296. 

  296. 	<cfargument name="name" type="string" required="true">

    297. 

  297. 	<cfargument name="value" type="string" required="true">

    298. 

  298. 	<cfreturn ' #LCase(arguments.name)#="#arguments.value#"'>

    299. 

  299. </cffunction>

    300. 

  300. 

    301. 

  301. <cffunction name="$element" returntype="string" access="public" output="false">

    302. 

  302. 	<cfargument name="name" type="string" required="true">

    303. 

  303. 	<cfargument name="attributes" type="struct" required="false" default="#StructNew()#">

    304. 

  304. 	<cfargument name="content" type="string" required="false" default="">

    305. 

  305. 	<cfargument name="skip" type="string" required="false" default="">

    306. 

  306. 	<cfargument name="skipStartingWith" type="string" required="false" default="">

    307. 

  307. 	<cfscript>

    308. 

  308. 		var returnValue = "";

    309. 

  309. 		returnValue = arguments.content;

    310. 

  310. 		StructDelete(arguments, "content");

    311. 

  311. 		returnValue = $tag(argumentCollection=arguments) & returnValue & "</" & arguments.name & ">";

    312. 

  312. 	</cfscript>

    313. 

  313. 	<cfreturn returnValue>

    314. 

  314. </cffunction>

    315. 

  315. 

    316. 

  316. <cffunction name="$objectName" returntype="any" access="public" output="false">

    317. 

  317. 	<cfargument name="objectName" type="any" required="true">

    318. 

  318. 	<cfargument name="association" type="string" required="false" default="">

    319. 

  319. 	<cfargument name="position" type="string" required="false" default="">

    320. 

  320. 	<cfscript>

    321. 

  321. 		var loc = {};

    322. 

  322. 		loc.currentModelObject = false;

    323. 

  323. 		loc.hasManyAssociationCount = 0;

    324. 

  324. 		// combine our arguments

    325. 

  325. 		$combineArguments(args=arguments, combine="positions,position");

    326. 

  326. 		$combineArguments(args=arguments, combine="associations,association");

    327. 

  327. 		// only try to create the object name if we have a simple value

    328. 

  328. 		if (IsSimpleValue(arguments.objectName) && ListLen(arguments.associations))

    329. 

  329. 		{

    330. 

  330. 			for (loc.i = 1; loc.i lte ListLen(arguments.associations); loc.i++)

    331. 

  331. 			{

    332. 

  332. 				loc.association = ListGetAt(arguments.associations, loc.i);

    333. 

  333. 				loc.currentModelObject = $getObject(arguments.objectName);

    334. 

  334. 				arguments.objectName = arguments.objectName & "['" & loc.association & "']";

    335. 

  335. 				loc.expanded = loc.currentModelObject.$expandedAssociations(include=loc.association);

    336. 

  336. 				loc.expanded = loc.expanded[1];

    337. 

  337. 				// is this assocication a hasMany?

    338. 

  338. 				if (loc.expanded.type == "hasMany")

    339. 

  339. 				{

    340. 

  340. 					loc.hasManyAssociationCount++;

    341. 

  341. 					if (loc.hasManyAssociationCount gt ListLen(arguments.positions) && application.wheels.showErrorInformation)

    342. 

  342. 						$throw(type="Wheels.InvalidArgument", message="You passed the hasMany association of `#loc.association#` but did not provide a corresponding position.");

    343. 

  343. 					arguments.objectName = arguments.objectName & "[" & ListGetAt(arguments.positions, loc.hasManyAssociationCount) & "]";

    344. 

  344. 				}

    345. 

  345. 			}

    346. 

  346. 		}

    347. 

  347. 	</cfscript>

    348. 

  348. 	<cfreturn arguments.objectName>

    349. 

  349. </cffunction>

    350. 

  350. 

    351. 

  351. <cffunction name="$tagId" returntype="string" access="public" output="false">

    352. 

  352. 	<cfargument name="objectName" type="any" required="true">

    353. 

  353. 	<cfargument name="property" type="string" required="true">

    354. 

  354. 	<cfargument name="valueToAppend" type="string" default="">

    355. 

  355. 	<cfscript>

    356. 

  356. 		var loc = {};

    357. 

  357. 		if (IsSimpleValue(arguments.objectName))

    358. 

  358. 		{

    359. 

  359. 			// form element for object(s)

    360. 

  360. 			loc.returnValue = ListLast(arguments.objectName, ".");

    361. 

  361. 			if (Find("[", loc.returnValue))

    362. 

  362. 				loc.returnValue = $swapArrayPositionsForIds(objectName=loc.returnValue);

    363. 

  363. 			if (Find("($", arguments.property))

    364. 

  364. 				arguments.property = ReplaceList(arguments.property, "($,)", "-,");

    365. 

  365. 			if (Find("[", arguments.property))

    366. 

  366. 				loc.returnValue = REReplace(REReplace(loc.returnValue & arguments.property, "[,\[]", "-", "all"), "[""'\]]", "", "all");

    367. 

  367. 			else

    368. 

  368. 				loc.returnValue = REReplace(REReplace(loc.returnValue & "-" & arguments.property, "[,\[]", "-", "all"), "[""'\]]", "", "all");

    369. 

  369. 		}

    370. 

  370. 		else

    371. 

  371. 		{

    372. 

  372. 			loc.returnValue = ReplaceList(arguments.property, "[,($,],',"",)", "-,-,");

    373. 

  373. 		}

    374. 

  374. 		if (Len(arguments.valueToAppend))

    375. 

  375. 			loc.returnValue = loc.returnValue & "-" & arguments.valueToAppend;

    376. 

  376. 	</cfscript>

    377. 

  377. 	<cfreturn REReplace(loc.returnValue, "-+", "-", "all")>

    378. 

  378. </cffunction>

    379. 

  379. 

    380. 

  380. <cffunction name="$tagName" returntype="string" access="public" output="false">

    381. 

  381. 	<cfargument name="objectName" type="any" required="true">

    382. 

  382. 	<cfargument name="property" type="string" required="true">

    383. 

  383. 	<cfscript>

    384. 

  384. 		var loc = {};

    385. 

  385. 		if (IsSimpleValue(arguments.objectName))

    386. 

  386. 		{

    387. 

  387. 			loc.returnValue = ListLast(arguments.objectName, ".");

    388. 

  388. 			if (Find("[", loc.returnValue))

    389. 

  389. 				loc.returnValue = $swapArrayPositionsForIds(objectName=loc.returnValue);

    390. 

  390. 			if (Find("[", arguments.property))

    391. 

  391. 				loc.returnValue = ReplaceList(loc.returnValue & arguments.property, "',""", "");

    392. 

  392. 			else

    393. 

  393. 				loc.returnValue = ReplaceList(loc.returnValue & "[" & arguments.property & "]", "',""", "");

    394. 

  394. 		}

    395. 

  395. 		else

    396. 

  396. 		{

    397. 

  397. 			loc.returnValue = arguments.property;

    398. 

  398. 		}

    399. 

  399. 	</cfscript>

    400. 

  400. 	<cfreturn loc.returnValue>

    401. 

  401. </cffunction>

    402. 

  402. 

    403. 

  403. <cffunction name="$swapArrayPositionsForIds" returntype="string" access="public" output="false">

    404. 

  404. 	<cfargument name="objectName" type="any" required="true" />

    405. 

  405. 	<cfscript>

    406. 

  406. 		var loc = {};

    407. 

  407. 		loc.returnValue = arguments.objectName;

    408. 

  408. 		

    409. 

  409. 		// we could have multiple nested arrays so we need to traverse the objectName to find where we have array positions and

    410. 

  410. 		// swap all of the out for object ids

    411. 

  411. 		loc.array = ListToArray(ReplaceList(loc.returnValue, "],'", ""), "[", true);

    412. 

  412. 		loc.iEnd = ArrayLen(loc.array);

    413. 

  413. 		for (loc.i = 1; loc.i lte loc.iEnd; loc.i++)

    414. 

  414. 		{

    415. 

  415. 			if (REFind("\d", loc.array[loc.i])) // if we find a digit, we need to replace it with an id

    416. 

  416. 			{

    417. 

  417. 				// build our object reference

    418. 

  418. 				loc.objectReference = "";

    419. 

  419. 				for (loc.j = 1; loc.j lte loc.i; loc.j++)

    420. 

  420. 					loc.objectReference = ListAppend(loc.objectReference, ListGetAt(arguments.objectName, loc.j, "["), "[");

    421. 

  421. 				loc.returnValue = ListSetAt(loc.returnValue, loc.i, $getObject(loc.objectReference).key($returnTickCountWhenNew=true) & "]", "[");

    422. 

  422. 			}

    423. 

  423. 		}

    424. 

  424. 	</cfscript>

    425. 

  425. 	<cfreturn loc.returnValue />

    426. 

  426. </cffunction>

    427. 

  427. 

    428. 

  428. <cffunction name="$addToJavaScriptAttribute" returntype="string" access="public" output="false">

    429. 

  429. 	<cfargument name="name" type="string" required="true">

    430. 

  430. 	<cfargument name="content" type="string" required="true">

    431. 

  431. 	<cfargument name="attributes" type="struct" required="true">

    432. 

  432. 	<cfscript>

    433. 

  433. 		var loc = {};

    434. 

  434. 		if (StructKeyExists(arguments.attributes, arguments.name))

    435. 

  435. 		{

    436. 

  436. 			loc.returnValue = arguments.attributes[arguments.name];

    437. 

  437. 			if (Right(loc.returnValue, 1) != ";")

    438. 

  438. 				loc.returnValue = loc.returnValue & ";";

    439. 

  439. 			loc.returnValue = loc.returnValue & arguments.content;

    440. 

  440. 		}

    441. 

  441. 		else

    442. 

  442. 		{

    443. 

  443. 			loc.returnValue = arguments.content;

    444. 

  444. 		}

    445. 

  445. 	</cfscript>

    446. 

  446. 	<cfreturn loc.returnValue>

    447. 

  447. </cffunction>

    448. 

  448. 

    449. 

  449. <cffunction name="$getObject" returntype="any" access="public" output="false" hint="Returns the object referenced by the variable name passed in. If the scope is included it gets it from there, otherwise it gets it from the variables scope.">

    450. 

  450. 	<cfargument name="objectName" type="string" required="true">

    451. 

  451. 	<cfscript>

    452. 

  452. 		var loc = {};

    453. 

  453. 		loc.returnValue = "";

    454. 

  454. 		

    455. 

  455. 		try

    456. 

  456. 		{

    457. 

  457. 			if (Find(".", arguments.objectName) or Find("[", arguments.objectName)) // we can't directly invoke objects in structure or arrays of objects so we must evaluate

    458. 

  458. 				loc.returnValue = Evaluate(arguments.objectName);

    459. 

  459. 			else

    460. 

  460. 				loc.returnValue = variables[arguments.objectName];

    461. 

  461. 		}

    462. 

  462. 		catch (Any e)

    463. 

  463. 		{

    464. 

  464. 			if (application.wheels.showErrorInformation)

    465. 

  465. 				$throw(type="Wheels.ObjectNotFound", message="Wheels tried to find the model object `#arguments.objectName#` for the form helper, but it does not exist.");

    466. 

  466. 			else

    467. 

  467. 				$throw(argumentCollection=e);

    468. 

  468. 		}	

    469. 

  469. 	</cfscript>

    470. 

  470. 	<cfreturn loc.returnValue>

    471. 

  471. </cffunction>
    472.