Opis
Użyj interfejsu chrome.tabGroups API, aby korzystać z systemu grupowania kart w przeglądarce. Za pomocą tego interfejsu API możesz modyfikować i przenosić grupy kart w przeglądarce. Aby grupować i rozgrupowywać karty lub sprawdzać, które karty należą do grup, użyj interfejsu chrome.tabs API.
Uprawnienia
tabGroupsDostępność
Typy
Color
Kolor grupy.
Typ wyliczeniowy
„grey”
„blue”
„red”
„yellow”
„green”
„pink”
„purple”
„cyan”
„orange”
TabGroup
Właściwości
-
zwinięto
Wartość logiczna
Czy grupa jest zwinięta. Zwinięta grupa to grupa, której karty są ukryte.
-
kolor
Kolor grupy.
-
id
liczba
Identyfikator grupy. Identyfikatory grup są unikalne w ramach sesji przeglądarki.
-
Wartość logiczna
Chrome 137 lub nowszaczy grupa jest udostępniona;
-
tytuł
string opcjonalny
Nazwa grupy.
-
windowId
liczba
Identyfikator okna zawierającego grupę.
Właściwości
TAB_GROUP_ID_NONE
Identyfikator, który oznacza brak grupy.
Wartość
-1
Metody
get()
chrome.tabGroups.get(
groupId: number,
): Promise<TabGroup>
Pobiera szczegóły określonej grupy.
Parametry
-
groupId
liczba
Zwroty
-
Promise<TabGroup>
Chrome w wersji 90 lub nowszej
move()
chrome.tabGroups.move(
groupId: number,
moveProperties: object,
): Promise<TabGroup | undefined>
Przenosi grupę i wszystkie karty w jej oknie lub do nowego okna.
Parametry
-
groupId
liczba
Identyfikator grupy do przeniesienia.
-
moveProperties
obiekt
-
indeks
liczba
Pozycja, do której ma zostać przeniesiona grupa. Aby umieścić grupę na końcu okna, użyj
-1. -
windowId
number opcjonalny
Okno, do którego chcesz przenieść grupę. Domyślnie jest to okno, w którym obecnie znajduje się grupa. Pamiętaj, że grupy można przenosić tylko do i z okien typu
windows.WindowType"normal".
-
Zwroty
-
Promise<TabGroup | undefined>
Chrome w wersji 90 lub nowszej
query()
chrome.tabGroups.query(
queryInfo: object,
): Promise<TabGroup[]>
Pobiera wszystkie grupy, które mają określone właściwości, lub wszystkie grupy, jeśli nie określono żadnych właściwości.
Parametry
-
queryInfo
obiekt
-
zwinięto
wartość logiczna opcjonalna
Czy grupy są zwinięte.
-
kolor
Kolor opcjonalny
Kolor grup.
-
wartość logiczna opcjonalna
Chrome 137 lub nowszaczy grupa jest udostępniona;
-
tytuł
string opcjonalny
Dopasuj tytuły grup do wzorca.
-
windowId
number opcjonalny
Identyfikator okna nadrzędnego lub
windows.WINDOW_ID_CURRENTw przypadku bieżącego okna.
-
Zwroty
-
Promise<TabGroup[]>
Chrome w wersji 90 lub nowszej
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
): Promise<TabGroup | undefined>
Modyfikuje właściwości grupy. Właściwości, które nie są określone w updateProperties, nie są modyfikowane.
Parametry
-
groupId
liczba
Identyfikator grupy, którą chcesz zmodyfikować.
-
updateProperties
obiekt
-
zwinięto
wartość logiczna opcjonalna
Określa, czy grupa ma być zwinięta.
-
kolor
Kolor opcjonalny
Kolor grupy.
-
tytuł
string opcjonalny
Nazwa grupy.
-
Zwroty
-
Promise<TabGroup | undefined>
Chrome w wersji 90 lub nowszej
Wydarzenia
onCreated
chrome.tabGroups.onCreated.addListener(
callback: function,
)
Wywoływane, gdy grupa zostanie utworzona.
onMoved
chrome.tabGroups.onMoved.addListener(
callback: function,
)
Wywoływane, gdy grupa zostanie przeniesiona w oknie. Zdarzenia przenoszenia są nadal wywoływane w przypadku poszczególnych kart w grupie, a także w przypadku samej grupy. To zdarzenie nie jest wywoływane, gdy grupa jest przenoszona między oknami. Zamiast tego jest usuwana z jednego okna i tworzona w innym.
onRemoved
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
Uruchamiane, gdy grupa zostanie zamknięta bezpośrednio przez użytkownika lub automatycznie, ponieważ nie zawierała żadnych kart.
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Uruchamiane po zaktualizowaniu grupy.