Package org.zkoss.zul

Interface ClientConstraint

    • Method Detail

      • getClientConstraint

        java.lang.String getClientConstraint()
        Returns the JavaScript snippet that will be evaluated at client to return a validator, or null if no client constraint is supported. The validator is later used to validate an input.

        For example,

        String getClientConstraint() {
          return "new foo.MyValidator()";
        }

        Instead of return the snippet of JavaScript codes, it can return an instance of JavaScript string (enclosed with quotation), if the validator is zul.inp.SimpleConstraint.

        For example,

        String getClientConstraint() {
          return "'no empty'";
        }

        The validator could implement the validate, and showCustomError methods, and an optional property, serverValidate methods as follow. validate is required, while showCustomError and serverValidate are optional.

        String validate(Widget wgt, String value);
        Object showCustomError(Widget wgt, String errmsg);
        boolean serverValidate;

        Please refer to zul.inp.SimpleConstraint for details.

        Notice that CustomConstraint has the higher priority than ClientConstraint. In other words, ClientConstraint is ignored if both defined.

        Returns:
        the code snippet that will be evaluated at client to return a validator.
        Since:
        5.0.0
      • getClientPackages

        java.lang.String getClientPackages()
        Returns a list of packages separated by comma that ZK client engine has to load before evaluating getClientConstraint().

        For example,

        com.foo,com.foo.more
        Since:
        5.0.0