10. 案例研究:RdvMedecins 应用程序的 Angular 客户端
10.1. 问题描述
[RdvMedecins]应用程序允许用户在医生诊所预约。[NestJS]课程将其编写为 HTML 应用程序,由服务器生成页面。这里我们编写的是[Angular]客户端:同样的页面,由浏览器根据服务器上的 JSON 数据生成,该服务器在“RdvMedecins 服务器:一个黑盒”一章中有所描述。
客户端必须提供 HTML 应用程序所提供的一切:
- 受验证码(CAPTCHA)保护的登录页面,并可创建患者账户;
- 某位医生某一天的日程,支持预约(患者选择窗口)和取消;
- 对于管理员:医生和客户的管理(列表、添加、编辑、删除);
- 对于患者:个人仪表板(显示即将到来的预约,可以取消)和账户管理;
- 两种语言:法语和英语;
- 唯一的 URL([/schedule?doctorId=1&day=...]),可以重新加载、添加书签,并可使用浏览器的“后退/前进”按钮进行导航。
10.2. 安装与运行
必须安装并运行 JSON 服务器(参见“RdvMedecins 服务器:一个黑盒”一章)。在浏览器中使用该客户端时,无需验证码测试模式:可以在服务器的[.env]文件中将[CAPTCHA_TEST]字段留空。
在打开到[rdvmedecins-angular]文件夹的控制台窗口中:
然后在浏览器中打开 http://localhost:4200。演示账户列在登录页面上(密码 = 登录名)。
各示例同样使用 4200 端口:首先停止当前正在运行的示例([Ctrl-C])。也可以在其他端口上启动客户端:[npm start -- --port 4300]。
10.3. 使用应用程序
10.3.1. 登录页面

密码错误:页面底部会出现一条消息,并显示一张新图片(每张图片只能使用一次):

10.3.2. 管理员和医生所见的日历
以[admin]身份登录后,会进入日历页面:

选择一位医生和一个日期,然后点击“查看日程”。URL 变为[/schedule?doctorId=1&day=2026-10-05]:

“预约”会打开预约窗口。URL 变为[/schedule?doctorId=1&day=2026-10-05&book=3]:重新加载页面(F5)会重新打开同一个窗口。

预约已保存:

“取消”会提示确认:

医生直接进入他自己的当日日程:

10.3.3. 患者门户
一位患者([martin])进入“我的空间”:

在日历中,他们会在其他患者的预约时段旁看到“已预约”:

他们无需选择患者,即可为自己预约:

他的预约显示在他的名下;“预约”按钮不再可用(只允许一个即将到来的预约),并有一条消息说明原因:

他的仪表板显示如下内容:

“管理我的账户”:任何更改都需要当前密码;这些错误来自服务器端:

如果他输入保留给管理员的地址 /doctors:

10.3.4. 管理医生和客户

填写不正确的输入:

添加成功:

同名同姓:

删除一位已有预约安排的医生的请求被拒绝:

10.3.5. 创建账户
在登录页面上,输入验证码,然后点击“创建患者账户”。填写不正确的表单随后被服务器拒绝:

账户创建后,返回登录页面;登录字段已被预先填好:

10.3.6. 法语界面
FR / EN 按钮可当场翻译页面,无需向服务器发出任何请求;浏览器标签页标题也会被翻译:

10.3.7. 会话过期,未知地址
如果令牌过期(或 Cookie 被删除),下一次请求会收到 401 响应;客户端被重定向到登录页面:

未知地址:

10.4. 客户端架构

