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 üst kısmında, eklentiyi tanımlayan ve kart (temelde eklentinin kullanıcı arayüzünün "sayfası") gösteren bir araç çubuğu bulunur. Google Apps Komut Dosyası, Card nesnelerini kullanarak proje kodundaki kartları temsil eder.
Kart anatomisi
Kart, tasarladığınız 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 ve daha iyi performans için 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, kart bölümlerine eklenemezler. 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 gezinmeyi 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 ok da sağlanır. Başlık ve geri ok işlevini kodlamanız gerekmez. Bu işlem, eklentinizdeki kartları tanımladığınızda otomatik olarak yapılır.
Eklentileri tasarlarken, kartlar sınırlı bir ekran alanını paylaşmak zorunda olduğundan aynı anda gösterdiğiniz kart sayısını sınırlamanız önerilir. Ayrıca, kartlarda gereksiz karmaşıklık olmaması da önemlidir.
Performans nedeniyle, bir karta 100'den fazla widget veya 100 kart bölümü ekleyemezsiniz.