一、所有註解

二、頁面註解

1、viewModel="@id(name) @init(expression)"

     explanation：用於設定ViewModel

      ◆ 一個擁有apply="org.zkoss.bind.BindComposer"屬性的元件可以使用這個註解，如果沒有這個註解，那麼這個元件將會被設定到一個composer上。

      ◆ expression：如果它被賦予一個Class，那麼這個Class將建立一個ViewModel例項

2、comp-attribute="@load(expression)"

     explanation：單向繫結。用來載入屬性的表示式

      ◆ 使用者可以在表示式中指定繫結條件，通過引數before和after來設定。例如@load(vm.filter,after='myCommand')，這表示Binder會在執行完command方法myCommand之後載入這個屬性

      ◆可以指定多個command

     

3、comp-attribute="@save(expression)"

     explanation：單向繫結。儲存元件的屬性值到ViewModel屬性中的表示式。

     ◆ 使用者可以在表示式中指定繫結條件，通過引數before和after來設定。例如：@save(vm.filter,before='myCommand')

，這表示Binder會在執行command方法myCommand之前儲存這個屬性到ViewModel

4、comp-attribute="@bind(expression)"

     explanation：雙向繫結。在元件的屬性和ViewModel的屬性之間實現雙向繫結，它不支援條件繫結，也就是說在繫結時不能使用條件。

     ◆ 它等同於@load(expression)@save(expression)

     ◆ 如果元件的屬性不支援@save的話，Binder將會自動忽略它

     ◆ 例子：對於表示式e.f.g.h，如果任何一個通知說e.f.g.h、e.f.g、e.f或者e被改變了，那麼元件的屬性將會被重新載入

5、@converter(expression, arg = arg-expression)

     explanation：為繫結提供一個轉換器conveter

    ◆ 如果expression是一個ZK提供的conveter，那麼它將會直接被使用

    ◆ 如果expression是一串字元，那麼它將會從ViewModel中查詢相應的getConveter方法，方法的名字為get+expression返回值為Conveter。

6、comp-event="@command(expression, arg =another-expression)"

     explanation：繫結到相應的事件command方法

    ◆ expression必須是ViewModel中的一個command方法的名字

    ◆ 事件被觸發時，它將會按照ZK Bind Lifecycle來執行這個command方法

三、ViewModel註解

1、@NotifyChange on setter

     explanation：通知(notify)Binder該屬性的值被改變

    ◆ 當呼叫了屬性的setter方法之後，它將會通知(notify)Binder該屬性的值被改變了。它是預設開啟的，在屬性的setter方法上你可以省略不寫這個註解

2、@NotifyChange on command method

     explanation：用於command方法上

    ◆ @NotifyChange(expression)、@NotifyChange({expression1,expression2,……})

3、@NotifyChangeDisabled on setter

     explanation：使setter方法預設開啟的@NotifyChange關閉

4、@Command('commanName')

     explanation：commandName是可選的，如果不指定的話，command方法的名字預設就是它所註解的方法的名字

四、引數註解

1、@BindingParam(“keyString”)

描述：傳遞command方法的引數

功能：Binder可以通過@BindingParam註解中指定的字串來獲取ZUL頁面上繫結的內容

2、@QueryParam("keyString")

描述：傳遞一個方法的引數，這個方法可以是一個command方法，也可以是一個@Init方法。

功能：Binder可以通過@QueryParam中指定的字串在HTTP請求中得到傳遞到ViewModel中的引數

3、@HeaderParam("keyString")

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：Binder可以通過@HeaderParam中指定的字串在HTTP請求中得到傳遞到ViewModel中的引數。與@QueryParam類似

4、@CookieParam("keyString")

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：從HTTP 請求cookie中獲得引數。

5、@ExecutionParam("keyString")

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：獲得當前Excursion設定的Attribute值。

executionparam-inner.zul：

6、@ExecutionArgParam("keyString")

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：獲得當前Execution的argument

7、@ScopeParam("keyString")  或  @ScopeParam(scopes=Scope.APPLICATION, value="keyString")

enum Scope{ COMPONET, SPACE, PAGE, DESKTOP, SESSION, APPLICATION, AUTO}  //對應“元件，空間，頁面，桌面，會話，應用，自動”

預設是AUTO，按COMPONENT-->SPACE-->PAGE-->DESKTOP-->SESSION-->APPLICATION的順序一個個查詢，直到找到不為空的值。

如果限定了Scope，則只會查詢特定的Scope。

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：在指定的Scope中查詢引數。

8、@SelectorParam("#componentId")  、 @SelectorParam("tagName")  、@SelectorParam(".className")  、@SelectorParam(":root")  、

      @SelectorParam("window > button")  、@SelectorParam("button[ label= ' Submit ' ] ")

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：從繫結的元件中獲取引數。通過Selectors根據value值查詢元件。

【通過標籤名"label"，取得所有Label元件】

9、@ContextParam(ContextType.XXX)

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：告訴繫結器傳遞指定型別的上下文物件。
enum ContextType { BIND_CONTEXT,  //BindContext instance BINDER,        //Binder instance TRIGGER_EVENT, //Event that trigger the command (since 6.0.1) COMMAND_NAME,  //Command name (since 6.0.1) EXECUTION,     //Execution instance COMPONENT,     //Component instance of current binding SPACE_OWNER,   //IdSpance instance of spaceOwner of current component VIEW,          //the view component of binder PAGE,          //Page instance of current component DESKTOP,       //Desktop instance of current component SESSION,       //Session instance APPLICATION    //Application instance }

10、@Default(“defaultValue”)

描述：傳遞一個方法的引數，可以應用到@Init方法和command方法上。

功能：當繫結引數為空時使用指定的預設值。可以將該註解應用在其他引數相關注解之後，如果第一個註解取到空，則使用該註解指定的預設值。

點選第一個按鈕，arg2為100；點選第二個按鈕，arg為3。

四、@Wire