---
url: 'https://dxpr.com/ar/hc/documentation/learn-dxpr-builder/development/icon-sets'
title: 'مجموعات الأيقونات المخصصة | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T01:25:34+00:00'
updated: '2026-10-24T09:09:48+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  يعرض منتقي الأيقونات 14 مجموعة أيقونات مدمجة. وتضيفون مجموعتكم بملف
  YAML في وحدتكم أو قالبكم، أو تغيّرون القائمة بخطاف تعديل. فيدمج DXPR Builder
  كل ملف *.dxpr_icon_sets.yml يجده في الوحدات والقوالب المفعّلة، ثم يشغّل
  الخطاف.
  المجموعات المدمجة
  من dxpr_builder.dxpr_icon_sets.yml:
tags:
  - 'Bouw erop voort'
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: |-
        يعرض منتقي الأيقونات 14 مجموعة أيقونات مدمجة. وتضيفون مجموعتكم بملف
        YAML في وحدتكم أو قالبكم، أو تغيّرون القائمة بخطاف تعديل. فيدمج DXPR Builder
        كل ملف *.dxpr_icon_sets.yml يجده في الوحدات والقوالب المفعّلة، ثم يشغّل
        الخطاف.
        المجموعات المدمجة
        من 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:34+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/development/icon-sets'
      articleSection: 'Bouw erop voort'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/ar/hc/documentation/learn-dxpr-builder/development/icon-sets'
      description: |-
        يعرض منتقي الأيقونات 14 مجموعة أيقونات مدمجة. وتضيفون مجموعتكم بملف
        YAML في وحدتكم أو قالبكم، أو تغيّرون القائمة بخطاف تعديل. فيدمج DXPR Builder
        كل ملف *.dxpr_icon_sets.yml يجده في الوحدات والقوالب المفعّلة، ثم يشغّل
        الخطاف.
        المجموعات المدمجة
        من 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) /[Extend](/hc/documentation/learn-dxpr-builder/extend) /[Bouw erop voort](/hc/documentation/learn-dxpr-builder/extend/build-on-it) # مجموعات الأيقونات المخصصة.

 Learn DXPR BuilderExtendBouw erop voort

   ## In this guide

يعرض منتقي الأيقونات 14 مجموعة أيقونات مدمجة. وتضيفون مجموعتكم بملف YAML في وحدتكم أو قالبكم، أو تغيّرون القائمة بخطاف تعديل. فيدمج DXPR Builder كل ملف `*.dxpr_icon_sets.yml` يجده في الوحدات والقوالب المفعّلة، ثم يشغّل الخطاف.

## المجموعات المدمجة

من `dxpr_builder.dxpr_icon_sets.yml`:

| المفتاح | التسمية | البادئة |
|---|---|---|
| `bi` | Bootstrap Icons | `bi` |
| `et` | ET Line Icons | `et` |
| `fa` | Font Awesome (v4 compatibility) | `fa` |
| `fab` | Font Awesome Free Brands | `fab` |
| `far` | Font Awesome Free Regular | `far` |
| `fas` | Font Awesome Free Solid | `fas` |
| `glyphicon` | Glyphicon Halflings | `glyphicon` |
| `pe` | Pixeden Line Icons | `pe` |
| `ph` | Phosphor Icons Regular | `ph` |
| `ph_bold` | Phosphor Icons Bold | `ph-bold` |
| `ph_duotone` | Phosphor Icons Duotone | `ph-duotone` |
| `ph_fill` | Phosphor Icons Fill | `ph-fill` |
| `ph_light` | Phosphor Icons Light | `ph-light` |
| `ph_thin` | Phosphor Icons Thin | `ph-thin` |

يستطيع ملف المنشئ تقييد المجموعات التي يراها محرّروه (**مجموعات الأيقونات** في نموذج الملف).

## اكتشاف YAML (موصى به)

أنشئوا `mymodule.dxpr_icon_sets.yml` في جذر وحدتكم أو قالبكم:

```yaml
material:
  label: 'Material Symbols'
  prefix: material-symbols
  css: vendor/material-symbols/material-symbols.css
  library: mymodule/material_symbols
  icons:
    - 'material-symbols material-symbols-star'
    - 'material-symbols material-symbols-home'
    - 'material-symbols material-symbols-search'

```

المجموعة ذات المفتاح نفسه كمجموعة سابقة تحل محلها.

### الخصائص

| الخاصية | مطلوبة | الوصف |
|---|---|---|
| `label` | نعم | الاسم في قائمة مجموعات الأيقونات المنسدلة؛ ويُستخدم المفتاح عند غيابه |
| `prefix` | نعم | بادئة فئة CSS التي تحدّد أيقونات هذه المجموعة |
| `css` | نعم | ورقة الأنماط التي يحمّلها المحرّر؛ والمسار النسبي يُحَل من جذر وحدتكم أو قالبكم |
| `library` | نعم | مكتبة Drupal المرفقة للزوار عندما يستخدم المحتوى المحفوظ هذه المجموعة |
| `icon_prefix` | لا | بادئة اسم الأيقونة عندما تختلف عن `prefix`، كما في `fas fa-heart` |
| `icons` | نعم\* | القائمة الكاملة لفئات الأيقونات |

\*المجموعات المدمجة تحذف `icons`؛ فالمحرّر يحمل قوائمها في JavaScript. أما مجموعتكم فيجب أن تسرد كل أيقونة.

## تعريف مكتبة Drupal

سجّلوا ورقة الأنماط كمكتبة في `mymodule.libraries.yml`، ليحصل عليها الزوار على الصفحات التي تستخدم أيقوناتكم:

```yaml
material_symbols:
  css:
    theme:
      vendor/material-symbols/material-symbols.css: {}

```

لا ترفق الوحدة مكتبة يحمل اسمها `/` إلا عندما تكون `library` الخاصة بمجموعة أيقونات مسجلة.

## خطاف التعديل

لمنطق زمن التشغيل، مثل إضافة مجموعة فقط تحت شرط ما، نفّذوا `hook_dxpr_builder_icon_sets_alter()`. يعمل الخطاف بعد حل مسارات YAML، فامنحوا `css` مسارًا من جذر Drupal:

```php
/**
 * Implements hook_dxpr_builder_icon_sets_alter().
 */
function mymodule_dxpr_builder_icon_sets_alter(array &$icon_sets) {
  if (some_condition()) {
    $module_path = \Drupal::service('extension.list.module')
      ->getPath('mymodule');
    $icon_sets['custom'] = [
      'label' => t('Custom Icons'),
      'prefix' => 'ci',
      'css' => $module_path . '/css/custom-icons.css',
      'library' => 'mymodule/custom_icons',
      'icons' => ['ci ci-logo', 'ci ci-arrow'],
    ];
  }
}

```

انظر [مرجع واجهة الخطافات](/ar/hc/documentation/learn-dxpr-builder/development/hooks-api) للخطافات الأخرى.

## إزالة المجموعات المدمجة

```php
/**
 * Implements hook_dxpr_builder_icon_sets_alter().
 */
function mymodule_dxpr_builder_icon_sets_alter(array &$icon_sets) {
  // Remove ET Line Icons from the picker.
  unset($icon_sets['et']);
}

```

## التحقق من مجموعتكم

1. امسحوا ذاكرة التخزين المؤقت: `drush cr`.
2. افتحوا صفحة في المنشئ وأضيفوا عنصر أيقونة.
3. افتحوا منتقي الأيقونات واختاروا مجموعتكم في القائمة المنسدلة.
4. اختاروا أيقونة واحفظوا وشاهدوا الصفحة كزائر للتأكد من عرض الأيقونة.