Skip to content

breaking(upload): 对齐小程序布局与上传状态契约 - #1047

Open
RSS1102 wants to merge 5 commits into
developfrom
rss1102/style/upload-miniprogram-alignment
Open

breaking(upload): 对齐小程序布局与上传状态契约#1047
RSS1102 wants to merge 5 commits into
developfrom
rss1102/style/upload-miniprogram-alignment

Conversation

@RSS1102

@RSS1102 RSS1102 commented Aug 23, 2026

Copy link
Copy Markdown
Collaborator

🤔 这个 PR 的性质是?

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

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

🔗 相关 Issue

Related: #1027

💡 需求背景和解决方案

当前 Upload 仅支持宫格布局,禁用态图片缺少小程序的遮罩,且无法区分“重新上传”和“上传失败”;Demo 的分组也没有对齐小程序官方示例。

  • 新增 TUpload.layout,通过 TUploadLayout.grid/list 表达宫格和列表布局,不引入小程序平台专属的拖拽、插槽和请求 API。
  • 新增 TUploadFileStatus.retryableError,与既有 error 分别渲染重试和失败状态;保留受控 filesonChangedonRetry 等 Flutter 调用方式。
  • 禁用态已有图片使用 token 派生的禁用遮罩;列表布局显示文件名、大小 / 状态信息和删除操作。
  • Demo 对齐“组件类型 / 组件状态 / 组件风格”三组,并按小程序隐私约定默认使用禁用态。
  • UI 变更已由 Upload Widget/Golden 测试和 Example 分组布局测试覆盖;待在 PR 预览环境补充人工截图复核。

Spec:specs/012-upload-contract-alignment

📝 更新日志

  • breaking(upload): 新增列表布局与 retryableError 状态,补齐禁用态文件视觉表现

  • 本条 PR 不需要纳入 Changelog

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

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

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

@github-actions

github-actions Bot commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

完成

Web Demo

APK 下载

@tencent-adm

Copy link
Copy Markdown
Member

CLA assistant check
Thank you for your submission, we really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ RSS1102
❌ autofix-ci[bot]
You have signed the CLA already but the status is still pending? Let us recheck it.

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.

2 participants