下表将[NestJS]课程中的 HTML 应用程序与本客户端进行了对比:
HTML 应用程序(NestJS) | Angular 客户端 |
服务器生成每个页面([res.render]) | 服务器返回 JSON;[src/app/pages/] 中的组件生成页面 |
[views/layout.hbs] 及其局部视图 | [app.ts] 以及[src/app/components/]中的组件 |
控制器路由([@Get('my-area')]) | 客户端路由([app.routes.ts]);服务器只有 /api/... 路由 |
[JwtAuthGuard] 和 [RolesGuard] 重定向到 /login 或 403 页面 | 路由器守卫;服务器保留自己的守卫,返回 401 或 403 |
存放在 Cookie 中的闪现消息 | 存放在服务中的闪现消息,[MessagesService] |
由服务器读取的字典,辅助函数 [{{t}}] | 客户端中的字典,[ngx-translate];服务器只返回键 |
语言存放在 Cookie 中 | 语言存放在[localStorage]中 |
表单被拒绝:服务器重新加载页面 | 表单被拒绝:400/409 响应;客户端在字段下方显示错误 |
确认窗口:一个小脚本,[public/js/app.js] | 一个服务和一个组件,[ConfirmDialog] |
应用程序无需 JavaScript 即可运行 | 应用程序本身就是 JavaScript |
上一课中的[Vue.js] 客户端具有完全相同的结构:“store”([Pinia])变成了服务,“组合式函数”变成了服务或函数,视图变成了页面。
客户端的所有文件都显示在下方。它们带有大量注释;这些注释是课程的一部分。
10.4.1. 项目配置
10.4.1.1. package.json
- 第 8–9 行:[npm start] 启动开发服务器;[npm run build] 构建生产版本;
- 第 11–22 行:应用程序使用的库:[Angular]、[ngx-translate]、[Bootstrap]和[RxJS]的库;
- 第 23–28 行:开发工具:[Angular]编译器、[ng]命令和[TypeScript]。
10.4.1.2. angular.json
这次只有一个项目,位于文件夹根目录(第 11 行):
- 第 18 行:应用程序的入口点;
- 第 20 行:[public]文件夹的内容会原样复制到构建后的应用程序中(图标);
- 第 21 行:全局样式表:先是[Bootstrap]的样式表,然后是我们自己的;
- 第 24–30 行:生产配置。如果应用程序超出指定的大小,budgets 会触发警告(或错误);[outputHashing] 会在每个文件的名称中添加内容指纹(参见“部署”一章);
- 第 37 行:[ng build] 默认构建生产版本;
- 第 42 行:开发服务器代理;
- 第 48 行:[ng serve] 使用开发配置(未优化的代码,供调试器使用的“source maps”)。
10.4.1.3. tsconfig.json, tsconfig.app.json, proxy.conf.json
- 第 3 行:[TypeScript]的严格模式;
- 第 14 行:JSON 文件(字典)的导入;
- 第 21 行:[Angular]编译器还会检查模板中的类型。
示例 22 中的代理:/api/... 请求被转发到 JSON 服务器。
10.4.2. 启动应用程序
10.4.2.1. index.html
- 第 17 行:[Angular] 显示根组件的元素;
- 第 19 行:没有 [JavaScript],[Angular] 应用程序就无法显示任何内容:我们对此作出提示。
10.4.2.2. src/main.ts
10.4.2.3. src/app/app.config.ts
- 第 21 行:未处理的错误(例如没有人等待的被拒绝的 promise)会报告到浏览器控制台;
- 第 22 行:路由器,路由参数会传递给页面的输入(示例 17);
- 第 23 行:[TitleStrategy] 是在每次导航后设置标签页标题的路由器服务。我们用自己的服务(替换[Angular] 自带的那个[i18n/title.strategy.ts]),它会翻译标题。这正是依赖注入的意义所在:你可以用自己的类替换框架的类,而无需改动其他任何内容;
- 第 24 行:HTTP 客户端,带有我们的拦截器;
- 第 25 行:[ngx-translate]。
10.4.2.4. src/app/app.ts
- 第 22–30 行:所有页面共用的模板:导航栏、成功消息、当前页面、错误区域和确认窗口(示例 16)。
10.4.2.5. src/styles.css
- 第 24–35 行:页面底部的错误区域;
- 第 49–53 行:验证码图像。与示例 24 中一样,由[<svg>] 通过[[innerHTML]] 插入的内容只能通过全局样式来设置样式。
10.4.3. API 访问层
10.4.3.1. src/app/api/types.ts
将“RdvMedecins 服务器,一个黑盒”一章中描述的 API 翻译为[TypeScript]接口。关键字[extends] 可避免重复公共字段:[Person] 是一个 [Identity](称谓、名、姓)外加一个标识符和一个版本。
10.4.3.2. src/app/api/api-error.ts
示例 24 中的[common/api-error.ts]文件。
10.4.3.3. src/app/api/api.interceptor.ts
示例 24 中的拦截器,增加了一项新功能:对 401 响应的集中式处理。401 可能随时出现:令牌已过期、账户已被删除……与其在每个页面上处理这种情况,不如在这里统一处理一次。
- 第 28 行:一个上下文令牌 ([HttpContextToken])——附加在请求上、拦截器可以读取的信息。默认情况下,其值为[false];
- 第 33–35 行:拦截器注入它将需要的服务。[inject] 必须在函数开头调用:稍后在[catchError]中,注入上下文已不复存在;
- 第 39 行:任何错误都会变成[ApiError];
- 第 40–44 行:对于自身不处理 401 的请求,遇到 401 响应时:用户被遗忘,准备好“会话已过期”消息(将在下一页显示),并将用户重定向到登录页面;
- 第 45 行:无论何种情况,错误都会传递给发出该请求的代码。
10.4.3.4. src/app/api/rdvmedecins.api.ts
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 | |
API 访问层:每个路由对应一个方法。
- 第 40–48 行:由一个方法处理所有请求。[http.request] 接受 HTTP 方法作为参数;[firstValueFrom] 将其转换为 promise;
- 第 45 行:请求携带上下文令牌[IGNORE_401]:对于自行处理 401 的路由为 true。密码错误会返回 401:这并不是会话过期!同样,当没有人登录时,[GET /api/auth/me] 会返回 401,这是正常的;
- 第 77–83 行:[HttpParams] 生成 URL 参数(?day=...&doctorId=...)。[HttpParams] 对象不会改变:[set] 返回一个新对象;
- 第 85 行:[clientId ?? undefined]:如果缺少 [clientId],则根本不发送它;
- 第 92–106 行:医生和客户的处理方式相同:类型(['doctors'] 或 ['clients'])是地址的一部分;
- 第 119 行:带有包含当前密码的请求体的 DELETE,删除账户时必须提供。
10.4.4. 语言
10.4.4.1. src/app/i18n/i18n.ts
示例 21 中的[ngx-translate] 配置:
- 第 30–40 行:源语言是用户最后选择的语言;否则,如果浏览器语言是法语则使用法语,其他情况则使用英语。访问[localStorage] 可能会失败(在某些隐私浏览模式下),因此在这种情况下我们跳过它。
10.4.4.2. src/app/i18n/language.service.ts
- 第 13 行:当前语言,一个信号;
- 第 20–28 行:切换语言:页面被重新翻译(第 21 行),页面的[lang]属性被更新(第 22 行),所选语言被保存(第 24 行)。
10.4.4.3. src/app/i18n/title.strategy.ts
每个路由都会声明一个标题,这里它是一个翻译键('SCHEDULE.PAGE_TITLE')。默认情况下,[Angular] 会将其原样写入标签页。这个类取代了路由器的[TitleStrategy]服务(app.config.ts,第 23 行):
- 第 20 行:它继承了[TitleStrategy]类,该类来自[Angular];
- 第 30–33 行:[updateTitle] 由路由器在每次导航后调用;[buildTitle]是继承而来的,提供所显示路由声明的标题;
- 第 35–38 行:翻译后的标题,后面跟着应用程序名称:“Schedule - RdvMedecins”;
- 第 27 行:当语言改变时,最后一个标题会被重新翻译。
10.4.4.4. 字典
字典[fr.json] 和[en.json] 来自[NestJS]课程中的 HTML 应用程序,并补充了一些客户端专用的键([ERRORS.SERVER_UNREACHABLE]……)。只有其参数语法有所变化:[{{min}}] 用于[ngx-translate]。JSON 服务器返回相同的键。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | |
10.4.5. 服务
10.4.5.1. src/app/services/session.service.ts
已登录的用户,位于一个信号服务中(示例 20):
- 第 22 行:状态:用户,或[null]。令牌本身不在这里:它在只有浏览器才会处理的 Cookie 中;
- 第 26–32 行:组件读取的内容:用户,以及由此推断出的内容(用户是否已登录?是 ADMIN 吗?是患者吗?);
- 第 35 行:每个角色的主页;
- 第 39–45 行:启动时(以及按 F5 之后),服务并不知道谁已登录:它会询问服务器。[check] 在每次导航之前由路由器守卫调用,但只在第一次时查询服务器:promise 被保留下来(第 40 行,[??=]:“如果它尚不存在”),并在之后每次调用时返回。如果两次导航紧接着发生,它们会等待同一个响应;
- 第 43 行:401(没有人登录)或服务器不可达:没有用户;
- 第 56–62 行:登出;[finally]:即使服务器没有响应,用户也会被遗忘;
- 第 65–67 行:在不向服务器发送请求的情况下忘记用户:这正是拦截器在遇到 401 时所做的事。
10.4.5.2. src/app/services/messages.service.ts
向用户显示的消息,与 HTML 应用程序中一样:页面顶部的成功消息,页面底部的错误消息。消息是一个翻译键:如果用户切换语言,它会自动重新翻译。
- 第 29–30 行:当前页面上的两条消息;
- 第 58–63 行:[ApiError] 会成为页面的错误消息;任何其他错误属于客户端问题,允许报告;
- 第 71–74 行:为下一个页面准备的 flash 消息。以页面跳转结束的操作(添加了医生、返回列表)因此会显示其消息;
- 第 39–43 行:服务监听路由器事件(示例 17)。每次导航结束时(第 76–80 行),上一页的消息消失,flash 消息出现。在服务器端,这是短期 Cookie 的作用。
10.4.5.3. src/app/services/confirmation.service.ts
示例 16 中的服务。消息现在是一个翻译键(第 18 行),新的提问会清除上一个操作的消息(第 25 行)。
10.4.5.4. src/app/services/form-submission.ts
应用程序中的所有表单都遵循示例 25 所示的模式:规则由服务器验证,如果表单被拒绝,每个字段的错误会显示在该字段下方,页面底部显示一条通用错误消息。该类把这些操作集中在一起,这样就不必在每个页面上重复:
- 第 24 行:一个 泛型类:[T] 是表单模型类型;
- 第 25 行:[inject] 位于字段初始化中:该类必须在注入上下文中创建,即在组件字段初始化期间(第 12 行);
- 第 27 行:错误消息的参数([{{min}}]……),由服务器返回;
- 第 35–54 行:提交。[submit](示例 25)执行操作;该方法返回 [true] 表示操作成功;
- 第 39 行:[ignoreValidators]:默认情况下(['pending']),[submit] 在表单存在验证错误时不执行操作(登录页面有一个包含两个必填字段的模式)。['all']:仍然发送请求(见登录页面);
- 第 46 行:通用消息;
- 第 57–62 行:字段错误。[isFieldTree] 验证表单确实有该名称的字段:服务器可能报告表单并未显示的字段的错误。
10.4.6. 格式化
10.4.6.1. src/app/pipes/formatting.ts
服务器发送原始数据([startHour: 8, startMinute: 0];[day: "2026-10-05"]);格式化取决于语言,由客户端负责:
- 第 34–40 行:这是有效日期吗?[2026-02-30] 格式正确,但并不存在:[new Date] 会把它转换为 3 月 2 日。因此我们验证它读回后是否相同。[day is string]:如果函数返回 true,[TypeScript] 就知道 [day] 是字符串;
- 第 43–48 行:[Intl.DateTimeFormat]由浏览器提供,以所请求的语言书写日期。UTC 时区可避免位于格林尼治以西的浏览器显示前一天。
10.4.6.2. src/app/pipes/formatting.pipes.ts
同样的函数,以管道的形式用于模板。[longDate] 接收语言作为参数:纯管道(示例 09)只有在其某个参数改变时才会重新计算;因此,更改语言会触发重新计算。
10.4.7. 路由器
10.4.7.1. src/app/app.routes.ts
与 HTML 应用程序相同的 URL(/login、/schedule、/doctors、/my-area……),但它们现在是客户端路由:
- 第 50–53 行:所有页面都是某个无组件路由的子路由([children]),该路由带有守卫[sessionGuard]:[canActivateChild] 将其应用于每个子路由,无需重复;
- 第 55 行:地址 / 指向登录页面,如果用户已登录,登录页面再重定向到该角色的主页;
- 第 56–57 行:两个访问量最大的页面包含在主文件中;其余页面按需加载([loadComponent]);
- [title]:标签页标题的翻译键;
- [data]:[public](无需登录即可访问),[roles](授权角色;缺省:所有已登录角色),[type](['doctors'] 或 ['clients']),[code](403、404)。得益于 [withComponentInputBinding],路由数据也会传入页面组件的 输入,例如地址参数;
- 第 34–47 行:医生管理系统的三个路由和客户管理系统的路由由同一个函数生成:两个系统使用相同的页面,只是 [type] 不同;
- 第 41 行:[canMatch]:一个判断路由是否匹配地址的守卫。如果失败,路由器会尝试后续路由:因此 /doctors/abc/edit 会指向 404 页面;
- 第 65 行:账户创建页面专用的守卫;
- 第 79 行:403 页面,守卫将用户重定向到该页面;
- 第 80–85 行:任何其他地址:404 页面。
10.4.7.2. src/app/guards.ts
- 第 27 行:守卫可以是 [async]:路由器会等待其响应;
- 第 28–30 行:注意:[inject] 只允许出现在守卫的开头,即在任何 [await] 之前;此后注入上下文就丢失了;
- 第 30 行:第一次时,向服务器询问当前登录的是谁;
- 第 32–38 行:公共页面;但登录页面对已登录用户不再有意义(第 34 行)。[parseUrl] 将地址转换为 [UrlTree],这是触发重定向的值;
- 第 39–42 行:未登录:跳转到登录页面,同时保留所请求的页面;
- 第 43–46 行:无效角色:重定向到 403 页面;
- 第 52–62 行:创建账户需要一张“通行证”,通过在登录页面解决验证码(CAPTCHA)获得。没有它,用户会被带回登录页面并收到一条消息;
- 第 66 行:守卫 [canMatch] 接收地址段:[['doctors', '3', 'edit']]。
这些守卫只是为了方便:数据保护由服务器保证,服务器在每次请求时都会重新验证令牌和角色。
10.4.8. 组件
10.4.8.1. src/app/components/nav-bar
- 第 29 行:注销,即使服务器没有响应;然后返回登录页面。
- 第 4–23 行:菜单,取决于角色;
- 第 31–36 行:FR / EN 按钮;[aria-pressed] 向屏幕阅读器指示哪个按钮被按下;
- 第 39–43 行:角色、姓名、注销。
10.4.8.2. src/app/components/success-message.ts and error-panel.ts
两个小组件,显示来自[MessagesService]服务的消息,并连同参数一起翻译。[status]和[alert]角色会让屏幕阅读器播报这些消息。
10.4.8.3. src/app/components/confirm-dialog
示例 16 中的窗口,增加了键盘支持:
- 第 34–45 行:一个跟踪“否”按钮出现和消失的 effect。打开时,保留原本拥有焦点的元素,并把焦点交给“否”按钮;关闭时,焦点回到保留的元素(例如被点击的“删除”按钮)。[untracked]:在该函数中读取的信号不会成为 effect 的依赖项;
- 第 48–64 行:键盘。Esc 回答“否”;Tab 和 Shift+Tab 停留在窗口内:从最后一个按钮回到第一个,反之亦然。否则,焦点会移到后面变灰的页面上;
- 第 67–71 行:点击变灰的背景会回答“否”。
- 第 2 行:在包含窗口的元素上监听按键;
- 第 14 行:消息,一个翻译键。
10.4.8.4. src/app/components/input-field.ts
一个完整的表单字段:标签、字段、提示或错误消息。应用程序中的所有表单都使用它。它是一个 自定义表单控件:遵循 [FormValueControl] 契约,它接受 [[formField]] 指令,就像接受普通的 [<input>] 一样:
- 第 46 行:该类实现 [FormValueControl<string>] 接口:编译器会验证它是否符合契约;
- 第 48 行:[value],一个 [model()](示例 11):字段的值,[[formField]] 指令对其既读又写;
- 第 49 行:[errors],契约的一个可选输入:如果组件声明了它,指令会把字段的错误存放在那里;
- 第 54–61 行:组件专有的输入。元素 [<input>] 的标识符命名为 [fieldId],而不是 [id]:因为 [id] 属性如果设置在 [<app-input-field>] 上,也会保留在该元素上,页面就会有两个具有相同标识符的元素;
- 第 61 行:[booleanAttribute] 将属性的存在([mandatory],不带值) 转换为 [true];
- 第 64 行:字段的第一个错误:其翻译键;
- 第 36–38 行:[<input>] 元素显示值,并在每次按键时返回它(第 66–68 行)。[aria-invalid] 和 [aria-describedby] 为屏幕阅读器将字段与其消息关联起来;
- 第 39–43 行:错误消息,否则为帮助消息,连同其参数一起翻译;
- 第 29–33 行:[:host] 指组件元素本身([<app-input-field>])。浏览器不认识的元素按“内联”显示:把它转换为块级元素,这样父级应用的类([col-sm-6])才能生效。
10.4.8.5. src/app/components/person-fields.ts
称谓、名和姓字段,三个表单共用。父级把基于信号的表单中的这三个 字段 传递给该组件:
- 第 42–44 行:字段([FieldTree])和其他值一样,是一个值:可以作为输入接收;
- 第 25 行:[title()] 是作为输入接收的字段;[title()()] 是它的状态;
- 第 26 行:称谓列表通过 [[formField]] 与字段绑定;
- 第 36–37 行:另外两个字段传递给 [InputField] 组件。
10.4.8.6. src/app/components/captcha-field.ts
验证码(CAPTCHA)图片及其输入字段:另一个自定义表单控件。
- 第 61 行:组件创建后立即加载一张图片;
- 第 65–72 行:[reload] 是 public:登录页面在每次尝试后调用它,因为每张图片只使用一次;
- 第 75–77 行:所显示图片的 ID,随答案一起发送;
- 第 37 行:SVG 图片(示例 22),带有供屏幕阅读器使用的替代文本;
- 第 40 行:[autocapitalize] 和 [spellcheck]:在手机上不自动大写,也不进行拼写检查。
父页面通过 [viewChild(CaptchaField)](示例 13)获取该组件,以调用其公共方法。
10.4.8.7. src/app/components/booking-dialog
预订时段窗口。它不与服务器通信:它接收要显示的内容,并发送用户的决定;执行操作的是日历页面。
- 第 29–32 行:输入:时间段、可供选择的患者(ADMIN、DOCTOR),或患者本人(USER),以及一个“正在发送”指示器;
- 第 34–35 行:输出:确认(携带所选患者);关闭;
- 第 25 行:Esc 关闭窗口;
- 第 43 行:[afterNextRender](示例 13):窗口显示后,焦点移到患者列表,否则移到确认按钮。
- 第 5 行:一个表单:Enter 键确认;
- 第 16–26 行:患者为自己预订:没有列表;
- 第 21–24 行:[[ngValue]](示例 05):每个选项的值是一个数字,或 [null];
- 第 31 行:提交期间按钮被禁用:双击不会导致重复预订。
10.4.9. 页面
10.4.9.1. src/app/pages/login
登录页面:用户名、密码、验证码(CAPTCHA),以及第二个“创建患者账户”按钮,它在允许创建账户之前验证同一个验证码。
- 第 31–32 行:两个 URL 参数:/login?login=jbernard 预填用户名(紧接在创建账户之后);由守卫设置的 /login?redirect=/doctors 指定登录后要打开的页面;
- 第 43–46 行:应用程序中唯一带有 模式的表单:用户名和密码为必填。于是 [[formField]] 指令会在两个字段上设置 HTML 属性 [required],只要它们为空,浏览器就拒绝提交表单;
- 第 47 行:提交表单(services/form-submission.ts);
- 第 49 行:验证码组件,用于调用其方法;
- 第 52–58 行:[afterNextRender]:页面显示后,输入已知。URL 中的登录名被复制到表单中(限 30 个字符),焦点设置在第一个空字段上。[focusBoundControl()] 把焦点设置到由 [[formField]] 与字段关联的元素上;
- 第 63–75 行:两个按钮都遵循这个顺序:提交,然后如果失败,就换一张新图片(每张只使用一次)。顺序很重要:[reload] 会清空验证码字段,这会移除与该字段关联的错误;因此我们要“先”重新加载图片,以便再次触发该错误,[FormSubmission] 随后会把它与字段关联起来;
- 第 77–87 行:登录,随后导航到所请求的页面或该角色的主页。与示例 18 一样,只接受内部路径(第 84 行);
- 第 89–94 行:第二个按钮。服务器验证验证码并设置一张“通行证”(一个 Cookie);随后打开账户创建页面。这里不使用用户名和密码:模式规则被忽略(第 93 行)。
- 第 6 行:这里没有 [novalidate]:浏览器会提示用户名或密码为空;
- 第 18 行:自定义验证码控件,与表单中的 [captcha] 字段关联;
- 第 21 行:提交期间按钮被禁用([submitting()]);
- 第 25 行:[type="button"]:该按钮不提交表单,因此浏览器不要求填写用户名和密码。
10.4.9.2. src/app/pages/schedule
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 | |
应用程序中功能最丰富的页面。与 HTML 应用程序一样,页面的全部状态都包含在其 URL 中:/schedule?doctorId=1&day=2026-10-05 显示一个日历,&book=7 则加上预订窗口。因此可以重新加载页面、将其加入书签,并使用后退/前进按钮。原则是:页面跟随其 URL,而用户的操作改变URL。
- 第 51–53 行:三个 URL 参数,作为输入;
- 第 39–42 行:地址参数可以包含任何内容;要对其进行验证;
- 第 69–70 行:“医生 + 日期”表单的值,从 URL 复制而来;
- 第 73 行:所显示日历的参数,不含预订窗口;
- 第 77–80 行:预订窗口所打开的时间段,根据地址([?book=7])和日历计算得出:仅当该用户可预订时才有。这是一个 [computed]:地址变化时,窗口自动打开或关闭;
- 第 89–93 行:一个依赖于两个输入 [doctorId] 和 [day] 的 effect:其中任何一个变化时,日历都会重新加载。重新加载在 [untracked] 中执行:其中读取和修改的信号不会成为该 effect 的依赖项。输入 [book] 不会被读取:打开或关闭窗口不会重新加载日历;
- 第 99–109 行:医生,以及对有权查看患者的用户显示的患者;
- 第 111–141 行:加载日历。无效日期会被报告(第 115–118 行);没有指定医生时,DOCTOR 看到的是他自己的日历:服务器从令牌中获取(第 126–129 行);
- 第 153–159 行:“查看日程”和关闭窗口会改变地址;日历随之更新;
- 第 161–187 行:预约预订。如果成功,会准备一条 flash 消息(第 169 行);它将在第 185 行之后显示,该行关闭窗口。如果没有选择患者,窗口保持打开(第 171–175 行)。任何其他错误(时间段在此期间被占用等)都会显示在日历上,同时窗口关闭。在所有情况下,都会重新读取日历:以服务器的记录为准(第 186 行);
- 第 189–200 行:取消,需经确认。
- 第 2–21 行:选择医生和日期,使用 [ngModel](示例 05);
- 第 23 行:[@let]:日历,只读取一次;
- 第 26–30 行:已经有一个即将到来的预约的患者:服务器发送一条消息,解释为什么没有“预订”按钮;
- 第 37 行:以本地语言完整拼写的日期;
- 第 52–58 行:时间段的状态:可用、患者(以蓝色显示),或在服务器没有发送患者姓名时显示“已预订”;
- 第 63–67 行:“预订”是一个 链接:它在 URL 中加上 &book=...,从而打开预订窗口;
- 第 87–91 行:预订窗口,仅当 URL 包含 &book=... 且该时间段可预订时才显示。
10.4.9.3. src/app/pages/persons/persons.config.ts
管理医生和客户的页面是相同的:同样的列表,同样的表单。与 HTML 应用程序一样(抽象类 [PersonsController]),它们只写一次;唯一变化的是 API 地址和标签键,这里对此进行了描述:
- 第 25 行:[Record<PersonType, PersonKeys>]:编译器要求每种类型恰好有一个条目,不多也不少;
- 第 49–51 行:“已添加 / 已修改 / 已删除”消息的参数。
10.4.9.4. src/app/pages/persons
- 第 26 行:[export default]:路由按需加载该页面(示例 17);
- 第 27 行:类型(['doctors'] 或 ['clients']) 来自路由的输入数据;
- 第 33 行:此类型的标签键;
- 第 34 行:[null]:列表尚未加载;
- 第 37–39 行:[ngOnInit](示例 13)而不是构造函数:此时输入已经可用;
- 第 49–61 行:删除,需经确认。仍有预约的医生不能被删除:服务器返回 409 响应,并显示其消息。
- 第 3 行:[['/', type(), 'add']]:/doctors/add 或 /clients/add;
- 第 8–12 行:加载期间、空列表、列表;
- 第 32 行:/doctors/3/edit。
10.4.9.5. src/app/pages/person-form
创建(/doctors/add)或修改(/doctors/3/edit)医生或客户:
- 第 37 行:地址参数 [:id],创建时不存在。选项 [transform] 将其转换为数字([numberAttribute]);
- 第 44 行:是创建还是修改?
- 第 46–48 行:没有验证器的表单(服务器验证一切),及其提交;
- 第 51–67 行:对于更新,会读取记录,包括 其版本;将用这些修改对其进行更新(乐观锁)。不存在的记录(/doctors/999/edit)会重定向到列表并显示一条消息;
- 第 69–85 行:保存。成功后会闪现一条消息,用户被重定向到列表(第 75 行和第 78–79 行)。如果记录在此期间已被另一位管理员删除,用户同样被重定向到列表(第 80–84 行);任何其他错误都会使表单继续显示,并附带其错误信息。
- 第 6 行:[novalidate]:由服务器验证表单;
- 第 7 行:称谓、名和姓,位于同一个组件中;
- 第 10–15 行:用户名和密码,创建和修改时使用不同的帮助消息。密码从不预填:服务器从不返回它;
- 第 14 行:服务器返回的错误消息所用的参数(例如密码的最小长度)。
10.4.9.6. src/app/pages/register
创建患者账户。只有持有服务器在验证码(CAPTCHA)通过后颁发的令牌,才能继续(guards.ts):
- 第 25 行:密码的最小长度;用于帮助消息:与服务器的值相同;
- 第 41 行:帮助消息和密码错误消息的参数。如果服务器返回了参数,则以服务器的参数为准(它们被放在最后);
- 第 46–48 行:提交;服务器返回所创建账户的用户名;
- 第 49–52 行:返回登录页面,并预填用户名;
- 第 53–57 行:令牌已过期(15 分钟):返回验证码页面。
- 第 7 行:称谓、名、姓;
- 第 10–17 行:用户名、密码和确认密码——这次为必填([mandatory] 属性只是提示:由服务器决定)。
10.4.9.7. src/app/pages/patient-area
患者的主页:两个选项(“管理我的账户”“查看日程”)以及其即将到来的预约,患者可以取消该预约(第 45–56 行)。
- 第 2 行:由管道计算出的翻译参数;
- 第 22 行:[$last]:最后一行没有边框;
- 第 29 行:指向该日医生日历的链接。
10.4.9.8. src/app/pages/my-account
两个相互独立的表单:账户修改和账户删除。两者都需要当前密码,由服务器验证。两个表单,因此有两个模型、两棵字段树,以及两个[FormSubmission]:一个表单中的错误不会出现在另一个表单中。
- 第 60–67 行:读取账户,并将其值复制到模型中(包括版本号);
- 第 74 行:修改之后,服务器返回更新后的用户(并已颁发新的令牌):导航栏必须随之更新;
- 第 83 行:提交被拒绝后,清除当前密码。我们更新的是字段(而不是整个表单):只有该字段的错误消失;其他错误仍然显示;
- 第 87–98 行:确认后删除账户。服务器已删除令牌 Cookie:用户被遗忘,页面返回登录页面。
10.4.9.9. src/app/pages/error/error.ts
错误页面,403 或 404:错误码作为输入从路由数据传入([data.code])。