模板:羁绊按钮

模板说明：羁绊按钮

功能概述

该模板用于生成一个带有收集状态切换功能的按钮，通常用于“羁绊”、“收藏”、“图鉴”等需要记录用户点击/收集状态的场景。按钮样式为复古风格，包含一个图标和文字，并支持点击后标记为“已收集”。

使用方法

{{羁绊按钮|显示文字|图标文件名|列表标识}}

参数说明

参数1（必填）：按钮上显示的文字（例如：传谣、放火）

参数2（必填）：图标文件名（不含.png扩展名），对应图片需已上传

参数3（可选）：收集列表标识，用于区分不同页面或不同组的收集项目

示例代码

{{羁绊按钮|传谣|晴天|test}}
{{羁绊按钮|放火|大雪|test}}

 传谣

 放火

输出效果

- 生成两个按钮，分别显示“传谣”（+晴天图标）和“放火”（+大雪图标）

- 按钮可点击，点击后会标记为“已收集”状态（样式变化）

- 状态由bwiki-collection相关脚本驱动（需配合站点全局的收集系统JS使用）

注意事项

1. 依赖文件：需确保对应的{{{2}}}.png图标已上传至站点。
2. 全局脚本：按钮的“收集”交互依赖BWiki的bwiki-collection组件JS/CSS，请确保页面已加载相关资源。
3. 同一列表标识：若多个按钮属于同一收集列表，请使用相同的{{{3}}}值，否则收集状态将独立记录。
4. 样式覆盖：模板已内嵌CSS（仅首次使用时生效），如需全局调整，请覆写.combo-btn等相关类。

技术说明（维护用）

- 模板利用data-collection和data-collectionlist属性存储收集信息。

- 通过1控制CSS只加载一次。

- 状态变化由外部JS监听并添加.checked类。