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 时使用回退值。

避免过度可选

如果大量属性都可选,组件内部会充满分支,调用方也难以预测最终界面。此时应检查组件是否承担了太多职责,或者是否应该拆成多个更明确的组件。

默认值应稳定、直观且没有昂贵副作用。需要读取时间、随机数或外部环境的值,不应悄悄作为默认行为。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

可选属性与默认值

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通