Ghi đè các trang Chrome

Ghi đè trang là một cách để thay thế tệp HTML từ 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:

  • 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 trên 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 vào 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ý từ trình đơn Chrome hoặc mục Hiển thị toàn bộ nhật ký từ trình đơn Nhật ký trên máy Mac. 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 trang này bằng cách nhập URL chrome://newtab.
Lưu ý: Một tiện ích chỉ có thể ghi đè chỉ một trang. Ví dụ: một tiện ích không thể ghi đè cả Trình quản lý dấu trang và trang Lịch sử.

Cửa sổ ẩn danh được xử lý đặc biệt. Không thể ghi đè các trang Thẻ mới trong cửa sổ ẩn danh. Các trang ghi đè khác hoạt động trong cửa sổ ẩn danh, miễn là thuộc tính tệp kê khai ẩn danh được đặt thành "spanning" (là giá trị mặc định). Xem phần Lưu dữ liệu và chế độ ẩn danh trong phần Tổng quan để biết thêm thông tin 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 cho thấy 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 nội dung 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:

  • Đảm bảo tốc độ nhanh và kích thước trang nhỏ. 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 thực hiện những việc có thể mất nhiều thời gian. Ví dụ: tránh tìm nạp đồng bộ tài nguyên mạng hoặc cơ sở dữ liệu.
  • Thêm tiêu đề vào trang. 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. Dưới đây là ví dụ về cách chỉ định tiêu đề: <title>New Tab</title>
  • Đừng dựa vào trang có tiêu điểm là bàn phím. Thanh địa chỉ luôn là tiêu điểm đầu tiên khi người dùng tạo một thẻ mới.
  • Đừng cố 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 một chút của trang Thẻ mới mặc định (với các trang hàng đầu, trang đóng gần đây, mẹo, hình nền giao diện, v.v.) chưa tồn tại. Cho đến khi chúng thực hiện, bạn nên cố gắng tạo ra một nội dung hoàn toàn khác.

Ví dụ

Xem mẫu ghi đè.