跳到主要内容

矩阵

为了让此徽章起作用,您的房间主机必须允许访客帐户或虚拟帐户注册,并且房间必须对所有人可见(聊天历史记录对任何人都可见)。

以下步骤将向您展示如何使用 Element Matrix 客户端设置徽章 URL。

  • 在 Element 客户端中选择所需的房间
  • 点击位于客户端右上角的房间设置按钮(齿轮图标)
  • 滚动到设置页面最底部,查看“地址”部分
  • 您应该会看到一个或多个“房间地址(或别名)”,它们很容易通过其起始哈希(#)字符(例如:#twim:matrix.org)识别
  • 如果此房间没有地址,请在“此房间的本地地址”下添加一个
  • 删除起始哈希字符(#)
  • 最终的徽章 URL 应该类似于:/matrix/twim:matrix.org.svg

一些 Matrix 主服务器不保留与它们所在位置匹配的服务器名称(例如,如果创建了房间别名 #mysuperroom:example.com 的主服务器 example.com 位于 matrix.example.com)。

如果是用于生成徽章的房间别名创建的服务器,您需要添加服务器的 FQDN(完全限定域名)作为查询参数。

然后最终的徽章 URL 应该类似于:/matrix/mysuperroom:example.com.svg?server_fqdn=matrix.example.com。

路径参数
roomAlias 字符串 必需

示例:twim:matrix.org

查询参数
server_fqdn 字符串

示例:matrix.org

style 字符串

可能的值:[flat, flat-square, plastic, for-the-badge, social]

如果未指定,则此徽章的默认样式为“flat”。

示例:flat

logo 字符串

来自 simple-icons 的图标缩略语。您可以点击 simple-icons 上的图标标题以复制缩略语,或者可以在 simple-icons 存储库中的 slugs.md 文件 中找到它们。 更多信息

示例:appveyor

logoColor 字符串

徽标的颜色(支持十六进制、rgb、rgba、hsl、hsla 和 css 命名颜色)。支持 simple-icons 徽标,但不支持自定义徽标。

示例:violet

logoSize 字符串

通过设置 auto 使图标自适应调整大小。对于一些较宽的徽标(如 amdamg)很有用。支持 simple-icons 徽标,但不支持自定义徽标。

示例:auto

label 字符串

覆盖默认的左侧文本(URL 编码 需要用于空格或特殊字符!)

示例:healthiness

labelColor 字符串

左侧部分的背景颜色(支持十六进制、rgb、rgba、hsl、hsla 和 css 命名颜色)。

示例:abcdef

color 字符串

右侧部分的背景颜色(支持十六进制、rgb、rgba、hsl、hsla 和 css 命名颜色)。

示例:fedcba

cacheSeconds 字符串

HTTP 缓存生命周期(规则用于推断每个徽章的默认值,任何低于默认值的指定值将被忽略)。

示例:3600

link 字符串[]

指定单击徽章的左侧/右侧应执行的操作。请注意,这仅在将徽章集成到 <object> HTML 标签中时有效,而不在 <img> 标签或标记语言中有效。