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

Class TextInput

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

ใช้ได้กับส่วนเสริมของ Google Workspace และแอป Google Chat

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 ต้องระบุฟังก์ชัน Callback ที่ส่งคืนออบเจ็กต์ 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`	ค่าเริ่มต้นที่อยู่ในอินพุต โดยจะแสดงเป็นสตริงเสมอใน พารามิเตอร์ Callback ของฟอร์ม

รีเทิร์น

TextInput — ออบเจ็กต์นี้สำหรับการทำห่วงโซ่