DragTargetEvent 坐标字段已废弃

INFO

本指南以 Flet 0.85.0 为准，内容是最准确的。后续版本可能会新增 API 或增加额外的迁移路径。

破坏性变更与废弃索引列出了为每个版本编写的指南。

概述

Flet 0.85.0 废弃了 DragTargetEvent.x、DragTargetEvent.y 和 DragTargetEvent.offset。

请使用 [DragTargetEvent.local_position][flet.DragTargetEvent.local_position] 表示目标相对坐标，或使用 [DragTargetEvent.global_position][flet.DragTargetEvent.global_position] 表示页面级坐标。

背景

旧的 x、y 和 offset 字段没有明确其坐标空间。新的位置字段将目标相对坐标与全局坐标分开，这让拖放代码更易读、更少歧义。

迁移指南

迁移前代码：

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

如果你的代码需要页面级坐标，请使用 event.global_position.x、event.global_position.y 或 event.global_position。

时间线

• 废弃于：0.85.0
• 移除于：1.0.0

参考

• API 文档：[DragTargetEvent][flet.DragTargetEvent]
• 问题与 PR：#6387、#6401、#6693（移除）
• 发布说明：Flet 0.85.0