简单模拟QQ聊天栏 组件

注意


此页为于 SCP 维基内部使用的“组件”页。用于在其他页面中引用。

未经组件作者或工作人员允许，请勿修改此页的内容。

评分: +93+–x

简介

这是一个旨在让你以更简单的格式插入聊天记录的组件。基本的思路是用Wikidot的基础语法（##颜色|文本##、//斜体//、{{等宽}}）替代复杂的[[div class="..."]]和[[span class="..."]]。

优点：

  • 不需要写一句就include一下，只需要非常非常简单的维基语法。
  • 源代码更简洁，可读性更强。
  • 加载速度更快。
  • 更方便二次修改。

由于部分版式会魔改Wikidot基础语法，此组件在带版式的页面上可能出现奇奇怪怪的bug。请在讨论区报告版式兼容问题。

使用教程

要引用此组件，需要在页面最开头插入以下代码：

[[include :scp-wiki-cn:component:ezchat
|darkmode=↵填入“*”，可以启用暗色模式。留空则是亮色模式。
|customHeadColor=↵必须和下面那个选项一起启用或者关闭。填入“*”，自定义标题栏的背景颜色。
|headColor=↵在上面那个选项启用后，在这个选项填入一个任意格式的颜色值。留空则和底部输入栏保持一致。
]]

然后，在你需要插入聊天记录的地方：

第一步

复制粘贴下面的内容。


[!-- =====从这里开始复制===== --]
[[div class="ezchat container"]]
[[div class="ezchat head"]]
##ezchat-ui-icon return|返回## ##ezchat-ui-button messages|99+## ##head-title|聊天名称## ##ezchat-ui-icon menu|菜单##
[[/div]]
[[div class="ezchat chat-content"]]
[!-- =====聊天记录主体从这里开始===== --]




[!-- =====聊天记录到这里结束===== --]
[[/div]]
[[div class="ezchat bottom"]]
##ezchat-ui-icon voice|语音## ##bottom-input|待发送的消息内容## ##ezchat-ui-icon emojis|表情## ##ezchat-ui-icon more|更多##
[[/div]]
[[/div]]
[!-- =====从这里结束复制===== --]

其中，“99+”、“聊天名称”、“待发送的消息内容”都是可以随意填写的。

如果想在“待发送的消息内容”留空，可以使用@@ @@。

第二步

告诉组件你需要哪些人出来聊天。

以这样的形式定义一个用户：

[[include :scp-wiki-cn:component:ezchat-define
|id=↵用户ID，建议用a1、b1或者姓名缩写，尽量简洁一些。必须由小写字母组成。
|avatar=↵用户头像图片的URL地址。
|size=↵用户头像图片的大小。默认为cover（缩放以确保覆盖背景）。
|pos=↵用户头像图片位置。默认为center（正中心。）
|color=↵用户头像边框颜色，可以是任意的颜色格式。默认为#AAAAAA。
]]

除了id之外，所有的选项都不是必填的。例如，如果聊天记录中需要一个叫“林南”的角色，但不想要头像只想要头像框颜色，可以这样做：

[[include :scp-wiki-cn:component:ezchat-define
|id=linnan
|color=#114514
]]

想定义一个新的用户，就要把这段代码重新复制一遍，再修改里面的内容。

但你也可以不定义用户，这样头像会显示为默认头像，适合故事里的NPC。

第三步

在“[!-- =====聊天记录主体从这里开始===== --]”和“[!-- =====聊天记录到这里结束===== --]”之间，以这样的形式插入聊天记录：

↓最基础的聊天记录。
##name userid|用户名称##
> 你好啊

↓自己发送的信息（节省时间的小窍门：选中后按一下编辑面板的“div”）。
[[div]]
##name userid|用户名称##
> 为什么你们都在左边，就我在右边，你们是不是孤立我？
[[/div]]

↓一个人连续发送了几条消息。类似Discord，这样可以省略几个头像。
##name userid|用户名称##
> UP主您好

> 吃小份去吧

↓群管理发的消息。
##name admin userid|{{管理员}}用户名称##
> 作为管理我是不是应该制止这类话题？

