مكتبات الأيقونات.

Learn DXPR BuilderManage the siteJe huisstijl toepassen

يعرض منتقي الأيقونات في عنصري الأيقونة وعداد الدائرة كل مجموعة أيقونات مسجلة على موقعكم. يشحن DXPR Builder مع 14 مجموعة؛ ويمكن للوحدات والقوالب إضافة المزيد بملف YAML. تسرد هذه الصفحة المجموعات المشحونة وتشرح كيفية تحميلها وتعرض كيفية إضافة واحدة. ولتقييد المجموعات التي يراها دور، استخدموا ملف منشئ؛ انظر ملفات تعريف المستخدم.

مجموعات الأيقونات المشحونة

المجموعات مسجلة في dxpr_builder.dxpr_icon_sets.yml:

المفتاح	التسمية في المنتقي	بادئة الفئة	المكتبة
`bi`	Bootstrap Icons	`bi`	`dxpr_builder/elements.bootstrap_icons`
`et`	ET Line Icons	`et`	`dxpr_builder/elements.et_line_font`
`fab`	Font Awesome Free Brands	`fab`	`dxpr_builder/elements.font_awesome_6_free`
`far`	Font Awesome Free Regular	`far`	`dxpr_builder/elements.font_awesome_6_free`
`fas`	Font Awesome Free Solid	`fas`	`dxpr_builder/elements.font_awesome_6_free`
`glyphicon`	Glyphicon Halflings	`glyphicon`	`dxpr_builder/elements.glyphicons_halflings`
`pe`	Pixeden Line Icons	`pe`	`dxpr_builder/elements.pe_icon_7_stroke`
`ph`	Phosphor Icons Regular	`ph`	`dxpr_builder/elements.phosphor_icons`
`ph_bold`	Phosphor Icons Bold	`ph-bold`	`dxpr_builder/elements.phosphor_icons_bold`
`ph_duotone`	Phosphor Icons Duotone	`ph-duotone`	`dxpr_builder/elements.phosphor_icons_duotone`
`ph_fill`	Phosphor Icons Fill	`ph-fill`	`dxpr_builder/elements.phosphor_icons_fill`
`ph_light`	Phosphor Icons Light	`ph-light`	`dxpr_builder/elements.phosphor_icons_light`
`ph_thin`	Phosphor Icons Thin	`ph-thin`	`dxpr_builder/elements.phosphor_icons_thin`
`fa`	Font Awesome (v4 compatibility)	`fa`	`dxpr_builder/elements.font_awesome_6_free`

لا يعرض المنتقي المجموعة fa، لأنها لا تحمل قائمة أيقونات. فهي تجعل الأيقونات المحفوظة بالفئة fa القديمة تحمّل مكتبة Font Awesome. وتحصل الصفحات المحفوظة بأسماء مكتبة Font Awesome القديمة أيضًا على ورقة الأنماط dxpr_builder/elements.font_awesome_v4_shims، فتبقى أيقوناتها ظاهرة.

تحمّل كل مجموعات Font Awesome الإصدار Font Awesome Free 7. وتحتفظ المكتبة بالاسم الآلي للإصدار 6، لأن الصفحات المحفوظة والشيفرة المخصصة تشير إليه. يسرد Font Awesome 7 في DXPR Builder ما تغيّر.

كيف يحمّل المنتقي والصفحات الأيقونات

تبدأ قائمة المجموعات المنسدلة بـ كل مجموعات الأيقونات، ثم تسرد كل مجموعة مسجلة ذات قائمة أيقونات. وتحمل المجموعات المشحونة الـ 13 غير fa قوائم مدمجة، فيعرض الموقع الذي يحمل DXPR Builder وحده 14 مدخلًا. وتحتاج المجموعة من وحدة أو قالب آخر إلى قائمة icons في YAML الخاص بها لتظهر.

عندما يختار محرّر أيقونة، يخزّن العنصر فئات الأيقونة، مثل bi bi-star، واسم مكتبتها. فينزّل الزوار عندها فقط خطوط الأيقونات التي تستخدمها صفحتهم. وفي المحرّر، تُحمَّل ET Line وPixeden وGlyphicon مع المحرّر نفسه؛ ويحمّل المنتقي أوراق أنماط المجموعات الأخرى عندما يُفتَح.

