Etkinlikleri Tetikleme

Görselleştirmeniz bir ana makine sayfasının almak üzere kaydedebileceği etkinlikleri tetikleyebilir. Etkinlikler, kullanıcı işlemleri tarafından tetiklenebilir (örneğin, kullanıcı bir grafiği tıklar veya dahili olabilir): Örneğin, her 10 saniyede bir etkinlik tetikleme. Belirli etkinlikler tetiklendiğinde, muhtemelen o etkinliğe özel verilerle birlikte çağrılacak bir JavaScript yöntemi kaydedebilirsiniz.

Her görselleştirme kendi etkinliklerini tanımlar. Bu görselleştirmenin dokümanları, her etkinliğin ne zaman tetiklendiğini, ne anlama geldiğini ve etkinlik işleyicinize hangi bilgileri gönderdiğini açıklamalıdır (örneğin, kuruluş şeması görselleştirmesine bakın). Bu sayfada, bir görselleştirme oluşturucunun etkinlikleri nasıl tetikleyebileceği açıklanmaktadır. Müşterilerin etkinlik almak için nasıl kaydolabileceğini öğrenmek isterseniz Etkinlikleri Kullanma sayfasına göz atın.

Seçilebilir görselleştirmenin tetiklenmesi gereken bir etkinlik vardır: seçilecek etkinlik. Ancak, bu etkinliğin davranışı ve anlamı her görselleştirme tarafından tanımlanır.

Görselleştirme, draw yöntemi kullanıcıya kontrol döndürmesinin hemen ardından etkileşim için hazır değilse görselleştirmenin etkinleştirilmesi gerekir: Hazır etkinlik. Bu etkinliğin tam davranışı ve anlamı Hazır Etkinlik bölümünde tanımlanır.

Görselleştirme API'sı etkinliklerinin standart DOM etkinliklerinden ayrı ve farklı olduğunu unutmayın.

İçindekiler

  1. Etkinlik tetikleme
  2. Etkinlik Seçin
  3. Hazır etkinlik
  4. Daha Fazla Bilgi

Etkinlik tetikleme

Görselleştirmenizdeki bir etkinliği tetiklemek için google.visualization.events.trigger() işlevini çağırın. İşlev aşağıdaki parametreleri bekler:

  1. Kaynak görselleştirme (bu genellikle this değeridir).
  2. Etkinlik adı (dize).
  3. Etkinlik ayrıntıları (Object). Belirli etkinlik ayrıntılarının isteğe bağlı haritasıdır (ad/değer).

Aşağıdaki örnekte, bir görselleştirmenin seçilen etkinliği nasıl attığı gösterilmektedir: 

MyVisualization.prototype.onclick = function(rowIndex) {
  this.highlightRow(this.selectedRow, false); // Clear previous selection
  this.highlightRow(rowIndex, true); // Highlight new selection

  // Save the selected row index in case getSelection is called.
  this.selectedRow = rowIndex;

  // Fire a select event.
  google.visualization.events.trigger(this, 'select', {});
};

Barındırma sayfaları google.visualization.events.addListener() veya google.visualization.events.addOneTimeListener() numaralı telefonu arayarak etkinliklerinizi almak için kaydolabilir. Lütfen etkinleştirdiğiniz tüm etkinlikleri belgelendirin.

Seçme Etkinliği

"select" etkinliği, bir kullanıcının fare tıklaması sonucunda birçok görselleştirme tarafından düzenlenen standart bir etkinliktir. Bir etkinliği fare tıklamalarına yanıt olarak tetiklemeyi seçerseniz "select" etkinliğini burada açıklanan standart şekilde uygulamanız gerekir:

  1. Kullanıcı, görselleştirmenin içinden bazı verileri seçtiğinde "select" adlı bir etkinliği tetikleyin. Etkinlik, dinleme işlevlerine bağımsız değişkenler göndermez.
  2. getSelection() yöntemini, bağlı doküman bölümünde açıklandığı gibi gösterin. Bu yöntem, kullanıcının seçtiği veri öğelerinin dizinlerini döndürmelidir.
  3. Referans bölümünde açıklandığı gibi bir setSelection() yöntemi sunun. Ayrıca, etkinliklerin nasıl işleneceğini öğrenmek için etkinlikleri işleme sayfasına göz atın.

Hazır Etkinlik

Görselleştirme, yöntem olarak adlandırılan yöntem hazır olduğunda geliştiriciye bildirmek için standart şekilde çalışan bir "hazır" etkinlik tetiklemelidir. (Bununla birlikte, görselleştirmenin bu şekilde davranması kesin olarak gerekmez. Görselleştirmenizin dokümanlarını inceleyin.)

Genel olarak, "hazır" etkinliği ortaya çıkaran görselleştirmeler aşağıdaki spesifikasyonlarla tasarlanmıştır:

  • Hazır etkinlik, işleyiciye hiçbir özellik iletmez (işlev işleyiciniz parametreye parametre aktarılmasını beklememelidir).
  • Görselleştirme, etkileşim için hazır hale geldikten sonra hazır etkinliği tetiklemelidir. Görselleştirmenin çizimi eşzamansızsa, yalnızca draw yöntemi sona erdiğinde değil, etkileşim yöntemleri gerçekten çağrılabildiğinde etkinliğin tetiklenmesi önemlidir.
  • draw yöntemini çağırmadan önce bu etkinliğe bir dinleyici eklemeniz gerekir. Aksi takdirde, dinleyici ayarlanıncaya kadar etkinlik tetiklenebilir ve siz yakalayamazsınız.
  • Hazır etkinlik tetiklenmeden önce etkileşim yöntemlerini çağırarak bu yöntemlerin düzgün çalışmaması riskiyle karşı karşıya kalırsınız.

"Hazır" etkinliğini tetiklemeyen görselleştirmeler draw yöntemi sona erdikten hemen sonra etkileşim için hazır olur ve kontrolü kullanıcıya döndürür.

Daha Fazla Bilgi