Columnsวิดเจ็ตจะแสดงได้สูงสุด 2 คอลัมน์ในการ์ดหรือกล่องโต้ตอบ คุณเพิ่มวิดเจ็ตไปยังColumnแต่ละรายการได้ โดยวิดเจ็ตจะปรากฏตามลำดับที่ระบุ ดูตัวอย่างในแอป Google Chat ได้ที่คอลัมน์
ความสูงของแต่ละคอลัมน์จะกำหนดโดยคอลัมน์ที่สูงกว่า เช่น หากคอลัมน์แรกสูงกว่าคอลัมน์ที่ 2 ทั้ง 2 คอลัมน์จะมีความสูงเท่ากับคอลัมน์แรก เนื่องจากแต่ละคอลัมน์มีวิดเจ็ตได้จำนวนต่างกัน คุณจึงกำหนดแถวหรือจัดแนววิดเจ็ตระหว่างคอลัมน์ไม่ได้
คอลัมน์จะแสดงแบบเคียงข้างกัน คุณปรับแต่งความกว้างของแต่ละคอลัมน์ได้โดยใช้ช่อง
Horizontal หากความกว้างของหน้าจอผู้ใช้แคบเกินไป คอลัมน์ที่ 2 จะ
ขึ้นบรรทัดใหม่ใต้คอลัมน์แรก
- ในเว็บ คอลัมน์ที่ 2 จะตัดข้อความหากความกว้างของหน้าจอน้อยกว่าหรือเท่ากับ 480 พิกเซล
- ในอุปกรณ์ iOS คอลัมน์ที่ 2 จะขึ้นบรรทัดใหม่หากความกว้างของหน้าจอน้อยกว่าหรือเท่ากับ 300 pt
- ในอุปกรณ์ Android คอลัมน์ที่ 2 จะตัดข้อความหากความกว้างของหน้าจอน้อยกว่าหรือเท่ากับ 320 dp
พร้อมใช้งานสำหรับแอป Google Chat และส่วนเสริมของ Google Workspace UI ของส่วนเสริมที่รองรับคอลัมน์มีดังนี้
- กล่องโต้ตอบที่แสดงเมื่อผู้ใช้เปิดส่วนเสริมจากฉบับร่างอีเมล
- กล่องโต้ตอบที่แสดงเมื่อผู้ใช้เปิดส่วนเสริมจากเมนูเพิ่มไฟล์แนบในกิจกรรม Google ปฏิทิน
// Build a column that is aligned in the center and fills the space: const column = CardService.newColumn() .setHorizontalSizeStyle( CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE) .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER) .setVerticalAlignment(CardService.VerticalAlignment.CENTER); const columns = CardService.newColumns().addColumn(column).setWrapStyle( CardService.WrapStyle.WRAP);
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
add | Columns | เพิ่ม Column ลงในวิดเจ็ตคอลัมน์ |
add | Widget | เพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต |
set | Widget | กำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน |
set | Widget | ตั้งค่าระดับการมองเห็นของวิดเจ็ต |
set | Columns | กำหนดรูปแบบการตัดข้อความของคอลัมน์ ควบคุมวิธีปรับขนาดคอลัมน์ตามความกว้างของหน้าจอ |
เอกสารโดยละเอียด
add Column(column)
add Event Action(eventAction)
เพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
event | Event | Event ที่จะเพิ่ม |
รีเทิร์น
Widget — ออบเจ็กต์สำหรับการเชื่อมโยง
set Id(id)
กำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน การเปลี่ยนแปลงวิดเจ็ต รองรับเฉพาะในส่วนเสริม
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
id | String | รหัสของวิดเจ็ต โดยมีความยาวได้ไม่เกิน 64 อักขระและอยู่ในรูปแบบ `[a-zA-Z0-9-]+` |
รีเทิร์น
Widget - ออบเจ็กต์นี้สำหรับการเชื่อมโยง
set Visibility(visibility)
ตั้งค่าระดับการมองเห็นของวิดเจ็ต ค่าเริ่มต้นคือ `VISIBLE`
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
visibility | Visibility | Visibility ของวิดเจ็ต |
รีเทิร์น
Widget — ออบเจ็กต์สำหรับการเชื่อมโยง
set Wrap Style(wrapStyle)
กำหนดรูปแบบการตัดข้อความของคอลัมน์ ควบคุมวิธีปรับขนาดคอลัมน์ตามความกว้างของหน้าจอ
const columns = CardService.newColumns() .addColumn(CardService.newColumn()) .setWrapStyle(CardService.WrapStyle.WRAP);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
wrap | Wrap | รูปแบบการตัดข้อความที่จะตั้งค่าสำหรับคอลัมน์ |
รีเทิร์น
Columns - ออบเจ็กต์นี้สำหรับการเชื่อมโยง