Class TextInput

TextInput

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öntemDönüş türüKısa açıklama
setFieldName(fieldName)TextInputBir kod getirildiğinde oluşturulan etkinlik nesnesinde bu metin girişini tanımlayan anahtarı bir kullanıcı arayüzü etkileşimidir.
setHint(hint)TextInputMetin girişi için bir ipucu ayarlar.
setMultiline(multiline)TextInputGiriş metninin bir satırda mı yoksa birden çok satırda mı gösterileceğini ayarlar.
setOnChangeAction(action)TextInputMetin girişi her değiştiğinde uygulanacak bir işlemi ayarlar.
setSuggestions(suggestions)TextInputMetin alanında otomatik tamamlama önerilerini ayarlar.
setSuggestionsAction(suggestionsAction)TextInputOtomatik tamamlama için kullanıcı girişine göre önerileri getirmek üzere geri çağırma işlemini ayarlar.
setTitle(title)TextInputGiriş alanının üzerinde gösterilecek başlığı ayarlar.
setValue(value)TextInputGiriş 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

AdTürAçıklama
fieldNameStringBu 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

AdTürAçıklama
hintStringGiriş 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

AdTürAçıklama
multilineBooleanÇok satırlı ayarı.

Return

TextInput: Zincirleme için bu nesne.


setOnChangeAction(action)

Metin girişi her değiştiğinde uygulanacak bir işlemi ayarlar.

Parametreler

AdTürAçıklama
actionActionYapılacak işlem.

Return

TextInput: Zincirleme için bu nesne.


setSuggestions(suggestions)

Metin alanında otomatik tamamlama önerilerini ayarlar.

Parametreler

AdTürAçıklama
suggestionsSuggestionsKullanı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

AdTürAçıklama
suggestionsActionActionBu 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

AdTürAçıklama
titleStringBu giriş için metin etiketi.

Return

TextInput: Zincirleme için bu nesne.


setValue(value)

Giriş alanında ayarlanacak önceden doldurulmuş değeri ayarlar.

Parametreler

AdTürAçıklama
valueStringGirişe yerleştirilen varsayılan değer. Her zaman geri çağırma parametrelerini içerir.

Return

TextInput: Zincirleme için bu nesne.