首页UI ComponentsTencent/tdesign-flutter
// archived 2026-04-10
Tencent

tdesign-flutter

Mobile#Flutter#UI Components#Dart#Design System
前往 GitHub →
1,116

// 项目简介

TDesign Flutter 是一个基于腾讯设计体系构建的跨平台 UI 组件库,适用于移动端和 Web 应用。它提供了一套全面的预构建组件、主题定制工具和图标支持,以确保 iOS、Android 和 Web 平台上的设计一致性。该库还支持深色模式、自定义主题生成以及与 Flutter 国际化功能的集成等高级特性。

// 技术分析

TDesign Flutter 是一个基于 Flutter 框架构建的跨平台 UI 组件库,实现了腾讯的设计系统规范。它通过提供一套全面的预构建组件和灵活的主题定制工具,满足了 Android、iOS 和 Web 平台对一致性、高质量 UI 开发的需求。该库通过结构化的主题配置系统强调设计一致性,允许开发者通过 JSON 或专用生成器管理颜色、排版和样式,同时在易用性与处理深色模式和国际化等复杂需求之间取得了平衡。

// 核心亮点

01
提供了一套严格遵循 TDesign 设计规范的全面 Flutter UI 组件库。
02
支持通过 JSON 配置文件对颜色、字体和组件样式进行灵活的主题定制。
03
包含一个专用的 Theme Generator 工具,简化了自定义设计 Token 的创建和导出。
04
内置对深色模式的支持,允许在浅色和深色配色方案之间无缝切换。
05
提供了一个强大的图标库,可以根据需要轻松集成和替换。
06
通过允许开发者扩展 TDResourceDelegate 类来注入本地化文本资源,从而实现国际化。

// 典型使用场景

01
快速开发具有一致性的跨平台移动端和 Web 应用
02
使用 JSON 配置或 TDesign Theme Generator 自定义应用主题
03
在 Flutter 项目中实现深色模式和国际化

// 快速开始

要开始使用 TDesign Flutter,请将依赖项 'tdesign_flutter: ^0.2.7' 添加到您的 pubspec.yaml 文件中,并使用 'import 'package:tdesign_flutter/tdesign_flutter.dart';' 导入该包。然后,您可以通过将 TDThemeData 注入到您的 MaterialApp 中来配置应用程序的主题,并在您的 widget 树中使用该库的组件。