Google Workspace eklentileri, genişlettikleri ana uygulamanı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şletmelidir. Burada sunulan yönergeler, metin, resim, kontrol ve markalamanın yüksek kaliteli bir kullanıcı deneyimi sağlayacak şekilde nasıl ele alınacağını açıklar.
Eklentiniz, eklentinin çalışmasının ayrılmaz bir parçası olan ayrı web sayfaları (ör. eklentinin ayarlar sayfası) açıyorsa bu web sayfalarının da bu stil kurallarına uyduğundan emin olun.
Metin ve resimler
Bu bölümde, eklentinizde metin ve resimleri nasıl 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 listelemesi 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 iyisi 15 veya daha az karakter kullanmaktır. 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ızda "eklenti" kelimesini kullanmayın.
- Sürüm bilgilerini eklemeyin.
Yazma stili
Çok fazla yazmanız gerekmez. Çoğu işlem; simgeler, düzen ve kısa etiketlerle netleştirilmelidir. 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 net 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 işlem kelimesiyle 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ı zorunlu kılmamak için menü öğelerinin sayısını az tutun. Uygulamanız gereken daha fazla işlem varsa her birinde farklı işlemler bulunan birden fazla kart kullanmayı düşünebilirsiniz.
Hata mesajları
Bir sorun oluştuğ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 bilgilerini göstermediğinden emin olun.
Yardım içeriği
Yardım bilgilerini gösteren veya eklentinin işleyişini kullanıcıya açıklayan kartlar tasarlamak isteyebilirsiniz. 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, eklentinizi kullanabilecek herkesin bu resimlere erişebildiğinden emin olun.
Denetimler
Bu bölümde, etkileşimli widget'larla ilgili kullanıcı deneyimi yönergeleri verilmektedir.
Düğmeler
Kullanıcı arayüzünüzdeki temel 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 geri alınması zor olan büyük işlemleri tetiklemek için kullanmayın. Bunun yerine, mevcut seçim değerlerini okuyup 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 Pazartesi'den 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çeneğini kullanın.
- Kullanıcının metni doğru biçimde ve içerikle girmesine yardımcı olmak için ipuçları ve öneriler kullanın.
- Girilecek metin birkaç kelimeden uzunsa ç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 sayede kullanıcılar eklentinizin işlevlerine odaklanabilir.
- 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ınlanmak üzere yapılandırırken Google Workspace Marketplace listelemesini oluşturmak için bir dizi grafik ve metin öğesi sağlarsınız.
Mağaza girişinizin tüm yönleri ve bu öğeler markalama kurallarına uygun olmalıdır.