Mô tả
Sử dụng thẻ webview
để chủ động tải nội dung trực tiếp từ web qua mạng và nhúng nội dung đó vào Ứng dụng Chrome. Ứng dụng của bạn có thể kiểm soát sự xuất hiện của webview
và tương tác với nội dung web, bắt đầu các thao tác điều hướng trong trang web được nhúng, phản ứng với các sự kiện lỗi xảy ra trong trang web đó và nhiều thao tác khác (xem phần Cách sử dụng).
Quyền
webview
Loại
ClearDataOptions
Các tuỳ chọn xác định dữ liệu nào sẽ bị clearData
xoá.
Thuộc tính
-
từ
số không bắt buộc
Xoá dữ liệu được tích luỹ vào hoặc sau ngày này, được biểu thị bằng mili giây kể từ thời gian bắt đầu của hệ thống (có thể truy cập qua phương thức getTime của đối tượng
Date
JavaScript). Nếu không có, chế độ mặc định sẽ là0
(sẽ xoá tất cả dữ liệu duyệt web).
ClearDataTypeSet
Một tập hợp các loại dữ liệu. Các thuộc tính bị thiếu sẽ được hiểu là false
.
Thuộc tính
-
bộ nhớ đệm của ứng dụng
boolean không bắt buộc
Trang web bộ nhớ đệm ứng dụng.
-
bộ nhớ đệm
boolean không bắt buộc
Chrome 44 trở lênKể từ Chrome 43. Bộ nhớ đệm của trình duyệt. Lưu ý: khi xoá dữ liệu, thao tác này sẽ xoá toàn bộ bộ nhớ đệm; ký tự đó không bị giới hạn ở phạm vi mà bạn chỉ định.
-
cookie
boolean không bắt buộc
Cookie của phân vùng.
-
fileSystems
boolean không bắt buộc
Trang web hệ thống tệp.
-
indexedDB
boolean không bắt buộc
Trang web Dữ liệu IndexedDB.
-
localStorage
boolean không bắt buộc
Trang web dữ liệu lưu trữ cục bộ.
-
persistentCookies
boolean không bắt buộc
Chrome 58 trở lênCookie cố định của phân vùng.
-
sessionCookies
boolean không bắt buộc
Chrome 58 trở lênCookie phiên của phân vùng.
-
webSQL
boolean không bắt buộc
Trang web Dữ liệu WebSQL.
ContentScriptDetails
Chi tiết về tập lệnh nội dung cần chèn. Tham khảo tài liệu về tập lệnh nội dung để biết thêm chi tiết.
Thuộc tính
-
all_frames
boolean không bắt buộc
Nếu
all_frames
làtrue
, điều này có nghĩa là JavaScript hoặc CSS cần được chèn vào tất cả khung của trang hiện tại. Theo mặc định,all_frames
làfalse
và JavaScript hoặc CSS chỉ được chèn vào khung trên cùng. -
css
InjectionItems không bắt buộc
Mã CSS hoặc danh sách các tệp CSS sẽ được chèn vào các trang phù hợp. Các mô-đun này được đưa vào theo thứ tự xuất hiện trước khi bất kỳ DOM nào được xây dựng hoặc hiển thị cho trang đó.
-
exclude_globs
string[] không bắt buộc
Được áp dụng sau khi so khớp để loại trừ những URL khớp với cụm cầu này. Nhằm mô phỏng từ khoá @excluded Grease sao.
-
exclude_matches
string[] không bắt buộc
Không bao gồm các trang mà tập lệnh nội dung này sẽ được chèn vào.
-
include_globs
string[] không bắt buộc
Được áp dụng sau các kết quả trùng khớp để chỉ bao gồm những URL cũng khớp với cụm cầu này. Nhằm mô phỏng từ khoá @include Greasesh.
-
JavaScript
InjectionItems không bắt buộc
Mã JavaScript hoặc danh sách tệp JavaScript sẽ được chèn vào các trang phù hợp. Các biến này được chèn theo thứ tự xuất hiện.
-
match_about_blank
boolean không bắt buộc
Liệu có chèn tập lệnh nội dung vào about:blank và about:srcdoc hay không. Tập lệnh nội dung sẽ chỉ được đưa vào các trang khi URL kế thừa của chúng khớp với một trong các mẫu đã khai báo trong trường so khớp. URL kế thừa là URL của tài liệu đã tạo khung hoặc cửa sổ. Không thể chèn tập lệnh nội dung vào khung hộp cát.
-
khớp với
chuỗi[]
Chỉ định những trang mà tập lệnh nội dung này sẽ được chèn vào.
-
tên
string
Tên của tập lệnh nội dung cần chèn.
-
run_at
RunAt không bắt buộc
Thời điểm sớm nhất mà JavaScript hoặc CSS sẽ được chèn vào thẻ. Giá trị mặc định là "document_idle".
ContentWindow
Ô điều khiển nhắn tin tới cửa sổ khách.
Thuộc tính
-
postMessage
void
Đăng thông báo lên nội dung web được nhúng, miễn là nội dung được nhúng vẫn hiển thị một trang từ nguồn gốc đích. Bạn có thể sử dụng phương thức này sau khi trang tải xong. Theo dõi sự kiện
contentload
rồi gọi phương thức này.Khách có thể gửi tin nhắn trả lời cho người nhúng bằng cách đăng tin nhắn lên
event.source
trong sự kiện tin nhắn mà họ nhận được.API này giống với API HTML5 postMessage để giao tiếp giữa các trang web. Trình nhúng có thể theo dõi các phản hồi bằng cách thêm trình nghe sự kiện
message
vào khung của chính trình nghe đó.Hàm
postMessage
có dạng như sau:(message: any, targetOrigin: string) => {...}
-
tin nhắn
bất kỳ
Đối tượng tin nhắn để gửi cho khách.
-
targetOrigin
string
Chỉ định nguồn gốc của cửa sổ khách để điều phối sự kiện.
-
ContextMenuCreateProperties
Thuộc tính
-
đã chọn
boolean không bắt buộc
Trạng thái ban đầu của hộp đánh dấu hoặc mục radio: true nếu đã chọn và false nếu đã bỏ chọn. Bạn chỉ có thể chọn một mục chọn tại một thời điểm trong một nhóm mục chọn.
-
bối cảnh
[ContextType, ...ContextType[]] không bắt buộc
Danh sách các bối cảnh mà mục này trong trình đơn sẽ xuất hiện. Giá trị mặc định là ['page'] nếu không được chỉ định.
-
documentUrlPatterns
string[] không bắt buộc
Cho phép bạn giới hạn mục để chỉ áp dụng cho các tài liệu có URL khớp với một trong các mẫu cho trước. (Điều này cũng áp dụng cho khung hình.) Để biết thông tin chi tiết về định dạng của mẫu, hãy xem So khớp mẫu.
-
đang bật
boolean không bắt buộc
Liệu mục trình đơn theo bối cảnh này đang bật hay tắt. Giá trị mặc định là
true
. -
id
chuỗi không bắt buộc
Mã nhận dạng duy nhất để gán cho mục này. Bắt buộc đối với các trang sự kiện. Không được giống với một mã khác cho tiện ích này.
-
parentId
string | số không bắt buộc
Mã của một mục trong trình đơn gốc; thao tác này sẽ làm cho mục này trở thành phần tử con của mục đã thêm trước đó.
-
targetUrlPatterns
string[] không bắt buộc
Tương tự như documentUrlPatterns nhưng cho phép bạn lọc dựa trên thuộc tính
src
của thẻ img/audio/video vàhref
của thẻ ký tự liên kết. -
tiêu đề
chuỗi không bắt buộc
Văn bản sẽ xuất hiện trong mặt hàng; đây là bắt buộc trừ khi
type
là "dấu phân cách". Khi ngữ cảnh là "lựa chọn", bạn có thể dùng%s
trong chuỗi để hiện văn bản đã chọn. Ví dụ: nếu giá trị của thông số này là "Dịch '%s' thành Pig Latin" và người dùng chọn từ "tuyệt vời", mục trong trình đơn theo bối cảnh để lựa chọn là "Dịch "tuyệt vời" cho Pig Latin". -
loại
ItemType không bắt buộc
Loại mục trong trình đơn. Giá trị mặc định là "bình thường" nếu không được chỉ định.
-
onclick
khoảng trống không bắt buộc
Một hàm sẽ được gọi lại khi người dùng nhấp vào một mục trong trình đơn.
Hàm
onclick
có dạng như sau:(info: OnClickData) => {...}
-
info
Thông tin về mặt hàng được nhấp vào và bối cảnh nơi xảy ra lượt nhấp.
-
ContextMenus
Thuộc tính
-
onShow
Sự kiện<functionvoidvoid>
Được kích hoạt trước khi hiển thị trình đơn theo bối cảnh trên
webview
này. Bạn có thể dùng để tắt trình đơn theo bối cảnh này bằng cách gọievent.preventDefault()
.Hàm
onShow.addListener
có dạng như sau:(callback: function) => {...}
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(event: object) => void
-
event
đối tượng
-
preventDefault
void
Gọi lệnh này để ngăn hiển thị trình đơn theo bối cảnh.
Hàm
preventDefault
có dạng như sau:() => {...}
-
-
-
-
create
void
Tạo một mục mới trong trình đơn theo bối cảnh. Xin lưu ý rằng nếu xảy ra lỗi trong quá trình tạo, thì bạn có thể không biết được cho đến khi lệnh gọi lại tạo kích hoạt (thông tin chi tiết sẽ có trong
runtime.lastError
).Hàm
create
có dạng như sau:(createProperties: object, callback?: function) => {...}
-
createProperties
đối tượng
Các thuộc tính dùng để tạo mục này
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
-
returns
string | số
Mã của mục mới tạo.
-
-
xoá
void
Xoá một mục trong trình đơn theo bối cảnh.
Hàm
remove
có dạng như sau:(menuItemId: string | number, callback?: function) => {...}
-
string | số
Mã của mục trong trình đơn theo bối cảnh cần xoá.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
-
-
xoáTất cả
void
Xoá tất cả mục trong trình đơn theo bối cảnh đã thêm vào
webview
này.Hàm
removeAll
có dạng như sau:(callback?: function) => {...}
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
-
-
cập nhật
void
Cập nhật một mục trong trình đơn theo bối cảnh đã tạo trước đó.
Hàm
update
có dạng như sau:(id: string | number, updateProperties: object, callback?: function) => {...}
-
id
string | số
Mã của mặt hàng cần cập nhật.
-
updateProperties
đối tượng
Các thuộc tính cần cập nhật. Chấp nhận các giá trị giống với hàm create.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
-
ContextMenuUpdateProperties
Thuộc tính
-
đã chọn
boolean không bắt buộc
Trạng thái của hộp đánh dấu hoặc mục radio: true nếu đã chọn và false nếu đã bỏ chọn. Bạn chỉ có thể chọn một mục chọn tại một thời điểm trong một nhóm mục chọn.
-
bối cảnh
[ContextType, ...ContextType[]] không bắt buộc
Danh sách các bối cảnh mà mục này trong trình đơn sẽ xuất hiện.
-
documentUrlPatterns
string[] không bắt buộc
Cho phép bạn giới hạn mục để chỉ áp dụng cho các tài liệu có URL khớp với một trong các mẫu cho trước. (Điều này cũng áp dụng cho khung hình.) Để biết thông tin chi tiết về định dạng của mẫu, hãy xem So khớp mẫu.
-
đang bật
boolean không bắt buộc
Liệu mục trình đơn theo bối cảnh này đang bật hay tắt.
-
parentId
string | số không bắt buộc
Mã của một mục trong trình đơn gốc; thao tác này sẽ làm cho mục này trở thành phần tử con của mục đã thêm trước đó. Lưu ý: Bạn không thể thay đổi một mục thành phần tử con của một trong các phần tử con của chính mục đó.
-
targetUrlPatterns
string[] không bắt buộc
Tương tự như documentUrlPatterns nhưng cho phép bạn lọc dựa trên thuộc tính
src
của thẻ img/audio/video vàhref
của thẻ ký tự liên kết. -
tiêu đề
chuỗi không bắt buộc
Văn bản sẽ xuất hiện trong mặt hàng
-
loại
ItemType không bắt buộc
Loại mục trong trình đơn.
-
onclick
khoảng trống không bắt buộc
Một hàm sẽ được gọi lại khi người dùng nhấp vào một mục trong trình đơn.
Hàm
onclick
có dạng như sau:(info: OnClickData) => {...}
-
info
Thông tin về mặt hàng được nhấp vào và bối cảnh nơi xảy ra lượt nhấp.
-
ContextType
Các ngữ cảnh khác nhau mà một trình đơn có thể xuất hiện. Chỉ định "tất cả" tương đương với sự kết hợp của tất cả các ngữ cảnh khác.
Enum
"tất cả"
"trang"
"khung"
"selection"
"link"
"chỉnh sửa"
"hình ảnh"
"video"
"audio"
DialogController
Giao diện được đính kèm với dialog
sự kiện DOM.
Thuộc tính
-
hủy
void
Từ chối hộp thoại. Tương đương với việc nhấp vào Huỷ trong hộp thoại
confirm
hoặcprompt
.Hàm
cancel
có dạng như sau:() => {...}
-
ok
void
Chấp nhận hộp thoại. Tương đương với việc nhấp vào OK trong hộp thoại
alert
,confirm
hoặcprompt
.Hàm
ok
có dạng như sau:(response?: string) => {...}
-
phản hồi
chuỗi không bắt buộc
Chuỗi phản hồi cần cung cấp cho khách khi chấp nhận hộp thoại
prompt
.
-
DownloadPermissionRequest
Loại đối tượng request
đi kèm với sự kiện DOM download
permissionrequest
.
Thuộc tính
-
requestMethod
string
Loại yêu cầu HTTP (ví dụ:
GET
) được liên kết với yêu cầu tải xuống. -
url
string
URL tải xuống được yêu cầu.
-
allow
void
Cho phép yêu cầu quyền.
Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi
allow
.Hàm
deny
có dạng như sau:() => {...}
FileSystemPermissionRequest
Loại đối tượng request
đi kèm với sự kiện DOM filesystem
permissionrequest
.
Thuộc tính
-
url
string
URL của khung yêu cầu quyền truy cập vào hệ thống tệp cục bộ.
-
allow
void
Cho phép yêu cầu quyền.
Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền.
Hàm
deny
có dạng như sau:() => {...}
FindCallbackResults
Chứa tất cả kết quả của yêu cầu tìm.
Thuộc tính
-
activeMatchOrdinal
số
Số thứ tự của kết quả trùng khớp hiện tại.
-
đã huỷ
boolean
Cho biết liệu yêu cầu tìm này có bị huỷ hay không.
-
numberOfMatches
số
Số lần
searchText
được khớp trên trang. -
selectionRect
Mô tả một hình chữ nhật xung quanh kết quả trùng khớp chủ động trong toạ độ màn hình.
FindOptions
Các lựa chọn dành cho yêu cầu tìm.
Thuộc tính
-
phía sau
boolean không bắt buộc
Gắn cờ để tìm các kết quả trùng khớp theo thứ tự đảo ngược. Giá trị mặc định là
false
. -
matchCase
boolean không bắt buộc
Gắn cờ để khớp với phân biệt chữ hoa chữ thường. Giá trị mặc định là
false
.
FullscreenPermissionRequest
Loại request
đi kèm với sự kiện DOM fullscreen
permissionrequest
.
Thuộc tính
-
nguồn gốc
string
Nguồn gốc của khung bên trong
webview
đã khởi tạo yêu cầu toàn màn hình. -
allow
void
Cho phép yêu cầu quyền.
Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền.
Hàm
deny
có dạng như sau:() => {...}
GeolocationPermissionRequest
Loại đối tượng request
đi kèm với sự kiện DOM geolocation
permissionrequest
.
Thuộc tính
-
url
string
URL của khung yêu cầu quyền truy cập vào dữ liệu định vị vị trí.
-
allow
void
Cho phép yêu cầu quyền.
Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi
allow
.Hàm
deny
có dạng như sau:() => {...}
HidPermissionRequest
Loại đối tượng request
đi kèm với sự kiện DOM hid
permissionrequest
.
Thuộc tính
-
url
string
URL của khung yêu cầu quyền truy cập vào HID API.
-
allow
void
Cho phép yêu cầu quyền.
Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi
allow
.Hàm
deny
có dạng như sau:() => {...}
InjectDetails
Thông tin chi tiết về tập lệnh hoặc CSS cần chèn. Bạn phải đặt mã hoặc thuộc tính tệp, nhưng không được đặt cả hai mã cùng một lúc.
Thuộc tính
-
mã
chuỗi không bắt buộc
JavaScript hoặc mã CSS cần chèn.
Cảnh báo: Hãy thận trọng khi sử dụng tham số
code
. Việc sử dụng sai cách đoạn mã này có thể khiến ứng dụng của bạn gặp phải các cuộc tấn công tập lệnh trên nhiều trang web. -
tệp
chuỗi không bắt buộc
JavaScript hoặc CSS cần chèn.
InjectionItems
Loại mục chèn: mã hoặc một tập hợp tệp.
Thuộc tính
-
mã
chuỗi không bắt buộc
Mã JavaScript hoặc CSS để chèn vào các trang phù hợp.
-
tệp
string[] không bắt buộc
Danh sách các tệp JavaScript hoặc CSS sẽ được chèn vào các trang phù hợp. Các biến này được chèn theo thứ tự xuất hiện trong mảng này.
LoadPluginPermissionRequest
Loại đối tượng request
đi kèm với sự kiện DOM loadplugin
permissionrequest
.
Thuộc tính
-
giá trị nhận dạng
string
Chuỗi giá trị nhận dạng của trình bổ trợ.
-
tên
string
Tên hiển thị của trình bổ trợ.
-
allow
void
Cho phép yêu cầu quyền. Đây là hành vi mặc định nếu không gọi
deny
.Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền.
Hàm
deny
có dạng như sau:() => {...}
MediaPermissionRequest
Loại đối tượng request
đi kèm với sự kiện DOM media
permissionrequest
.
Thuộc tính
-
url
string
URL của khung yêu cầu quyền truy cập vào nội dung nghe nhìn của người dùng.
-
allow
void
Cho phép yêu cầu quyền.
Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi
allow
.Hàm
deny
có dạng như sau:() => {...}
NewWindow
Giao diện được đính kèm với newwindow
sự kiện DOM.
Thuộc tính
-
đính kèm
void
Đính kèm trang đích được yêu cầu vào một phần tử
webview
hiện có.Hàm
attach
có dạng như sau:(webview: object) => {...}
-
chế độ xem web
đối tượng
Phần tử
webview
cần đính kèm vào trang đích.
-
-
hủy
void
Huỷ yêu cầu về cửa sổ mới.
Hàm
discard
có dạng như sau:() => {...}
PointerLockPermissionRequest
Loại request
đi kèm với sự kiện DOM pointerLock
permissionrequest
.
Thuộc tính
-
lastUnlockedBySelf
boolean
Khung yêu cầu có phải là ứng dụng gần đây nhất có khoá con trỏ hay không.
-
url
string
URL của khung yêu cầu khoá con trỏ.
-
userGesture
boolean
Liệu có yêu cầu khoá con trỏ do cử chỉ nhập của người dùng hay không.
-
allow
void
Cho phép yêu cầu quyền.
Hàm
allow
có dạng như sau:() => {...}
-
từ chối
void
Từ chối yêu cầu cấp quyền. Đây là hành vi mặc định nếu không gọi
allow
.Hàm
deny
có dạng như sau:() => {...}
SelectionRect
Mô tả một hình chữ nhật trong toạ độ màn hình.
Ngữ nghĩa ngăn chặn giống như mảng; tức là toạ độ (left, top)
được coi là nằm trong hình chữ nhật, nhưng toạ độ (left + width, top)
thì không.
Thuộc tính
-
độ cao
số
Chiều cao của hình chữ nhật.
-
trái
số
Khoảng cách từ cạnh trái của màn hình đến cạnh trái của hình chữ nhật.
-
trên cùng
số
Khoảng cách từ cạnh trên của màn hình đến cạnh trên của hình chữ nhật.
-
chiều rộng
số
Chiều rộng của hình chữ nhật.
WebRequestEventInterface
Giao diện cấp quyền truy cập vào các sự kiện webRequest trên trang khách. Xem API tiện ích chrome.webRequest để biết thông tin chi tiết về vòng đời webRequest và các khái niệm có liên quan. Lưu ý: Sự kiện chrome.webRequest.onActionIgnored không được hỗ trợ cho webview.
Để minh hoạ sự khác biệt giữa việc sử dụng và API webRequest của tiện ích, hãy xem xét mã mẫu sau đây giúp chặn mọi yêu cầu của khách đối với các URL khớp với *://www.evil.com/*
:
webview.request.onBeforeRequest.addListener(
function(details) { return {cancel: true}; },
{urls: ["*://www.evil.com/*"]},
["blocking"]);
Ngoài ra, giao diện này hỗ trợ các quy tắc webRequest khai báo thông qua các sự kiện onRequest
và onMessage
. Hãy xem declarativeWebRequest
để biết thông tin chi tiết về API.
Xin lưu ý rằng các điều kiện và hành động cho webRequest khai báo phải được tạo thực thể từ các phiên bản tương ứng trong chrome.webViewRequest.*
. Mã ví dụ sau đây tuyên bố chặn tất cả các yêu cầu đến "example.com"
trên webview myWebview
:
var rule = {
conditions: [
new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
],
actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);
ZoomMode
Xác định cách xử lý thao tác thu phóng trong webview
.
Enum
"mỗi nguồn gốc"
Những thay đổi của tính năng thu phóng sẽ được duy trì trong nguồn gốc của trang được thu phóng, tức là tất cả các webview khác trong cùng một phân vùng được điều hướng đến cùng nguồn gốc đó cũng sẽ được thu phóng. Ngoài ra, các thay đổi về mức thu phóng per-origin
được lưu cùng với nguồn gốc, nghĩa là khi chuyển đến các trang khác ở cùng nguồn gốc, tất cả các trang đó sẽ được thu phóng về cùng một hệ số thu phóng.
"trên mỗi chế độ xem"
Các thay đổi đối với chế độ thu phóng chỉ có hiệu lực trong chế độ xem web này và những thay đổi về chế độ thu phóng trong các chế độ xem web khác sẽ không ảnh hưởng đến việc thu phóng của chế độ xem web này. Ngoài ra, những thay đổi về mức thu phóng của per-view
sẽ được đặt lại trong quá trình điều hướng; việc di chuyển trong một chế độ xem web sẽ luôn tải trang có hệ số thu phóng trên mỗi nguồn gốc (trong phạm vi của phân vùng).
"disabled"
Tắt tất cả tính năng thu phóng trong chế độ xem web. Nội dung sẽ quay về mức thu phóng mặc định và mọi thay đổi mà bạn thực hiện để thu phóng sẽ bị bỏ qua.
Thuộc tính
contentWindow
Tham chiếu đối tượng có thể dùng để đăng thông báo lên trang khách.
Loại
contextMenus
Tương tự như API ContextMenus của Chrome, nhưng áp dụng cho webview
thay vì trình duyệt. Dùng API webview.contextMenus
để thêm mục vào trình đơn theo bối cảnh của webview
. Bạn có thể chọn loại đối tượng mà phần bổ sung của trình đơn theo bối cảnh sẽ áp dụng, chẳng hạn như hình ảnh, siêu liên kết và trang.
Loại
request
Giao diện cấp quyền truy cập vào các sự kiện webRequest trên trang khách.
Phương thức
addContentScripts()
chrome.webviewTag.addContentScripts(
contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
Thêm quy tắc chèn tập lệnh nội dung vào webview
. Khi webview
chuyển đến một trang phù hợp với một hoặc nhiều quy tắc, thì các tập lệnh liên quan sẽ được đưa vào. Bạn có thể lập trình để thêm quy tắc hoặc cập nhật quy tắc hiện có.
Ví dụ sau sẽ thêm hai quy tắc vào webview
: 'myRule' và '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';
Bạn có thể trì hoãn lệnh gọi addContentScripts cho đến khi cần chèn các tập lệnh.
Ví dụ sau đây trình bày cách ghi đè quy tắc hiện có.
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'}]);
Nếu webview
đã được điều hướng đến nguồn gốc (ví dụ: foo.com) và gọi webview.addContentScripts
để thêm "myRule", thì bạn cần phải đợi thao tác điều hướng tiếp theo để các tập lệnh được chèn. Nếu bạn muốn chèn ngay lập tức, executeScript
sẽ hoạt động đúng cách.
Các quy tắc được giữ nguyên ngay cả khi quy trình khách gặp sự cố hoặc bị tắt hay ngay cả khi webview
được gán lại cấp độ gốc.
Tham khảo tài liệu về tập lệnh nội dung để biết thêm chi tiết.
Tham số
-
contentScriptList
Thông tin chi tiết về các tập lệnh nội dung cần thêm.
back()
chrome.webviewTag.back(
callback?: function,
)
Di chuyển lùi lại một mục nhật ký nếu có thể. Tương đương với go(-1)
.
Tham số
-
số gọi lại
hàm không bắt buộc
Chrome 44 trở lênTham số
callback
sẽ có dạng như sau:(success: boolean) => void
-
thành công
boolean
Cho biết liệu quá trình điều hướng có thành công hay không.
-
canGoBack()
chrome.webviewTag.canGoBack()
Cho biết liệu có thể di chuyển ngược lại thông qua nhật ký hay không. Trạng thái của hàm này được lưu vào bộ nhớ đệm và cập nhật trước mỗi loadcommit
, vì vậy, vị trí tốt nhất để gọi hàm này là trên loadcommit
.
Giá trị trả về
-
boolean
canGoForward()
chrome.webviewTag.canGoForward()
Cho biết có thể điều hướng tiếp theo trong lịch sử hay không. Trạng thái của hàm này được lưu vào bộ nhớ đệm và cập nhật trước mỗi loadcommit
, vì vậy, vị trí tốt nhất để gọi hàm này là trên loadcommit
.
Giá trị trả về
-
boolean
captureVisibleRegion()
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
Chụp khu vực hiển thị của chế độ xem web.
Tham số
-
tùy chọn
ImageDetails không bắt buộc
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(dataUrl: string) => void
-
dataUrl
string
Một URL dữ liệu mã hoá hình ảnh của khu vực hiển thị của thẻ được chụp. Có thể được chỉ định cho thuộc tính "src" thuộc tính của phần tử Hình ảnh HTML để hiển thị.
-
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
Xoá dữ liệu duyệt web cho phân vùng webview
.
Tham số
-
tùy chọn
Các tuỳ chọn xác định dữ liệu cần xoá.
-
loại
Loại dữ liệu cần xoá.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
Chèn mã JavaScript vào trang khách.
Mã mẫu sau đây dùng tính năng chèn tập lệnh để đặt màu nền của trang khách thành màu đỏ:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
Tham số
-
chi tiết
Thông tin chi tiết về tập lệnh cần chạy.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(result?: any[]) => void
-
kết quả
bất kỳ[] không bắt buộc
Kết quả của tập lệnh trong mỗi khung được chèn.
-
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
)
Khởi tạo yêu cầu tìm trong trang.
Tham số
-
searchText
string
Chuỗi cần tìm trong trang.
-
tùy chọn
FindOptions không bắt buộc
Các lựa chọn dành cho yêu cầu tìm.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(results?: FindCallbackResults) => void
-
kết quả
FindCallbackResults không bắt buộc
Chứa tất cả kết quả của yêu cầu tìm. Bạn có thể bỏ qua
results
nếu không dùng hàm này trong phần nội dung của hàm callback; ví dụ: nếu lệnh gọi lại chỉ được dùng để xác định thời điểm yêu cầu tìm đã hoàn tất.
-
forward()
chrome.webviewTag.forward(
callback?: function,
)
Di chuyển tiến tới một mục nhật ký nếu có thể. Tương đương với go(1)
.
Tham số
-
số gọi lại
hàm không bắt buộc
Chrome 44 trở lênTham số
callback
sẽ có dạng như sau:(success: boolean) => void
-
thành công
boolean
Cho biết liệu quá trình điều hướng có thành công hay không.
-
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
)
Trạng thái âm thanh của cụm từ tìm kiếm.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(audible: boolean) => void
-
audible
boolean
-
getProcessId()
chrome.webviewTag.getProcessId()
Trả về mã quy trình nội bộ của Chrome cho quy trình hiện tại của trang web khách, cho phép người nhúng biết số lượng khách sẽ bị ảnh hưởng khi chấm dứt quá trình. Hai khách sẽ chỉ chia sẻ một quy trình nếu họ thuộc cùng một ứng dụng và có cùng mã phân vùng bộ nhớ. Lệnh gọi này có tính đồng bộ và trả về khái niệm đã lưu vào bộ nhớ đệm của người nhúng về mã nhận dạng tiến trình hiện tại. Mã tiến trình không giống với mã tiến trình của hệ điều hành.
Giá trị trả về
-
số
getUserAgent()
chrome.webviewTag.getUserAgent()
Trả về chuỗi tác nhân người dùng mà webview
sử dụng cho các yêu cầu trên trang khách.
Giá trị trả về
-
string
getZoom()
chrome.webviewTag.getZoom(
callback: function,
)
Lấy hệ số thu phóng hiện tại.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(zoomFactor: number) => void
-
zoomFactor
số
Hệ số thu phóng hiện tại.
-
getZoomMode()
chrome.webviewTag.getZoomMode(
callback: function,
)
Xem chế độ thu phóng hiện tại.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(ZoomMode: ZoomMode) => void
-
ZoomMode
Chế độ thu phóng hiện tại của
webview
.
-
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
)
Chuyển đến một mục nhật ký bằng chỉ mục nhật ký so với bảng điều hướng hiện tại. Nếu không thể điều hướng đã yêu cầu, thì phương thức này sẽ không có hiệu lực.
Tham số
-
relativeIndex
số
Chỉ mục nhật ký tương đối mà
webview
nên được điều hướng đến. Ví dụ: giá trị của2
sẽ điều hướng tiến 2 mục nhập nhật ký nếu có thể; giá trị-3
sẽ điều hướng lùi lại 3 mục nhập. -
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(success: boolean) => void
-
thành công
boolean
Cho biết liệu quá trình điều hướng có thành công hay không.
-
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
)
Chèn CSS vào trang khách.
Tham số
-
chi tiết
Thông tin chi tiết về CSS cần chèn.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
)
Truy vấn xem âm thanh có bị tắt tiếng hay không.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(muted: boolean) => void
-
đã tắt tiếng
boolean
-
isSpatialNavigationEnabled()
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
)
Truy vấn xem bạn có bật tính năng điều hướng theo không gian cho WebView hay không.
Tham số
-
hàm
Tham số
callback
sẽ có dạng như sau:(enabled: boolean) => void
-
boolean
-
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden()
Cho biết liệu chuỗi tác nhân người dùng của webview
có bị webviewTag.setUserAgentOverride
ghi đè hay không.
loadDataWithBaseUrl()
chrome.webviewTag.loadDataWithBaseUrl(
dataUrl: string,
baseUrl: string,
virtualUrl?: string,
)
Tải một URL dữ liệu có URL cơ sở cụ thể dùng cho đường liên kết tương đối. Nếu muốn, bạn có thể cung cấp một URL ảo để người dùng thấy được thay vì URL dữ liệu.
Tham số
-
dataUrl
string
URL dữ liệu cần tải.
-
baseUrl
string
URL cơ sở sẽ dùng cho đường liên kết tương đối.
-
virtualUrl
chuỗi không bắt buộc
URL mà người dùng sẽ nhìn thấy (trong thanh địa chỉ).
print()
chrome.webviewTag.print()
In nội dung của webview
. Điều này tương đương với việc gọi hàm in theo tập lệnh qua chính webview
.
reload()
chrome.webviewTag.reload()
Tải lại trang cấp cao nhất hiện tại.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
Xoá tập lệnh nội dung khỏi webview
.
Ví dụ sau đây xóa "myRule" đã được thêm trước đó.
webview.removeContentScripts(['myRule']);
Bạn có thể xoá tất cả quy tắc bằng cách gọi:
webview.removeContentScripts();
Tham số
-
scriptNameList
string[] không bắt buộc
Danh sách tên của các tập lệnh nội dung sẽ bị xoá. Nếu danh sách này trống thì mọi tập lệnh nội dung đã thêm vào
webview
đều sẽ bị xoá.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
Đặt trạng thái tắt âm thanh của chế độ xem web.
Tham số
-
tắt tiếng
boolean
Tắt tiếng giá trị âm thanh
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
)
Đặt trạng thái điều hướng không gian của chế độ xem web.
Tham số
-
boolean
Giá trị trạng thái điều hướng không gian.
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
)
Ghi đè chuỗi tác nhân người dùng mà webview
sử dụng cho các yêu cầu trên trang khách. Việc ghi đè sẽ khiến các giá trị tiêu đề Gợi ý ứng dụng tác nhân người dùng và các giá trị do navigator.userAgentData
trả về bị trống đối với các yêu cầu trang khách mà cơ chế ghi đè này sẽ được áp dụng.
Tham số
-
userAgent
string
Chuỗi tác nhân người dùng cần sử dụng.
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
)
Thay đổi hệ số thu phóng của trang. Phạm vi và khả năng duy trì của thay đổi này là do chế độ thu phóng hiện tại của chế độ xem web xác định (xem webviewTag.ZoomMode
).
Tham số
-
zoomFactor
số
Hệ số thu phóng mới.
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
setZoomMode()
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
)
Thiết lập chế độ thu phóng của webview
.
Tham số
-
ZoomMode
Xác định cách xử lý thao tác thu phóng trong
webview
. -
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:() => void
stop()
chrome.webviewTag.stop()
Dừng tải quá trình điều hướng webview
hiện tại nếu đang diễn ra.
stopFinding()
chrome.webviewTag.stopFinding(
action?: "clear"
| "keep"
| "activate"
,
)
Kết thúc phiên tìm hiện tại (xoá tất cả nội dung được đánh dấu) và huỷ tất cả các yêu cầu tìm đang thực hiện.
Tham số
-
hành động
"xoá"
| "keep"
| "kích hoạt"
không bắt buộcXác định việc cần làm với kết quả trùng khớp đang diễn ra sau khi phiên tìm kiếm kết thúc.
clear
sẽ xoá phần đánh dấu nội dung được đánh dấu trong trận đấu đang diễn ra;keep
sẽ làm nổi bật kết quả trùng khớp đang hoạt động;activate
sẽ làm nổi bật kết quả trùng khớp đang hoạt động và mô phỏng hoạt động nhấp của người dùng vào kết quả trùng khớp đó. Thao tác mặc định làkeep
.
terminate()
chrome.webviewTag.terminate()
Buộc tắt quy trình kết xuất đồ hoạ của trang web khách. Việc này có thể ảnh hưởng đến nhiều thẻ webview
trong ứng dụng hiện tại nếu các thẻ đó áp dụng cùng một quy trình, nhưng sẽ không ảnh hưởng đến các thẻ webview
trong các ứng dụng khác.
Sự kiện
close
chrome.webviewTag.close.addListener(
callback: function,
)
Được kích hoạt khi cửa sổ khách cố gắng tự đóng.
Mã ví dụ sau đây điều hướng webview
đến about:blank
khi khách cố gắng tự đóng.
webview.addEventListener('close', function() {
webview.src = 'about:blank';
});
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:() => void
consolemessage
chrome.webviewTag.consolemessage.addListener(
callback: function,
)
Được kích hoạt khi cửa sổ khách ghi lại thông báo trên bảng điều khiển.
Mã ví dụ sau đây chuyển tiếp tất cả thông điệp nhật ký đến bảng điều khiển của người nhúng mà không quan tâm đến cấp độ nhật ký hoặc các thuộc tính khác.
webview.addEventListener('consolemessage', function(e) {
console.log('Guest page logged a message: ', e.message);
});
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(level: number, message: string, line: number, sourceId: string) => void
-
cấp lần truy cập,
số
-
tin nhắn
string
-
dòng
số
-
sourceId
string
-
contentload
chrome.webviewTag.contentload.addListener(
callback: function,
)
Được kích hoạt khi cửa sổ khách kích hoạt một sự kiện load
, tức là khi tài liệu mới được tải. Thao tác này không bao gồm thao tác điều hướng trang trong tài liệu hiện tại hoặc các lượt tải tài nguyên không đồng bộ.
Mã ví dụ sau đây sửa đổi kích thước phông chữ mặc định của phần tử body
của khách sau khi tải trang:
webview.addEventListener('contentload', function() {
webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:() => void
dialog
chrome.webviewTag.dialog.addListener(
callback: function,
)
Được kích hoạt khi cửa sổ khách cố gắng mở hộp thoại phương thức qua window.alert
, window.confirm
hoặc window.prompt
.
Việc xử lý sự kiện này sẽ chặn quy trình khách cho đến khi từng trình nghe sự kiện trả về hoặc đối tượng dialog
không thể truy cập được (nếu preventDefault()
được gọi).
Hành vi mặc định là huỷ hộp thoại.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(messageType: "alert"
| "confirm"
| "prompt"
, messageText: string, dialog: DialogController) => void-
messageType
"cảnh báo"
| "xác nhận"
| "prompt"
-
messageText
string
-
hộp thoại
-
exit
chrome.webviewTag.exit.addListener(
callback: function,
)
Được kích hoạt khi quá trình kết xuất nội dung web khách đã thoát.
Mã ví dụ sau đây sẽ hiển thị thông báo tạm biệt bất cứ khi nào trang khách gặp sự cố:
webview.addEventListener('exit', function(e) {
if (e.reason === 'crash') {
webview.src = 'data:text/plain,Goodbye, world!';
}
});
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(processID: number, reason: "normal"
| "abnormal"
| "crash"
| "kill"
) => void-
processID
số
-
lý do
"bình thường"
| "bất thường"
| "sự cố"
| "giết"
-
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
Được kích hoạt khi có kết quả tìm kiếm mới cho một yêu cầu tìm đang hoạt động. Điều này có thể xảy ra nhiều lần cho một yêu cầu tìm khi hệ thống tìm thấy kết quả trùng khớp.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
-
searchText
string
-
numberOfMatches
số
-
activeMatchOrdinal
số
-
selectionRect
-
đã huỷ
boolean
-
finalUpdate
string
-
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
Được kích hoạt khi tải cấp cao nhất bị huỷ mà không thực hiện. Một thông báo lỗi sẽ được in trên bảng điều khiển trừ phi sự kiện đó được ngăn chặn theo mặc định.
Lưu ý: Khi tải tài nguyên bị huỷ, sự kiện loadabort
cuối cùng sẽ được theo sau bởi một sự kiện loadstop
, ngay cả khi tất cả lượt tải được cam kết kể từ sự kiện loadstop
gần đây nhất (nếu có) đã bị huỷ.
Lưu ý: Khi việc tải URL giới thiệu hoặc URL JavaScript bị huỷ, loadabort
sẽ được kích hoạt và sau đó, webview
sẽ được điều hướng đến "about:blank".
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(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
string
-
isTopLevel
boolean
-
mã
số
-
lý do
"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"
-
loadcommit
chrome.webviewTag.loadcommit.addListener(
callback: function,
)
Được kích hoạt khi đã thực hiện tải. Điều này bao gồm việc điều hướng trong tài liệu hiện tại cũng như các lần tải ở cấp tài liệu khung phụ, nhưng không bao gồm các lần tải tài nguyên không đồng bộ.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(url: string, isTopLevel: boolean) => void
-
url
string
-
isTopLevel
boolean
-
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
Được kích hoạt khi yêu cầu tải cấp cao nhất chuyển hướng đến một URL khác.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
-
oldUrl
string
-
newUrl
string
-
isTopLevel
boolean
-
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
Được kích hoạt khi quá trình tải bắt đầu.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(url: string, isTopLevel: boolean) => void
-
url
string
-
isTopLevel
boolean
-
loadstop
chrome.webviewTag.loadstop.addListener(
callback: function,
)
Được kích hoạt khi tất cả lượt tải ở cấp khung hình trong một trang khách (bao gồm tất cả các khung phụ của trang đó) đã hoàn tất. Điều này bao gồm việc điều hướng trong tài liệu hiện tại cũng như các lần tải ở cấp tài liệu khung phụ, nhưng không bao gồm các lần tải tài nguyên không đồng bộ. Sự kiện này kích hoạt mỗi khi số lượt tải ở cấp tài liệu chuyển đổi từ 1 (hoặc nhiều) sang 0. Ví dụ: nếu một trang đã tải xong (tức là loadstop
đã được kích hoạt một lần) tạo iframe mới tải trang, sau đó loadstop
thứ hai sẽ kích hoạt khi tải trang iframe hoàn tất. Mẫu này thường thấy trên các trang tải quảng cáo.
Lưu ý: Khi một lượt tải cam kết bị huỷ, sự kiện loadstop
sẽ diễn ra sau sự kiện loadabort
, ngay cả khi tất cả lượt tải đã cam kết kể từ sự kiện loadstop
gần đây nhất (nếu có) đã bị huỷ.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:() => void
newwindow
chrome.webviewTag.newwindow.addListener(
callback: function,
)
Được kích hoạt khi trang khách cố mở một cửa sổ trình duyệt mới.
Mã ví dụ sau đây sẽ tạo và điều hướng một webview
mới trong trình nhúng cho mỗi cửa sổ mới được yêu cầu:
webview.addEventListener('newwindow', function(e) {
var newWebview = document.createElement('webview');
document.body.appendChild(newWebview);
e.window.attach(newWebview);
});
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(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-
cửa sổ
-
targetUrl
string
-
initialWidth
số
-
initialHeight
số
-
tên
string
-
windowOpenDisposition
"bỏ qua"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_ tạm thời"
-
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
Được kích hoạt khi trang khách cần yêu cầu quyền đặc biệt từ người nhúng.
Mã ví dụ sau đây sẽ cấp quyền truy cập vào API webkitGetUserMedia
cho trang khách. Xin lưu ý rằng ứng dụng sử dụng mã ví dụ này phải tự chỉ định các quyền audioCapture
và/hoặc videoCapture
trong tệp kê khai:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(permission: "media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
, request: object) => void-
quyền
"media"
| "vị trí địa lý"
| "pointerLock"
| "tải xuống"
| "loadplugin"
| "hệ thống tệp"
| "toàn màn hình"
| "ẩn"
-
request
đối tượng
-
responsive
chrome.webviewTag.responsive.addListener(
callback: function,
)
Được kích hoạt khi quá trình hiển thị nội dung web khách đã trở lại phản hồi sau khi không phản hồi.
Mã ví dụ sau đây sẽ làm mờ hoặc mờ dần phần tử webview
khi phần tử này trở nên thích ứng hoặc không phản hồi:
webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
webview.style.opacity = '1';
});
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(processID: number) => void
-
processID
số
-
sizechanged
chrome.webviewTag.sizechanged.addListener(
callback: function,
)
Được kích hoạt khi nội dung web được nhúng được đổi kích thước thông qua autosize
. Chỉ kích hoạt nếu autosize
được bật.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
-
oldWidth
số
-
oldHeight
số
-
newWidth
số
-
newHeight
số
-
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
Được kích hoạt khi quá trình kết xuất nội dung web khách không phản hồi. Sự kiện này sẽ được tạo một lần bằng một sự kiện thích ứng phù hợp nếu khách bắt đầu trả lời lại.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(processID: number) => void
-
processID
số
-
zoomchange
chrome.webviewTag.zoomchange.addListener(
callback: function,
)
Được kích hoạt khi mức thu phóng của trang thay đổi.
Tham số
-
số gọi lại
hàm
Tham số
callback
sẽ có dạng như sau:(oldZoomFactor: number, newZoomFactor: number) => void
-
oldZoomFactor
số
-
newZoomFactor
số
-