Tailwind CSS on GitHub

屏幕阅读器

用于改善屏幕阅读器的可访问性的功能类。

Default class reference

Class
Properties
sr-onlyposition: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border-width: 0;
not-sr-onlyposition: static; width: auto; height: auto; padding: 0; margin: 0; overflow: visible; clip: auto; white-space: normal;

使用

使用 sr-only 来隐藏一个元素,而不对屏幕阅读器隐藏。

<a href="#">
  <svg><!-- ... --></svg>
  <span class="sr-only">Settings</span>
</a>

使用 not-sr-only 来撤销 sr-only,使一个元素对视力用户和屏幕阅读器都可见。当您想在小屏幕上隐藏某些元素,但在大屏幕上显示它时,这很有用。

<a href="#">
  <svg><!-- ... --></svg>
  <span class="sr-only sm:not-sr-only">Settings</span>
</a>

默认情况下,responsivefocus 变体是为这些功能类生成的。您可以使用 focus:not-sr-only 来使一个元素在默认情况下被隐藏,但当用户用 tab 键点击它时,它又是可见的--这对 skip to content 链接很有用。

<a href="#" class="sr-only focus:not-sr-only">
  Skip to content
</a>

自定义

变体

默认情况下, 针对 accessibility 功能类,只生成 responsive, focus-within and focus 变体。

您可以通过修改您的 tailwind.config.js 文件中的 variants 部分中的 accessibility 属性来控制为 accessibility 功能生成哪些变体。

例如,这个配置将生成 hover and active 变体:

  // tailwind.config.js
  module.exports = {
    variants: {
      extend: {
        // ...
+       accessibility: ['hover', 'active'],
      }
    }
  }

禁用

如果您不打算在您的项目中使用 accessibility 功能,您可以通过在配置文件的 corePlugins 部分将 accessibility 属性设置为 false 来完全禁用它们:

  // tailwind.config.js
  module.exports = {
    corePlugins: {
      // ...
+     accessibility: false,
    }
  }