---
url: 'https://dxpr.com/ar/hc/documentation/learn-dxpr-builder/customization/icon-libraries'
title: 'مكتبات الأيقونات | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T01:25:10+00:00'
updated: '2026-10-24T09:09:48+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  يعرض منتقي الأيقونات في عنصري الأيقونة وعداد الدائرة كل مجموعة
  أيقونات مسجلة على موقعكم. يشحن DXPR Builder مع 14 مجموعة؛ ويمكن للوحدات
  والقوالب إضافة المزيد بملف YAML. تسرد هذه الصفحة المجموعات المشحونة وتشرح
  كيفية تحميلها وتعرض كيفية إضافة واحدة. ولتقييد المجموعات التي يراها دور،
  استخدموا ملف منشئ؛ انظر ملفات تعريف المستخدم.
  مجموعات الأيقونات المشحونة
  المجموعات مسجلة في dxpr_builder.dxpr_icon_sets.yml:
tags:
  - 'Je huisstijl toepassen'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T09:09:48+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'مكتبات الأيقونات'
      description: |-
        يعرض منتقي الأيقونات في عنصري الأيقونة وعداد الدائرة كل مجموعة
        أيقونات مسجلة على موقعكم. يشحن DXPR Builder مع 14 مجموعة؛ ويمكن للوحدات
        والقوالب إضافة المزيد بملف YAML. تسرد هذه الصفحة المجموعات المشحونة وتشرح
        كيفية تحميلها وتعرض كيفية إضافة واحدة. ولتقييد المجموعات التي يراها دور،
        استخدموا ملف منشئ؛ انظر ملفات تعريف المستخدم.
        مجموعات الأيقونات المشحونة
        المجموعات مسجلة في dxpr_builder.dxpr_icon_sets.yml:
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T01:25:10+0000'
      dateModified: '2026-10-24T09:09:48+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/ar/hc/documentation/learn-dxpr-builder/customization/icon-libraries'
      articleSection: 'Je huisstijl toepassen'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/ar/hc/documentation/learn-dxpr-builder/customization/icon-libraries'
      description: |-
        يعرض منتقي الأيقونات في عنصري الأيقونة وعداد الدائرة كل مجموعة
        أيقونات مسجلة على موقعكم. يشحن DXPR Builder مع 14 مجموعة؛ ويمكن للوحدات
        والقوالب إضافة المزيد بملف YAML. تسرد هذه الصفحة المجموعات المشحونة وتشرح
        كيفية تحميلها وتعرض كيفية إضافة واحدة. ولتقييد المجموعات التي يراها دور،
        استخدموا ملف منشئ؛ انظر ملفات تعريف المستخدم.
        مجموعات الأيقونات المشحونة
        المجموعات مسجلة في dxpr_builder.dxpr_icon_sets.yml:
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: الرئيسية
            item: 'https://dxpr.com/ar'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: ar
---
[Help Center](/ar/hc)/[Documentation](/ar/hc/documentation) /[Learn DXPR Builder](/hc/documentation/learn-dxpr-builder) /[Manage the site](/hc/documentation/learn-dxpr-builder/manage) /[Je huisstijl toepassen](/hc/documentation/learn-dxpr-builder/customization) # مكتبات الأيقونات.

 Learn DXPR BuilderManage the siteJe huisstijl toepassen

   ## In this guide

 Related guides

- [مجموعات الأيقونات المخصصة](/ar/hc/documentation/learn-dxpr-builder/development/icon-sets)
- [أيقونات ](/ar/hc/documentation/learn-dxpr-builder/elements/icon)

يعرض منتقي الأيقونات في عنصري **الأيقونة** و**عداد الدائرة** كل مجموعة أيقونات مسجلة على موقعكم. يشحن DXPR Builder مع 14 مجموعة؛ ويمكن للوحدات والقوالب إضافة المزيد بملف YAML. تسرد هذه الصفحة المجموعات المشحونة وتشرح كيفية تحميلها وتعرض كيفية إضافة واحدة. ولتقييد المجموعات التي يراها دور، استخدموا ملف منشئ؛ انظر [ملفات تعريف المستخدم](/ar/hc/documentation/learn-dxpr-builder/admin/user-profiles-admin).

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

المجموعات مسجلة في `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](/hc/documentation/learn-dxpr-builder/getting-started/font-awesome-7) ما تغيّر.

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

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

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

كيف يختار المحرّرون أيقونة وينسّقونها في [إضافة أيقونة](/ar/hc/documentation/learn-dxpr-builder/elements/icon).

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

يحمل كل ملف منشئ مجموعة **مجموعات الأيقونات** مع مربع لكل مجموعة ومربع **تحديد/إلغاء تحديد كل مجموعات الأيقونات**. اضبطوها في **DXPR Studio** > **DXPR Builder** > **ملفات تعريف المستخدم**؛ وتحمل [ملفات تعريف المستخدم](/ar/hc/documentation/learn-dxpr-builder/admin/user-profiles-admin) الخطوات. وكيف تتصرف المجموعة:

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

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

مجموعة الأيقونات مدخل YAML إضافة إلى مكتبة Drupal. يقرأ DXPR Builder الملفات `*.dxpr_icon_sets.yml` من كل وحدة وقالب مثبّت. ومرجع الخصائص وخطاف التعديل في [مجموعات الأيقونات المخصصة](/ar/hc/documentation/learn-dxpr-builder/development/icon-sets).

1. أنشئوا `mymodule/mymodule.dxpr_icon_sets.yml`:

    ```yaml
    brand:
      label: 'Brand icons'
      prefix: brand
      css: css/brand-icons.css
      library: mymodule/brand_icons
      icons:
        - 'brand brand-logo'
        - 'brand brand-arrow'

    ```

    `css` نسبي إلى مجلد الوحدة ويُحمَّل في المحرّر. وكل أيقونة هي البادئة إضافة إلى فئة تبدأ بالبادئة وشرطة.
2. أعلنوا المكتبة في `mymodule.libraries.yml`. فتحمّلها صفحات الزوار:

    ```yaml
    brand_icons:
      css:
        theme:
          css/brand-icons.css: {}

    ```
3. امسحوا ذاكرات التخزين المؤقت باستخدام `drush cr`.
4. حدّدوا المجموعة الجديدة في كل ملف منشئ لا يحمل **تحديد/إلغاء تحديد كل مجموعات الأيقونات** محددًا.
5. افتحوا إعدادات عنصر **أيقونة** واختاروا **Brand icons** في القائمة المنسدلة للمجموعات.

تستطيع الوحدة المخصصة أيضًا إزالة مجموعة من المنتقي بخطاف تعديل؛ والشيفرة في [مرجع واجهة الخطافات](/ar/hc/documentation/learn-dxpr-builder/development/hooks-api#hook_dxpr_builder_icon_sets_alter). وتبقى أيقونات مجموعة مشحونة تُحمَّل على الصفحات المحفوظة على أي حال. وتتوقف أيقونات مجموعة مخصصة مزالة عن تحميل CSS الخاص بها، لأن DXPR Builder لا يرفق إلا مكتبة تُسمّيها مجموعة مسجلة.

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

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

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

- [مجموعات الأيقونات المخصصة](/ar/hc/documentation/learn-dxpr-builder/development/icon-sets): مرجع خصائص YAML وخطاف التعديل.
- [إضافة أيقونة](/ar/hc/documentation/learn-dxpr-builder/elements/icon): إعدادات عنصر الأيقونة.