React / 系统课时
可选属性与默认值
可选属性与默认值
并非每个组件参数都必须由调用方提供。合理的可选属性可以降低使用成本,而默认值能保证省略属性时仍有明确行为。本课将用 TypeScript 的问号语法完成这一设计。
学习目标
- 能够使用
?声明可选 Props - 能够通过参数解构设置默认值
- 理解“未传入”和显式传入特殊值的区别
何时把属性设为可选
决定组件核心含义的数据应保持必填,例如卡片标题。只影响外观、辅助文案或非关键行为的配置,可以设计为可选,例如强调色、按钮文字或是否显示边框。
可选属性的类型会自动包含 undefined。组件内部必须提供回退逻辑,或在使用前判断它是否存在。
使用参数默认值
下面的 Notice 组件要求 message 必填,同时允许调用方省略 tone 和 closable。默认值直接写在参数解构位置,定义和使用保持在一起。
tsx
type NoticeProps = {
message: string;
tone?: "info" | "success" | "warning";
closable?: boolean;
};
function Notice({
message,
tone = "info",
closable = false,
}: NoticeProps) {
return (
<section>
<strong>类型:{tone}</strong>
<p>{message}</p>
{closable && <button type="button">关闭</button>}
</section>
);
}
export default function App() {
return (
<main>
<Notice message="资料已自动保存。" />
<Notice
message="课程已发布。"
tone="success"
closable={true}
/>
</main>
);
}预期结果
text
第一条提示使用 info 类型,且不显示关闭按钮。
第二条提示使用 success 类型,并显示“关闭”按钮。默认值只在属性为 undefined 时生效。调用方省略属性,或显式传入 undefined,都会触发默认值。
默认值与特殊值
不要使用 value || defaultValue 代替所有默认逻辑,因为空字符串、数字 0 和布尔值 false 都会被视为假值。它们可能是调用方有意传入的有效数据。
参数默认值和空值合并运算符 ?? 更适合保留这些值。例如 count ?? 10 只在 count 为 null 或 undefined 时使用回退值。
避免过度可选
如果大量属性都可选,组件内部会充满分支,调用方也难以预测最终界面。此时应检查组件是否承担了太多职责,或者是否应该拆成多个更明确的组件。
默认值应稳定、直观且没有昂贵副作用。需要读取时间、随机数或外部环境的值,不应悄悄作为默认行为。
按自己的节奏,确认真正理解。