Halaman ini diterjemahkan oleh Cloud Translation API.

Class 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

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`setFieldName(fieldName)`	`TextInput`	Menetapkan kunci yang mengidentifikasi input teks ini dalam objek peristiwa yang dihasilkan saat ada interaksi UI.
`setHint(hint)`	`TextInput`	Menetapkan petunjuk untuk input teks.
`setMultiline(multiline)`	`TextInput`	Menetapkan apakah teks input ditampilkan dalam satu baris atau beberapa baris.
`setOnChangeAction(action)`	`TextInput`	Menetapkan tindakan yang akan dilakukan setiap kali input teks berubah.
`setSuggestions(suggestions)`	`TextInput`	Menetapkan saran untuk pelengkapan otomatis di kolom teks.
`setSuggestionsAction(suggestionsAction)`	`TextInput`	Menetapkan tindakan callback untuk mengambil saran berdasarkan input pengguna untuk pelengkapan otomatis.
`setTitle(title)`	`TextInput`	Menyetel judul yang akan ditampilkan di atas kolom input.
`setValue(value)`	`TextInput`	Menetapkan 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

Name	Jenis	Deskripsi
`fieldName`	`String`	Kunci 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

Name	Jenis	Deskripsi
`hint`	`String`	Petunjuk 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

Name	Jenis	Deskripsi
`multiline`	`Boolean`	Setelan multibaris.

Return

TextInput — Objek ini, untuk rantai.

`setOnChangeAction(action)`

Menetapkan tindakan yang akan dilakukan setiap kali input teks berubah.

Parameter

Name	Jenis	Deskripsi
`action`	`Action`	Tindakan yang akan diambil.

Return

TextInput — Objek ini, untuk rantai.

`setSuggestions(suggestions)`

Menetapkan saran untuk pelengkapan otomatis di kolom teks.

Parameter

Name	Jenis	Deskripsi
`suggestions`	`Suggestions`	Kumpulan 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

Name	Jenis	Deskripsi
`suggestionsAction`	`Action`	Tindakan 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

Name	Jenis	Deskripsi
`title`	`String`	Label teks untuk input ini.

Return

TextInput — Objek ini, untuk rantai.

`setValue(value)`

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

Parameter

Name	Jenis	Deskripsi
`value`	`String`	Nilai default yang dimasukkan dalam input. Nilai ini selalu direpresentasikan sebagai string dalam parameter callback formulir.

Return

TextInput — Objek ini, untuk rantai.