从 Typecho 的 HoerMouse 插件移植而来,为前台添加点击气泡特效和个性鼠标指针。 移植过程未改动任何核心代码,仅使用 GopherInk 的公开插件接口,用于验证接口通用性。
- 文字气泡:每次点击依次弹出一个字符并上浮淡出,可设置文字、颜色(
random或十六进制)和上浮时长。 - 爱心气泡:点击迸出彩色爱心。
- 喷墨气泡:基于本地化 anime.js 2.2.0 的 fireworks 画布特效,不依赖外部 CDN。
- 个性鼠标:7 套内置光标主题(dew / carrot / exquisite / marisa / shark / sketch / star),分别设置普通指针和链接指针。
| Typecho | GopherInk 接口 |
|---|---|
Widget_Archive->footer 钩子 |
HookFrontendFooter 运行时钩子,返回追加后的 HTML |
Helper::options()->plugin('HoerMouse') |
rt.Config(ctx, pluginName) |
/usr/plugins/HoerMouse/static 静态资源 |
StaticProvider.PluginStatic()(go:embed 打包),核心在 /plugin/<name>/ 提供 |
| 资源 URL | rt.PluginURL(ctx, "") |
config(Form)(Radio/Text/Layout) |
声明式 ConfigSchema []FieldSchema,并用 ShowWhenField 做条件显示 |
- 移除外部 jQuery 依赖:原版文字气泡依赖 jQuery,且 CDN 源(新浪 SAE)早已失效。 移植版把文字气泡重写为原生 JS,行为一致但无需任何外部库。原版的“是否加载 jQuery” 选项因此删除。
- 喷墨气泡的 anime.js 使用随插件打包的 2.2.0 版本(MIT License),
fireworks.js继续使用其全局animeAPI。 - 光标资源(
.cur)、anime.js 和fireworks.js都通过go:embed打包进程序。 - 静态资源 URL 会从
PluginURL规范化为当前站点的相对路径,因此本地、预览域名和正式域名共用一份配置。
主题需在页脚输出 {{.FrontendFooter}}(默认主题已支持)。若主题未输出该变量,
本插件的特效不会生效——这与原版依赖 $this->footer() 的机制一致。