react-sxo
SXO 设计系统的 React 适配器,提供完整的 React Hooks 支持和类型安全。
安装
bash
pnpm add react-sxo @sxo/ui @sxo/engine @sxo/design⚡ JIT 运行时工作原理
react-sxo 深度集成了 SXO 的 JIT 引擎。与传统的引入全量 CSS 不同:
- 动态样式注入: 当 React 组件挂载时,适配器会根据组件的
props通知 JIT 引擎生成对应的样式。 - 样式池管理: 引擎会维护一个全局样式池,确保相同的样式声明只会被注入一次。
- 响应式更新: 当组件属性变化时,JIT 引擎会即时计算并更新对应的 CSS 类。
功能特性
- React Hooks: 提供
useSxo等 Hooks 接口,支持在函数组件中直接调用 JIT 引擎能力。 - SxoProvider: 充当 JIT 引擎的上下文容器,负责管理主题状态和样式注入点。
- 类型安全: 完整的 TypeScript 定义,提供属性提示与校验。
快速开始
1. 配置 Provider
在应用根目录包裹 SxoProvider:
tsx
import { SxoProvider } from 'react-sxo';
function App() {
return (
<SxoProvider theme="github">
<MyComponent />
</SxoProvider>
);
}2. 使用组件
tsx
import { Button } from 'react-sxo';
const MyComponent = () => (
<Button variant="primary" onClick={() => console.log('clicked')}>
Hello SXO
</Button>
);