React / 系统课时
JSX 属性与样式
JSX 属性与样式
本课把动态数据应用到 JSX 属性和样式中。你将掌握 className、驼峰属性、布尔属性、动态属性与行内样式对象,并学会在固定样式和少量动态样式之间做合理选择。
学习目标
- 正确书写 JSX 属性和常见特殊名称
- 使用表达式设置动态属性与布尔属性
- 选择 CSS 类名或行内样式对象实现界面样式
JSX 属性的基本规则
JSX 属性接近 HTML 属性,但名称要符合 JavaScript 对象属性习惯。CSS 类使用 className,for 使用 htmlFor,事件使用 onClick、onChange 等驼峰形式。
字符串常量可以写成 title="课程卡片",变量和计算结果使用 title={courseName}。布尔属性写成 disabled={true} 或简写为 disabled;需要动态控制时使用 disabled={!available}。
aria-* 和 data-* 保持短横线写法,例如 aria-label、data-course-id。这些属性分别用于可访问性和自定义数据,不应改成驼峰形式。
动态类名与行内样式
下面示例包含固定类名、条件类名、动态属性和样式对象。将其写入 src/App.tsx:
import "./App.css";
type CourseCardProps = {
name: string;
progress: number;
available: boolean;
};
function CourseCard({ name, progress, available }: CourseCardProps) {
// 类名表达离散状态,样式对象承载连续的进度值。
const cardClassName = available ? "course-card" : "course-card is-disabled";
const progressStyle = { width: `${progress}%` };
return (
<article className={cardClassName} data-course-name={name}>
<h2>{name}</h2>
<div className="progress" aria-label={`学习进度 ${progress}%`}>
<div className="progress__value" style={progressStyle} />
</div>
<button type="button" disabled={!available}>
{available ? "继续学习" : "暂不可用"}
</button>
</article>
);
}
export default function App() {
// available 简写等价于 available={true}。
return <CourseCard name="React 基础" progress={40} available />;
}在 src/App.css 中加入样式:
.course-card {
max-width: 360px;
padding: 16px;
border: 1px solid #cbd5e1;
border-radius: 12px;
}
.course-card.is-disabled {
opacity: 0.55;
}
.progress {
height: 8px;
overflow: hidden;
background: #e2e8f0;
border-radius: 999px;
}
/* 宽度由组件的行内样式动态提供。 */
.progress__value {
height: 100%;
background: #2563eb;
}预期结果:页面显示一张“React 基础”课程卡片,进度条宽度为 40%,按钮文字为“继续学习”且可用。把 available 改为 false 后,卡片透明度降低,按钮变为禁用状态。
行内样式是 JavaScript 对象
style 接收对象,不接收 CSS 字符串。属性名使用驼峰,例如 backgroundColor,数值属性是否自动补单位取决于具体 CSS 属性。示例把百分比拼成字符串,明确生成 40%。
行内样式适合少量由运行时数据决定的值,例如进度宽度、坐标或主题变量。固定布局、颜色和响应式规则更适合放在 CSS 文件中,这样更易复用,也能使用媒体查询和伪类。
动态类名要保持简单
只有两个状态时,条件运算足够清晰。状态增多后,可以先计算类名数组,或使用专门的类名组合工具。不要在 className 中嵌套多层条件表达式,否则样式规则会难以排查。
类名表达的是界面状态,而不是业务过程。示例使用 is-disabled 描述最终外观状态,比 request-failed-and-no-permission 更稳定。
属性传递的边界
传给原生元素的属性最终可能进入 DOM,因此不要随意把业务对象整体展开到 <div> 或 <button>。未知属性可能产生警告,也可能把不必要数据暴露到页面结构中。
传给自定义组件的属性由组件自行定义。使用 TypeScript 类型声明必需字段和数据类型,可以在编码阶段发现漏传或类型错误。