组件动画使用指导
组件动画是一个不可见工具组件。它使用 Android 原生属性动画，不依赖 Flubber 等第三方库， 动画只改变透明度、位移、缩放和旋转，不会反复重排界面。
最常用的操作只有一块积木：启动(组件, 动画类型)。动画类型是下拉选项，不用背英文名称。 默认播放 500 毫秒、无延迟、不重复；需要时再修改属性。
联机调试需要使用包含该组件的新版本 AI 伴侣。安卓与鸿蒙都支持，积木写法相同；鸿蒙上滑入滑出的距离取组件设定的宽高（自动或充满时按 120 像素）。
快速上手
界面：拖入 按钮1、一个 垂直布局1（里面放几个标签当作卡片内容），再拖一个组件动画（默认名 组件动画1）。
让按钮被点击时弹一下：
when 按钮1.Click() {
组件动画1.Start(按钮1, "pop")
}
让卡片从屏幕左侧淡入：
when Screen1.Initialize() {
组件动画1.Duration = 650
组件动画1.Start(垂直布局1, "slideInLeft")
}
同一组件还在播放时再次启动，旧动画会自动取消，新动画从组件原始状态开始， 因此连续点击不会让位移或缩放越积越大。
动画类型
| 用途 | 可选动画（括号内为代码里的取值） |
|---|---|
| 出现 | 淡入 fadeIn、放大进入 zoomIn、从左/右/上/下滑入 slideInLeft / slideInRight / slideInUp / slideInDown |
| 消失 | 淡出 fadeOut、缩小退出 zoomOut、向左/右/上/下滑出 slideOutLeft / slideOutRight / slideOutUp / slideOutDown |
| 强调 | 呼吸 pulse、弹出 pop、弹跳 bounce、抖动 shake、晃动 wobble、摇摆 swing、橡皮筋 rubberBand |
| 变换 | 旋转 rotate、水平翻转 flipHorizontal、垂直翻转 flipVertical |
编辑器里动画类型直接从下拉选项里选中文名；本文代码块为了能直接复制，写成括号里的取值文本（如 "pop"），两种写法效果相同。
“出现”和“强调”动画结束后组件回到播放前的正常状态；“消失”动画会保留消失后的状态。
调用复位（组件）（Reset）可随时恢复组件第一次播放动画前的状态。
使用建议
- 点击反馈优先用“弹出”或“呼吸”，时长建议 180–300 毫秒。
- 页面元素进入可用“淡入”或“滑入”，时长建议 300–600 毫秒。
- 不要给很多大组件同时使用弹跳缓动，否则视觉上容易显得杂乱。
- “淡出、缩小退出、滑出”会让组件保持在退出状态；稍后要再次显示时，直接播放相应的进入动画即可。
完整 .aia 源码与操作指导
无需网络与硬件。22种动画和6种缓动均有中文选择入口。先选择参数并点应用，再点开始；淡出／退出结束后用复位恢复卡片。鸿蒙滑入滑出距离以设定尺寸计算。
导入 ComponentAnimationAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。
| API / 功能 | 操作入口 | 预期结果 |
|---|---|---|
| 五个设计器属性、Duration / StartDelay / RepeatCount / AutoReverse / Easing 读取与设置 | 修改输入、往返与缓动后点应用 | 显示实际属性；额外重复次数0代表只播放一次 |
| Start | 选择22种动画之一，点开始 | 卡片播放真实动画，开始前复位，避免上次淡出看不到 |
| IsAnimating | 点状态，在运行中和结束后对比 | 分别为真与假；延迟及往返会影响总等待时间 |
| Stop | 播放中点停止 | 停止继续变化，可能保留当前位置；可点复位 |
| Reset | 点复位 | 卡片恢复透明度、位置、大小与角度 |
| AnimationEnded | 等自然结束 | 显示目标、内部动画类型和计数；停止不当作自然完成 |
| 全部缓动 | 分别选择6种缓动、应用并开始 | 比较速度曲线；中文选项映射准确内部值 |
所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。
组件动画
导入方法：项目 → 导入项目（.aia）→ 选择下载的 .aia 源码文件。 无需网络与硬件。22种动画和6种缓动均有中文选择入口。先选择参数并点应用，再点开始；淡出／退出结束后用复位恢复卡片。鸿蒙滑入滑出距离以设定尺寸计算。 覆盖检查 20/20。首次载入及保存重开均0个错误，真实后台导入、安装包编译通过；真机／伴侣／硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。
扫码添加客服咨询
