TDesign React Starter 使用教程

项目介绍

TDesign React Starter 是一个基于 TDesign 的 React 项目，使用 Vite 进行开发。该项目提供了一套 UI 组件，可以快速启动和定制主题。TDesign 是腾讯开源的一套设计系统，旨在提供一致的用户体验和开发效率。

项目快速启动

安装依赖

首先，克隆项目仓库并安装依赖：

git clone https://github.com/Tencent/tdesign-react-starter.git
cd tdesign-react-starter
npm install

启动开发服务器

安装完成后，启动开发服务器：

npm run dev

这将启动一个本地开发服务器，你可以在浏览器中访问 http://localhost:3000 查看应用。

应用案例和最佳实践

创建一个新页面

在 src/pages 目录下创建一个新的页面文件 MyPage.jsx：

import React from 'react';
import { Button } from 'tdesign-react';

const MyPage = () => {
  return (
    <div>
      <h1>我的新页面</h1>
      <Button type="primary">点击我</Button>
    </div>
  );
};

export default MyPage;

然后在 src/App.js 中引入并使用这个新页面：

import React from 'react';
import { BrowserRouter as Router, Route, Switch } from 'react-router-dom';
import MyPage from './pages/MyPage';

const App = () => {
  return (
    <Router>
      <Switch>
        <Route path="/my-page" component={MyPage} />
      </Switch>
    </Router>
  );
};

export default App;

最佳实践

• 组件复用：尽量复用已有的组件，避免重复造轮子。
• 样式管理：使用 TDesign 提供的样式系统，保持样式的一致性。
• 性能优化：使用 React 的钩子函数和 TDesign 的优化策略，提升应用性能。

典型生态项目

TDesign React Starter 可以与其他腾讯开源项目结合使用，例如：

• Taro：一个多端开发框架，可以与 TDesign 结合，实现跨平台应用开发。
• WeUI：微信官方设计团队开发的一套 UI 库，与 TDesign 结合可以更好地适配微信生态。

通过这些生态项目的结合，可以进一步扩展 TDesign React Starter 的功能和应用场景。