使用Velocity，当然就免不了要使用宏，或者说使用Velocity而不使用其宏，就相当于废了Velocity一半以上的武功，非常可惜的。
怎么使用Velocity的宏呢，才最大程度的发挥其作用但是又避免掉入其中的坑呢？且听悠然乱弹乱弹：
官方文档中，关于Macro是这么说的：
#macro - Allows users to define a Velocimacro (VM), a repeated segment of a VTL template, as requiredFormat: # [ { ] macro [ } ] ( vmname $arg1 [ $arg2 $arg3 ... $argn ] ) [ VM VTL code... ] # [ { ] #end [ } ]
Once defined, the VM is used like any other VTL directive in a template. #vmname( $arg1 $arg2 ) |
当然，上面清晰的说明了怎么写Macro,
也就是说可以写成：
|
1
2
3
4
5
|
#
{macro}(macroName $varName
1
$varName
2
)
##
这里是模板内容
#
end
|
|
1
2
3
4
5
|
#macro(macroName $varName1 $varName2)
##这里是模板内容
#end
|
OK，确实很简单，但是上面的说法实际上只解决了如何写出满足正确语法的宏，但是实际应用当中，如果不加以约束，可能就出现非常难以查找的问题。
比如下面定义了一个超链接的宏，由于id不是每次都用得到，因此id是可选参数，可以填，也可以不填：
|
1
2
3
|
#macro(link $href $id)
<
a
href
=
"$!href"
#if($id)
id
=
"$id"
#end>$bodyContent</
a
>
#end
|
|
1
|
#@link("www.tinygroup.com")TinyGroup#end
|
上面的写法有问题么？？似乎没有什么问题，即使什么参数也不传，只写下面的调用方法：
|
1
|
#@link()#end
|
|
1
|
<
a
href
=
""
></
a
>
|
接下来，我们又要写一个图片链接的宏，同样的由于id不是每次都需要，我们把它写成可选的：
|
1
2
3
|
#macro(image $href $id)
<
img
src
=
"$href"
#if($id)
id
=
"$id"
#end>
#end
|
|
1
|
#image("www.tinygroup.org/img/logo.gif")
|
|
1
|
#image("www.tinygroup.org/img/logo.gif" "logoImage")
|
但是我们想给首页上的Logo图片加个链接到首面上。
这个时候，我们会如下写：
|
1
2
3
|
#@link("www.tinygroup.org")
#image("www.tinygroup.org/img/logo.gif")
#end
|
|
1
|
<
a
href
=
"www.tinygroup.org"
><
img
src
=
"www.tinygroup.org/img/logo.gif"
></
a
>
|
这个时候，我们忽然期望首页链接添加个id，期望利用JQuery对其进行一些动态处理，我们就把代码写成下面的样子：
|
1
2
3
|
#@link("www.tinygroup.org" "homepageLink")
#image("www.tinygroup.org/img/logo.gif")
#end
|
|
1
|
<
a
href
=
"www.tinygroup.org"
id
=
"homepageLink"
><
img
src
=
"www.tinygroup.org/img/logo.gif"
id
=
"homepageLink"
></
a
>
|
- 外层的宏中的变量，在内层的宏中是可以访问的
- 内层中的变量，如果与外层中宏的变量名冲突，如果有传入，则按传入的值，如果没有传入，则取上层中的值
正是基于上述原因，在Tiny UI框架中，所有宏定义，宏变量都必须前宏前缀，也就是说上面的两个宏定义要按下面的方式来进行定义：
|
1
2
3
|
#macro(link $linkHref $linkId)
<
a
href
=
"$!linkHref"
#if($linkId)
id
=
"$linkId"
#end>$bodyContent</
a
>
#end
|
|
1
2
3
|
#macro(image $imageHref $imageId)
<
img
src
=
"$imageHref"
#if($imageId) id="$imageId<span></
span
>"#end>
#end
|
小结：
虽然原因及解决办法都非常简单，但是也是吃了亏之后才总结出来的，希望能对也使用Velocicty或其它模板语言的同学有帮助。
