การ์ดและระดับชั้นของพื้นผิว
กฎการใช้งานสำหรับการ์ดเนื้อหา, Shell ของพื้นที่ทำงาน, เลเยอร์ลอย, เงา และการเบลอพื้นหลัง
บัตรเนื้อหาจะแบนราบ; โครงนอกสื่อถึงการจัดกลุ่มพื้นที่ทำงาน
บัตรเนื้อหามาตรฐานไม่ใช้เงาภายนอก
การเลือกและการแสดงสถานะสื่อสารผ่านสีและลำดับความสำคัญของข้อมูล
มาตรฐานวัสดุและระดับชั้นของการ์ด
เอกสารนี้อธิบายอย่างเปิดเผยว่าอินเทอร์เฟซของ Qokit ใช้เงา, ความโปร่งใส, การไล่ระดับสี และการเบลอพื้นหลังในสถานการณ์ใดบ้าง ใช้ได้กับแพลตฟอร์มส่วนขยาย, Builder, CMS, Dashboard, Studio และ Admin หน้าการตลาดและเว็บไซต์ที่สร้างขึ้นสามารถแสดงออกได้มากกว่า แต่เอฟเฟกต์ต้องเป็นไปตามธีมปัจจุบันและต้องมั่นใจว่าเนื้อหาสามารถอ่านได้
หลักการสำคัญ
เอฟเฟกต์ภาพใช้เพื่อแสดงโครงสร้าง ไม่ใช่เพื่อตกแต่งทุกบล็อก:
- เนื้อหาแยกแยะได้จากความแตกต่างของสีพื้นหลัง
- คอนเทนเนอร์แสดงความเป็นเจ้าของผ่านความโปร่งใสหรือการไล่ระดับสีที่ควบคุม
- เลเยอร์ลอยแสดงระดับชั้นผ่านเงา
- การโต้ตอบแสดงสถานะผ่านสีและวงแหวนโฟกัส
การ์ดสีทึบอิสระและช่องป้อนข้อมูลใช้เงาเบาๆ ระดับแรกร่วมกัน รายการ พื้นผิวที่ซ้อนกัน และการจัดกลุ่มแบบโปร่งใสจะเรียบแบน เฉพาะเลเยอร์ลอยที่แท้จริงเท่านั้นที่ใช้เงาที่ชัดเจน
ลำดับการพิจารณา
ก่อนเพิ่มเอฟเฟกต์วัสดุ ให้พิจารณาทหน้าที่ของพื้นผิวก่อน:
- เป็นการ์ดสีทึบอิสระหรือช่องป้อนข้อมูลหรือไม่? ใช้พื้นผิวระดับแรกหรือเงาของฟิลด์ร่วมกัน
- เป็นแถวรายการ การ์ดที่ซ้อนกัน ตัวเลือกที่ทำซ้ำ หรือการจัดกลุ่มแบบโปร่งใสหรือไม่? ให้เรียบแบน
- จัดระเบียบการ์ดเนื้อหาภายในหลายใบเป็นพื้นที่ทำงานหรือไม่? ใช้ Shell
- ทับเนื้อหาบนหน้าหรือปรากฏเหนือระนาบปัจจุบันหรือไม่? ใช้เงาของเลเยอร์ลอย
- อยู่ในสถานะลาก ซูม หรือลอยชั่วคราวหรือไม่? ใช้เงาชั่วคราว
- เป็นเพียงการแสดง 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-shadowDialogPanel, เมนูแบบเลื่อนลง, 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ผ่านการตรวจสอบ