【问题标题】:How to activate MathJax accessibility by default?默认情况下如何激活 MathJax 可访问性?
【发布时间】:2024-01-02 12:28:01
【问题描述】:

我来回搜索了文档,但找不到默认激活辅助功能的方法。只需右键单击 Mathjax 元素即可打开上下文菜单,然后选择辅助功能->激活。

文档内容如下: "扩展可以通过上下文菜单激活,它本身是完全可访问的,或者默认使用配置选项。"

但我找不到任何关于如何使用配置激活它的信息。 This is the configuration 我找到了,那里没有“激活”选项。

我错过了什么?

(我使用的是最新的 MathJax 版本:3.0)

这是我配置我的 MathJax 的方式,下面是我得到的上下文菜单,其中未激活可访问性选项。

MathJax = {
   tex: {
     inlineMath: [['##', '##'], ['\\(', '\\)']]
   },
   options: {
       a11y: {
          speech: true,   
          subtitles: true
       }
  }
};

【问题讨论】:

    标签: accessibility mathjax


    【解决方案1】:

    在文档中挖掘了两天后,我放弃了。我认为默认情况下无法激活辅助功能。我个人认为这很荒谬,因为如果屏幕阅读器没有阅读它,盲人究竟应该如何猜测如何激活它?

    最终,我所做的是在每个页面的顶部位置隐藏一个 div,并提供有关如何激活插件的说明。我正在使用 css 对所有用户隐藏该 div,并将其公开给屏幕阅读器像这样:

      .accessibility_hint{font: 400 12px arial; color: #0e2d6d; background-color: white; position: absolute; left: 50%; margin-left: -55px; top: 0px; padding: 2px 4px; opacity: 0;}
    	.accessibility_hint:focus, .accessibility_hint:active{opacity: 1; z-index:999;} 
    the div is here. you'll see it only if you use keyborad navigation to focus on it
        <div class=accessibility_hint tabindex=0>[insert textual explanation on how to use keyboard navigation to activate the plug-in]</div>
    
      

    【讨论】:

    【解决方案2】:

    在黄色配置选项框的正下方all of the accessibility options:-

    我认为您是因为在描述中使用 a11y 而不是 AccessibilitY - 这是一个 numeronym 用于“辅助功能”这个词.这和 i18n (IninternationalisatioN)

    之类的东西是一样的

    是的,我知道具有讽刺意味的是,这不是很容易获得,他们应该只使用这个词!

    如果您配置了默认启用的所有选项,则不需要“激活” - 可以通过包含 ally 及其子选项来完成。 (请注意,如果您想向屏幕阅读器输出添加其他信息,您可能需要使用 enrichSpeech: 'shallow'enrichSpeech: 'deep'。)

    MathJax = {
      options: {
        a11y: { //everything within here will be on if you set that item to a 'truthy' statement i.e. speech: true
    

    【讨论】:

    • 感谢您的回复,格雷厄姆。这确实令人困惑,但我确实意识到 a11y 代表 Accessibility,并且我确实尝试使用那里的配置。但它们都没有将“激活”选项设置为 true。我将编辑原始问题,以便显示我缺少的选项的图像。
    【解决方案3】:

    (评论有点长)。 Here 是 2019 年 11 月会议演讲的一些幻灯片,由 MathJax 的主要开发人员之一提供。引用它:

    开启辅助功能

    • 向下导航到辅助功能子菜单条目

    • 打开子菜单项

    • 点击激活命令

    MathJax Cookie

    • MathJax 使用 cookie 来记住菜单设置

    • 在菜单中明确设置的任何内容都会覆盖内容/页面作者所做的设置。

    • 因此用户可以始终保留他们的个人设置

    • 它们会一直保留到页面的 cookie 被删除

    讨论了通过 Javascript 进行的设置,但没有讨论如何以编程方式打开可访问性。因此,我会说当前的行为是“设计使然”。

    这对我来说似乎很奇怪,因为@einav 在他的回答中解释了原因。也就是说,虽然我不是屏幕阅读器用户,但从我对屏幕阅读器如何工作的极其有限的理解来看,我认为上下文菜单的存在应该是显而易见的,并且用户可能会期待 MathJax 的这种行为。这种想法或许可以解释设计决策。

    【讨论】: