今天, 文章中的例子是一个较为综合性的例子, 编辑, 新建信息, 显示不同样式和处理字段等, 但主要还是为大家说明如何在 Repeater 当中为用户提示消息.

由于精力有限, 不能在多个博客中保证文章的同步, 可在如下地址查看最新内容, 请谅解:

请到 的 JQueryElement 示例下载一节下载示例代码

本文将详细的讲解如何在 Repeater 中提示消息, 比如数据下载成功, 字段内容不符合要求, 目录如下:

  * 准备

  * 设置 TipTemplate

  * 调用 showtip 函数

  * 设置 FieldMask 属性

  * 消息的时效性

 

 

准备

请先查看 或者准备一节的内容.

设置 TipTemplate

如果希望 repeater 可以显示一些提示信息, 则首先需要设置 TipTemplate 模板:

                @{tip,'第 ' + (++tipCount).toString() + ' 条消息:' + @}   
     

代码中, 使用了 @{<属性名>[,<属性表达式>]} 来绑定属性 tip, tip 表示需要显示文本. 这和字段的绑定是类似, 不同的是 # 表示字段, 而 @ 表示属性, 可以参考 . tip 的内容可能是来自于 showtip 函数, 也可能来自于 FieldMask 属性.

调用 showtip 函数

通过 <repeater 变量>.__repeater('showtip', '<提示消息>') 可以让 repeater 显示提示消息:

上面的示例中, 多处调用了 showtip 函数, 并传递需要显示的字符串, 在 Filled 属性中, 传递的则是 e.custom.message, 这是来自于服务器返回的消息.

设置 FieldMask 属性

FieldMask 本来是用于验证字段的, 但由于 FieldMask 中包含了错误提示, 所以 repeater 会在字段验证错误时, 显示这些提示:

代码中, FieldMask 被赋值为 mask 变量, 而 mask 中包含了用于验证的规则, 可以参考 的设置字段一节.

mask 中的 tip 可以是一个字符串, 表示验证失败的提示, 也可以是一个对象, 包含更具体的提示消息.

而消息的提示是有 repeater 自动完成的, 前提是设置了有效的 TipTemplate.

消息的时效性

当需要显示新的消息, 或者 repeater 重新绑定数据时, 原有的消息将被替换或隐藏. 编辑行, 跳转到下一页, 调用 fill 方法都可以使 repeater 重新绑定数据.

JQueryElement 是开源共享的代码, 可以在 页面下载 dll 或者是源代码.

实际过程演示: , 建议全屏观看.