chrome.webviewTag

ملاحظة مهمة: تعمل واجهة برمجة التطبيقات هذه على نظام التشغيل ChromeOS فقط.

الوصف

استخدِم علامة webview لتحميل المحتوى المباشر من الويب عبر الشبكة بشكل نشط وتضمينه في تطبيق Chrome. يمكن لتطبيقك التحكّم في مظهر webview والتفاعل مع المحتوى على الويب وبدء عمليات التنقّل في صفحة ويب مضمّنة والتفاعل مع أحداث الأخطاء التي تحدث داخلها والمزيد (راجِع الاستخدام).

الأذونات

webview

مدى التوفّر

نظام التشغيل ChromeOS فقط

الأنواع

ClearDataOptions

الخيارات التي تحدّد البيانات التي يجب محوها من خلال clearData

الخصائص

• منذ

  number اختيارية

  تمثّل هذه السمة تاريخًا بالملي ثانية منذ بداية العصر (يمكن الوصول إليه من خلال طريقة getTime لكائن JavaScript Date)، ويتم محو البيانات التي تم تجميعها في هذا التاريخ أو بعده. في حال عدم توفّرها، يتم ضبطها تلقائيًا على 0 (ما يؤدي إلى إزالة جميع بيانات التصفّح).

ClearDataTypeSet

مجموعة من أنواع البيانات يتم تفسير السمات غير المتوفّرة على أنّها false.

الخصائص

• appcache

  قيمة منطقية اختيارية

  ذاكرة التخزين المؤقت للتطبيقات في المواقع الإلكترونية

• ذاكرة التخزين المؤقت

  قيمة منطقية اختيارية

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

  منذ الإصدار 43 من Chrome ذاكرة التخزين المؤقت للمتصفّح ملاحظة: عند إزالة البيانات، يؤدي ذلك إلى محو ذاكرة التخزين المؤقت بالكامل، ولا يقتصر على النطاق الذي تحدّده.

• البسكويت

  قيمة منطقية اختيارية

  ملفات تعريف الارتباط الخاصة بالقسم

• fileSystems

  قيمة منطقية اختيارية

  أنظمة ملفات المواقع الإلكترونية

• indexedDB

  قيمة منطقية اختيارية

  بيانات IndexedDB للمواقع الإلكترونية

• localStorage

  قيمة منطقية اختيارية

  بيانات مساحة التخزين المحلية للمواقع الإلكترونية

• persistentCookies

  قيمة منطقية اختيارية

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

  ملفات تعريف الارتباط الثابتة للقسم

• sessionCookies

  قيمة منطقية اختيارية

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

  ملفات تعريف الارتباط للجلسة في القسم

• webSQL

  قيمة منطقية اختيارية

  بيانات WebSQL للمواقع الإلكترونية

ContentScriptDetails

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

تفاصيل النص البرمجي للمحتوى المطلوب إدخاله لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات النصوص البرمجية للمحتوى.

الخصائص

• all_frames

  قيمة منطقية اختيارية

  إذا كانت قيمة all_frames هي true، يعني ذلك أنّه يجب إدخال JavaScript أو CSS في جميع إطارات الصفحة الحالية. يكون الإعداد التلقائي لـ all_frames هو false ويتم إدخال JavaScript أو CSS في الإطار العلوي فقط.

• css

  InjectionItems اختياري

  رمز CSS أو قائمة بملفات CSS التي سيتم إدخالها في الصفحات المطابقة ويتم إدخالها بالترتيب الذي تظهر به، قبل إنشاء أي نموذج DOM أو عرضه للصفحة.

• exclude_globs

  string[] اختياري

  يتم تطبيق هذا الفلتر بعد المطابقات لاستبعاد عناوين URL التي تتطابق مع هذا النمط. تهدف إلى محاكاة الكلمة الرئيسية ‎ @exclude في Greasemonkey.

• exclude_matches

  string[] اختياري

  يستبعد الصفحات التي سيتم حقن نص المحتوى البرمجي هذا فيها.

• include_globs

  string[] اختياري

  يتم تطبيقها بعد المطابقات لتضمين عناوين URL التي تتطابق أيضًا مع هذا النمط العام فقط. تهدف إلى محاكاة الكلمة الرئيسية ‎ @include في Greasemonkey.

• js

  InjectionItems اختياري

  رمز JavaScript أو قائمة بملفات JavaScript التي سيتم إدخالها في الصفحات المطابقة ويتم إدخالها بالترتيب الذي تظهر به.

• match_about_blank

  قيمة منطقية اختيارية

  تحدّد ما إذا كان سيتم إدراج النص البرمجي للمحتوى في about:blank وabout:srcdoc. لن يتم إدخال نصوص المحتوى البرمجية في الصفحات إلا عندما يتطابق عنوان URL الموروث مع أحد الأنماط المُعلَن عنها في حقل المطابقات. عنوان URL المكتسَب هو عنوان URL للمستند الذي أنشأ الإطار أو النافذة. لا يمكن إدراج نصوص المحتوى البرمجية في إطارات وضع الحماية.

• فلتر مطابق لـ

  string[]

  يحدّد الصفحات التي سيتم إدخال نص المحتوى البرمجي هذا فيها.

• الاسم

  سلسلة

  اسم النص البرمجي للمحتوى المطلوب إدخاله

• run_at

  RunAt اختيارية

  أقرب وقت سيتم فيه إدخال JavaScript أو CSS في علامة التبويب. القيمة التلقائية هي "document_idle".

ContentWindow

معالجة المراسلة في نافذة ضيف

الخصائص

• postMessage

  void

  تنشر هذه الطريقة رسالة في المحتوى المضمَّن على الويب طالما أنّ المحتوى المضمَّن يعرض صفحة من المصدر المستهدَف. تتوفّر هذه الطريقة بعد اكتمال تحميل الصفحة. استمِع إلى الحدث contentload ثم استدعِ الطريقة.

  سيتمكّن الضيف من إرسال ردود إلى المضمِّن من خلال نشر رسالة إلى event.source في حدث الرسالة الذي يتلقّاه.

  تتطابق واجهة برمجة التطبيقات هذه مع HTML5 postMessage API للتواصل بين صفحات الويب. يمكن أن يستمع المُضمِّن إلى الردود من خلال إضافة متتبِّع أحداث message إلى إطاره الخاص.

  تبدو الدالة postMessage على النحو التالي:

  (message: any, targetOrigin: string) => {...}

  • رسالة

    أي واحد

    تمثّل هذه السمة عنصر الرسالة المطلوب إرساله إلى الضيف.

  • targetOrigin

    سلسلة

    يحدّد هذا الخيار مصدر نافذة الضيف لإرسال الحدث.

