الوصف
يمكنك استخدام علامة webview
لتحميل المحتوى المباشر من الويب على الشبكة بشكل نشط وتضمينه في تطبيق Chrome. يمكن لتطبيقك التحكّم في مظهر webview
والتفاعل مع محتوى الويب وبدء التنقّل في صفحة ويب مضمّنة والتفاعل مع أحداث الأخطاء التي تحدث داخلها وغير ذلك (راجِع الاستخدام).
الأذونات
webview
الأنواع
ClearDataOptions
خيارات تحدّد البيانات التي يجب محوها بحلول clearData
.
أماكن إقامة
-
منذ
الرقم اختياري
محو البيانات المتراكمة في هذا التاريخ أو بعده، والممثّلة بالمللي ثانية منذ تاريخ بدء حساب الفترة (يمكن الوصول إليها من خلال طريقة getTime لكائن
Date
في JavaScript) في حال عدم توفّر هذه المعلومات، يتم ضبطها تلقائيًا على "0
" (ما سيؤدي إلى إزالة جميع بيانات التصفّح).
ClearDataTypeSet
مجموعة من أنواع البيانات. ويتم تفسير السمات غير المتوفّرة على أنّها false
.
أماكن إقامة
-
ذاكرة التخزين المؤقت للتطبيق
منطقية اختيارية
تطبيقات المواقع الإلكترونية.
-
ذاكرة التخزين المؤقت
منطقية اختيارية
Chrome 44 والإصدارات الأحدثبدايةً من الإصدار 43 من Chrome. ذاكرة التخزين المؤقت في المتصفّح. ملاحظة: عند إزالة البيانات، يؤدي هذا إلى محو ذاكرة التخزين المؤقت بالكامل، ولا يقتصر على النطاق الذي تحدده.
-
ملفات تعريف الارتباط
منطقية اختيارية
ملفات تعريف الارتباط الخاصة بالقسم
-
fileSystems
منطقية اختيارية
أنظمة ملفات مواقع الويب.
-
indexedDB
منطقية اختيارية
بيانات IndexedDB لمواقع الويب
-
localStorage
منطقية اختيارية
بيانات التخزين المحلية للمواقع الإلكترونية
-
persistentCookies
منطقية اختيارية
Chrome 58 والإصدارات الأحدثهي ملفات تعريف الارتباط الدائمة للقسم.
-
sessionCookies
منطقية اختيارية
Chrome 58 والإصدارات الأحدثملفات تعريف الارتباط لجلسة القسم.
-
webSQL
منطقية اختيارية
بيانات WebSQL للمواقع الإلكترونية
ContentScriptDetails
تفاصيل نص المحتوى البرمجي المطلوب إدخاله. راجِع مستندات النصوص البرمجية للمحتوى للحصول على مزيد من التفاصيل.
أماكن إقامة
-
all_frames
منطقية اختيارية
إذا كانت قيمة
all_frames
هيtrue
، يعني ذلك أنّه يجب إدخال JavaScript أو CSS في جميع إطارات الصفحة الحالية. يتم ضبطall_frames
تلقائيًا علىfalse
، ويتم إدخال JavaScript أو CSS في الإطار العلوي فقط. -
css
InjectionItems اختيارية
رمز CSS أو قائمة ملفات CSS المطلوب إدخالها في الصفحات المطابقة. يتم إدخال هذه العناصر بالترتيب الذي تظهر به، قبل إنشاء أي نموذج العناصر في المستند (DOM) أو عرضه للصفحة.
-
exclude_globs
سلسلة[] اختيارية
يتم تطبيقها بعد المطابقات لاستبعاد عناوين URL التي تتطابق مع هذه الكلمة الرئيسية. مخصصة لمحاكاة الكلمة الرئيسية @DELETE Greaseاصطحاب.
-
exclude_matches
سلسلة[] اختيارية
تستبعد الصفحات التي تم إدخال نص المحتوى البرمجي فيها بطريقة أخرى.
-
include_globs
سلسلة[] اختيارية
يتم تطبيقها بعد المطابقات لتضمين عناوين URL التي تتطابق أيضًا مع هذه الكلمة الرئيسية فقط. الغرض منها محاكاة الكلمة الرئيسية @include Greasemonkey.
-
js
InjectionItems اختيارية
رمز JavaScript أو قائمة ملفات JavaScript المراد إدخالها في الصفحات المطابقة. ويتم إدخال هذه المعرّفات بالترتيب الذي تظهر به.
-
match_about_blank
منطقية اختيارية
يمكنك تحديد ما إذا كان سيتم إدراج النص البرمجي للمحتوى في about:blank وabout:srcdoc. لن يتم إدخال النصوص البرمجية للمحتوى في الصفحات إلا عند مطابقة عنوان URL الذي تم اكتسابه مع أحد الأنماط المُعلَن عنها في حقل التطابقات. عنوان URL المكتسب هو عنوان URL للمستند الذي تم إنشاء الإطار أو النافذة فيه. لا يمكن إدراج النصوص البرمجية للمحتوى في الإطارات في وضع الحماية.
-
فلتر مطابق لـ
سلسلة[]
تحدّد الصفحات التي سيتم إدخال هذا النص البرمجي للمحتوى إليها.
-
اسم
سلسلة
اسم نص المحتوى البرمجي المطلوب إدخاله.
-
run_at
RunAt اختيارية
أقرب وقت يتم فيه إدخال JavaScript أو CSS في علامة التبويب. يتم ضبط القيمة التلقائية على "document_idle".
ContentWindow
مقبض المراسلة إلى نافذة ضيف.
أماكن إقامة
-
postMessage
void
نشر رسالة على محتوى الويب المضمّن ما دام المحتوى المضمّن يعرض صفحة من المصدر المستهدف تتوفر هذه الطريقة بعد اكتمال تحميل الصفحة. استمع إلى حدث
contentload
، ثم استدعِ الطريقة.سيتمكن الضيف من إرسال الردود على أداة التضمين من خلال نشر رسالة إلى
event.source
حول حدث الرسالة الذي يتلقّاه.تتطابق واجهة برمجة التطبيقات هذه مع HTML5 postMessage API للتواصل بين صفحات الويب. يمكن لأداة التضمين الاستماع إلى الردود من خلال إضافة أداة معالجة حدث
message
إلى إطارها الخاص.تبدو الدالة
postMessage
على النحو التالي:(message: any, targetOrigin: string) => {...}
-
رسالة
أي فلتر
سيتم إرسال عنصر الرسالة إلى المدعو.
-
targetOrigin
سلسلة
تُحدِّد هذه السياسة مصدر نافذة الضيف التي يجب إرسال الحدث إليها.
-
ContextMenuCreateProperties
أماكن إقامة
-
تم وضع علامة في المربّع
منطقية اختيارية
الحالة الأولية لمربّع اختيار أو عنصر اختيار: يكون صحيح للخيار "محدد" و"خطأ" مع العناصر غير المحددة. يمكن اختيار عنصر راديو واحد فقط في كل مرة ضمن مجموعة معيّنة من عناصر الاختيار.
-
السياقات
[ContextType, ...ContextType[]] اختيارية
قائمة السياقات التي سيظهر فيها عنصر القائمة هذا ويتم ضبط القيمة تلقائيًا على ['page'] في حال عدم تحديدها.
-
documentUrlPatterns
سلسلة[] اختيارية
يتيح لك هذا الخيار تقييد العنصر لتطبيقه فقط على المستندات التي يتطابق عنوان URL الخاص بها مع أحد الأنماط المحدّدة. (ينطبق هذا على الإطارات أيضًا.) ولمعرفة تفاصيل عن تنسيق النمط، يُرجى الاطّلاع على أنماط المطابقة.
-
مفعّلة
منطقية اختيارية
ما إذا كان عنصر قائمة السياق هذا مفعَّلاً أو غير مفعَّل. وتكون الإعدادات التلقائية
true
. -
id
سلسلة اختيارية
المعرّف الفريد الذي سيتم تعيينه لهذا العنصر. إلزامي لصفحات الفعاليات. لا يمكن أن يكون مطابقًا لمعرّف آخر لهذه الإضافة.
-
parentId
سلسلة | رقم اختياري
معرّف عنصر القائمة الرئيسي، ويؤدي هذا إلى جعل العنصر ثانويًا لعنصر تمت إضافته سابقًا.
-
targetUrlPatterns
سلسلة[] اختيارية
هذا الوضع مشابه لـ documentUrlPatterns، ولكنّه يتيح لك الفلترة استنادًا إلى السمة
src
لعلامات img/audio/video وعلامات الارتساءhref
. -
title
سلسلة اختيارية
النص الذي سيتم عرضه في العنصر، يكون هذا مطلوبًا ما لم تكن السمة
type
"فاصلة". عندما يتم ضبط السياق على 'select' (اختيار)، يمكنك استخدام%s
داخل السلسلة لعرض النص المحدَّد. على سبيل المثال، إذا كانت قيمة هذه المَعلمة هي "ترجمة '%s' إلى لغة Pig Latin" واختيار المستخدم كلمة "cool"، يكون عنصر قائمة السياق المحدد هو "ترجمة كلمة "رائع" إلى اللغة اللاتينية". -
كتابة
ItemType اختيارية
نوع صنف في القائمة يتم ضبط القيمة تلقائيًا على "عادي" إذا لم يتم تحديدها.
-
onclick
باطل اختياري
يشير ذلك المصطلح إلى دالة يتم استدعاءها عند النقر على عنصر في القائمة.
تبدو الدالة
onclick
على النحو التالي:(info: OnClickData) => {...}
-
معلومات
معلومات عن السلعة التي تم النقر عليها والسياق الذي حدثت فيه النقرة
-
ContextMenus
أماكن إقامة
-
onShow
الحدث<functionvitvit>
تم تنشيط هذه الميزة قبل عرض قائمة سياقات على جهاز
webview
هذا. يمكن استخدامها لإيقاف قائمة السياقات هذه من خلال استدعاءevent.preventDefault()
.تبدو الدالة
onShow.addListener
على النحو التالي:(callback: function) => {...}
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(event: object) => void
-
event
عنصر
-
preventDefault
void
عليك استدعاء هذا الحدث لمنع عرض قائمة السياق.
تبدو الدالة
preventDefault
على النحو التالي:() => {...}
-
-
-
-
إنشاء
void
ينشئ عنصرًا جديدًا في قائمة السياق. تجدر الإشارة إلى أنّه في حال حدوث خطأ أثناء الإنشاء، قد لا يتم اكتشاف ذلك إلى أن يتم تنشيط معاودة الاتصال بالإنشاء (ستكون التفاصيل في
runtime.lastError
).تبدو الدالة
create
على النحو التالي:(createProperties: object, callback?: function) => {...}
-
createProperties
عنصر
الخصائص المستخدمة لإنشاء العنصر
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
-
returns
سلسلة | رقم
رقم تعريف العنصر الذي تم إنشاؤه حديثًا.
-
-
إزالة
void
لإزالة عنصر في قائمة السياقات.
تبدو الدالة
remove
على النحو التالي:(menuItemId: string | number, callback?: function) => {...}
-
سلسلة | رقم
رقم تعريف عنصر قائمة السياق المطلوب إزالته.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
-
-
removeAll
void
يؤدي هذا الإجراء إلى إزالة كل عناصر قائمة السياق التي تمّت إضافتها إلى بطاقة "
webview
".تبدو الدالة
removeAll
على النحو التالي:(callback?: function) => {...}
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
-
-
تحديث
void
لتعديل عنصر في قائمة السياق تم إنشاؤه سابقًا.
تبدو الدالة
update
على النحو التالي:(id: string | number, updateProperties: object, callback?: function) => {...}
-
id
سلسلة | رقم
رقم تعريف العنصر المطلوب تعديله.
-
updateProperties
عنصر
السمات المطلوب تعديلها تقبل القيم نفسها مثل دالة الإنشاء.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
-
ContextMenuUpdateProperties
أماكن إقامة
-
تم وضع علامة في المربّع
منطقية اختيارية
حالة مربّع اختيار أو عنصر اختيار: true مع محدّد أو false للخيار غير المحدّد. يمكن اختيار عنصر راديو واحد فقط في كل مرة ضمن مجموعة معيّنة من عناصر الاختيار.
-
السياقات
[ContextType, ...ContextType[]] اختيارية
قائمة السياقات التي سيظهر فيها عنصر القائمة هذا
-
documentUrlPatterns
سلسلة[] اختيارية
يتيح لك هذا الخيار تقييد العنصر لتطبيقه فقط على المستندات التي يتطابق عنوان URL الخاص بها مع أحد الأنماط المحدّدة. (ينطبق هذا على الإطارات أيضًا.) ولمعرفة تفاصيل عن تنسيق النمط، يُرجى الاطّلاع على أنماط المطابقة.
-
مفعّلة
منطقية اختيارية
ما إذا كان عنصر قائمة السياق هذا مفعَّلاً أو غير مفعَّل.
-
parentId
سلسلة | رقم اختياري
معرّف عنصر القائمة الرئيسي، ويؤدي هذا إلى جعل العنصر ثانويًا لعنصر تمت إضافته سابقًا. ملاحظة: لا يمكنك تغيير عنصر ليكون عنصرًا فرعيًا لأحد العناصر التابعة له.
-
targetUrlPatterns
سلسلة[] اختيارية
هذا الوضع مشابه لـ documentUrlPatterns، ولكنّه يتيح لك الفلترة استنادًا إلى السمة
src
لعلامات img/audio/video وعلامات الارتساءhref
. -
title
سلسلة اختيارية
النص الذي سيتم عرضه في العنصر
-
كتابة
ItemType اختيارية
نوع صنف في القائمة
-
onclick
باطل اختياري
يشير ذلك المصطلح إلى دالة يتم استدعاءها عند النقر على عنصر في القائمة.
تبدو الدالة
onclick
على النحو التالي:(info: OnClickData) => {...}
-
معلومات
معلومات عن السلعة التي تم النقر عليها والسياق الذي حدثت فيه النقرة
-
ContextType
السياقات المختلفة التي يمكن أن تظهر فيها القائمة. ويكون تحديد "الكل" مساويًا لتركيبة كل السياقات الأخرى.
التعداد
"audio"
DialogController
تم إرفاق الواجهة بأحداث DOM dialog
.
أماكن إقامة
-
إلغاء
void
رفض مربّع الحوار يعادل النقر على "إلغاء" في مربّع حوار
confirm
أوprompt
.تبدو الدالة
cancel
على النحو التالي:() => {...}
-
حسنًا
void
اقبل مربّع الحوار. يعادل النقر على "حسنًا" في مربّع حوار
alert
أوconfirm
أوprompt
.تبدو الدالة
ok
على النحو التالي:(response?: string) => {...}
-
رد
سلسلة اختيارية
سلسلة الردّ المطلوب تقديمها إلى الضيف عند قبول مربّع حوار
prompt
-
DownloadPermissionRequest
تمثّل هذه السمة نوع عنصر request
الذي يصاحب حدث DOM download
permissionrequest
.
أماكن إقامة
-
requestMethod
سلسلة
نوع طلب HTTP (مثل
GET
) المرتبط بطلب التنزيل -
url
سلسلة
عنوان URL المطلوب للتنزيل.
-
سماح
void
اسمح بطلب الإذن.
تبدو الدالة
allow
على النحو التالي:() => {...}
-
رفض
void
رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء
allow
.تبدو الدالة
deny
على النحو التالي:() => {...}
FileSystemPermissionRequest
تمثّل هذه السمة نوع عنصر request
الذي يصاحب حدث DOM filesystem
permissionrequest
.
أماكن إقامة
-
url
سلسلة
تمثّل هذه السمة عنوان URL للإطار الذي يطلب الوصول إلى نظام الملفات المحلي.
-
سماح
void
اسمح بطلب الإذن.
تبدو الدالة
allow
على النحو التالي:() => {...}
-
رفض
void
رفض طلب الإذن
تبدو الدالة
deny
على النحو التالي:() => {...}
FindCallbackResults
يحتوي على جميع نتائج طلب البحث.
أماكن إقامة
-
activeMatchOrdinal
الرقم
تمثّل هذه السمة العدد الترتيبي للمطابقة الحالية.
-
مُلغاة
boolean
يشير هذا العمود إلى ما إذا تم إلغاء طلب البحث هذا.
-
numberOfMatches
الرقم
عدد مرّات مطابقة
searchText
في الصفحة. -
selectionRect
لوصف مستطيل حول التطابق النشط في إحداثيات الشاشة.
FindOptions
خيارات طلب البحث.
أماكن إقامة
-
إلى الخلف
منطقية اختيارية
ضَع علامة للعثور على نتائج مطابقة بترتيب عكسي. تكون القيمة التلقائية
false
. -
matchCase
منطقية اختيارية
ضَع علامة للتوافق مع الحساسية لحالة الأحرف. تكون القيمة التلقائية
false
.
FullscreenPermissionRequest
تمثّل هذه السمة نوع عنصر request
الذي يصاحب حدث DOM fullscreen
permissionrequest
.
أماكن إقامة
-
الأصل
سلسلة
أصل الإطار داخل
webview
الذي بدأ طلب ملء الشاشة. -
سماح
void
اسمح بطلب الإذن.
تبدو الدالة
allow
على النحو التالي:() => {...}
-
رفض
void
رفض طلب الإذن
تبدو الدالة
deny
على النحو التالي:() => {...}
GeolocationPermissionRequest
تمثّل هذه السمة نوع عنصر request
الذي يصاحب حدث DOM geolocation
permissionrequest
.
أماكن إقامة
-
url
سلسلة
عنوان URL للإطار الذي يطلب الوصول إلى بيانات رصد الموقع الجغرافي.
-
سماح
void
اسمح بطلب الإذن.
تبدو الدالة
allow
على النحو التالي:() => {...}
-
رفض
void
رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء
allow
.تبدو الدالة
deny
على النحو التالي:() => {...}
HidPermissionRequest
تمثّل هذه السمة نوع عنصر request
الذي يصاحب حدث DOM hid
permissionrequest
.
أماكن إقامة
-
url
سلسلة
تمثّل هذه السمة عنوان URL للإطار الذي يطلب الوصول إلى واجهة برمجة تطبيقات HID.
-
سماح
void
اسمح بطلب الإذن.
تبدو الدالة
allow
على النحو التالي:() => {...}
-
رفض
void
رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء
allow
.تبدو الدالة
deny
على النحو التالي:() => {...}
InjectDetails
تفاصيل النص البرمجي أو CSS المطلوب إدخالها. يجب ضبط الرمز أو خاصية الملف، ولكن لا يمكن ضبطهما معًا في الوقت نفسه.
أماكن إقامة
-
رمز
سلسلة اختيارية
رمز JavaScript أو CSS المطلوب إدخاله
تحذير: عليك توخي الحذر عند استخدام معلمة
code
. قد يؤدي الاستخدام غير الصحيح لهذه الطريقة إلى فتح تطبيقك لهجمات النصوص البرمجية على المواقع الإلكترونية. -
ملف
سلسلة اختيارية
ملف JavaScript أو CSS المطلوب إدخاله.
InjectionItems
نوع عنصر الحقن: رمز أو مجموعة من الملفات.
أماكن إقامة
-
رمز
سلسلة اختيارية
رمز JavaScript أو CSS مطلوب إدخالها في الصفحات المطابقة.
-
ملف
سلسلة[] اختيارية
قائمة ملفات JavaScript أو CSS المطلوب إدخالها في الصفحات المطابقة. يتم إدخال هذه القيم بالترتيب الذي تظهر به في هذه الصفيفة.
LoadPluginPermissionRequest
تمثّل هذه السمة نوع عنصر request
الذي يصاحب حدث DOM loadplugin
permissionrequest
.
أماكن إقامة
-
معرّف
سلسلة
سلسلة معرّف المكوّن الإضافي.
-
اسم
سلسلة
اسم عرض المكوّن الإضافي.
-
سماح
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
على النحو التالي:() => {...}
PointerLockPermissionRequest
تمثّل هذه السمة نوع عنصر request
الذي يصاحب حدث DOM pointerLock
permissionrequest
.
أماكن إقامة
-
lastUnlockedBySelf
boolean
ما إذا كان الإطار الطالب هو أحدث عميل اضغط على قفل المؤشر أم لا.
-
url
سلسلة
عنوان URL للإطار الذي يطلب قفل المؤشر.
-
userGesture
boolean
ما إذا تم طلب قفل المؤشر نتيجة إيماءة إدخال المستخدم.
-
سماح
void
اسمح بطلب الإذن.
تبدو الدالة
allow
على النحو التالي:() => {...}
-
رفض
void
رفض طلب الإذن هذا هو السلوك التلقائي في حال عدم استدعاء
allow
.تبدو الدالة
deny
على النحو التالي:() => {...}
SelectionRect
لوصف مستطيل في إحداثيات الشاشة.
تشبه دلالات الاحتواء الصفيف، أي أن الإحداثي (left, top)
يعتبر مضمنة في المستطيل، لكن الإحداثي (left + width, top)
غير ذلك.
أماكن إقامة
-
الطول
الرقم
ارتفاع المستطيل.
-
في يمين الصورة
الرقم
المسافة من الحافة اليسرى للشاشة إلى الحافة اليسرى للمستطيل.
-
في أعلى الصورة
الرقم
المسافة من الحافة العلوية للشاشة إلى الحافة العلوية للمستطيل.
-
العرض
الرقم
عرض المستطيل
WebRequestEventInterface
واجهة تتيح الدخول إلى أحداث webRequest على صفحة الضيف. يمكنك الاطّلاع على واجهة برمجة تطبيقات إضافات chrome.webRequest للحصول على تفاصيل حول دورة حياة webRequest والمفاهيم ذات الصلة. ملاحظة: لا يمكن استخدام الحدث chrome.webRequest.onActionIgnored مع مكتبات WebView.
لتوضيح مدى اختلاف الاستخدام عن واجهة برمجة التطبيقات 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"
في WebView myWebview
:
var rule = {
conditions: [
new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
],
actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);
ZoomMode
تحدِّد هذه السياسة طريقة التعامل مع التكبير أو التصغير في webview
.
التعداد
"per-origin"
ستظل تغييرات التكبير أو التصغير في أصل الصفحة التي تم تكبيرها، أي أنّ جميع مكوّنات WebView الأخرى في القسم نفسه الذي تم الانتقال إليه إلى ذلك الأصل سيتم تكبيره أيضًا. بالإضافة إلى ذلك، يتم حفظ تغييرات التكبير/التصغير الـ per-origin
مع المصدر، ما يعني أنّه عند الانتقال إلى صفحات أخرى في المصدر نفسه، سيتم تكبيرها جميعًا باستخدام عامل التكبير/التصغير نفسه.
"لكل مشاهدة"
لا تسري تغييرات التكبير/التصغير إلا في WebView هذا، ولن تؤثر تغييرات التكبير/التصغير في WebView الأخرى في تكبير عرض WebView هذا. تتم أيضًا إعادة ضبط تغييرات التكبير/التصغير في per-view
عند التنقّل، وسيؤدي التنقّل في WebView إلى تحميل الصفحات دائمًا بعوامل التكبير/التصغير حسب المصدر (ضمن نطاق القسم).
"غير مفعَّل"
لإيقاف جميع عمليات التكبير في WebView. سيعود المحتوى إلى مستوى التكبير أو التصغير التلقائي، وسيتم تجاهل جميع التغييرات التي تمت محاولة استخدامها.
أماكن إقامة
contentWindow
مرجع عنصر يمكن استخدامه لنشر الرسائل في صفحة الضيف.
النوع
contextMenus
هذه الواجهة تشبه واجهة برمجة التطبيقات Context Menus في Chrome، ولكنها تنطبق على webview
بدلاً من المتصفّح. استخدِم واجهة برمجة تطبيقات webview.contextMenus
لإضافة عناصر إلى قائمة سياقات "webview
". يمكنك اختيار أنواع العناصر التي تنطبق عليها إضافات قائمة السياق، مثل الصور والروابط التشعّبية والصفحات.
النوع
request
واجهة تتيح الدخول إلى أحداث webRequest على صفحة الضيف.
النوع
الطُرق
addContentScripts()
chrome.webviewTag.addContentScripts(
contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
يؤدي هذا الإعداد إلى إضافة قواعد إدخال النص البرمجي للمحتوى إلى 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
تفاصيل النصوص البرمجية للمحتوى المطلوب إضافتها.
back()
chrome.webviewTag.back(
callback?: function,
)
للرجوع إلى الخلف عند إدخال سجلّ واحد، إن أمكن هذا الرمز مكافئ للرمز go(-1)
.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
Chrome 44 والإصدارات الأحدثتبدو معلَمة
callback
على النحو التالي:(success: boolean) => void
-
النجاح
boolean
يشير إلى ما إذا كان التنقل ناجحًا.
-
canGoBack()
chrome.webviewTag.canGoBack()
يشير إلى ما إذا كان من الممكن الانتقال للخلف خلال السجلّ أم لا. يتم تخزين حالة هذه الدالة مؤقتًا ويتم تعديلها قبل كل loadcommit
، لذا فإنّ أفضل مكان لطلب استخدامها هو loadcommit
.
المرتجعات
-
boolean
canGoForward()
chrome.webviewTag.canGoForward()
يشير إلى ما إذا كان من الممكن التنقل للأمام خلال السجل أم لا. يتم تخزين حالة هذه الدالة مؤقتًا ويتم تعديلها قبل كل loadcommit
، لذا فإنّ أفضل مكان لطلب استخدامها هو loadcommit
.
المرتجعات
-
boolean
captureVisibleRegion()
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
لتسجيل المنطقة المرئية من WebView.
المَعلمات
-
الخيارات
ImageDetails اختيارية
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(dataUrl: string) => void
-
dataUrl
سلسلة
عنوان URL للبيانات يتم ترميز صورة المنطقة المرئية لعلامة التبويب التي تم التقاطها. يمكن تعيينه لخاصية "src" في عنصر صورة HTML للعرض.
-
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
محو بيانات التصفُّح لقسم webview
.
المَعلمات
-
الخيارات
خيارات تحدد البيانات المطلوب مسحها.
-
الأنواع
أنواع البيانات التي سيتم محوها
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
إدخال رمز JavaScript في صفحة الضيف
يستخدم الرمز النموذجي التالي حقن النصوص البرمجية لضبط لون خلفية صفحة الضيف على الأحمر:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
المَعلمات
-
التفاصيل
تفاصيل النص البرمجي المطلوب تشغيله.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result?: any[]) => void
-
نتيجة
أي نوع[] اختياري
نتيجة النص البرمجي في كل إطار تم إدخاله.
-
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
)
لبدء طلب بحث في الصفحة.
المَعلمات
-
searchText
سلسلة
السلسلة المطلوب العثور عليها في الصفحة.
-
الخيارات
FindOptions اختيارية
خيارات طلب البحث.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(results?: FindCallbackResults) => void
-
النتائج
FindCallbackResults اختياري
يحتوي على جميع نتائج طلب البحث. يمكن حذف
results
إذا لم يتم استخدامه في نص دالة الاستدعاء، على سبيل المثال، إذا كان يتم استخدام معاودة الاتصال لرصد اكتمال طلب البحث فقط.
-
forward()
chrome.webviewTag.forward(
callback?: function,
)
للانتقال للأمام عن طريق الانتقال إلى إدخال واحد للسجلّ إن أمكن. هذا الرمز مكافئ للرمز go(1)
.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
Chrome 44 والإصدارات الأحدثتبدو معلَمة
callback
على النحو التالي:(success: boolean) => void
-
النجاح
boolean
يشير إلى ما إذا كان التنقل ناجحًا.
-
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
)
حالة الصوت لطلبات البحث
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(audible: boolean) => void
-
تطبيق audible
boolean
-
getProcessId()
chrome.webviewTag.getProcessId()
لعرض معرّف العملية الداخلي في Chrome للعملية الحالية لصفحة الويب على الضيوف، ما يسمح لبرامج التضمين بمعرفة عدد المدعوين الذين سيتأثرون بإنهاء العملية. ولن يشارك ضيفان العملية إلا إذا كانا ينتميان إلى التطبيق نفسه ولديهما رقم تعريف قسم مساحة التخزين نفسه. يكون الاستدعاء متزامنًا ويعرض الفكرة المخزَّنة مؤقتًا لمعرّف العملية الحالية في أداة التضمين. يختلف رقم تعريف العملية عن رقم تعريف العملية في نظام التشغيل.
المرتجعات
-
الرقم
getUserAgent()
chrome.webviewTag.getUserAgent()
تعرض سلسلة وكيل المستخدم التي تستخدمها webview
لطلبات صفحات الضيوف.
المرتجعات
-
سلسلة
getZoom()
chrome.webviewTag.getZoom(
callback: function,
)
للحصول على عامل التكبير/التصغير الحالي
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(zoomFactor: number) => void
-
zoomFactor
الرقم
عامل التكبير/التصغير الحالي
-
getZoomMode()
chrome.webviewTag.getZoomMode(
callback: function,
)
الحصول على وضع التكبير أو التصغير الحالي
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(ZoomMode: ZoomMode) => void
-
ZoomMode
وضع التكبير أو التصغير الحالي في "
webview
"
-
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
)
للانتقال إلى إدخال سجلّ باستخدام فهرس سجلّ نسبة إلى شريط التنقّل الحالي. في حال كان التنقّل المطلوب مستحيلاً، لن يكون لهذه الطريقة أي تأثير.
المَعلمات
-
relativeIndex
الرقم
فهرس السجلّ النسبي الذي يجب الانتقال إليه
webview
. على سبيل المثال، ستؤدي القيمة2
إلى الانتقال للأمام بين إدخالَي السجلّ إن أمكن، وتنقل القيمة-3
للخلف بمقدار 3 إدخالات. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(success: boolean) => void
-
النجاح
boolean
يشير إلى ما إذا كان التنقل ناجحًا.
-
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
)
إدخال CSS في صفحة الضيف
المَعلمات
-
التفاصيل
تفاصيل خدمة مقارنة الأسعار (CSS) المطلوب إدراجها.
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
)
الاستعلام عمّا إذا كان الصوت مكتومًا أم لا
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(muted: boolean) => void
-
تم كتم الصوت
boolean
-
isSpatialNavigationEnabled()
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
)
طلبات البحث عن تفعيل التنقّل المكاني في WebView
المَعلمات
-
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(enabled: boolean) => void
-
boolean
-
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden()
يشير إلى ما إذا تم إلغاء سلسلة وكيل مستخدم webview
من خلال webviewTag.setUserAgentOverride
أم لا.
loadDataWithBaseUrl()
chrome.webviewTag.loadDataWithBaseUrl(
dataUrl: string,
baseUrl: string,
virtualUrl?: string,
)
تقوم بتحميل عنوان URL الخاص بالبيانات مع عنوان URL أساسي محدد يُستخدم للروابط النسبية. يمكن اختياريًا تقديم عنوان URL افتراضي لعرضه للمستخدم بدلاً من عنوان URL للبيانات.
المَعلمات
-
dataUrl
سلسلة
عنوان URL للبيانات المطلوب تحميله.
-
baseUrl
سلسلة
عنوان URL الأساسي الذي سيتم استخدامه للروابط النسبية.
-
virtualUrl
سلسلة اختيارية
عنوان URL الذي سيتم عرضه للمستخدم (في شريط العناوين).
print()
chrome.webviewTag.print()
طباعة محتوى webview
. يعادل ذلك استدعاء دالة الطباعة النصية من webview
نفسها.
reload()
chrome.webviewTag.reload()
لإعادة تحميل صفحة المستوى الأعلى الحالية.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
يؤدي هذا الإجراء إلى إزالة النصوص البرمجية للمحتوى من webview
.
يزيل المثال التالي قاعدة "myRule" التي تمت إضافتها من قبل.
webview.removeContentScripts(['myRule']);
يمكنك إزالة جميع القواعد عن طريق طلب البيانات التالية:
webview.removeContentScripts();
المَعلمات
-
scriptNameList
سلسلة[] اختيارية
قائمة بأسماء النصوص البرمجية للمحتوى التي ستتم إزالتها. إذا كانت القائمة فارغة، ستتم إزالة جميع النصوص البرمجية للمحتوى التي تمت إضافتها إلى
webview
.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
لضبط حالة كتم الصوت في WebView.
المَعلمات
-
كتم الصوت
boolean
قيمة كتم الصوت
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
)
لضبط حالة التنقّل المكاني في WebView.
المَعلمات
-
boolean
قيمة حالة التنقّل المكاني
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
)
تجاهُل سلسلة وكيل المستخدم المستخدمة في webview
لطلبات صفحات الضيوف. وسيؤدي الإلغاء إلى جعل قيم عنوان "تلميح عميل وكيل المستخدم" والقيم التي يعرضها navigator.userAgentData
فارغة لطلبات صفحات الضيف التي تم تطبيق هذا الإلغاء عليها.
المَعلمات
-
userAgent
سلسلة
سلسلة وكيل المستخدم المطلوب استخدامها
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
)
يغيّر عامل تكبير/تصغير الصفحة. يتم تحديد نطاق هذا التغيير واستمراره من خلال وضع التكبير أو التصغير الحالي في WebView (يُرجى الاطّلاع على webviewTag.ZoomMode
).
المَعلمات
-
zoomFactor
الرقم
عامل التكبير/التصغير الجديد
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
setZoomMode()
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
)
لضبط وضع التكبير أو التصغير في webview
.
المَعلمات
-
ZoomMode
يتم تحديد طريقة التعامل مع التكبير أو التصغير في
webview
. -
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
stop()
chrome.webviewTag.stop()
لإيقاف تحميل شريط التنقّل الحالي في webview
إذا كان قيد التقدم.
stopFinding()
chrome.webviewTag.stopFinding(
action?: "clear"
| "keep"
| "activate"
,
)
يتم إنهاء جلسة البحث الحالية (محو جميع التمييز) وإلغاء جميع طلبات البحث قيد التقدم.
المَعلمات
-
إجراء
اختياري
يُحدِّد الإجراء المطلوب اتخاذه بشأن المطابقة النشطة بعد انتهاء جلسة البحث. سيمحو
clear
التمييز فوق المطابقة النشطة، وسيحافظkeep
على تمييز المطابقة النشطة، بينما سيحافظactivate
على تمييز المطابقة النشطة وسيحاكي نقرة المستخدم على هذه المطابقة. الإجراء التلقائي هوkeep
.
terminate()
chrome.webviewTag.terminate()
يؤدي إلى إيقاف عملية عرض صفحة ويب الضيف بشكل إجباري. قد يؤثر هذا الإجراء في علامات webview
متعدّدة في التطبيق الحالي في حال كانت تحمل العملية نفسها، لكنّه لن يؤثر في علامات webview
في التطبيقات الأخرى.
فعاليات
close
chrome.webviewTag.close.addListener(
callback: function,
)
يتم تنشيطها عندما تحاول نافذة الضيف إغلاق نفسها.
يؤدي الرمز في المثال التالي إلى الانتقال من webview
إلى about:blank
عندما يحاول الضيف إغلاق نفسه.
webview.addEventListener('close', function() {
webview.src = 'about:blank';
});
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:() => void
consolemessage
chrome.webviewTag.consolemessage.addListener(
callback: function,
)
يتم تنشيطها عندما تُسجِّل نافذة الضيف رسالة في وحدة التحكُّم.
يعيد الرمز في المثال التالي توجيه جميع رسائل السجلّ إلى وحدة تحكُّم أداة التضمين بدون مراعاة مستوى السجلّ أو الخصائص الأخرى.
webview.addEventListener('consolemessage', function(e) {
console.log('Guest page logged a message: ', e.message);
});
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
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
على النحو التالي:() => void
dialog
chrome.webviewTag.dialog.addListener(
callback: function,
)
يتم تنشيطها عندما تحاول نافذة الضيف فتح مربّع حوار مشروط باستخدام window.alert
أو window.confirm
أو window.prompt
.
ستؤدي معالجة هذا الحدث إلى حظر عملية الضيف إلى أن يعود كل مستمع للحدث أو إلى أن لا يمكن الوصول إلى عنصر dialog
(إذا تم طلب preventDefault()
).
ويكون السلوك التلقائي هو إلغاء مربّع الحوار.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(messageType: "alert"
| "confirm"
| "prompt"
, messageText: string, dialog: DialogController) => void-
messageType
"alert"
| "confirm"
| "prompt"
-
messageText
سلسلة
-
الاكتشاف الإلكتروني
-
exit
chrome.webviewTag.exit.addListener(
callback: function,
)
يتم تنشيطها عند خروج محتوى الويب للضيوف.
سيعرض الرمز النموذجي التالي رسالة وداع عندما تتعطل صفحة الضيف:
webview.addEventListener('exit', function(e) {
if (e.reason === 'crash') {
webview.src = 'data:text/plain,Goodbye, world!';
}
});
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(processID: number, reason: "normal"
| "abnormal"
| "crash"
| "kill"
) => void-
processID
الرقم
-
السبب
"normal"
| "abnormal"
| "crash"
| "kill"
-
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
يتم تنشيطها عند توفُّر نتائج بحث جديدة لطلب بحث نشط. قد يحدث ذلك عدة مرات في ما يتعلق بطلب بحث واحد عند العثور على نتائج مطابقة.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
-
searchText
سلسلة
-
numberOfMatches
الرقم
-
activeMatchOrdinal
الرقم
-
selectionRect
-
مُلغاة
boolean
-
finalUpdate
سلسلة
-
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
يتم تنشيطها عند إلغاء تحميل عالي المستوى بدون الالتزام. ستتم طباعة رسالة خطأ على وحدة التحكّم ما لم يتم منع الحدث تلقائيًا.
ملاحظة: عند إلغاء تحميل موارد، سيتبع حدث loadabort
في النهاية حدث loadstop
، حتى إذا تم إلغاء جميع عمليات التحميل التي تم تنفيذها منذ آخر حدث loadstop
(إن وُجد).
ملاحظة: عند إلغاء تحميل عنوان URL لصفحة "لمحة" أو عنوان URL بلغة JavaScript، سيتم تنشيط loadabort
ثم سيتم نقل webview
إلى "about:blank".
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(url: string, isTopLevel: boolean, code: number, reason: "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"
) => void-
url
سلسلة
-
isTopLevel
boolean
-
رمز
الرقم
-
السبب
"ERR_ABORTED"
| "ERR_PARTNER_UNREACHABLE"
| "ERR_DISALLOWED_URL_SCHEME"
| "ERR_BLOCKED_BY_CLIENT"
| "ERR_ADDRESS_UNREACHABLE"
| "ERR_ADDRESS_UNREACHABLE"
| " ERR_EMPTY_URL ERR_EMPTY_RESP
-
loadcommit
chrome.webviewTag.loadcommit.addListener(
callback: function,
)
يتم تنشيطها عند تنفيذ عملية تحميل. ويشمل هذا التنقل داخل المستند الحالي بالإضافة إلى عمليات التحميل على مستوى المستند الفرعي، ولكنه لا يتضمن عمليات تحميل الموارد غير المتزامنة.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(url: string, isTopLevel: boolean) => void
-
url
سلسلة
-
isTopLevel
boolean
-
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
يتم تنشيطها عند إعادة توجيه طلب تحميل من المستوى الأعلى إلى عنوان URL مختلف.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
-
oldUrl
سلسلة
-
newUrl
سلسلة
-
isTopLevel
boolean
-
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
يتم تنشيطها عند بدء التحميل.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(url: string, isTopLevel: boolean) => void
-
url
سلسلة
-
isTopLevel
boolean
-
loadstop
chrome.webviewTag.loadstop.addListener(
callback: function,
)
يتم تنشيطها عند اكتمال جميع عمليات التحميل على مستوى الإطار في صفحة الضيف (بما في ذلك كل إطاراتها الفرعية). ويشمل هذا التنقل داخل المستند الحالي بالإضافة إلى عمليات التحميل على مستوى المستند الفرعي، ولكنه لا يتضمن عمليات تحميل الموارد غير المتزامنة. يتم تنشيط هذا الحدث في كل مرة ينتقل فيها عدد عمليات تحميل عمليات التحميل على مستوى المستند من واحد (أو أكثر) إلى صفر. على سبيل المثال، إذا كان قد سبق واكتمل تحميل صفحة (أي loadstop
التي سبق تنشيطها مرة واحدة) إلى إنشاء إطار iframe جديد لتحميل الصفحة، ثم يتم تنشيط loadstop
ثانٍ عند اكتمال تحميل صفحة iframe. ويلاحظ هذا النمط عادةً على الصفحات التي تُحمِّل الإعلانات.
ملاحظة: عند إلغاء عملية التحميل الملتزمة، سيتبع حدث loadstop
حدث loadabort
في نهاية المطاف، حتى إذا تم إلغاء جميع عمليات التحميل الملتزمة منذ آخر حدث loadstop
(إن وُجد).
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
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
على النحو التالي:(window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: "ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
) => void-
نافذة
-
targetUrl
سلسلة
-
initialWidth
الرقم
-
initialHeight
الرقم
-
اسم
سلسلة
-
windowOpenDisposition
"ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
-
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
يتم تنشيطها عندما تحتاج صفحة الضيف إلى طلب إذن خاص من أداة التضمين.
سيمنح الرمز في المثال التالي صفحة الضيف إمكانية الوصول إلى واجهة برمجة تطبيقات webkitGetUserMedia
. وتجدُر الإشارة إلى أنّ التطبيق الذي يستخدم نموذج الرمز هذا يجب أن يحدّد بنفسه أذونات البيان audioCapture
و/أو videoCapture
:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(permission: "media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
, request: object) => void-
permission
"media"
| "geolocation"
| "pointerLock"
| "download"
| "loadextension"
| "filesystem"
| "fullscreen"
| "hid"
-
طلب
عنصر
-
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
على النحو التالي:(processID: number) => void
-
processID
الرقم
-
sizechanged
chrome.webviewTag.sizechanged.addListener(
callback: function,
)
يتم تنشيطها عند تغيير حجم محتوى الويب المضمّن من خلال autosize
. يتم تنشيطها فقط في حال تفعيل "autosize
".
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
-
oldWidth
الرقم
-
oldHeight
الرقم
-
newWidth
الرقم
-
newHeight
الرقم
-
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
يتم تنشيطها عندما تصبح العملية التي تعرض محتوى الويب للضيوف غير مستجيبة. سيتم إنشاء هذا الحدث مرة واحدة مع حدث متجاوب مطابق إذا بدأ الضيف الردّ مرة أخرى.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(processID: number) => void
-
processID
الرقم
-
zoomchange
chrome.webviewTag.zoomchange.addListener(
callback: function,
)
يتم تنشيطها عند تغيير تكبير/تصغير الصفحة.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(oldZoomFactor: number, newZoomFactor: number) => void
-
oldZoomFactor
الرقم
-
newZoomFactor
الرقم
-