Google Workspace eklentileri, ana uygulamanın kullanıcı arayüzünün kenar çubuğunda bilgi ve kullanıcı kontrolleri sunar. Eklentiler, ana tanımlayıcı araç çubuğu ve bir veya daha fazla karttan oluşur.
Her kart, eklentinizin kullanıcı arayüzünün belirli bir "sayfasını" temsil eder ve yeni bir karta gitmek genellikle yalnızca bu kartı oluşturup dahili bir kart yığınına göndermekle ilgilidir. Zengin bir etkileşim deneyimi için kartlar arasında gezinme akışları tanımlayabilirsiniz.
Kartlar bağlamsız veya bağlamsal olabilir. Bağlama duyarlı kartlar, ana uygulama belirli bir bağlamdayken kullanıcıya gösterilir. Örneğin, Gmail iletisi veya Takvim etkinliği açarken. Bağlam dışı kartlar (ör. ana sayfalar), kullanıcıya ana makinenin belirli bir bağlamı dışında sunulur. Örneğin, kullanıcı Gmail gelen kutusunu, ana Drive klasörünü veya Takvim'i görüntülerken.
Apps Komut Dosyası'nda oluşturulan Google Workspace eklentileri, kartlardan kullanıcı arayüzleri oluşturmak için Card hizmetini kullanır. Diğer dillerde oluşturulan eklentilerin, arayüzün kart olarak oluşturulması için düzgün biçimlendirilmiş JSON döndürmesi gerekir.
Her kart bir başlık ve bir veya daha fazla kart bölümünden oluşur. Her bölüm bir dizi widget'tan oluşur. Widget'lar, kullanıcıya bilgi gösterir veya düğmeler gibi etkileşim kontrolleri sağlar.
Kart tabanlı arayüzlerin aşağıdaki avantajları vardır:
- Kart tabanlı arayüzler oluşturmak için HTML veya CSS bilgisi gerekmez.
- Kartlar ve widget'lar, kapsamlarını genişlettikleri Google Workspace uygulamalarıyla iyi çalışacak şekilde otomatik olarak biçimlendirilir.
Kart tabanlı arayüzler hem masaüstü hem de mobil cihazlarda çalışır ancak arayüzü yalnızca bir kez tanımlamanız gerekir.
Kart tabanlı arayüzler oluşturma
Kart tabanlı eklentiler oluştururken belirli kavramları ve tasarım kalıplarını anlamak önemlidir. Aşağıdaki kılavuzlar, etkili kart tabanlı eklentiler oluşturmak için ihtiyacınız olan bilgileri sağlar:
- Kartlar
- Ana sayfalar
- Widget'lar
- İşlemler
- Etkinlik nesneleri
- Kart oluşturma
- Etkileşimli kartlar oluşturma
- Kartlar arasında gezinme
- Evrensel işlemleri kullanma
- Metin girişlerine otomatik tamamlama ekleme
- Kullanıcı yerel ayarlarını ve saat dilimlerini kullanma
- Google dışı hizmetlere bağlanma
- Stil kılavuzu
- En iyi uygulamalar
Kart oluştururken ve kullanıcı arayüzü davranışını uygularken bu sayfalardan yararlanın. Ayrıca, eklentinizi uygularken referans olarak kullanabileceğiniz aşağıdaki ek örnekleri de faydalı bulabilirsiniz:
Google Workspace "Cats" eklentisiyle hızlı başlangıç
Bu eklenti örneğinde, birden fazla sayfa ve ana sayfa içeren basit bir Google Workspace eklenti kullanıcı arayüzü gösterilmektedir.
Google Workspace eklentisi: "Çevir"
Bu eklenti örneği, kullanıcıların Dokümanlar, E-Tablolar ve Slaytlar'da metin çevirmesine olanak tanıyan bir Google Workspace eklentisini gösterir.
Google Workspace eklentisi: "Takım Listesi"
Bu eklenti örneği, Gmail iletisi alıcıları, Drive dosyası düzenleyicileri veya Takvim etkinliği katılımcıları hakkında kullanıcı bilgilerini gösteren daha karmaşık bir Google Workspace eklentisi örneğini gösterir. Bu eklenti, kullanıcı bilgilerini almak için Directory API'yi kullandığından yalnızca bir alan içinde kullanılabilir.