Class TextInput

MetinGirişi

Metin girişini kabul eden bir giriş alanı widget'ı.

Form gönderimi doğrulamayı destekler. Action.setAllWidgetsAreRequired(allWidgetsAreRequired), true olarak ayarlandığında veya bu widget Action.addRequiredWidget(requiredWidget) aracılığıyla belirtildiğinde, değer girilmediği sürece gönderme işlemi engellenir.

Google Workspace eklentileri ve Google Chat uygulamaları için kullanılabilir. 

const 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)TextInputKullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu metin girişini tanımlayan anahtarı ayarlar.
setHint(hint)TextInputMetin girişi için ipucu ayarlar.
setHostAppDataSource(hostAppDataSource)TextInputGoogle Workspace uygulamalarından bir veri kaynağı ayarlar.
setMultiline(multiline)TextInputGiriş metninin tek satırda mı yoksa birden fazla satırda mı gösterileceğini ayarlar.
setOnChangeAction(action)TextInputMetin girişi her değiştiğinde gerçekleştirilecek bir işlem ayarlar.
setSuggestions(suggestions)TextInputMetin alanında otomatik tamamlama önerilerini ayarlar.
setSuggestionsAction(suggestionsAction)TextInputGeri çağırma işlemini, otomatik tamamlama için kullanıcı girişine dayalı önerileri getirecek şekilde ayarlar.
setTitle(title)TextInputBaşlığı, giriş alanının üzerinde gösterilecek şekilde ayarlar.
setValidation(validation)TextInputBu widget için doğrulama kuralını ayarlar.
setValue(value)TextInputGiriş alanında ayarlanacak önceden doldurulmuş değeri belirler.

Ayrıntılı belgeler

setFieldName(fieldName)

Kullanıcı arayüzü etkileşimi olduğunda oluşturulan etkinlik nesnesinde bu metin girişini tanımlayan anahtarı ayarlar. Kullanıcı tarafından görülemez. Zorunlu, benzersiz olmalıdır.

Parametreler

AdTürAçıklama
fieldNameStringBu girişi tanımlamak için kullanılan anahtar.

Return

TextInput: Zincirleme için kullanılan bu nesne.

setHint(hint)

Metin girişi için ipucu ayarlar. Kullanıcıya ne gireceği konusunda ek rehberlik sağlamak için kullanılır. Örneğin, bir ipucu, telefon numarası alanının biçimlendirmesini ("xxx-xxx-xxxx") açıklayabilir.

Parametreler

AdTürAçıklama
hintStringGiriş alanının altında gösterilecek metin ipucu. Bu metin her zaman görünür.

Return

TextInput: Zincirleme için kullanılan bu nesne.

setHostAppDataSource(hostAppDataSource)

Google Workspace uygulamalarından bir veri kaynağı ayarlar. Şu anda kullanıcıları ve Chat alanlarını desteklemektedir.

Yalnızca Google Workspace akışlarını genişleten Google Workspace eklentileri için Gemini Alpha programı üzerinden kullanılabilir. 

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_form_input_key')
                      .setTitle('Text input title')
                      .setHint('Text input hint')
                      .setHostAppDataSource(hostAppDataSource);

Parametreler

AdTürAçıklama
hostAppDataSourceHostAppDataSourceVeri kaynağı.

Return

TextInput: Zincirleme için kullanılan bu nesne.

setMultiline(multiline)

Giriş metninin tek satırda mı yoksa birden fazla satırda mı gösterileceğini ayarlar.

Parametreler

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

Return

TextInput: Zincirleme için kullanılan bu nesne.

setOnChangeAction(action)

Metin girişi her değiştiğinde gerçekleştirilecek bir işlem ayarlar.

Parametreler

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

Return

TextInput: Zincirleme için kullanılan bu nesne.

setSuggestions(suggestions)

Metin alanında otomatik tamamlama önerilerini ayarlar.

Parametreler

AdTürAçıklama
suggestionsSuggestionsKullanılacak öneri koleksiyonu.

Return

TextInput: Zincirleme için kullanılan bu nesne.

setSuggestionsAction(suggestionsAction)

Geri çağırma işlemini, otomatik tamamlama için kullanıcı girişine dayalı önerileri getirecek şekilde ayarlar. Action parametresi, SuggestionsResponse nesnesi döndüren bir geri çağırma işlevi belirtmelidir. 

const action = CardService.newAction()
                   .setFunctionName('suggestionCallback')
                   .setParameters({numSuggestions: 3});

CardService.newTextInput()
    .setFieldName('option-field')
    .setTitle('Option Selected')
    .setSuggestionsAction(action);

// ...

function suggestionCallback(e) {
  const suggestions = CardService.newSuggestions();
  const numSuggestions = Number.parseInt(e.parameter.numSuggestions);
  for (let i = 1; i <= numSuggestions; i++) {
    suggestions.addSuggestion(`Suggestion ${i}`);
  }
  return CardService.newSuggestionsResponseBuilder()
      .setSuggestions(suggestions)
      .build();
}

Parametreler

AdTürAçıklama
suggestionsActionActionBu giriş için önerileri getiren işlem.

Return

TextInput: Zincirleme için kullanılan bu nesne.

setTitle(title)

Başlığı, giriş alanının üzerinde gösterilecek şekilde ayarlar. Zorunlu.

Parametreler

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

Return

TextInput: Zincirleme için kullanılan bu nesne.

setValidation(validation)

Bu widget için doğrulama kuralını ayarlar. 

const validation = CardService.newValidation().setCharacterLimit('10').setType(
    CardService.InputType.TEXT);

const input = CardService.newTextInput()
                  .setFieldName('text_name_xxx1')
                  .setTitle('Max 10 characters')
                  .setValidation(validation);

Parametreler

AdTürAçıklama
validationValidationBu TextInput widget'ının doğrulama kuralı.

Return

TextInput: Zincirleme için kullanılan bu nesne.

setValue(value)

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

Parametreler

AdTürAçıklama
valueStringGirişe yerleştirilen varsayılan değer. Form geri çağırma parametrelerinde her zaman dize olarak gösterilir.

Return

TextInput: Zincirleme için kullanılan bu nesne.