Skip to content

Commit bf94b92

Browse files
Luozf12345Luozf12345
authored
Merge pull request #701 from Tencent/release/0.2.4
Release/0.2.4
2 parents cc76f12 + 669cbff commit bf94b92

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+917
-705
lines changed

‎tdesign-component/CHANGELOG.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,20 @@
1+
## 🌈 0.2.4 `2025-08-14`
2+
### 🚀 Features
3+
- `TDUpload`: Support setting image spacing and alignment @cyjaysong ([#677](https://github.com/Tencent/tdesign-flutter/pull/677))
4+
- `TDTreeSelect`: Added custom width and max lines fields, fixed fixed width for second level and long text overflow issues @123dw-bot ([#694](https://github.com/Tencent/tdesign-flutter/pull/694))
5+
- `TDDropdownMenu`: Added TDDropdownItemController to allow external reset and change of dropdown options @Luozf12345 ([#697](https://github.com/Tencent/tdesign-flutter/pull/697))
6+
- `TDStepper`: Added controller parameter to Stepper for real-time value modification @Luozf12345 ([#699](https://github.com/Tencent/tdesign-flutter/pull/699))
7+
8+
### 🐞 Bug Fixes
9+
- `TDIndexes`: Fixed issue where custom indexes could not respond to click events @epoll-j ([#692](https://github.com/Tencent/tdesign-flutter/pull/692))
10+
- `TDPopup`: Fixed bug where close method was triggered twice @epoll-j ([#690](https://github.com/Tencent/tdesign-flutter/pull/690))
11+
- `TDSideBar`: Fixed issue where children of TDSideBar component could not be updated after initialization @Luozf12345 ([#698](https://github.com/Tencent/tdesign-flutter/pull/698))
12+
13+
### 🚧 Others
14+
- `Misc`: Restored default adaptation for flutter SDK version 3.32
15+
16+
17+
118
## 🌈 0.2.3 `2025-07-09`
219
### 🚀 Features
320
- `TDPicker`: Supports prioritizing the retention of cascaded option values when switching @epoll-j ([#666](https://github.com/Tencent/tdesign-flutter/pull/666))

‎tdesign-component/example/assets/api/button_api.md‎

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,5 @@
11
## API
2-
### TDButtonStyle
3-
#### 默认构造方法
4-
5-
| 参数 | 类型 | 默认值 | 说明 |
6-
| --- | --- | --- | --- |
7-
| backgroundColor | Color? | - | 背景颜色 |
8-
| frameColor | Color? | - | 边框颜色 |
9-
| textColor | Color? | - | 文字颜色 |
10-
| frameWidth | double? | - | 边框宽度 |
11-
| radius | BorderRadiusGeometry? | - | 自定义圆角 |
12-
13-
14-
#### 工厂构造方法
15-
16-
| 名称 | 说明 |
17-
| --- | --- |
18-
| TDButtonStyle.generateFillStyleByTheme | 生成不同主题的填充按钮样式 |
19-
| TDButtonStyle.generateOutlineStyleByTheme | 生成不同主题的描边按钮样式 |
20-
| TDButtonStyle.generateTextStyleByTheme | 生成不同主题的文本按钮样式 |
21-
| TDButtonStyle.generateGhostStyleByTheme | 生成不同主题的幽灵按钮样式 |
22-
23-
```
24-
```
25-
### TDButton
2+
### TDButton
263
#### 默认构造方法
274

285
| 参数 | 类型 | 默认值 | 说明 |
@@ -51,3 +28,26 @@
5128
| margin | EdgeInsetsGeometry? | - | 自定义margin |
5229
| padding | EdgeInsetsGeometry? | - | 自定义padding |
5330
| iconPosition | TDButtonIconPosition? | TDButtonIconPosition.left | 图标位置 |
31+
32+
```
33+
```
34+
### TDButtonStyle
35+
#### 默认构造方法
36+
37+
| 参数 | 类型 | 默认值 | 说明 |
38+
| --- | --- | --- | --- |
39+
| backgroundColor | Color? | - | 背景颜色 |
40+
| frameColor | Color? | - | 边框颜色 |
41+
| textColor | Color? | - | 文字颜色 |
42+
| frameWidth | double? | - | 边框宽度 |
43+
| radius | BorderRadiusGeometry? | - | 自定义圆角 |
44+
45+
46+
#### 工厂构造方法
47+
48+
| 名称 | 说明 |
49+
| --- | --- |
50+
| TDButtonStyle.generateFillStyleByTheme | 生成不同主题的填充按钮样式 |
51+
| TDButtonStyle.generateOutlineStyleByTheme | 生成不同主题的描边按钮样式 |
52+
| TDButtonStyle.generateTextStyleByTheme | 生成不同主题的文本按钮样式 |
53+
| TDButtonStyle.generateGhostStyleByTheme | 生成不同主题的幽灵按钮样式 |

‎tdesign-component/example/assets/api/calendar_api.md‎

Lines changed: 38 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,36 @@
11
## API
2-
### TDCalendarPopup
2+
### TDCalendar
33
#### 默认构造方法
44

55
| 参数 | 类型 | 默认值 | 说明 |
66
| --- | --- | --- | --- |
7-
| context | BuildContext | context | 上下文 |
8-
| top | double? | - | 距离顶部的距离 |
9-
| autoClose | bool? | true | 自动关闭；在点击关闭按钮、确认按钮、遮罩层时自动关闭 |
10-
| confirmBtn | Widget? | - | 自定义确认按钮 |
11-
| visible | bool? | - | 默认是否显示日历 |
12-
| onClose | VoidCallback? | - | 关闭时触发 |
13-
| onConfirm | void Function(List<int> value)? | - | 点击确认按钮时触发 |
14-
| builder | CalendarBuilder? | - | 控件构建器，优先级高于[child] |
15-
| child | TDCalendar? | - | 日历控件 |
7+
| key | | - | |
8+
| firstDayOfWeek | int? | 0 | 第一天从星期几开始，默认 0 = 周日 |
9+
| format | CalendarFormat? | - | 用于格式化日期的函数，可定义日期前后的显示内容和日期样式 |
10+
| maxDate | int? | - | 最大可选的日期(fromMillisecondsSinceEpoch)，不传则默认半年后 |
11+
| minDate | int? | - | 最小可选的日期(fromMillisecondsSinceEpoch)，不传则默认今天 |
12+
| title | String? | - | 标题 |
13+
| titleWidget | Widget? | - | 标题组件 |
14+
| type | CalendarType? | CalendarType.single | 日历的选择类型，single = 单选；multiple = 多选; range = 区间选择 |
15+
| value | List<int>? | - | 当前选择的日期(fromMillisecondsSinceEpoch)，不传则默认今天，当 type = single 时数组长度为1 |
16+
| displayFormat | String? | 'year month' | 年月显示格式，`year`表示年，`month`表示月，如`year month`表示年在前、月在后、中间隔一个空格 |
17+
| cellHeight | double? | 60 | 日期高度 |
18+
| height | double? | - | 高度 |
19+
| width | double? | - | 宽度 |
20+
| style | TDCalendarStyle? | - | 自定义样式 |
21+
| onChange | void Function(List<int> value)? | - | 选中值变化时触发 |
22+
| onCellClick | void Function(int value, DateSelectType type, TDate tdate)? | - | 点击日期时触发 |
23+
| onCellLongPress | void Function(int value, DateSelectType type, TDate tdate)? | - | 长安日期时触发 |
24+
| onHeaderClick | void Function(int index, String week)? | - | 点击周时触发 |
25+
| useTimePicker | bool? | false | 是否显示时间选择器 |
26+
| timePickerModel | List<DatePickerModel>? | - | 自定义时间选择器 |
27+
| monthTitleHeight | double? | 22 | 月标题高度 |
28+
| monthTitleBuilder | Widget Function(BuildContext context, DateTime monthDate)? | - | 月标题构建器 |
29+
| pickerHeight | double? | 178 | 时间选择器List的视窗高度 |
30+
| pickerItemCount | int? | 3 | 选择器List视窗中item个数，pickerHeight / pickerItemCount即item高度 |
31+
| isTimeUnit | bool? | true | 是否显示时间单位 |
32+
| animateTo | bool? | false | 动画滚动到指定位置 |
33+
| cellWidget | Widget? Function(BuildContext context, TDate tdate, DateSelectType selectType)? | - | 自定义日期单元格组件 |
1634

1735
```
1836
```
@@ -43,35 +61,17 @@
4361

4462
```
4563
```
46-
### TDCalendar
64+
### TDCalendarPopup
4765
#### 默认构造方法
4866

4967
| 参数 | 类型 | 默认值 | 说明 |
5068
| --- | --- | --- | --- |
51-
| key | | - | |
52-
| firstDayOfWeek | int? | 0 | 第一天从星期几开始，默认 0 = 周日 |
53-
| format | CalendarFormat? | - | 用于格式化日期的函数，可定义日期前后的显示内容和日期样式 |
54-
| maxDate | int? | - | 最大可选的日期(fromMillisecondsSinceEpoch)，不传则默认半年后 |
55-
| minDate | int? | - | 最小可选的日期(fromMillisecondsSinceEpoch)，不传则默认今天 |
56-
| title | String? | - | 标题 |
57-
| titleWidget | Widget? | - | 标题组件 |
58-
| type | CalendarType? | CalendarType.single | 日历的选择类型，single = 单选；multiple = 多选; range = 区间选择 |
59-
| value | List<int>? | - | 当前选择的日期(fromMillisecondsSinceEpoch)，不传则默认今天，当 type = single 时数组长度为1 |
60-
| displayFormat | String? | 'year month' | 年月显示格式，`year`表示年，`month`表示月，如`year month`表示年在前、月在后、中间隔一个空格 |
61-
| cellHeight | double? | 60 | 日期高度 |
62-
| height | double? | - | 高度 |
63-
| width | double? | - | 宽度 |
64-
| style | TDCalendarStyle? | - | 自定义样式 |
65-
| onChange | void Function(List<int> value)? | - | 选中值变化时触发 |
66-
| onCellClick | void Function(int value, DateSelectType type, TDate tdate)? | - | 点击日期时触发 |
67-
| onCellLongPress | void Function(int value, DateSelectType type, TDate tdate)? | - | 长安日期时触发 |
68-
| onHeaderClick | void Function(int index, String week)? | - | 点击周时触发 |
69-
| useTimePicker | bool? | false | 是否显示时间选择器 |
70-
| timePickerModel | List<DatePickerModel>? | - | 自定义时间选择器 |
71-
| monthTitleHeight | double? | 22 | 月标题高度 |
72-
| monthTitleBuilder | Widget Function(BuildContext context, DateTime monthDate)? | - | 月标题构建器 |
73-
| pickerHeight | double? | 178 | 时间选择器List的视窗高度 |
74-
| pickerItemCount | int? | 3 | 选择器List视窗中item个数，pickerHeight / pickerItemCount即item高度 |
75-
| isTimeUnit | bool? | true | 是否显示时间单位 |
76-
| animateTo | bool? | false | 动画滚动到指定位置 |
77-
| cellWidget | Widget? Function(BuildContext context, TDate tdate, DateSelectType selectType)? | - | 自定义日期单元格组件 |
69+
| context | BuildContext | context | 上下文 |
70+
| top | double? | - | 距离顶部的距离 |
71+
| autoClose | bool? | true | 自动关闭；在点击关闭按钮、确认按钮、遮罩层时自动关闭 |
72+
| confirmBtn | Widget? | - | 自定义确认按钮 |
73+
| visible | bool? | - | 默认是否显示日历 |
74+
| onClose | VoidCallback? | - | 关闭时触发 |
75+
| onConfirm | void Function(List<int> value)? | - | 点击确认按钮时触发 |
76+
| builder | CalendarBuilder? | - | 控件构建器，优先级高于[child] |
77+
| child | TDCalendar? | - | 日历控件 |

‎tdesign-component/example/assets/api/checkbox_api.md‎

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,26 @@
11
## API
2-
### TDCheckbox
2+
### TDCheckboxGroup
3+
#### 默认构造方法
4+
5+
| 参数 | 类型 | 默认值 | 说明 |
6+
| --- | --- | --- | --- |
7+
| child | | - | |
8+
| key | | - | |
9+
| onChangeGroup | OnGroupChange? | - | 状态变化监听器 |
10+
| controller | TDCheckboxGroupController? | - | 可以通过控制器操作勾选状态 |
11+
| checkedIds | List<String>? | - | 勾选的CheckBox id列表 |
12+
| maxChecked | int? | - | 最多可以勾选多少 |
13+
| titleMaxLine | int? | - | CheckBox标题的行数 |
14+
| customContentBuilder | ContentBuilder? | - | CheckBox完全自定义内容 |
15+
| contentDirection | TDContentDirection? | - | 文字相对icon的方位 |
16+
| style | TDCheckboxStyle? | - | CheckBox复选框样式：圆形或方形 |
17+
| spacing | double? | - | CheckBoxicon和文字的距离 |
18+
| customIconBuilder | IconBuilder? | - | 自定义选择icon的样式 |
19+
| onOverloadChecked | VoidCallback? | - | 超过最大可勾选的个数 |
20+
21+
```
22+
```
23+
### TDCheckbox
324
#### 默认构造方法
425

526
| 参数 | 类型 | 默认值 | 说明 |
@@ -31,24 +52,3 @@
3152
| subTitleColor | Color? | - | 副标题文字颜色 |
3253
| checkBoxLeftSpace | double? | - | 选项框左侧间距 |
3354
| customSpace | EdgeInsetsGeometry? | - | 自定义组件间距 |
34-
35-
```
36-
```
37-
### TDCheckboxGroup
38-
#### 默认构造方法
39-
40-
| 参数 | 类型 | 默认值 | 说明 |
41-
| --- | --- | --- | --- |
42-
| child | | - | |
43-
| key | | - | |
44-
| onChangeGroup | OnGroupChange? | - | 状态变化监听器 |
45-
| controller | TDCheckboxGroupController? | - | 可以通过控制器操作勾选状态 |
46-
| checkedIds | List<String>? | - | 勾选的CheckBox id列表 |
47-
| maxChecked | int? | - | 最多可以勾选多少 |
48-
| titleMaxLine | int? | - | CheckBox标题的行数 |
49-
| customContentBuilder | ContentBuilder? | - | CheckBox完全自定义内容 |
50-
| contentDirection | TDContentDirection? | - | 文字相对icon的方位 |
51-
| style | TDCheckboxStyle? | - | CheckBox复选框样式：圆形或方形 |
52-
| spacing | double? | - | CheckBoxicon和文字的距离 |
53-
| customIconBuilder | IconBuilder? | - | 自定义选择icon的样式 |
54-
| onOverloadChecked | VoidCallback? | - | 超过最大可勾选的个数 |

0 commit comments

Comments
 (0)