Skip to content

组件一览 ​

所有故事组件都是 renderless(无渲染)的,它们不会在页面上生成任何额外的 DOM 元素,只默默地在幕后完成数据收集与逻辑组织。你的模板最终只输出插槽中的真实内容,这意味着你可以完全掌控页面的结构和样式。

组件职责速查 ​

组件作用
AShell故事根节点,收集所有场景与对话,统一计算 next 并调用 API
AScene定义一个场景,提供 id 与 name,自动推断子对话的 next。支持 stop 属性暂停故事
ADialog一段对话的容器,收集其中的台词、选项、结局等,作为整体发送。支持 stop 属性暂停故事
ALine一行普通对话,其内容可以是任意 HTML 或组件
AOptions选项组,将多个 AOption 打包为选项列表
AOption单个选项,包含显示文字(content 插槽)和选择后执行的对话内容。支持 stop 属性暂停故事
AEnding对话结束标记,当执行到时调用 Adv.ending() 结束游戏
AIf条件分支,根据 condition 决定是否执行插槽内容
AElif"否则如果"分支,与 AIf 配合形成多路条件判断
AElse"否则"分支,当所有 AIf/AElif 条件不满足时执行
AEndDialog提前结束当前对话,跳过后续所有脚本
AGoto强制跳转到指定的对话或场景 ID
ARun在脚本执行流中嵌入任意自定义代码
ACheck属性检定组件,封装掷骰、修正、成功/失败分流全流程
ABattle发动战斗

在接下来的章节中,我们将逐一学习如何用它们编写故事。