Thuộc tính
Phần này giải thích cách tạo phần tử <div> cho nút đăng ký. Các danh sách dưới đây giải thích các thuộc tính bắt buộc và không bắt buộc của phần tử. Các thuộc tính không bắt buộc cho phép bạn kiểm soát bố cục và giao diện của nút cũng như chọn có hiển thị số người đăng ký của kênh hay không.
Thuộc tính bắt buộc
-
class– Đặt giá trị thànhg-ytsubscribe. Lớp này xác định phần tử<div>là vùng chứa cho nút đăng ký và cho phép YouTube thay đổi kích thước nút được nhúng một cách linh hoạt như giải thích trong phần tiếp theo. -
Bạn phải chỉ định giá trị cho một trong hai thuộc tính sau:
data-channel– Tên của kênh được liên kết với nút. Giá trị mẫu:GoogleDevelopers.data-channelid– Mã nhận dạng kênh liên kết với nút. Giá trị mẫu:UC_x5XG1OV2P6uZZ5FSM9Ttw. Bạn có thể truy xuất mã nhận dạng kênh trong phần cài đặt tài khoản YouTube hoặc bằng cách sử dụng APIs Explorer ở cuối tài liệu này. Tìm hiểu thêm về cách sử dụng mã nhận dạng kênh.
Thuộc tính không bắt buộc
-
data-layout– Định dạng của nút. Giá trị thuộc tính hợp lệ là:default– Hiển thị biểu tượng nút phát và từ "đăng ký" bằng ngôn ngữ của người dùng. Ngôn ngữ này được chọn bằng chế độ cài đặt ngôn ngữ hoặc vị trí của người dùng.full– Hiển thị hình đại diện và tiêu đề kênh ngoài nút tiêu chuẩn.
-
data-theme– Chỉ định bảng phối màu sẽ dùng cho nút. Các giá trị hợp lệ làdefaultvàdark. Giao diệndarkdành cho những ứng dụng đặt các nút l��n một phần tử nền tối hơn. -
data-count– Cho biết nút này có hiển thị số người đăng ký của kênh hay không. Hành vi mặc định của nút này là hiển thị số người đăng ký. Các giá trị hợp lệ làdefaultvàhidden. -
data-onytevent– Lưu ý: Thuộc tính này không còn được dùng nữa.
Sự kiện
Lưu ý: Các sự kiện subscribe và unsubscribe của Nút Đăng ký không còn được dùng nữa. Tương tự, thuộc tính data-ytonevent (trước đây có thể được thêm vào phần tử tiện ích để chỉ định một trình nghe cho thông báo sự kiện) cũng đã không được dùng nữa.
Kết xuất động
Ngoài cách sử dụng mã nhúng tiêu chuẩn trong công cụ định cấu hình, bạn có thể kết xuất Subscribe Button một cách linh động. Phương pháp này ngăn JavaScript của API duyệt qua toàn bộ DOM để xác định vị trí các nút, điều này có thể cải thiện thời gian kết xuất nút.
Là một phần của Google+ JavaScript API, Subscribe Button hỗ trợ các phương thức go và render tiêu chuẩn. Bạn có thể dùng các phương thức này để kết xuất nút đăng ký một cách linh động. Ví dụ: bạn có thể sử dụng các phương thức này để hiển thị một nút không xuất hiện khi sự kiện DOM ready kích hoạt, chẳng hạn như trên một trang được cập nhật bằng AJAX.
| Phương thức | Mô tả |
|---|---|
gapi.ytsubscribe.go( |
Hiển thị tất cả các nút đăng ký trong vùng chứa được chỉ định. Hãy sử dụng phương thức này nếu các phần tử nút đăng ký mà bạn muốn hiển thị đã tồn tại. Ví dụ: nếu ứng dụng của bạn gửi một yêu cầu AJAX trả về phần tử <div> hoàn chỉnh cho một Subscribe Button, hãy gọi phương thức go() để hiển thị nút.
|
gapi.ytsubscribe.render( |
Hiển thị Subscribe Button trong vùng chứa được chỉ định. Sử dụng phương thức này nếu phần tử sẽ chứa Subscribe Button chưa tồn tại và cần được tạo.
|
Kết xuất nút bằng gapi.ytsubscribe.go
Ví dụ bên dưới cho thấy mã mà bạn sẽ dùng để gọi phương thức gapi.ytsubscribe.go nhằm kết xuất động một nút khi người dùng nhấp vào đường liên kết.
Lưu ý: Công cụ định cấu hình ở trên cũng sử dụng phương thức go để hiển thị một nút mới khi bạn cập nhật các lựa chọn hoặc mã của nút.
Kết xuất nút bằng gapi.ytsubscribe.render
Ví dụ dưới đây minh hoạ cách gọi phương thức gapi.ytsubscribe.render để kết xuất động một nút khi người dùng nhấp vào đường liên kết: