CSSProperties 是 React 提供的 TypeScript 类型定义(Type Definition)。
在 React + TypeScript 中,CSSProperties 是一个 TypeScript 内置的类型(Type),主要作用是:
规定 JavaScript 对象中的 CSS 样式属性及其值的类型,让你能够在 TypeScript 中安全地编写内联 CSS 样式。
它不是一个 CSS 类,也不是一个 React 组件,而是一个类型定义。
1. 基本用法
import { CSSProperties } from 'react';
const style: CSSProperties = {
color: 'red',
fontSize: '16px',
backgroundColor: '#f5f5f5',
marginTop: '10px'
};
function App() {
return <div style={style}>Hello React</div>;
}
这里:
CSSProperties:规定 style 对象允许使用哪些 CSS 属性。style:实际存放 CSS 样式的 JavaScript 对象。style={style}:把样式对象传递给 React 的 DOM 元素。
2. 为什么需要 CSSProperties?
例如,你这样写:
const style: CSSProperties = {
color: 'red',
fontSize: '16px',
backgroundColor: '#fff'
};
TypeScript 会检查:
color 是合法的 CSS 属性。fontSize 是合法的 CSS 属性。backgroundColor 是合法的 CSS 属性。- 属性值是否符合相应的类型要求。
如果你写错了:
const style: CSSProperties = {
colr: 'red'
};
TypeScript 就会提示错误,因为 colr 不是合法的 CSS 属性名称。
3. 在组件 Props 中使用
如果你想让一个 React 组件接收外部传入的样式,可以这样写:
import { CSSProperties } from 'react';
interface ButtonProps {
title: string;
style?: CSSProperties;
}
function MyButton({ title, style }: ButtonProps) {
return (
<button style={style}>
{title}
</button>
);
}
// 使用组件
<MyButton
title="提交"
style={{ color: 'red', fontSize: '18px' }}
/>
这里的 style?: CSSProperties 表示:
style 是一个可选属性。- 如果传入,必须是符合 CSSProperties 定义的 CSS 样式对象。
4. CSSProperties 和普通 CSS 的区别
| 普通 CSS | React CSSProperties |
|---|
background-color | backgroundColor |
font-size | fontSize |
margin-top | marginTop |
border-radius | borderRadius |
z-index | zIndex |
注意两个特点:
- CSS 属性名称使用驼峰命名法。
- 数值通常可以直接使用数字,例如
fontSize: 16,React 会根据 CSS 属性规则处理单位。
记住一句话:
CSSProperties 就是 TypeScript 对 React 内联 CSS 样式对象的类型约束,主要提供类型检查和代码自动补全。