نشان‌ها

همه نشان‌ها می‌توانند در مکان‌های مختلف در نمایش گرافیکی استفاده شوند. بنابراین، امکان وجود دارد که اینها را به عنوان متغیر یا متن تعریف کنید.

برای نمایش یک نشان در نمایش گرافیکی، این با تگ [icon:SYMBOLPFAD] مستقیم در متن اعلام می‌شود. مسیر نشان می‌تواند با کلیک راست یا با CTRL+C از کتابخانه نشان‌ها کپی شود. باید اگر ممکن است فقط Material Symbols انتخاب شود تا سبک نمایش گرافیکی یکسان بماند.

کتابخانه نشان‌ها

همه نشان‌های موجود می‌توانند در منوی کنтекست نمایش گرافیکی ▸ نشان‌ها فراخوانی و جستجو شوند. همچنین امکان وجود دارد که یک مجموعه نشان خود را به کتابخانه وارد کنید. روش در زیر توضیح داده شده است.

توضیحات: نامی که در لیست نشان‌ها نمایش داده می‌شود با مسیر نشان یکسان نیست. اگر در مسیر هیچ مجموعه نشان مشخص نشده باشد، خودکاراً مجموعه Glyphicons استفاده خواهد شد.

فیلتر در کتابخانه نشان‌ها نیز بعد از تگ‌های ثبت شده جستجو می‌کند. اگر این رفتار مورد نظر نباشد، فیلتر می‌تواند با یک = شروع شود تا فقط در نام‌ها جستجو کند.

مجموعه نشان Material Symbols (پیش‌فرض)

این مجموعه نشان کاملاً دینامیک است و سبک نشان‌ها خودکاراً مطابق با طراحی نمایش گرافیکی تنظیم می‌شود. علاوه بر این، یک نشان پر شده خودکاراً استفاده خواهد شد اگر نشان باید فعال باشد. هر نشان دارای یک نسخه پر نشده نیست.

نشان‌ها خودکاراً دور می‌شوند اگر شعاع دکمه بزرگتر یا برابر 16 پیکسل باشد. اگر شعاع برابر 0px باشد، نشان‌های تیز استفاده خواهند شد. در ویرایشگر همیشه نشان‌های معمولی استفاده می‌شوند.

توضیح: توصیه می‌شود مجموعه نشان "Material Symbols" را برای طراحی یکسان نمایش گرافیکی استفاده کنید.

مجموعه نشان Material Animated

بعضی از نشان‌های Material Symbols که برای نمایش مقادیر انیمیشن شده‌اند، وجود دارند. این نشان‌ها فقط یک انیمیشن با نشان ساختار دارند. در هنگام انتخاب، متغیرهای بیشتر فعال خواهند شد.

مجموعه نشان Philips Hue

نشان‌های Philips Hue می‌توانند آزادانه استفاده شوند اگر رابط Hue استفاده شود. علاوه بر این، یک مجموعه نشان Hue اضافه از جامعه Home Assistant HASS وجود دارد. اطلاعات بیشتر را در پایان این فصل پیدا کنید.

مجموعه نشان آب و هوا

این مجموعه نشان نشان‌های آب و هوای نمایش گرافیکی را نمایش می‌دهد. اینها به صورت خودکار توسط رابط‌های مختلف پشتیبانی می‌شوند. ببینید فصل زیر نشان‌های آب و هوا.

مجموعه نشان Legacy (قدیمی)

مجموعه نشان Legacy همه نشان‌های نمایش گرافیکی قدیمی را در بر می‌گیرد. سبک نمایش جدید همانند قبل باقی می‌ماند. نشان‌ها نباید بیشتر استفاده شوند زیرا نمایش آنها برای سطح جدید بهینه‌سازی نشده است.

بعضی از نشان‌های قدیمی همچنان انیمیشن شده‌اند:

  • legacy/door
  • legacy/door_2
  • legacy/lock
  • legacy/shutter
  • legacy/shutter_blinds
  • legacy/window
  • legacy/window_tilt

