Skip to content

feat(TMessage): 补齐官方 Demo 矩阵并同步站点文档与图标间距 - #1035

Open
RSS1102 wants to merge 3 commits into
developfrom
rss1102/cnb-issue-71/feat/message-contract-alignment-review
Open

feat(TMessage): 补齐官方 Demo 矩阵并同步站点文档与图标间距#1035
RSS1102 wants to merge 3 commits into
developfrom
rss1102/cnb-issue-71/feat/message-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

💡 需求背景和解决方案

以 TDesign 小程序 Message 官方实现为基线,对 Flutter TMessage 进行跨端对齐,补齐公开 Demo 矩阵、同步生成代码与站点文档,并修复一处像素级视觉差异。

  1. 补齐官方 Demo 矩阵example/lib/page/t_message_page.dart):按官方分组逐一补齐并一一对应——组件类型(纯文字 / 带图标 / 带关闭 / 可滚动跑马灯 / 带按钮链接 / 组件声明式调用)、组件风格(普通 / 成功 / 警示 / 错误 4 主题)、关闭所有通知(打开多个 / 关闭所有)。
  2. 同步生成代码:新增 example/assets/code/message.*.txt 12 个片段,删除失效的 message._marquee.txt,与示例页保持一致。
  3. 站点文档对齐现网 APItdesign-site/docs/components/message/README.md):示例代码与 API 表格统一为 TMessage.show / TMessageVariant / TMessageLink / TMessageMarquee / showIcon / showCloseButton / onCloseButtonPressed / onLinkPressed,移除已废弃 API 写法。
  4. 像素级视觉对齐:图标与文本间距由 10px 调整为官方 @spacer(8px),并同步 marquee 文本可用宽度计算(30→28)。仅内部视觉微调,未新增 / 未删除 / 未重命名任何公共 API。
  5. 补充组件测试t_message_test.dart):覆盖图标-文本间距、纯文字无图标、多消息叠加与句柄关闭、声明式 visible 切换。

相关 Spec:specs/007-message-contract-alignment/

验证状态

  • Spec acceptance 记录(提交 f5ec47d3):flutter analyze --fatal-infos(Flutter 3.32.0 与 3.47.0)均 0 error / 0 warning;test/components/message/t_message_test.dart 25/25 通过;lib/src/components/message/ 行覆盖率 98.21%(LH=220 / LF=224);codegen --check 通过。
  • 分支最终提交 91a64290(多消息示例相互覆盖修复)晚于上述记录,最终态 CI / analyze / test 重跑待确认。
  • 仍需人工/真机验证(未完成):默认定位(距顶 80px 居中卡片 vs 官方贴顶全宽条带)、阴影(Material elevation vs 官方 shadow token)、图标尺寸(Flutter 20×22 vs 官方 22px)。
  • Golden 快照未包含:按组件对齐 Review 标准,新增公开 Demo 尚缺逐项 Golden 快照,该项未完成。

📝 更新日志

  • fix(TMessage): 图标与文本间距对齐官方规范,由 10px 调整为 8px

  • 本条 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