图标

Material Design 图标

Home Assistant 利用社区驱动的 Material Design 图标 (MDI) 项目,在前端中使用图标。该图标库是 Google 提供的基础图标库的超集,包含数千个由社区制作的图标,适用于非常具体的应用、行业和用例。

默认图标

Home Assistant 中的每个实体都有一个默认图标。这里列出太多不便,但你会在仪表板中看到它们。你可以 自定义任何实体,以更改显示的图标。

查找图标

图标选择器

查找图标最常见的方法是使用内置于 Home Assistant 的图标选择器。在自定义实体时选择 图标 字段并开始输入。列表将根据你的搜索条件过滤出匹配的图标。当字段为空时,你也可以滚动浏览所有可用的图标。

Home Assistant 中的图标选择器

Tip

图标选择器将根据图标名称和 MDI 项目为图标应用的别名进行过滤。例如,输入 “user” 将显示大多数名为 “account” 的图标。

有关自定义实体(包括其图标)的更详细步骤,请参阅 自定义实体

Material Design 图标选择器浏览器扩展

在 Home Assistant 之外浏览和查找图标的最简单方法是使用官方 Material Design 图标选择器 浏览器扩展。该扩展适用于 Chrome、Firefox 和 Edge,并由 MDI 团队维护。

Material Design 图标选择器

Note

并非所有出现在 MDI 选择器浏览器扩展中的图标在 Home Assistant 中都可能可用(目前还没有!)。尽管浏览器扩展会随着 MDI 发布新包而更新,Home Assistant 可能在下一个版本之前滞后。

Pictogrammers 网站上的 Material Design 图标

浏览可用图标的最后一种方式是在 Pictogrammers 网站上查看库,https://pictogrammers.com/library/mdi/。选择你想使用的图标,然后点击 “Home Assistant” 查看其用法示例。

Note

Pictogrammers 网站将始终显示 Material Design 图标库的最新版本。然而,你可能会发现一些图标在 Home Assistant 中尚不可用(目前还没有!)。请关注 Home Assistant 的发布说明,以获取有关 Material Design 图标库更新的公告。

建议或贡献新图标

作为开源项目,Home Assistant 的 Material Design 图标库始终欢迎建议和贡献,以扩展图标库。

Note

在建议或创建新图标之前,搜索当前库是非常重要的 搜索当前库搜索所有问题,包括已开启和已关闭的问题。尝试使用不同的术语进行搜索,这些术语可能意味着相同的意思。(例如 “user”, “person”, “account”)

建议新图标

如果你有一个当前不在库中的图标的想法,但不想自己创建它,打开一个新的图标建议

贡献新图标

如果你想向库中贡献一个新图标,请熟悉 系统图标指南 中的 Material Design 系统。然后创建你的图标并 提交给 Pictogrammers 团队进行审核

创建新图标的提示

  • 认真关注 Material Design 指南
  • 记住,图标应该是上下文的,而不是字面的。
  • 就小细节而言,少即是多。
  • 如果你不确定,请在他们的 GitHub 上打开一个问题。他们非常乐意帮助你!
  • 不是所有的图标都会进入库,这是可以的!

建议图标别名

有时一个图标存在,但你无法找到使用的术语。如果你遇到这种情况,请 向 Pictogrammers 团队打开一个问题,建议可以添加到现有图标的新别名