نشان‌های مخفی

همچنین نشان‌هایی وجود دارند که برای نمایش گرافیکی مخفی هستند. اینها در فصل‌های زیر بیشتر توضیح داده می‌شوند.

برای فراخوانی نشان‌ها فقط یک پیشوند URL لازم است.

مجموعه نشان‌های خود

امکان وجود دارد که یک مجموعه نشان را به پروژه وارد کنید. هر مجموعه نشان باید به عنوان یک فایل ZIP آماده شود. برخی از داده‌های نمونه می‌توانند از اینجا دانلود شوند:

نکته حرفه‌ای: پس از وارد کردن موفق، می‌توانید مجموعه نشان را به عنوان .antobj صادر کنید تا وارد کردن آسان‌تر شود. برای این کار با کلیک راست روی یک مجموعه نشان و انتخاب صدور عمل کنید.

قوانین زیر ساخت و نیازهای یک مجموعه نشان را تعریف می‌کنند. لطفاً اینها را با دقت بخوانید و دقیقاً به آنها عمل کنید.

قوانین

  • پیشوند
    • فقط می‌تواند _, a–z و 0–9 را در بر بگیرد.
    • حروف بزرگ خودکاراً به حروف کوچک تبدیل می‌شوند.
    • نام‌های محفوظ مانند sys, src یا doc نامعتبر هستند.
    • باید با یک حرف (a–z) شروع شود. فقط اعداد مجاز نیستند.
    • خط زیرهای اضافه شده (_) حذف می‌شوند.
    • باید حداقل 3 کاراکتر طول داشته باشد.
    • خط زیرهای چندگانه (__) به یک خط زیر کاهش می‌یابند.
  • نام نشان‌ها
    • خودکاراً به حروف کوچک تبدیل می‌شوند.
    • کاراکترهای مجاز -, _, a–z و 0–9 هستند.
    • نام‌های طولانی و پیشوندها باید از آن‌ها اجتناب شود.
    • یک پیشوند باید منحصر به فرد باشد و فقط یک بار استفاده شود.
    • اگر یک نشان همان نام و پیشوند یک نشان سیستم را داشته باشد، می‌تواند آن را جایگزین کند.
  • محدودیت‌های فایل
    • حجم فایل حداکثر پس از پاکسازی: 10 kB. فایل‌های بزرگتر رد می‌شوند.
    • فایل‌های SVG باید پاک شده باشند:
      • خط‌های جدید خودکاراً حذف می‌شوند.
      • عناصر زیر حذف می‌شوند: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • ویژگی‌های زیر حذف می‌شوند: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • نشان‌هایی با اسکریپت‌های دربسته، تصاویر، CSS یا منابع خارجی رد می‌شوند.
      • اگر Styles رنگ‌ها یا بلوک‌های Style را شامل شوند، وارد کردن نیز ممکن است رد شود.
  • نیازهای سربرگ SVG
    • باید شامل باشد: viewBox, width و height. مقادیر ناقص، اگر ممکن است، خودکاراً تکمیل می‌شوند.
    • باید فضای نام را شامل باشد: xmlns="http://www.w3.org/2000/svg". اگر آن وجود ندارد یا اشتباه است، خودکاراً تکمیل می‌شود.
    • نام Icon باید دقیقاً با ابعاد مطابقت داشته باشد، در غیر این صورت Icon رد می‌شود.
    • ابعاد باید مربعی باشند (عرض = ارتفاع). پیش‌فرض: 24px.
    • Styles متضاد یا ابعاد نامناسب باید از آن‌ها اجتناب شود.
  • عمومی
    • Icons بد ساخته شده می‌توانند نمایش را بسیار کند کنند یا حتی اشتباه کنند.
    • به حق تکثیر نشان‌ها توجه کنید.
    • همه وکتورهای به سه رقم اعشاری گرد می‌شوند.

