Kartlar

Kart tabanlı bir eklenti, kenar çubuğunda bölme 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 bir araç çubuğu bulunur ve bu araç çubuğu, normalde eklentinin kullanıcı arayüzünün bir "sayfası" olan bir kart görüntüler. Apps Komut Dosyası, Card nesnelerini kullanan proje kodundaki kartları temsil eder.

Kart anatomisi

Örnek eklenti kartı

Kart, tasarladığınız kullanıcı arayüzü öğelerinden oluşan bir gruptur. Kart aşağıdaki bölümlerden oluşur:

  • Kart başlığı. Bu ad, kartları tanımlar. Başlık metni vardır, isterseniz bir alt başlık ve simge de bulunabilir.
  • 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ümün isteğe bağlı olarak metin bölüm üstbilgisi olabilir. Kart bölümleri, yatay bir cetvel ile kart üzerinde birbirinden ayrılır. Bir kart bölümü özellikle büyükse otomatik olarak kullanıcıların gerektiğinde genişletebileceği veya daraltabileceği daraltılabilir bir bölüm halinde oluşturulur. Bir kartta 100'den fazla kart bölümü olamaz. Daha iyi performans elde edilebilmesi için kartta yalnızca birkaç kart bölümü bulunmalıdır.

  • Her kart bölümünde bir veya daha fazla kullanıcı arayüzü widget'ı bulunur. Widget'lar kullanıcıya bilgi veya etkileşimli kontroller sağlar. Kartlar ve kart bölümleri yapısal widget'lardır, bu nedenle bunları bir kart bölümüne ekleyemezsiniz. Bir kart bölümünde 100'den fazla widget bulunamaz ve en iyi performans için mümkün olduğunca basit olmalıdır.

Kartlar, belirli kullanıcı etkinlikleri veya veri kümeleriyle ilgili tasarlanmalıdır. Örneğin, Google E-Tablolar'dan alınan verileri gösteren bir Google Workspace eklentisinde, veri aldığı her sayfa için ayrı bir kart bulunabilir.

Birden fazla kart kullanma

Örnek eklenti kartı

Eklentiler genellikle birden fazla karttan oluşur. Bu kartları birden fazla kartlı 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 Google Workspace uygulaması ilk kez açıldığında, 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ık listesine dönmek için geri oku da eklenir. Başlık ve geri ok işlevlerini kodlamanız gerekmez. Bu, eklentinizde kartları tanımladığınızda otomatik olarak yapılır.

Eklentileri tasarlarken kartların sınırlı miktarda ekran alanı paylaşması gerektiğinden, aynı anda görüntülediğiniz kart sayısını sınırlandırmak en iyisidir. Kartlarda gereksiz karmaşıklıktan kaçınmak da en iyisidir.