首页
/ Khan Academy Perseus 53.1.0版本技术解析

Khan Academy Perseus 53.1.0版本技术解析

2025-07-02 22:16:31作者:咎竹峻Karen

Perseus是Khan Academy开发的一个开源数学交互式内容渲染引擎,主要用于呈现数学题目、图表和交互式组件。最新发布的53.1.0版本带来了一系列功能增强和问题修复,特别关注了组件公共选项导出和屏幕阅读器支持方面的改进。

核心功能增强

组件公共选项导出机制

53.1.0版本为多个交互式组件引入了公共选项导出功能,这一机制允许开发者获取组件的配置选项而不包含评分相关的内部数据。具体实现包括:

  1. 交互式图表组件:新增了获取公共选项的函数,可以提取用户配置的图表参数,如坐标轴范围、网格线设置等,同时过滤掉评分标准等内部数据。

  2. 表格组件:实现了表格配置的公共选项导出,包括行列设置、单元格内容等可公开的配置项。

  3. 矩阵组件:支持导出矩阵的维度、元素值等公共配置,便于在其他场景复用矩阵布局。

  4. 绘图器组件:新增了过滤评分数据的选项导出功能,保留了绘图区域设置、工具配置等公开参数。

  5. Grapher组件:实现了函数绘图器的公共选项导出,包括函数表达式、坐标范围等核心配置。

这种标准化的公共选项导出机制为组件复用和配置管理提供了更好的支持,特别是在需要将Perseus组件集成到其他系统时特别有用。

屏幕阅读器支持改进

针对视障用户的使用体验,本版本对屏幕阅读器支持做了多项优化:

  1. 多边形绘图组件:全面增强了多边形绘制交互的屏幕阅读器支持,包括顶点位置朗读和操作反馈。

  2. 图表组件:修复了图表区域会暴露无关空图像给屏幕阅读器的问题,优化了焦点管理和ARIA属性。

  3. 线段组件:修正了两处屏幕阅读器朗读字符串中的拼写错误,提高了语音反馈的准确性。

这些改进使得依赖屏幕阅读器的用户能够更准确地理解和使用Perseus中的数学交互组件。

问题修复与优化

  1. 移动端显示问题:修复了在移动设备上,折叠容器内的可缩放内容在展开时可能不显示的问题,确保了响应式布局的正确性。

  2. 选择题样式问题:修正了单选组件中错误选项可能显示为蓝色而非红色的样式问题,统一了错误状态的视觉反馈。

  3. 坐标反转逻辑:将角度图表中的坐标反转逻辑移入评分系统,使交互行为与评分标准更加一致。

  4. 样式表配置:调整了Storybook中的Aphrodite样式配置,移除了自动添加的!important标记,避免样式优先级问题。

技术架构调整

  1. Mafs集成:从交互式图表代码中移除了Mafs标志,简化了代码结构,为后续可能的渲染引擎切换做准备。

  2. 依赖更新:升级了WonderBlocks等核心依赖包的版本,确保使用最新的稳定功能和安全性修复。

这个版本体现了Perseus项目对可访问性和组件化设计的持续投入,通过标准化的公共接口和增强的屏幕阅读器支持,使得这个数学内容引擎更加健壮和包容。开发者可以更方便地集成和扩展这些组件,而视障用户也能获得更好的使用体验。

登录后查看全文
热门项目推荐
相关项目推荐