Kart tabanlı eklentiler, kenar çubuğunda bir panel olarak (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 (temel olarak eklentinin kullanıcı arayüzünün bir "sayfası") gösteren bir araç çubuğu bulunur. Apps Komut Dosyası, proje kodundaki kartları Card nesnelerini kullanarak 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 ve isteğ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. İsteğe bağlı olarak bir bölümde metin bölüm başlığı bulunabilir. Kart bölümleri, kart üzerinde yatay bir çizgiyle birbirinden ayrılır. Özellikle büyük olan kart bölümleri, kullanıcıların gerektiğinde genişletebileceği veya daraltabileceği, otomatik olarak daraltılabilir bir bölüm olarak oluşturulur. Bir kartta en fazla 100 kart bölümü bulunabilir ve daha iyi performans için yalnızca birkaç bölüm bulunmalıdır.
Her kart bölümü bir veya daha fazla kullanıcı arayüzü widget'ı içerir. Widget'lar kullanıcıya bilgi veya etkileşimli kontroller sağlar. Kartlar ve kart bölümleri yapısal widget'lar olduğundan bunları bir kart bölümüne ekleyemezsiniz. Kart bölümünde en fazla 100 widget bulunabilir 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örüntüleyen bir Google Workspace eklentisinin, veri aldığı her e-tablo için ayrı bir kartı 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 gezinme kullanıyorsa eklenti ilk açıldığında, 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 bir geri oku da sağlanır. Başlık ve geri ok işlevini kodlamanız gerekmez. Bu işlem, eklentinizde kartları tanımladığınızda otomatik olarak yapılır.
Kartlar sınırlı miktarda ekran alanı paylaşmak zorunda olduğundan, eklentileri tasarlarken aynı anda görüntülediğiniz kart sayısını sınırlandırmanız önerilir. Ayrıca kartlarda gereksiz karmaşıklıktan kaçınmanız önerilir.