This project is currently unmaintained.

Master	Develop

A swiss-army-knife for all emoji, in Javascript. Used by Gitter and Mapbox.

The emoji keywords are as described by emoji-cheat-sheet.com.

Go to this project's GitHub pages to see the code in action.

• Fast
• Awesome
• Converts emoticons like :) :( :'(
• Allows customisation of processed emoji
• Multiple modes; img, sprites and data-URI
• Available on a CDN (gasp)
• Includes a sample .htaccess file for caching Javascript and CSS
• Switchable emoji sets (SOON!)
• Made from unicorn blood

Care about old browsers compatibility? Use https://github.com/es-shims/es5-shim

emojify.js is now available on cdnjs - https://cdnjs.com/libraries/emojify.js

Add this to the rest of your stylesheet imports:

<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/emojify.js/1.1.0/css/basic/emojify.min.css" />

Then add this to your Javascript code:

<script src="//cdnjs.cloudflare.com/ajax/libs/emojify.js/1.1.0/js/emojify.min.js"></script>

bower install emojify.js --save

npm install emojify.js --save

This works in the browser and on Node

• object - Optional JSON object with any of the following attributes:

emojify.setConfig({tag_type : 'div'});

This works in the browser and Node

• element - Optional HTML element to restrict the emojification to.
• replacer - Optional Function to override emoji replacement behaviour with your own. The function will receive two arguments, the emoji pattern found (emoji), and the emoji name (name). In the case of emoticons, for example, emoji = ':)' and name = 'smile'. Your function must return a HTMLElement.

emojify.run();
// OR
emojify.run(document.getElementById('my-element'))
// OR
emojify.run(null, function(emoji, emojiName){
  var span = document.createElement('span');
  span.className = 'emoji emoji-'  + emojiName;
  span.innerHTML = emoji + ' replaced';
  return span;
});

Requires you to have jsdom installed: npm i jsdom --save

var jsdom = require('jsdom')

jsdom.env({
    html: "<p><code>jhhh</code><em>:)</em></p>",
    done: function(errors, window) {
        emojify.run(window.document.body)
    }
});

This works in the browser and on Node

• string - String to emojify
• callback - Optional callback function to output emoji with

By default, emojify.js uses the internal function defaultReplacer() to replace emoji. You can override this behaviour by supplying your own callback function.

Your callback function will receive two arguments, the emoji pattern found (emoji), and the emoji name (name). In the case of emoticons, for example, emoji = ':)' and name = 'smile'.

The context in which your replacer function is run will have the config available. So you can access properties such as img_dir at this.config.img_dir.

emojify.replace('I am happy :)');
// OR
replacer = function(emoji, name) {
    // Customise output here
    return emojifiedString;
}

emojify.replace('I am happy :)', replacer);

Please read CONTRIBUTING.md.

• All Contributors
• Hassan Khan

Please read LICENSE.md. For image attributions, please read LICENSE-IMAGES.md