Metin girişini kabul eden bir giriş alanı widget'ı.
Google Workspace eklentilerinde ve Google Chat uygulamalarında kullanılabilir.
var textInput = CardService.newTextInput() .setFieldName("text_input_form_input_key") .setTitle("Text input title") .setHint("Text input hint");
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
setFieldName(fieldName) | TextInput | Bir kod getirildiğinde oluşturulan etkinlik nesnesinde bu metin girişini tanımlayan anahtarı bir kullanıcı arayüzü etkileşimidir. |
setHint(hint) | TextInput | Metin girişi için bir ipucu ayarlar. |
setMultiline(multiline) | TextInput | Giriş metninin bir satırda mı yoksa birden çok satırda mı gösterileceğini ayarlar. |
setOnChangeAction(action) | TextInput | Metin girişi her değiştiğinde uygulanacak bir işlemi ayarlar. |
setSuggestions(suggestions) | TextInput | Metin alanında otomatik tamamlama önerilerini ayarlar. |
setSuggestionsAction(suggestionsAction) | TextInput | Otomatik tamamlama için kullanıcı girişine göre önerileri getirmek üzere geri çağırma işlemini ayarlar. |
setTitle(title) | TextInput | Giriş alanının üzerinde gösterilecek başlığı ayarlar. |
setValue(value) | TextInput | Giriş alanında ayarlanacak önceden doldurulmuş değeri ayarlar. |
Ayrıntılı belgeler
setFieldName(fieldName)
Bir kod getirildiğinde oluşturulan etkinlik nesnesinde bu metin girişini tanımlayan anahtarı bir kullanıcı arayüzü etkileşimidir. Kullanıcı tarafından görülemez. Zorunludur ve benzersiz olmalıdır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
fieldName | String | Bu girişi tanımlamak için kullanılan anahtar. |
Return
TextInput
: Zincirleme için bu nesne.
setHint(hint)
Metin girişi için bir ipucu ayarlar. Kullanıcıya ne gireceği konusunda ek rehberlik sağlamak için kullanılır. Örneğin, Örneğin, ipucu bir telefon numarası alanının biçimlendirmesini ("xxx-xxx-xxxx") açıklayabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
hint | String | Giriş alanının altında görüntülenecek metin ipucu. Bu metin her zaman görünür. |
Return
TextInput
: Zincirleme için bu nesne.
setMultiline(multiline)
Giriş metninin bir satırda mı yoksa birden çok satırda mı gösterileceğini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
multiline | Boolean | Çok satırlı ayarı. |
Return
TextInput
: Zincirleme için bu nesne.
setOnChangeAction(action)
setSuggestions(suggestions)
Metin alanında otomatik tamamlama önerilerini ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
suggestions | Suggestions | Kullanılacak öneriler koleksiyonu. |
Return
TextInput
: Zincirleme için bu nesne.
setSuggestionsAction(suggestionsAction)
Otomatik tamamlama için kullanıcı girişine göre önerileri getirmek üzere geri çağırma işlemini ayarlar. İlgili içeriği oluşturmak için kullanılan
Action
parametresi, SuggestionsResponse
nesnesi döndüren bir geri çağırma işlevi belirtmelidir.
var action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({'numSuggestions': 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { var suggestions = CardService.newSuggestions(); var numSuggestions = parseInt(e.parameter['numSuggestions']); for(var i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion('Suggestion ' + i); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
suggestionsAction | Action | Bu girişle ilgili önerileri getiren işlem. |
Return
TextInput
: Zincirleme için bu nesne.
setTitle(title)
Giriş alanının üzerinde gösterilecek başlığı ayarlar. Zorunlu.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
title | String | Bu giriş için metin etiketi. |
Return
TextInput
: Zincirleme için bu nesne.
setValue(value)
Giriş alanında ayarlanacak önceden doldurulmuş değeri ayarlar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
value | String | Girişe yerleştirilen varsayılan değer. Her zaman geri çağırma parametrelerini içerir. |
Return
TextInput
: Zincirleme için bu nesne.