Skip to content

feat(TLoading): 对齐官方跨端契约(duration/axis 默认值、全屏蒙层、尺寸与 Demo) - #1031

Open
RSS1102 wants to merge 2 commits into
developfrom
rss1102/cnb-issue-70/feat/loading-contract-alignment-review
Open

feat(TLoading): 对齐官方跨端契约(duration/axis 默认值、全屏蒙层、尺寸与 Demo)#1031
RSS1102 wants to merge 2 commits into
developfrom
rss1102/cnb-issue-70/feat/loading-contract-alignment-review

Conversation

@RSS1102

@RSS1102 RSS1102 commented Aug 18, 2026

Copy link
Copy Markdown
Collaborator

🤔 这个 PR 的性质是?

勾选规则:
1.只要有新增参数,就勾选"新特性提交"
2.只修改内部bug,未新增参数,才勾选"日常 bug 修复"
3.其他选项视具体改动判断

  • 日常 bug 修复
  • 新特性提交
  • 文档改进
  • 演示代码改进
  • 组件样式/交互改进
  • CI/CD 改进
  • 重构
  • 代码风格优化
  • 测试用例
  • 分支合并
  • 其他

🔗 相关 Issue

(无关联 Issue)

💡 需求背景和解决方案

对标 TDesign 小程序 / Mobile Vue 官方 Loading,进行跨端契约对齐:

  1. duration 默认值2000ms → 800ms,对齐官方 duration 默认值,转圈动画速度加快。
  2. axis 默认方向Axis.vertical → Axis.horizontal(图标在左、文字在右),对齐官方 layout 默认;如需保留原竖向布局,请显式传入 axis: Axis.vertical
  3. 全屏蒙层TLoadingController.show 新增可选参数 overlay(复用 toast 的 TOverlayConfig),支持 showOverlay 渲染全屏半透明蒙层、preventTap 拦截背景点击;不传时行为与原先一致,向后兼容。
  4. 尺寸统一:circle 图标三档容器直径统一为 20/22/26,与 activity 及官方尺寸 demo 对齐。
  5. Demo 与文档:示例页新增"自定义图标"Demo;修正站点 README 的文件链接、API 表(axis/iconColor/textColor/duration 归入 TLoadingThemeData)及示例代码。

风险与验证说明:本环境无真机,尺寸/蒙层/间距对齐基于官方 CSS 数值与 Flutter 常量静态换算,真机像素表现仍需真机复核(未实测);colorScheme?.primary fallback 分支为既有边界未覆盖,不影响 ≥95% 覆盖率门槛。

📝 更新日志

  • breaking(TLoading): duration 默认值由 2000ms 调整为 800ms,转圈动画速度加快,对齐官方默认值

  • breaking(TLoading): 默认布局方向由 vertical(图标在上、文字在下)调整为 horizontal(图标在左、文字在右),对齐官方默认;如需保留原竖向布局请显式传入 axis: Axis.vertical

  • feat(TLoading): TLoadingController.show 新增 overlay 参数,支持全屏半透明蒙层与拦截背景点击

  • feat(TLoading): circle 图标三档尺寸统一为 20/22/26,与官方尺寸 demo 对齐

  • 本条 PR 不需要纳入 Changelog

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项⚠️

  • 标题遵循 Conventional Commits 格式:type(<scope>?): 修改描述
    示例:fix(TBottomTabBar): 修复 iconText 模式底部溢出
  • "相关 Issue"处带上修复的 Issue 链接或无关联 Issue
  • 已添加对应的 Spec 链接,或已由 Review 确认本次改动无需 Spec
  • 相关文档已补充或无须补充

@github-actions

Copy link
Copy Markdown
Contributor

完成

Web Demo

APK 下载

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant