Merge pull request #518 from Tencent/release/0.1.9

Release/0.1.9

Author: Luozf12345

tdesign-component/demo_tool/all_build.sh

@@ -82,15 +82,20 @@
 # empty
 ./bin/api_tool_linux generate --file ../lib/src/components/empty/td_empty.dart --name TDEmpty --folder-name empty --output ../example/assets/api/ --only-api
 # footer
+./bin/api_tool_linux generate --file ../lib/src/components/footer/td_footer.dart --name TDFooter,TDFooterType --folder-name footer --output ../example/assets/api/ --only-api
+
 # grid
 # image
 ./bin/api_tool_linux generate --file ../lib/src/components/image/td_image.dart --name TDImage --folder-name image --output ../example/assets/api/ --only-api
 # imageViewer
 ./bin/api_tool_linux generate --folder ../lib/src/components/image_viewer  --name TDImageViewer,TDImageViewerWidget,  --folder-name image-viewer --output ../example/assets/api/ --only-api
 # progress
-./bin/demo_tool generate --file ../lib/src/components/image/td_progress.dart --name TDProgress --folder-name progress --output ../example/assets/api/ --only-api
+./bin/api_tool_linux generate --file ../lib/src/components/progress/td_progress.dart --name TDProgress --folder-name progress --output ../example/assets/api/ --only-api
 # result
+./bin/api_tool_linux generate --file ../lib/src/components/result/td_result.dart --name TDResult --folder-name result --output ../example/assets/api/ --only-api
 # skeleton
+./bin/api_tool_linux generate --folder ../lib/src/components/skeleton --name TDSkeleton,TDSkeletonRowColStyle,TDSkeletonRowCol,TDSkeletonRowColObjStyle,TDSkeletonRowColObj --folder-name skeleton --output ../example/assets/api/ --only-api
+
 # sticky
 # swiper
 ./bin/api_tool_linux generate --folder ../lib/src/components/swiper --name TDSwiperPagination,TDPageTransformer --folder-name swiper --output ../example/assets/api/ --only-api --get-comments
@@ -111,6 +116,7 @@
 # loading
 ./bin/api_tool_linux generate --file ../lib/src/components/loading/td_loading.dart --name TDLoading --folder-name loading --output ../example/assets/api/ --only-api
 # message
+./bin/api_tool_linux generate --file ../lib/src/components/message/td_message.dart --name TDMessage,MessageTheme,MessageMarquee,MessageLink --folder-name message --output ../example/assets/api/ --only-api
 # noticeBar
 ./bin/api_tool_linux generate --folder ../lib/src/components/notice_bar --name TDNoticeBar,TDNoticeBarStyle --folder-name notice-bar --output ../example/assets/api/ --only-api --get-comments
 # overlay

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

@@ -1,5 +1,28 @@
 ## API
-### TDButton
+### TDButtonStyle
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| backgroundColor | Color? | - | 背景颜色 |
+| frameColor | Color? | - | 边框颜色 |
+| textColor | Color? | - | 文字颜色 |
+| frameWidth | double? | - | 边框宽度 |
+| radius | BorderRadiusGeometry? | - | 自定义圆角 |
+
+
+#### 工厂构造方法
+
+| 名称  | 说明 |
+| --- |  --- |
+| TDButtonStyle.generateFillStyleByTheme  | 生成不同主题的填充按钮样式 |
+| TDButtonStyle.generateOutlineStyleByTheme  | 生成不同主题的描边按钮样式 |
+| TDButtonStyle.generateTextStyleByTheme  | 生成不同主题的文本按钮样式 |
+| TDButtonStyle.generateGhostStyleByTheme  | 生成不同主题的幽灵按钮样式 |
+
+```
+```
+ ### TDButton
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -28,26 +51,3 @@
 | margin | EdgeInsetsGeometry? | - | 自定义margin |
 | padding | EdgeInsetsGeometry? | - | 自定义padding |
 | iconPosition | TDButtonIconPosition? | TDButtonIconPosition.left | 图标位置 |
-
-```
-```
- ### TDButtonStyle
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| backgroundColor | Color? | - | 背景颜色 |
-| frameColor | Color? | - | 边框颜色 |
-| textColor | Color? | - | 文字颜色 |
-| frameWidth | double? | - | 边框宽度 |
-| radius | BorderRadiusGeometry? | - | 自定义圆角 |
-
-
-#### 工厂构造方法
-
-| 名称  | 说明 |
-| --- |  --- |
-| TDButtonStyle.generateFillStyleByTheme  | 生成不同主题的填充按钮样式 |
-| TDButtonStyle.generateOutlineStyleByTheme  | 生成不同主题的描边按钮样式 |
-| TDButtonStyle.generateTextStyleByTheme  | 生成不同主题的文本按钮样式 |
-| TDButtonStyle.generateGhostStyleByTheme  | 生成不同主题的幽灵按钮样式 |

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

@@ -0,0 +1,76 @@
+## API
+### TDCalendar
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| key |  | - |  |
+| firstDayOfWeek | int? | 0 | 第一天从星期几开始，默认 0 = 周日 |
+| format | CalendarFormat? | - | 用于格式化日期的函数，可定义日期前后的显示内容和日期样式 |
+| maxDate | int? | - | 最大可选的日期(fromMillisecondsSinceEpoch)，不传则默认半年后 |
+| minDate | int? | - | 最小可选的日期(fromMillisecondsSinceEpoch)，不传则默认今天 |
+| title | String? | - | 标题 |
+| titleWidget | Widget? | - | 标题组件 |
+| type | CalendarType? | CalendarType.single | 日历的选择类型，single = 单选；multiple = 多选; range = 区间选择 |
+| value | List<int>? | - | 当前选择的日期(fromMillisecondsSinceEpoch)，不传则默认今天，当 type = single 时数组长度为1 |
+| displayFormat | String? | 'year month' | 年月显示格式，`year`表示年，`month`表示月，如`year month`表示年在前、月在后、中间隔一个空格 |
+| cellHeight | double? | 60 | 日期高度 |
+| height | double? | - | 高度 |
+| width | double? | - | 宽度 |
+| style | TDCalendarStyle? | - | 自定义样式 |
+| onChange | void Function(List<int> value)? | - | 选中值变化时触发 |
+| onCellClick | void Function(int value, DateSelectType type, TDate tdate)? | - | 点击日期时触发 |
+| onCellLongPress | void Function(int value, DateSelectType type, TDate tdate)? | - | 长安日期时触发 |
+| onHeaderClick | void Function(int index, String week)? | - | 点击周时触发 |
+| useTimePicker | bool? | false | 是否显示时间选择器 |
+| timePickerModel | List<DatePickerModel>? | - | 自定义时间选择器 |
+| monthTitleHeight | double? | 22 | 月标题高度 |
+| monthTitleBuilder | Widget Function(BuildContext context, DateTime monthDate)? | - | 月标题构建器 |
+| pickerHeight | double? | 178 | 时间选择器List的视窗高度 |
+| pickerItemCount | int? | 3 | 选择器List视窗中item个数，pickerHeight / pickerItemCount即item高度 |
+| isTimeUnit | bool? | true | 是否显示时间单位 |
+| animateTo | bool? | false | 动画滚动到指定位置 |
+
+```
+```
+ ### 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
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| decoration |  | - |  |
+| titleStyle | TextStyle? | - | header区域 [TDCalendar.title]的样式 |
+| titleMaxLine | int? | - | header区域 [TDCalendar.title]的行数 |
+| titleCloseColor | Color? | - | header区域 关闭图标的颜色 |
+| weekdayStyle | TextStyle? | - | header区域 周 文字样式 |
+| monthTitleStyle | TextStyle? | - | body区域 年月文字样式 |
+| cellStyle | TextStyle? | - | 日期样式 |
+| centreColor | Color? | - | 日期范围内背景样式 |
+| cellDecoration | BoxDecoration? | - | 日期decoration |
+| cellPrefixStyle | TextStyle? | - | 日期前面的字符串的样式 |
+| cellSuffixStyle | TextStyle? | - | 日期后面的字符串的样式 |
+
+
+#### 工厂构造方法
+
+| 名称  | 说明 |
+| --- |  --- |
+| TDCalendarStyle.generateStyle  | 生成默认样式 |
+| TDCalendarStyle.cellStyle  | 日期样式 |

tdesign-component/example/assets/api/cell_api.md