كيف يختار المحرّرون أيقونة وينسّقونها في إضافة أيقونة.

تقييد مجموعات الأيقونات لكل دور

يحمل كل ملف منشئ مجموعة مجموعات الأيقونات مع مربع لكل مجموعة ومربع تحديد/إلغاء تحديد كل مجموعات الأيقونات. اضبطوها في DXPR Studio > DXPR Builder > ملفات تعريف المستخدم؛ وتحمل ملفات تعريف المستخدم الخطوات. وكيف تتصرف المجموعة:

مع تحديد تحديد/إلغاء تحديد كل مجموعات الأيقونات، يرى الدور كل مجموعة، بما فيها المجموعات المضافة لاحقًا.
دونه، يرى الدور المجموعات المحددة فقط. ويبدأ ملف جديد بهذه الطريقة، مع تحديد كل مجموعة، فتبقى المجموعة المضافة لاحقًا مخفية حتى تحدّدوها.
دونه ولا مجموعة محددة، يكون المنتقي فارغًا.
تبقى الأيقونات الموجودة على صفحة ظاهرة. فالملف لا يغيّر إلا ما يعرضه المنتقي.

إضافة مجموعة أيقونات

مجموعة الأيقونات مدخل YAML إضافة إلى مكتبة Drupal. يقرأ DXPR Builder الملفات *.dxpr_icon_sets.yml من كل وحدة وقالب مثبّت. ومرجع الخصائص وخطاف التعديل في مجموعات الأيقونات المخصصة.

أنشئوا mymodule/mymodule.dxpr_icon_sets.yml:
```
brand:
  label: 'Brand icons'
  prefix: brand
  css: css/brand-icons.css
  library: mymodule/brand_icons
  icons:
    - 'brand brand-logo'
    - 'brand brand-arrow'
```
css نسبي إلى مجلد الوحدة ويُحمَّل في المحرّر. وكل أيقونة هي البادئة إضافة إلى فئة تبدأ بالبادئة وشرطة.
أعلنوا المكتبة في mymodule.libraries.yml. فتحمّلها صفحات الزوار:
```
brand_icons:
  css:
    theme:
      css/brand-icons.css: {}
```
امسحوا ذاكرات التخزين المؤقت باستخدام drush cr.
حدّدوا المجموعة الجديدة في كل ملف منشئ لا يحمل تحديد/إلغاء تحديد كل مجموعات الأيقونات محددًا.
افتحوا إعدادات عنصر أيقونة واختاروا Brand icons في القائمة المنسدلة للمجموعات.

تستطيع الوحدة المخصصة أيضًا إزالة مجموعة من المنتقي بخطاف تعديل؛ والشيفرة في مرجع واجهة الخطافات. وتبقى أيقونات مجموعة مشحونة تُحمَّل على الصفحات المحفوظة على أي حال. وتتوقف أيقونات مجموعة مخصصة مزالة عن تحميل CSS الخاص بها، لأن DXPR Builder لا يرفق إلا مكتبة تُسمّيها مجموعة مسجلة.

إذا غابت مجموعة أيقونات

مجموعة جديدة ليست في القائمة المنسدلة. لا يحمل YAML الخاص بها قائمة icons، أو ما زالت ذاكرة التخزين المؤقت تحمل السجل القديم. أضيفوا القائمة وشغّلوا drush cr.
تغيب مجموعة لدى بعض المحرّرين فقط. لا يحدّدها ملف المنشئ الخاص بهم. حدّدوها ضمن مجموعات الأيقونات في /admin/dxpr_studio/dxpr_builder/profile.
تظهر الأيقونات في المحرّر لكن ليس للزوار. يحمّل المحرّر ملف css الخاص بالمجموعة، لكن صفحات الزوار تحمّل library الخاصة بها. تأكدوا من أن library تُسمّي مكتبة في mymodule.libraries.yml تحتوي ملف CSS.

ما الخطوة التالية؟

مجموعات الأيقونات المخصصة: مرجع خصائص YAML وخطاف التعديل.
إضافة أيقونة: إعدادات عنصر الأيقونة.