کتابخانه
emoji-datasource-apple یه بسته npm با مجوز MIT از پروژه emoji-data است که تصویرهای ایموجی به سبک اپل رو همراه با یه فایل داده در اختیارت می ذاره. توی فایل داده نام، کد یونیکد و دسته هر ایموجی هست. اگه می خوای ایموجی ها روی همه دستگاه ها و مرورگرها دقیقاً یک شکل دیده بشن، به کارت میاد.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۹۸٫۱ مگابایت· ۳۸۱۴ فایل· انتشار
SHA-256: 1d602e65be88772bf8cc368ce16b855d719eeddbafe128d471b80203f494d29f
ایموجی روی هر سیستم عامل شکل خودش رو داره. همون لبخند روی آیفون یه جور دیده می شه، روی اندروید یه جور دیگه و روی ویندوز باز یه جور دیگه. اگه توی سایتت ایموجی گذاشته باشی، احتمالاً دیدی که ظاهر کار روی دستگاه های مختلف یکدست نیست. emoji-datasource-apple این مشکل رو ساده حل می کنه: خود تصویرها رو بهت می ده تا به جای فونت سیستم، ایموجی ها رو از فایل های خودت نشون بدی.
توی بسته دو چیز اصلی هست. یکی تصویرهای PNG ایموجی ها در چند اندازه، هم به صورت فایل جدا و هم sprite sheet، یعنی یه تصویر بزرگ که همه ایموجی ها کنار هم توش چیده شدن. یکی هم فایل داده که برای هر ایموجی نام کوتاه، کد یونیکد، دسته، ترتیب نمایش، موقعیت روی sprite sheet و نسخه های رنگ پوست رو نگه می داره. پس این بسته انتخابگر ایموجی آماده نیست، فقط مواد خامشه. رابط و منطقش رو باید خودت بنویسی یا از کتابخونه ای استفاده کنی که روی همین نوع داده ساخته شده.
این بسته به درد کسی می خوره که چت، بخش نظرات، انتخابگر ایموجی یا پنل مدیریت می سازه و ظاهر یکدست براش مهمه. توی قالب ها و افزونه های وردپرسی که ایموجی نشون می دن هم می تونه کاربرد داشته باشه. برای انتخابگر یا لیست بلند، sprite sheet معمولاً راحت تره، چون به جای کلی درخواست کوچک فقط یه فایل لود می شه. ولی اگه فقط یکی دو تا ایموجی لابه لای متن می ذاری، همون کاراکتر یونیکد کافیه و لازم نیست یه بسته نسبتاً سنگین رو وارد پروژه کنی. اگه هم سراغش رفتی، فقط اندازه و روشی رو که لازم داری بردار، نه کل بسته رو.
حواست به دو نکته باشه. مجوز MIT مال خود بسته است، ولی طرح تصویرها کار اپله و حقوقش جدا بررسی می شه. اگه پروژه تجاری داری، قبل از استفاده شرایطش رو خودت چک کن. نکته دوم مخصوص شرایط ماست: اگه فایل ها رو از یه CDN خارجی لود کنی، توی روزهای اختلال اینترنت بین الملل ممکنه ایموجی ها نمایش داده نشن. بهتره فایل ها روی هاست خودت باشن. نسخه های رسمی و بدون تغییر emoji-datasource-apple توی مخزن داخلی ما هم هست و می تونی از همون جا برداری.
کار با این بسته چند قدم ساده داره:
آخرش سایت رو روی ویندوز و یه گوشی واقعی هم باز کن. اگه ایموجی ها خالی یا جابه جا دیده شدن، معمولاً مسیر فایل ها یا اندازه تصویر با مختصات هماهنگ نیست. توی متن های راست به چپ هم چک کن ایموجی کنار کلمه های فارسی سر جای درستش بشینه.
ایموجی معمولی یه کاراکتر یونیکده و شکلش رو فونت سیستم تعیین می کنه. این بسته خود تصویرهای ایموجی به سبک اپل رو بهت می ده، پس ظاهرشون روی همه دستگاه ها یکسانه. فایل داده همراهش هم اطلاعات هر ایموجی مثل نام و دسته رو نگه می داره.
خود بسته مجوز MIT داره و استفاده از کدش آزاده. ولی طرح تصویرهای ایموجی کار اپله و حقوقش جدا از این مجوزه. برای پروژه تجاری یا محصول فروشی، قبل از انتشار شرایط استفاده از این تصویرها رو خودت بررسی کن و فقط به برداشت کلی تکیه نکن.
چون بسته فقط فایل ها و داده رو می ده و خودش چیزی توی صفحه نشون نمی ده. باید با کد، تصویر یا sprite sheet رو به صفحه وصل کنی. اگه این کار رو کردی و باز خالیه، اول مسیر فایل ها و بعد مختصات sprite sheet رو بررسی کن.
برای سایت ایرانی، هاست خودت انتخاب مطمئن تره. وقتی اینترنت بین الملل مشکل داره، CDN های خارجی ممکنه کند بشن یا اصلاً باز نشن و ایموجی ها نیان. فایل هایی که روی هاست داخلی باشن معمولاً مثل بقیه فایل های سایتت سریع و در دسترس می مونن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.