Google Workspace eklentileri, genişlettikleri ana uygulamanın stili ve düzeniyle tutarlı olmalıdır. Aşina oldukları kontrolleri ve davranışları kullanarak kullanıcı arayüzünü doğal bir şekilde genişletmelidirler. Burada sunulan yönergelerde, metin, resim, kontrol ve markalamanın yüksek kaliteli bir kullanıcı deneyimi sağlayacak şekilde nasıl ele alınacağı açıklanmaktadır.
Eklentinizin çalışması için gerekli olan ayrı web sayfaları (ör. eklentinin ayarlar sayfası) açılıyorsa bu web sayfalarının da bu stil kurallarına uygun olduğundan emin olun.
Metin ve resimler
Bu bölümde, eklentinizde metin ve resimleri nasıl doğru şekilde kullanacağınız açıklanmaktadır.
Eklenti adı
Eklentinizin adını projenin manifest dosyasında ve yayın için eklentinizi yapılandırırken ayarlamanız gerekir. Ad, Google Workspace Marketplace girişi ve menüler gibi birçok yerde görünür. Ad seçerken:
- Başlık düzeni kullanın.
- Markanızın bir parçası değilse noktalama işaretlerinden (özellikle parantezlerden) kaçının.
- Kısa tutun. En fazla 15 karakter kullanın. Uzun adlar, Google Workspace Marketplace girişinde ve başka yerlerde otomatik olarak kısaltılabilir.
- Eklenti adınızda "Google", "Gmail" veya diğer Google ürün adlarını kullanmayın.
- Eklenti adınıza "eklenti" kelimesini eklemeyin.
- Sürüm bilgilerini eklemeyin.
Yazma stili
Çok fazla yazmanız gerekmez. Çoğu işlem; simgeler, düzen ve kısa etiketlerle net bir şekilde açıklanmalıdır. Eklentinizin bir bölümünün kısa etiketlerin sağlayabileceğinden daha kapsamlı bir açıklamaya ihtiyacı olduğunu düşünüyorsanız eklentinizi açıklayan ayrı bir web sayfası oluşturup bu sayfaya bağlantı vermeniz en iyi uygulamadır.
Kullanıcı arayüzü metni yazarken:
- Cümle büyük harfi kullanın (özellikle düğmeler, etiketler ve kart işlemleri için).
- Jargon veya kısaltma içermeyen kısa ve basit metinleri tercih edin.
Evrensel ve kart işlemleri
Eklentinizde evrensel işlemler veya kart işlemleri kullanıyorsanız bu işlemler, tanımladığınız kartlarda menü öğeleri olarak görünür. Bu işlemler için bu menülerde kullanılan metni seçebilirsiniz. Kullanılacak metni seçerken:
- Eklentinizin adını tekrarlayan menü metinlerinden kaçının.
- Her menü öğesini "Çalıştır", "Yapılandır" veya "Oluştur" gibi bir fiille başlatın.
- İşlemin gösterdiği kullanıcı arayüzü bileşenini değil, görevi açıklayın.
- İşleminiz bir iş akışı başlatıyorsa ve ne yaptığını açıklayan tek bir fiil yoksa "Başlat" olarak adlandırın.
- Kullanıcının uzun bir listede kaydırma yapmasını önlemek için menü öğelerinin sayısını az tutun. Uygulamanız gereken başka işlemler varsa her birinde farklı işlemler bulunan birden fazla kart kullanmayı düşünebilirsiniz.
Hata mesajları
Bir sorun olduğunda basit bir dil kullanmak önemlidir. Sorunu kullanıcının bakış açısıyla açıklayın ve nasıl düzeltileceğini önerin.
- Kullanıcının kodunuzun oluşturduğu istisnaları görmesine izin vermeyin. Bunun yerine, istisnaları yakalamak için
try...catchifadelerini kullanın, ardından kullanıcı dostu bir hata mesajı gösterin. - Yayınlamadan önce, eklentinizin kullanıcı arayüzünde hata ayıklama bilgilerinin gösterilmediğinden emin olun.
Yardım içeriği
Yardım bilgilerini gösteren veya eklentinin işleyişini kullanıcıya açıklayan kartlar tasarlayabilirsiniz. Eklentiniz için yardım içeriği oluşturursanız şunları yapmayı unutmayın:
- Mümkün olduğunda talimatları madde işaretli veya numaralı liste olarak gösterin. Kullanıcıları, adlandırılmış kullanıcı arayüzü öğelerine net referanslar vererek sonuca kadar yönlendirin.
- Talimatlarınızda, belirli bir şekilde e-tablo oluşturma gibi tüm şartlar net bir şekilde açıklanmalıdır.
- Destekleyici web sayfaları gibi harici yardım içeriklerine bağlantı verebilirsiniz.
Resimler
Eklentinizde kullanılan resimler, yerleşik simge türlerinden biri veya URL ile belirtilen herkese açık olarak barındırılan bir resimdir. Barındırılan resimleri kullanırken bu resimlere, eklentinizi kullanabilecek herkesin erişebildiğinden emin olun.
Denetimler
Bu bölümde, etkileşimli widget'lar için kullanıcı deneyimi yönergeleri verilmektedir.
Düğmeler
Kullanıcı arayüzünüzdeki ana işlemleri kontrol etmek için diğer widget'lar yerine düğmeleri kullanın.
- Çoğu metin düğmesi etiketi fiille başlamalıdır.
- Düğme satırları çoğu durumda üç veya daha az düğmeyle sınırlı olmalıdır.
DecoratedText
DecoratedText widget'ları metin içeriklerini simgeler, düğmeler veya anahtarlarla sunmanıza olanak tanır.
- Metin içeriğinde normal cümle düzeni kullanın.
- DecoratedText widget'ının metni, mevcut 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 çeşitli seçim girişi widget'ları kullanabilirsiniz: açılır seçim kutuları, onay kutuları ve radyo düğmeleri.
- Kullanıcıların birden fazla seçenek belirleyebileceği veya hiç seçenek belirleyemeyeceği durumlarda 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 kazanmaya çalışırken kısa bir alternatif listesi sunmak için açılır listeleri kullanın.
- Her seçeneğe atanan metin için normal cümle düzeni kullanın.
- Kullanıcılar seçim yaparken genellikle hata yaptığından, seçim değişikliklerini büyük ve geri alınması zor işlemleri tetiklemek için kullanmayın. Bunun yerine, mevcut seçim değerlerini okuyan ve ardından işlemi tetikleyen bir düğme eklemeyi düşünebilirsiniz.
- 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 (ör. haftanın günlerini pazar veya pazartesiden başlayarak sırayla sunma).
- Belirli bir seçim giriş widget'ındaki seçenek sayısını makul bir sayıyla sınırlayın. Çok fazla seçenek varsa kullanıcılar widget'ı kullanmakta zorlanabilir. Bu gibi durumlarda, seçeneği farklı kategorilere ve birden fazla widget'a ayırmayı düşünebilirsiniz.
Metin girişleri
Metin girişleri, kullanıcıların dize verilerini girebileceği bir yer sağlar.
- Kullanıcının belirli bir olası giriş kümesinden birini yazmasını sağlamak için metin girişi kullanmayın. Bunun yerine açılır liste seçimi kullanın.
- Kullanıcının metni doğru biçim ve içerikle girmesine yardımcı olmak için ipuçları ve öneriler kullanın.
- Girilecek metin birkaç kelimeden fazlaysa çok satırlı metin girişleri kullanın.
Marka bilinci oluşturma
Bu bölümde, eklenti arayüzünüze marka öğeleri eklemeyle ilgili kullanıcı deneyimi yönergeleri verilmektedir.
Eklentinizde
Eklenti kullanıcı arayüzünüze markalama eklemek istiyorsanız kısa ve basit tutun. Bu, kullanıcıların eklenti işlevinize odaklanmasına yardımcı olur.
- Eklentinizin tüm yönleri markalama kurallarına uygun olmalıdır.
- "Google", "Gmail" veya diğer Google ürün adlarını eklemeyin.
- Değiştirilmiş olsa bile Google ürün simgelerini eklemeyin.
- Markalama metninize "eklenti" kelimesini eklemeyin.
- Markalama metni birkaç kelimeden uzun olmamalıdır.
Google Workspace Marketplace'te
Eklentinizi yayınlanacak şekilde yapılandırırken Google Workspace Marketplace girişini oluşturmak için bir dizi grafik ve metin öğesi sağlarsınız.
Mağaza girişinizin ve bu öğelerin tüm yönleri markalama kurallarına uygun olmalıdır.