usability - 宏的速度命名参数

Question

我有一个带有多个参数的宏。其中一些是可选的，如果参数留空，它将替换为默认值。

现在的问题是如何让普通网页设计师尽可能轻松地完成这项工作。除了我的示例之外，还有其他可能性来处理这种情况吗？

示例 1:

这里明显的问题是可选值。

#macro (myTag $param1 $param2 $param3)
...
#end

示例 2:

这里的问题是当多次使用同一个宏并且所有变量都没有重新设置时可能出现的问题。

#set ($param1="value1") 
#set ($param2="value2") 
#set ($param3="value3") 

#macro (myTag)
...
#end

Answer 1

从 Velocity 1.6 开始，不支持可选或命名参数。最近提交了一个具有此功能的补丁，因此我们可能会在未来的版本中看到它可用。

与此同时，考虑传入一个列表或值映射。例如，您可以按如下方式传入参数映射(需要 Velocity 1.5 或更高):

#macro(myMacro $p)
  item 1: $p.param1
  item 2: $p.param2
#end

#set($params = {"param1" : "val1", "param2":"val2"})
#myMacro($params)

显示:

item 1: val1
item 2: val2

要处理可选参数，请在宏中使用#if 来检查参数。向 map 添加新元素有点困惑。由于 Java 方法“put”返回一个值，因此您必须使用#set 来处理返回值。 (否则它会显示在结果文本中)。

#macro(myMacro $p)
  #if(!$p.param1)#set($dummy = $p.put("param1", "default1"))#end
  #if(!$p.param2)#set($dummy = $p.put("param2", "default2"))#end
  #if(!$p.param3)#set($dummy = $p.put("param3", "default3"))#end

  item 1: $p.param1
  item 2: $p.param2
  item 3: $p.param3
#end

#set($params = {"param1" : "val1", "param2":"val2"})
#myMacro($params)

显示

item 1: val1
item 2: val2
item 3: default3