Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 16 additions & 3 deletions tdesign-component/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,21 @@
## 🌈 0.2.1 `2025-06-13`

## 🌈 0.2.3 `2025-07-09`
### 🚀 Features
- `TDPicker`: Supports prioritizing the retention of cascaded option values when switching @epoll-j ([#666](https://github.com/Tencent/tdesign-flutter/pull/666))
- `TDTable`: Supports default row selection @ccXxx1aoBai ([#665](https://github.com/Tencent/tdesign-flutter/pull/665))
- `TDCalendar`: Adds custom date cell functionality @epoll-j ([#667](https://github.com/Tencent/tdesign-flutter/pull/667))
- `TDForm`: Adds Form component @shizhe2018 @SimonWuZY ([#620](https://github.com/Tencent/tdesign-flutter/pull/620))
- `TDTable`: Separates TDTableCol attribute configuration and empty data configuration @ccXxx1aoBai ([#665](https://github.com/Tencent/tdesign-flutter/pull/665))

### 🐞 Bug Fixes
- `TDTable`: Fixes the issue with unselected icon display in table headers and the selection state problem under disabled conditions @ccXxx1aoBai ([#665](https://github.com/Tencent/tdesign-flutter/pull/665))
- `TDTable`: Fixes the empty data issue in tables @ccXxx1aoBai ([#671](https://github.com/Tencent/tdesign-flutter/pull/671))
- `TDDialog`: Fixes the issue where dialogs block the keyboard @jflin19990707 ([#669](https://github.com/Tencent/tdesign-flutter/pull/669))
- `TDCollapse`: Updates the demo page name for collapse @jflin19990707 ([#670](https://github.com/Tencent/tdesign-flutter/pull/670))
- `TDDropdownMenu`: Fixes the incorrect popup position calculation in nested routing scenarios @hcanyz ([#648](https://github.com/Tencent/tdesign-flutter/pull/648))


## 🌈 0.2.2 `2025-06-13`
### 🚀 Features
- `TDTable`: Added support for row selection and custom row height. @ccXxx1aoBai ([#594](https://github.com/Tencent/tdesign-flutter/pull/594))
- `TDTreeSelect`: Added partial multi-selection support. @epoll-j ([#587](https://github.com/Tencent/tdesign-flutter/pull/587))
- `TDCell`: Added support for custom height and bottom divider. @ccXxx1aoBai ([#611](https://github.com/Tencent/tdesign-flutter/pull/611))
Expand All @@ -11,7 +25,6 @@
- `TDAvatar`: Added custom BoxFit parameter. @shizhe2018 ([#633](https://github.com/Tencent/tdesign-flutter/pull/633))

### 🐞 Bug Fixes

- `TDDatePicker`: Fixed minute-level time display issue and optimized hour/minute/second range calculation logic. @epoll-j ([#585](https://github.com/Tencent/tdesign-flutter/pull/585))
- `TDSearchBar`: Added onTapOutside callback support. @cyjaysong ([#608](https://github.com/Tencent/tdesign-flutter/pull/608))
- `TDDropdownMenu`: Added support for modifying selected icon color. @jflin19990707 ([#631](https://github.com/Tencent/tdesign-flutter/pull/631))
Expand Down
36 changes: 18 additions & 18 deletions tdesign-component/example/assets/api/action-sheet_api.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,5 @@
## API
### TDActionSheetItem
#### 简介
动作面板项目
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| label | String | - | 标提 |
| textStyle | TextStyle? | - | 标题样式 |
| icon | Widget? | - | 图标 |
| badge | TDBadge? | - | 角标 |
| disabled | bool | false | 是否禁用 |
| iconSize | double? | - | 图标大小 |
| group | String? | - | 分组,用于带描述多行滚动宫格 |

```
```
### TDActionSheet
### TDActionSheet
#### 简介
动作面板
#### 默认构造方法
Expand Down Expand Up @@ -52,3 +35,20 @@
| showListActionSheet | | required BuildContext context, required List<TDActionSheetItem> items, TDActionSheetAlign align, String cancelText, bool showCancel, VoidCallback? onCancel, TDActionSheetItemCallback? onSelected, bool showOverlay, bool closeOnOverlayClick, VoidCallback? onClose, bool useSafeArea, | 显示列表类型面板 |
| showGridActionSheet | | required BuildContext context, required List<TDActionSheetItem> items, TDActionSheetAlign align, String cancelText, bool showCancel, TDActionSheetItemCallback? onSelected, bool showOverlay, bool closeOnOverlayClick, int count, int rows, double itemHeight, double itemMinWidth, bool scrollable, bool showPagination, VoidCallback? onCancel, String? description, VoidCallback? onClose, bool useSafeArea, | 显示宫格类型面板 |
| showGroupActionSheet | | required BuildContext context, required List<TDActionSheetItem> items, TDActionSheetAlign align, String cancelText, bool showCancel, TDActionSheetItemCallback? onSelected, bool showOverlay, bool closeOnOverlayClick, double itemHeight, double itemMinWidth, VoidCallback? onCancel, VoidCallback? onClose, bool useSafeArea, | 显示分组类型面板 |

```
```
### TDActionSheetItem
#### 简介
动作面板项目
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| label | String | - | 标提 |
| textStyle | TextStyle? | - | 标题样式 |
| icon | Widget? | - | 图标 |
| badge | TDBadge? | - | 角标 |
| disabled | bool | false | 是否禁用 |
| iconSize | double? | - | 图标大小 |
| group | String? | - | 分组,用于带描述多行滚动宫格 |
36 changes: 18 additions & 18 deletions tdesign-component/example/assets/api/calendar_api.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,22 @@
## API
### TDCalendarStyle
### TDCalendarPopup
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| context | BuildContext | context | 上下文 |
| top | double? | - | 距离顶部的距离 |
| autoClose | bool? | true | 自动关闭;在点击关闭按钮、确认按钮、遮罩层时自动关闭 |
| confirmBtn | Widget? | - | 自定义确认按钮 |
| visible | bool? | - | 默认是否显示日历 |
| onClose | VoidCallback? | - | 关闭时触发 |
| onConfirm | void Function(List<int> value)? | - | 点击确认按钮时触发 |
| builder | CalendarBuilder? | - | 控件构建器,优先级高于[child] |
| child | TDCalendar? | - | 日历控件 |

```
```
### TDCalendarStyle
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
Expand Down Expand Up @@ -58,20 +75,3 @@
| isTimeUnit | bool? | true | 是否显示时间单位 |
| animateTo | bool? | false | 动画滚动到指定位置 |
| cellWidget | Widget? Function(BuildContext context, TDate tdate, DateSelectType selectType)? | - | 自定义日期单元格组件 |

```
```
### TDCalendarPopup
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| context | BuildContext | context | 上下文 |
| top | double? | - | 距离顶部的距离 |
| autoClose | bool? | true | 自动关闭;在点击关闭按钮、确认按钮、遮罩层时自动关闭 |
| confirmBtn | Widget? | - | 自定义确认按钮 |
| visible | bool? | - | 默认是否显示日历 |
| onClose | VoidCallback? | - | 关闭时触发 |
| onConfirm | void Function(List<int> value)? | - | 点击确认按钮时触发 |
| builder | CalendarBuilder? | - | 控件构建器,优先级高于[child] |
| child | TDCalendar? | - | 日历控件 |
42 changes: 21 additions & 21 deletions tdesign-component/example/assets/api/cell_api.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,25 @@
## API
### TDCellStyle
### TDCellGroup
#### 简介
单元格组组件
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| key | | - | |
| bordered | bool? | false | 是否显示组边框 |
| theme | TDCellGroupTheme? | TDCellGroupTheme.defaultTheme | 单元格组风格。可选项:default/card |
| title | String? | - | 单元格组标题 |
| cells | List<TDCell> | - | 单元格列表 |
| builder | CellBuilder? | - | cell构建器,可自定义cell父组件,如Dismissible |
| style | TDCellStyle? | - | 自定义样式 |
| titleWidget | Widget? | - | 单元格组标题组件 |
| scrollable | bool? | false | 可滚动 |
| isShowLastBordered | bool? | false | 是否显示最后一个cell的下边框 |

```
```
### TDCellStyle
#### 简介
单元格组件样式
#### 默认构造方法
Expand Down Expand Up @@ -67,23 +87,3 @@
| imageCircle | double? | 50 | 主图圆角,默认50(圆形) |
| showBottomBorder | bool? | false | 是否显示下边框(建议TDCellGroup组件下false,避免与bordered重叠) |
| height | double? | - | 高度 |

```
```
### TDCellGroup
#### 简介
单元格组组件
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| key | | - | |
| bordered | bool? | false | 是否显示组边框 |
| theme | TDCellGroupTheme? | TDCellGroupTheme.defaultTheme | 单元格组风格。可选项:default/card |
| title | String? | - | 单元格组标题 |
| cells | List<TDCell> | - | 单元格列表 |
| builder | CellBuilder? | - | cell构建器,可自定义cell父组件,如Dismissible |
| style | TDCellStyle? | - | 自定义样式 |
| titleWidget | Widget? | - | 单元格组标题组件 |
| scrollable | bool? | false | 可滚动 |
| isShowLastBordered | bool? | false | 是否显示最后一个cell的下边框 |
128 changes: 64 additions & 64 deletions tdesign-component/example/assets/api/dialog_api.md
Original file line number Diff line number Diff line change
@@ -1,52 +1,47 @@
## API
### TDImageDialog
### TDAlertDialog
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| key | | - | |
| image | Image | - | 图片 |
| imagePosition | TDDialogImagePosition? | TDDialogImagePosition.top | 图片位置 |
| backgroundColor | Color | Colors.white | 背景颜色 |
| radius | double | 12.0 | 圆角 |
| title | String? | - | 标题 |
| titleColor | Color | const Color(0xE6000000) | 标题颜色 |
| titleAlignment | AlignmentGeometry? | - | 标题对齐模式 |
| contentWidget | Widget? | - | 内容Widget |
| content | String? | - | 内容 |
| contentColor | Color? | - | 内容颜色 |
| titleAlignment | AlignmentGeometry? | - | 标题对齐模式 |
| contentWidget | Widget? | - | 内容Widget |
| contentMaxHeight | double | 0 | 内容的最大高度,默认为0,也就是不限制高度 |
| leftBtn | TDDialogButtonOptions? | - | 左侧按钮配置 |
| rightBtn | TDDialogButtonOptions? | - | 右侧按钮配置 |
| leftBtnAction | Function()? | - | 左侧按钮默认点击 |
| rightBtnAction | Function()? | - | 右侧按钮默认点击 |
| showCloseButton | bool? | - | 显示右上角关闭按钮 |
| padding | EdgeInsets? | - | 内容内边距 |
| buttonStyle | | TDDialogButtonStyle.normal | |
| padding | EdgeInsets? | const EdgeInsets.fromLTRB(24, 32, 24, 0) | 内容内边距 |
| buttonWidget | Widget? | - | 自定义按钮 |

```
```
### TDDialogButtonOptions
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| title | String | - | 标题内容 |
| action | Function()? | - | 点击操作 |
| titleColor | Color? | - | 标题颜色 |
| titleSize | double? | - | 字体大小 |
| style | TDButtonStyle? | - | 按钮样式 |
| type | TDButtonType? | - | 按钮类型 |
| theme | TDButtonTheme? | - | 按钮类型 |
| height | double? | - | 按钮高度 |
| fontWeight | FontWeight? | - | 字体粗细 |
#### 工厂构造方法

| 名称 | 说明 |
| --- | --- |
| TDAlertDialog.vertical | 纵向按钮排列的对话框

[buttons]参数是必须的,纵向按钮默认样式都是[TDButtonTheme.primary] |

```
```
### TDConfirmDialog
### TDImageDialog
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| key | | - | |
| action | Function()? | - | 点击 |
| image | Image | - | 图片 |
| imagePosition | TDDialogImagePosition? | TDDialogImagePosition.top | 图片位置 |
| backgroundColor | Color | Colors.white | 背景颜色 |
| radius | double | 12.0 | 圆角 |
| title | String? | - | 标题 |
Expand All @@ -55,12 +50,10 @@
| contentWidget | Widget? | - | 内容Widget |
| content | String? | - | 内容 |
| contentColor | Color? | - | 内容颜色 |
| contentMaxHeight | double | 0 | 内容的最大高度,默认为0,也就是不限制高度 |
| buttonText | String? | - | 按钮文字 |
| buttonTextColor | Color? | - | 按钮文字颜色 |
| buttonStyle | TDDialogButtonStyle | TDDialogButtonStyle.normal | 按钮样式 |
| showCloseButton | bool? | - | 右上角关闭按钮 |
| padding | EdgeInsets? | const EdgeInsets.fromLTRB(24, 32, 24, 0) | 内容内边距 |
| leftBtn | TDDialogButtonOptions? | - | 左侧按钮配置 |
| rightBtn | TDDialogButtonOptions? | - | 右侧按钮配置 |
| showCloseButton | bool? | - | 显示右上角关闭按钮 |
| padding | EdgeInsets? | - | 内容内边距 |
| buttonWidget | Widget? | - | 自定义按钮 |

```
Expand Down Expand Up @@ -88,41 +81,6 @@
| buttonWidget | Widget? | - | 自定义按钮 |
| customInputWidget | Widget? | - | 自定义输入框 |

```
```
### TDAlertDialog
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| key | | - | |
| backgroundColor | Color | Colors.white | 背景颜色 |
| radius | double | 12.0 | 圆角 |
| title | String? | - | 标题 |
| titleColor | Color | const Color(0xE6000000) | 标题颜色 |
| content | String? | - | 内容 |
| contentColor | Color? | - | 内容颜色 |
| titleAlignment | AlignmentGeometry? | - | 标题对齐模式 |
| contentWidget | Widget? | - | 内容Widget |
| contentMaxHeight | double | 0 | 内容的最大高度,默认为0,也就是不限制高度 |
| leftBtn | TDDialogButtonOptions? | - | 左侧按钮配置 |
| rightBtn | TDDialogButtonOptions? | - | 右侧按钮配置 |
| leftBtnAction | Function()? | - | 左侧按钮默认点击 |
| rightBtnAction | Function()? | - | 右侧按钮默认点击 |
| showCloseButton | bool? | - | 显示右上角关闭按钮 |
| buttonStyle | | TDDialogButtonStyle.normal | |
| padding | EdgeInsets? | const EdgeInsets.fromLTRB(24, 32, 24, 0) | 内容内边距 |
| buttonWidget | Widget? | - | 自定义按钮 |


#### 工厂构造方法

| 名称 | 说明 |
| --- | --- |
| TDAlertDialog.vertical | 纵向按钮排列的对话框

[buttons]参数是必须的,纵向按钮默认样式都是[TDButtonTheme.primary] |

```
```
### TDDialogScaffold
Expand Down Expand Up @@ -216,3 +174,45 @@
| height | double? | 40.0 | 按钮高度 |
| width | double? | - | 按钮宽度 |
| isBlock | bool | true | 按钮高度 |

```
```
### TDConfirmDialog
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| key | | - | |
| action | Function()? | - | 点击 |
| backgroundColor | Color | Colors.white | 背景颜色 |
| radius | double | 12.0 | 圆角 |
| title | String? | - | 标题 |
| titleColor | Color | const Color(0xE6000000) | 标题颜色 |
| titleAlignment | AlignmentGeometry? | - | 标题对齐模式 |
| contentWidget | Widget? | - | 内容Widget |
| content | String? | - | 内容 |
| contentColor | Color? | - | 内容颜色 |
| contentMaxHeight | double | 0 | 内容的最大高度,默认为0,也就是不限制高度 |
| buttonText | String? | - | 按钮文字 |
| buttonTextColor | Color? | - | 按钮文字颜色 |
| buttonStyle | TDDialogButtonStyle | TDDialogButtonStyle.normal | 按钮样式 |
| showCloseButton | bool? | - | 右上角关闭按钮 |
| padding | EdgeInsets? | const EdgeInsets.fromLTRB(24, 32, 24, 0) | 内容内边距 |
| buttonWidget | Widget? | - | 自定义按钮 |

```
```
### TDDialogButtonOptions
#### 默认构造方法

| 参数 | 类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| title | String | - | 标题内容 |
| action | Function()? | - | 点击操作 |
| titleColor | Color? | - | 标题颜色 |
| titleSize | double? | - | 字体大小 |
| style | TDButtonStyle? | - | 按钮样式 |
| type | TDButtonType? | - | 按钮类型 |
| theme | TDButtonTheme? | - | 按钮类型 |
| height | double? | - | 按钮高度 |
| fontWeight | FontWeight? | - | 字体粗细 |
Loading
Loading