Class TextInput

การป้อนข้อความ

วิดเจ็ตช่องอินพุตที่ยอมรับการป้อนข้อความ

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
setFieldName(fieldName)TextInputตั้งค่าคีย์ที่ระบุอินพุตข้อความในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI
setHint(hint)TextInputกําหนดคําแนะนําสําหรับการป้อนข้อความ
setMultiline(multiline)TextInputตั้งค่าว่าจะให้ข้อความที่ป้อนแสดงในบรรทัดเดียวหรือหลายบรรทัด
setOnChangeAction(action)TextInputตั้งค่าการดําเนินการเมื่อมีการเปลี่ยนแปลงการป้อนข้อความ
setSuggestions(suggestions)TextInputตั้งค่าคําแนะนําสําหรับการเติมข้อมูลอัตโนมัติในช่องข้อความ
setSuggestionsAction(suggestionsAction)TextInputตั้งค่าการดําเนินการเรียกกลับเพื่อดึงคําแนะนําตามการป้อนข้อมูลของผู้ใช้สําหรับการเติมข้อความอัตโนมัติ
setTitle(title)TextInputตั้งชื่อที่จะแสดงเหนือช่องป้อนข้อมูล
setValue(value)TextInputกําหนดค่าที่ป้อนไว้ล่วงหน้าในช่องป้อนข้อมูล

เอกสารประกอบโดยละเอียด

setFieldName(fieldName)

ตั้งค่าคีย์ที่ระบุอินพุตข้อความในออบเจ็กต์เหตุการณ์ที่สร้างขึ้นเมื่อมีการโต้ตอบ UI ผู้ใช้จะไม่เห็น ต้องระบุ ต้องไม่ซ้ํากัน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fieldNameStringคีย์ที่ใช้ในการระบุอินพุตนี้

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน


setHint(hint)

กําหนดคําแนะนําสําหรับการป้อนข้อความ ใช้เพื่อให้คําแนะนําเพิ่มเติมแก่ผู้ใช้ว่าควรป้อนข้อมูลอะไร เช่น คําใบ้อาจอธิบายถึงการจัดรูปแบบ ("xxx-xxx-xxxx") สําหรับช่องหมายเลขโทรศัพท์

พารามิเตอร์

ชื่อประเภทคำอธิบาย
hintStringคําแนะนําข้อความที่จะแสดงเมื่อข้อมูลว่างเปล่า

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน


setMultiline(multiline)

ตั้งค่าว่าจะให้ข้อความที่ป้อนแสดงในบรรทัดเดียวหรือหลายบรรทัด

พารามิเตอร์

ชื่อประเภทคำอธิบาย
multilineBooleanการตั้งค่าหลายบรรทัด

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน


setOnChangeAction(action)

ตั้งค่าการดําเนินการเมื่อมีการเปลี่ยนแปลงการป้อนข้อความ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
actionActionการดําเนินการที่ต้องทํา

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน


setSuggestions(suggestions)

ตั้งค่าคําแนะนําสําหรับการเติมข้อมูลอัตโนมัติในช่องข้อความ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
suggestionsSuggestionsชุดคําแนะนําที่จะใช้

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน


setSuggestionsAction(suggestionsAction)

ตั้งค่าการดําเนินการเรียกกลับเพื่อดึงคําแนะนําตามการป้อนข้อมูลของผู้ใช้สําหรับการเติมข้อความอัตโนมัติ พารามิเตอร์ Action ต้องระบุฟังก์ชันเรียกกลับที่แสดงออบเจ็กต์ 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();
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
suggestionsActionActionการดําเนินการที่ดึงคําแนะนําสําหรับอินพุตนี้

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน


setTitle(title)

ตั้งชื่อที่จะแสดงเหนือช่องป้อนข้อมูล ต้องระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
titleStringป้ายกํากับข้อความของอินพุตนี้

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน


setValue(value)

กําหนดค่าที่ป้อนไว้ล่วงหน้าในช่องป้อนข้อมูล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueStringค่าเริ่มต้นที่ใส่ไว้ในอินพุต และแสดงเป็นสตริงในพารามิเตอร์เรียกกลับของแบบฟอร์มเสมอ

ไปกลับ

TextInput — เป็นออบเจ็กต์นี้เพื่อเป็นเชน