查看“模板:ISEvent/doc”的源代码

{{Cbox2|lv=1|title=此模板尚在测试中。}}
==简述==
此模板为系列模板，旨在通过基于Vue组件框架的HTML+JS方式书写灵活性更高的集成战略事件列表。
包含以下组件：
* [[Widget:ISEvent]] —— 核心JS处理库，可通过GitHub仓库进行底层处理代码修改和提交。
* [[模板:ISEvent]] —— 本模板。数据外包装。
* [[模板:ISEvent/scene]] —— 场景定义类模板。
* [[模板:ISEvent/choose]] —— 选项定义类模板。

==架构==
本系列模板的基础架构如下：
* 数据外包装：包裹整个数据供核心处理库处理。
** 事件：多个场景的集合体。
*** 场景：一个具有图像、标题和解说的场景，可以包含若干选项；等效于游戏中事件的“一屏”。
**** 选项：一个具有选项名称、选项详情和图标的选项；可以互动用于场景之间跳转。
==如何撰写==
首先，在页面中放置 <code>Widget:ISEvent</code>，并使用 <code><nowiki>{{#vardefine:theme|<主题名>}}{{#vardefine:link|<收藏品一览页面名>}}</nowiki></code>定义收藏品页面跳转（如：[[傀影与猩红孤钻]]、[[傀影与猩红孤钻/长生者宝盒|长生者宝盒]]）。

之后放置本模板（<code><nowiki>{{ISEvent}}</nowiki></code>）。
===定义事件===
在ISEvent中，用 <code>|事件X=</code>（X=1,2,3...）定义一个事件。
* 为了维护方便，你可以在新的类别起使用新的X命名方式（如“story1”等）。
===定义场景===
定义好一个事件后，即可在此事件中，用 <code><nowiki>{{ISEvent/scene}}</nowiki></code> 模板插入一个场景。具体参数如下：
* '''etype''' （可选）指定场景所属类别，将会变为一个二级标题（如：不期而遇）。'''只在该类别第一个事件的第一个场景填写。'''
* '''无名第一参数''' 指定该场景的别名，用于这个事件的内部导航，可视情况自定。
* '''无名第二参数''' 指定该场景的显示图片，自动调用Wiki内图像，不需要扩展名。
* '''无名第三参数''' 指定该场景的标题。
* '''无名第四参数''' 指定该场景的描述。
* '''选项''' （可选）指定该场景包含的选项。
一个事件常常拥有许多个场景，此时只需要把多个 <code><nowiki>{{ISEvent/scene}}</nowiki></code> 连续排列即可。

这里是一个[[水月与深蓝之树/事件一览|水月与深蓝之树“悬高之葬”事件]]的场景样例（略去选项，有删减）：
<pre>{{ISEvent/scene|etype=不期而遇|开始|Avg_pic_rogue_2_1|悬高之葬|你正站在一座悬崖墓园内。这里正在举行送别逝者的仪式。……}}
{{ISEvent/scene|结束|Avg_pic_rogue_2_1|悬高之葬|祷告结束，你抬头向悬崖下方望去。……}}</pre>
===定义选项===
用 <code><nowiki>{{ISEvent/choose}}</nowiki></code> 在场景中插入若干选项。具体参数如下：
* '''无名第一参数''' 指定选项类型，包括以下几种：
* '''无名第二参数''' 指定选项名称；
** simple：简单选项。这将会生效下列选项：
*** '''无名第三参数''' 指定选项图标，根据ID自动调用Wiki内图像，不需要扩展名。
** collection：获得具体收藏品的选项。这将会生效下列选项：
*** '''无名第三参数''' 指定收藏品的图鉴ID。
** item：获得具体的集成战略专属道具的选项。这将会生效下列选项：
*** '''无名第三参数''' 指定道具名称。
** desc：该“选项”不是选项，而是用于穿插描述而用的说明性文字。
*** 此类型无参数，并弃用原本的第二参数。
* '''desc1''' （可选）指定该选项的附加说明文字，以游戏内为准。
* '''desc2''' （可选）指定该选项的附加信息，一般用于补充该选项的说明。
* '''dest''' （可选）指定要跳转的目标场景的序号。<br>以初始场景为0，按书写顺序依次递增。

这里是一些[[探索者的银凇止境/事件一览|探索者的银凇止境]]事件的选项样例：
<pre>{{ISEvent/choose|simple|扑进去！|population|desc1=获得{{color|#b4f7ff|2}}希望|dest=2}}
{{ISEvent/choose|collection|搜索营地|220|desc1=获得收藏品{{color|#b4f7ff|树痕之盔}}|dest=1}}
{{ISEvent/choose|item|强化训练|高级物资配给券|desc1=获得进阶券<br/>{{color|#b4f7ff|高级物资配给券}}|dest=2}}
{{ISEvent/choose|desc|desc1={{fa|info-circle}} '''以下选项随机出现3个'''}}</pre>