↓群主发的消息。
##name host userid|{{群主}}用户名称##
> 严肃观看。

↓有群头衔的成员发的消息。
##name title userid|{{头衔名称}}用户名称##
> 你们这群真是压抑完了。

↓自己发送的信息，但希望头衔在用户名称的左边。其实我觉得无所谓。
[[div]]
##name title userid|用户名称{{头衔名称}}##
> 我这个级别的基米有权哈任何人。
[[/div]]

↓一个人发送了很长一段消息，里面有换行。
##name userid|用户名称##
> 发长难句为什么不加逗号既然你知道句子很长很难那不应该加上逗号让读者读明白吗不然他们一口气看下去读到一半发现自己不知道在读哪里该怎么办
> 逗号又不要钱而且不加标点会让整个段落看起来像一团乱麻读者需要反复阅读才能理解你的意思这难道不是浪费大家的时间吗写作的目的是沟通而不是制造障碍所以请记得在适当的地方加上逗号让句子更清晰易懂
> 说起来其实这就是Wikidot引用块的语法吧？

↓@某个人。
##name userid|用户名称##
> 出来修bug，##at|@被at的用户名称##！

↓贴表情。
##name userid|用户名称##
> 你喜欢大红按钮吗？emoji没有。但我们有。
{{##emoji|😭 2## ##emoji|😡 3##}}

↓贴大红按钮（效果见末尾）。
##name userid|用户名称##
> K圣。
{{##emoji emoji-red-button|1## ##emoji emoji-red-button-fast|2##}}

↓居中提示消息，比如入群、禁言或者拍一拍。
//说的道理拍了拍你//

↓回复某条消息。
##name userid|用户名称##
> ##reply|用户名称2：进攻D点！##
> 不行！

↓发送图片。
##name userid|用户名称##
> [[image 图片URL地址]]

其中，userid需要被替换为你定义的角色，如果按照上面的例子，那就应该替换成linnan。如果只有一个光秃秃的name或者只有name admin/name host/name title，这个人的头像就会变成默认的用户图标。强烈建议所有关键字使用全小写英文字符和数字，以避免可能的解析问题。

请注意，userid不能是：name、admin、title、host、ezchat-ui-icon等关键字，否则可能导致bug，就像你不能给某个python变量起名为“False”或者“if”一样。

示例

返回 99+ Sara.AIC舰长群 菜单

超绝可爱Sara酱群主

那什么，反正这是一个聊天记录示例。

@全体成员 我现在展示一下这些格式

NPC1

不赖
我看这个Sara也是风韵犹存

🤣 4 🎉 3 🥵 4

NPC2

1

超绝可爱Sara酱群主

你知道幻象计划吗？它拯救的小粉丝超出你的想象。
QQ20250528-130932.png

O5-3“小孩”加入了群聊

真的O5-3

大家好。

管理员S处

谁家小孩？

🤣 9 🐛 7 😈 3 💥 2 😭 2 😚 2 😎 2 😨 1 🤤 1 😂 1 🎃 1 🤔 1 🐱1 🔥 1

邪恶黑标BasaltHighlighter.AIC

S处：谁家小孩？
S处区完了

2025年10月7日

超绝可爱Sara酱群主

更新：Kcorena制作的大红按钮GIF已被部署在此组件。你可以通过##emoji emoji-red-button|1##的方式展示这个完美的续标识。1

3 5

2025年10月8日

超绝可爱Sara酱群主

更新：Sharia Vanilla为此组件制作了一个组件扩展，允许你真的通过点击贴表情的方式增加贴表情的数量。点击此处查看。

2026年2月7日

管理员随机生成的管理员

更新：修复了以下bug：
（1）在部分版式中，组件字体会被替换，导致观感不佳。
（2）管理员、群主和头衔拥有者无法使用默认头像。

语音 有bug请在讨论区反馈，谢谢捏 表情 更多

+展示源代码
脚注
原创组件
页面版本: 36, 最后编辑于: 05 Apr 2026 17:20
编辑 评分 (+93) 标签 讨论 (17) 历史记录 附件 打印 网站工具 + 选项
除非特别注明，本页内容采用以下授权方式： Creative Commons Attribution-ShareAlike 3.0 License