已移除被废弃的间距与边框辅助函数

INFO

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

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

概述

Flet 0.85.0 移除了 ft.margin、ft.padding、ft.border 和 ft.border_radius 中已被废弃的模块级辅助函数。请把模块级辅助函数调用替换为类方法：

已移除的辅助函数	替代方案
margin.all(...)	Margin.all(...)
margin.symmetric(...)	Margin.symmetric(...)
margin.only(...)	Margin.only(...)
padding.all(...)	Padding.all(...)
padding.symmetric(...)	Padding.symmetric(...)
padding.only(...)	Padding.only(...)
border.all(...)	Border.all(...)
border.symmetric(...)	Border.symmetric(...)
border.only(...)	Border.only(...)
border_radius.all(...)	BorderRadius.all(...)
border_radius.horizontal(...)	BorderRadius.horizontal(...)
border_radius.vertical(...)	BorderRadius.vertical(...)
border_radius.only(...)	BorderRadius.only(...)

背景

这些辅助函数被类方法取代，是为了让公开 API 与它们所创建的具名值类型保持一致。例如，Padding.all(...) 现在明确地返回一个 [Padding][flet.Padding] 值，而 BorderRadius.only(...) 返回 [BorderRadius][flet.BorderRadius] 值。

迁移指南

迁移前代码：

import flet as ft

card = ft.Container(
    padding=ft.padding.all(12),
    border=ft.border.all(1, ft.Colors.OUTLINE),
    border_radius=ft.border_radius.all(8),
)

迁移后代码：

import flet as ft

card = ft.Container(
    padding=ft.Padding.all(12),
    border=ft.Border.all(1, ft.Colors.OUTLINE),
    border_radius=ft.BorderRadius.all(8),
)

时间线

• 移除于：0.85.0

参考

• API 文档：[Border][flet.Border]、[BorderRadius][flet.BorderRadius]、[Padding][flet.Padding]
• 问题与 PR：#6425
• 发布说明：Flet 0.85.0