Kart tabanlı Google Workspace eklentileri, kenar çubuğunda bir bölme (veya mobil cihazlarda menüden erişilen başka bir etkinlik penceresi) olarak görünür. Eklentinin, eklentiyi tanımlayan ve kart (temelde eklentinin kullanıcı arayüzünün "sayfası") görüntüleyen bir üst araç çubuğu vardır. Google Apps Komut Dosyası, Card nesnelerini kullanarak proje kodundaki kartları temsil eder.
Kart anatomisi
Kart, tasarladığınız bir kullanıcı arayüzü öğeleri grubudur. Kartlar aşağıdaki bölümlerden oluşur:
- Kart başlığı. Bu, kartları tanımlar. Başlık metni içerir. İsteğe bağlı olarak alt başlık ve simge de içerebilir.
Bir veya daha fazla kart bölümü. Bunlar, kartın kullanıcı arayüzü alanının alt bölümleridir. Bir bölümde metin bölüm başlığı olabilir. Kart bölümleri, kartta yatay bir çizgiyle birbirinden ayrılır. Bir kart bölümü çok büyükse otomatik olarak daraltılabilir bir bölüm olarak oluşturulur. Kullanıcılar bu bölümü gerektiğinde genişletebilir veya daraltabilir. Bir kartta en fazla 100 kart bölümü olabilir. Daha iyi performans için kartta yalnızca birkaç bölüm olmalıdır.
Her kart bölümü bir veya daha fazla kullanıcı arayüzü widget'ı içerir. Widget'lar, kullanıcılara bilgi veya etkileşimli kontroller sağlar. Kartlar ve kart bölümleri yapısal widget'lardır. Bu nedenle, bunları kart bölümüne ekleyemezsiniz. Bir kart bölümünde en fazla 100 widget olabilir ve en iyi performans için mümkün olduğunca kısa olmalıdır.
Kartları belirli kullanıcı etkinlikleri veya veri kümeleri etrafında tasarlamanız gerekir. Örneğin, Google E-Tablolar'dan alınan verileri gösteren bir Google Workspace eklentisi, veri çektiği her sayfa için ayrı bir karta sahip olabilir.
Birden fazla kart kullanma
Eklentiler genellikle birden fazla karttan oluşur. Bu kartları temel gezinme için liste olarak yapılandırabilir veya kullanıcının kartlar arasında nasıl hareket edeceğini kontrol etmek için daha karmaşık gezinme yöntemleri yapılandırabilirsiniz. Ayrıntılar için Birden fazla kartla temel gezinme başlıklı makaleyi inceleyin.
Eklenti temel gezinme özelliğini kullanıyorsa eklenti ilk kez açıldığında, eklentinin genişlettiği Google Workspace uygulaması kart başlıklarının bir listesini oluşturur ve bunları kullanıcıya sunar. Kart başlığını tıkladığınızda ilgili kart açılır. Kart başlığı listesine dönmek için geri oku da sağlanır. Başlık ve geri ok işlevini kodlamanız gerekmez. Bu işlevler, eklentinizdeki kartları tanımladığınızda otomatik olarak yapılır.
Eklentileri tasarlarken, kartlar sınırlı miktarda ekran alanını paylaşmak zorunda olduğundan, aynı anda gösterdiğiniz kart sayısını sınırlamanız en iyisidir. Ayrıca, kartlarda gereksiz karmaşıklık oluşturmaktan kaçınmanız da önerilir.
Performans nedeniyle, bir karta 100'den fazla widget veya 100 kart bölümü ekleyemezsiniz.