通过 GraphQL 使用自定义表情符号
- 引入于极狐GitLab 13.6,功能标志为
custom_emoji
。默认禁用。- 在 JihuLab.com 中启用于极狐GitLab 14.0。
- 私有化部署上启用于极狐GitLab 16.7。
- 在极狐GitLab 16.9 中 GA。功能标志
custom_emoji
被移除。
要想在注释和描述中使用自定义表情,您可通过 GraphQL API 来将他们添加到顶级群组中。
创建自定义表情
mutation CreateCustomEmoji($groupPath: ID!) {
createCustomEmoji(input: {groupPath: $groupPath, name: "party-parrot", url: "https://cultofthepartyparrot.com/parrots/hd/parrot.gif"}) {
clientMutationId
customEmoji {
name
}
errors
}
}
在您将自定义表情添加到群组中后,成员可以像使用其他表情一样在注释中使用它们。
属性
查询接受以下属性:
属性 | 类型 | 是否必需 | 描述 |
---|---|---|---|
group_path |
integer/string | Yes | ID or URL-encoded path of the top-level group. |
name |
string | Yes | Name of the custom emoji. |
file |
string | Yes | URL of the custom emoji image. |
使用 GraphiQL
您可以使用 GraphiQL 来查询群组的自定义表情。
- 打开 GraphiQL:
- 对 JihuLab.com,使用:
https://jihulab.com/-/graphql-explorer
- 对私有化部署实例,使用:
https://jihulab.example.com/-/graphql-explorer
- 对 JihuLab.com,使用:
-
将下面的文本拷贝进左侧窗口。在此查询中,
gitlab-org
是群组路径。query GetCustomEmoji { group(fullPath: "gitlab-org") { id customEmoji { nodes { name, url } } } }
- 选择 运行。