Class TextInput

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
TextInput

Widget kolom input yang menerima input teks.

var textInput = CardService.newTextInput()
    .setFieldName("text_input_form_input_key")
    .setTitle("Text input title")
    .setHint("Text input hint");

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
setFieldName(fieldName)TextInputMenetapkan kunci yang mengidentifikasi input teks ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI.
setHint(hint)TextInputMenetapkan petunjuk untuk input teks.
setMultiline(multiline)TextInputMenetapkan apakah teks input ditampilkan dalam satu baris atau beberapa baris.
setOnChangeAction(action)TextInputMenetapkan tindakan yang akan dilakukan setiap kali input teks berubah.
setSuggestions(suggestions)TextInputMenetapkan saran untuk pelengkapan otomatis di kolom teks.
setSuggestionsAction(suggestionsAction)TextInputMenetapkan tindakan callback untuk mengambil saran berdasarkan input pengguna untuk pelengkapan otomatis.
setTitle(title)TextInputMenyetel judul yang akan ditampilkan di atas kolom input.
setValue(value)TextInputMenetapkan nilai yang terisi otomatis yang akan ditetapkan di kolom input.

Dokumentasi mendetail

setFieldName(fieldName)

Menetapkan kunci yang mengidentifikasi input teks ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI. Tidak terlihat oleh pengguna. Wajib, harus unik.

Parameter

NameJenisDeskripsi
fieldNameStringKunci yang digunakan untuk mengidentifikasi input ini.

Return

TextInput — Objek ini, untuk rantai.


setHint(hint)

Menetapkan petunjuk untuk input teks. Digunakan untuk memberi pengguna panduan tambahan tentang apa yang harus dimasukkan. Misalnya, petunjuk dapat menjelaskan pemformatan ("xxx-xxx-xxxx") untuk kolom nomor telepon.

Parameter

NameJenisDeskripsi
hintStringPetunjuk teks yang akan ditampilkan saat input kosong.

Return

TextInput — Objek ini, untuk rantai.


setMultiline(multiline)

Menetapkan apakah teks input ditampilkan dalam satu baris atau beberapa baris.

Parameter

NameJenisDeskripsi
multilineBooleanSetelan multibaris.

Return

TextInput — Objek ini, untuk rantai.


setOnChangeAction(action)

Menetapkan tindakan yang akan dilakukan setiap kali input teks berubah.

Parameter

NameJenisDeskripsi
actionActionTindakan yang akan diambil.

Return

TextInput — Objek ini, untuk rantai.


setSuggestions(suggestions)

Menetapkan saran untuk pelengkapan otomatis di kolom teks.

Parameter

NameJenisDeskripsi
suggestionsSuggestionsKumpulan saran yang digunakan.

Return

TextInput — Objek ini, untuk rantai.


setSuggestionsAction(suggestionsAction)

Menetapkan tindakan callback untuk mengambil saran berdasarkan input pengguna untuk pelengkapan otomatis. Parameter Action harus menentukan fungsi callback yang menampilkan objek SuggestionsResponse.

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();
}

Parameter

NameJenisDeskripsi
suggestionsActionActionTindakan yang mengambil saran untuk input ini.

Return

TextInput — Objek ini, untuk rantai.


setTitle(title)

Menyetel judul yang akan ditampilkan di atas kolom input. Wajib diisi.

Parameter

NameJenisDeskripsi
titleStringLabel teks untuk input ini.

Return

TextInput — Objek ini, untuk rantai.


setValue(value)

Menetapkan nilai yang terisi otomatis yang akan ditetapkan di kolom input.

Parameter

NameJenisDeskripsi
valueStringNilai default yang dimasukkan dalam input. Nilai ini selalu direpresentasikan sebagai string dalam parameter callback formulir.

Return

TextInput — Objek ini, untuk rantai.