Tài liệu tham khảo về API JavaScript hỗ trợ iframe trung gian

Trang tham khảo này mô tả API JavaScript hỗ trợ iframe trung gian, được One Tap sử dụng để thao tác với iframe trung gian trong trải nghiệm người dùng tiếp theo.

Hãy xem hướng dẫn Tích hợp tính năng Một lần chạm bằng iframe để tìm hiểu cách sử dụng iframe trung gian.

Bảng sau đây liệt kê tất cả các phương thức hiện có và hành vi của các phương thức đó.

Tải Thư viện JavaScript hỗ trợ iframe trung gian

Đặt đoạn mã sau vào bất kỳ trang HTML nào mà bạn muốn tải iframe trung gian:

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

Phương thức: google.accounts.id.intermediate.verifyParentOrigin

Phương thức google.accounts.id.intermediate.verifyParentOrigin thực hiện quy trình xác minh nguồn gốc của thành phần mẹ. Hãy xem ví dụ về mã sau đây của phương thức:

google.accounts.id.intermediate.verifyParentOrigin(
    origins, verifiedCallback, verificationFailedCallback)

Ví dụ về mã sau đây cho thấy cách chỉ hiển thị giao diện người dùng sau khi nguồn gốc gốc được xác minh:

<script>
  window.onload = () => {
    google.accounts.id.intermediate.verifyParentOrigin(
        "https://example.com", showUI, showError);
  };
</script>

Bảng sau đây liệt kê các tham số:

nguồn gốc

Các nguồn gốc được phép nhúng iframe trung gian. Hãy xem bảng sau để biết thêm thông tin:

Bảng sau đây liệt kê các loại giá trị được hỗ trợ và nội dung mô tả về các loại giá trị đó.

verifiedCallback

Trường này là một phương thức gọi lại JavaScript được kích hoạt khi nguồn gốc mẹ hiện tại được phép nhúng iframe trung gian.

verificationFailedCallback

Trường này là một phương thức gọi lại JavaScript được kích hoạt khi nguồn gốc mẹ hiện tại không được phép nhúng iframe trung gian.

Phương thức: google.accounts.id.intermediate.notifyParentClose

Phương thức google.accounts.id.intermediate.notifyParentClose thông báo cho khung mẹ đóng iframe trung gian khi bỏ qua quy trình UX của tính năng Một lần chạm. Hãy xem ví dụ về mã sau đây của phương thức:

google.accounts.id.intermediate.notifyParentClose()

Phương thức: google.accounts.id.intermediate.notifyParentDone

Phương thức google.accounts.id.intermediate.notifyParentDone thông báo cho khung mẹ đóng iframe trung gian và làm mới trạng thái đăng nhập. Hãy xem ví dụ về mã sau đây của phương thức:

google.accounts.id.intermediate.notifyParentDone()

Phương thức: google.accounts.id.intermediate.notifyParentResize

Phương thức google.accounts.id.intermediate.notifyParentResize thông báo cho khung mẹ để đổi kích thước iframe trung gian. Hãy xem ví dụ về mã sau đây của phương thức:

google.accounts.id.intermediate.notifyParentResize(height)

chiều cao

Chiều cao mới tính bằng pixel. Đây là trường bắt buộc. Giá trị phải là một số không âm.

Nếu tham số chiều cao lớn hơn 0, thì iframe trung gian sẽ được đặt thành chiều cao mới. Nếu tham số chiều cao là 0, thì iframe trung gian sẽ trở nên vô hình. Một iframe ẩn chưa đóng. Bạn có thể cho thấy cửa sổ này sau bằng một lệnh gọi phương thức đổi kích thước khác.

Phương thức: google.accounts.id.intermediate.notifyParentTapOutsideMode

Phương thức google.accounts.id.intermediate.notifyParentTapOutsideMode thông báo cho khung mẹ biết liệu có nên huỷ iframe trung gian khi người dùng nhấp vào bên ngoài iframe trung gian hay không. Hãy xem ví dụ về mã sau đây của phương thức:

google.accounts.id.intermediate.notifyParentTapOutsideMode(cancel)

hủy

Giá trị boolean bắt buộc này cho biết có huỷ iframe trung gian khi người dùng nhấp vào bên ngoài iframe trung gian hay không.