Ability to show content emojis using the Atlaskit Emoji package

Forge Forge UI Kit and Custom UI
1

Hi All,

I’m trying to display the emoji that is set for a piece of content in Confluence Cloud using Forge Custom UI.

I have 2 questions.

Querying the emoji for a content

I see that the emoji is stored in the emoji-title-published content property. In it, there is a Unicode value for built-in emojis and an id for custom emojis. The fact that it is stored in a content property makes an additional REST API request necessary, so I would suggest to move this value to a field directly on the content itself. More importantly, how is one supposed to use the value returned for custom emojis?

Displaying the emoji

Built-in emojis could in theory be shown as a Unicode character. However, some emojis, like “pinched fingers“, are not supported in all fonts. Also, even supported emojis do not have a uniform representation across system fonts on different platforms.

I see there is an Atlaskit package for displaying emojis here: Examples – Atlaskit

It is supposed to fix the above problems with Unicode characters. However, this package is marked internal and there is very limited information on how one is supposed to use the components in it. Is there any chance that this package is going to be made public and officially supported in the future? Also, how can I use it to show custom emojis?

Thanks,

Gabor

2

I’m not sure what you mean by the content property making an additional REST call necessary. It seems you can get it with a single call using include-properties. And you can use the ID with, for example, the ADF renderer, as in the examples.