مكونات واجهة المستخدم

هذه قائمة بعناصر واجهة المستخدم المتاحة في الإضافات. يحتوي كل إدخال على ما يلي:

• تمثّل هذه السمة صورة العنصر (إذا كان ذلك منطبقًا).
• تمثّل هذه السمة وصفًا للغرض من استخدامها.
• عناصر الواجهة ذات الصلة (إذا كان ذلك منطبقًا)
• روابط إلى تعليمات التنفيذ وعيّنات الرموز البرمجية

هذه العناصر هي طرق مختلفة لاستدعاء ميزات الإضافة. ليس عليك تنفيذها كلها. في الواقع، قد لا تستخدم بعض حالات الاستخدام أيًا منها. على سبيل المثال، يمكن لأداة تقصير الروابط أن تعمل على عنوان URL المعروض باستخدام اختصار لوحة المفاتيح وأن تضع الرابط المختصَر في الحافظة آليًا.

الإجراءات

الإجراء هو ما يحدث عندما ينقر المستخدم على رمز الإجراء الخاص بالإضافة. يمكن أن يؤدي الإجراء إما إلى استدعاء ميزة إضافية باستخدام Action API أو فتح نافذة منبثقة تتيح للمستخدمين استدعاء ميزات إضافية متعددة. أخبِر المستخدمين بما يفعله الإجراء باستخدام تلميح أداة.

لمعرفة كيفية إنشاء إجراء، اطّلِع على تنفيذ إجراء أو راجِع نماذج الإجراءات.

رموز الإجراءات

تتطلّب الإضافة أيقونة واحدة على الأقل لتمثيلها. ينقر المستخدمون على الرمز لتنفيذ إجراء، سواء كان هذا الإجراء يستدعي ميزة إضافة باستخدام Action API أو يفتح نافذة منبثقة.

يمكنك أيضًا إضافة تصنيف، يُطلق عليه هنا اسم "شارة"، إلى الرمز لتوضيح معلومات مثل حالة الإضافة أو الإشارة إلى أنّ المستخدم بحاجة إلى اتّخاذ إجراءات.

لمعرفة كيفية إنشاء إجراء، اطّلِع على تنفيذ إجراء أو راجِع نماذج الإجراءات.

الشارات

الشارات هي أجزاء من النص المنسَّق يتم وضعها فوق رمز الإجراء للإشارة إلى أمور مثل حالة الإضافة أو أنّ المستخدم بحاجة إلى اتّخاذ إجراءات. يمكنك ضبط نص الشارة من خلال استدعاء browser.action.setBadgeText() ولون البانر من خلال استدعاء browser.action.setBadgeBackgroundColor().

لمعرفة كيفية إنشاء إجراء، اطّلِع على تنفيذ إجراء أو على نموذج شرب الماء.

الطلبات الصوتية

الأوامر هي مجموعات مفاتيح تستدعي ميزة إحدى الإضافات. حدِّد مجموعات المفاتيح في ملف manifest.json واستجِب لها باستخدام واجهة برمجة التطبيقات Commands API. للتعرّف على كيفية تنفيذ أمر، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات أو نموذج browser.commands.

قائمة السياقات

تظهر قائمة السياق للنقرة البديلة (التي يُطلق عليها غالبًا اسم النقر بزر الماوس الأيمن). حدِّد قوائم السياق باستخدام Context Menus API.

لمعرفة كيفية تنفيذ قائمة سياق، اطّلِع على أمثلة قائمة السياق.

المربّع المتعدد الاستخدامات

يمكنك التفاعل مع المستخدمين باستخدام المربّع المتعدد الاستخدامات في Chrome. عندما يُدخل المستخدم كلمات رئيسية محدّدة في الإضافة في مربّع البحث الشامل، تتحكّم الإضافة في ما يظهر للمستخدم في مربّع البحث الشامل. حدِّد الكلمات الرئيسية في manifest.json واستجِب لها باستخدام Omnibox API.

