إلغاء صفحات Chrome

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

مدير الإشارات
الصفحة التي تظهر عندما يختار المستخدم عنصر قائمة "مدير الإشارات" من قائمة Chrome أو من عنصر "مدير الإشارات" على جهاز Mac من قائمة "الإشارات المرجعية" يمكنك أيضًا الانتقال إلى هذه الصفحة من خلال إدخال عنوان URL chrome://bookmarks.
السجلّ
الصفحة التي تظهر عندما يختار المستخدم عنصر قائمة "السجلّ" من قائمة Chrome أو "عرض السجلّ الكامل" من قائمة "السجلّ" على جهاز Mac. يمكنك أيضًا الوصول إلى هذه الصفحة من خلال إدخال عنوان URL chrome://history.
علامة تبويب جديدة
الصفحة التي تظهر عندما ينشئ المستخدم علامة تبويب أو نافذة جديدة كما يمكنك أيضًا الانتقال إلى هذه الصفحة من خلال إدخال عنوان URL chrome://newtab.

تعرض لقطات الشاشة التالية صفحة "علامة تبويب جديدة" التلقائية ثم صفحة "علامة تبويب جديدة" مخصَّصة.

صفحة علامة التبويب الجديدة التلقائية
صفحة علامة التبويب الجديدة التلقائية
صفحة علامة تبويب جديدة مخصصة
صفحة علامة تبويب جديدة مخصَّصة
.

لتجربة ذلك، يمكنك الاطّلاع على نماذج الإلغاء.

سلوك نافذة التصفُّح المتخفي

في نوافذ التصفح المتخفي، لا يمكن للإضافات إلغاء صفحات "علامة تبويب جديدة". ستظل الصفحات الأخرى تعمل في حال ضبط سمة البيان التصفّح المتخفّي على "span" (القيمة التلقائية). للحصول على تفاصيل حول كيفية التعامل مع نوافذ التصفُّح المتخفي، يُرجى الاطّلاع على حفظ البيانات ووضع التصفُّح المتخفي.

البيان

استخدم الرمز التالي لتسجيل صفحة إلغاء في بيان الإضافة:

{
  "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.

أمثلة

اطّلِع على نماذج الإلغاء.