组件:气泡通知 (Toast Message)
Toast 组件是一种简短的、自动消失的通知,用于提供有关系统事件或用户操作的实时反馈。它被设计为高可见性但低干扰性,出现在应用程序内容之上,且不会中断用户的当前工作流。
解剖结构
Toast 由以下元素组成:
- 自定义消息 (Custom Message): 提供清晰、简洁反馈给用户的动态字符串。
- 时间戳 (Timestamp): 记录事件触发的准确时间,辅助进行按时间顺序的追踪。
- 关闭图标 (Close Icon): 一个自定义的可交互元素,允许用户手动关闭通知。
属性 (CoDeSys)
在实现该组件时,使用以下属性来定义其内容和行为:
| 属性 (Property) | 类型 (Type) | 描述 (Description) |
|---|---|---|
message |
string |
显示在 Toast 主体中的主要文本内容。 |
icon |
string |
用于关闭操作的视觉资源的标识符。 |
duration |
number |
Toast 自动消失前的持续时间(以毫秒为单位)。 |
使用示例:
使用指南
消息配置
Toast 消息以 string(字符串)形式提供。为了保持组件的非侵入性,消息应保持简短。建议避免在此字符串中使用复杂的格式,以确保用户能一目了然地快速阅读。
行为与持久性
- 自动失效 (Auto-Expiry): 该组件遵循由
duration属性定义的生命周期。一旦时间耗尽,Toast 将自动动画化消失。如果将duration设置为 0,Toast 将无限期显示,直到用户手动将其关闭。 - 手动关闭: 关闭图标 为用户提供了一个立即清除通知的备选方案,确保界面始终处于用户的控制之下。
CSS 变量
可以重新分配以下 CSS 变量来自定义 Toast 的外观:
--toast-bg
--toast-accent-color
--toast-border
--toast-height
--toast-width
--toast-padding
--toast-font-size
--toast-font-color
--toast-icon-color
--toast-icon-size
--toast-bg
--toast-accent-color
--toast-border
--toast-height
--toast-width
--toast-padding
--toast-font-size
--toast-font-color
--toast-icon-color
--toast-icon-size
duration
duration
string
number
duration
string
icon
string
message