ContextMenuCreateProperties

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

الخصائص

• تم وضع علامة في المربّع

  قيمة منطقية اختيارية

  الحالة الأولية لمربّع اختيار أو زر اختيار: "صحيح" (true) إذا كان محدّدًا و"خطأ" (false) إذا لم يكن محدّدًا. يمكن اختيار عنصر زر اختيار واحد فقط في كل مرة في مجموعة معيّنة من عناصر زر الاختيار.

• contexts

  [ContextType, ...ContextType[]] اختياري

  قائمة بالسياقات التي سيظهر فيها عنصر القائمة هذا ويتم ضبط القيمة على ['page'] تلقائيًا في حال عدم تحديدها.

• documentUrlPatterns

  string[] اختياري

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

• مفعّلة

  قيمة منطقية اختيارية

  تحدّد ما إذا كان عنصر قائمة السياق هذا مفعَّلاً أم غير مفعَّل. القيمة التلقائية هي true.

• id

  string اختياري

  المعرّف الفريد الذي سيتم تعيينه لهذا العنصر مطلوبة لصفحات الفعاليات. لا يمكن أن يكون هو نفسه معرّف آخر لهذه الإضافة.

• parentId

  string | number اختيارية

  رقم تعريف عنصر قائمة رئيسي، ما يجعل العنصر فرعيًا لعنصر تمت إضافته سابقًا.

• targetUrlPatterns

  string[] اختياري

  تشبه documentUrlPatterns، ولكنها تتيح لك الفلترة استنادًا إلى السمة src لعلامات img/audio/video وhref لعلامات الارتساء.

• title

  string اختياري

  النص الذي سيتم عرضه في العنصر، وهو مطلوب ما لم تكن قيمة type هي "separator". عندما يكون السياق "selection"، يمكنك استخدام %s ضمن السلسلة لعرض النص المحدّد. على سبيل المثال، إذا كانت قيمة هذه المَعلمة هي "ترجمة %s إلى لغة الخنازير اللاتينية" واختار المستخدم كلمة "رائع"، سيكون عنصر قائمة السياق للاختيار هو "ترجمة "رائع" إلى لغة الخنازير اللاتينية".

• النوع

  ItemType اختياري

  نوع عنصر القائمة ويتم ضبط القيمة على "normal" تلقائيًا في حال عدم تحديدها.

• onclick

  void اختياري

  دالة سيتم استدعاؤها عند النقر على عنصر القائمة

  تبدو الدالة onclick على النحو التالي:

  (info: OnClickData) => {...}

  • معلومات

    OnClickData

    معلومات حول العنصر الذي تم النقر عليه والسياق الذي حدثت فيه النقرة

ContextMenus

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

الخصائص

• onShow

  Event<functionvoidvoid>

  يتم تنشيط هذا الحدث قبل عرض قائمة سياق على webview. يمكن استخدامها لإيقاف قائمة السياق هذه من خلال استدعاء event.preventDefault().

  تبدو الدالة onShow.addListener على النحو التالي:

  (callback: function) => {...}

  • callback

    دالة

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

    (event: object) => void

    • حدث

      عنصر

      • preventDefault

        void

        يمكنك استدعاء هذه الدالة لمنع عرض قائمة السياقات.

        تبدو الدالة preventDefault على النحو التالي:

        () => {...}

• إنشاء

  void

  لإنشاء عنصر جديد في قائمة السياق يُرجى العِلم أنّه في حال حدوث خطأ أثناء الإنشاء، قد لا تكتشف ذلك إلا بعد تفعيل دالة الاستدعاء الخاصة بالإنشاء (ستظهر التفاصيل في runtime.lastError).

  تبدو الدالة create على النحو التالي:

  (createProperties: object, callback?: function) => {...}

  • createProperties

    عنصر

    السمات المستخدَمة لإنشاء العنصر

  • callback

    function اختياري

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

    () => void

  • returns

    string | number

    معرّف العنصر الذي تم إنشاؤه حديثًا

• إزالة

  void

  لإزالة عنصر من قائمة السياق

  تبدو الدالة remove على النحو التالي:

  (menuItemId: string | number, callback?: function) => {...}

  • menuItemId

    string | number

    معرّف عنصر قائمة السياق المطلوب إزالته.

  • callback

    function اختياري

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

    () => void

• removeAll

  void

  لإزالة جميع عناصر قائمة السياق التي تمت إضافتها إلى "webview".

  تبدو الدالة removeAll على النحو التالي:

  (callback?: function) => {...}

  • callback

    function اختياري

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

    () => void

• تحديث

  void

  يعدّل عنصر قائمة سياق تم إنشاؤه سابقًا.

  تبدو الدالة update على النحو التالي:

  (id: string | number, updateProperties: object, callback?: function) => {...}

  • id

    string | number

    رقم تعريف العنصر المطلوب تعديله

  • updateProperties

    عنصر

    السمات المطلوب تعديلها تقبل هذه الدالة القيم نفسها التي تقبلها دالة الإنشاء.

  • callback

    function اختياري

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

    () => void

ContextMenuUpdateProperties

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

الخصائص

• تم وضع علامة في المربّع

  قيمة منطقية اختيارية

  حالة مربّع اختيار أو عنصر زر اختيار: "صحيح" للعنصر المحدّد و"خطأ" للعنصر غير المحدّد يمكن اختيار عنصر زر اختيار واحد فقط في كل مرة في مجموعة معيّنة من عناصر زر الاختيار.

• contexts

  [ContextType, ...ContextType[]] اختياري

  قائمة بالسياقات التي سيظهر فيها عنصر القائمة هذا

• documentUrlPatterns

  string[] اختياري

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

• مفعّلة

  قيمة منطقية اختيارية

  تحدّد ما إذا كان عنصر قائمة السياق هذا مفعَّلاً أم غير مفعَّل.

