chrome.pageAction

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.pageAction لوضع الرموز في شريط أدوات Google Chrome الرئيسي، على يسار شريط العناوين. تمثّل إجراءات الصفحة الإجراءات التي يمكن اتّخاذها على الصفحة الحالية، ولكنّها لا تنطبق على جميع الصفحات. تظهر إجراءات الصفحة باللون الرمادي عندما تكون غير نشطة.

مدى التوفّر

≤ MV2

إليك بعض الأمثلة:

  • الاشتراك في خلاصة RSS لهذه الصفحة
  • إنشاء عرض شرائح من صور هذه الصفحة

يمثّل رمز RSS في لقطة الشاشة التالية إجراءً في الصفحة يتيح لك الاشتراك في خلاصة RSS للصفحة الحالية.

تظهر الإجراءات المخفية على الصفحة باللون الرمادي. على سبيل المثال، تظهر خلاصة RSS أدناه باللون الرمادي، لأنّه لا يمكنك الاشتراك في الخلاصة للصفحة الحالية:

يُرجى استخدام إجراء المتصفّح بدلاً من ذلك، ليتمكّن المستخدمون من التفاعل دائمًا مع الإضافة.

البيان

سجِّل إجراء الصفحة في ملف بيان الإضافة على النحو التالي:

{
  "name": "My extension",
  ...
  "page_action": {
    "default_icon": {                    // optional
      "16": "images/icon16.png",           // optional
      "24": "images/icon24.png",           // optional
      "32": "images/icon32.png"            // optional
    },
    "default_title": "Google Mail",      // optional; shown in tooltip
    "default_popup": "popup.html"        // optional
  },
  ...
}

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

لا تزال البنية القديمة لتسجيل الرمز التلقائي متاحة:

{
  "name": "My extension",
  ...
  "page_action": {
    ...
    "default_icon": "images/icon32.png"  // optional
    // equivalent to "default_icon": { "32": "images/icon32.png" }
  },
  ...
}

أجزاء من واجهة المستخدم

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

يمكنك إظهار إجراء الصفحة وجعله يظهر باللون الرمادي باستخدام الطريقتَين pageAction.show وpageAction.hide على التوالي. يظهر إجراء الصفحة باللون الرمادي تلقائيًا. عند عرضه، يمكنك تحديد علامة التبويب التي يجب أن يظهر فيها الرمز. يظل الرمز مرئيًا إلى أن يتم إغلاق علامة التبويب أو يبدأ عرض عنوان URL مختلف (لأنّ المستخدم ينقر على رابط، على سبيل المثال).

نصائح

للحصول على أفضل تأثير مرئي، اتّبِع الإرشادات التالية:

  • يُفضَّل استخدام إجراءات الصفحة للميزات التي تكون منطقية لبضع صفحات فقط.
  • لا تستخدِم إجراءات الصفحة للميزات التي تناسب معظم الصفحات. استخدِم إجراءات المتصفّح بدلاً من ذلك.
  • لا تحرّك الرمز باستمرار. هذا مزعج فقط.

الأنواع

ImageDataType

بيانات البكسل للصورة يجب أن يكون عنصر ImageData (على سبيل المثال، من عنصر canvas).

النوع

ImageData

TabDetails

الإصدار 88 من Chrome أو الإصدارات الأحدث

الخصائص

  • tabId

    number اختيارية

    رقم تعريف علامة التبويب المطلوب الاستعلام عن حالتها إذا لم يتم تحديد علامة تبويب، يتم عرض الحالة غير المحدّدة لعلامة التبويب.

الطُرق

getPopup()

Promise 
chrome.pageAction.getPopup(
  details: TabDetails,
  callback?: function,
): Promise<string>

تحصل على مستند HTML الذي تم ضبطه كنافذة منبثقة لإجراء الصفحة هذا.

المعلمات

  • التفاصيل

    TabDetails

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (result: string) => void

    • نتيجة

      سلسلة

المرتجعات

  • وعد<سلسلة>

    الإصدار 101 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

getTitle()

Promise 
chrome.pageAction.getTitle(
  details: TabDetails,
  callback?: function,
): Promise<string>

تحصل على عنوان إجراء الصفحة.

المعلمات

  • التفاصيل

    TabDetails

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    (result: string) => void

    • نتيجة

      سلسلة

المرتجعات

  • وعد<سلسلة>

    الإصدار 101 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

hide()

Promise 
chrome.pageAction.hide(
  tabId: number,
  callback?: function,
): Promise<void>

يخفي إجراء الصفحة. تظل إجراءات الصفحة المخفية تظهر في شريط أدوات Chrome، ولكنها تظهر باللون الرمادي.

المعلمات

  • tabId

    الرقم

    رقم تعريف علامة التبويب التي تريد تعديل إجراء الصفحة لها.

  • callback

    function اختياري

    الإصدار 67 من Chrome والإصدارات الأحدث

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 101 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

setIcon()

Promise 
chrome.pageAction.setIcon(
  details: object,
  callback?: function,
): Promise<void>

يضبط هذا الإجراء رمز إجراء الصفحة. يمكن تحديد الرمز إما كمسار لملف صورة أو كبيانات بكسل من عنصر لوحة رسم، أو كقاموس لأي منهما. يجب تحديد السمة path أو imageData.

المعلمات

  • التفاصيل

    عنصر

    • iconIndex

      number اختيارية

      تمّت إزالة هذا العمود. يتم تجاهل هذه الوسيطة.

    • imageData

      ‫ImageData | عنصر اختياري

      إمّا عنصر ImageData أو قاموس {size -> ImageData} يمثّل الرمز المطلوب ضبطه. إذا تم تحديد الرمز كقاموس، يتم اختيار الصورة الفعلية التي سيتم استخدامها بناءً على كثافة وحدات بكسل الشاشة. إذا كان عدد بكسلات الصورة التي تتناسب مع وحدة مساحة شاشة واحدة يساوي scale، سيتم اختيار الصورة ذات الحجم scale * n، حيث n هو حجم الرمز في واجهة المستخدم. يجب تحديد صورة واحدة على الأقل. يُرجى ملاحظة أنّ "details.imageData = foo" يعادل "details.imageData = {'16': foo}".

    • المسار

      string | object اختيارية

      إما مسار صورة نسبي أو قاموس {size -> relative image path} يشير إلى الرمز المطلوب ضبطه. إذا تم تحديد الرمز كقاموس، يتم اختيار الصورة الفعلية التي سيتم استخدامها بناءً على كثافة وحدات بكسل الشاشة. إذا كان عدد بكسلات الصورة التي تتناسب مع وحدة مساحة شاشة واحدة يساوي scale، سيتم اختيار الصورة ذات الحجم scale * n، حيث n هو حجم الرمز في واجهة المستخدم. يجب تحديد صورة واحدة على الأقل. يُرجى العِلم أنّ "details.path = foo" يعادل "details.path = {'16': foo}"

    • tabId

      الرقم

      رقم تعريف علامة التبويب التي تريد تعديل إجراء الصفحة لها.

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 101 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

setPopup()

Promise 
chrome.pageAction.setPopup(
  details: object,
  callback?: function,
): Promise<void>

يضبط مستند HTML ليتم فتحه كنافذة منبثقة عندما ينقر المستخدم على رمز إجراء الصفحة.

المعلمات

  • التفاصيل

    عنصر

    • نافذة منبثقة

      سلسلة

      المسار النسبي لملف HTML الذي سيتم عرضه في نافذة منبثقة. في حال ضبط السياسة على سلسلة فارغة ('')، لن تظهر أي نافذة منبثقة.

    • tabId

      الرقم

      رقم تعريف علامة التبويب التي تريد تعديل إجراء الصفحة لها.

  • callback

    function اختياري

    الإصدار 67 من Chrome والإصدارات الأحدث

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 101 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

setTitle()

Promise 
chrome.pageAction.setTitle(
  details: object,
  callback?: function,
): Promise<void>

يتم ضبط عنوان إجراء الصفحة. يتم عرض هذا في تلميح فوق إجراء الصفحة.

المعلمات

  • التفاصيل

    عنصر

    • tabId

      الرقم

      رقم تعريف علامة التبويب التي تريد تعديل إجراء الصفحة لها.

    • title

      سلسلة

      سلسلة التلميح

  • callback

    function اختياري

    الإصدار 67 من Chrome والإصدارات الأحدث

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 101 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

show()

Promise 
chrome.pageAction.show(
  tabId: number,
  callback?: function,
): Promise<void>

تعرض هذه السمة الإجراء على الصفحة. يظهر إجراء الصفحة كلما تم اختيار علامة التبويب.

المعلمات

  • tabId

    الرقم

    رقم تعريف علامة التبويب التي تريد تعديل إجراء الصفحة لها.

  • callback

    function اختياري

    الإصدار 67 من Chrome والإصدارات الأحدث

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 101 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

الفعاليات

onClicked

chrome.pageAction.onClicked.addListener(
  callback: function,
)

يتم تشغيل هذا الحدث عند النقر على رمز إجراء الصفحة. لن يتم تنشيط هذا الحدث إذا كان إجراء الصفحة يحتوي على نافذة منبثقة.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (tab: tabs.Tab) => void