Một năm trước, vào tháng 5 năm 2022, chúng tôi đã thêm bảng điều khiển bên vào Chrome. Đây là một nền tảng đồng hành mới cho phép người dùng sử dụng các công cụ cùng với nội dung mà họ đang duyệt xem. Hôm nay, chúng tôi rất vui mừng thông báo rằng tiện ích của bạn có thể bắt đầu hiển thị nội dung trong bảng điều khiển bên, bắt đầu từ Chrome 114.
Tốt hơn cho người dùng, dễ dàng hơn cho nhà phát triển
Chúng tôi đã thấy nhiều nhà phát triển triển khai trải nghiệm giống như thanh bên vào tiện ích của họ. Đó là lý do chúng tôi rất vui mừng khi biến trải nghiệm này thành tiêu chuẩn nền tảng. Với Side Panel API (API Bảng điều khiển bên) mới, giờ đây, bạn có thể cung cấp một giao diện người dùng liên tục mở cùng với một trang mà người dùng đang truy cập. Người dùng sẽ được hưởng lợi từ vị trí và bố cục nhất quán giữa các tiện ích. Ngoài ra, khả năng hiển thị giao diện người dùng mà không cần yêu cầu quyền máy chủ là một lợi ích đáng kể về quyền riêng tư cho người dùng, đồng thời giúp giảm số lượng cảnh báo hiển thị cho tiện ích của bạn trong thời gian cài đặt.
Side Panel API (API Bảng điều khiển bên) giúp loại bỏ những rắc rối liên quan đến việc chèn nội dung vào một trang không đáng tin cậy. API này cũng giúp giảm đáng kể yêu cầu duy trì khả năng tương thích trên nhiều trang web và sàng lọc các báo cáo lỗi về tình trạng gián đoạn do tiện ích của bạn gây ra.
Một người bạn đồng hành của người dùng trên web
Khi xây dựng trải nghiệm bảng điều khiển bên mới trong tiện ích, bạn cần lưu ý một điều: bạn đang hỗ trợ người dùng hoàn thành các nhiệm vụ trên web như thế nào? Dưới đây là một số câu hỏi bạn nên cân nhắc:
- Bảng điều khiển bên của tôi giúp người dùng như thế nào?
- Chính sách về mục đích duy nhất cũng áp dụng cho bảng điều khiển bên. Hãy đảm bảo rằng bảng điều khiển bên của bạn cung cấp chức năng liên quan trực tiếp đến phần còn lại của tiện ích và những gì người dùng đang cố gắng đạt được.
- Bảng điều khiển bên của tôi có chỉ xuất hiện khi có liên quan không?
- API Bảng điều khiển bên cho phép bạn chọn những trang web mà người dùng sẽ thấy bảng điều khiển bên. Bằng cách này, bạn có thể tránh hiển thị bảng điều khiển bên khi không liên quan đến người dùng hoặc không liên quan đến nội dung mà người dùng đang duyệt xem.
- Thiết kế có nhất quán với phần còn lại của tiện ích không?
- Bảng điều khiển bên của bạn phải có thiết kế hấp dẫn về mặt hình ảnh, phù hợp với biểu trưng, màu sắc, biểu tượng và phông chữ của tiện ích và trang thông tin trên Cửa hàng Chrome. Điều này giúp người dùng có được trải nghiệm nhất quán và dễ nhận biết ở bất cứ nơi nào họ sử dụng tiện ích của bạn.
- Người dùng tìm thấy bảng điều khiển bên của tôi bằng cách nào?
- Hãy cho người dùng mới biết cách sử dụng bảng điều khiển bên bằng cách cung cấp đủ tài liệu hoặc hướng dẫn trong tiện ích. Điều này sẽ giúp bạn giữ chân người dùng và tránh các bài đánh giá tiêu cực trong trang thông tin trên Cửa hàng Chrome. Xin lưu ý rằng bạn có thể bắt đầu hướng dẫn người dùng trước khi họ cài đặt tiện ích bằng cách đưa một video trên YouTube cho thấy cách tiện ích của bạn hoạt động trong trang thông tin trên Cửa hàng Chrome!
Chúng tôi cũng đã cập nhật Chính sách chương trình, đồng thời cập nhật các phần Phương pháp hay nhất và Nguyên tắc về chất lượng để phản ánh một số điểm cần cân nhắc này. Những thay đổi này nhấn mạnh rằng bảng điều khiển bên của bạn phải đóng vai trò là một người bạn đồng hành hữu ích cho trải nghiệm duyệt web của người dùng bằng cách cung cấp chức năng bổ sung. Những thay đổi này cũng làm rõ rằng bảng điều khiển bên của bạn không được gây xao nhãng không cần thiết.
Tổng quan về API
Để tiện ích của bạn xuất hiện trong bảng điều khiển bên, hãy yêu cầu quyền "sidePanel" trong tệp kê khai và thêm khoá "side_panel" có "default_path" trỏ đến một trang trong tiện ích:
manifest.json:
{
...
"side_panel": {
"default_path": "sidepanel.html"
},
"permissions": [
"sidePanel"
]
...
}
Trên trang bảng điều khiển bên, bạn có thể tải tập lệnh và gọi API tiện ích như trên bất kỳ trang tiện ích nào khác. Biểu tượng cho bảng điều khiển bên sẽ được lấy từ biểu tượng tiện ích của bạn. Đừng quên đặt biểu tượng đó để có thêm một chút điểm nhấn.
Các tính năng bổ sung
Bạn có thể liên kết bảng điều khiển bên với biểu tượng hành động để có thể dễ dàng mở bất cứ lúc nào:
service-worker.js:
await chrome.sidePanel.setPanelBehavior({ openPanelOnActionClick: true });
Nếu chỉ muốn bảng điều khiển bên xuất hiện trên một số trang cụ thể, bạn có thể kiểm soát điều đó và ngăn bảng điều khiển bên xuất hiện ở những nơi khác không liên quan đến người dùng:
service-worker.js:
chrome.tabs.onUpdated.addListener((tabId, info, tab) => {
if (!tab.url) return;
const url = new URL(tab.url);
if (url.origin === 'https://example.com') {
chrome.sidePanel.setOptions({ tabId, path: 'sidepanel.html', enabled: true });
} else {
chrome.sidePanel.setOptions({ tabId, enabled: false });
}
});
Tìm hiểu thêm
Chúng tôi đã xuất bản tài liệu về Side Panel API mà bạn có thể bắt đầu đọc ngay hôm nay. Chúng tôi cũng đã thêm các mẫu vào kho lưu trữ chrome-extensions-samples. Đây là nơi tuyệt vời để xem cách sử dụng API này trong thực tế.
Như đã đề cập, các trang chính sách và phương pháp hay nhất của chúng tôi cũng đã được sửa đổi để chia sẻ thêm về cách xây dựng bảng điều khiển bên mang lại trải nghiệm tốt nhất cho người dùng.
Bạn có thể cập nhật tin tức về tiện ích của Chrome bằng cách truy cập vào trang Có gì mới. Nếu có câu hỏi hoặc cần trợ giúp về Side Panel API (API Bảng điều khiển bên), bạn có thể truy cập vào nhóm trên Google Groups về tiện ích Chromium.