feat: support function button custom

This commit is contained in:
Erzbir
2026-08-22 22:38:26 +08:00
parent e0b2e9ff70
commit 7ee2cf1e2d
7 changed files with 317 additions and 249 deletions
+10 -10
View File
@@ -11,7 +11,7 @@
- Terminal 风格的响应式页面布局
- 浅色, 深色和跟随系统 3 种外观模式, 页头按钮会显示太阳, 月亮或圆圈图标
- 12 套内置配色和多套自定义配色
- 可分别控制页头的搜索, 配色选择, 外观切换和像素化按钮
- 可排序的页头功能按钮, 支持搜索, 配色选择, 外观切换, 像素化和自定义功能
- 常规图标和像素图标切换
- 内置 JetBrains Mono, Hack 和 Fira Code 字体, 也可使用访客系统字体
- 支持多字体 fallback, PostScript Name 本地匹配和高级 `@font-face` 配置
@@ -62,16 +62,16 @@
### 页头
| 设置 | 配置名 | 说明 |
|---------|---------------------------------------|------------------|
| Logo 文本 | `header.logo` | 留空时使用 Halo 站点标题 |
| 搜索按钮 | `header.search_button_enable` | 搜索组件插件可用时展示 |
| 配色切换按钮 | `header.color_scheme_switcher_enable` | 展示自动发现的配色列表 |
| 深浅切换按钮 | `header.appearance_switcher_enable` | 在浅色, 深色和跟随系统之间循环 |
| 像素化按钮 | `header.pixel_style_switcher_enable` | 切换像素字体和像素图标 |
| 设置 | 配置名 | 说明 |
|---------|------------------|---------------------|
| Logo 文本 | `header.logo` | 留空时使用 Halo 站点标题 |
| 功能按钮 | `header.buttons` | 按数组顺序展示内置按钮和自定义功能按钮 |
搜索, 配色切换, 深浅切换和像素化按钮都可以自定义普通图标与像素风格图标. 深浅切换按钮可分别设置浅色, 深色和
跟随系统三种状态的图标. 只设置其中一种自定义图标时, 普通和像素模式都会使用该图标; 两者都留空时才使用主题内置图标.
`header.buttons` 默认包含搜索, 外观切换和像素化按钮. 在数组中添加, 删除或拖动条目即可控制按钮的显示与顺序;
搜索按钮仅在搜索组件插件可用时展示. 内置按钮可自定义普通和像素风格图标, 留空时使用主题内置图标.
自定义功能按钮需设置按钮名称, `onclick` JavaScript 和图标; 可选的像素风格图标留空时使用普通图标. `onclick` 中可使用
`event` 和 `this`; 代码会在访客点击按钮时执行, 只应填写可信任的 JavaScript.
外观切换顺序为 `浅色 -> 深色 -> 跟随系统`; 图标依次为太阳, 月亮和圆圈. 切换外观模式时会清除访客单独选择的配色,
让浅色和深色模式重新使用主题设置中对应的方案.