TDesign React UI 组件库使用指南

1. 项目介绍

TDesign React 是一个专为React 16.x及桌面应用程序设计的UI组件库。它提供了高质量的组件，与TDesign在其他框架上的组件库保持一致的API和界面。支持暗模式以及可自定义的主题，并且优化了树摇（tree-shaking）以减少最终包的体积。

2. 项目快速启动

安装依赖

使用npm、yarn或pnpm安装TDesign React组件库：

npm install tdesign-react
# 或者
yarn add tdesign-react
# 或者
pnpm add tdesign-react

引入组件及样式

在你的React应用中引入所需的组件及其样式：

import React from 'react';
import { Button } from 'tdesign-react';
import 'tdesign-react/es/style/index.css';

function App() {
  return <Button>Hello TDesign</Button>;
}

ReactDOM.createRoot(document.getElementById('app')).render(<App />);

3. 应用案例和最佳实践

在实际应用中，可以通过组合TDesign React提供的组件，创建出具有专业外观和交互体验的应用。例如，构建一个登录表单：

import React, { useState } from 'react';
import { Form, Input, Button } from 'tdesign-react';

const LoginForm = () => {
  const [username, setUsername] = useState('');
  const [password, setPassword] = useState('');

  const handleSubmit = (e) => {
    e.preventDefault();
    console.log(`Logging in as ${username}:${password}`);
  };

  return (
    <Form onSubmit={handleSubmit}>
      <Form.Item label="用户名" required>
        <Input value={username} onChange={(value) => setUsername(value)} />
      </Form.Item>
      <Form.Item label="密码" required>
        <Input type="password" value={password} onChange={(value) => setPassword(value)} />
      </Form.Item>
      <Form.Item wrapperCol={{ span: 24 }}>
        <Button block type="primary" htmlType="submit">
          登录
        </Button>
      </Form.Item>
    </Form>
  );
};

ReactDOM.createRoot(document.getElementById('app')).render(<LoginForm />);

遵循以下最佳实践以提高用户体验：

• 使用统一的颜色和字体风格。
• 在组件间保持一致的间距和排列。
• 根据应用需求灵活利用组件的props定制样式和行为。

4. 典型生态项目

TDesign 支持多平台和框架，包括：

• Vue 3.x 的组件库：tdesign-vue-next
• Vue 2.x 的组件库：tdesign-vue
• 微信小程序 的组件库：tdesign-miniprogram

这些组件库共同构成了TDesign丰富的生态系统，为跨平台开发提供了一致的设计语言和开发体验。