Tetikleme Etkinlikleri

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

Her görselleştirme kendi etkinliklerini tanımlar. Bu görselleştirmeye ilişkin dokümanlarda her bir etkinliğin ne zaman tetiklendiği, ne anlama geldiği ve etkinlik işleyicinize hangi bilgileri gönderdiği açıklanmalıdır (örneğin, kuruluş şeması görselleştirmesine bakın). Bu sayfada, görselleştirme oluşturucunun etkinlikleri nasıl tetikleyebileceği açıklanmaktadır. Müşterilerin etkinlikleri almak üzere nasıl kaydolabileceğini öğrenmek için Etkinlikleri Yönetme sayfasını inceleyin.

Seçilebilir bir görselleştirmenin tetiklemesi gereken bir etkinlik vardır: seçili etkinlik. Ancak bu etkinliğin davranışı ve anlamı her görselleştirmeyle tanımlanır.

Bir görselleştirme, draw yöntemi kullanıcının kontrolü kullanıcıya geri döndürmesinden hemen sonra etkileşim için hazır değilse görselleştirme, "hazır etkinlik" olarak etkinleşmelidir. Bu etkinliğin tam davranışı ve anlamı Hazır Etkinlik bölümünde tanımlanmıştır.

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

İçindekiler

  1. Etkinlik tetikleme
  2. Select Etkinlik
  3. Hazır Etkinliği
  4. Daha Fazla Bilgi

Etkinliği Tetikleme

Görselleştirmenizden bir etkinlik tetiklemek için google.visualization.events.trigger() işlevini çağırın. İşlev aşağıdaki parametrelerin olmasını bekler:

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

Aşağıdaki örnekte bir görselleştirmenin select etkinliğini nasıl yayınladığı 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ı, etkinliklerinizi almak için google.visualization.events.addListener() veya google.visualization.events.addOneTimeListener() numaralı telefonu arayarak kaydolabilir. Tetiklediğiniz tüm etkinlikleri ayrıntılı bir şekilde belgelediğinizden emin olun.

Select Etkinlik

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

  1. Kullanıcı görselleştirme içinde bazı verileri seçtiğinde "select" adlı bir etkinliği tetikleyin. Etkinlik, dinleme işlevlerine herhangi bir bağımsız değişken göndermez.
  2. getSelection() yöntemini bağlı belge bölümünde açıklandığı şekilde kullanıma sunun. Bu yöntem, kullanıcının seçtiği data öğelerinin dizinlerini döndürmelidir.
  3. Referans bölümünde açıklandığı şekilde bir setSelection() yöntemi sunun. Etkinliklerin nasıl işleneceğini öğrenmek için sevkiyata hazırlık etkinlikleri sayfasına da bakın.

Hazır Etkinliği

Tüm görselleştirmeler, görselleştirme denilen yöntemler denilen işlenmeye hazır olduğunda bunu geliştiriciye bildirmek için standart bir şekilde çalışan "hazır" etkinliği tetiklemelidir. (Bununla birlikte, bir görselleştirmenin bu şekilde davranması için mutlak bir gereksinim yoktur. Görselleştirmenizle ilgili dokümanları kontrol edin).

Genel olarak, "hazır" etkinliğini gösteren görselleştirmeler aşağıdaki spesifikasyonlarla tasarlanmıştır:

  • Hazır etkinliği, işleyiciye herhangi bir özellik iletmez (işlev işleyiciniz, kendisine herhangi bir parametrenin aktarılmasını beklememelidir).
  • Görselleştirme, etkileşime hazır hale geldikten sonra hazır etkinliği tetikler . Görselleştirmenin çizimi eşzamansızsa etkinliğin yalnızca draw yöntemi sona erdiğinde değil, etkileşim yöntemleri gerçekten çağrılabildiği zaman tetiklenmesi önemlidir.
  • Bu etkinliğe işleyici eklenmesi, draw yöntemi çağrılmadan önce yapılmalıdır. Aksi takdirde etkinlik, işleyici oluşturulmadan önce tetiklenebilir ve etkinliği yakalayamazsınız.
  • Hazır etkinlik tetiklenmeden önce etkileşim yöntemlerini çağırarak bu yöntemlerin düzgün çalışmama riskini alırsınız.

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

Daha Fazla Bilgi