หน้านี้ได้รับการแปลโดย Cloud Translation API

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 ผู้ใช้จะไม่เห็น ต้องระบุ ต้องไม่ซ้ํากัน

พารามิเตอร์

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

ไปกลับ

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

`setHint(hint)`

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

พารามิเตอร์

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

ไปกลับ

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

`setMultiline(multiline)`

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

พารามิเตอร์

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

ไปกลับ

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

`setOnChangeAction(action)`

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

พารามิเตอร์

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

ไปกลับ

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

`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 — เป็นออบเจ็กต์นี้เพื่อเป็นเชน