refactor(popup): 收敛蒙层配置到 TPopupOverlayConfig 并对齐圆角与动画时长 - #1037
Open
RSS1102 wants to merge 7 commits into
Open
Conversation
- 新增公开类 TPopupOverlayConfig(showOverlay/color/opacity/preventTap/closeOnClick/onClick) - TPopupOptions 移除 showOverlay/closeOnOverlayClick/overlayColor/overlayOpacity/modal/onOverlayClick 六个散参 - 新增可选参数 overlay(默认 null 时行为与现状一致) - showOverlay 与 preventTap 解耦,支持显示蒙层但不拦截交互 - ActionSheet/Dialog/Drawer 适配新 API - 更新测试与文档
- t_popup_types.dart: comment_references 告警,TOverlayConfig 不在作用域内,改用反引号 - 测试中 TPopupOptions 及其内部构造改用 const(prefer_const_constructors)
- 新增「组件示例」:带标题及操作、自定义关闭按钮 - 新增「嵌套弹窗」Demo - 同步生成 example/assets/code 示例片段 - 重写 tdesign-site/docs/components/popup/README.md: 对齐现网 API(onPressed/variant/colorScheme)与真实 Demo,移除旧版残留
- BorderRadius 局部变量补空判断以消除 unchecked_use_of_nullable_value - 用 Navigator.of(...).pop() 替代 tester.widget<NavigatorState> 关闭浮层 - 断言路由动画时长前转换为 TransitionRoute - BorderRadius.horizontal 补 const 关键字
BorderRadiusGeometry 无 topLeftRadius 等属性,需先经 resolve(TextDirection.ltr) 解析为具体 BorderRadius 后再判断内缘圆角,修复 flutter latest 下 analyze 报错。
Contributor
Web DemoAPK 下载 |
Open
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.

🤔 这个 PR 的性质是?
🔗 相关 Issue
💡 需求背景和解决方案
收敛 Popup 蒙层散参。
TPopupOptions上showOverlay、closeOnOverlayClick、overlayColor、overlayOpacity、modal、onOverlayClick六个字段散落于构造器与各命名工厂,签名膨胀且与 Toast 的TOverlayConfig命名割裂。本次新增公开类TPopupOverlayConfig,将这些参数统一收敛为单个overlay参数,并保持showOverlay与preventTap解耦;ActionSheet / Dialog / Drawer 同步适配新 API。跨端 UI 对齐:left/right 默认无圆角(对齐官方全高矩形),保留通过
TPopupThemeData.panelRadius/TPopupOptions.radius自定义圆角能力;默认动画时长由 240ms 调整为 300ms,与官方及其他浮层组件对齐。补充组件示例(带标题及操作、自定义关闭按钮、嵌套弹窗),重写站点 Popup 文档与 API 文档。
关联 Spec:
specs/007-popup-overlay-config/specs/008-popup-radius-duration-alignment/📝 更新日志
breaking(popup):
TPopupOptions蒙层配置收敛为TPopupOverlayConfig,原showOverlay/closeOnOverlayClick/overlayColor/overlayOpacity/modal/onOverlayClick六个参数迁移到overlay配置项,请按新 API 调整既有调用breaking(popup): left/right 默认无圆角(对齐官方全高矩形)、默认动画时长由 240ms 调整为 300ms;如需 left/right 圆角可显式设置
radius或TPopupThemeData.panelRadius本条 PR 不需要纳入 Changelog
☑️ 请求合并前的自查清单
type(<scope>?): 修改描述。示例:
fix(TBottomTabBar): 修复 iconText 模式底部溢出