يمكن للإضافات استخدام صفحات تجاوز HTML لاستبدال صفحة يوفّرها Google Chrome عادةً. يمكن أن تحتوي إضافة على تجاوز لأي من الصفحات التالية، ولكن يمكن لكل إضافة أن تتجاوز صفحة واحدة فقط:
- مدير الإشارات
- الصفحة التي تظهر عندما يختار المستخدم عنصر قائمة "مدير الإشارات" من قائمة Chrome أو عنصر "مدير الإشارات" على نظام التشغيل Mac من قائمة الإشارات المرجعية. يمكنك أيضًا للوصول إلى هذه الصفحة من خلال إدخال عنوان URL chrome://bookmarks.
- السجلّ
- الصفحة التي تظهر عندما يختار المستخدم عنصر قائمة "السجلّ" من متصفّح Chrome أو في نظام التشغيل Mac، عنصر إظهار السجل بالكامل من قائمة السجل. يمكنك أيضًا الوصول إلى هذه الصفحة من خلال إدخال عنوان URL chrome://history.
- علامة تبويب جديدة
- الصفحة التي تظهر عندما ينشئ المستخدم علامة تبويب أو نافذة جديدة. يمكنك أيضًا الاطّلاع على هذه الصفحة عن طريق إدخال عنوان URL chrome://newtab.
تعرض لقطات الشاشة التالية صفحة "علامة تبويب جديدة" التلقائية، ثم صفحة "علامة تبويب جديدة" مخصَّصة.
لتجربة ذلك، يمكنك الاطّلاع على إلغاء النماذج.
سلوك نافذة التصفّح المتخفي
في نوافذ التصفّح المتخفي، لا يمكن للإضافات إلغاء صفحات "علامة تبويب جديدة". وستظل الصفحات الأخرى تعمل إذا كانت خاصية وضع التصفّح المتخفي في ملف البيان. تم الضبط على "التمديد" (القيمة الافتراضية). للحصول على تفاصيل حول كيفية التعامل مع نوافذ التصفح المتخفي، راجع حفظ البيانات ووضع التصفح المتخفي.
البيان
استخدِم الرمز التالي لتسجيل صفحة إلغاء في بيان الإضافة:
{
"manifest_version": 3,
"name": "My extension",
...
"chrome_url_overrides" : {
"PAGE_TO_OVERRIDE": "myPage.html"
},
...
}
بالنسبة إلى PAGE_TO_OVERRIDE، استبدِل واحدًا مما يلي:
"bookmarks""history""newtab"
أفضل الممارسات
صمِّم صفحة سريعة وصغيرة الحجم.
يتوقع المستخدمون أن يتم فتح صفحات المتصفّح المضمَّنة على الفور. تجنب القيام بالأشياء التي قد تستغرق وقتًا طويلاً الوقت. وعلى وجه التحديد، تجنب الوصول إلى موارد قاعدة البيانات بشكل متزامن. عند إرسال طلبات عبر الشبكة، من المفضّل استخدامfetch()علىXMLHttpRequest().لتجنُّب التباس الأمور على المستخدمين، أضِف عنوانًا لصفحتك.
بدون عنوان، يتم ضبط عنوان الصفحة تلقائيًا على عنوان URL. حدِّد العنوان باستخدام العلامة<title>في ملف HTML.تذكّر أنّ علامات التبويب الجديدة تركّز على شريط العناوين أولاً.
لا تعتمد على الإعداد التلقائي لتركيز لوحة المفاتيح على أجزاء أخرى من الصفحة.تخصيص صفحة علامة التبويب الجديدة:
تجنَّب إنشاء صفحة علامة تبويب جديدة قد يخلط المستخدمون بينها وبين صفحة علامة التبويب الجديدة التلقائية في Chrome.
أمثلة
يمكنك الاطّلاع على تجاوز العيّنات.