Template:Emoji presentation

File:Test Template Info-Icon - Version (2).svg Template documentationview edit history purge

{{#ifeq:emoji presentation |doc

{{#ifeq:show |show

This is a documentation subpage for Template:Terminate sentence
It may contain usage information, categories and other content that is not part of the original {{#if: |{{{text2}}} |{{#if: |{{{text1}}} |{{#ifeq:Template |User |template template page |{{#if:Template |template page|article}}}}}}}}.

        }}{{#if:|
         |{{#ifexist:Template:Emoji presentation
                  | [[Category:{{#switch:Template |Template=Template |Module=Module |User=User |#default=Wikipedia}} documentation pages]]
                  | 
                 }}
        }}
    | 
   }}

This template uses Unicode variation selectors to request emoji or text presentation of a character. It works by adding VS15 (U+FE0E) for text presentation, and VS16 (U+FE0F) for emoji presentation.

Note that it only works on a single character; any input after the first character (including existing variation selectors) will be removed.

What the reader actually sees will depend on their software. (To see what it looks like in your software, visit the test cases.) Support requires a renderer that understands (and honours) the variation selector, plus a font that contains the desired character, drawn in the requested style. Most modern computer systems have these, but there are always exceptions (and bugs).

Possible reasons to use this template:

It makes the choice visible. Variation selectors are typically not rendered on their own, which makes it hard to edit them separately from the preceding character. Some editors (bots) have been known to strip invisible characters, including variation selectors.
It makes the choice readable. You could use a character entity reference like ︎, but other editors may not know what that is. Some editors (not bots) have been known to strip character entities that don't produce a visible character.
- Also, you would need to look up (or remember) the code points, FE0E and FE0F, and which one is which.
It makes it clear that the choice is intentional. {{Emoji presentation|♈}} tells other editors that you want the colourful emoji, not the text style (as would be preferred, say, in astronomy).
- Input methods, ranging from emoji keyboards to copy-and-paste, may give you either (or no) variation selector automatically. This template means you don't have to know (or care) which one it is.
It avoids relying on defaults. Every character that has both emoji and text presentations will default to one or the other, but which one is unpredictable, and some software may not respect the default. (For example, some users have reported that Google Chrome running on Windows 10 selected emoji versions, where other browsers selected text versions.)

Usage

The following examples use {{#ifexpr:(0=0) and ({{#ifeq:X{{#ifeq:2139 | <#salted#> | <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}|X0000 |0 |1}}) |Error using {{unichar}}: Input "2139" is not a hexadecimal value.

| {{{{#ifeq:|y|sans-serif|mono}}|{{#switch:<#salted#>

| <#salted#>=U+ | =U+ | #default=[[<#salted#>|U+]]}}{{#ifeq:2139 | <#salted#> | <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}}} {{#if:|Template:Substr}}{{#if: | [[File:|frameless|{{#if: | {{#if:|{{{size}}}|10px}} | {{#if:{{{cwith}}}|125%|150%}} }}|baseline|alt={{#if: | Script error: No such module "Unicode alias". | Lua error in Module:Unicode_data at line 541: Parameter 2 is not a code point in hexadecimal base.}}]] | {{#switch:{{#if:0|{{#ifexpr: 0<=65535|{{#ifexpr: (00<=0) and (0<=31) or (127<=0) and (0<=159)| Cc | {{#ifexpr: (55296<=0) and (0<=57343)| Cs | {{#ifexpr: ((57344<=0) and (0<=63743))| Cp | {{#ifexpr: (64976<=0 and 0<=65007) or 0=65534 or 0=65535| Cn | {{#ifexpr: (0=173) or (0=1807) or (0=6068) or (0=6069) or (8203<=0 and 0<=8207) or (8234<=0 and 0<=8238) or (8288<=0 and 0<=8292) or (8298<=0 and 0<=8303) or (0=65279) or (65529<=0 and 0<=65531)| Cf | {{#ifexpr: (1536<=0 and 0<=1539) or (0=1757)| Cf (visible)| {{#ifexpr: 0=32 or 0=160 or 0=5760 or 0=6158 or 0=8239 or 0=8287 or 0=8288 or 0=12288 or (8192<=0 and 0<=8205)| Zs | {{#ifexpr: 0=8232| Zl | {{#ifexpr: 0=8233| Zp | }} }} }} }} }} }} }} }} }}|{{#switch: } }}| FFFE | FFFF = Cn | {{#ifexpr: ((983040<=0) and (0<=1114111))| Cp | {{#ifexpr: 0>=1114112 | <#not a Unicode code point#>| {{#ifexpr: (0=69821) or (119155<=0 and 0<=119162) or (0=917505) or (917536<=0 and 0<=917631)| Cf | }} }} }} }} }}|<#not a Unicode code point#> }}

| <#not a Unicode code point#> =<not-a-Unicode-code-point-{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}>

| Cc =<control-{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}>

| Cs =<surrogate-{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}>

| Cp =<private-use-{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}>

| Cn =<noncharacter-{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}>

| Cf | Zl | Zp =
| Zs ={{#ifeq:{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}| 0020 | |&#x{{#ifeq:2139 | <#salted#> | <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}};}}

| #default={{#switch:unicode
  | ipa   =Template:IPA
  | lang  =[{{#if: | {{{cwith}}} | {{#if:{{{cwith}}} || ◌ }} }}&#x{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}};] Error: {{Lang}}: missing language tag (help)

  | script=Template:Script
  | unicode 
  | #default = {{#ifeq:{{#if: | {{{cwith}}} | {{#if:{{{cwith}}} || ◌ }} }}|◌|Template:Script|{{#if: | {{{cwith}}} | {{#if:{{{cwith}}} || ◌ }} }}&#x{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}; }}}}}}{{#ifeq:{{#if: | {{{cwith}}} | {{#if:{{{cwith}}} || ◌ }} }}| | }}}}{{#if:|Template:Substr}} {{#ifeq:| none || {{#switch:{{#if:0|{{#ifexpr: 0<=65535|{{#ifexpr: (00<=0) and (0<=31) or (127<=0) and (0<=159)| Cc | {{#ifexpr: (55296<=0) and (0<=57343)| Cs | {{#ifexpr: ((57344<=0) and (0<=63743))| Cp | {{#ifexpr: (64976<=0 and 0<=65007) or 0=65534 or 0=65535| Cn | {{#ifexpr: (0=173) or (0=1807) or (0=6068) or (0=6069) or (8203<=0 and 0<=8207) or (8234<=0 and 0<=8238) or (8288<=0 and 0<=8292) or (8298<=0 and 0<=8303) or (0=65279) or (65529<=0 and 0<=65531)| Cf | {{#ifexpr: (1536<=0 and 0<=1539) or (0=1757)| Cf (visible)| {{#ifexpr: 0=32 or 0=160 or 0=5760 or 0=6158 or 0=8239 or 0=8287 or 0=8288 or 0=12288 or (8192<=0 and 0<=8205)| Zs | {{#ifexpr: 0=8232| Zl | {{#ifexpr: 0=8233| Zp | }} }} }} }} }} }} }} }} }}|{{#switch: } }}| FFFE | FFFF = Cn | {{#ifexpr: ((983040<=0) and (0<=1114111))| Cp | {{#ifexpr: 0>=1114112 | <#not a Unicode code point#>| {{#ifexpr: (0=69821) or (119155<=0 and 0<=119162) or (0=917505) or (917536<=0 and 0<=917631)| Cf | }} }} }} }} }}|<#not a Unicode code point#> }} | Zl | Zp | Zs={{#ifeq:<#salted#> | <#salted#> |{{#if: | Script error: No such module "Unicode alias". | Lua error in Module:Unicode_data at line 541: Parameter 2 is not a code point in hexadecimal base.}}| {{#if: <#salted#> | [[<#salted#>|{{#if: | Script error: No such module "Unicode alias". | Lua error in Module:Unicode_data at line 541: Parameter 2 is not a code point in hexadecimal base.}}]] |[[{{#ifeq:{{#ifeq:2139 | <#salted#> | <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}|0020|space (punctuation)|{{#if: | script error: no such module "unicode alias". | lua error in module:unicode_data at line 541: parameter 2 is not a code point in hexadecimal base.}}}}|{{#if: | Script error: No such module "Unicode alias". | Lua error in Module:Unicode_data at line 541: Parameter 2 is not a code point in hexadecimal base.}}]] }}}} | Cc | Cs | Cp | Cn | <#not a Unicode code point#> = {{#ifeq:<#salted#> | <#salted#> || {{#if: <#salted#> | [[<#salted#>]] | Error using {{unichar}}: Pagename expected in "nlink="}}}} | #default={{#switch:<#salted#>

| <#salted#> ={{#if: |  Script error: No such module "Unicode alias". | Lua error in Module:Unicode_data at line 541: Parameter 2 is not a code point in hexadecimal base.}}
| =[[{{#switch:{{#ifeq:2139  | <#salted#>

| <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}}|0023|002E|003C|003E|005B|005D|007B|007C|007D|200E|200F|202A|202B|202C|202D|202E={{#if: | script error: no such module "unicode alias". | lua error in module:unicode_data at line 541: parameter 2 is not a code point in hexadecimal base.}}|003A=colon (punctuation)|005F=underscore|#default=&#x{{#ifeq:2139 | <#salted#> | <#salted#> | {{#switch:2139

   |0x0x
   |u+0x = <#salted#>

}} {{#SWITCH:21

    | U+
    | 0X = {{SAFESUBST:#IFEXPR: 2 < 0

|2139 |{{SAFESUBST:#IFEXPR: 2+1 > 4 | | 2139 }} }}

    |2139 
    }}

}};}}|{{#if: | Script error: No such module "Unicode alias". | Lua error in Module:Unicode_data at line 541: Parameter 2 is not a code point in hexadecimal base.}}]]

| #default =[[<#salted#>|{{#if: |  Script error: No such module "Unicode alias". | Lua error in Module:Unicode_data at line 541: Parameter 2 is not a code point in hexadecimal base.}}]]}}}}}} {{#if:{{#ifeq:{{#ifeq:+|-|yes|no}}|yes||}}

|({{safesubst:#if:1|{{#ifeq:{{#ifeq:{{#ifeq:+|-|yes|no}}|yes||}}|||{{ safesubst:#if: |{{ safesubst:#ifeq:{{{demo}}} |no

|
|

}} |{{ safesubst:#ifeq:Template|Template

|
|

}}}}{{#ifeq:{{#ifeq:+|-|yes|no}}|yes||}}{{#if:|⧼dot-separator⧽}}}}}})}} }}.

Default (requests emoji presentation):

{{Emoji presentation|ℹ}}

Explicitly request emoji presentation:

{{Emoji presentation|ℹ|emoji}}

Request text presentation:

{{Emoji presentation|ℹ|text}}

When using this template to request emoji presentation, you should also add {{Contains special characters|emoticon}} at the top of the article, or {{Contains special characters|emoticon|section}} at the top of the section.

Template data

{{#if:|{{#switch:

|=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3AEmoji+presentation%7CEmoji+presentation%7CEmoji+presentation%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|S|s}}ee a monthly parameter usage report] for {{#if:Emoji presentation|Template:Emoji presentation|this template}} in articles{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}}.

|None|none=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3AEmoji+presentation%7CEmoji+presentation%7CEmoji+presentation%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report]{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}}

|for|For=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3AEmoji+presentation%7CEmoji+presentation%7CEmoji+presentation%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report] for {{#if:Emoji presentation|Template:Emoji presentation|Template:Emoji presentation}}{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}}.

|#default=[1]{{#ifeq:{{safesubst:#switch: y
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}} }}|This is the {{#if:|TemplateData|TemplateData}} for this template used by TemplateWizard, VisualEditor and other tools. {{#switch:

|=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3AEmoji+presentation%7CEmoji+presentation%7CEmoji+presentation%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|S|s}}ee a monthly parameter usage report] for {{#if:Emoji presentation|Template:Emoji presentation|this template}} in articles{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}}.

|None|none=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3AEmoji+presentation%7CEmoji+presentation%7CEmoji+presentation%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report]{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}}

|for|For=[https://bambots.brucemyers.com/TemplateParam.php?wiki=enwiki&template=%7B%7B%23if%3AEmoji+presentation%7CEmoji+presentation%7CEmoji+presentation%7D%7D {{#ifeq:{{safesubst:#switch: {{{lc}}}
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|no|P|p}}arameter usage report] for {{#if:Emoji presentation|Template:Emoji presentation|Template:Emoji presentation}}{{#ifeq:{{safesubst:#switch: y

|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}}.

|#default=[2]{{#ifeq:{{safesubst:#switch: y
|no
|n
|f
|false
|off
|0        = no
|         = no
|¬        = no
|yes
|y
|t
|true
|on
|1        = yes
|#default = no

}}|yes| based on {{#if:Emoji presentation|its|this}} TemplateData}} }}}}

TemplateData for Emoji presentation

{{#switch:

 {{#if:
 | {{{demospace}}}    
 | {{#ifeq:Template|Template
   | template
   | other
   }}
 }}

| template = {{safesubst:#if:{{safesubst:#ifeq:Emoji p|sandbox|1}}{{safesubst:#ifeq:Emoji presentation|doc|1}}||

}} | other | #default = }} <templatedata> { "params": { "1": { "label": "Character", "description": "The Unicode character to be presented as emoji or text. Enter this as text or an XML entity, not as a Unicode codepoint.", "example": "ℹ", "type": "unknown" }, "2": { "label": "Presentation style", "description": "The presentation style to be used, either \"emoji\" or \"text\".", "example": "emoji", "default": "emoji" } }, "description": "Apply a Unicode variation selector to request emoji or text presentation of a character." } </templatedata>

{{safesubst:#if:{{safesubst:#ifeq:Emoji p|sandbox|1}}{{safesubst:#ifeq:Emoji presentation|doc|1}}|| }}

The above documentation is transcluded from Template:Emoji presentation/doc. (edit | history)
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages.
Add categories to the /doc subpage. Subpages of this template.