วิดเจ็ตช่องอินพุตที่ยอมรับการป้อนข้อความ
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 ผู้ใช้จะไม่เห็น ต้องระบุ ต้องไม่ซ้ํากัน
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fieldName | String | คีย์ที่ใช้ในการระบุอินพุตนี้ |
ไปกลับ
TextInput
— เป็นออบเจ็กต์นี้เพื่อเป็นเชน
setHint(hint)
กําหนดคําแนะนําสําหรับการป้อนข้อความ ใช้เพื่อให้คําแนะนําเพิ่มเติมแก่ผู้ใช้ว่าควรป้อนข้อมูลอะไร เช่น คําใบ้อาจอธิบายถึงการจัดรูปแบบ ("xxx-xxx-xxxx") สําหรับช่องหมายเลขโทรศัพท์
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
hint | String | คําแนะนําข้อความที่จะแสดงเมื่อข้อมูลว่างเปล่า |
ไปกลับ
TextInput
— เป็นออบเจ็กต์นี้เพื่อเป็นเชน
setMultiline(multiline)
ตั้งค่าว่าจะให้ข้อความที่ป้อนแสดงในบรรทัดเดียวหรือหลายบรรทัด
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
multiline | Boolean | การตั้งค่าหลายบรรทัด |
ไปกลับ
TextInput
— เป็นออบเจ็กต์นี้เพื่อเป็นเชน
setOnChangeAction(action)
setSuggestions(suggestions)
ตั้งค่าคําแนะนําสําหรับการเติมข้อมูลอัตโนมัติในช่องข้อความ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
suggestions | Suggestions | ชุดคําแนะนําที่จะใช้ |
ไปกลับ
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(); }
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
suggestionsAction | Action | การดําเนินการที่ดึงคําแนะนําสําหรับอินพุตนี้ |
ไปกลับ
TextInput
— เป็นออบเจ็กต์นี้เพื่อเป็นเชน
setTitle(title)
ตั้งชื่อที่จะแสดงเหนือช่องป้อนข้อมูล ต้องระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
title | String | ป้ายกํากับข้อความของอินพุตนี้ |
ไปกลับ
TextInput
— เป็นออบเจ็กต์นี้เพื่อเป็นเชน
setValue(value)
กําหนดค่าที่ป้อนไว้ล่วงหน้าในช่องป้อนข้อมูล
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | String | ค่าเริ่มต้นที่ใส่ไว้ในอินพุต และแสดงเป็นสตริงในพารามิเตอร์เรียกกลับของแบบฟอร์มเสมอ |
ไปกลับ
TextInput
— เป็นออบเจ็กต์นี้เพื่อเป็นเชน