• parentId

  string | number اختيارية

  رقم تعريف عنصر قائمة رئيسي، ما يجعل العنصر فرعيًا لعنصر تمت إضافته سابقًا. ملاحظة: لا يمكنك تغيير عنصر ليكون عنصرًا فرعيًا لأحد العناصر التابعة له.

• targetUrlPatterns

  string[] اختياري

  تشبه documentUrlPatterns، ولكنها تتيح لك الفلترة استنادًا إلى السمة src لعلامات img/audio/video وhref لعلامات الارتساء.

• title

  string اختياري

  النص المطلوب عرضه في العنصر

• النوع

  ItemType اختياري

  نوع عنصر القائمة

• onclick

  void اختياري

  دالة سيتم استدعاؤها عند النقر على عنصر القائمة

  تبدو الدالة onclick على النحو التالي:

  (info: OnClickData) => {...}

  • معلومات

    OnClickData

    معلومات حول العنصر الذي تم النقر عليه والسياق الذي حدثت فيه النقرة

ContextType

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

السياقات المختلفة التي يمكن أن تظهر فيها القائمة ويعادل تحديد "الكل" دمج جميع السياقات الأخرى.

Enum

"all"

"page"

"frame"

"selection"

"link"

"editable"

"image"

"video"

"audio"

DialogController

واجهة مرتبطة بأحداث DOM في dialog.

الخصائص

• إلغاء

  void

  ارفض مربّع الحوار. يعادل النقر على "إلغاء" في مربّع حوار confirm أو prompt.

  تبدو الدالة cancel على النحو التالي:

  () => {...}

• حسنًا

  void

  اقبل مربّع الحوار. يعادل النقر على "حسنًا" في مربّع حوار alert أو confirm أو prompt.

  تبدو الدالة ok على النحو التالي:

  (response?: string) => {...}

  • رد

    string اختياري

    سلسلة الردّ التي يتم تقديمها للضيف عند قبول مربّع حوار prompt.

DialogMessageType

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

نوع مربّع الحوار المشروط الذي يطلبه الضيف

Enum

"alert"

"confirm"

"prompt"

DownloadPermissionRequest

نوع عنصر request الذي يرافق حدث DOM من النوع download permissionrequest.

الخصائص

• requestMethod

  سلسلة

  نوع طلب HTTP (مثل GET) المرتبط بطلب التنزيل

• url

  سلسلة

  عنوان URL المطلوب للتنزيل

• سماح

  void

  اسمح بطلب الحصول على الإذن.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن هذا هو الإعداد التلقائي في حال عدم استدعاء allow.

  تبدو الدالة deny على النحو التالي:

  () => {...}

ExitReason

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

سلسلة تشير إلى سبب الخروج

Enum

"normal"

"abnormal"

"crashed"

"killed"

"oom killed"

"oom"

"تعذّر التشغيل"

"integrity failure"

FileSystemPermissionRequest

نوع عنصر request الذي يرافق حدث DOM من النوع filesystem permissionrequest.

الخصائص

• url

  سلسلة

  عنوان URL للإطار الذي يطلب الوصول إلى نظام الملفات على الجهاز

• سماح

  void

  اسمح بطلب الحصول على الإذن.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن

  تبدو الدالة deny على النحو التالي:

  () => {...}

FindCallbackResults

يحتوي على جميع نتائج طلب البحث.

الخصائص

• activeMatchOrdinal

  الرقم

  العدد الترتيبي للمباراة الحالية

• مُلغاة

  قيمة منطقية

  يشير إلى ما إذا تم إلغاء طلب البحث هذا.

• numberOfMatches

  الرقم

  عدد مرات مطابقة "searchText" في الصفحة

• selectionRect

  SelectionRect

  يصف مستطيلاً حول المطابقة النشطة في إحداثيات الشاشة.

FindOptions

خيارات طلب البحث

الخصائص

• الرجوع

  قيمة منطقية اختيارية

  علامة للعثور على التطابقات بترتيب عكسي. تكون القيمة التلقائية false.

• matchCase

  قيمة منطقية اختيارية

  علامة للمطابقة مع حساسية حالة الأحرف. تكون القيمة التلقائية false.

FullscreenPermissionRequest

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

نوع عنصر request الذي يرافق حدث DOM من النوع fullscreen permissionrequest.

الخصائص

• الأصل

  سلسلة

  مصدر الإطار داخل webview الذي بدأ طلب ملء الشاشة

• سماح

  void

  اسمح بطلب الحصول على الإذن.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن

  تبدو الدالة deny على النحو التالي:

  () => {...}

GeolocationPermissionRequest

نوع عنصر request الذي يرافق حدث DOM من النوع geolocation permissionrequest.

الخصائص

• url

  سلسلة

  عنوان URL للإطار الذي يطلب الوصول إلى بيانات الموقع الجغرافي

• سماح

  void

  اسمح بطلب الحصول على الإذن.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن هذا هو الإعداد التلقائي في حال عدم استدعاء allow.

  تبدو الدالة deny على النحو التالي:

  () => {...}

HidPermissionRequest

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

نوع عنصر request الذي يرافق حدث DOM من النوع hid permissionrequest.

الخصائص

• url

  سلسلة

  عنوان URL للإطار الذي يطلب الوصول إلى HID API

• سماح

  void

  اسمح بطلب الحصول على الإذن.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن هذا هو الإعداد التلقائي في حال عدم استدعاء allow.

  تبدو الدالة deny على النحو التالي:

  () => {...}

InjectDetails

تفاصيل النص البرمجي أو CSS المطلوب إدخالهما يجب ضبط سمة الرمز أو الملف، ولكن لا يمكن ضبط كليهما في الوقت نفسه.

الخصائص

• رمز

  string اختياري

  رمز JavaScript أو CSS المطلوب إدخاله

  تحذير: يُرجى توخّي الحذر عند استخدام المَعلمة code. وقد يؤدي استخدامه بشكل غير صحيح إلى تعرُّض تطبيقك لهجمات اختراق المواقع الإلكترونية.

• ملف واحد

  string اختياري

  ملف JavaScript أو CSS المطلوب إدخاله

InjectionItems

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

نوع عنصر الحقن: رمز أو مجموعة من الملفات.

الخصائص

