状态和通知
上次修改时间: 2015年3月9日
适用范围: SharePoint Foundation 2010
Microsoft SharePoint Foundation 在页面上包含一个状态栏和一个通知区。这两个区域以不打扰用户的方式提供上下文消息。状态消息和通知均通过使用 ECMAScript(JavaScript、JScript)对象模型进行控制。
状态栏
状态栏用于显示永久性信息,例如页面状态或版本。它在服务器功能区下面显示为条状,并且有四种预定义的背景颜色,代表不同的重要性级别。状态栏可包含多条信息,但只会反映重要性或优先级最高的颜色。状态栏中的消息是 HTML,可包含链接或视觉元素。下表说明了颜色值及其重要性级别。
值 |
优先级 |
---|---|
红色 |
非常重要 |
黄色 |
重要 |
绿色 |
成功 |
蓝色 |
信息 |
使用 JavaScript 和服务器对象模型可访问状态栏。在服务器端,可使用 SPPageStatusSetter 类添加状态消息。在客户端上,可使用 SP.UI.Status.addStatus 添加状态消息。您可以使用 SP.UI.Status.updateStatus、SP.UI.Status.removeStatus、SP.UI.Status.setStatusPriColor 和 SP.UI.Status.removeAllStatus 操纵状态消息。
![]() |
---|
使用 SP.UI.Status.removeAllStatus 应谨慎。此方法将删除从代码外部添加的状态消息。 |
通知
通知用于在页面上显示临时性消息,例如操作状态。通知显示在页面右侧功能区下面。默认情况下,通知消息显示 5 秒。向页面添加通知时,您可以指定希望该消息在页面上的保留时间超过 5 秒。通知中的消息是 HTML,可包含链接或视觉元素。通知是使用 JavaScript 对象模型添加的。您可以使用 SP.UI.Notify.addNotification 添加通知,使用 SP.UI.Notify.removeNotification 删除通知。