Skip to Content
ออกแบบ

การ์ดและระดับชั้นของพื้นผิว

กฎการใช้งานสำหรับการ์ดเนื้อหา, Shell ของพื้นที่ทำงาน, เลเยอร์ลอย, เงา และการเบลอพื้นหลัง

องค์ประกอบแบบเรียลไทม์ชั้นของบัตร

บัตรเนื้อหาจะแบนราบ; โครงนอกสื่อถึงการจัดกลุ่มพื้นที่ทำงาน

ภาพรวมโปรเจกต์ความพร้อมสำหรับเปิดตัว
เนื้อหาหน้า 12 หน้าเสร็จสมบูรณ์

บัตรเนื้อหามาตรฐานไม่ใช้เงาภายนอก

ตรวจสอบพร้อมใช้งานบนมือถือ

การเลือกและการแสดงสถานะสื่อสารผ่านสีและลำดับความสำคัญของข้อมูล

มาตรฐานวัสดุและระดับชั้นของการ์ด

เอกสารนี้อธิบายอย่างเปิดเผยว่าอินเทอร์เฟซของ Qokit ใช้เงา, ความโปร่งใส, การไล่ระดับสี และการเบลอพื้นหลังในสถานการณ์ใดบ้าง ใช้ได้กับแพลตฟอร์มส่วนขยาย, Builder, CMS, Dashboard, Studio และ Admin หน้าการตลาดและเว็บไซต์ที่สร้างขึ้นสามารถแสดงออกได้มากกว่า แต่เอฟเฟกต์ต้องเป็นไปตามธีมปัจจุบันและต้องมั่นใจว่าเนื้อหาสามารถอ่านได้

หลักการสำคัญ

เอฟเฟกต์ภาพใช้เพื่อแสดงโครงสร้าง ไม่ใช่เพื่อตกแต่งทุกบล็อก:

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

การ์ดสีทึบอิสระและช่องป้อนข้อมูลใช้เงาเบาๆ ระดับแรกร่วมกัน รายการ พื้นผิวที่ซ้อนกัน และการจัดกลุ่มแบบโปร่งใสจะเรียบแบน เฉพาะเลเยอร์ลอยที่แท้จริงเท่านั้นที่ใช้เงาที่ชัดเจน

ลำดับการพิจารณา

ก่อนเพิ่มเอฟเฟกต์วัสดุ ให้พิจารณาทหน้าที่ของพื้นผิวก่อน:

  1. เป็นการ์ดสีทึบอิสระหรือช่องป้อนข้อมูลหรือไม่? ใช้พื้นผิวระดับแรกหรือเงาของฟิลด์ร่วมกัน
  2. เป็นแถวรายการ การ์ดที่ซ้อนกัน ตัวเลือกที่ทำซ้ำ หรือการจัดกลุ่มแบบโปร่งใสหรือไม่? ให้เรียบแบน
  3. จัดระเบียบการ์ดเนื้อหาภายในหลายใบเป็นพื้นที่ทำงานหรือไม่? ใช้ Shell
  4. ทับเนื้อหาบนหน้าหรือปรากฏเหนือระนาบปัจจุบันหรือไม่? ใช้เงาของเลเยอร์ลอย
  5. อยู่ในสถานะลาก ซูม หรือลอยชั่วคราวหรือไม่? ใช้เงาชั่วคราว
  6. เป็นเพียงการแสดง hover, การเลือก หรือ focus เท่านั้นหรือไม่? ใช้บทบาท hover ร่วมกัน สีพื้นหลังการโต้ตอบ และวงแหวนโฟกัส

อย่าซ้อนเงา ความโปร่งใส การไล่ระดับสี และการเบลอพร้อมกัน เว้นแต่ทหน้าที่ของพื้นผิวต้องการจริงๆ

เมทริกซ์สถานการณ์

ทหน้าที่ของพื้นผิวเงาความโปร่งใสหรือการไล่ระดับสีการเบลอพื้นหลัง
การ์ดเนื้อหาสีทึบอิสระ การ์ดตัวชี้วัดเงาเบาๆ ระดับแรกร่วมกันอนุญาตให้มีความแตกต่างของสีพื้นหลังเล็กน้อยไม่มี
แถวรายการ การ์ดที่ซ้อนกัน การจัดกลุ่มแบบโปร่งใส ตัวเลือกที่ทำซ้ำไม่มีอนุญาตให้มีความแตกต่างของสีพื้นหลังเล็กน้อยไม่มี
Shell จัดกลุ่มภายในหน้าไม่มีแนะนำมักไม่จำเป็น
แถบด้านข้างหรือ Shell พื้นที่ทำงานถาวรเบาแนะนำอนุญาตเมื่อมีเนื้อหาที่มองเห็นได้ด้านหลัง
Dialog, Popover, Dropdown, เมนูบริบทเงาของเลเยอร์ลอยที่ชัดเจนพื้นหลังต้องทึบเพียงพอเพื่อให้สามารถอ่านได้อนุญาต
ตัวอย่างการลาก สถานะซูม ตัวอย่างการลอยชั่วคราวค่อนข้างแรงไม่บังคับมักไม่จำเป็น
Hoverรักษาหรือเพิ่มเงาระดับแรกเล็กน้อยสามารถเปลี่ยนพื้นหลังได้ไม่เปลี่ยนแปลง
สถานะเลือกหรือใช้งานไม่มีพื้นหลังสีเน้นหรือการไล่ระดับสีที่ควบคุมไม่เปลี่ยนแปลง
ช่องป้อนข้อมูล ช่องค้นหาเงาฟิลด์เบามากใช้สีพื้นผิวของตัวควบคุมมักไม่จำเป็น
การดำเนินการหลักอิสระ แคปซูลอิสระ เปลือกตัวควบคุมแบบแบ่งส่วนเงาตัวควบคุมเบามากใช้สีพื้นผิวของตัวควบคุมมักไม่จำเป็น
แถบเครื่องมือและตัวควบคุมชั้นในแบบโปร่งใสไม่มีใช้สีพื้นผิวของตัวควบคุมหรือโปร่งใสมักไม่จำเป็น
การ์ดภาพหน้าการตลาดหรือเว็บไซต์ที่สร้างขึ้นกำหนดโดยธีมอนุญาตใช้แบบควบคุม

การแมปคอมโพเนนต์

  • <Card> ใช้ layer="content" เป็นค่าเริ่มต้น: เงาเบาๆ ระดับแรกร่วมกัน ไม่มีขอบ มุมโค้ง 20px เป็นค่าเริ่มต้น ตัวแปร muted, ซ้อนกัน, รายการ และโปร่งใสจะเรียบแบน
  • <Card layer="shell">: ภายในหน้ามีทหน้าที่จัดกลุ่มเท่านั้น ใช้พื้นผิวโปร่งใสหรือไล่ระดับสีเบาๆ และเรียบแบน Shell พื้นที่ทำงานถาวรให้ระดับชั้นโดยโหมดที่เป็นเจ้าของ
  • <Card shape="pill">: ใช้สำหรับการ์ดแถวเดียวแบบกะทัดรัด มุมโค้งเป็นรูปแคปซูลวงรี
  • SidebarNavigation: Shell พื้นที่ทำงานอิสระ รักษาการไล่ระดับสี ความโปร่งใส การเบลอ และเงาเบาๆ ที่ชัดเจน
  • PromptPanel ของ Studio เมื่อใช้เป็นคอนเทนเนอร์พื้นที่ทำงาน: ใช้ --workspace-shell-shadow
  • DialogPanel, เมนูแบบเลื่อนลง, Popover, เมนูบริบท และ Concept Explorer: ใช้เงาของเลเยอร์ลอย
  • แคนวาสของ Builder, ตัวอย่างอุปกรณ์, ตัวอย่างเว็บไซต์ที่สร้างขึ้น, ตัวอย่างการลาก และสถานะซูม: เนื่องจากแสดงถึงระนาบตัวอย่างอิสระหรือเลเยอร์การโต้ตอบชั่วคราว สามารถรักษาเงาเฉพาะได้

อย่าสร้างการ์ดเนื้อหาที่ลอยซ้อนกันเป็นชั้นๆ หากต้องการการจัดกลุ่มชั้นนอกจริงๆ มันต้องเป็น Shell แบบเรียบแบน ยกเว้นเลเยอร์ลอยที่แท้จริง โซ่บรรพบุรุษ DOM เดียวกันสามารถมีเงาของเนื้อหาหรือตัวควบคุมทั่วไปเพียงหนึ่งรายการเท่านั้น

การใช้ตัวแปรการออกแบบ (Token)

ใช้ Token ร่วมกันเป็นลำดับแรก อย่าฮาร์ดโค้ดเอฟเฟกต์:

  • เงาการ์ดเนื้อหา: --card-shadow: var(--qk-shadow-surface)
  • เงา hover การ์ดเนื้อหา: --card-shadow-hover: var(--qk-shadow-surface-hover)
  • เงาฟิลด์: --input-shadow: var(--qk-shadow-field)
  • เงาฟิลด์ที่ใช้งาน: --input-state-shadow: var(--qk-shadow-field-active)
  • เงาตัวควบคุม: --qk-shadow-control / --qk-shadow-control-hover
  • เงาตัวควบคุมการดำเนินการหลัก: --qk-shadow-control-accent / --qk-shadow-control-accent-hover
  • การเบลอการ์ดเนื้อหา: --card-backdrop-filter: none
  • พื้นผิว Shell: --card-shell-surface
  • การเบลอ Shell: --card-shell-backdrop-filter
  • เงา Shell พื้นที่ทำงาน: --workspace-shell-shadow
  • พื้นผิว Dialog: --dialog-surface ให้การไล่ระดับสีธีมที่ควบคุม
  • การเบลอ Dialog: --dialog-backdrop-filter
  • เงาของเลเยอร์ลอย Dialog: --dialog-shadow
  • มุมโค้ง Dialog: ใช้ซ้ำ --card-radius
  • โฟกัสคีย์บอร์ด: --focus-ring
  • เงาของเลเยอร์ลอย: ใช้ Token ของ Dialog, Dropdown, Menu หรือเลเยอร์ลอยระดับหน้าที่มีอยู่

การ์ดเนื้อหาทั่วไปและแผงพื้นที่ทำงานต้องไม่ใช้ Token ทั่วไป --shadow ที่แรงกว่า

เงาทั่วโลกใช้สเกลที่เงียบของ "การเคลื่อนที่สั้น ความโปร่งใสต่ำ เพิ่มขึ้นตามระดับการวาง" การ์ด ฟิลด์ และตัวควบคุมทั่วไปต้องไม่ทำให้เงาร่วมกันลึกขึ้นหรือขยายใหญ่ขึ้นในเส้นทาง Popover และ Dialog แสดงการออกห่างจากหน้าผ่านการเคลื่อนที่และช่วงเบลอที่ใหญ่ขึ้น ไม่ใช่การซ้อนหมอกสีเทาเข้ม

กฎการโต้ตอบ

Hover

  • การ์ดเนื้อหาต้องไม่ยกขึ้นสูงกว่าระดับ --qk-shadow-surface-hover
  • ไม่ยกการ์ดเนื้อหาขึ้นผ่าน translateY
  • ใช้การเปลี่ยนแปลงพื้นหลังเล็กน้อยหรือการตอบสนองของตัวควบคุมที่ชัดเจน
  • ไม่เปลี่ยนรูปร่าง เพื่อหลีกเลี่ยงมุมโค้งที่ไม่สอดคล้องกันหรือเงาถูกตัด

การเลือกและการใช้งาน

  • ใช้พื้นผิวสีเน้น สถานะไอคอน สถานะความหมาย หรือการไล่ระดับสีที่ควบคุม
  • ต้องไม่แสดงสถานะผ่านเงาเท่านั้น

โฟกัสคีย์บอร์ด

  • ใช้กฎ focus-visible ร่วมกันหรือ --focus-ring
  • เงาการ์ดทั่วไปไม่สามารถแทนที่คำแนะนำโฟกัสได้
  • ต้องมองเห็นได้ชัดเจนทั้งในธีมสีอ่อนและสีเข้ม

การลากและการซูม

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

ความโปร่งใสและการเบลอพื้นหลัง

ความโปร่งใสใช้เพื่อแสดงความเป็นเจ้าของระหว่างพื้นผิวชั้นนอกและพื้นที่ทำงาน การเบลอพื้นหลังจะมีความหมายเฉพาะเมื่อมีเนื้อหา สี หรือภาพที่มองเห็นได้ด้านหลังพื้นผิวจริงๆ

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

ข้อยกเว้นที่อนุญาตให้รักษาเงา

  • Shell แถบด้านข้างพื้นที่ทำงาน
  • Dialog, Popover, Dropdown, เมนู และแผงโมดัล
  • Concept Explorer และเลเยอร์ลอยยืนยันของ Studio
  • แคนวาสของ Builder, กรอบอุปกรณ์ และระนาบตัวอย่างเว็บไซต์ที่สร้างขึ้น
  • ตัวอย่างการลาก การตอบสนองการซูม และเครื่องมือลอยชั่วคราว
  • ปุ่มการดำเนินการหลักที่ Token ปุ่มร่วมกันได้นิยามเงาไว้แล้ว
  • องค์ประกอบภาพหน้าการตลาดและเว็บไซต์ที่สร้างขึ้นที่ควบคุมโดยธีมปัจจุบัน

ข้อยกเว้นเหล่านี้ต้องไม่ส่งผลต่อการ์ดเนื้อหาทั่วไปผ่านตัวเลือกที่กว้างหรือ Token ร่วมกัน

รายการตรวจสอบ

  • การ์ดเนื้อหาสีทึบอิสระและช่องป้อนข้อมูลใช้บทบาทเงาเบาๆ ระดับแรกร่วมกันเท่านั้น
  • การดำเนินการหลักอิสระ แคปซูลอิสระ และเปลือกตัวควบคุมแบบแบ่งส่วนใช้บทบาทเงาตัวควบคุมเบามากที่แชร์ร่วมกันเท่านั้น
  • การจัดกลุ่มหน้า แถวรายการ การ์ดที่ซ้อนกัน การจัดกลุ่มแบบโปร่งใส Tab/Pill ที่ทำซ้ำ แถบเครื่องมือ และรายการภายในตัวควบคุมแบบประกอบเรียบแบน
  • การค้นหา การกรอง การเรียงลำดับ มุมมอง และการดำเนินการหลักแบบอินไลน์ในแถบเครื่องมือเรียบแบน เงาเบาๆ ของช่องป้อนข้อมูลทั่วไปต้องไม่รั่วไหลไปยังแถบเครื่องมือ ยกเว้นวงแหวนโฟกัสคีย์บอร์ด
  • เมื่อ Segmented อยู่ภายในการ์ด กล่องโต้ตอบ หรือแถบเครื่องมือที่มีเงาอยู่แล้ว เปลือกและรายการที่เลือกจะเรียบแบน การคลิกเมาส์ไม่แสดงวงแหวนโฟกัสคีย์บอร์ด
  • ยกเว้นเลเยอร์ลอยที่แท้จริง โซ่บรรพบุรุษเดียวกันไม่ซ้อนเงาทั่วไปหลายรายการ
  • hover ไม่ทำให้การ์ดเนื้อหาเคลื่อนที่ในแนวตั้ง
  • ลบการ์ดเนื้อหาที่ซ้อนกันออกแล้ว หรือนิยามชั้นนอกเป็น Shell อย่างชัดเจน
  • เฉพาะ Shell ที่แท้จริงใช้ --workspace-shell-shadow
  • เฉพาะเลเยอร์ลอยที่แท้จริงและเลเยอร์การโต้ตอบชั่วคราวใช้เงาที่แรงกว่า
  • มีเนื้อหาที่มองเห็นได้ด้านหลังการเบลอพื้นหลัง และมีพื้นหลังสำรองที่อ่านได้
  • focus-visible ใช้วงแหวนโฟกัส
  • ธีมสีอ่อนและสีเข้มรักษาความเปรียบต่างที่เพียงพอ
  • พื้นผิวมุมโค้งไม่ตัดการตอบสนองของ hover, focus, การลาก หรือเลเยอร์ลอย
  • ความกว้างเดสก์ท็อปและมือถือไม่มีการล้นแนวนอนใหม่
  • npm run ui:check-card-surfaces --workspace @qokit-ai/web ผ่านการตรวจสอบ

ในหน้านี้