0.21.2 • Published 5 years ago

emojidex v0.21.2

Weekly downloads
219
License
emojiOL
Repository
github
Last release
5 years ago

emojidex-web

emojidex-webはウェブサイトやJavaScriptベースのアプリ等で、emojidexの様々なサービスが使える ツールや、ウィジェットが含まれたjQueryプラグインです。

開発にはCoffeeScriptとSlimを使用しています。そこから簡単に使えるJavaScriptモジュールに コンパイルされます。

このライブラリを使用してemojidexのサービスを利用する際には、使用される全ての絵文字はemojidexの CDNから自動的に取得され、クライアント側にキャッシュされます。 それにより、絵文字を自身のサーバーへアップロードしたり、アプリに追加する必要はありません。

デモと機能説明: http://emojidex.github.io/emojidex-web

使い方

使い方は簡単です。

1. 下記を参考に必要なjavascriptとcssを読み込んでください。

<head>
  ...
  <link href="http://cdn.emojidex.com/scripts/css/emojidex.min.css" rel="stylesheet" />
  <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.1.1/jquery.min.js"></script>
  <script src="http://cdn.emojidex.com/scripts/javascript/emojidex.min.js"></script>
  ...
</head>

2. emojidex-webの設定
JavaScriptで使う場合

$(document).ready(function() {
  ...
  $("body").emojidexReplace();
  await $('body').data().plugin_emojidexReplace; // Wait for initialization
  $(".emojidex-plain_text").emojidexAutocomplete();
  await $(".emojidex-plain_text").data().plugin_emojidexAutocomplete; // Wait for initialization
  $(".emojidex-content_editable").emojidexAutocomplete();
  await $(".emojidex-content_editable").data().plugin_emojidexAutocomplete // Wait for initialization
  ...
});

以上で終了です。

機能説明

.emojidexReplace()

指定されたエレメントのテキスト要素を全文検索し、「:」で囲まれた絵文字コード (例:「:smile:」)と、UTF絵文字(例:「😄」)を対応したemojidexの絵文字画像に置き換えます。 emojidexに対応した絵文字が無い場合は、元のテキストがそのまま使用されます。

emojidexReplace :kissing_heart:

UTF moji codes to emoji:
❤🛅😄😡💌💌😈👍💩
💙💙💙

Acknowledged ZWJ emoji:
👨‍👩‍👦

:code: to emoji:
❤:octopus::boar::frog:\:hand_salute: no_match:😄::no match::heart eyes(wh):

emojidex replace image

Options

Defaults

emojidexReplace({
  useLoadingImg: true,
  autoUpdate: true,
  selector: '*',
  ignore: 'script, noscript, canvas, img, style, iframe, input, textarea, pre, code',
  ignoreContentEditable: true
});

options.useLoadingImg

Type: Boolean Default: true

置換実行中にCSSに指定されているローディング画像を表示するか、しないかを設定出来ます。

options.autoUpdate

Type: Boolean Default: true

Ajax処理等で、動的に追加された要素に対しても置換処理を行うかをBooleanで指定出来ます。

options.selector

Type: String Default: *

置換処理を許可する要素を文字列で指定出来ます。 ※options.ignoreの後に判定します。

options.ignore

Type: String Default: script, noscript, canvas, img, style, iframe, input, textarea, pre, code

置換処理を除外する要素を文字列で指定出来ます。

options.ignoreContentEditable

Type: Boolean Default: true

contenteditable="true"の要素の置換を無視するかどうかを設定出来ます。

.emojidexAutocomplete()

input, textarea, contenteditable="true"で「:」から始まる文字列を使ってemojidexの対応絵文字検索し、 候補をリスト表示します。

input, textareaでは候補を選択すると「:【対応する絵文字コード】:」がプレーンテキストで挿入されます。 contenteditable="true"では、候補に表示される絵文字の画像が挿入されます。

Options

Default options

emojidexAutocomplete({
  listLimit: 15,
  content_editable: {
    insertImg: true
  }
});

options.listLimit

Type: Int Default: 15

候補リストの最大数を設定出来ます。

options.content_editable.insertImg

Type: Boolean Default: true

ターゲットがcontenteditable="true"の時に画像挿入するか、プレーンテキストを挿入するかの設定が 出来ます。 falseに設定するとプレーンテキストが挿入されます。

.emojidexPalette()

設定された要素をクリックする事で、様々な機能を持った絵文字パレットを表示する事が出来ます。

パレットの絵文字タイルをクリックすると、クリップボードに絵文字のコードがコピーされます。 また、絵文字の検索や、emojidex.comにログインする機能を使う事で、お気に入りや使用履歴等と連携する事が出来ます。

Options

Default options

emojidexPalette({
  onEmojiButtonClicked: undefined,
  paletteEmojisLimit: 50
});

options.onEmojiButtonClicked

Type: Function({imageTag: クリックした絵文字のimgタグ, emojiCode: クリックした絵文字のcode}) Default: undefined

パレットの絵文字ボタンをクリックした時に実行される関数を設定することが出来ます。

options.paletteEmojisLimit

Type: Int Default: 50

パレットに一度に表示する絵文字の上限を設定する事が出来ます。

ビルドの仕方

nodeにnpmとyarnが必要です。

ソースの取得

まだクローンしていなければ、以下を実行する事でクローンが出来ます。

git clone git@github.com:emojidex/emojidex-web.git
cd emojidex-web

パッケージの取得

yarn install

ビルド

一発ビルド:

yarn build

distフォルダ内に出力されます。

開発用の動的ビルド:

yarn dev

編集の際に再コンパイルされ、 http://localhost:8000/dist/ から確認出来ます。

プレミアムアカウントへの無料アップグレード

あなたが開発者としてemojidexのパッケージやモジュールを使用している場合、プレミアムアカウントへの無料アップグレードをすることが出来ます。

件名を「開発者アカウント」にして以下を記載して、info@emojidex.comにご連絡ください。 1. あなたのemojidexでのユーザー名 2. あなたが取り組もうとしているプロジェクト

テスト

specには2種類あります。 1つはテストアカウントを使用したもの、もう1つはR-18を有効にしたプレミアムアカウントを使用したものです。

テストURL: localhost:8888/?random=false

テストアカウントを使用したテスト

emojidex-webのディレクトリ内で下記のコマンドを実行してください。

yarn gulp spec
もしくは
yarn test

プレミアムアカウントを使用したテスト

プレミアムアカウントを取得した後、下記の情報を含むファイル.envemojidex-webのディレクトリ内に作成します。

例:

USERNAME=Your_UserName
EMAIL=your@email.com
PASSWORD=YourPassword123
AUTH_TOKEN=0123456789abcdef

各値はあなたのものに変更してください。 AUTH_TOKENユーザー情報ページの一番下、「認証トークンの表示」をクリックすることで確認できます(要ログイン)。

上記ファイル作成後、emojidex-webのディレクトリ内で下記のコマンドを実行してください。

yarn gulp spec
もしくは
yarn test

ライセンス

emojidexとemojidex関連のツール全てが emojidex Open License にてライセンスされています。

©2013 emojidex / 株式会社幻創社

0.21.2

5 years ago

0.21.1

5 years ago

0.21.0

6 years ago

0.20.1

6 years ago

0.20.0

6 years ago

0.19.0

7 years ago

0.18.2

7 years ago

0.18.1

7 years ago

0.18.0

7 years ago

0.17.2

8 years ago

0.17.1

8 years ago

0.17.0

8 years ago

0.16.8

8 years ago

0.16.7

8 years ago

0.16.6

8 years ago

0.16.5

8 years ago

0.16.4

8 years ago

0.16.3

8 years ago

0.16.2

8 years ago

0.16.1

8 years ago

0.16.0

8 years ago

0.15.2

8 years ago

0.15.1

8 years ago

0.15.0

8 years ago

0.14.6

8 years ago

0.14.5

8 years ago

0.14.4

8 years ago

0.14.3

9 years ago

0.14.2

9 years ago

0.14.1

9 years ago

0.14.0

9 years ago

0.13.0

9 years ago

0.12.0

9 years ago

0.11.1

9 years ago

0.11.0

9 years ago

0.10.3

9 years ago

0.10.2

9 years ago

0.10.1

9 years ago

0.10.0

9 years ago

0.9.2

9 years ago

0.9.1

9 years ago

0.9.0

9 years ago

0.8.6-beta.3

9 years ago

0.8.6-beta.2

9 years ago

0.8.6-beta.1

9 years ago

0.8.5

9 years ago

0.8.4

9 years ago

0.8.3

9 years ago

0.8.2

9 years ago

0.8.1

9 years ago

0.8.0

9 years ago

0.7.2

9 years ago

0.7.0

9 years ago

0.6.3

9 years ago

0.6.0

9 years ago

0.5.2

10 years ago

0.5.1

10 years ago

0.5.0

10 years ago

0.4.8

10 years ago

0.4.7

10 years ago

0.4.6

10 years ago

0.4.5

10 years ago

0.4.4

10 years ago

0.4.3

10 years ago

0.4.2

10 years ago

0.4.1

10 years ago

0.4.0

10 years ago

0.3.3

10 years ago

0.3.2

10 years ago

0.3.1

10 years ago

0.3.0

10 years ago

0.1.0

10 years ago