ساختار

  • فایل iconset.ini الزامی است تا مجموعه نشان را تشخیص دهد.
    • این می‌تواند در ریشه فایل ZIP یا در یک زیرمجموعه قرار داشته باشد.
    • باید به حروف کوچک باشد (iconset.ini).
    • نام‌های فایل نشان خود case-sensitive نیستند.
  • وارد کردن خودکاراً پس از فایل‌های SVG جستجو نمی‌کند.
    • پوشه Icon باید در iconset.ini به صورت صریح تعریف شود (توجه به حروف بزرگ/کوچک).
    • در قالب فایل ZIP یک پوشه با نام icons/ تعریف شده است.
  • زیرمجموعه‌ها
    • زیرمجموعه‌هایی در پوشه تعریف شده (icons/) به عنوان دسته‌بندی‌ها عمل می‌کنند.
    • نام‌های نشان باید در همه دسته‌بندی‌ها منحصر به فرد باشند.
    • قوانین نام در پوشه Icon:
      • کمترین: فقط ابعاد و پسوند فایل (مثلاً 24.svg).
      • واریانت‌ها مانند filled24.svg یا round_filled_24.svg مجاز هستند.
      • نام‌های فایل با اعداد چندگانه (مثلاً 24_48.svg) نامعتبر هستند.
      • واریانت‌های Style توسط:
        • پر شده: باید filled یا fill را شامل باشد.
        • دور شده: باید round را شامل باشد.
        • تیز: باید sharp را شامل باشد.
        • دور شده و تیز نمی‌توانند با هم ترکیب شوند.
      • اگر چندین قانون اعمال شود، فایل آخرین شناسایی شده استفاده خواهد شد (انتخاب ممکن است تصادفی به نظر برسد).
  • قوانین دیگر
    • زیرمجموعه‌های زیر زیرمجموعه‌ای جستجو نمی‌شوند (اینها می‌توانند برای پشتیبان‌گیری یا اصلی استفاده شوند).
    • فایل‌هایی بدون .svg نادیده گرفته می‌شوند.
    • در یک پوشه Icon، یک فایل با نام tags.txt وجود دارد تا تگ‌های اضافه برای جستجو اضافه کند.
      • تگ‌ها می‌توانند با ,, ; یا خط‌های جدید جدا شوند.

مجموعه نشان‌های ویژه

همچنین برخی از مجموعه نشان‌های ویژه وجود دارند که مانند مجموعه نشان‌های خود وارد می‌شوند، اما باید مطابق با دستورالعمل‌های بالا تنظیم شوند.

نشان‌های Hass Hue

یکی از آنها نشان‌های Gibhub hass-hue-icons است. این یک مجموعه نشان Hue اضافه از جامعه Home Assistant HASS است و فقط برای پروژه‌های غیر تجاری استفاده می‌شود زیرا تحت مجوز Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International قرار دارد. بنابراین، مجموعه نشان با Antcas Control ارائه نمی‌شود. اما نشان‌ها هر زمان که بخواهید با فایل ZIP hass-hue-icons-main.zip به عنوان یک مجموعه نشان جدید وارد پروژه شوند. در این مورد، شرایط مجوز پروژه را در وب‌سایت Github بررسی کنید.

منبع: https://github.com/arallsopp/hass-hue-icons.

نشان‌های Material Design از Pictogrammers

یکی دیگر نشان‌های Pictogrammers است. برای این کار، فایل mdi-###.json باید به یک فایل ZIP بسته شده و وارد شود. فایل می‌تواند در کنسول توسعه‌دهنده مرورگر پیدا و دانلود شود. تلاش می‌شود نشان‌های Outline با پر شده ترکیب شوند. کتابخانه تقریباً مانند Material Symbols است. اما بسیاری از گسترش‌های جامعه وجود دارد. اگر می‌خواهید مجموعه نشان‌های دیگر را به کتابخانه اضافه کنید، می‌توانید از ما بپرسید.

منبع: https://pictogrammers.com/library/mdi/

صفحات زیرمجموعه