底部提示条使用指导

底部提示条使用指导

不可见组件：在屏幕底部弹出一条提示，可以带一个按钮（如「撤销」「重试」「查看」），几秒后自动收起。和对话框的「显示警告」相比，它多一个可点的按钮；又不像确认框那样挡住页面、打断操作。

快速上手：删除后可撤销

各案例独立使用；组合到同一屏幕时，将同名事件的处理合并到一个事件积木中。

global items = ["买菜", "交电费", "取快递"]
global deleted = ""

when Screen1.Initialize() {
  列表显示框1.Elements = items
}

when 列表显示框1.AfterPicking() {
  deleted = 列表显示框1.Selection
  listRemove(items, 列表显示框1.SelectionIndex)
  列表显示框1.Elements = items
  底部提示条1.ShowWithAction(join("已删除：", deleted), "撤销")
}

when 底部提示条1.ActionClicked() {
  listAdd(items, deleted)
  列表显示框1.Elements = items
}

网络断开提示：显示时长设为 0，提示会一直显示，网络恢复后调用 底部提示条1.Dismiss() 关掉。

搭建与测试

在设计器拖入本组件和案例涉及的按钮、标签、布局等组件，按案例中的名称重命名。先运行最小案例，确认事件返回，再增加业务逻辑。示例中的素材先上传到项目，服务器地址、令牌、文件路径换成自己的值。

可见组件需要有非零宽高；不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣；涉及系统入口或权限的行为还要编译安装后验证。

案例：持续显示再主动关闭

放底部提示条、显示和关闭按钮。Duration 为 0 时持续显示，适合网络断开提示。

when 按钮_显示.Click() {
  底部提示条1.Duration = 0
  底部提示条1.Show("网络连接已断开")
}
when 按钮_关闭.Click() {
  底部提示条1.Dismiss()
}

提示条叠在当前界面上，不会替你重试业务操作；带操作按钮的案例在 ActionClicked 中执行真正的业务。

属性、方法与事件速查

完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途；有完成事件的方法在事件中读取结果。

入口	用途
按钮颜色（`ActionColor`）	按钮文字颜色，默认琥珀色。
背景颜色（`BackgroundColor`）	提示条底色，默认深灰。
显示时长（`Duration`）	显示多久后自动收起（毫秒），默认 3000；0 表示一直显示，直到点按钮或调用「关闭」。
显示中（`Showing`）	提示条是否正在显示。
文本颜色（`TextColor`）	提示文字颜色，默认白色。
关闭（`Dismiss`）	立即关闭提示条。
显示（文本）（`Show`）	显示一条提示，「显示时长」后自动收起。已有提示条时替换它。
显示带按钮的提示（文本，按钮文字）（`ShowWithAction`）	显示一条带按钮的提示（按钮文字如「撤销」），用户点按钮触发「按钮被点击」并收起。
按钮被点击（`ActionClicked`）	用户点了提示条上的按钮。
已收起（`Dismissed`）	提示条收起时触发（到时自动收起、调用「关闭」或点了按钮）；被新的提示替换时不触发。

常见问题与验收

检查项	操作与预期
初始化	对照案例检查是否已经调用加载、注册、连接或显示方法；仅拖入组件不会替你执行这些步骤。
结果返回	将成功事件和失败事件都接到标签，记录事件参数；异步操作完成前不读取结果属性。
输入配置	检查素材名大小写、网址是否为直接资源地址、文件是否存在、编号和索引是否在范围内。
平台与权限	按组件参考中的平台说明测试；授权被拒绝时应有明确提示，不继续假定操作成功。
最小案例	先验证页面中的最小案例，再验证第二个场景；重复操作、取消、返回屏幕后结果应符合事件说明。

完整 .aia 源码与操作指导

下载 .aia 源码

无网络和账号依赖。通过删除收藏与撤销演示真实提示条操作；删除只改示例内存状态。时长单位毫秒，配色采用高对比文字，底部按钮支持撤销。

导入 SnackbarAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。

API / 功能	操作入口	预期结果
Duration / BackgroundColor / TextColor / ActionColor / Showing 读取	点读取	显示当前四个设置及是否显示
Show	点提示	出现普通提示，按设置时长收起
ShowWithAction / ActionClicked	点删除，在提示条点撤销	收藏删除后恢复，实际按钮事件计数增加
重复操作	超时后点恢复示例收藏	恢复为已收藏，可再次删除与撤销
Dismiss / Dismissed	点关闭或等超时	提示条收起，事件计数增加，显示状态变假
Duration 设置	输入5000等有效值，应用后再显示	新提示使用新时长，拒绝非数字和范围外输入
三个颜色属性设置	点配色后显示带按钮提示	实际背景／文字／按钮颜色变化

所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。