npm 包 heymdall-favicons 使用教程
在前端开发过程中，图标与标题是网站页面特别重要的元素之一，也是用户对网站的首要印象，同时也能够提升网站的品牌形象和辨识度。本文将介绍一个使用 npm 包 heymdall-favicons 生成 favicon 的方法。
什么是 heymdall-favicons
heymdall-favicons 是一个 npm 包，可以快速帮你生成不同类型、不同规格的 favicon 和 meta 标签。它基于 web app manifest 文件，可以让你生成各种设备和平台下的图标和启动屏，并且可以在构建过程中使用它，不需要添加大量繁琐的配置。
安装 heymdall-favicons
在使用 heymdall-favicons 之前，我们需要在本地安装它。
通过 npm 安装：
npm install heymdall-favicons
或者通过 yarn 安装：
yarn add heymdall-favicons
使用 heymdall-favicons
在安装完 heymdall-favicons 后，我们可以在命令行中使用下面的命令（将 projectName 替换为你的项目名称，size 为生成的图标大小）：
heymdall-favicons --name projectName --size 512
heymdall-favicons 会在当前目录下的 public 文件夹生成 favicon.ico 和 manifest.json。
如果你想在项目中使用 heymdall-favicons 生成的图标和 meta 标签，你只需要将以下代码添加到你的 html 文件中：
-- -------------------- ---- -------
--------- -----
------
------
----- ---------------------- --------------- -----------------------------
----- ---------- ---------------- ------------- --------------------------
----- ---------- ---------------- ------------- --------------------------
----- -------------- -------------------------
----- --------------- ----------------------------- ----------------
----- --------------------------------- ----------------------
----- ----------------------- ----------------------
----- ------------------------------ ------------------
----- ------------------ ------------------
-------
------
---
-------
-------heymdall-favicons 的配置选项
heymdall-favicons 有很多配置选项，可以让你生成不同规格和类型的图标和启动屏，并且可以自定义图标和 meta 标签。
下面是一些常用的选项：
| 选项 | 描述 |
|---|---|
| --name | 生成的网站名称（用于生成 manifest.json 中的 name 属性） |
| --display | 指定启动屏的显示方式，有 standalone、fullscreen、minimal-ui、browser 等选项 |
| --orientation | 指定启动屏的方向，landscape、portrait、any |
| --background | 指定启动屏的背景颜色，例如 #ffffff，会在生成的 manifest.json 中添加 background_color 属性 |
| --path | 指定输出路径，例如 --path /public 会将生成的图标和 meta 标签放到 public 文件夹下 |
| --icons | 指定要生成的图标尺寸，例如 --icons "{appleIcon: [60, 120], androidIcon: [192, 512], favicon: true}" |
| --logo | 指定网站 logo 的路径，例如 --logo /path/to/logo.png 会在生成的 manifest.json 中添加 shortcuts_icon 属性 |
| --theme_color | 指定启动屏顶部的主题颜色，例如 --theme_color "#ffffff" 将在生成的 manifest.json 中添加 theme_color 属性 |
| --apple-touch | 生成 apple-touch-icon，例如 --apple-touch "{60, 76, 120, 152}" |
| --background | 指定启动屏的背景颜色，例如 --background "#ffffff" 将在生成的 manifest.json 中添加 background_color 属性 |
总结
通过使用 heymdall-favicons，我们可以快速生成不同类型、不同规格的 favicon 和 meta 标签，省去了手写大量代码配置的麻烦，同时提高了网站的用户体验和品牌形象，对于前端开发者来说是一个不可多得的工具。
示例代码
heymdall-favicons --name projectName --size 512
-- -------------------- ---- -------
--------- -----
------
------
----- ---------------------- --------------- -----------------------------
----- ---------- ---------------- ------------- --------------------------
----- ---------- ---------------- ------------- --------------------------
----- -------------- -------------------------
----- --------------- ----------------------------- ----------------
----- --------------------------------- ----------------------
----- ----------------------- ----------------------
----- ------------------------------ ------------------
----- ------------------ ------------------
-------
------
---
-------
-------来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60055eb181e8991b448dc50c