技术文献

react内置类型:CSSProperties

2026-11-17

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 的区别

普通 CSSReact CSSProperties
background-colorbackgroundColor
font-sizefontSize
margin-topmarginTop
border-radiusborderRadius
z-indexzIndex

注意两个特点:

  1. CSS 属性名称使用驼峰命名法。
  2. 数值通常可以直接使用数字,例如 fontSize: 16,React 会根据 CSS 属性规则处理单位。

记住一句话:

CSSProperties 就是 TypeScript 对 React 内联 CSS 样式对象的类型约束,主要提供类型检查和代码自动补全。