للتعرّف على كيفية تجاهل المربّع المتعدد الاستخدامات، راجِع "تنفيذ الإجراءات من المربّع المتعدد الاستخدامات" أو نموذج مرجع واجهة برمجة التطبيقات السريع.

تجاوز الصفحات

يمكن أن تتجاوز إحدى الإضافات إحدى صفحات Chrome المضمّنة التالية:

• السجلّ
• علامة تبويب جديدة
• الإشارات المرجعية

لمعرفة كيفية تجاهل صفحات Chrome، يُرجى الاطّلاع على تجاهل صفحات Chrome أو نموذج التجاهل.

النوافذ المنبثقة

النافذة المنبثقة هي إجراء يعرض نافذة تتيح للمستخدمين استدعاء ميزات متعددة للإضافة. يمكن فتح النوافذ المنبثقة إذا نقر المستخدم على رمز الإجراء، أو من خلال اختصار لوحة المفاتيح أو عن طريق استدعاء browser.action.openPopup().

للتعرّف على كيفية إنشاء نافذة منبثقة، يمكنك الاطّلاع على مقالة إضافة نافذة منبثقة. يمكنك أيضًا تنزيل خطوة من خلال أحد نماذج الإجراءات.

اللوحات الجانبية

تتيح اللوحة الجانبية للمستخدمين الاستفادة من ميزات الإضافة إلى جانب صفحات الويب (راجِع الصورة). يمكن ربط لوحة جانبية بعلامة تبويب واحدة أو بنافذة كاملة. يتم التحكّم في اللوحة الجانبية باستخدام Side Panel API.

للتعرّف على كيفية إنشاء لوحة جانبية، اطّلِع على حالات استخدام اللوحة الجانبية أو راجِع عيّنات اللوحة الجانبية.

تلميحات

تُعدّ تلميحات الأدوات طريقة لعرض الإجراء الذي تنفّذه إضافتك عندما يمرّر المستخدم مؤشر الماوس فوق رمز الإجراء. تعرض تلميحات الأدوات اسم الإضافة تلقائيًا.

لمعرفة كيفية إضافة تلميح أداة، استخدِم العضو "default_title" في مفتاح "action" بملفات البيان.

أدوات مطوري البرامج

يمكنك إضافة لوحات مخصّصة (وهي ما يُطلق عليه اسم علامات التبويب في "أدوات مطوّري البرامج") إلى "أدوات مطوّري البرامج" باستخدام DevTools Panels API. تتيح لك واجهات برمجة التطبيقات الأخرى في "أدوات مطوّري البرامج" مراقبة النوافذ وحركة بيانات الشبكة. يمكنك أيضًا تخصيص لوحة المسجّل في "أدوات مطوّري البرامج". بدأت لوحة Lighthouse في "أدوات مطوّري البرامج في Chrome" كإضافة في "أدوات مطوّري البرامج".

الإشعارات

يمكنك نشر رسائل في لوحة نظام المستخدم باستخدام Notifications API للإضافات أو Notifications API لمنصات الويب.

للتعرّف على كيفية استخدام الإشعارات، يُرجى الاطّلاع على مقالة إرسال إشعارات إلى المستخدمين.

المظاهر

المظهر هو نوع خاص من الإضافات التي تغيّر شكل المتصفّح. يتم تجميع السمات مثل الإضافات العادية، ولكنّها لا تحتوي على رمز JavaScript أو HTML.

لمعرفة كيفية إنشاء مظهر، اطّلِع على مقالة ما هي المظاهر؟.

طرق أخرى للتفاعل مع المستخدمين

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

تسهيل الاستخدام

بالنسبة إلى العديد من المستخدمين، تمثّل إمكانية الوصول حرفيًا واجهة المستخدم، ويمكن أن تكون ميزاتها مفيدة غالبًا للمستخدمين الذين لا يحتاجون إلى إمكانية الوصول كوسيلة أساسية للتفاعل مع الإضافة. تعرَّف على أساسيات تسهيل استخدام الإضافة.

التدويل

تحدَّث مع المستخدمين بلغتهم. كيفية إتاحة الواجهة بلغات متعددة