We value your feedback!

Can you spare a moment to take our survey?
Your feedback helps us improve Lucide and make it better for everyone.

Lucide 中文文档

Appearance

Get JavaScript certificates from certificates.dev

深入理解无障碍性 ​

图标是不使用文字即可表达含义的图片。它们非常有用，因为可以快速提供信息。

然而，并非所有人都能轻松理解它们。在使用图标时，非常重要的是要考虑以下无障碍性方面。

INFO

默认情况下，我们使用 aria-hidden="true" 向屏幕阅读器隐藏图标。您可以遵循以下指南自行使它们具备无障碍性。

提供可见标签 ​

图标是改善感知能力的有用工具，但它们不能替代文本。

在大多数情况下，最好也提供图标功能的文本表示。

In short: Don’t rely on communicating the function of elements by icons alone. Do also provide a written description of the your interactive elements. For example: write out "On this page" on your on-page navigation element.Don't rely on communicating thefunction of elements by icons alone.Do also provide a written descriptionof your interacive elements.

对比度 ​

确保图标与其背景之间有足够的对比度，以便低视力或色觉缺陷人群可见。

我们建议遵循 WCAG 2.1 SC 1.4.3。

In short: use a contrast ratio of at least 4.5:1Don't use low contrast. Do use a contrast ratio of at least 4.5:1.

颜色的使用 ​

避免仅依靠颜色在图标中传达含义，因为某些用户可能有色盲。相反，请使用形状、阴影或文本等附加视觉线索。

For example: Don’t mark state with color, mark it with distinct visuals.

交互性 ​

确保交互式图标可以通过键盘导航访问，并在激活时提供清晰的反馈。

在大多数情况下，只需将它们包裹在图标按钮中即可轻松完成。

最小目标尺寸 ​

小目标可能难以点击或触摸，如果您的图标是可交互的，我们建议其最小目标尺寸应为 44×44 像素。

Example of using target size correctly

实际上，这并不一定意味着图标本身应该这么大，只是其交互包装元素应该这么大。

意义明确 ​

图标应以普遍可理解的方式代表概念或操作。避免使用可能使某些用户困惑的抽象、模糊或特定文化的符号。

For example: Use universally understandable symbols and don't base your choice of icon on puns.

一致性 ​

在整个界面中保持图标设计和用法的一致性，以帮助用户更容易地学习和理解它们的含义。

For example: Don’t use the same icon for multiple distinct purposes or meanings. Don’t use different icons for the same purpose or function.

文本替代 ​

您可能需要为图标提供文本标签或替代文本描述，特别是对于视障人士使用的屏幕阅读器。

但是：描述应仅提供给非纯装饰性的独立图标，因为为非功能性元素提供无障碍名称只会在使用屏幕阅读器时增加混乱。

关于独立图标 ​

图标通常极不可能在没有语义化包装元素的情况下独立存在。在大多数情况下，它们将是徽章、按钮（包括图标按钮）、导航项或其他交互式 UI 元素的一部分。

WARNING

如果您的某些图标是独立的，并且它们具有非装饰性功能，请确保为它们提供适当的无障碍标签。

In short: provide accessible label for semantic icons, but not for decorative icons.

一般来说，尽量避免使用没有交互性的功能性图标，我们建议：

  1. 要么在它们旁边添加可见描述，或者
  2. 将它们放在徽章、标签或按钮上，并至少为它们添加工具提示。

在任何此类情况下，最好仅为这些交互式元素（徽章、按钮、导航项等）提供无障碍名称，而不是图标本身。

关于按钮 ​

不要在按钮上使用的图标提供无障碍标签，因为此标签将被屏幕阅读器读出，导致文本无意义。

Don't provide accessible labels todecorative icons.Do omit aria-label on decorative icons.
代码示例
tsx
// 不要这样做
<button>
  <Plus aria-label="加号图标"/>
  添加文档
</button>

// 这样做，保留原样即可
<button>
  <Plus/>
  添加文档
</button>

关于图标按钮 ​

图标按钮是指除了图标本身之外不包含任何可见文本的按钮（例如对话框的关闭按钮）。

如前所述，您应该在图标按钮本身上提供无障碍标签，而不是包含的图标。

Don't provide accessible labels foricons on icon buttons.
代码示例
tsx
// 不要这样做
<button class="btn-icon">
  <House/>
</button>

    <House aria-label="首页图标"/>
<button class="btn-icon">
  <House aria-label="首页图标"/>
</button>

    <House aria-label="首页图标"/>
<button aria-label="返回首页" class="btn-icon">
  <House/>
</button>
  <button aria-label="返回首页" class="btn-icon">
// 改为这样做
<button class="btn-icon">
  <House/>
  <span class="visually-hidden">返回首页</span>
</button>
<span class="visually-hidden">返回首页</span>

关于 aria-label 的说明 ​

虽然您可以通过 aria-label 属性为元素提供无障碍标签，但我们通常建议避免这样做，而是建议您尽可能使用所选 CSS 框架的“视觉隐藏”实用程序。您可以 阅读更多关于为什么 aria-label 可能不是最佳解决方案的信息。

示例 - Radix UI ​

使用 Radix UI 内置的无障碍图标实用程序组件。

tsx
import { ArrowRightIcon } from 'lucide-react';
import { AccessibleIcon } from '@radix-ui/react-accessible-icon';

<AccessibleIcon label="下一个项目">
  <ArrowRightIcon />
</AccessibleIcon>

示例 - Bootstrap ​

html

<div>
  <i data-lucide="phone" aria-hidden="true"></i>
  <span class="visually-hidden">电话号码</span>
</div>

示例 - Tailwind CSS ​

html

<div>
  <i data-lucide="phone" aria-hidden="true"></i>
  <span class="sr-only">电话号码</span>
</div>

如果您不确定，可以考虑了解更多关于 如何隐藏内容。

更多资源 ​

我们还建议查看以下关于无障碍性的资源：