• رمز

  string اختياري

  رمز JavaScript أو CSS المطلوب إدخاله في الصفحات المطابقة

• ملفات

  string[] اختياري

  قائمة ملفات JavaScript أو CSS التي سيتم إدخالها في الصفحات المطابقة ويتم إدخالها بالترتيب الذي تظهر به في هذه المصفوفة.

LoadAbortReason

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

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

Enum

"ERR_ABORTED"

"ERR_INVALID_URL"

"ERR_DISALLOWED_URL_SCHEME"

"ERR_BLOCKED_BY_CLIENT"

"ERR_ADDRESS_UNREACHABLE"

"ERR_EMPTY_RESPONSE"

"ERR_FILE_NOT_FOUND"

"ERR_UNKNOWN_URL_SCHEME"

LoadPluginPermissionRequest

نوع عنصر request الذي يرافق حدث DOM من النوع loadplugin permissionrequest.

الخصائص

• identifier

  سلسلة

  سلسلة معرّف المكوّن الإضافي

• الاسم

  سلسلة

  الاسم المعروض للمكوّن الإضافي

• سماح

  void

  اسمح بطلب الحصول على الإذن. هذا هو الإعداد التلقائي في حال عدم استدعاء deny.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن

  تبدو الدالة deny على النحو التالي:

  () => {...}

MediaPermissionRequest

نوع عنصر request الذي يرافق حدث DOM من النوع media permissionrequest.

الخصائص

• url

  سلسلة

  عنوان URL للإطار الذي يطلب الوصول إلى وسائط المستخدم

• سماح

  void

  اسمح بطلب الحصول على الإذن.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن هذا هو الإعداد التلقائي في حال عدم استدعاء allow.

  تبدو الدالة deny على النحو التالي:

  () => {...}

NewWindow

واجهة مرتبطة بأحداث DOM في newwindow.

الخصائص

• إرفاق

  void

  أرفِق الصفحة المستهدفة المطلوبة بعنصر webview حالي.

  تبدو الدالة attach على النحو التالي:

  (webview: object) => {...}

  • webview

    عنصر

    عنصر webview الذي يجب إرفاق الصفحة المستهدفة به.

• تجاهل

  void

  إلغاء طلب فتح نافذة جديدة

  تبدو الدالة discard على النحو التالي:

  () => {...}

PermissionType

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

نوع الإذن المطلوب

Enum

"media"

"geolocation"

"pointerLock"

"تنزيل"

"loadplugin"

"filesystem"

"fullscreen"

"hid"

PointerLockPermissionRequest

نوع عنصر request الذي يرافق حدث DOM من النوع pointerLock permissionrequest.

الخصائص

• lastUnlockedBySelf

  قيمة منطقية

  ما إذا كان الإطار الذي يطلب الإذن هو آخر عميل تم قفل المؤشر عليه أم لا

• url

  سلسلة

  عنوان URL للإطار الذي يطلب قفل المؤشر

• userGesture

  قيمة منطقية

  ما إذا كان قد تم طلب قفل المؤشر نتيجة إيماءة من المستخدم أم لا

• سماح

  void

  اسمح بطلب الحصول على الإذن.

  تبدو الدالة allow على النحو التالي:

  () => {...}

• رفض

  void

  رفض طلب الحصول على الإذن هذا هو الإعداد التلقائي في حال عدم استدعاء allow.

  تبدو الدالة deny على النحو التالي:

  () => {...}

SelectionRect

يصف مستطيلاً في إحداثيات الشاشة.

تكون دلالات الاحتواء شبيهة بالمصفوفة، أي أنّ الإحداثي (left, top) يُعتبر محتوًى في المستطيل، ولكن الإحداثي (left + width, top) ليس كذلك.

الخصائص

• الارتفاع

  الرقم

  ارتفاع المستطيل

• لليسار

  الرقم

  المسافة من الحافة اليسرى للشاشة إلى الحافة اليسرى للمستطيل

• العلوية

  الرقم

  المسافة من الحافة العلوية للشاشة إلى الحافة العلوية للمستطيل

• العرض

  الرقم

  عرض المستطيل

StopFindingAction

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

يحدّد هذا الإعداد الإجراء الذي يجب اتّخاذه مع المطابقة النشطة بعد انتهاء جلسة البحث. سيؤدي الضغط على clear إلى محو التمييز عن المطابقة النشطة، بينما سيؤدي الضغط على keep إلى إبقاء المطابقة النشطة مميّزة، وسيؤدي الضغط على activate إلى إبقاء المطابقة النشطة مميّزة ومحاكاة نقرة المستخدم على تلك المطابقة. الإجراء التلقائي هو keep.

Enum

"clear"

"keep"

"activate"

WebRequestEventInterface

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

واجهة توفّر إمكانية الوصول إلى أحداث webRequest على صفحة الضيف يُرجى الاطّلاع على واجهة برمجة التطبيقات لإضافات chrome.webRequest لمعرفة تفاصيل حول دورة حياة webRequest والمفاهيم ذات الصلة. ملاحظة: لا يتوفّر الحدث chrome.webRequest.onActionIgnored في طرق عرض الويب.

لتوضيح مدى اختلاف الاستخدام عن واجهة webRequest API للإضافات، يمكنك الاطّلاع على الرمز البرمجي التالي الذي يحظر أي طلبات من الضيوف لعناوين URL التي تتطابق مع *://www.evil.com/*:

webview.request.onBeforeRequest.addListener(
  function(details) { return {cancel: true}; },
  {urls: ["*://www.evil.com/*"]},
  ["blocking"]);

بالإضافة إلى ذلك، تتيح هذه الواجهة قواعد webRequest التعريفية من خلال الحدثَين onRequest وonMessage. لمزيد من التفاصيل حول واجهة برمجة التطبيقات، يُرجى الاطّلاع على declarativeWebRequest.

يُرجى العِلم أنّه يجب إنشاء مثيل للشروط والإجراءات الخاصة بطلبات الويب التعريفية في WebView من نظيراتها في chrome.webViewRequest.*. يحظر نموذج الرمز البرمجي التالي بشكل تعريفي جميع الطلبات إلى "example.com" في عرض الويب myWebview:

var rule = {
  conditions: [
    new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
  ],
  actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);

WindowOpenDisposition

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

