Class Columns

คอลัมน์

วิดเจ็ต Columns จะแสดงได้สูงสุด 2 คอลัมน์ในการ์ดหรือกล่องโต้ตอบ คุณสามารถเพิ่มวิดเจ็ตลงใน Column แต่ละรายการได้ โดยวิดเจ็ตจะปรากฏตามลำดับที่ระบุ ดูตัวอย่างในแอป Google Chat ได้ที่คอลัมน์

ความสูงของแต่ละคอลัมน์จะกำหนดโดยคอลัมน์ที่สูงกว่า เช่น หากคอลัมน์แรกสูงกว่าคอลัมน์ที่ 2 คอลัมน์ทั้ง 2 คอลัมน์จะมีความสูงเท่ากับคอลัมน์แรก เนื่องจากแต่ละคอลัมน์อาจมีวิดเจ็ตจํานวนต่างกัน คุณจึงไม่สามารถกําหนดแถวหรือจัดแนววิดเจ็ตระหว่างคอลัมน์

คอลัมน์จะแสดงคู่กัน คุณปรับความกว้างของแต่ละคอลัมน์ได้โดยใช้ช่อง HorizontalSizeStyle หากความกว้างของหน้าจอผู้ใช้แคบเกินไป คอลัมน์ที่ 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);

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addColumn(column)Columnsเพิ่ม Column ลงในวิดเจ็ตคอลัมน์
setWrapStyle(wrapStyle)Columnsกำหนดรูปแบบการตัดของคอลัมน์ ควบคุมวิธีปรับขนาดคอลัมน์ตามความกว้างของหน้าจอ

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

addColumn(column)

เพิ่ม Column ลงในวิดเจ็ตคอลัมน์ คอลัมน์จะแสดงตามลำดับที่เพิ่ม คุณเพิ่มได้สูงสุด 2 คอลัมน์

const columns = CardService.newColumns().addColumn(CardService.newColumn());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
columnColumnคอลัมน์ย่อยที่จะเพิ่มลงในวิดเจ็ตคอลัมน์

รีเทิร์น

Columns — ออบเจ็กต์นี้สําหรับการต่อเชื่อม


setWrapStyle(wrapStyle)

กำหนดรูปแบบการตัดของคอลัมน์ ควบคุมวิธีปรับขนาดคอลัมน์ตามความกว้างของหน้าจอ

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
wrapStyleWrapStyleรูปแบบการตัดขึ้นบรรทัดใหม่ที่จะตั้งค่าสำหรับคอลัมน์

รีเทิร์น

Columns — ออบเจ็กต์นี้สําหรับการต่อเชื่อม