Google Workspace Eklentileri, genişlettikleri ana makine uygulamasının stili ve düzeniyle tutarlı olmalıdır. Tanıdık kontroller ve davranışları kullanarak kullanıcı arayüzünü doğal bir şekilde genişletmeleri gerekir. Burada sunulan yönergelerde yüksek kaliteli kullanıcı deneyimini teşvik eden metinleri, resimleri, kontrolleri ve marka öğelerini ele alma yöntemleri açıklanmaktadır.
Eklentiniz, eklenti çalışmasının ayrılmaz bir parçası olan ayrı web sayfaları açarsa (eklentinin ayarlar sayfası gibi) bu web sayfalarının da bu stil yönergelerine uyduğundan emin olun.
Metin ve resimler
Bu bölümde, eklentinizde metin ve resimleri doğru şekilde nasıl kullanacağınız açıklanmaktadır.
Eklenti adı
Eklentinizin adını proje manifestinde ve eklentinizi yayınlanmak üzere yapılandırırken yapılandırmanız gerekir. Bu ad, Google Workspace Marketplace girişi ve menüler gibi birçok yerde görünür. Ad seçerken:
- Yalnızca ilk harfler büyük olsun.
- Markanızın bir parçası olmadığı sürece noktalama işaretleri, özellikle de parantezler kullanmaktan kaçının.
- Kısa tutun. 15 veya daha az karakter kullanmanız önerilir. Uzun adlar, Google Workspace Marketplace listesinde ve başka yerlerde otomatik olarak kısaltılabilir.
- Eklenti adınıza "Google", "Gmail" veya diğer Google ürün adlarını eklemeyin.
- Eklenti adınıza "eklenti" kelimesini eklemeyin.
- Sürüm bilgilerini girmeyin.
Yazım stili
Çok fazla şey yazmanız gerekmez. Çoğu eylem; ikon, düzen ve kısa etiketlerle açıkça belirtilmelidir. Eklentinizin bir bölümünün kısa etiketlerin sağlayabileceğinden daha kapsamlı bir açıklamaya ihtiyacı olduğunu fark ederseniz, eklentinizi açıklayan ve bağlantısını açıklayan ayrı bir web sayfası oluşturmak en iyi uygulamadır.
Kullanıcı arayüzü metni yazarken:
- Normal tümce düzeni kullanın (özellikle düğmeler, etiketler ve kart işlemleri için).
- Jargon veya kısaltmalar içermeyen, kısa ve basit metinler tercih edin.
Evrensel işlemler ve kart işlemleri
Eklentinizde evrensel işlemler veya kart işlemleri kullanıyorsanız bunlar, tanımladığınız kartlarda menü öğeleri olarak görünür. Bu işlemler için bu menülerde kullanılacak metni seçebilirsiniz. Kullanılacak metni seçerken:
- Yalnızca eklentinizin adını tekrarlayan menü metinlerinden kaçının.
- Her menü öğesine "Çalıştır", "Yapılandır" veya "Oluştur" gibi bir işlem kelimesiyle başlayın.
- İşlemin görüntülediği kullanıcı arayüzü bileşenini değil, görevi açıklayın.
- İşleminiz bir iş akışıyla başlıyorsa ve eylemini açıklayan tek bir fiil yoksa buna "Başlat" adını verin.
- Kullanıcıyı büyük bir listede kaydırmaya zorlamamak için menü öğelerinin sayısını az tutun. Uygulanacak daha fazla işleminiz varsa, her birinde farklı işlemler içeren birden fazla kart kullanmayı düşünün.
Hata mesajları
Bir şeyler ters gittiğinde sade bir dil kullanmak önemlidir. Sorunu kullanıcının bakış açısından açıklayın ve nasıl düzeltilebileceğiyle ilgili öneride bulunun.
- Kullanıcının, kodunuzun attığı istisnaları görmesine izin vermeyin. Bunun yerine, istisnalara müdahale etmek için
try...catchifadelerini kullanın ve ardından kullanıcı dostu bir hata mesajı görüntüleyin. - Yayınlamadan önce, eklentinizin kullanıcı arayüzünde hata ayıklama bilgilerini görüntülemediğinden emin olun.
Yardım içeriği
Yardım bilgileri gösteren veya eklentinin işleyişini kullanıcıya açıklayan kartlar tasarlamak isteyebilirsiniz. Eklentiniz için yardım içeriği oluşturacaksanız, şunları unutmayın:
- Mümkün olduğunda, talimatları madde işaretli veya numaralı listede gösterin. Adlandırılmış kullanıcı arayüzü öğelerine açık referanslarla kullanıcıları nihai sonuca yönlendirin.
- Talimatlarınızda bir elektronik tabloyu belirli bir şekilde hazırlamak gibi tüm gerekliliklerin net bir şekilde açıklandığından emin olun.
- Destekleyici web sayfaları gibi harici yardım içeriğine bağlantı verebilirsiniz.
Resimler
Eklentinizde kullanılan resimler, yerleşik simge türlerinden biri veya bir URL ile belirtilen, herkese açık olarak barındırılan bir resimdir. Barındırılan resimler kullanırken, eklentinizi kullanabilecek herkesin bu resimlere erişebildiğinden emin olun.
Denetimler
Bu bölümde etkileşimli widget'lar için kullanıcı deneyimi yönergeleri sunulmaktadır.
Düğmeler
Kullanıcı arayüzünüzün ana işlemlerini kontrol etmek için diğer widget'lar yerine düğmeleri kullanın.
- Çoğu metin düğmesi etiketi bir fiil ile başlamalıdır.
- Çoğu durumda, düğme satırları üç veya daha az düğmeyle sınırlanmalıdır.
SüslüMetin
DecoratedText widget'ları, simgeler, düğmeler veya anahtarlarla metin içeriği sunmanıza olanak sağlar.
- Metin içeriğinde cümle düzeni kullanın.
- DecoratedText widget'ının metni, kullanılabilir alana sığmıyorsa kısaltılır. Bu nedenle, metin içeriğini her zaman mümkün olduğunca kısa tutmaya çalışın.
Seçim girişleri
Eklentinizde açılır seçim kutuları, onay kutuları ve radyo düğmeleri gibi çeşitli seçim giriş widget'larını kullanabilirsiniz.
- Kullanıcılar birden fazla seçenek belirleyebiliyorsa veya hiçbir seçenek belirtmiyorsa onay kutularını kullanın. Tam olarak bir seçeneğin belirlenmesi gerektiğinde radyo düğmelerini (veya bir seçim menüsünü) kullanın. Kullanıcı arayüzünde yer açmaya çalışırken kısa bir alternatif listesi sağlarken açılır listeleri kullanın.
- Her seçeneğe atanan metin için cümle düzeni kullanın.
- Büyük, tersine çevrilmesi zor işlemleri tetiklemek için seçim değişiklikleri yapmaktan kaçının, çünkü kullanıcılar seçim yaparken genellikle hata yaparlar. Bunun yerine, mevcut seçim değerlerini okuyan ve ardından işlemi tetikleyen bir düğme eklemeyi düşünün.
- Açılır listelerde, seçenekleri alfabetik olarak veya tüm kullanıcıların anlayabileceği mantıksal bir şemaya göre sıralayın (örneğin, Pazar veya Pazartesi'den başlayarak haftanın günlerini sırayla sunmak).
- Belirli bir seçim girişi widget'ındaki seçenek sayısını makul bir sayıyla sınırlandırın. Çok fazla seçenek olması durumunda kullanıcılar widget'ı kullanmakta zorlanabilir. Bu gibi durumlarda seçeneği farklı kategorilere ve birden fazla widget'a bölebilirsiniz.
Metin girişleri
Metin girişleri, kullanıcıların dize verilerini girebileceği bir alan sağlar.
- Kullanıcı türünü belirli bir olası giriş grubundan biri yapmak için metin girişi kullanmayın. Bunun yerine açılır liste kullanın.
- Kullanıcının metni doğru biçim ve içerikle girmesini sağlamak için ipuçlarından ve önerilerden yararlanın.
- Girilecek metin birkaç kelimeden uzunsa çok satırlı metin girişleri kullanın.
Marka
Bu bölümde, eklenti arayüzünüze marka öğeleri eklemek için kullanıcı deneyimi yönergeleri sunulmaktadır.
Eklentinizde
Eklenti kullanıcı arayüzünüze marka eklemek istiyorsanız kısa ve anlaşılır ifadeler kullanın. Bu sayede kullanıcılar eklentinizin işlevlerine odaklanabilir.
- Eklentinizin tüm özellikleri marka bilinci oluşturma kurallarına uygun olmalıdır.
- "Google", "Gmail" kelimesini veya diğer Google ürün adlarını eklemeyin.
- Değiştirilmiş olsalar bile Google ürün simgelerini eklemeyin.
- Markalama metninizde "eklenti" kelimesini kullanmayın.
- Markalama metni birkaç kelimeden uzun olmamalıdır.
Google Workspace Marketplace'te
Eklentinizi yayınlanmak üzere yapılandırırken Google Workspace Marketplace girişini oluşturmak için çeşitli grafik ve metin öğeleri sağlarsınız.
Mağaza girişinizin tüm özellikleri ve bu öğeler marka bilinci oluşturma kurallarına uygun olmalıdır.