Angular Academy · 课时

必需输入与转换输入

Q: 「必需输入与转换输入」这节课中我会学到什么？

将输入标记为必需项并转换其值。 你通过在浏览器中直接运行的动手代码来练习 Angular Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

将输入标记为必需项并转换其值。

必需输入与转换输入 是 CoddyKit 上的免费 Angular Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Angular Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。

超越基础输入

信号输入支持两个强大功能：将输入标记为必需，以及在存储传入值之前对其进行转换。

必需输入

当父组件必须始终提供值时，请使用 input.required()。它没有默认值。

import { input } from "@angular/core";

export class UserComponent {
  userId = input.required<string>();
}

为什么必需输入很重要

如果未绑定必需输入，Angular 会报告错误，从而及早发现问题，而不是让未定义的值悄悄传递下去。

<!-- error: userId is required -->
<app-user></app-user>

<!-- correct -->
<app-user [userId]="id"></app-user>

必需输入不会为空

由于必需输入必须提供值，因此其类型永远不会是 undefined，您可以安全地读取它而无需进行 null 检查。

userId = input.required<string>();
load() {
  return this.api.get(this.userId()); // always a string
}

转换输入

transform 选项会在传入值存储之前对其运行一个函数，适合用于强制转换。

import { input } from "@angular/core";

export class ToggleComponent {
  disabled = input(false, { transform: (v: unknown) => !!v });
}

布尔值强制转换

Angular 提供了 booleanAttribute，可将属性风格的值强制转换为真正的布尔值，非常适合表示属性是否存在的场景。

import { input, booleanAttribute } from "@angular/core";

disabled = input(false, { transform: booleanAttribute });

<!-- both work -->
<app-btn disabled></app-btn>
<app-btn [disabled]="true"></app-btn>

数字强制转换

同样，numberAttribute 可以将字符串属性转换为数字。

import { input, numberAttribute } from "@angular/core";

count = input(0, { transform: numberAttribute });

<!-- string "5" becomes number 5 -->
<app-counter count="5"></app-counter>

自定义转换函数

您可以编写任意转换逻辑来规范化值，例如去除字符串首尾的空白。

label = input("", {
  transform: (v: string) => v.trim()
});

转换输入类型与输出类型

转换函数可以接受一种类型并存储另一种类型。接受的类型是父组件绑定时使用的类型；存储的类型是您读取时得到的类型。

// accepts string | number, stores number
size = input(0, {
  transform: (v: string | number) => Number(v)
});

同时使用必需和转换

您可以将选项对象传递给 input.required()，从而同时使用必需设置和转换功能。

value = input.required({
  transform: numberAttribute
});

何时使用各项功能

使用必需设置来强制要求绑定，使用转换来强制转换或规范化传入数据，从而让组件逻辑保持简洁一致。

快速检查

测试您对必需输入和转换输入的理解。

回顾

使用 input.required() 声明必需输入（不可为空且没有默认值），并使用 transform 选项（包括 booleanAttribute 和 numberAttribute）强制转换值。两者可以结合使用。

常见问题解答

「必需输入与转换输入」课时是免费的吗？

是的 — 「必需输入与转换输入」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Angular Academy 课程的其余内容，请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。

「必需输入与转换输入」这节课中我会学到什么？

将输入标记为必需项并转换其值。你通过在浏览器中直接运行的动手代码来练习 Angular Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Angular Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「必需输入与转换输入」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Angular Academy 课中编写并运行代码吗？

能。每节 Angular Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Angular Academy