spz-action-macro

何时使用

spz-action-macro 用于创建可复用的 action 序列,并控制它们的执行顺序。

支持布局

  • logic

使用方式

每个 action 宏需要一个 idarguments 定义。通过 id 调用宏并传入参数来改变其行为。

<spz-carousel id="carousel" ...>...</spz-carousel>
<spz-action-macro
  id="carousel-macro"
  execute="carousel.goToSlide(index=foo), carousel.goToSlide(index=bar)"
  arguments="foo, bar"
></spz-action-macro>
<button @tap="carousel-macro.execute(foo=1, bar=2)">
  先跳到 slide 1 再跳到 slide 2
</button>

属性

属性名说明类型是否必需
id宏的唯一标识符。调用宏时通过此 ID 引用string
arguments逗号分隔的参数变量名,可在 action 表达式中被替换string

Actions

execute

执行宏的 action 表达式。元素上的 execute 属性定义了要执行的 action,参数占位符会被调用时传入的值替换。

参数:arguments 属性定义。每个参数名即为命名参数。

示例:

<spz-action-macro
  id="my-macro"
  execute="target.show;target2.toggleClass(class=foo)"
  arguments="foo"
></spz-action-macro>
<button @tap="my-macro.execute(foo='highlight')">执行宏</button>

注意事项

  • execute 属性定义的是 action 表达式模板,本身不是一个 action。
  • 该组件不派发自定义事件。