Merge pull request #796 from Tencent/release/0.2.6

 chore: release 0.2.6

Author: Luozf12345

tdesign-component/CHANGELOG.md

@@ -1,3 +1,28 @@
+
+## 🌈 0.2.6 `2025-11-14`
+### 🚀 Features
+- `TDNoticeBar`: Added `content` property, deprecated and compatible with the original context property @runoob-coder ([#744](https://github.com/Tencent/tdesign-flutter/pull/744))
+- `TDButton`: Added gradient color background @jflin19990707 ([#773](https://github.com/Tencent/tdesign-flutter/pull/773))
+- `TDToast`: TDToast supports displaying multiple toasts @jflin19990707 ([#780](https://github.com/Tencent/tdesign-flutter/pull/780))
+- `TDUpload`: Added custom upload listener @leenc123 ([#775](https://github.com/Tencent/tdesign-flutter/pull/775))
+- `TDTable`: Added custom footer property @leenc123 ([#776](https://github.com/Tencent/tdesign-flutter/pull/776))
+
+### 🐞 Bug Fixes
+- `TDMultiCascader`: Fixed initialIndexes parameter not taking effect @epoll-j ([#752](https://github.com/Tencent/tdesign-flutter/pull/752))
+- `TDDialog`: Fixed button text overflow issue @jflin19990707 ([#772](https://github.com/Tencent/tdesign-flutter/pull/772))
+- `TDDateTimePicker`: Changed English configuration for date, hour, minute, second to abbreviations @jflin19990707 ([#770](https://github.com/Tencent/tdesign-flutter/pull/770))
+- `TDCell`: Fixed overflow issue when note is too long @jflin19990707 ([#769](https://github.com/Tencent/tdesign-flutter/pull/769))
+- `TDCell`: Fixed alignment issue between icon and text in the cell @runoob-coder ([#789](https://github.com/Tencent/tdesign-flutter/pull/789))
+- `TDProgress`: Fixed style issue when progress bar changes @runoob-coder ([#744](https://github.com/Tencent/tdesign-flutter/pull/744))
+
+### 📝 Documentation
+- `docs`: Optimized document format and content @runoob-coder ([#744](https://github.com/Tencent/tdesign-flutter/pull/744))
+
+### 🚧 Others
+- Components fully adapted to dark mode, optimized and adjusted component styles (experimental version) @runoob-coder ([#744](https://github.com/Tencent/tdesign-flutter/pull/744))
+- `demo`: Optimized and adjusted demo example project and code demonstrations, upgraded Android build configuration and dependencies to be compatible with Flutter from `3.16.9` to the latest version (`3.35.5`), adjusted web preview iframe style to remove top margin @runoob-coder ([#744](https://github.com/Tencent/tdesign-flutter/pull/744))
+- `web`: Overridden web dependencies, resolved version conflict with flutter_localizations, compatible with previous Flutter versions @runoob-coder ([#744](https://github.com/Tencent/tdesign-flutter/pull/744))
+
 ## 🌈 0.2.5 `2025-09-12`
 ### 🐞 Bug Fixes
 - `TDPopover`: Added custom corner radius property @jflin19990707 ([#727](https://github.com/Tencent/tdesign-flutter/pull/727))

tdesign-component/demo_tool/bin/api_tool_macos_arm64

@@ -55,19 +55,15 @@ class App extends StatelessWidget {
             theme: themeData.systemThemeDataLight!.copyWith(
               /// 根据自己的需求用 TD 颜色覆盖 Material/Cupertino 的颜色
               cupertinoOverrideTheme: const CupertinoThemeData().copyWith(
-                barBackgroundColor: themeData.bgColorContainer.withValues(
-                  alpha: 0.5,
-                ),
+                barBackgroundColor: themeData.bgColorContainer.withOpacity(0.5),
               ),
               /// ... 更多重载主题
             ),
 
             /// 深色模式
             darkTheme: themeData.systemThemeDataDark?.copyWith(
               cupertinoOverrideTheme: const CupertinoThemeData().copyWith(
-                barBackgroundColor: themeData.dark?.grayColor13.withValues(
-                  alpha: 0.5,
-                ),
+                barBackgroundColor: themeData.dark?.grayColor13.withOpacity(0.5),
               ),
 
               /// ... 更多重载主题

tdesign-component/example/lib/component_test/dark_test.dart

@@ -1,3 +1,4 @@
+import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 import 'package:provider/provider.dart';
@@ -11,6 +12,7 @@ import 'home.dart';
 import 'l10n/app_localizations.dart';
 import 'provider/locale_provider.dart';
 import 'provider/theme_mode_provider.dart';
+import 'util/web_theme_listener.dart';
 
 Future<void> main() async {
   WidgetsFlutterBinding.ensureInitialized();
@@ -82,6 +84,17 @@ class _MyAppState extends State<MyApp> {
       ],
       child: Consumer2<ThemeModeProvider, LocaleProvider>(
         builder: (context, themeModeProvider, localeProvider, child) {
+          // 在 Web 平台设置 postMessage 监听
+          if (PlatformUtil.isWeb) {
+            WidgetsBinding.instance.addPostFrameCallback((_) {
+              // 仅在 Web 平台执行
+              if (!kIsWeb) {
+                return;
+              }
+              setupThemeModeListener(themeModeProvider);
+            });
+          }
+
           return MaterialApp(
             title: 'TDesign Flutter Example',
             theme: _themeData.systemThemeDataLight,

tdesign-component/example/lib/main.dart

@@ -0,0 +1,6 @@
+// Web 平台主题模式监听器
+// 使用条件导入，避免在非 Web 平台编译时出错
+// 条件导入：Web 平台使用 dart:html，非 Web 平台使用 stub
+export 'web_theme_listener_stub.dart'
+    if (dart.library.html) 'web_theme_listener_web.dart';
+

tdesign-component/example/lib/util/web_theme_listener.dart

@@ -0,0 +1,11 @@
+// 非 Web 平台的 stub 实现
+
+import 'package:flutter/material.dart';
+
+import '../provider/theme_mode_provider.dart';
+
+/// 非 Web 平台的 stub 实现（空操作）
+void setupThemeModeListener(ThemeModeProvider themeModeProvider) {
+  // 非 Web 平台不需要实现，空操作即可
+}
+

tdesign-component/example/lib/util/web_theme_listener_stub.dart

@@ -0,0 +1,33 @@
+// Web 平台实现：使用 dart:html 监听 postMessage
+
+import 'dart:html' as html;
+
+import 'package:flutter/material.dart';
+
+import '../provider/theme_mode_provider.dart';
+
+// 静态变量，用于确保只设置一次监听器
+bool _listenerSetup = false;
+
+/// Web 平台的主题模式监听器实现
+void setupThemeModeListener(ThemeModeProvider themeModeProvider) {
+  // 只设置一次监听器
+  if (_listenerSetup) return;
+  _listenerSetup = true;
+
+  // 监听来自父窗口的 postMessage
+  html.window.onMessage.listen((event) {
+    if (event.data is Map) {
+      final data = event.data as Map;
+      if (data['type'] == 'theme-mode-change') {
+        final themeMode = data['themeMode'] as String?;
+        if (themeMode == 'dark') {
+          themeModeProvider.themeMode = ThemeMode.dark;
+        } else if (themeMode == 'light') {
+          themeModeProvider.themeMode = ThemeMode.light;
+        }
+      }
+    }
+  });
+}
+

tdesign-component/example/lib/util/web_theme_listener_web.dart

@@ -1,6 +1,6 @@
 name: tdesign_flutter
 description: Tencent TDesign UI component library of Flutter, suitable for use in mobile projects.
-version: 0.2.5
+version: 0.2.6
 homepage: https://github.com/Tencent/tdesign-flutter
 
 environment:

tdesign-component/pubspec.yaml

@@ -17,9 +17,9 @@ TDesign Flutter 从 `0.2.0` 版本开始，正常情况下，每月初发一个
 - 在应用使用中切换主题颜色，示例代码请参考 example 的 `main.dart` 和 `home.dart`：https://github.com/Tencent/tdesign-flutter/blob/main/tdesign-component/example/lib/main.dart
 - 转换完整代码：https://github.com/Tencent/tdesign-flutter/blob/main/tdesign-component/example/shell/theme/css2JsonTheme.dart
 
-## 暗色模式
+## 深色模式
 
-TDesign Flutter 目前未内置暗色模式，请使用“自定义主题”方式自己适配。
+可参考[深色模式](https://tdesign.tencent.com/flutter/dark-mode)
 
 ## 文字居中