组件:气泡通知 (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