@@ -0,0 +1,86 @@
+## API
+### 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
+#### 简介
+单元格组件样式
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| context | BuildContext? | - | 传递context，会生成默认样式 |
+| leftIconColor | Color? | - | 左侧图标颜色 |
+| rightIconColor | Color? | - | 右侧图标颜色 |
+| titleStyle | TextStyle? | - | 标题文字样式 |
+| requiredStyle | TextStyle? | - | 必填星号文字样式 |
+| descriptionStyle | TextStyle? | - | 内容描述文字样式 |
+| noteStyle | TextStyle? | - | 说明文字样式 |
+| arrowColor | Color? | - | 箭头颜色 |
+| borderedColor | Color? | - | 单元格边框颜色 |
+| groupBorderedColor | Color? | - | 单元格组边框颜色 |
+| backgroundColor | Color? | - | 默认状态背景颜色 |
+| clickBackgroundColor | Color? | - | 点击状态背景颜色 |
+| groupTitleStyle | TextStyle? | - | 单元组标题文字样式 |
+| padding | EdgeInsets? | - | 单元格内边距 |
+| cardBorderRadius | BorderRadius? | - | 卡片模式边框圆角 |
+| cardPadding | EdgeInsets? | - | 卡片模式内边距 |
+| titlePadding | EdgeInsets? | - | 单元格组标题内边距 |
+
+
+#### 工厂构造方法
+
+| 名称  | 说明 |
+| --- |  --- |
+| TDCellStyle.cellStyle  | 生成单元格默认样式 |
+
+```
+```
+ ### TDCell
+#### 简介
+单元格组件
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| key |  | - |  |
+| align | TDCellAlign? | TDCellAlign.middle | 内容的对齐方式，默认居中对齐。可选项：top/middle/bottom |
+| arrow | bool? | false | 是否显示右侧箭头 |
+| bordered | bool? | true | 是否显示下边框，仅在TDCellGroup组件下起作用 |
+| description | String? | - | 下方内容描述文字 |
+| descriptionWidget | Widget? | - | 下方内容描述组件 |
+| hover | bool? | true | 是否开启点击反馈 |
+| image | ImageProvider? | - | 主图 |
+| imageSize | double? | - | 主图尺寸 |
+| imageWidget | Widget? | - | 主图组件 |
+| leftIcon | IconData? | - | 左侧图标，出现在单元格标题的左侧 |
+| leftIconWidget | Widget? | - | 左侧图标组件 |
+| note | String? | - | 和标题同行的说明文字 |
+| noteWidget | Widget? | - | 说明文字组件 |
+| required | bool? | false | 是否显示表单必填星号 |
+| title | String? | - | 标题 |
+| titleWidget | Widget? | - | 标题组件 |
+| onClick | TDCellClick? | - | 点击事件 |
+| onLongPress | TDCellClick? | - | 长按事件 |
+| style | TDCellStyle? | - | 自定义样式 |
+| rightIcon | IconData? | - | 最右侧图标 |
+| rightIconWidget | Widget? | - | 最右侧图标组件 |
+| disabled | bool? | false | 禁用 |
+| imageCircle | double? | 50 | 主图圆角，默认50（圆形） |

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

@@ -1,26 +1,5 @@
 ## API
-### TDCheckboxGroup
-#### 默认构造方法
-
-| 参数 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
-| child |  | - |  |
-| key |  | - |  |
-| onChangeGroup | OnGroupChange? | - | 状态变化监听器 |
-| controller | TDCheckboxGroupController? | - | 可以通过控制器操作勾选状态 |
-| checkedIds | List<String>? | - | 勾选的CheckBox id列表 |
-| maxChecked | int? | - | 最多可以勾选多少 |
-| titleMaxLine | int? | - | CheckBox标题的行数 |
-| customContentBuilder | ContentBuilder? | - | CheckBox完全自定义内容 |
-| contentDirection | TDContentDirection? | - | 文字相对icon的方位 |
-| style | TDCheckboxStyle? | - | CheckBox复选框样式：圆形或方形 |
-| spacing | double? | - | CheckBoxicon和文字的距离 |
-| customIconBuilder | IconBuilder? | - | 自定义选择icon的样式 |
-| onOverloadChecked | VoidCallback? | - | 超过最大可勾选的个数 |
-
-```
-```
- ### TDCheckbox
+### TDCheckbox
 #### 默认构造方法
 
 | 参数 | 类型 | 默认值 | 说明 |
@@ -51,3 +30,24 @@
 | titleColor | Color? | - | 标题文字颜色 |
 | subTitleColor | Color? | - | 副标题文字颜色 |
 | checkBoxLeftSpace | double? | - | 选项框左侧间距 |
+
+```
+```
+ ### TDCheckboxGroup
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| child |  | - |  |
+| key |  | - |  |
+| onChangeGroup | OnGroupChange? | - | 状态变化监听器 |
+| controller | TDCheckboxGroupController? | - | 可以通过控制器操作勾选状态 |
+| checkedIds | List<String>? | - | 勾选的CheckBox id列表 |
+| maxChecked | int? | - | 最多可以勾选多少 |
+| titleMaxLine | int? | - | CheckBox标题的行数 |
+| customContentBuilder | ContentBuilder? | - | CheckBox完全自定义内容 |
+| contentDirection | TDContentDirection? | - | 文字相对icon的方位 |
+| style | TDCheckboxStyle? | - | CheckBox复选框样式：圆形或方形 |
+| spacing | double? | - | CheckBoxicon和文字的距离 |
+| customIconBuilder | IconBuilder? | - | 自定义选择icon的样式 |
+| onOverloadChecked | VoidCallback? | - | 超过最大可勾选的个数 |

tdesign-component/example/assets/api/date-time-picker_api.md

@@ -0,0 +1,43 @@
+## API
+### TDDatePicker
+#### 默认构造方法
+
+| 参数 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| title | String | - | 选择器标题 |
+| onConfirm | DatePickerCallback? | - | 选择器确认按钮回调 |
+| rightText | String? | - | 右侧按钮文案 |
+| leftText | String? | - | 左侧按钮文案 |
+| onCancel | DatePickerCallback? | - | 选择器取消按钮回调 |
+| backgroundColor | Color? | - | 背景颜色 |
+| titleDividerColor | Color? | - | 标题分割线颜色 |
+| topRadius | double? | - | 顶部圆角 |
+| titleHeight | double? | - | 标题高度 |
+| padding | EdgeInsets? | - | 适配padding |
+| leftPadding | double? | - | 左边填充 |
+| rightPadding | double? | - | 右边填充 |
+| leftTextStyle | TextStyle? | - | 自定义左侧文案样式 |
+| rightTextStyle | TextStyle? | - | 自定义右侧文案样式 |
+| centerTextStyle | TextStyle? | - | 自定义中间文案样式 |
+| customSelectWidget | Widget? | - | 自定义选择框样式 |
+| itemDistanceCalculator | ItemDistanceCalculator? | - | 根据距离计算字体颜色、透明度、粗细 |
+| model | DatePickerModel | - | 数据模型 |
+| showTitle | bool | true | 是否展示标题 |
+| pickerHeight | double | 200 | 选择器List的视窗高度，默认200 |
+| pickerItemCount | int | - | 选择器List视窗中item个数，pickerHeight / pickerItemCount即item高度 |
+| isTimeUnit | bool? | - | 是否时间显示 |
+| onSelectedItemChanged | void Function(int wheelIndex, int index)? | - | 选择器选中项改变回调 |
+| itemBuilder | ItemBuilderType? | - | 自定义item构建 |
+| key |  | - |  |
+
+```
+```
+ ### TDPicker
+
+#### 静态方法
+
+| 名称 | 返回类型 | 参数 | 说明 |
+| --- | --- | --- | --- |
+| showDatePicker |  |   required null context,  required String title,  required DatePickerCallback? onConfirm,  DatePickerCallback? onCancel,  bool useYear,  bool useMonth,  bool useDay,  bool useHour,  bool useMinute,  bool useSecond,  bool useWeekDay,  Color? barrierColor,  List<int> dateStart,  List<int>? dateEnd,  List<int>? initialDate,  String? rightText,  String? leftText,  TextStyle? leftTextStyle,  TextStyle? centerTextStyle,  TextStyle? rightTextStyle,  Color? titleDividerColor,  Widget? customSelectWidget,  Duration duration,  double pickerHeight,  bool isTimeUnit,   Function(int wheelIndex, int index)? onSelectedItemChanged,  int pickerItemCount,  List<int> Function(DateTypeKey key, List<int> nums)? filterItems,  ItemBuilderType? itemBuilder, | 显示时间选择器 |
+| showMultiPicker |  |   required null context,  String? title,  required MultiPickerCallback? onConfirm,  MultiPickerCallback? onCancel,  required List<List<String>> data,  List<int>? initialIndexes,  Duration duration,  Color? barrierColor,  double pickerHeight,  String? rightText,  String? leftText,  TextStyle? leftTextStyle,  TextStyle? centerTextStyle,  TextStyle? rightTextStyle,  Color? titleDividerColor,  double? topPadding,  int pickerItemCount,  Widget? customSelectWidget,  ItemBuilderType? itemBuilder, | 显示多级选择器 |
+| showMultiLinkedPicker |  |   required null context,  String? title,  required MultiPickerCallback? onConfirm,  MultiPickerCallback? onCancel,  required Map data,  required int columnNum,  required List initialData,  Duration duration,  Color? barrierColor,  String? rightText,  String? leftText,  TextStyle? leftTextStyle,  TextStyle? centerTextStyle,  TextStyle? rightTextStyle,  double pickerHeight,  Color? titleDividerColor,  Widget? customSelectWidget,  double? topPadding,  int pickerItemCount, | 显示多级联动选择器 |