Reference Guide

Özellikler

Bu bölümde, abonelik düğmesi için <div> öğesinin nasıl oluşturulacağı açıklanmaktadır. Aşağıdaki listelerde, öğenin zorunlu ve isteğe bağlı özellikleri açıklanmaktadır. İsteğe bağlı özellikler, düğmenin düzeni ve temasını kontrol etmenizin yanı sıra kanalın abone sayısının gösterilip gösterilmeyeceğini seçmenizi de sağlar.

Gerekli özellikler

  • class: Değeri g-ytsubscribe olarak ayarlayın. Bu sınıf, <div> öğesini abonelik düğmesi için bir kapsayıcı olarak tanımlar ve YouTube'un, sonraki bölümde açıklandığı gibi yerleştirilmiş düğmeyi dinamik olarak yeniden boyutlandırmasını sağlar.

  • Aşağıdaki iki özellikten biri için bir değer belirtmeniz gerekir.

İsteğe bağlı özellikler

  • data-layout: Düğmenin biçimi. Geçerli özellik değerleri şunlardır:

    • default – Kullanıcının dilinde (kullanıcının dil ayarı veya konumu kullanılarak seçilir) bir oynatma düğmesi simgesi ve "abone ol" kelimesini gösterir.
    • full: Standart düğmenin yanı sıra kanalın avatarını ve kanal başlığını gösterir.

  • data-theme: Düğmede kullanılacak renk şemasını belirtir. Geçerli değerler default ve dark'dir. dark teması, düğmeleri daha koyu bir arka plan öğesinin üzerine yerleştiren uygulamalar için tasarlanmıştır.

  • data-count: Düğmede, kanalın abone sayısının gösterilip gösterilmeyeceğini belirtir. Düğmenin varsayılan davranışı, abone sayısını görüntülemek şeklindedir. Geçerli değerler default ve hidden'dir.

  • data-onytevent – Not: Bu özelliğin desteği sonlandırılmıştır.

Etkinlikler

Not: Abone Olma Düğmesi'nin subscribe ve unsubscribe etkinlikleri kullanımdan kaldırıldı. Benzer şekilde, daha önce etkinlik bildirimleri için bir dinleyici belirtmek üzere widget öğesine eklenebilen data-ytonevent özelliği de kullanımdan kaldırıldı.

Dinamik oluşturma

Yapılandırma aracındaki standart yerleştirme kodunu kullanmak yerine Subscribe Button öğesini dinamik olarak oluşturabilirsiniz. Bu yaklaşım, API'nin JavaScript'inin düğmeleri bulmak için tüm DOM öğesini geçmesini önler. Bu da düğme oluşturma süresini iyileştirebilir.

Google+ JavaScript API kapsamında Subscribe Button, abonelik düğmelerini dinamik olarak oluşturmak için kullanılabilecek standart go ve render yöntemlerini destekler. Örneğin, DOM ready etkinliği tetiklendiğinde mevcut olmayan bir düğmeyi (ör. AJAX ile güncellenen bir sayfada) oluşturmak için bu yöntemleri kullanabilirsiniz.

Yöntem Açıklama
gapi.ytsubscribe.go(
  opt_container
)		 Belirtilen kapsayıcıdaki tüm abonelik düğmelerini oluşturur. Oluşturmak istediğiniz abonelik düğmesi öğeleri zaten varsa bu yöntemi kullanın. Örneğin, uygulamanız bir Subscribe Button için <div> öğesinin tamamını döndüren bir AJAX isteği gönderiyorsa düğmeyi oluşturmak için go() yöntemini çağırın.
opt_container
Oluşturulacak abonelik düğmelerini içeren HTML öğesi. Öğenin kimliğini veya DOM öğesinin kendisini belirtin. Bu parametre eklenmezse sayfadaki tüm abonelik düğmeleri oluşturulur.
gapi.ytsubscribe.render(
  container,
  parameters
)		 Belirtilen kapsayıcıda Subscribe Button öğesini oluşturur. Subscribe Button öğesini içerecek öğe henüz mevcut değilse ve oluşturulması gerekiyorsa bu yöntemi kullanın.
kapsayıcı
, Subscribe Button öğesinin oluşturulacağı boş HTML öğesini tanımlar. Öğenin kimliğini veya DOM öğesinin kendisini belirtin.
parametreler
key:value çiftleri olarak abonelik düğmesi özelliklerini içeren bir nesne (ör. {"channel": "GoogleDevelopers", "layout": "full"}).

gapi.ytsubscribe.go ile düğme oluşturma

Aşağıdaki örnekte, bağlantı tıklandığında bir düğmeyi dinamik olarak oluşturmak için gapi.ytsubscribe.go yöntemini çağırmak üzere kullanacağınız kod gösterilmektedir.

Not: Yukarıdaki yapılandırma aracı, düğme seçeneklerini veya kodu güncellediğinizde yeni bir düğme oluşturmak için go yöntemini de kullanır.

gapi.ytsubscribe.render ile düğme oluşturma

Aşağıdaki örnekte, bağlantı tıklandığında bir düğmeyi dinamik olarak oluşturmak için gapi.ytsubscribe.render yönteminin nasıl çağrılacağı gösterilmektedir: