การ์ด

ส่วนเสริมแบบการ์ดจะปรากฏเป็นแผงในแถบด้านข้าง (หรือบนอุปกรณ์เคลื่อนที่เมื่อเข้าถึงหน้าต่างกิจกรรมอื่นผ่านเมนู) ส่วนเสริมมีแถบเครื่องมือด้านบนที่ระบุส่วนเสริมและแสดงการ์ด ซึ่งมักจะเป็น "หน้า" ของ UI ของส่วนเสริม Apps Script แสดงการ์ดในโค้ดโปรเจ็กต์โดยใช้ออบเจ็กต์ Card

การวิเคราะห์ส่วนต่างๆ ของการ์ด

ตัวอย่างการ์ดส่วนเสริม

การ์ดคือกลุ่มองค์ประกอบ UI ที่คุณออกแบบ การ์ดประกอบด้วยส่วนต่างๆ ต่อไปนี้

  • ส่วนหัวของการ์ด แอตทริบิวต์นี้จะระบุการ์ด มีข้อความชื่อวิดีโอ และอาจ มีคำบรรยายและไอคอน
  • ส่วนการ์ดอย่างน้อย 1 ส่วน ซึ่งเป็นส่วนย่อยของพื้นที่ UI ของการ์ด ส่วนอาจมีส่วนหัวของส่วนข้อความหรือไม่ก็ได้ ส่วนการ์ดจะแยกออกจากกันบนการ์ดด้วยกฎแนวนอน หากส่วนการ์ดมีขนาดใหญ่เป็นพิเศษ ส่วนการ์ดจะแสดงผลเป็นส่วนที่ยุบได้โดยอัตโนมัติซึ่งผู้ใช้ขยายหรือยุบได้ตามต้องการ การ์ด 1 ใบมีส่วนการ์ดได้ไม่เกิน 100 ส่วน และควรมีส่วนอย่างน้อย 2-3 ส่วนเพื่อประสิทธิภาพที่ดีขึ้น

  • ส่วนการ์ดแต่ละส่วนจะมีวิดเจ็ต UI อย่างน้อย 1 รายการ วิดเจ็ตช่วยให้ผู้ใช้ได้รับข้อมูล หรือการควบคุมแบบอินเทอร์แอกทีฟ การ์ดและส่วนของการ์ดเป็นวิดเจ็ตในเชิงโครงสร้าง คุณจึงไม่สามารถเพิ่มลงในหัวข้อการ์ดได้ ส่วนการ์ดมีวิดเจ็ตได้ไม่เกิน 100 รายการและควรเรียบง่ายที่สุดเพื่อประสิทธิภาพที่ดีที่สุด

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

การใช้บัตรหลายใบ

ตัวอย่างการ์ดส่วนเสริม

โดยปกติแล้วส่วนเสริมจะมีการ์ดมากกว่า 1 ใบ คุณจะกำหนดค่าการ์ดเหล่านี้เป็นรายการง่ายๆ สำหรับการไปยังส่วนต่างๆ แบบพื้นฐานด้วยการ์ดหลายใบ หรือกำหนดค่าวิธีไปยังส่วนต่างๆ ที่ซับซ้อนขึ้นเพื่อควบคุมวิธีที่ผู้ใช้ย้ายไปมาระหว่างการ์ดได้

หากส่วนเสริมใช้การนำทางแบบพื้นฐาน เมื่อส่วนเสริมเปิดขึ้นเป็นครั้งแรก แอปพลิเคชัน Google Workspace จะขยายรายการส่วนหัวของการ์ดและแสดงส่วนหัวเหล่านั้นแก่ผู้ใช้ การคลิกส่วนหัวของการ์ดจะเปิดการ์ดนั้นขึ้นมา นอกจากนี้ยังมีลูกศรย้อนกลับเพื่อย้อนกลับไปยังรายการส่วนหัวของการ์ดด้วย คุณไม่ต้องเขียนโค้ดฟังก์ชันการทำงานของส่วนหัวและลูกศรย้อนกลับ เพราะจะดำเนินการโดยอัตโนมัติเมื่อคุณกำหนดการ์ดในส่วนเสริม

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