You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

567 lines
24 KiB

  1. /*jslint indent: 2, browser: true, bitwise: true, plusplus: true */
  2. var twemoji = (function (
  3. /*! Copyright Twitter Inc. and other contributors. Licensed under MIT *//*
  4. https://github.com/twitter/twemoji/blob/gh-pages/LICENSE
  5. */
  6. // WARNING: this file is generated automatically via
  7. // `node twemoji-generator.js`
  8. // please update its `createTwemoji` function
  9. // at the bottom of the same file instead.
  10. ) {
  11. 'use strict';
  12. /*jshint maxparams:4 */
  13. var
  14. // the exported module object
  15. twemoji = {
  16. /////////////////////////
  17. // properties //
  18. /////////////////////////
  19. // default assets url, by default will be Twitter Inc. CDN
  20. base: 'https://twemoji.maxcdn.com/2/',
  21. // default assets file extensions, by default '.png'
  22. ext: '.png',
  23. // default assets/folder size, by default "72x72"
  24. // available via Twitter CDN: 72
  25. size: '72x72',
  26. // default class name, by default 'emoji'
  27. className: 'emoji',
  28. // basic utilities / helpers to convert code points
  29. // to JavaScript surrogates and vice versa
  30. convert: {
  31. /**
  32. * Given an HEX codepoint, returns UTF16 surrogate pairs.
  33. *
  34. * @param string generic codepoint, i.e. '1F4A9'
  35. * @return string codepoint transformed into utf16 surrogates pair,
  36. * i.e. \uD83D\uDCA9
  37. *
  38. * @example
  39. * twemoji.convert.fromCodePoint('1f1e8');
  40. * // "\ud83c\udde8"
  41. *
  42. * '1f1e8-1f1f3'.split('-').map(twemoji.convert.fromCodePoint).join('')
  43. * // "\ud83c\udde8\ud83c\uddf3"
  44. */
  45. fromCodePoint: fromCodePoint,
  46. /**
  47. * Given UTF16 surrogate pairs, returns the equivalent HEX codepoint.
  48. *
  49. * @param string generic utf16 surrogates pair, i.e. \uD83D\uDCA9
  50. * @param string optional separator for double code points, default='-'
  51. * @return string utf16 transformed into codepoint, i.e. '1F4A9'
  52. *
  53. * @example
  54. * twemoji.convert.toCodePoint('\ud83c\udde8\ud83c\uddf3');
  55. * // "1f1e8-1f1f3"
  56. *
  57. * twemoji.convert.toCodePoint('\ud83c\udde8\ud83c\uddf3', '~');
  58. * // "1f1e8~1f1f3"
  59. */
  60. toCodePoint: toCodePoint
  61. },
  62. /////////////////////////
  63. // methods //
  64. /////////////////////////
  65. /**
  66. * User first: used to remove missing images
  67. * preserving the original text intent when
  68. * a fallback for network problems is desired.
  69. * Automatically added to Image nodes via DOM
  70. * It could be recycled for string operations via:
  71. * $('img.emoji').on('error', twemoji.onerror)
  72. */
  73. onerror: function onerror() {
  74. if (this.parentNode) {
  75. this.parentNode.replaceChild(createText(this.alt), this);
  76. }
  77. },
  78. /**
  79. * Main method/logic to generate either <img> tags or HTMLImage nodes.
  80. * "emojify" a generic text or DOM Element.
  81. *
  82. * @overloads
  83. *
  84. * String replacement for `innerHTML` or server side operations
  85. * twemoji.parse(string);
  86. * twemoji.parse(string, Function);
  87. * twemoji.parse(string, Object);
  88. *
  89. * HTMLElement tree parsing for safer operations over existing DOM
  90. * twemoji.parse(HTMLElement);
  91. * twemoji.parse(HTMLElement, Function);
  92. * twemoji.parse(HTMLElement, Object);
  93. *
  94. * @param string|HTMLElement the source to parse and enrich with emoji.
  95. *
  96. * string replace emoji matches with <img> tags.
  97. * Mainly used to inject emoji via `innerHTML`
  98. * It does **not** parse the string or validate it,
  99. * it simply replaces found emoji with a tag.
  100. * NOTE: be sure this won't affect security.
  101. *
  102. * HTMLElement walk through the DOM tree and find emoji
  103. * that are inside **text node only** (nodeType === 3)
  104. * Mainly used to put emoji in already generated DOM
  105. * without compromising surrounding nodes and
  106. * **avoiding** the usage of `innerHTML`.
  107. * NOTE: Using DOM elements instead of strings should
  108. * improve security without compromising too much
  109. * performance compared with a less safe `innerHTML`.
  110. *
  111. * @param Function|Object [optional]
  112. * either the callback that will be invoked or an object
  113. * with all properties to use per each found emoji.
  114. *
  115. * Function if specified, this will be invoked per each emoji
  116. * that has been found through the RegExp except
  117. * those follwed by the invariant \uFE0E ("as text").
  118. * Once invoked, parameters will be:
  119. *
  120. * iconId:string the lower case HEX code point
  121. * i.e. "1f4a9"
  122. *
  123. * options:Object all info for this parsing operation
  124. *
  125. * variant:char the optional \uFE0F ("as image")
  126. * variant, in case this info
  127. * is anyhow meaningful.
  128. * By default this is ignored.
  129. *
  130. * If such callback will return a falsy value instead
  131. * of a valid `src` to use for the image, nothing will
  132. * actually change for that specific emoji.
  133. *
  134. *
  135. * Object if specified, an object containing the following properties
  136. *
  137. * callback Function the callback to invoke per each found emoji.
  138. * base string the base url, by default twemoji.base
  139. * ext string the image extension, by default twemoji.ext
  140. * size string the assets size, by default twemoji.size
  141. *
  142. * @example
  143. *
  144. * twemoji.parse("I \u2764\uFE0F emoji!");
  145. * // I <img class="emoji" draggable="false" alt="❤️" src="/assets/2764.gif"> emoji!
  146. *
  147. *
  148. * twemoji.parse("I \u2764\uFE0F emoji!", function(iconId, options) {
  149. * return '/assets/' + iconId + '.gif';
  150. * });
  151. * // I <img class="emoji" draggable="false" alt="❤️" src="/assets/2764.gif"> emoji!
  152. *
  153. *
  154. * twemoji.parse("I \u2764\uFE0F emoji!", {
  155. * size: 72,
  156. * callback: function(iconId, options) {
  157. * return '/assets/' + options.size + '/' + iconId + options.ext;
  158. * }
  159. * });
  160. * // I <img class="emoji" draggable="false" alt="❤️" src="/assets/72x72/2764.png"> emoji!
  161. *
  162. */
  163. parse: parse,
  164. /**
  165. * Given a string, invokes the callback argument
  166. * per each emoji found in such string.
  167. * This is the most raw version used by
  168. * the .parse(string) method itself.
  169. *
  170. * @param string generic string to parse
  171. * @param Function a generic callback that will be
  172. * invoked to replace the content.
  173. * This calback wil receive standard
  174. * String.prototype.replace(str, callback)
  175. * arguments such:
  176. * callback(
  177. * rawText, // the emoji match
  178. * );
  179. *
  180. * and others commonly received via replace.
  181. */
  182. replace: replace,
  183. /**
  184. * Simplify string tests against emoji.
  185. *
  186. * @param string some text that might contain emoji
  187. * @return boolean true if any emoji was found, false otherwise.
  188. *
  189. * @example
  190. *
  191. * if (twemoji.test(someContent)) {
  192. * console.log("emoji All The Things!");
  193. * }
  194. */
  195. test: test
  196. },
  197. // used to escape HTML special chars in attributes
  198. escaper = {
  199. '&': '&amp;',
  200. '<': '&lt;',
  201. '>': '&gt;',
  202. "'": '&#39;',
  203. '"': '&quot;'
  204. },
  205. // RegExp based on emoji's official Unicode standards
  206. // http://www.unicode.org/Public/UNIDATA/EmojiSources.txt
  207. re = /\ud83d[\udc68-\udc69](?:\ud83c[\udffb-\udfff])?\u200d(?:\u2695\ufe0f|\u2696\ufe0f|\u2708\ufe0f|\ud83c[\udf3e\udf73\udf93\udfa4\udfa8\udfeb\udfed]|\ud83d[\udcbb\udcbc\udd27\udd2c\ude80\ude92])|(?:\ud83c[\udfcb\udfcc]|\ud83d\udd75|\u26f9)(?:\ufe0f|\ud83c[\udffb-\udfff])\u200d[\u2640\u2642]\ufe0f|(?:\ud83c[\udfc3\udfc4\udfca]|\ud83d[\udc6e\udc71\udc73\udc77\udc81\udc82\udc86\udc87\ude45-\ude47\ude4b\ude4d\ude4e\udea3\udeb4-\udeb6]|\ud83e[\udd26\udd37-\udd39\udd3d\udd3e])(?:\ud83c[\udffb-\udfff])?\u200d[\u2640\u2642]\ufe0f|\ud83d\udc68\u200d\u2764\ufe0f\u200d\ud83d\udc8b\u200d\ud83d\udc68|\ud83d\udc68\u200d\ud83d\udc68\u200d\ud83d\udc66\u200d\ud83d\udc66|\ud83d\udc68\u200d\ud83d\udc68\u200d\ud83d\udc67\u200d\ud83d[\udc66\udc67]|\ud83d\udc68\u200d\ud83d\udc69\u200d\ud83d\udc66\u200d\ud83d\udc66|\ud83d\udc68\u200d\ud83d\udc69\u200d\ud83d\udc67\u200d\ud83d[\udc66\udc67]|\ud83d\udc69\u200d\u2764\ufe0f\u200d\ud83d\udc8b\u200d\ud83d[\udc68\udc69]|\ud83d\udc69\u200d\ud83d\udc69\u200d\ud83d\udc66\u200d\ud83d\udc66|\ud83d\udc69\u200d\ud83d\udc69\u200d\ud83d\udc67\u200d\ud83d[\udc66\udc67]|\ud83d\udc68\u200d\u2764\ufe0f\u200d\ud83d\udc68|\ud83d\udc68\u200d\ud83d\udc66\u200d\ud83d\udc66|\ud83d\udc68\u200d\ud83d\udc67\u200d\ud83d[\udc66\udc67]|\ud83d\udc68\u200d\ud83d\udc68\u200d\ud83d[\udc66\udc67]|\ud83d\udc68\u200d\ud83d\udc69\u200d\ud83d[\udc66\udc67]|\ud83d\udc69\u200d\u2764\ufe0f\u200d\ud83d[\udc68\udc69]|\ud83d\udc69\u200d\ud83d\udc66\u200d\ud83d\udc66|\ud83d\udc69\u200d\ud83d\udc67\u200d\ud83d[\udc66\udc67]|\ud83d\udc69\u200d\ud83d\udc69\u200d\ud83d[\udc66\udc67]|\ud83c\udff3\ufe0f\u200d\ud83c\udf08|\ud83c\udff4\u200d\u2620\ufe0f|\ud83d\udc41\u200d\ud83d\udde8|\ud83d\udc68\u200d\ud83d[\udc66\udc67]|\ud83d\udc69\u200d\ud83d[\udc66\udc67]|\ud83d\udc6f\u200d\u2640\ufe0f|\ud83d\udc6f\u200d\u2642\ufe0f|\ud83e\udd3c\u200d\u2640\ufe0f|\ud83e\udd3c\u200d\u2642\ufe0f|(?:[\u0023\u002a\u0030-\u0039])\ufe0f?\u20e3|(?:(?:\ud83c[\udfcb\udfcc]|\ud83d[\udd74\udd75\udd90]|[\u261d\u26f7\u26f9\u270c\u270d])(?:\ufe0f|(?!\ufe0e))|\ud83c[\udf85\udfc2-\udfc4\udfc7\udfca]|\ud83d[\udc42\udc43\udc46-\udc50\udc66-\udc69\udc6e\udc70-\udc78\udc7c\udc81-\udc83\udc85-\udc87\udcaa\udd7a\udd95\udd96\ude45-\ude47\ude4b-\ude4f\udea3\udeb4-\udeb6\udec0\udecc]|\ud83e[\udd18-\udd1c\udd1e\udd26\udd30\udd33-\udd39\udd3d\udd3e]|[\u270a\u270b])(?:\ud83c[\udffb-\udfff]|)|\ud83c\udde6\ud83c[\udde8-\uddec\uddee\uddf1\uddf2\uddf4\uddf6-\uddfa\uddfc\uddfd\uddff]|\ud83c\udde7\ud83c[\udde6\udde7\udde9-\uddef\uddf1-\uddf4\uddf6-\uddf9\uddfb\uddfc\uddfe\uddff]|\ud83c\udde8\ud83c[\udde6\udde8\udde9\uddeb-\uddee\uddf0-\uddf5\uddf7\uddfa-\uddff]|\ud83c\udde9\ud83c[\uddea\uddec\uddef\uddf0\uddf2\uddf4\uddff]|\ud83c\uddea\ud83c[\udde6\udde8\uddea\uddec\udded\uddf7-\uddfa]|\ud83c\uddeb\ud83c[\uddee-\uddf0\uddf2\uddf4\uddf7]|\ud83c\uddec\ud83c[\udde6\udde7\udde9-\uddee\uddf1-\uddf3\uddf5-\uddfa\uddfc\uddfe]|\ud83c\udded\ud83c[\uddf0\uddf2\uddf3\uddf7\uddf9\uddfa]|\ud83c\uddee\ud83c[\udde8-\uddea\uddf1-\uddf4\uddf6-\uddf9]|\ud83c\uddef\ud83c[\uddea\uddf2\uddf4\uddf5]|\ud83c\uddf0\ud83c[\uddea\uddec-\uddee\uddf2\uddf3\uddf5\uddf7\uddfc\uddfe\uddff]|\ud83c\uddf1\ud83c[\udde6-\udde8\uddee\uddf0\uddf7-\uddfb\uddfe]|\ud83c\uddf2\ud83c[\udde6\udde8-\udded\uddf0-\uddff]|\ud83c\uddf3\ud83c[\udde6\udde8\uddea-\uddec\uddee\uddf1\uddf4\uddf5\uddf7\uddfa\uddff]|\ud83c\uddf4\ud83c\uddf2|\ud83c\uddf5\ud83c[\udde6\uddea-\udded\uddf0-\uddf3\uddf7-\uddf9\uddfc\uddfe]|\ud83c\uddf6\ud83c\udde6|\ud83c\uddf7\ud83c[\uddea\uddf4\uddf8\uddfa\uddfc]|\ud83c\uddf8\ud83c[\udde6-\uddea\uddec-\uddf4\uddf7-\uddf9\uddfb\uddfd-\uddff]|\ud83c\uddf9\ud83c[\udde6\udde8\udde9\uddeb-\udded\uddef-\uddf4\uddf7\uddf9\uddfb\uddfc\uddff]|\ud83c\uddfa\ud83c[\udde6\uddec\uddf2\uddf3\uddf8\uddfe\uddff]|\ud83c\uddfb\ud83c[\udde6\udde8\uddea\uddec\uddee\uddf3\uddfa]|\ud83c\uddfc\ud83c[\uddeb\uddf8]|\ud83c\uddfd\ud83c\uddf0|\ud83c\uddfe\ud83c[\uddea\uddf9]|\ud83c\uddff\ud83c[\udde6\uddf2\uddfc]|\ud800\udc00|\ud83c[\udccf\udd8e\udd91-\udd9a\udde6-\uddff\ude01\ude32-\ude36\ude38-\ude3a\ude50\ude51\udf00-\udf20\udf2d-\udf35\udf37-\udf7c\udf7e-\udf84\udf86-\udf93\udfa0-\udfc1\udfc5\udfc6\udfc8\udfc9\udfcf-\udfd3\udfe0-\udff0\udff4\udff8-\udfff]|\ud83d[\udc00-\udc3e\udc40\udc44\udc45\udc51-\udc65\udc6a-\udc6d\udc6f\udc79-\udc7b\udc7d-\udc80\udc84\udc88-\udca9\udcab-\udcfc\udcff-\udd3d\udd4b-\udd4e\udd50-\udd67\udda4\uddfb-\ude44\ude48-\ude4a\ude80-\udea2\udea4-\udeb3\udeb7-\udebf\udec1-\udec5\uded0-\uded2\udeeb\udeec\udef4-\udef6]|\ud83e[\udd10-\udd17\udd1d\udd20-\udd25\udd27\udd3a\udd3c\udd40-\udd45\udd47-\udd4b\udd50-\udd5e\udd80-\udd91\uddc0]|[\u23e9-\u23ec\u23f0\u23f3\u2640\u2642\u2695\u26ce\u2705\u2728\u274c\u274e\u2753-\u2755\u2795-\u2797\u27b0\u27bf\ue50a]|(?:\ud83c[\udc04\udd70\udd71\udd7e\udd7f\ude02\ude1a\ude2f\ude37\udf21\udf24-\udf2c\udf36\udf7d\udf96\udf97\udf99-\udf9b\udf9e\udf9f\udfcd\udfce\udfd4-\udfdf\udff3\udff5\udff7]|\ud83d[\udc3f\udc41\udcfd\udd49\udd4a\udd6f\udd70\udd73\udd76-\udd79\udd87\udd8a-\udd8d\udda5\udda8\uddb1\uddb2\uddbc\uddc2-\uddc4\uddd1-\uddd3\udddc-\uddde\udde1\udde3\udde8\uddef\uddf3\uddfa\udecb\udecd-\udecf\udee0-\udee5\udee9\udef0\udef3]|[\u00a9\u00ae\u203c\u2049\u2122\u2139\u2194-\u2199\u21a9\u21aa\u231a\u231b\u2328\u23cf\u23ed-\u23ef\u23f1\u23f2\u23f8-\u23fa\u24c2\u25aa\u25ab\u25b6\u25c0\u25fb-\u25fe\u2600-\u2604\u260e\u2611\u2614\u2615\u2618\u2620\u2622\u2623\u2626\u262a\u262e\u262f\u2638-\u263a\u2648-\u2653\u2660\u2663\u2665\u2666\u2668\u267b\u267f\u2692-\u2694\u2696\u2697\u2699\u269b\u269c\u26a0\u26a1\u26aa\u26ab\u26b0\u26b1\u26bd\u26be\u26c4\u26c5\u26c8\u26cf\u26d1\u26d3\u26d4\u26e9\u26ea\u26f0-\u26f5\u26f8\u26fa\u26fd\u2702\u2708\u2709\u270f\u2712\u2714\u2716\u271d\u2721\u2733\u2734\u2744\u2747\u2757\u2763\u2764\u27a1\u2934\u2935\u2b05-\u2b07\u2b1b\u2b1c\u2b50\u2b55\u3030\u303d\u3297\u3299])(?:\ufe0f|(?!\ufe0e))/g,
  208. // avoid runtime RegExp creation for not so smart,
  209. // not JIT based, and old browsers / engines
  210. UFE0Fg = /\uFE0F/g,
  211. // avoid using a string literal like '\u200D' here because minifiers expand it inline
  212. U200D = String.fromCharCode(0x200D),
  213. // used to find HTML special chars in attributes
  214. rescaper = /[&<>'"]/g,
  215. // nodes with type 1 which should **not** be parsed (including lower case svg)
  216. shouldntBeParsed = /IFRAME|NOFRAMES|NOSCRIPT|SCRIPT|SELECT|STYLE|TEXTAREA|[a-z]/,
  217. // just a private shortcut
  218. fromCharCode = String.fromCharCode;
  219. return twemoji;
  220. /////////////////////////
  221. // private functions //
  222. // declaration //
  223. /////////////////////////
  224. /**
  225. * Shortcut to create text nodes
  226. * @param string text used to create DOM text node
  227. * @return Node a DOM node with that text
  228. */
  229. function createText(text) {
  230. return document.createTextNode(text);
  231. }
  232. /**
  233. * Utility function to escape html attribute text
  234. * @param string text use in HTML attribute
  235. * @return string text encoded to use in HTML attribute
  236. */
  237. function escapeHTML(s) {
  238. return s.replace(rescaper, replacer);
  239. }
  240. /**
  241. * Default callback used to generate emoji src
  242. * based on Twitter CDN
  243. * @param string the emoji codepoint string
  244. * @param string the default size to use, i.e. "36x36"
  245. * @return string the image source to use
  246. */
  247. function defaultImageSrcGenerator(icon, options) {
  248. return ''.concat(options.base, options.size, '/', icon, options.ext);
  249. }
  250. /**
  251. * Given a generic DOM nodeType 1, walk through all children
  252. * and store every nodeType 3 (#text) found in the tree.
  253. * @param Element a DOM Element with probably some text in it
  254. * @param Array the list of previously discovered text nodes
  255. * @return Array same list with new discovered nodes, if any
  256. */
  257. function grabAllTextNodes(node, allText) {
  258. var
  259. childNodes = node.childNodes,
  260. length = childNodes.length,
  261. subnode,
  262. nodeType;
  263. while (length--) {
  264. subnode = childNodes[length];
  265. nodeType = subnode.nodeType;
  266. // parse emoji only in text nodes
  267. if (nodeType === 3) {
  268. // collect them to process emoji later
  269. allText.push(subnode);
  270. }
  271. // ignore all nodes that are not type 1 or that
  272. // should not be parsed as script, style, and others
  273. else if (nodeType === 1 && !shouldntBeParsed.test(subnode.nodeName)) {
  274. grabAllTextNodes(subnode, allText);
  275. }
  276. }
  277. return allText;
  278. }
  279. /**
  280. * Used to both remove the possible variant
  281. * and to convert utf16 into code points.
  282. * If there is a zero-width-joiner (U+200D), leave the variants in.
  283. * @param string the raw text of the emoji match
  284. */
  285. function grabTheRightIcon(rawText) {
  286. // if variant is present as \uFE0F
  287. return toCodePoint(rawText.indexOf(U200D) < 0 ?
  288. rawText.replace(UFE0Fg, '') :
  289. rawText
  290. );
  291. }
  292. /**
  293. * DOM version of the same logic / parser:
  294. * emojify all found sub-text nodes placing images node instead.
  295. * @param Element generic DOM node with some text in some child node
  296. * @param Object options containing info about how to parse
  297. *
  298. * .callback Function the callback to invoke per each found emoji.
  299. * .base string the base url, by default twemoji.base
  300. * .ext string the image extension, by default twemoji.ext
  301. * .size string the assets size, by default twemoji.size
  302. *
  303. * @return Element same generic node with emoji in place, if any.
  304. */
  305. function parseNode(node, options) {
  306. var
  307. allText = grabAllTextNodes(node, []),
  308. length = allText.length,
  309. attrib,
  310. attrname,
  311. modified,
  312. fragment,
  313. subnode,
  314. text,
  315. match,
  316. i,
  317. index,
  318. img,
  319. rawText,
  320. iconId,
  321. src;
  322. while (length--) {
  323. modified = false;
  324. fragment = document.createDocumentFragment();
  325. subnode = allText[length];
  326. text = subnode.nodeValue;
  327. i = 0;
  328. while ((match = re.exec(text))) {
  329. index = match.index;
  330. if (index !== i) {
  331. fragment.appendChild(
  332. createText(text.slice(i, index))
  333. );
  334. }
  335. rawText = match[0];
  336. iconId = grabTheRightIcon(rawText);
  337. i = index + rawText.length;
  338. src = options.callback(iconId, options);
  339. if (src) {
  340. img = new Image();
  341. img.onerror = options.onerror;
  342. img.setAttribute('draggable', 'false');
  343. attrib = options.attributes(rawText, iconId);
  344. for (attrname in attrib) {
  345. if (
  346. attrib.hasOwnProperty(attrname) &&
  347. // don't allow any handlers to be set + don't allow overrides
  348. attrname.indexOf('on') !== 0 &&
  349. !img.hasAttribute(attrname)
  350. ) {
  351. img.setAttribute(attrname, attrib[attrname]);
  352. }
  353. }
  354. img.className = options.className;
  355. img.alt = rawText;
  356. img.src = src;
  357. modified = true;
  358. fragment.appendChild(img);
  359. }
  360. if (!img) fragment.appendChild(createText(rawText));
  361. img = null;
  362. }
  363. // is there actually anything to replace in here ?
  364. if (modified) {
  365. // any text left to be added ?
  366. if (i < text.length) {
  367. fragment.appendChild(
  368. createText(text.slice(i))
  369. );
  370. }
  371. // replace the text node only, leave intact
  372. // anything else surrounding such text
  373. subnode.parentNode.replaceChild(fragment, subnode);
  374. }
  375. }
  376. return node;
  377. }
  378. /**
  379. * String/HTML version of the same logic / parser:
  380. * emojify a generic text placing images tags instead of surrogates pair.
  381. * @param string generic string with possibly some emoji in it
  382. * @param Object options containing info about how to parse
  383. *
  384. * .callback Function the callback to invoke per each found emoji.
  385. * .base string the base url, by default twemoji.base
  386. * .ext string the image extension, by default twemoji.ext
  387. * .size string the assets size, by default twemoji.size
  388. *
  389. * @return the string with <img tags> replacing all found and parsed emoji
  390. */
  391. function parseString(str, options) {
  392. return replace(str, function (rawText) {
  393. var
  394. ret = rawText,
  395. iconId = grabTheRightIcon(rawText),
  396. src = options.callback(iconId, options),
  397. attrib,
  398. attrname;
  399. if (src) {
  400. // recycle the match string replacing the emoji
  401. // with its image counter part
  402. ret = '<img '.concat(
  403. 'class="', options.className, '" ',
  404. 'draggable="false" ',
  405. // needs to preserve user original intent
  406. // when variants should be copied and pasted too
  407. 'alt="',
  408. rawText,
  409. '"',
  410. ' src="',
  411. src,
  412. '"'
  413. );
  414. attrib = options.attributes(rawText, iconId);
  415. for (attrname in attrib) {
  416. if (
  417. attrib.hasOwnProperty(attrname) &&
  418. // don't allow any handlers to be set + don't allow overrides
  419. attrname.indexOf('on') !== 0 &&
  420. ret.indexOf(' ' + attrname + '=') === -1
  421. ) {
  422. ret = ret.concat(' ', attrname, '="', escapeHTML(attrib[attrname]), '"');
  423. }
  424. }
  425. ret = ret.concat('>');
  426. }
  427. return ret;
  428. });
  429. }
  430. /**
  431. * Function used to actually replace HTML special chars
  432. * @param string HTML special char
  433. * @return string encoded HTML special char
  434. */
  435. function replacer(m) {
  436. return escaper[m];
  437. }
  438. /**
  439. * Default options.attribute callback
  440. * @return null
  441. */
  442. function returnNull() {
  443. return null;
  444. }
  445. /**
  446. * Given a generic value, creates its squared counterpart if it's a number.
  447. * As example, number 36 will return '36x36'.
  448. * @param any a generic value.
  449. * @return any a string representing asset size, i.e. "36x36"
  450. * only in case the value was a number.
  451. * Returns initial value otherwise.
  452. */
  453. function toSizeSquaredAsset(value) {
  454. return typeof value === 'number' ?
  455. value + 'x' + value :
  456. value;
  457. }
  458. /////////////////////////
  459. // exported functions //
  460. // declaration //
  461. /////////////////////////
  462. function fromCodePoint(codepoint) {
  463. var code = typeof codepoint === 'string' ?
  464. parseInt(codepoint, 16) : codepoint;
  465. if (code < 0x10000) {
  466. return fromCharCode(code);
  467. }
  468. code -= 0x10000;
  469. return fromCharCode(
  470. 0xD800 + (code >> 10),
  471. 0xDC00 + (code & 0x3FF)
  472. );
  473. }
  474. function parse(what, how) {
  475. if (!how || typeof how === 'function') {
  476. how = {callback: how};
  477. }
  478. // if first argument is string, inject html <img> tags
  479. // otherwise use the DOM tree and parse text nodes only
  480. return (typeof what === 'string' ? parseString : parseNode)(what, {
  481. callback: how.callback || defaultImageSrcGenerator,
  482. attributes: typeof how.attributes === 'function' ? how.attributes : returnNull,
  483. base: typeof how.base === 'string' ? how.base : twemoji.base,
  484. ext: how.ext || twemoji.ext,
  485. size: how.folder || toSizeSquaredAsset(how.size || twemoji.size),
  486. className: how.className || twemoji.className,
  487. onerror: how.onerror || twemoji.onerror
  488. });
  489. }
  490. function replace(text, callback) {
  491. return String(text).replace(re, callback);
  492. }
  493. function test(text) {
  494. // IE6 needs a reset before too
  495. re.lastIndex = 0;
  496. var result = re.test(text);
  497. re.lastIndex = 0;
  498. return result;
  499. }
  500. function toCodePoint(unicodeSurrogates, sep) {
  501. var
  502. r = [],
  503. c = 0,
  504. p = 0,
  505. i = 0;
  506. while (i < unicodeSurrogates.length) {
  507. c = unicodeSurrogates.charCodeAt(i++);
  508. if (p) {
  509. r.push((0x10000 + ((p - 0xD800) << 10) + (c - 0xDC00)).toString(16));
  510. p = 0;
  511. } else if (0xD800 <= c && c <= 0xDBFF) {
  512. p = c;
  513. } else {
  514. r.push(c.toString(16));
  515. }
  516. }
  517. return r.join(sep || '-');
  518. }
  519. }());