angular-emoji-popup
v1.1.0
Published
Angular based Emoji Popup along with filters for encoding/decoding emojis http://coraza.github.io/angular-emoji-popup/
Downloads
7
Readme
#Angular Emoji
An angular module to serve multiple purpose:
- A directive to render a comprehensive emoji popup from which user can select an emoji.
- Filters to encode the message containing emoji to various formats and decode them.
###Demo
###Note about encoding and decoding There are various standards to encode and decode emojis. Most popular are:
Colon: The emojis are converted to their colon style strings. This is simple to save in the database since its just a string. See the mapping at http://www.emoji-cheat-sheet.com/
UTF-8 Characters: Emojis are mapped to their Unicode characters. The advatage of this method is that some platforms (such as Android, iOS) can render them automatically as emoji unlike colon style encoding which almost always require decoding. On the disadvantage, Saving them in databases require special handling. See note below
A comprehensive list of unicode codes can be obtained from http://apps.timwhitlock.info/emoji/tables/unicode
- HTML: Emojis are converted to HTML
<img>
tags rendering each emoji as an image either from the single image or a sprite. This is the least useful method to adopt as its not cross platform. There is no standardization of Emoji sprite images and hence you will never be sure that target platform has the same emoji images.
This module contain various filters to encode and decode emojis in the above formats.
##Installation
Only dependencies are Jquery
, AngularJs
and angular-Sanitize
module.
<script type="text/javascript" src="https://code.jquery.com/jquery-2.1.3.min.js"></script>
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/angular.js/1.3.7/angular.min.js"></script>
<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/angular.js/1.3.7/angular-sanitize.min.js"></script>
<script type="text/javascript" src="js/config.js"></script>
<script type="text/javascript" src="js/emoji.min.js"></script>
<link type="text/stylesheet" rel="stylesheet" href="css/emoji.min.css" />
Inject the emojiApp
module to your app
angular.module("myApp", ['ngSanitize', 'emojiApp']);
##Usage
The module consists of following components:
emojiForm
- Enclose this directive with atextarea
and abutton
namedemojibtn
. This directive adds acontenteditable
div
and hides thetextarea
. Anything typed into thiscontebteditable
div
is synced with thetextarea
. It also hooks up the button to show an Emoji popup.
<div emoji-form emoji-message="emojiMessage">
<textarea id="messageInput" ng-model="emojiMessage.messagetext"></textarea>
<button id="emojibtn">
<i class="icon icon-emoji"></i>
</button>
</div>
Make sure to initialize emojiMessage
inside your controller
emojiApp.controller('emojiController', ['$scope', function($scope) {
$scope.emojiMessage={};
}]);
###Encoding
By default, emoji are encoded to colon style string. Hence emojiMessage.messagetext
will contain the encoded emoji with colons.
emojiMessage.rawhtml
will contain the raw html string of the message.
For additional encodings, the following filters can be used
colonToCode
: Converts the colon style emoji string to string contaning UTF-8 characters
<div ng-bind="emojiMessage.messagetext | colonToCode"> </div>
###Decoding For decoding the message string containing either colon style emojis or UTF-8 character emojis, following filters can be used:
codeToSmiley
: Converts the string containing UTF-8 characters to smiley representation using HTML
<div ng-bind-html="emojiMessage.encodedtext | codeToSmiley"></div>
colonToSmiley
: Converts the string containing colon characters to smiley representation using HTML
<div ng-bind-html="emojiMessage.encodedtext | colonToSmiley"></div>
##How it works
Much of the functionality of this module is driven by the map contained in config.js
file. It contains a mapping of Emoji UTF-8 character and its colon representation. If you encounter any bugs in this mapping, please raise an issue or send a pull request.
Using MySQL for storage
The following text is taken verbatim from https://github.com/iamcal/js-emoji
Some special care may be needed to store emoji in your database. While some characters (e.g. Cloud, U+2601) are within the Basic Multilingual Plane (BMP), others (e.g. Close Umbrella, U+1F302) are not. As such, they require 4 bytes of storage to encode each character. Inside MySQL, this requires switching from
utf8
storage toutf8mb4
.
You can modify a database and table using a statement like:
ALTER DATABASE my_database DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE my_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
You will also need to modify your connection character set.
You don't need to worry about this if you translate to colon syntax before storage.
##Credits This project utilizes snippets and ideas from following open source projects: