前端跨平台桌面应用移动开发【免费下载链接】fletBuild realtime web, mobile and desktop apps in Python only. No frontend experience required.项目地址https://gitcode.com/gh_mirrors/fl/flet点击查看免费下载本文面向正在升级到 Flet 0.85.0 及以上的开发者系统讲解DragTargetEvent旧坐标字段x、y、offset为何被弃用、如何迁移到新的local_position与global_position字段并结合仓库源码与官方示例帮助你写出坐标语义明确、无弃用警告的拖放代码。背景坐标语义不明确的旧字段在 Flet 0.85.0 之前DragTargetEvent提供了x、y和offset三个字段来上报拖放指针的位置。问题在于这三个字段没有明确声明它们所处的坐标系——它们究竟是相对于DragTarget控件边界target-relative还是相对于整个页面page-level开发者只能靠猜测或翻阅实现细节才能确定这在实际编码中很容易造成坐标换算错误。Flet 0.85.0 正是为了解决这一歧义弃用了这三个旧字段并引入两个语义清晰的新字段新字段坐标系语义DragTargetEvent.local_positiontarget-relative指针相对于DragTarget目标控件边界的坐标DragTargetEvent.global_positionpage-level指针在页面全局坐标系中的坐标迁移指南一行代码的等价替换迁移前旧写法def on_accept(event: ft.DragTargetEvent): target_x event.x target_y event.y target_position event.offset迁移后新写法def on_accept(event: ft.DragTargetEvent): target_x event.local_position.x target_y event.local_position.y target_position event.local_position如果你的业务需要的是页面级坐标则将上述代码中的local_position替换为global_positiondef on_accept(event: ft.DragTargetEvent): page_x event.global_position.x page_y event.global_position.y page_position event.global_position旧字段x、y、offset与新的local_position、global_position均为Offset二维向量类型或其分量因此迁移本质上是字段名的一一映射不涉及数据类型转换。从源码理解两个坐标系的底层实现Python 侧事件负载的数据结构在 drag_target.py 中DragTargetEvent是一个 dataclass其定义如下节选dataclass class DragTargetEvent(Event[DragTarget]): src_id: Optional[int] src: Draggable field(initFalse) local_position: Offset field(metadata{data_field: l}) # Pointer position relative to the target bounds. global_position: Offset field(metadata{data_field: g}) # Pointer position in the global coordinate space. def __post_init__(self): if self.src_id is not None: self.src cast(Draggable, self.page.get_control(self.src_id))几个值得注意的实现细节字段序列化键local_position对应传输层数据键lglobal_position对应g见data_field元数据。这样的事件负载结构同时在 Flutter 侧生成见下文。src_id与srcsrc_id是拖拽源Draggable控件的 ID可能为Nonesrc属性在__post_init__中通过page.get_control(src_id)解析为实际的Draggable控件实例方便在回调中直接访问源控件。Offset类型两个位置字段均为Offset对象通过.x、.y访问分量或直接使用整个Offset对象如用于设置控件坐标。Flutter 侧坐标如何被计算出来在 drag_target.dart 中Dart 端的DragTargetEvent与 Python 端一一对应class DragTargetEvent { final int srcId; final Offset localPosition; final Offset globalPosition; // ... MapString, dynamic toMap() String, dynamic{ src_id: srcId, l: {x: localPosition.dx, y: localPosition.dy}, g: {x: globalPosition.dx, y: globalPosition.dy}, }; }坐标的计算逻辑位于同一文件的_getLocalPosition方法中drag_target.dartOffset _getLocalPosition(BuildContext? context, Offset globalPosition) { final renderObject context?.findRenderObject(); if (renderObject is! RenderBox || !renderObject.hasSize) { return globalPosition; } return renderObject.globalToLocal(globalPosition); }这揭示了两个坐标系的确切定义global_position直接取自 FlutterDragTargetDetails.offset即拖放指针在页面全局坐标系中的位置local_position是通过RenderBox.globalToLocal(globalPosition)将全局坐标换算到DragTarget自身 RenderBox 坐标系即目标控件边界的结果当目标控件尚未完成布局renderObject不是RenderBox或没有尺寸时会回退为全局坐标。也就是说local_position天然就是以DragTarget左上角为原点的坐标这正是旧字段x/y想要表达却未言明的语义。理解了这条调用链你就能在迁移后自信地判断需要相对于目标盒子的坐标用local_position需要相对页面的坐标用global_position。实战示例在拖放回调中展示两种坐标仓库官方示例 drag_target_positions/main.py 完整演示了新 API 的用法——在on_move和on_accept中同时刷新local_position与global_position的显示import flet as ft def main(page: ft.Page): def refresh_position(e: ft.DragTargetEvent): lp_label.value ( flocal_position: ({e.local_position.x:.1f}, {e.local_position.y:.1f}) ) gp_label.value ( fglobal_position: ({e.global_position.x:.1f}, {e.global_position.y:.1f}) ) target.update() def handle_move(e: ft.DragTargetEvent): refresh_position(e) def handle_accept(e: ft.DragTargetEvent): refresh_position(e) # ... target : ft.DragTarget( groupdemo, on_will_accepthandle_will_accept, on_movehandle_move, on_accepthandle_accept, on_leavehandle_leave, contentft.Container( # ... contentft.Column( controls[ ft.Text(Drop here, size16, weightft.FontWeight.BOLD), lp_label : ft.Text(local_position: -), gp_label : ft.Text(global_position: -), ], ), ), ) if __name__ __main__: ft.run(main)该示例还展示了与DragTargetEvent配套的另外两个事件负载类型均定义在 drag_target.pyDragWillAcceptEventon_will_accept回调的负载含src_id、src和accept目标是否接受拖拽DragTargetLeaveEventon_leave回调的负载仅含src_id/src因为拖拽离开时无需上报坐标。DragTarget控件的完整事件集为on_will_accept、on_accept、on_leave、on_move其中on_accept和on_move使用带坐标的DragTargetEvent。旧坐标字段的迁移仅影响这两个回调。时间线与完整移除计划阶段版本说明弃用0.85.0x、y、offset被标记为弃用代码中仍可使用移除1.0.0三个旧字段被正式删除必须使用新字段Flet 1.0.0 的移除清单removed-deprecated-apis.md中明确记录了本次移除的映射关系RemovedReplacementDragTargetEvent.x/.yDragTargetEvent.local_positionDragTargetEvent.offsetDragTargetEvent.global_position注意一个细节移除表中offset的替换目标是global_position而 0.85.0 弃用文档的示例中target_position event.offset被替换为event.local_position。这说明旧offset字段的实际语义与local_position等价示例按目标内相对坐标这一最常见用法迁移而官方移除表则按字段名对齐给出了global_position的映射。如果你的旧代码明确把offset当作页面级坐标使用请迁移到global_position若当作目标内坐标使用则迁移到local_position——务必根据旧代码的实际语义选择。升级检查清单全局搜索event.x、event.y、event.offset以及e.x、e.y、e.offset逐一确认是否属于DragTargetEvent判断旧代码中这些坐标的实际使用场景相对目标控件定位 →local_position相对页面定位 →global_position批量替换后运行应用并手动拖放验证坐标方向与量级正确升级到 1.0.0 前可用如下命令运行应用以暴露所有DeprecationWarning来自 removed-deprecated-apis.mdpython -W default::DeprecationWarning main.py参考资料弃用声明原文deprecated-drag-target-event-coordinates.mdPython 事件负载与DragTarget控件实现drag_target.pyFlutter 侧坐标计算与事件序列化drag_target.dart官方坐标演示示例drag_target_positions/main.py更多拖放示例drag_and_drop_containers/main.py、drag_and_drop_containers_declarative/main.py1.0.0 移除清单removed-deprecated-apis.md破坏性变更索引breaking-changes/index.md赞分享前端跨平台桌面应用移动开发【免费下载链接】fletBuild realtime web, mobile and desktop apps in Python only. No frontend experience required.项目地址https://gitcode.com/gh_mirrors/fl/flet点击查看免费下载相关推荐kustomize vars 字段详解变量替换机制、弃用说明与 replacements 迁移实战kustomize vars 字段详解变量替换机制、弃用说明与 replacements 迁移实战 本篇技术指南围绕 kustomize 的 vars 字段展CLI开发工具云原生ESP-IDF 5.3 迁移指南Bluetooth Classic 设备名 API 弃用与替换方案ESP IDF 5.3 迁移指南Bluetooth Classic 设备名 API 弃用与替换方案 导读 本文围绕 ESP IDF 5.3 版本迁移指南中关于物联网嵌入式Hydra 0.11 到 1.0 迁移strict 模式弃用与新增字段的完整替代方案Hydra 0.11 到 1.0 迁移strict 模式弃用与新增字段的完整替代方案 本文是 Hydra 从 0.11 升级到 1.0 的迁移指南之一聚焦于开发工具后端CLI上一篇DEX-Arbitrage配置文件详解如何自定义路由器、代币与交易路径下一篇Pillar Valley游戏架构深度解析Expo Three.js的完美结合创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考