Düzenleyici Eklentisi için iletişim kutuları ve kenar çubukları

Çoğu düzenleyici eklentisinde, iletişim kutusu pencereleri ve kenar çubuğu panelleri birincil eklenti kullanıcı arayüzleridir. Her ikisi de standart HTML ve CSS kullanılarak tamamen özelleştirilebilir. Apps Komut Dosyası'nın istemci-sunucu iletişim modeli kullanıcı kenar çubuğuyla veya iletişim kutusuyla etkileşime geçtiğinde Apps Komut Dosyası işlevlerini çalıştırmak için kullanılır. Eklentiniz birden fazla kenar çubuğu ve iletişim kutusu tanımlayabilir ancak eklenti, aynı anda yalnızca bir tane atanabilir.

Kullanıcının düzenleyiciyle etkileşimde bulunmasını istemediğiniz zaman eklenti arayüzünde bir seçim yapıp iletişim kutusunu kullanabilirsiniz. Aksi takdirde kenar çubuğu.

İletişim kutuları

İletişim kutuları, birincil düzenleyici içeriğiyle yer paylaşımlı pencere panelleridir. Apps Komut Dosyası iletişim kutuları kalıcıdır; ancak kullanıcılar açılış sayfalarında editör arayüzünün diğer öğeleri. İçeriği ve boyutu özelleştirebilirsiniz. anlamına gelir.

Eklenti iletişim kutularını Apps Komut Dosyası ile aynı şekilde derlersiniz özel iletişim kutuları; genel önerilen prosedür şudur:

  1. İletişim kutunuzun HTML yapısını tanımlayan bir komut dosyası proje dosyası oluşturun. CSS ve istemci taraflı JavaScript davranışı. İletişim kutusunu tanımlarken Düzenleyici Eklentisi stil yönergelerine bakın.
  2. İletişim kutusunun açılmasını istediğiniz sunucu tarafı kodunuzda HtmlService.createHtmlOutputFromFile(filename) HtmlOutput oluşturmak için temsil eden bir nesnedir. Alternatif olarak çağırabileceğiniz templated HTML HtmlService.createTemplateFromFile(filename) bir şablon oluşturmayı ve sonra HtmlTemplate.evaluate() dönüştürmek için HtmlOutput nesnesini tanımlayın.
  3. Ui.showModalDialog(htmlOutput, dialogTitle) numaralı telefonu arayın iletişim kutusunu HtmlOutput.

İletişim kutuları, açık durumdayken sunucu tarafı komut dosyasını askıya almaz. İlgili içeriği oluşturmak için kullanılan istemci taraflı JavaScript, sunucu tarafına eşzamansız çağrılar yapabilir google.script.run() ve ilişkilendirilmiş işleyici işlevleridir. Daha fazla bilgi için bkz. İstemciden sunucuya iletişim.

Dosya açma iletişim kutuları

Dosya açma iletişim kutuları, kullanıcılarınızın dosya seçmesine olanak tanıyan önceden oluşturulmuş iletişim kutularıdır. Google Drive'dan paylaşabilirler. Eklentinize dosya açma iletişim kutusu ekleyebilirsiniz. hem de biraz ek yapılandırma gerektirir. Ayrıca ve Cloud Platform projesi Google Picker API'sini etkinleştirin.

Tüm ayrıntılar için Dosya açma iletişim kutuları bölümüne bakın.

Kenar çubukları, düzenleyici arayüzünün sağında görünen panellerdir ve en yaygın eklenti arayüzü türüdür. Diyalogların aksine, bir kenar çubuğu açıkken, düzenleyici arayüzünün diğer öğeleriyle açın. Kenar çubukları sabit bir genişliğe sahiptir, ancak içeriklerini özelleştirebilirsiniz.

Eklenti kenar çubuklarını Apps Komut Dosyası ile aynı şekilde oluşturursunuz özel kenar çubukları; genel önerilen prosedür şudur:

  1. Kenar çubuğunuzun HTML yapısını tanımlayan bir komut dosyası proje dosyası oluşturun, CSS ve istemci taraflı JavaScript davranışı. Kenar çubuğunu tanımlarken Düzenleyici Eklentisi stil yönergelerine bakın.

  2. Kenar çubuğunun açılmasını istediğiniz sunucu tarafı kodunuzda HtmlService.createHtmlOutputFromFile(filename) HtmlOutput oluşturmak için kenar çubuğunu temsil eden nesne. Alternatif olarak çağırabileceğiniz templated HTML HtmlService.createTemplateFromFile(filename) bir şablon oluşturmayı ve sonra HtmlTemplate.evaluate() dönüştürmek için HtmlOutput nesnesini tanımlayın.

  3. Ui.showSidebar(htmlOutput) numaralı telefonu arayın kenar çubuğunu görüntülemek için HtmlOutput.

Kenar çubukları açıkken sunucu tarafı komut dosyası askıya alınmaz. İlgili içeriği oluşturmak için kullanılan istemci taraflı JavaScript, sunucu tarafına eşzamansız çağrılar yapabilir google.script.run() ve ilişkilendirilmiş işleyici işlevleridir. Daha fazla bilgi için bkz. İstemciden sunucuya iletişim.