رموز

جميع الرموز يمكن استخدامها في مختلف الأماكن على التصفح. مما يجعل من الممكن تعريف هذه الرموز كمتغير أو نص.

لإظهار رمز على التصفح، يتم استخدامه باستخدام العلامة [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. يمكنك العثور على مزيد من المعلومات في نهاية هذا الفصل.

مجموعة الرموز الجوية

هذه المجموعة من الرموز تعرض رموز الطقس للتصفح. هذه المدعومة بسلاسة من واجهة متعددة. انظر الفصل التالي رموز الطقس.

مجموعة الرموز القديمة (مهملة)

مجموعة الرموز القديمة تحتوي على جميع الرموز من التصفح القديم. يتم الحفاظ على نمط العرض الجديد. لا يجب استخدام هذه الرموز anymore، حيث لم يتم تحسين عرضها للواجهة الجديدة.

بعض الرموز القديمة ما زالت متحركة:

  • 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 كيلوبايت. يتم رفض الملفات الأكبر.
    • يجب تنظيف ملفات 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". إذا كان مفقودًا أو خاطئًا، يتم إضافته تلقائيًا.
    • يجب أن يتطابق اسم الرمز بدقة مع الأبعاد، وإلا سيتم رفضه.
    • يجب أن تكون الأبعاد مربعية (العرض = الارتفاع). الافتراضي: 24px.
    • يجب تجنب Styles المتضاربة أو الأبعاد غير المناسبة.
  • عموميات
    • قد يؤدي إنشاء الرموز بشكل سيئ إلى إبطاء العرض بشكل كبير أو حتى causing errors.
    • الرجاء الانتباه إلى حقوق النشر للرموز.
    • يتم تقريب جميع المتجهات إلى ثلاثة أرقام عشرية.

الهيكلة

  • يجب أن يكون الملف iconset.ini موجودًا بشكل إلزامي لتحديد مجموعة الرموز.
    • يمكن وضعه في الجذر للملف ZIP أو في مجلد فرعي.
    • يجب أن يكون بحروف صغيرة (iconset.ini).
    • أسماء ملفات الرموز نفسها غير حساسة لحروف العلة.
  • لا يبحث الاستيراد تلقائيًا عن ملفات SVG.
    • يجب تحديد مجلد الرموز بشكل صريح في iconset.ini (الاحتفاظ بحروف العلة).
    • تم تعريف مجلد باسم icons/ في قالب ملف ZIP.
  • المجلدات الفرعية
    • تخدم المجلدات الفرعية داخل المجلد المحدد (icons/) كتصنيفات.
    • يجب أن تكون أسماء الرموز فريدة عبر جميع التصنيفات.
    • قواعد الأسماء في مجلد الرموز:
      • الحد الأدنى: فقط الأبعاد واسم الملف (مثل 24.svg).
      • النسخ المختلفة مثل filled24.svg أو round_filled_24.svg صالحة.
      • أسماء الملفات التي تحتوي على أرقام متعددة (مثل 24_48.svg) غير صالحة.
      • تتم التعرف على نسخ Style من خلال:
        • مملوء: يجب أن يحتوي على filled أو fill.
        • دائري: يجب أن يحتوي على round.
        • حادي: يجب أن يحتوي على sharp.
        • لا يمكن دمج الدائري والحادي معًا.
      • إذا كانت هناك عدة قواعد تنطبق، يتم استخدام آخر ملف تم التعرف عليه (قد يبدو الاختيار عشوائيًا).
  • قواعد إضافية
    • لا يتم البحث عن مجلدات فرعية متداخلة (يمكن استخدام هذه للمحافظ أو الأصل).
    • يتم تجاهل الملفات التي لا تحتوي على .svg.
    • في مجلد الرموز، يمكن وضع ملف باسم 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 واستيراده. يمكن العثور على الملف وتحميله في وحدة التحكم التطويرية للمتصفح. يتم محاولة دمج الرموز المتداخلة مع الرموز المملوءة. المكتبة تقريبًا مثل Material Symbols. ومع ذلك، هناك العديد من التوسعات المجتمعية. إذا كنت تريد دمج مجموعات رموز أخرى في المكتبة، يمكنك الاتصال بنا.

المصدر: https://pictogrammers.com/library/mdi/

الصفحات الفرعية