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

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

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

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

المهام

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

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

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

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

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

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

الشارات

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

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

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

الأوامر هي مجموعات مفاتيح تُستخدَم لتشغيل ميزة في الإضافة. يمكنك تحديد مجموعات المفاتيح في ملفian.json والاستجابة لها باستخدام Commands API. للتعرّف على كيفية تنفيذ أحد الأوامر، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات أو نموذج chrome.commands.

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

تظهر قائمة سياق للنقر البديل (الذي يُعرف غالبًا باسم النقر بزر الماوس الأيمن) باستخدام الماوس. حدد قوائم السياقات باستخدام واجهة برمجة تطبيقات قوائم السياق.

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

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

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

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

تجاهل الصفحات

يمكن لإحدى الإضافات أن تلغي إحدى صفحات Chrome المضمَّنة التالية:

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

للتعرّف على كيفية تجاوز صفحات Chrome، يمكنك الاطّلاع على مقالة تجاوز صفحات Chrome أو نموذج الإلغاء.

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

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

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

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

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

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

تلميحات

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

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

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

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

الإشعارات

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

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

المظاهر

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

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

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

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

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

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

التدويل

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