Opis
Używaj tagu webview
, aby aktywnie wczytywać treści opublikowane z internetu przez sieć i umieścić je w aplikacji Chrome. Aplikacja może kontrolować wygląd interfejsu webview
, wchodzić w interakcje z treściami internetowymi, inicjować nawigację na umieszczonej stronie internetowej oraz reagować na występujące w niej zdarzenia błędów (patrz Użycie).
Uprawnienia
webview
Typy
ClearDataOptions
Opcje określające, które dane powinny zostać wyczyszczone przez clearData
.
Właściwości
-
od
liczba opcjonalnie
Wyczyść dane zgromadzone w tym dniu lub później, wyrażone w milisekundach od początku epoki (dostępne za pomocą metody getTime obiektu JavaScript
Date
). Jeśli nie określono tego atrybutu, domyślnie przyjmuje on wartość0
(co powoduje usunięcie wszystkich danych przeglądania).
ClearDataTypeSet
Zbiór typów danych. Brakujące właściwości są interpretowane jako false
.
Właściwości
-
pamięć podręczna aplikacji
Wartość logiczna opcjonalna
Witryny pamięci podręcznej aplikacji.
-
Pamięć podręczna
Wartość logiczna opcjonalna
Chrome w wersji 44 lub nowszej .Od wersji Chrome 43. Pamięć podręczna przeglądarki. Uwaga: usunięcie danych powoduje wyczyszczenie całej pamięci podręcznej. nie jest ograniczony do wskazanego przez Ciebie zakresu.
-
ciastka
Wartość logiczna opcjonalna
Pliki cookie partycji.
-
fileSystems
Wartość logiczna opcjonalna
Witryny systemów plików.
-
indexedDB
Wartość logiczna opcjonalna
Witryny Dane IndexedDB.
-
localStorage
Wartość logiczna opcjonalna
Witryny pamięci lokalnej.
-
persistentCookies
Wartość logiczna opcjonalna
Chrome w wersji 58 lub nowszej .Trwałe pliki cookie partycji.
-
sessionCookies
Wartość logiczna opcjonalna
Chrome w wersji 58 lub nowszej .Pliki cookie sesji partycji.
-
webSQL
Wartość logiczna opcjonalna
Witryny danych WebSQL.
ContentScriptDetails
Szczegóły skryptu treści do wstawienia. Więcej informacji znajdziesz w dokumentacji skryptów treści.
Właściwości
-
all_frames
Wartość logiczna opcjonalna
Jeśli
all_frames
totrue
, oznacza to, że we wszystkich ramkach bieżącej strony należy wstawić JavaScript lub CSS. Domyślnieall_frames
tofalse
, a JavaScript lub CSS jest wstrzykiwany tylko w górnej ramce. -
css
Opcjonalny InjectionItems
Kod CSS lub lista plików CSS do wstrzykiwania na pasujących stronach. Są one wstrzykiwane w kolejności, w jakiej występują, przed utworzeniem lub wyświetleniem DOM strony.
-
exclude_globs
string[] opcjonalnie
Stosowane po dopasowaniu, aby wykluczyć adresy URL pasujące do tego glob. Służy do emulacji słowa kluczowego @excluded Greasemonkey.
-
exclude_matches
string[] opcjonalnie
Nie obejmuje stron, na których ten skrypt treści zostałby wstrzykiwany.
-
include_globs
string[] opcjonalnie
Jest stosowana po dopasowaniu, aby uwzględnić tylko te adresy URL, które również pasują do tego glob. Służy do emulacji słowa kluczowego @include Greasemonkey.
-
JS
Opcjonalny InjectionItems
Kod JavaScript lub lista plików JavaScript do wstrzykiwania na pasujących stronach. Są one wstrzykiwane w kolejności, w jakiej się pojawiają.
-
match_about_blank
Wartość logiczna opcjonalna
Określa, czy skrypt dotyczący treści ma być wstawiony w parametrach about:blank i about:srcdoc. Skrypty treści będą wstrzykiwane na stronach tylko wtedy, gdy ich dziedziczony adres URL zostanie dopasowany do jednego z zadeklarowanych wzorców w polu dopasowań. Dziedziczony URL to adres URL dokumentu, w którym ramka lub okno zostało utworzone. Nie można wstawiać skryptów treści w ramkach piaskownicy.
-
pasuje do
ciąg znaków[]
Określa strony, na których ten skrypt treści będzie wstrzykiwany.
-
nazwa
ciąg znaków
Nazwa skryptu treści do wstawienia.
-
run_at
Opcjonalnie RunAt
Najszybszym wstrzykiwaniem kodu JavaScript lub CSS do karty. Domyślna wartość to „document_idle”.
ContentWindow
Uchwyt wiadomości do okna gościa.
Właściwości
-
postMessage
nieważne
Publikuje wiadomość w umieszczonej treści internetowej, o ile tylko wyświetla ona stronę z docelowego źródła. Ta metoda jest dostępna po zakończeniu wczytywania strony. Wykryj zdarzenie
contentload
, a następnie wywołaj metodę.Gość będzie mógł wysyłać odpowiedzi do umieszczonej treści, publikując wiadomość na adres
event.source
w otrzymanym wydarzeniu.Ten interfejs API nie różni się od interfejsu HTML5 postMessage API do komunikacji między stronami internetowymi. Umieszczający kod może nasłuchiwać odpowiedzi, dodając do własnej ramki detektor zdarzeń
message
.Funkcja
postMessage
wygląda tak:(message: any, targetOrigin: string) => {...}
-
wiadomość
każdy
Obiekt wiadomości do wysłania do gościa.
-
targetOrigin
ciąg znaków
Określa, jakie musi być źródło okna gościa, aby można było wysłać zdarzenie.
-
ContextMenuCreateProperties
Właściwości
-
zaznaczono
Wartość logiczna opcjonalna
Początkowy stan pola wyboru lub elementu opcji: true (prawda) w przypadku zaznaczonych elementów i fałsz – jeśli nie są zaznaczone. W danej grupie elementów radiowych można w danym momencie wybrać tylko 1 element opcji.
-
konteksty
[ContextType, ...ContextType[]] opcjonalny
Lista kontekstów, w których będzie się wyświetlać ten element menu. Jeśli nie zostanie podany, domyślna wartość to ['strona'].
-
documentUrlPatterns
string[] opcjonalnie
Pozwala ograniczyć zastosowanie elementu tylko do dokumentów, których adres URL pasuje do jednego z podanych wzorców. (Dotyczy to również ramek). Szczegółowe informacje o formacie wzorca znajdziesz w artykule Wzorce dopasowania.
-
włączone
Wartość logiczna opcjonalna
Określa, czy ta pozycja menu kontekstowego jest włączona czy wyłączona. Domyślna wartość to
true
. -
id
ciąg znaków opcjonalny
Unikalny identyfikator do przypisania do tego elementu. Obowiązkowy na stronach wydarzeń. Nie może być taki sam jak inny identyfikator tego rozszerzenia.
-
parentId
string | liczba opcjonalnie
identyfikator nadrzędnej pozycji menu; element ten staje się elementem podrzędnym elementu dodanego wcześniej.
-
targetUrlPatterns
string[] opcjonalnie
Działa podobnie do documentUrlPatterns, ale pozwala filtrować na podstawie atrybutu
src
tagów img/audio/video ihref
tagów kotwicy. -
tytuł
ciąg znaków opcjonalny
Tekst do wyświetlenia w produkcie. jest wymagany, chyba że „
type
” jest „separatorem”. Gdy kontekst to „wybór”, możesz użyć w ciągu znaków%s
, aby wyświetlić zaznaczony tekst. Jeśli na przykład wartość tego parametru to „Przetłumacz '%s” po „Pig Latin” a użytkownik wybiera słowo „świetne”, co zostaje w menu kontekstowym jako „Przetłumacz „świetne” Pig Latin”. -
typ
Opcjonalny ItemType
Typ elementu menu. Domyślna wartość to „normal” jeśli nie określono żadnej wartości.
-
Kliknij
void opcjonalnie
Funkcja, która jest wywoływana po kliknięciu elementu menu.
Funkcja
onclick
wygląda tak:(info: OnClickData) => {...}
-
informacje
Informacje o klikniętym produkcie i kontekście kliknięcia.
-
ContextMenus
Właściwości
-
onShow
Zdarzenie<functionvoid>
Uruchamiane przed wyświetleniem menu kontekstowego w:
webview
. Można użyć do wyłączenia tego menu kontekstowego, wywołując funkcjęevent.preventDefault()
.Funkcja
onShow.addListener
wygląda tak:(callback: function) => {...}
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(event: object) => void
-
event
Obiekt
-
preventDefault
nieważne
Wywołuj je, by zapobiec wyświetlaniu menu kontekstowego.
Funkcja
preventDefault
wygląda tak:() => {...}
-
-
-
-
utwórz
nieważne
Tworzy nową pozycję w menu kontekstowym. Pamiętaj, że jeśli podczas tworzenia wystąpi błąd, możesz nie wiedzieć, dopóki nie uruchomi się wywołanie zwrotne tworzenia (szczegóły znajdziesz w
runtime.lastError
).Funkcja
create
wygląda tak:(createProperties: object, callback?: function) => {...}
-
createProperties
Obiekt
Właściwości użyte do utworzenia elementu
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
-
returns
string | numer
Identyfikator nowo utworzonego elementu.
-
-
usuń
nieważne
Usuwa pozycję menu kontekstowego.
Funkcja
remove
wygląda tak:(menuItemId: string | number, callback?: function) => {...}
-
string | numer
Identyfikator elementu menu kontekstowego, który ma zostać usunięty.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
-
-
usuń wszystko
nieważne
Usuwa wszystkie pozycje menu kontekstowego dodane do tego elementu (
webview
).Funkcja
removeAll
wygląda tak:(callback?: function) => {...}
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
-
-
update
nieważne
Aktualizuje wcześniej utworzony element menu kontekstowego.
Funkcja
update
wygląda tak:(id: string | number, updateProperties: object, callback?: function) => {...}
-
id
string | numer
Identyfikator elementu do zaktualizowania.
-
updateProperties
Obiekt
Właściwości do zaktualizowania. Akceptuje te same wartości co funkcja tworzenia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
-
ContextMenuUpdateProperties
Właściwości
-
zaznaczono
Wartość logiczna opcjonalna
Stan pola wyboru lub opcji: true (prawda) – zaznaczone, i fałsz – niezaznaczone. W danej grupie elementów radiowych można w danym momencie wybrać tylko 1 element opcji.
-
konteksty
[ContextType, ...ContextType[]] opcjonalny
Lista kontekstów, w których będzie się wyświetlać ten element menu.
-
documentUrlPatterns
string[] opcjonalnie
Pozwala ograniczyć zastosowanie elementu tylko do dokumentów, których adres URL pasuje do jednego z podanych wzorców. (Dotyczy to również ramek). Szczegółowe informacje o formacie wzorca znajdziesz w artykule Wzorce dopasowania.
-
włączone
Wartość logiczna opcjonalna
Określa, czy ta pozycja menu kontekstowego jest włączona czy wyłączona.
-
parentId
string | liczba opcjonalnie
identyfikator nadrzędnej pozycji menu; element ten staje się elementem podrzędnym elementu dodanego wcześniej. Uwaga: nie możesz zmienić elementu na element podrzędny jednego z jego elementów podrzędnych.
-
targetUrlPatterns
string[] opcjonalnie
Działa podobnie do documentUrlPatterns, ale pozwala filtrować na podstawie atrybutu
src
tagów img/audio/video ihref
tagów kotwicy. -
tytuł
ciąg znaków opcjonalny
Tekst do wyświetlenia w elemencie
-
typ
Opcjonalny ItemType
Typ elementu menu.
-
Kliknij
void opcjonalnie
Funkcja, która jest wywoływana po kliknięciu elementu menu.
Funkcja
onclick
wygląda tak:(info: OnClickData) => {...}
-
informacje
Informacje o klikniętym produkcie i kontekście kliknięcia.
-
ContextType
w różnych kontekstach, w których może się pojawiać menu; Określanie wszystkich jest odpowiednikiem kombinacji wszystkich innych kontekstów.
Typ wyliczeniowy
"all"
"strona"
"frame"
"selection"
"link"
"edycja"
"image"
"video"
"audio"
DialogController
Interfejs został dołączony do dialog
zdarzeń DOM.
Właściwości
-
anuluj
nieważne
Odrzuć okno. Odpowiednik kliknięcia Anuluj w oknie
confirm
lubprompt
.Funkcja
cancel
wygląda tak:() => {...}
-
OK
nieważne
Zaakceptuj okno. Odpowiednik kliknięcia OK w oknie
alert
,confirm
lubprompt
.Funkcja
ok
wygląda tak:(response?: string) => {...}
-
odpowiedź
ciąg znaków opcjonalny
Ciąg znaków odpowiedzi, który należy przekazać gościowi podczas akceptowania okna
prompt
.
-
DownloadPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM download
permissionrequest
.
Właściwości
-
requestMethod
ciąg znaków
Typ żądania HTTP (np.
GET
) powiązany z żądaniem pobierania. -
URL
ciąg znaków
Żądany URL pobierania.
-
allow
nieważne
Zezwól na prośbę o uprawnienia.
Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa
allow
nie jest wywoływana.Funkcja
deny
wygląda tak:() => {...}
FileSystemPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM filesystem
permissionrequest
.
Właściwości
-
URL
ciąg znaków
Adres URL ramki żądającej dostępu do lokalnego systemu plików.
-
allow
nieważne
Zezwól na prośbę o uprawnienia.
Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia,
Funkcja
deny
wygląda tak:() => {...}
FindCallbackResults
Zawiera wszystkie wyniki żądania.
Właściwości
-
activeMatchOrdinal
liczba
Liczba porządkowa bieżącego dopasowania.
-
anulowano
wartość logiczna
Wskazuje, czy to żądanie wyszukiwania zostało anulowane.
-
numberOfMatches
liczba
Liczba dopasowań na stronie (
searchText
). -
selectionRect
Opisuje prostokąt wokół aktywnego dopasowania we współrzędnych ekranu.
FindOptions
Opcje żądania znalezienia.
Właściwości
-
do tyłu
Wartość logiczna opcjonalna
Oznacz, by znaleźć dopasowania w odwrotnej kolejności. Wartością domyślną jest
false
. -
matchCase
Wartość logiczna opcjonalna
Oznacz zgodnie z uwzględnieniem wielkości liter. Wartością domyślną jest
false
.
FullscreenPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM fullscreen
permissionrequest
.
Właściwości
-
pochodzenie
ciąg znaków
Źródło ramki w elemencie
webview
, które zainicjowało żądanie pełnego ekranu. -
allow
nieważne
Zezwól na prośbę o uprawnienia.
Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia,
Funkcja
deny
wygląda tak:() => {...}
GeolocationPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM geolocation
permissionrequest
.
Właściwości
-
URL
ciąg znaków
Adres URL ramki żądającej dostępu do danych geolokalizacji.
-
allow
nieważne
Zezwól na prośbę o uprawnienia.
Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa
allow
nie jest wywoływana.Funkcja
deny
wygląda tak:() => {...}
HidPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM hid
permissionrequest
.
Właściwości
-
URL
ciąg znaków
Adres URL ramki żądającej dostępu do interfejsu HID API.
-
allow
nieważne
Zezwól na prośbę o uprawnienia.
Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa
allow
nie jest wywoływana.Funkcja
deny
wygląda tak:() => {...}
InjectDetails
Szczegóły skryptu lub kodu CSS do wstrzykiwania. Musisz ustawić kod lub właściwość pliku, ale nie możesz ustawić obu jednocześnie.
Właściwości
-
kod
ciąg znaków opcjonalny
Kod JavaScript lub CSS do wstrzykiwania.
Ostrzeżenie: Zachowaj ostrożność podczas korzystania z parametru
code
. Jego nieprawidłowe użycie może doprowadzić do ataku na Twoją aplikację za pomocą ataków typu cross-site scripting. -
plik
ciąg znaków opcjonalny
Plik JavaScript lub CSS do wstrzykiwania.
InjectionItems
Typ elementu wstrzykiwanego: kod lub zbiór plików.
Właściwości
-
kod
ciąg znaków opcjonalny
Kod JavaScript lub CSS do wstrzykiwania na pasujących stronach.
-
pliki
string[] opcjonalnie
Lista plików JavaScript lub CSS do wstawienia na pasujących stronach. Są one wstrzykiwane w kolejności, w jakiej występują w tej tablicy.
LoadPluginPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM loadplugin
permissionrequest
.
Właściwości
-
identyfikator
ciąg znaków
Ciąg identyfikatora wtyczki.
-
nazwa
ciąg znaków
Wyświetlana nazwa wtyczki.
-
allow
nieważne
Zezwól na prośbę o uprawnienia. Jest to domyślne działanie, jeśli funkcja
deny
nie jest wywoływana.Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia,
Funkcja
deny
wygląda tak:() => {...}
MediaPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM media
permissionrequest
.
Właściwości
-
URL
ciąg znaków
Adres URL ramki żądającej dostępu do multimediów użytkownika.
-
allow
nieważne
Zezwól na prośbę o uprawnienia.
Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa
allow
nie jest wywoływana.Funkcja
deny
wygląda tak:() => {...}
NewWindow
Interfejs został dołączony do newwindow
zdarzeń DOM.
Właściwości
-
podłączyć
nieważne
Dołącz żądaną stronę docelową do istniejącego elementu
webview
.Funkcja
attach
wygląda tak:(webview: object) => {...}
-
komponent WebView
Obiekt
Element
webview
, do którego chcesz dołączyć stronę docelową.
-
-
odrzuć
nieważne
Anuluj prośbę o nowe okno.
Funkcja
discard
wygląda tak:() => {...}
PointerLockPermissionRequest
Typ obiektu request
towarzyszącego zdarzeniu DOM pointerLock
permissionrequest
.
Właściwości
-
lastUnlockedBySelf
wartość logiczna
Określa, czy ramka żądająca była najnowszym klientem, w którym wstrzymano blokadę wskaźnika.
-
URL
ciąg znaków
Adres URL ramki żądającej blokady wskaźnika.
-
userGesture
wartość logiczna
Wskazuje, czy w wyniku gestu wprowadzania danych zażądano blokady wskaźnika.
-
allow
nieważne
Zezwól na prośbę o uprawnienia.
Funkcja
allow
wygląda tak:() => {...}
-
odmów
nieważne
odrzucić prośbę o uprawnienia, Jest to domyślne działanie, jeśli usługa
allow
nie jest wywoływana.Funkcja
deny
wygląda tak:() => {...}
SelectionRect
Opisuje prostokąt we współrzędnych na ekranie.
Semantyka przechowywania przypomina tablicę. oznacza, że współrzędna (left, top)
jest uznawana za znajdującą się w prostokątie, ale współrzędna (left + width, top)
nie.
Właściwości
-
wysokość
liczba
Wysokość prostokąta.
-
w lewo
liczba
Odległość od lewej krawędzi ekranu do lewej krawędzi prostokąta.
-
góra
liczba
Odległość od górnej krawędzi ekranu do górnej krawędzi prostokąta.
-
szerokość
liczba
Szerokość prostokąta.
WebRequestEventInterface
Interfejs umożliwiający dostęp do zdarzeń webRequest na stronie gościa. Szczegółowe informacje o cyklu życia WebRequest i powiązanych pojęciach znajdziesz w interfejsie API rozszerzeń chrome.webRequest. Uwaga: zdarzenie chrome.webRequest.onActionIgnored nie jest obsługiwane w przypadku komponentów WebView.
Aby pokazać, czym różni się wykorzystanie rozszerzeń od interfejsu webRequest API, zapoznaj się z tym przykładowym kodem, który blokuje żądania gości dotyczące adresów URL pasujących do *://www.evil.com/*
:
webview.request.onBeforeRequest.addListener(
function(details) { return {cancel: true}; },
{urls: ["*://www.evil.com/*"]},
["blocking"]);
Dodatkowo ten interfejs obsługuje deklaratywne reguły WebRequest za pomocą zdarzeń onRequest
i onMessage
. Szczegółowe informacje o interfejsie API znajdziesz na stronie declarativeWebRequest
.
Pamiętaj, że warunki i działania dotyczące deklaratywnych żądań WebView w przeglądarce powinny być tworzone z ich odpowiedników w chrome.webViewRequest.*
. Ten przykładowy kod deklaratywnie blokuje wszystkie żądania wysyłane do interfejsu "example.com"
w komponencie WebView myWebview
:
var rule = {
conditions: [
new chrome.webViewRequest.RequestMatcher({ url: { hostSuffix: 'example.com' } })
],
actions: [ new chrome.webViewRequest.CancelRequest() ]
};
myWebview.request.onRequest.addRules([rule]);
ZoomMode
Określa sposób powiększania w webview
.
Typ wyliczeniowy
"per-origin"
Zmiany powiększenia zostaną zachowane w źródle powiększonej strony, tzn. wszystkie pozostałe komponenty WebView w tej samej partycji, które są przechodzić do tego samego źródła, również zostaną powiększone. Co więcej, zmiany powiększenia w elemencie per-origin
są zapisywane z pierwotnym punktem początkowym, co oznacza, że podczas przechodzenia do innych stron w tym samym miejscu wszystkie zostaną powiększone do tego samego współczynnika powiększenia.
"per-view"
Zmiany powiększenia dotyczą tylko tego widoku witryny, a zmiany powiększenia w innych widokach nie mają wpływu na powiększenie tego komponentu. Dodatkowo zmiany powiększenia w per-view
są resetowane podczas nawigacji. korzystanie z komponentów WebView będzie zawsze wczytywało strony z określonym współczynnikiem powiększenia dla źródła (w zakresie partycji).
"disable"
Wyłącza całe powiększanie widoku witryny. Zawartość zostanie przywrócona do domyślnego poziomu powiększenia, a wszystkie próby zmiany powiększenia zostaną zignorowane.
Właściwości
contentWindow
Dokumentacja obiektu, która może służyć do publikowania wiadomości na stronie gościa.
Typ
contextMenus
Przypomina interfejs ContextMenus API w Chrome, ale dotyczy webview
zamiast przeglądarki. Aby dodać elementy do menu kontekstowego usługi webview
, użyj interfejsu API webview.contextMenus
. Możesz wybrać typy obiektów, do których mają zastosowanie dodane w menu kontekstowym, np. obrazów, hiperlinków i stron.
Typ
request
Interfejs umożliwiający dostęp do zdarzeń webRequest na stronie gościa.
Metody
addContentScripts()
chrome.webviewTag.addContentScripts(
contentScriptList: [ContentScriptDetails, ...ContentScriptDetails[]],
)
Dodaje reguły wstawiania skryptów treści do komponentu webview
. Gdy webview
przejdzie do strony pasującej do co najmniej 1 reguły, powiązane skrypty zostaną wstrzykiwane. Możesz automatycznie dodawać reguły i aktualizować istniejące.
Poniższy przykład dodaje do webview
2 reguły: „myRule” i „inna reguła”.
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';
Możesz odroczyć wywołanie addContentScripts do czasu wstrzykiwania skryptów.
Z przykładu poniżej dowiesz się, jak zastąpić istniejącą regułę.
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'}]);
Jeśli interfejs webview
został przekierowany do punktu początkowego (np. foo.com) i wywołuje funkcję webview.addContentScripts
, aby dodać element „myRule”, musisz poczekać na następną nawigację, aby umożliwić wstrzykiwanie skryptów. Jeśli potrzebujesz natychmiastowego wstrzykiwania, executeScript
zrobi to, co trzeba.
Reguły są zachowywane nawet wtedy, gdy proces gościa ulegnie awarii lub zostanie zatrzymany, a nawet jeśli tag webview
przestanie być nadrzędny.
Więcej informacji znajdziesz w dokumentacji skryptów treści.
Parametry
-
contentScriptList
Szczegóły skryptów treści, które chcesz dodać.
back()
chrome.webviewTag.back(
callback?: function,
)
Przewija wstecz o jeden wpis historii, jeśli to możliwe. Odpowiednik: go(-1)
.
Parametry
-
wywołanie zwrotne
funkcja optional
Chrome w wersji 44 lub nowszej .Parametr
callback
wygląda tak:(success: boolean) => void
-
sukces
wartość logiczna
Wskazuje, czy nawigacja zakończyła się pomyślnie.
-
canGoBack()
chrome.webviewTag.canGoBack()
Wskazuje, czy można przechodzić wstecz w historii. Stan tej funkcji jest przechowywany w pamięci podręcznej i aktualizowany przed każdym zdarzeniem loadcommit
, więc najlepiej jest ją wywołać w loadcommit
.
Zwroty
-
wartość logiczna
canGoForward()
chrome.webviewTag.canGoForward()
Wskazuje, czy można przechodzić do przodu w historii. Stan tej funkcji jest przechowywany w pamięci podręcznej i aktualizowany przed każdym zdarzeniem loadcommit
, więc najlepiej jest ją wywołać w loadcommit
.
Zwroty
-
wartość logiczna
captureVisibleRegion()
chrome.webviewTag.captureVisibleRegion(
options?: ImageDetails,
callback: function,
)
Przechwytuje widoczny obszar komponentu WebView.
Parametry
-
Opcje
ImageDetails opcjonalne
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(dataUrl: string) => void
-
dataUrl
ciąg znaków
Adres URL danych, który koduje obraz widocznego obszaru na przechwyconej karcie. Może być przypisany do parametru „src” właściwości elementu HTML Image do wyświetlania.
-
clearData()
chrome.webviewTag.clearData(
options: ClearDataOptions,
types: ClearDataTypeSet,
callback?: function,
)
Usuwa dane przeglądania dla partycji webview
.
Parametry
-
Opcje
Opcje określające, które dane mają zostać wyczyszczone.
-
typy
Typy danych do wyczyszczenia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
executeScript()
chrome.webviewTag.executeScript(
details: InjectDetails,
callback?: function,
)
Wstawia kod JavaScript na stronie gościa.
Ten przykładowy kod korzysta z funkcji wstrzykiwania skryptu, aby ustawić czerwony kolor tła strony gościa:
webview.executeScript({ code: "document.body.style.backgroundColor = 'red'" });
Parametry
-
szczegóły
Szczegóły skryptu do uruchomienia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(result?: any[]) => void
-
wynik
any[] opcjonalne
Wynik skryptu w każdej wstrzykniętej klatce.
-
find()
chrome.webviewTag.find(
searchText: string,
options?: FindOptions,
callback?: function,
)
Wysyła żądanie znajdowania na stronie.
Parametry
-
searchText
ciąg znaków
Ciąg do znalezienia na stronie.
-
Opcje
Opcjonalne FindOptions
Opcje żądania znalezienia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(results?: FindCallbackResults) => void
-
wyniki
Opcjonalne FindCallbackResults
Zawiera wszystkie wyniki żądania. Pole
results
można pominąć, jeśli nie jest używane w treści funkcji wywołania zwrotnego. np. gdy wywołanie zwrotne jest używane tylko do wykrywania zakończenia żądania.
-
forward()
chrome.webviewTag.forward(
callback?: function,
)
Przechodzi o jeden wpis historii do przodu, jeśli to możliwe. Odpowiednik: go(1)
.
Parametry
-
wywołanie zwrotne
funkcja optional
Chrome w wersji 44 lub nowszej .Parametr
callback
wygląda tak:(success: boolean) => void
-
sukces
wartość logiczna
Wskazuje, czy nawigacja zakończyła się pomyślnie.
-
getAudioState()
chrome.webviewTag.getAudioState(
callback: function,
)
Zapyta o stan dźwięku.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(audible: boolean) => void
-
audible
wartość logiczna
-
getProcessId()
chrome.webviewTag.getProcessId()
Zwraca wewnętrzny identyfikator procesu Chrome dla bieżącego procesu strony internetowej gościa, dzięki czemu osadzone elementy mogą dowiedzieć się, na ilu gości zakończenie tego procesu wpłynie na liczbę gości. Dwóch gości będzie korzystać z tego samego procesu tylko wtedy, gdy należą do tej samej aplikacji i mają ten sam identyfikator partycji miejsca na dane. Wywołanie jest synchroniczne i zwraca wartość bieżącego identyfikatora procesu zapisaną w pamięci podręcznej przez umieszczenie elementu. Identyfikator procesu różni się od identyfikatora procesu w systemie operacyjnym.
Zwroty
-
liczba
getUserAgent()
chrome.webviewTag.getUserAgent()
Zwraca ciąg znaków klienta użytkownika używany przez webview
w przypadku żądań stron gościa.
Zwroty
-
ciąg znaków
getZoom()
chrome.webviewTag.getZoom(
callback: function,
)
Pobiera bieżący współczynnik powiększenia.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(zoomFactor: number) => void
-
zoomFactor
liczba
Bieżący współczynnik powiększenia.
-
getZoomMode()
chrome.webviewTag.getZoomMode(
callback: function,
)
Pobiera bieżący tryb powiększenia.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(ZoomMode: ZoomMode) => void
-
ZoomMode
Bieżący tryb powiększenia na urządzeniu
webview
.
-
go()
chrome.webviewTag.go(
relativeIndex: number,
callback?: function,
)
Przechodzi do wpisu historii, korzystając z indeksu historii względem bieżącej nawigacji. Jeśli wybrana nawigacja jest niemożliwa, ta metoda nie działa.
Parametry
-
relativeIndex
liczba
Indeks historii względnej, do którego należy przejść w elemencie
webview
. Na przykład wartość2
w miarę możliwości powoduje przejście do przodu o 2 wpisy w historii. wartość-3
powoduje przejście do 3 wpisów wstecz. -
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:(success: boolean) => void
-
sukces
wartość logiczna
Wskazuje, czy nawigacja zakończyła się pomyślnie.
-
insertCSS()
chrome.webviewTag.insertCSS(
details: InjectDetails,
callback?: function,
)
Wstawia kod CSS na stronie gościa.
Parametry
-
szczegóły
Szczegóły kodu CSS do wstawienia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
isAudioMuted()
chrome.webviewTag.isAudioMuted(
callback: function,
)
Zapytanie, czy dźwięk jest wyciszony.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(muted: boolean) => void
-
Wyciszono
wartość logiczna
-
isSpatialNavigationEnabled()
chrome.webviewTag.isSpatialNavigationEnabled(
callback: function,
)
Zapytanie, czy nawigacja przestrzenna jest włączona w komponencie WebView.
Parametry
-
funkcja
Parametr
callback
wygląda tak:(enabled: boolean) => void
-
wartość logiczna
-
isUserAgentOverridden()
chrome.webviewTag.isUserAgentOverridden()
Wskazuje, czy ciąg znaków klienta użytkownika webview
został zastąpiony przez webviewTag.setUserAgentOverride
.
loadDataWithBaseUrl()
chrome.webviewTag.loadDataWithBaseUrl(
dataUrl: string,
baseUrl: string,
virtualUrl?: string,
)
Wczytuje adres URL danych z określonym podstawowym adresem URL używanym na potrzeby linków względnych. Opcjonalnie możesz podać wirtualny adres URL, który będzie wyświetlany użytkownikowi zamiast adresu URL danych.
Parametry
-
dataUrl
ciąg znaków
Adres URL danych do wczytania.
-
baseUrl
ciąg znaków
Podstawowy adres URL, który będzie używany w linkach względnych.
-
virtualUrl
ciąg znaków opcjonalny
Adres URL, który będzie wyświetlany użytkownikowi (na pasku adresu).
print()
chrome.webviewTag.print()
Drukuje zawartość pola webview
. Odpowiada to wywołaniu skryptowej funkcji drukowania z poziomu webview
.
reload()
chrome.webviewTag.reload()
Wczytuje ponownie bieżącą stronę najwyższego poziomu.
removeContentScripts()
chrome.webviewTag.removeContentScripts(
scriptNameList?: string[],
)
Usuwa skrypty treści z elementu webview
.
Poniższy przykład pozwala usunąć regułę „myRule” który został dodany wcześniej.
webview.removeContentScripts(['myRule']);
Aby usunąć wszystkie reguły, wywołaj połączenie:
webview.removeContentScripts();
Parametry
-
scriptNameList
string[] opcjonalnie
Lista nazw skryptów treści, które zostaną usunięte. Jeśli lista jest pusta, wszystkie skrypty treści dodane do listy
webview
zostaną usunięte.
setAudioMuted()
chrome.webviewTag.setAudioMuted(
mute: boolean,
)
Ustawia stan wyciszenia dźwięku w komponencie WebView.
Parametry
-
wycisz
wartość logiczna
Wartość wyciszenia dźwięku
setSpatialNavigationEnabled()
chrome.webviewTag.setSpatialNavigationEnabled(
enabled: boolean,
)
Ustawia stan nawigacji przestrzennej komponentu WebView.
Parametry
-
wartość logiczna
Wartość stanu nawigacji przestrzennej.
setUserAgentOverride()
chrome.webviewTag.setUserAgentOverride(
userAgent: string,
)
Zastąp ciąg znaków klienta użytkownika używany przez webview
w żądaniach stron gościa. Zastąpienie spowoduje, że w przypadku żądań stron gościa, do których to zastąpienie zostanie zastosowane, wartości nagłówka podpowiedzi klienta użytkownika i wartości zwracane przez navigator.userAgentData
będą puste.
Parametry
-
userAgent
ciąg znaków
Ciąg znaków klienta użytkownika, który ma zostać użyty.
setZoom()
chrome.webviewTag.setZoom(
zoomFactor: number,
callback?: function,
)
Zmienia współczynnik powiększenia strony. Zakres i trwałość tej zmiany zależy od bieżącego trybu powiększenia komponentu WebView (patrz webviewTag.ZoomMode
).
Parametry
-
zoomFactor
liczba
Nowy współczynnik powiększenia.
-
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
setZoomMode()
chrome.webviewTag.setZoomMode(
ZoomMode: ZoomMode,
callback?: function,
)
Ustawia tryb powiększenia w urządzeniu webview
.
Parametry
-
ZoomMode
Określa sposób powiększania w elemencie
webview
. -
wywołanie zwrotne
funkcja optional
Parametr
callback
wygląda tak:() => void
stop()
chrome.webviewTag.stop()
Zatrzymuje wczytywanie bieżącej nawigacji w usłudze webview
, jeśli jest w toku.
stopFinding()
chrome.webviewTag.stopFinding(
action?: "clear"
| "keep"
| "activate"
,
)
Kończy bieżącą sesję znajdowania (usuwa wszystkie zaznaczenia) i anuluje wszystkie trwające żądania wyszukiwania.
Parametry
-
działanie
"clear"
| "keep"
| "activate"
opcjonalnieOkreśla, co zrobić z aktywnym dopasowaniem po zakończeniu sesji znajdowania.
clear
wyczyści podświetlenie aktywnego dopasowania.keep
będzie zaznaczać aktywne dopasowanie.activate
będzie wyróżniać aktywne dopasowanie i symulować kliknięcie użytkownika. Działanie domyślne tokeep
.
terminate()
chrome.webviewTag.terminate()
Wymusza wyłączenie procesu renderowania strony internetowej gościa. Może to mieć wpływ na wiele tagów webview
w obecnej aplikacji, jeśli używają one tego samego procesu, ale nie wpłynie to na tagi webview
w innych aplikacjach.
Wydarzenia
close
chrome.webviewTag.close.addListener(
callback: function,
)
Uruchamiane, gdy okno gościa próbuje się zamknąć.
Ten przykładowy kod przekierowuje webview
do about:blank
, gdy gość próbuje zamknąć się samodzielnie.
webview.addEventListener('close', function() {
webview.src = 'about:blank';
});
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:() => void
consolemessage
chrome.webviewTag.consolemessage.addListener(
callback: function,
)
Uruchamiane, gdy okno gościa powoduje zarejestrowanie komunikatu w konsoli.
Ten przykładowy kod przekierowuje wszystkie komunikaty logu do konsoli umieszczania bez względu na poziom logowania i inne właściwości.
webview.addEventListener('consolemessage', function(e) {
console.log('Guest page logged a message: ', e.message);
});
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(level: number, message: string, line: number, sourceId: string) => void
-
poziom
liczba
-
wiadomość
ciąg znaków
-
linia
liczba
-
sourceId
ciąg znaków
-
contentload
chrome.webviewTag.contentload.addListener(
callback: function,
)
Uruchamiane, gdy okno gościa powoduje uruchomienie zdarzenia load
, czyli po wczytaniu nowego dokumentu. Nie obejmuje to nawigacji po stronie w bieżącym dokumencie ani wczytywania zasobów asynchronicznych.
Ten przykładowy kod zmienia domyślny rozmiar czcionki elementu body
gościa po wczytaniu strony:
webview.addEventListener('contentload', function() {
webview.executeScript({ code: 'document.body.style.fontSize = "42px"' });
});
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:() => void
dialog
chrome.webviewTag.dialog.addListener(
callback: function,
)
Uruchamiane, gdy okno gościa próbuje otworzyć okno modalne za pomocą window.alert
, window.confirm
lub window.prompt
.
Obsługa tego zdarzenia spowoduje zablokowanie procesu gościa do czasu powrotu detektora zdarzeń lub dopóki obiekt dialog
nie stanie się nieosiągalny (jeśli został wywołany preventDefault()
).
Domyślnym zachowaniem jest anulowanie okna.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(messageType: "alert"
| "confirm"
| "prompt"
, messageText: string, dialog: DialogController) => void-
messageType
"alert"
| "confirm"
| "prompt"
-
messageText
ciąg znaków
-
okno|okno dialogowe
-
exit
chrome.webviewTag.exit.addListener(
callback: function,
)
Uruchamiane po zakończeniu procesu renderowania treści internetowej gościa.
Ten przykładowy kod wyświetla wiadomość pożegnalną za każdym razem, gdy strona gościa ulegnie awarii:
webview.addEventListener('exit', function(e) {
if (e.reason === 'crash') {
webview.src = 'data:text/plain,Goodbye, world!';
}
});
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(processID: number, reason: "normal"
| "abnormal"
| "crash"
| "kill"
) => void-
processID
liczba
-
powód
"normal"
| "abnormal"
| "crash"
| "kill"
-
findupdate
chrome.webviewTag.findupdate.addListener(
callback: function,
)
Uruchamiane, gdy dostępne są nowe wyniki dla aktywnego żądania wyszukiwania. Może się to zdarzyć kilka razy w przypadku pojedynczego żądania wyszukiwania, gdy zostaną znalezione pasujące wyniki.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void
-
searchText
ciąg znaków
-
numberOfMatches
liczba
-
activeMatchOrdinal
liczba
-
selectionRect
-
anulowano
wartość logiczna
-
finalUpdate
ciąg znaków
-
loadabort
chrome.webviewTag.loadabort.addListener(
callback: function,
)
Uruchamiane, gdy ładowanie najwyższego poziomu zostało przerwane bez zatwierdzenia. Komunikat o błędzie zostanie wyświetlony w konsoli, chyba że to zdarzenie jest ustawione jako domyślne.
Uwaga: po przerwaniu wczytywania zasobów zdarzenie loadabort
zostanie ostatecznie zakończone zdarzeniem loadstop
, nawet jeśli wszystkie zatwierdzone operacje wczytywania od ostatniego zdarzenia loadstop
(jeśli jakiekolwiek wystąpiły) zostały przerwane.
Uwaga: w przypadku przerwania wczytywania adresu URL z informacjami lub adresu URL JavaScriptu polecenie loadabort
zostanie uruchomione, a webview
nastąpi przekierowanie do ciągu „about:blank”.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(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
ciąg znaków
-
isTopLevel
wartość logiczna
-
kod
liczba
-
powód
"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,
)
Uruchamiane po zatwierdzeniu obciążenia. Obejmuje to nawigację w obrębie bieżącego dokumentu oraz wczytywania ramki podrzędnej na poziomie dokumentu, ale nie uwzględnia asynchronicznego wczytywania zasobów.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(url: string, isTopLevel: boolean) => void
-
URL
ciąg znaków
-
isTopLevel
wartość logiczna
-
loadredirect
chrome.webviewTag.loadredirect.addListener(
callback: function,
)
Uruchamiane, gdy żądanie wczytywania najwyższego poziomu przekierowuje pod inny adres URL.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(oldUrl: string, newUrl: string, isTopLevel: boolean) => void
-
oldUrl
ciąg znaków
-
newUrl
ciąg znaków
-
isTopLevel
wartość logiczna
-
loadstart
chrome.webviewTag.loadstart.addListener(
callback: function,
)
Uruchamiane po rozpoczęciu wczytywania.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(url: string, isTopLevel: boolean) => void
-
URL
ciąg znaków
-
isTopLevel
wartość logiczna
-
loadstop
chrome.webviewTag.loadstop.addListener(
callback: function,
)
Uruchamiane po zakończeniu wczytywania wszystkich klatek na poziomie klatki na stronie gościa (wraz ze wszystkimi jej ramkami podrzędnymi). Obejmuje to nawigację w obrębie bieżącego dokumentu oraz wczytywania ramki podrzędnej na poziomie dokumentu, ale nie uwzględnia asynchronicznego wczytywania zasobów. To zdarzenie jest wywoływane za każdym razem, gdy liczba wczytań na poziomie dokumentu zmieni się z 1 (lub więcej) na 0. Jeśli na przykład strona, której wczytywanie zostało już zakończone (np. loadstop
już raz) tworzy nowy element iframe, który wczytuje stronę. Potem po zakończeniu wczytywania strony iframe uruchomi się drugi element loadstop
. Ten wzorzec często występuje na stronach, na których wczytują się reklamy.
Uwaga: po przerwaniu zaplanowanego wczytywania zdarzenie loadstop
będzie później następować po zdarzeniu loadabort
nawet wtedy, gdy wszystkie zatwierdzone operacje wczytywania od ostatniego zdarzenia loadstop
(jeśli jakiekolwiek wystąpiły) zostały przerwane.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:() => void
newwindow
chrome.webviewTag.newwindow.addListener(
callback: function,
)
Uruchamiane, gdy strona gościa próbuje otworzyć nowe okno przeglądarki.
Ten przykładowy kod utworzy nowy element webview
w umieszczonym elemencie i porusza się po nim w przypadku każdego żądanego nowego okna:
webview.addEventListener('newwindow', function(e) {
var newWebview = document.createElement('webview');
document.body.appendChild(newWebview);
e.window.attach(newWebview);
});
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(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-
okno
-
targetUrl
ciąg znaków
-
initialWidth
liczba
-
initialHeight
liczba
-
nazwa
ciąg znaków
-
windowOpenDisposition
"ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
-
permissionrequest
chrome.webviewTag.permissionrequest.addListener(
callback: function,
)
Uruchamiane, gdy strona gościa musi poprosić o specjalne uprawnienia od osadzonego komponentu.
Ten przykładowy kod przyzna stronie gościa dostęp do interfejsu API webkitGetUserMedia
. Pamiętaj, że aplikacja, która korzysta z tego przykładowego kodu, musi sama określać uprawnienia audioCapture
lub videoCapture
w pliku manifestu:
webview.addEventListener('permissionrequest', function(e) {
if (e.permission === 'media') {
e.request.allow();
}
});
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(permission: "media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
, request: object) => void-
uprawnienie
"media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
| "hid"
-
żądanie
Obiekt
-
responsive
chrome.webviewTag.responsive.addListener(
callback: function,
)
Uruchamiane, gdy proces renderowania treści internetowych dla gości ponownie reaguje po tym, jak przestał.
Ten przykładowy kod powoduje stopniowe zanikanie i wygładzanie elementu webview
w miarę, jak element ten zaczyna odpowiadać lub nie reaguje:
webview.style.webkitTransition = 'opacity 250ms';
webview.addEventListener('unresponsive', function() {
webview.style.opacity = '0.5';
});
webview.addEventListener('responsive', function() {
webview.style.opacity = '1';
});
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(processID: number) => void
-
processID
liczba
-
sizechanged
chrome.webviewTag.sizechanged.addListener(
callback: function,
)
Uruchamiane po zmianie rozmiaru umieszczonej treści internetowej w interfejsie autosize
. Uruchamiany tylko wtedy, gdy zasada autosize
jest włączona.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void
-
oldWidth
liczba
-
oldHeight
liczba
-
newWidth
liczba
-
newHeight
liczba
-
unresponsive
chrome.webviewTag.unresponsive.addListener(
callback: function,
)
Uruchamiane, gdy proces renderowania treści internetowej gościa przestał reagować. To zdarzenie zostanie wygenerowane jeden raz z pasującym zdarzeniem elastycznym, jeśli gość ponownie zacznie odpowiadać.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(processID: number) => void
-
processID
liczba
-
zoomchange
chrome.webviewTag.zoomchange.addListener(
callback: function,
)
Uruchamiane po zmianie powiększenia strony.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(oldZoomFactor: number, newZoomFactor: number) => void
-
oldZoomFactor
liczba
-
newZoomFactor
liczba
-