Nội dung mô tả
Sử dụng API chrome.tabGroups
để tương tác với hệ thống nhóm thẻ của trình duyệt. Bạn có thể sử dụng API này để sửa đổi và sắp xếp lại các nhóm thẻ trong trình duyệt. Để nhóm và huỷ nhóm các thẻ hoặc để truy vấn các thẻ có trong nhóm, hãy sử dụng API chrome.tabs
.
Quyền
tabGroups
Phạm vi cung cấp
Loại
Color
Màu của nhóm.
Liệt kê
TabGroup
Thuộc tính
-
đã thu gọn
boolean
Liệu nhóm có được thu gọn hay không. Nhóm thu gọn là một nhóm có các thẻ bị ẩn.
-
màu
Màu của nhóm.
-
id
number
Mã của nhóm. Mã nhóm là duy nhất trong một phiên trình duyệt.
-
title
chuỗi không bắt buộc
Tiêu đề của nhóm.
-
windowId
number
Mã của cửa sổ chứa nhóm.
Thuộc tính
TAB_GROUP_ID_NONE
Mã nhận dạng đại diện cho trường hợp không có một nhóm.
Giá trị
-1
Phương thức
get()
chrome.tabGroups.get(
groupId: number,
callback?: function,
)
Truy xuất thông tin chi tiết về nhóm đã chỉ định.
Tham số
-
groupId
number
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(group: TabGroup) => void
-
nhóm
-
Giá trị trả về
-
Promise<TabGroup>
Chrome 90 trở lênLời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.
move()
chrome.tabGroups.move(
groupId: number,
moveProperties: object,
callback?: function,
)
Di chuyển nhóm và tất cả các thẻ của nhóm trong cửa sổ của nhóm hoặc sang một cửa sổ mới.
Tham số
-
groupId
number
Mã của nhóm cần di chuyển.
-
moveProperties
đối tượng
-
index
number
Vị trí cần di chuyển nhóm tới. Sử dụng
-1
để đặt nhóm ở cuối cửa sổ. -
windowId
số không bắt buộc
Cửa sổ để chuyển nhóm sang. Giá trị mặc định là cửa sổ mà nhóm hiện đang truy cập. Xin lưu ý rằng bạn chỉ có thể di chuyển nhóm đến và từ cửa sổ thuộc loại
windows.WindowType
"normal"
.
-
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(group?: TabGroup) => void
-
nhóm
TabGroup không bắt buộc
Thông tin chi tiết về nhóm đã di chuyển.
-
Giá trị trả về
-
Promise<TabGroup | undefined>
Chrome 90 trở lênLời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.
query()
chrome.tabGroups.query(
queryInfo: object,
callback?: function,
)
Lấy tất cả các nhóm có thuộc tính được chỉ định hoặc tất cả các nhóm nếu không có thuộc tính nào được chỉ định.
Tham số
-
queryInfo
đối tượng
-
đã thu gọn
boolean không bắt buộc
Liệu các nhóm có được thu gọn hay không.
-
màu
Màu sắc không bắt buộc
Màu của nhóm.
-
title
chuỗi không bắt buộc
Ghép tiêu đề nhóm với một mẫu.
-
windowId
số không bắt buộc
Mã của cửa sổ mẹ hoặc biểu tượng
windows.WINDOW_ID_CURRENT
của cửa sổ hiện tại.
-
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(result: TabGroup[]) => void
-
kết quả
TabGroup[]
-
Giá trị trả về
-
Promise<TabGroup[]>
Chrome 90 trở lênLời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.
update()
chrome.tabGroups.update(
groupId: number,
updateProperties: object,
callback?: function,
)
Sửa đổi các thuộc tính của nhóm. Những thuộc tính không được chỉ định trong updateProperties
sẽ không được sửa đổi.
Tham số
-
groupId
number
Mã của nhóm cần sửa đổi.
-
updateProperties
đối tượng
-
đã thu gọn
boolean không bắt buộc
Liệu có nên thu gọn nhóm hay không.
-
màu
Màu sắc không bắt buộc
Màu của nhóm.
-
title
chuỗi không bắt buộc
Tiêu đề của nhóm.
-
-
số gọi lại
hàm không bắt buộc
Tham số
callback
sẽ có dạng như sau:(group?: TabGroup) => void
-
nhóm
TabGroup không bắt buộc
Thông tin chi tiết về nhóm được cập nhật.
-
Giá trị trả về
-
Promise<TabGroup | undefined>
Chrome 90 trở lênLời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp để có khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Lời hứa sẽ được phân giải bằng cùng một loại được truyền đến lệnh gọi lại.
Sự kiện
onCreated
chrome.tabGroups.onCreated.addListener(
callback: function,
)
Được kích hoạt khi một nhóm được tạo.
onMoved
chrome.tabGroups.onMoved.addListener(
callback: function,
)
Được kích hoạt khi một nhóm được di chuyển trong một cửa sổ. Sự kiện di chuyển vẫn được kích hoạt cho các thẻ riêng lẻ trong nhóm, cũng như cho chính nhóm đó. Sự kiện này không được kích hoạt khi một nhóm được di chuyển giữa các cửa sổ; thay vào đó, nhóm sẽ bị xoá khỏi một cửa sổ và được tạo trong một cửa sổ khác.
onRemoved
chrome.tabGroups.onRemoved.addListener(
callback: function,
)
Được kích hoạt khi một nhóm bị đóng, do người dùng trực tiếp hoặc tự động vì nhóm đó không chứa thẻ nào.
onUpdated
chrome.tabGroups.onUpdated.addListener(
callback: function,
)
Được kích hoạt khi một nhóm được cập nhật.