Tài liệu tham khảo trung gian Iframe API

Trang tham khảo này mô tả cách tải iframe trung gian vào các trang HTML.

Tải Thư viện JavaScript Iframe trung gian

Đặt đoạn mã sau vào trang HTML bất kỳ mà bạn muốn gửi đến Google One Nhấn để hiển thị:

<script src="https://accounts.google.com/gsi/intermediate"></script>

API HTML

Bạn có thể tải iframe trung gian bằng cách thêm một phần tử HTML có thuộc tính mã nhận dạng được đặt thành g_id_intermediate_iframe. Xem đoạn mã mẫu sau:

<script src="https://accounts.google.com/gsi/intermediate"></script>
<div id="g_id_intermediate_iframe"
     data-src="https://example.com/onetap_iframe.html">
</div>

Phần tử có mã "g_id_intermediate_iframe"

Bạn có thể đặt các thuộc tính dữ liệu iframe trung gian trong mọi phần tử hiển thị hoặc ẩn, chẳng hạn như <div> và <span>. Yêu cầu duy nhất là mã nhận dạng phần tử phải được đặt thành g_id_intermediate_iframe. Đừng đặt mã nhận dạng này trên nhiều phần tử.

Bảng sau đây liệt kê các thuộc tính dữ liệu cùng với nội dung mô tả của các thuộc tính đó:

Thuộc tính
data-src URI của iframe trung gian tính năng Một lần chạm
data-done Phương pháp gọi lại JavaScript sẽ được kích hoạt khi trải nghiệm người dùng bằng một lần chạm hoàn tất.

data-src

Thuộc tính này là URI của iframe trung gian chỉ với một lần chạm. Hãy xem bảng sau để biết thêm thông tin:

Loại Bắt buộc Ví dụ:
chuỗi Có data-src="https://example.com/onetap_iframe.html"

hoàn tất dữ liệu

Thuộc tính này là phương thức gọi lại JavaScript được kích hoạt khi trải nghiệm người dùng bằng một lần chạm hoàn tất.

Theo mặc định, trang nội dung sẽ được tải lại khi trải nghiệm người dùng bằng một lần chạm hoàn tất. Bạn có thể ghi đè hành vi mặc định bằng cách cung cấp lệnh gọi lại hoàn tất của riêng mình. Hãy xem bảng sau để biết thêm thông tin:

Loại Bắt buộc Ví dụ:
Chức năng Không bắt buộc data-done="onOneTapSuccess"

API JavaScript

Bạn có thể tải iframe trung gian bằng cách gọi phương thức JavaScript.

Phương thức: google.accounts.id.Initialize tới

Phương thức google.accounts.id.initializeIntermediate tải iframe trung gian dựa trên đối tượng cấu hình. Hãy xem mã ví dụ sau đây về phương thức:

google.accounts.id.initializeIntermediate(IntermediateConfig)

Ví dụ về mã sau đây triển khai phương thức google.accounts.id.initializeIntermediate bằng hàm onload:

<script>
  window.onload = function () {
    google.accounts.id.initializeIntermediate({
      src: 'https://example.com/intermediate'
    });
  };
</script>

Loại dữ liệu: MediumConfig

Bảng sau đây liệt kê các trường cùng với nội dung mô tả tương ứng:

Trường
src URI của iframe trung gian tính năng Một lần chạm
done Phương pháp gọi lại JavaScript sẽ được kích hoạt khi trải nghiệm người dùng bằng một lần chạm.

src

Trường này là URI của iframe trung gian chỉ với một lần chạm. Hãy xem bảng sau để biết thêm thông tin:

Loại Bắt buộc Ví dụ:
chuỗi Có src: "https://example.com/onetap_iframe.html"

done

Trường này là phương pháp gọi lại JavaScript sẽ được kích hoạt khi trải nghiệm người dùng bằng một lần chạm hoàn tất.

Theo mặc định, trang nội dung sẽ được tải lại khi trải nghiệm người dùng bằng một lần chạm hoàn tất. Bạn có thể ghi đè hành vi mặc định bằng cách cung cấp lệnh gọi lại hoàn tất của riêng mình. Hãy xem bảng sau để biết thêm thông tin:

Loại Bắt buộc Ví dụ:
Chức năng Không bắt buộc done: onOneTapSuccess