Kart tabanlı eklentiler, 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. Apps Komut Dosyası, proje kodundaki kartları Card nesneleriyle temsil eder.
Kart anatomisi
Kart, tasarladığınız bir grup kullanıcı arayüzü öğesidir. 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 isteğe bağlı olarak metin bölümü başlığı bulunabilir. Kart bölümleri, kartta yatay bir çizgiyle birbirinden ayrılır. Bir kart bölümü özellikle 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 basit 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ı birden fazla kartla temel gezinme için basit bir 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.
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 en iyisidir. Ayrıca, kartlarda gereksiz karmaşıklık olmaması da önemlidir.