Skip to Content
Week 20 - Avalonia 工业专项Day 5 - 键盘、焦点、可访问性与本地化

Day 5 - 键盘、焦点、可访问性与本地化

建议用时:150-210 分钟

你将学会什么

  • 设计 Tab 顺序和快捷键
  • 为状态提供文字和辅助名称
  • 使用资源完成本地化

现场操作经常戴手套、只用键盘或使用不同语言。界面必须可聚焦、可读、可翻译。 今天的 3 个例子都要亲手敲,不能只复制,也不能只看运行结果。

标为 Program.cs 的最小例子可以放进控制台练习项目;标为 Service、ViewModel、XAML 或 SQL 文件的例子,要在本周项目中按前一天已经建立的模型继续敲。文件名和上下文不同,不要把所有片段塞进同一个 Program.cs

学习衔接

这是 Week 20 的第 5 天。先使用前面已经掌握的 C#、异步、异常、接口和 MVVM,只增加今天这一层上位机能力。

今天的最低通过线

顺序必须掌握怎么证明
1设计 Tab 顺序和快捷键能用自己的话解释并完成对应例子
2为状态提供文字和辅助名称能用自己的话解释并完成对应例子
3使用资源完成本地化能用自己的话解释并完成对应例子

先用大白话理解

现场操作经常戴手套、只用键盘或使用不同语言。界面必须可聚焦、可读、可翻译。

学习时固定按这个顺序:

先看数据是什么 -> 再看最小代码 -> 对照运行结果 -> 修改一个参数 -> 故意制造错误 -> 最后组合进上位机项目

例子 1:键盘操作顺序

文件:DevicePage.axaml

<TextBox TabIndex="0" Watermark="搜索设备" /> <Button TabIndex="1" Content="查询" /> <DataGrid TabIndex="2" />

运行结果或界面效果:

按 Tab 依次进入搜索、查询和表格

必须改一次: 不用鼠标完成一次查询。

例子 2:状态不只靠颜色

文件:AlarmBadge.axaml

<StackPanel Orientation="Horizontal"> <Ellipse Fill="Red" Width="12" Height="12" /> <TextBlock Text="高温报警" Margin="8,0,0,0" /> </StackPanel>

运行结果或界面效果:

红色图形同时配有高温报警文字

必须改一次: 为屏幕阅读器设置辅助名称。

例子 3:本地化资源键

文件:DashboardView.axaml

<TextBlock Text="{DynamicResource Dashboard_Title}" /> <Button Content="{DynamicResource Common_Confirm}" />

运行结果或界面效果:

切换资源字典即可更换语言

必须改一次: 准备 zh-CN 和 en-US 两套资源。

常见错误和修法

  1. 只用红绿区分状态
  2. 快捷键触发危险操作却没有确认
  3. 界面文字直接散落在所有 XAML 文件

修错顺序固定为:先看第一条异常和行号,再看输入数据,再看原始字节或状态,最后才怀疑框架。

小白重复敲写训练

  1. 不看上面的代码,重新敲“键盘操作顺序”。
  2. 不看上面的代码,重新敲“状态不只靠颜色”。
  3. 不看上面的代码,重新敲“本地化资源键”。
  4. 完成改动任务:不用鼠标完成一次查询。
  5. 完成改动任务:为屏幕阅读器设置辅助名称。
  6. 完成改动任务:准备 zh-CN 和 en-US 两套资源。

每日小测

  1. 今天的知识在上位机里解决什么问题?
  2. 三个例子分别输入了什么,输出了什么?
  3. 如果运行结果不对,你第一步检查什么?
  4. 哪一段代码负责停止、超时或错误处理?

小测答案

答案不能只背一句话。回到三个例子,用代码中的变量、方法和输出逐项说明。能脱离页面说清楚,才算真的理解。

今日作业

  1. 新建空项目,不复制地重做三个例子。
  2. 每个例子都完成“必须改一次”。
  3. 故意制造一个错误,记录错误文字和修复办法。
  4. 把今天代码提交到自己的练习仓库。

作业验收

  • 三个例子都能运行或显示预期界面。
  • 能解释关键数据从哪里来、经过什么处理、最后去哪里。
  • 失败时不会让程序无提示崩溃。
  • 能说出今天内容如何进入“可长期运行的工业操作台”。