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 ลงในวิดเจ็ตคอลัมน์
addEventAction(eventAction)Widgetเพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต
setId(id)Widgetกำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน
setVisibility(visibility)Widgetตั้งค่าระดับการมองเห็นของวิดเจ็ต
setWrapStyle(wrapStyle)Columnsกำหนดรูปแบบการตัดข้อความของคอลัมน์ ควบคุมวิธีปรับขนาดคอลัมน์ตามความกว้างของหน้าจอ

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

addColumn(column)

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

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

พารามิเตอร์

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

รีเทิร์น

Columns - ออบเจ็กต์นี้สำหรับการเชื่อมโยง


addEventAction(eventAction)

เพิ่มการดำเนินการของเหตุการณ์ที่ทำได้ในวิดเจ็ต

พารามิเตอร์

ชื่อประเภทคำอธิบาย
eventActionEventActionEventAction ที่จะเพิ่ม

รีเทิร์น

Widget — ออบเจ็กต์สำหรับการเชื่อมโยง


setId(id)

กำหนดรหัสที่ไม่ซ้ำกันที่กำหนดให้ซึ่งใช้ระบุวิดเจ็ตที่จะเปลี่ยน การเปลี่ยนแปลงวิดเจ็ต รองรับเฉพาะในส่วนเสริม

พารามิเตอร์

ชื่อประเภทคำอธิบาย
idStringรหัสของวิดเจ็ต โดยมีความยาวได้ไม่เกิน 64 อักขระและอยู่ในรูปแบบ `[a-zA-Z0-9-]+`

รีเทิร์น

Widget - ออบเจ็กต์นี้สำหรับการเชื่อมโยง


setVisibility(visibility)

ตั้งค่าระดับการมองเห็นของวิดเจ็ต ค่าเริ่มต้นคือ `VISIBLE`

พารามิเตอร์

ชื่อประเภทคำอธิบาย
visibilityVisibilityVisibility ของวิดเจ็ต

รีเทิร์น

Widget — ออบเจ็กต์สำหรับการเชื่อมโยง


setWrapStyle(wrapStyle)

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

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

พารามิเตอร์

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

รีเทิร์น

Columns - ออบเจ็กต์นี้สำหรับการเชื่อมโยง