Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Image fallback for emoji
JavaScript Ruby
branch: master
Failed to load latest commit information.
spec Gulpify
.gitignore Gulpify
.travis.yml Build on Travis CI
LICENSE.txt Add license Build on Travis CI
Rakefile Fix file names
bower.json Bump version to 0.2.0
emojie.js UMD wrapper
emojie.min.js Build minified JS
gulpfile.js Gulpify
package.json Bump version to 0.2.0
sample.html Refactor to allow multiple emojie sets

Emojie Build Status

JavaScript library which aims to provide fallbacks for Emoji glyphs as images.

Emoji sets:


// Define mappings to images
emojie.register("\ud83d\ude04", options);

Options is set individually for each emoji. All options will be transfered as attributes to the img element, so you might want to at least set the src attribute.

An example to clarify:

emojie.register("\ud83d\ude04", { src: "emoji/smile.png", class: "smile", title: "smile!", id: "example-smiley" });
// <img src="emoji/smile.png" id="example-smiley" class="emojie emojie-smile" title="smile!">

There is only one exception: you can set the elementName and content options to wrap the emoji inside an element of the given type and set it's content to the content option. This is useful if one want's to use images in Chrome and real emojis in Safari wrapped in a span element perhaps.

To ignore elements from emojification, set data-no-emoji attribute. For example,

  <p>This will get emojified.</p>
  <p data-no-emojie>But this won't.</p>


The build process runs on gulp. Assuming npm is installed, dependencies can be installed by running

$ npm install

After that, you can run use local gulp from ./node_modules/.bin/gulp or have it installed globally with

$ npm install -g gulp

Then you should be able to run tests with

$ gulp test

To continously run tests after file changes use

$ gulp watch

There's also a gulp task for compiling minified JS file:

$ gulp dist
Something went wrong with that request. Please try again.