API JavaScript hỗ trợ trung gian Iframe

Trang tham khảo này mô tả API JavaScript hỗ trợ Iframe trung gian, cho phép bạn thao tác iframe trung gian trong trải nghiệm người dùng tiếp theo.

Lưu ý: Xem phần Tích hợp một lần nhấn qua Iframe để biết một số thông tin cơ bản về iframe trung gian và trải nghiệm người dùng sau này.

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

Phương pháp
verifyParentOrigin	thực hiện quy trình xác minh nguồn gốc gốc
notifyParentClose	thông báo cho khung gốc, luồng bỏ qua trải nghiệm người dùng bằng một lần chạm
notifyParentDone	thông báo cho khung mẹ về quy trình trải nghiệm người dùng bằng một lần chạm
notifyParentResize	thông báo cho khung gốc để đổi kích thước iframe trung gian
notifyParentTapOutsideMode	thông báo cho khung mẹ về việc huỷ iframe trung gian khi người dùng nhấp vào bên ngoài iframe trung gian

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

Đặt đoạn mã sau đây 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. Xem mã ví dụ sau của phương thức:

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

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

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

Bảng sau trình bày các tham số:

Thông số
origins	Các nguồn gốc được phép nhúng iframe trung gian.
verifiedCallback	Phương thức gọi lại JavaScript sẽ được kích hoạt khi nguồn gốc hiện tại được phép nhúng iframe trung gian.
verificationFailedCallback	Phương thức gọi lại JavaScript sẽ được kích hoạt khi nguồn gốc hiện tại không được phép nhúng iframe trung gian.

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:

Loại	Bắt buộc	Ví dụ:
chuỗi, mảng chuỗi hoặc hàm	Không bắt buộc	allowed_parent_origin: "https://example.com"

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

Loại giá trị
string	Một URI miền duy nhất.	"https://example.com"
string array	Một mảng các URI miền.	"https://news.example.com,https://local.example.com"

Lưu ý: Một chuỗi có URI được phân tách bằng dấu phẩy là không hợp lệ. Thay vào đó, hãy sử dụng đối tượng Mảng JavaScript.

Đã xác minh lại

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

verifyFailedCallback

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

Cảnh báo: nếu trang nội dung không phản hồi yêu cầu xác minh miền, thì quy trình xác minh sẽ đợi vĩnh viễn. Trong trường hợp này, cả verifiedCallback và verificationFailedCallback đều sẽ không được gọi.

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 quy trình trải nghiệm người dùng bằng một lần nhấn bị bỏ qua. Xem mã ví dụ sau của phương thức:

google.accounts.id.intermediate.notifyParentClose()

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

Phương thức google.accounts.id.intermediate.notifyParentClose thông báo cho khung mẹ để đóng iframe trung gian và làm mới trạng thái đăng nhập. Xem mã ví dụ sau 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 gốc để đổi kích thước iframe trung gian. Xem mã ví dụ sau đây về phương thức:

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

Lưu ý: Bạn không thể thay đổi chiều rộng của iframe trung gian.

độ cao

Chiều cao mới tính bằng pixel. Đây là trường bắt buộc. Giá trị này phải là 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, iframe trung gian sẽ không hiển thị. Một iframe ẩn không bị đóng. Sau đó, nó có thể được hiển thị 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ẹ về việc huỷ iframe trung gian khi người dùng nhấp vào bên ngoài iframe trung gian. Xem mã ví dụ sau đây về phương thức:

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

hủy

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