ส่วนเสริม Google Workspace ที่ใช้การ์ดจะปรากฏเป็นแผงในแถบด้านข้าง (หรือในอุปกรณ์เคลื่อนที่ จะปรากฏเป็นหน้าต่างกิจกรรมอื่นที่เข้าถึงได้ผ่านเมนู)
ส่วนเสริมมีแถบเครื่องมือด้านบนที่ระบุ
ส่วนเสริมและแสดงการ์ด ซึ่งโดยพื้นฐานแล้วคือ "หน้า"
ของ UI ของส่วนเสริม Google Apps Script แสดงการ์ดในโค้ดโปรเจ็กต์โดยใช้ออบเจ็กต์ Card
ส่วนต่างๆ ของการ์ด
การ์ดคือกลุ่มองค์ประกอบ UI ที่คุณออกแบบ การ์ดประกอบด้วยส่วนต่อไปนี้
- ส่วนหัวของการ์ด ซึ่งจะระบุการ์ด โดยมีข้อความชื่อ และอาจมีชื่อรองและไอคอนก็ได้
ส่วนการ์ดอย่างน้อย 1 ส่วน ซึ่งเป็นส่วนย่อยของพื้นที่ UI ของการ์ด ส่วนจะมีส่วนหัวของส่วนข้อความได้ ส่วนการ์ดจะ แยกจากกันในการ์ดด้วยเส้นแนวนอน หากส่วนการ์ด มีขนาดใหญ่เป็นพิเศษ ระบบจะแสดงเป็นส่วนที่ยุบได้โดยอัตโนมัติ ซึ่งผู้ใช้สามารถขยายหรือยุบได้ตามต้องการ การ์ดหนึ่งๆ มีส่วนการ์ดได้ไม่เกิน 100 ส่วน และควรมีเพียงไม่กี่ส่วนเพื่อให้ประสิทธิภาพดีขึ้น
แต่ละส่วนของการ์ดจะมี UI วิดเจ็ตอย่างน้อย 1 รายการ วิดเจ็ตจะให้ข้อมูลหรือตัวควบคุมแบบอินเทอร์แอกทีฟแก่ผู้ใช้ การ์ดและส่วนการ์ดเป็นวิดเจ็ตเชิงโครงสร้าง คุณจึงเพิ่มวิดเจ็ตเหล่านั้นลงในส่วนการ์ดไม่ได้ การ์ด ส่วนหนึ่งมีวิดเจ็ตได้ไม่เกิน 100 รายการ และควรย่อให้สั้นที่สุดเพื่อประสิทธิภาพสูงสุด
คุณควรออกแบบการ์ดตามกิจกรรมของผู้ใช้หรือชุดข้อมูลที่เฉพาะเจาะจง ตัวอย่างเช่น ส่วนเสริม Google Workspace ที่แสดงข้อมูลที่ดึงมาจาก Google ชีตอาจมีการ์ดแยกต่างหากสำหรับชีตแต่ละรายการที่ดึงข้อมูลมา
ใช้บัตรหลายใบ
โดยปกติแล้ว ส่วนเสริมจะมีบัตรมากกว่า 1 ใบ คุณสามารถ กำหนดค่าการ์ดเหล่านี้เป็นรายการสำหรับการนำทางพื้นฐาน หรือกำหนดค่าวิธีการนำทางที่ซับซ้อนมากขึ้น เพื่อควบคุมวิธีที่ผู้ใช้ย้ายไปมาระหว่างการ์ด ดูรายละเอียดได้ที่การไปยังส่วนต่างๆ ขั้นพื้นฐานด้วยการ์ดหลายใบ
หากส่วนเสริมใช้การนำทางพื้นฐาน เมื่อเปิดส่วนเสริมเป็นครั้งแรก แอปพลิเคชัน Google Workspace ที่ส่วนเสริมขยายจะสร้างรายการส่วนหัวของการ์ดและแสดงต่อผู้ใช้ การคลิกส่วนหัวของการ์ดจะเปิดการ์ดนั้น นอกจากนี้ยังมีลูกศรย้อนกลับ เพื่อกลับไปที่รายการส่วนหัวของการ์ดด้วย คุณไม่จำเป็นต้องเขียนโค้ดฟังก์ชันส่วนหัวและลูกศรย้อนกลับ เนื่องจากระบบจะดำเนินการนี้โดยอัตโนมัติเมื่อคุณกำหนดการ์ดในส่วนเสริม
เมื่อออกแบบส่วนเสริม คุณควรจำกัดจำนวนการ์ดที่แสดงพร้อมกัน เนื่องจากต้องแชร์พื้นที่หน้าจอที่มีจำกัด นอกจากนี้ คุณควรหลีกเลี่ยงความซับซ้อนที่ไม่จำเป็นในการ์ดด้วย
คุณเพิ่มวิดเจ็ตหรือส่วนการ์ดในการ์ดได้ไม่เกิน 100 รายการเพื่อประสิทธิภาพ