Ghi đè các trang Chrome

Các trang ghi đè là một cách để thay thế một tệp HTML trong tiện ích của bạn bằng một trang mà Google Chrome thường cung cấp. Ngoài HTML, trang ghi đè thường có mã CSS và JavaScript.

Tiện ích có thể thay thế bất kỳ trang nào trong số các trang sau đây:

  • Trình quản lý dấu trang: Trang xuất hiện khi người dùng chọn mục trong trình đơn Trình quản lý dấu trang từ trình đơn Chrome hoặc trên máy Mac, mục Trình quản lý dấu trang từ trình đơn Dấu trang. Bạn cũng có thể truy cập trang này bằng cách nhập URL chrome://bookmarks.
  • Nhật ký: Trang xuất hiện khi người dùng chọn mục trong trình đơn Nhật ký trên Chrome hoặc trên máy Mac, mục Hiển thị Toàn bộ Lịch sử từ trình đơn Lịch sử. Bạn cũng có thể truy cập vào trang này bằng cách nhập URL chrome://history.
  • Thẻ mới: Trang xuất hiện khi người dùng tạo một thẻ hoặc cửa sổ mới. Bạn cũng có thể truy cập vào trang này bằng cách nhập URL chrome://newtab.
Lưu ý: Một tiện ích đơn lẻ có thể ghi đè chỉ một trang. Ví dụ: một tiện ích không thể ghi đè cả trang Trình quản lý dấu trang và trang Nhật ký.

Cửa sổ ẩn danh được xử lý đặc biệt. Bạn không thể ghi đè các trang Thẻ mới trong cửa sổ ẩn danh. Các trang ghi đè khác sẽ hoạt động trong cửa sổ ẩn danh miễn là thuộc tính tệp kê khai ẩn danh đặt thành "spanning" (là giá trị mặc định). Xem Lưu dữ liệu và chế độ ẩn danh trong Tổng quan để biết thêm chi tiết về cách bạn nên xử lý cửa sổ ẩn danh.

Các ảnh chụp màn hình sau đây hiển thị trang Thẻ mới mặc định rồi đến trang Thẻ mới tuỳ chỉnh.

Trang thẻ mới mặc định

Trang thẻ mới tuỳ chỉnh

Tệp kê khai

Đăng ký một trang ghi đè trong tệp kê khai tiện ích như sau:

{
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

Đối với PAGE_TO_OVERRIDE, hãy thay thế một trong các tham số sau:

  • bookmarks
  • history
  • newtab

Mẹo

Để có một trang ghi đè hiệu quả, hãy làm theo các nguyên tắc sau:

  • Tạo nhanh và nhỏ cho trang của bạn. Người dùng mong muốn các trang trình duyệt tích hợp sẵn sẽ mở ngay lập tức. Tránh làm những việc có thể mất nhiều thời gian bất cứ lúc nào. Ví dụ: tránh tìm nạp đồng bộ các tài nguyên mạng hoặc cơ sở dữ liệu.
  • Thêm tiêu đề vào trang của bạn. Nếu không, mọi người có thể thấy URL của trang và điều này có thể gây nhầm lẫn. Sau đây là ví dụ về chỉ định tiêu đề: <title>New Tab</title>
  • Đừng phụ thuộc vào trang có tiêu điểm bàn phím. Thanh địa chỉ luôn được lấy tiêu điểm trước tiên khi người dùng tạo một thẻ mới.
  • Đừng tìm cách mô phỏng trang Thẻ mới mặc định. Các API cần thiết để tạo phiên bản được sửa đổi đôi chút của trang Thẻ mới mặc định—với trang, các trang đã đóng gần đây, mẹo, hình nền chủ đề, v.v.—chưa tồn tại. Cho đến chúng làm, bạn nên cố gắng tạo ra một điều gì đó hoàn toàn khác.

Ví dụ

Xem phần ghi đè mẫu.