通过 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 来查询群组的自定义表情。

  1. 打开 GraphiQL:
    • 对 JihuLab.com,使用:https://jihulab.com/-/graphql-explorer
    • 对私有化部署实例,使用:https://jihulab.example.com/-/graphql-explorer
  2. 将下面的文本拷贝进左侧窗口。在此查询中, gitlab-org 是群组路径。

        query GetCustomEmoji {
          group(fullPath: "gitlab-org") {
            id
            customEmoji {
              nodes {
                name,
                url
              }
            }
          }
        }
    
  3. 选择 运行

相关主题