الترتيب المطلوب للنافذة الجديدة

Enum

"ignore"

"save_to_disk"

"current_tab"

"new_background_tab"

"new_foreground_tab"

"new_window"

"new_popup"

ZoomMode

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

يحدّد هذا الإعداد كيفية التعامل مع التكبير أو التصغير في webview.

Enum

"per-origin"
سيتم الاحتفاظ بتغييرات التكبير/التصغير في مصدر الصفحة التي تم تكبيرها/تصغيرها، أي سيتم أيضًا تكبير/تصغير جميع عروض الويب الأخرى في القسم نفسه التي يتم الانتقال إليها من المصدر نفسه. بالإضافة إلى ذلك، يتم حفظ تغييرات التكبير/التصغير في per-origin مع المصدر، ما يعني أنّه عند الانتقال إلى صفحات أخرى في المصدر نفسه، سيتم تكبيرها أو تصغيرها جميعًا باستخدام عامل التكبير/التصغير نفسه.

"per-view"
لا تسري تغييرات التكبير أو التصغير إلا في طريقة العرض هذه على الويب، ولن تؤثر تغييرات التكبير أو التصغير في طرق العرض الأخرى على الويب في التكبير أو التصغير في طريقة العرض هذه على الويب. بالإضافة إلى ذلك، per-view تتم إعادة ضبط تغييرات التكبير/التصغير عند التنقّل، وسيؤدي التنقّل في WebView دائمًا إلى تحميل الصفحات بعوامل التكبير/التصغير لكل مصدر (ضمن نطاق القسم).

‫"disabled"
يتم إيقاف جميع عمليات التكبير أو التصغير في WebView. وسيعود المحتوى إلى مستوى التكبير التلقائي، وسيتم تجاهل جميع محاولات تغيير مستوى التكبير.

الخصائص

contentWindow

مرجع كائن يمكن استخدامه لنشر الرسائل في صفحة الضيف.

النوع

ContentWindow

contextMenus

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

تشبه واجهة برمجة التطبيقات ContextMenus في Chrome، ولكنها تنطبق على webview بدلاً من المتصفّح. استخدِم واجهة برمجة التطبيقات webview.contextMenus لإضافة عناصر إلى قائمة السياق في "webview". يمكنك اختيار أنواع العناصر التي تنطبق عليها إضافات قائمة السياق، مثل الصور والروابط التشعبية والصفحات.

النوع

ContextMenus

request

واجهة توفّر إمكانية الوصول إلى أحداث webRequest على صفحة الضيف

النوع

WebRequestEventInterface

الطُرق

addContentScripts()

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

chrome.webviewTag.addContentScripts(
  contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
): void

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

يضيف المثال التالي قاعدتَين إلى webview: "myRule" و"anotherRule".

webview.addContentScripts([
  {
    name: 'myRule',
    matches: ['http://www.foo.com/*'],
    css: { files: ['mystyles.css'] },
    js: { files: ['jquery.js', 'myscript.js'] },
    run_at: 'document_start'
  },
  {
    name: 'anotherRule',
    matches: ['http://www.bar.com/*'],
    js: { code: "document.body.style.backgroundColor = 'red';" },
    run_at: 'document_end'
  }]);
 ...

// Navigates webview.
webview.src = 'http://www.foo.com';

يمكنك تأجيل طلب addContentScripts إلى أن تحتاج إلى إدخال النصوص البرمجية.

يوضّح المثال التالي كيفية استبدال قاعدة حالية.

webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.foo.com/*'],
    js: { files: ['scriptA.js'] },
    run_at: 'document_start'}]);

// Do something.
webview.src = 'http://www.foo.com/*';
 ...
// Overwrite 'rule' defined before.
webview.addContentScripts([{
    name: 'rule',
    matches: ['http://www.bar.com/*'],
    js: { files: ['scriptB.js'] },
    run_at: 'document_end'}]);

إذا تم الانتقال من خلال webview إلى المصدر (مثل foo.com) وتم استدعاء webview.addContentScripts لإضافة "myRule"، عليك الانتظار حتى يتم الانتقال التالي لإدخال النصوص البرمجية. إذا أردت حقنًا فوريًا، سيقوم executeScript بالإجراء الصحيح.

يتم الاحتفاظ بالقواعد حتى في حال تعطُّل عملية الضيف أو إيقافها أو حتى في حال إعادة تعيين العنصر الرئيسي لـ webview.

لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات النصوص البرمجية للمحتوى.

المعلمات

• contentScriptList

  ‫[ContentScriptDetails, ...ContentScriptDetails[]]

  تفاصيل نصوص المحتوى البرمجية المطلوب إضافتها

back()

chrome.webviewTag.back(
  callback?: function,
): void

ينتقل إلى إدخال السجلّ السابق إن أمكن. هذا الرمز مكافئ للرمز go(-1).

المعلمات

• callback

  function اختياري

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

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

  (success: boolean) => void

  • نجاح

    قيمة منطقية

    يشير هذا الحقل إلى ما إذا كانت عملية التنقّل ناجحة.

canGoBack()

chrome.webviewTag.canGoBack(): boolean

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

المرتجعات

• قيمة منطقية

canGoForward()

chrome.webviewTag.canGoForward(): boolean

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

المرتجعات

• قيمة منطقية

captureVisibleRegion()

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

chrome.webviewTag.captureVisibleRegion(
  options?: ImageDetails,
  callback: function,
): void

لالتقاط المنطقة المرئية من عرض الويب

المعلمات

• الخيارات

  ‫ImageDetails اختيارية

• callback

  دالة

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

  (dataUrl: string) => void

  • dataUrl

    سلسلة

    عنوان URL للبيانات يرمّز صورة للمنطقة المرئية من علامة التبويب التي تم التقاطها ويمكن تخصيصها لسمة src لعنصر صورة HTML من أجل عرضها.

clearData()

chrome.webviewTag.clearData(
  options: ClearDataOptions,
  types: ClearDataTypeSet,
  callback?: function,
): void

يمحو هذا الإجراء بيانات التصفّح من قسم "webview".

المعلمات

• الخيارات

  ClearDataOptions

  خيارات تحدّد البيانات التي سيتم محوها

• الأنواع

  ClearDataTypeSet

  أنواع البيانات التي سيتم محوها

• callback

  function اختياري

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

  () => void

executeScript()

chrome.webviewTag.executeScript(
  details: InjectDetails,
  callback?: function,
): void

يتيح هذا الإذن إدخال رمز JavaScript في صفحة الضيف.

يستخدم الرمز النموذجي التالي حقن النصوص البرمجية لضبط لون خلفية صفحة الضيف على الأحمر:

webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });

المعلمات

• التفاصيل

  InjectDetails

  تفاصيل النص البرمجي المطلوب تشغيله

• callback

  function اختياري

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

  (result?: any[]) => void

  • نتيجة

    any[] اختيارية

    نتيجة النص البرمجي في كل إطار تم حقنه

find()

chrome.webviewTag.find(
  searchText: string,
  options?: FindOptions,
  callback?: function,
): void

لبدء طلب بحث في الصفحة

المعلمات

• searchText

  سلسلة

  السلسلة المطلوب البحث عنها في الصفحة

• الخيارات

  FindOptions اختياري

  خيارات طلب البحث

• callback

  function اختياري

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

  (results?: FindCallbackResults) => void

  • النتائج

    ‫FindCallbackResults اختياري

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

forward()

chrome.webviewTag.forward(
  callback?: function,
): void

ينتقل إلى الأمام بمقدار إدخال واحد في السجلّ إن أمكن. هذا الرمز مكافئ للرمز go(1).

المعلمات

• callback

  function اختياري

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

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

  (success: boolean) => void

  • نجاح

    قيمة منطقية

    يشير هذا الحقل إلى ما إذا كانت عملية التنقّل ناجحة.

getAudioState()

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

chrome.webviewTag.getAudioState(
  callback: function,
): void

للاستعلام عن حالة الصوت

المعلمات

• callback

  دالة

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

  (audible: boolean) => void

  • تطبيق audible

    قيمة منطقية

getProcessId()

chrome.webviewTag.getProcessId(): number

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

المرتجعات

• الرقم

getUserAgent()

chrome.webviewTag.getUserAgent(): string

تعرض هذه السمة سلسلة وكيل المستخدم التي يستخدمها webview لطلبات صفحات الضيوف.

المرتجعات

• سلسلة

getZoom()

chrome.webviewTag.getZoom(
  callback: function,
): void

للحصول على عامل التكبير/التصغير الحالي

المعلمات

• callback

  دالة

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

  (zoomFactor: number) => void

  • zoomFactor

    الرقم

    عامل التكبير/التصغير الحالي

getZoomMode()

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

chrome.webviewTag.getZoomMode(
  callback: function,
): void

تتيح هذه الطريقة الحصول على وضع التكبير أو التصغير الحالي.

المعلمات

• callback

  دالة

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

  (ZoomMode: ZoomMode) => void

  • ZoomMode

    ZoomMode

    وضع التكبير/التصغير الحالي لـ "webview"

go()

chrome.webviewTag.go(
  relativeIndex: number,
  callback?: function,
): void

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

المعلمات

• relativeIndex

  الرقم

  فهرس السجلّ النسبي الذي يجب الانتقال إليه في webview. على سبيل المثال، ستؤدي القيمة 2 إلى الانتقال للأمام بمقدار إدخالَين في السجلّ إن أمكن، بينما ستؤدي القيمة -3 إلى الانتقال للخلف بمقدار 3 إدخالات.

• callback

  function اختياري

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

  (success: boolean) => void

  • نجاح

    قيمة منطقية

    يشير هذا الحقل إلى ما إذا كانت عملية التنقّل ناجحة.

insertCSS()

chrome.webviewTag.insertCSS(
  details: InjectDetails,
  callback?: function,
): void

يتيح هذا الإذن إدخال CSS في صفحة الضيف.

المعلمات

• التفاصيل

  InjectDetails

  تفاصيل CSS المطلوب إدراجها

• callback

  function اختياري

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

  () => void

isAudioMuted()

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

chrome.webviewTag.isAudioMuted(
  callback: function,
): void

للاستعلام عمّا إذا كان الصوت مكتومًا

المعلمات

• callback

  دالة

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

  (muted: boolean) => void

  • تم كتم الصوت

    قيمة منطقية

isSpatialNavigationEnabled()

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

chrome.webviewTag.isSpatialNavigationEnabled(
  callback: function,
): void

يستعلم عما إذا كان التنقل المكاني مفعلاً لعرض الويب.

المعلمات

• callback

  دالة

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

  (enabled: boolean) => void

  • مفعّلة

    قيمة منطقية

isUserAgentOverridden()

chrome.webviewTag.isUserAgentOverridden(): void

يشير إلى ما إذا تم إلغاء سلسلة وكيل المستخدم في webview من خلال webviewTag.setUserAgentOverride أم لا.

loadDataWithBaseUrl()

chrome.webviewTag.loadDataWithBaseUrl(
  dataUrl: string,
  baseUrl: string,
  virtualUrl?: string,
): void

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

المعلمات

• dataUrl

  سلسلة

  عنوان URL للبيانات المطلوب تحميلها

• baseUrl

  سلسلة

  الجزء الأساسي من عنوان URL الذي سيتم استخدامه للروابط إلى مراجع محدّدة.

• virtualUrl

  string اختياري

  عنوان URL الذي سيظهر للمستخدم (في شريط العناوين)

print()

chrome.webviewTag.print(): void

لطباعة محتوى webview. وهذا يعادل استدعاء دالة الطباعة المبرمَجة من webview نفسه.

reload()

chrome.webviewTag.reload(): void

لإعادة تحميل الصفحة الحالية ذات المستوى الأعلى

removeContentScripts()

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

chrome.webviewTag.removeContentScripts(
  scriptNameList?: string[],
): void

تزيل هذه الطريقة نصوص المحتوى البرمجية من webview.

يزيل المثال التالي "myRule" التي تمت إضافتها سابقًا.

webview.removeContentScripts(['myRule']);

يمكنك إزالة جميع القواعد من خلال طلب:

webview.removeContentScripts();

المعلمات

• scriptNameList

  string[] اختياري

  قائمة بأسماء النصوص البرمجية للمحتوى التي ستتم إزالتها إذا كانت القائمة فارغة، ستتم إزالة جميع النصوص البرمجية للمحتوى التي تمت إضافتها إلى webview.

setAudioMuted()

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

chrome.webviewTag.setAudioMuted(
  mute: boolean,
): void

تضبط حالة كتم الصوت في WebView.

المعلمات

• كتم الصوت

  قيمة منطقية

  قيمة كتم الصوت

setSpatialNavigationEnabled()

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

chrome.webviewTag.setSpatialNavigationEnabled(
  enabled: boolean,
): void

يضبط هذا الإجراء حالة التنقّل المكاني في WebView.

المعلمات

• مفعّلة

  قيمة منطقية

  قيمة حالة التنقّل المكاني

setUserAgentOverride()

chrome.webviewTag.setUserAgentOverride(
  userAgent: string,
): void

تجاوز سلسلة وكيل المستخدم التي يستخدمها webview لطلبات صفحات الضيوف. سيؤدي التجاوز إلى إفراغ قيم عنوان حقول معلومات وكيل المستخدم والقيم التي يعرضها navigator.userAgentData لطلبات صفحة الضيف التي يتم تطبيق هذا التجاوز عليها.

المعلمات

• userAgent

  سلسلة

  سلسلة وكيل المستخدم المطلوب استخدامها

setZoom()

chrome.webviewTag.setZoom(
  zoomFactor: number,
  callback?: function,
): void

يغيّر عامل التكبير/التصغير للصفحة. يتم تحديد نطاق هذا التغيير واستمراريته من خلال وضع التكبير الحالي في WebView (راجِع webviewTag.ZoomMode).

المعلمات

• zoomFactor

  الرقم

  عامل التكبير الجديد

• callback

  function اختياري

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

  () => void

setZoomMode()

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

chrome.webviewTag.setZoomMode(
  ZoomMode: ZoomMode,
  callback?: function,
): void

يضبط وضع التكبير/التصغير في "webview".

المعلمات

• ZoomMode

  ZoomMode

  يحدّد هذا الإعداد كيفية التعامل مع التكبير في webview.

• callback

  function اختياري

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

  () => void

stop()

chrome.webviewTag.stop(): void

يوقف تحميل التنقّل الحالي في webview إذا كان قيد التقدم.

stopFinding()

chrome.webviewTag.stopFinding(
  action?: StopFindingAction,
): void

لإنهاء جلسة البحث الحالية (محو كل التمييز) وإلغاء جميع طلبات البحث قيد التقدم.

المعلمات

• إجراء

  StopFindingAction اختياري

  يحدّد هذا الإعداد الإجراء الذي يجب اتّخاذه مع المطابقة النشطة بعد انتهاء جلسة البحث. سيؤدي الضغط على clear إلى محو التمييز عن المطابقة النشطة، بينما سيؤدي الضغط على keep إلى إبقاء المطابقة النشطة مميّزة، وسيؤدي الضغط على activate إلى إبقاء المطابقة النشطة مميّزة ومحاكاة نقرة المستخدم على تلك المطابقة. الإجراء التلقائي هو keep.

terminate()

chrome.webviewTag.terminate(): void

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

الفعاليات

close

chrome.webviewTag.close.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما تحاول نافذة الضيف إغلاق نفسها.

ينقل الرمز النموذجي التالي webview إلى about:blank عندما يحاول الضيف إغلاق نفسه.

webview.addEventListener('close', function() {
  webview.src = 'about:blank';
});

المعلمات

• callback

  دالة

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

  () => void

consolemessage

chrome.webviewTag.consolemessage.addListener(
  callback: function,
)

يتم تفعيل هذا الحدث عندما تسجّل نافذة الضيف رسالة في وحدة التحكّم.

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

webview.addEventListener('consolemessage', function(e) {
  console.log('Guest page logged a message: ', e.message);
});

المعلمات

• callback

  دالة

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

  (level: number, message: string, line: number, sourceId: string) => void

  • مستوى

    الرقم

  • رسالة

    سلسلة

  • سطر

    الرقم

  • sourceId

    سلسلة

contentload

chrome.webviewTag.contentload.addListener(
  callback: function,
)

يتم تنشيطه عندما تنشّط نافذة الضيف حدث load، أي عند تحميل مستند جديد. لا يشمل ذلك التنقّل في الصفحة ضمن المستند الحالي أو عمليات تحميل الموارد غير المتزامنة.

يعدّل الرمز النموذجي التالي حجم الخط التلقائي لعنصر body الخاص بالضيف بعد تحميل الصفحة:

webview.addEventListener('contentload', function() {
  webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});

المعلمات

• callback

  دالة

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

  () => void

dialog

chrome.webviewTag.dialog.addListener(
  callback: function,
)

يتم تشغيل هذا الحدث عندما تحاول نافذة الضيف فتح مربّع حوار مشروط من خلال window.alert أو window.confirm أو window.prompt.

ستؤدي معالجة هذا الحدث إلى حظر عملية الضيف إلى أن يعود كل متتبِّع أحداث أو يتعذّر الوصول إلى عنصر dialog (في حال تم استدعاء preventDefault()).

والإعداد التلقائي هو إلغاء مربّع الحوار.

المعلمات

• callback

  دالة

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

  (messageType: DialogMessageType, messageText: string, dialog: DialogController) => void

  • messageType

    DialogMessageType

  • messageText

    سلسلة

  • مربّع حوار

    DialogController

exit

chrome.webviewTag.exit.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عند الخروج من العملية التي تعرض محتوى على الويب الخاص بالضيف.

سيعرض الرمز النموذجي التالي رسالة وداع كلما تعطّلت صفحة الضيف:

webview.addEventListener('exit', function(e) {
  if (e.reason === 'crash') {
    webview.src = 'data:text/plain,Goodbye, world!';
  }
});

المعلمات

• callback

  دالة

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

  (details: object) => void

  • التفاصيل

    عنصر

    • processID

      الرقم

      رقم التعريف الداخلي في Chrome للعملية التي تم إنهاؤها

    • reason

      ExitReason

      سلسلة تشير إلى سبب الخروج

findupdate

chrome.webviewTag.findupdate.addListener(
  callback: function,
)

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

المعلمات

• callback

  دالة

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

  (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

  • searchText

    سلسلة

  • numberOfMatches

    الرقم

  • activeMatchOrdinal

    الرقم

  • selectionRect

    SelectionRect

  • مُلغاة

    قيمة منطقية

  • finalUpdate

    سلسلة

loadabort

chrome.webviewTag.loadabort.addListener(
  callback: function,
)

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

ملاحظة: عند إلغاء تحميل مورد، سيتبع حدث loadabort في النهاية حدث loadstop، حتى إذا تم إلغاء جميع عمليات التحميل التي تم تنفيذها منذ آخر حدث loadstop (إن وُجد).

ملاحظة: عند إلغاء تحميل عنوان URL لصفحة "لمحة" أو عنوان URL لصفحة JavaScript، سيتم تنشيط loadabort ثم سيتم الانتقال إلى "about:blank" في webview.

المعلمات

• callback

  دالة

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

  (url: string, isTopLevel: boolean, code: number, reason: LoadAbortReason) => void

  • url

    سلسلة

  • isTopLevel

    قيمة منطقية

  • رمز

    الرقم

  • reason

    LoadAbortReason

loadcommit

chrome.webviewTag.loadcommit.addListener(
  callback: function,
)

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

المعلمات

• callback

  دالة

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

  (url: string, isTopLevel: boolean) => void

  • url

    سلسلة

  • isTopLevel

    قيمة منطقية

loadredirect

chrome.webviewTag.loadredirect.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما تتم إعادة توجيه طلب تحميل على المستوى الأعلى إلى عنوان URL مختلف.

المعلمات

• callback

  دالة

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

  (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

  • oldUrl

    سلسلة

  • newUrl

    سلسلة

  • isTopLevel

    قيمة منطقية

loadstart

chrome.webviewTag.loadstart.addListener(
  callback: function,
)

يتم تنشيطه عند بدء التحميل.

المعلمات

• callback

  دالة

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

  (url: string, isTopLevel: boolean) => void

  • url

    سلسلة

  • isTopLevel

    قيمة منطقية

loadstop

chrome.webviewTag.loadstop.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عند اكتمال جميع عمليات التحميل على مستوى الإطار في صفحة ضيف (بما في ذلك جميع الإطارات الفرعية). ويشمل ذلك التنقّل داخل المستند الحالي بالإضافة إلى عمليات تحميل المستندات على مستوى الإطار الفرعي، ولكنّه لا يشمل عمليات تحميل الموارد غير المتزامنة. يتم تنشيط هذا الحدث في كل مرة ينتقل فيها عدد عمليات التحميل على مستوى المستند من واحد (أو أكثر) إلى صفر. على سبيل المثال، إذا كانت الصفحة التي انتهى تحميلها (أي loadstop already fired once) creates a new iframe which loads a page, then a second loadstop will fire when the iframe page load completes. يُلاحظ هذا النمط عادةً في الصفحات التي تحمّل الإعلانات.

ملاحظة: عند إلغاء عملية تحميل تم الالتزام بها، سيتبع حدث loadstop في النهاية حدث loadabort، حتى إذا تم إلغاء جميع عمليات التحميل التي تم الالتزام بها منذ آخر حدث loadstop (إن وُجد).

المعلمات

• callback

  دالة

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

  () => void

newwindow

chrome.webviewTag.newwindow.addListener(
  callback: function,
)

يتم تشغيل هذا الحدث عندما تحاول صفحة الضيف فتح نافذة متصفّح جديدة.

سينشئ الرمز النموذجي التالي webview جديدًا وينتقل إليه في أداة التضمين لكل نافذة جديدة مطلوبة:

webview.addEventListener('newwindow', function(e) {
  var newWebview = document.createElement('webview');
  document.body.appendChild(newWebview);
  e.window.attach(newWebview);
});

المعلمات

• callback

  دالة

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

  (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: WindowOpenDisposition) => void

  • نافذة

    NewWindow

  • targetUrl

    سلسلة

  • initialWidth

    الرقم

  • initialHeight

    الرقم

  • الاسم

    سلسلة

  • windowOpenDisposition

    WindowOpenDisposition

permissionrequest

chrome.webviewTag.permissionrequest.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما تحتاج صفحة الضيف إلى طلب إذن خاص من المضمِّن.

سيمنح الرمز البرمجي في المثال التالي صفحة الضيف إذن الوصول إلى واجهة برمجة التطبيقات webkitGetUserMedia. يُرجى العِلم أنّ التطبيق الذي يستخدم نموذج الرمز البرمجي هذا يجب أن يحدّد بنفسه أذونات البيان audioCapture و/أو videoCapture:

webview.addEventListener('permissionrequest', function(e) {
  if (e.permission === 'media') {
    e.request.allow();
  }
});

المعلمات

• callback

  دالة

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

  (permission: PermissionType, request: object) => void

  • الإذن

    PermissionType

  • طلب

    عنصر

responsive

chrome.webviewTag.responsive.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما تصبح العملية التي تعرض محتوى على الويب الخاص بالضيف مستجيبة مرة أخرى بعد أن كانت غير مستجيبة.

سيؤدي نموذج الرمز البرمجي التالي إلى تلاشي العنصر webview أو ظهوره عندما يصبح مستجيبًا أو غير مستجيب:

webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
  webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
  webview.style.opacity = '1';
});

المعلمات

• callback

  دالة

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

  (processID: number) => void

  • processID

    الرقم

sizechanged

chrome.webviewTag.sizechanged.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عند تغيير حجم المحتوى المضمّن على الويب من خلال autosize. لا يتم تنشيطه إلا إذا كان autosize مفعَّلاً.

المعلمات

• callback

  دالة

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

  (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

  • oldWidth

    الرقم

  • oldHeight

    الرقم

  • newWidth

    الرقم

  • newHeight

    الرقم

unresponsive

chrome.webviewTag.unresponsive.addListener(
  callback: function,
)

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

المعلمات

• callback

  دالة

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

  (processID: number) => void

  • processID

    الرقم

zoomchange

chrome.webviewTag.zoomchange.addListener(
  callback: function,
)

يتم تشغيل هذا الحدث عند تغيير مستوى تكبير الصفحة.

المعلمات

• callback

  دالة

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

  (oldZoomFactor: number, newZoomFactor: number) => void

  • oldZoomFactor

    الرقم

  • newZoomFactor

    الرقم