Skip to Content
ออกแบบ

การเชื่อมต่อ Component

สัญญาการเชื่อมต่อสาธารณะสำหรับ Shared Component, Pattern, Skin และ Style Token ของ Qokit

การเชื่อมต่อ Component

Qokit ใช้โมเดล "Shared Skeleton + Skin Recipe" ผู้เข้าร่วมภายนอกพึ่งพาสัญญาเชิงความหมายและปฏิสัมพันธ์ของ Component แล้วทำการปรับแต่งภาพผ่าน Skin และ Token

2026-10-20 · การทำงานอิสระในการ์ดตัวเลือกแบบภาพ

ตัวเลือกของ EditorVisualChoiceGroup รองรับ accessory แบบไม่บังคับสำหรับเมนูการ์ดหรือตัวแก้ไขชื่อที่เป็นอิสระ โดย RadioGroup ที่ใช้ร่วมกันวางเนื้อหานี้ข้างป้ายกำกับดั้งเดิม การจัดการการ์ดจึงไม่เปลี่ยนตัวเลือกวิทยุ afterOptions วางคำสั่งแค็ตตาล็อกแยกต่างหาก เช่น สร้างการ์ด หลังตัวเลือก โฮสต์ยังรับผิดชอบการบันทึก สิทธิ์ การตรวจสอบ และโฟกัสหลังแทนที่หรือลบการ์ด ตัวเลือกที่ไม่มีส่วนเสริมคงโครงสร้างและพฤติกรรมเดิม

2026-10-17 · การเคลื่อนไหวของแผงโต๊ะทำงานร่วมกัน

EditorWorkbenchChrome แสดงช่องทางเริ่มต้น/สิ้นสุดที่ฉีดผ่าน BuilderWorkbenchFrame โครงสร้างแผงเดียวกันที่ใช้โดย Creator และแก้ไขเนื้อหา โฮสต์ให้เนื้อหา ความสามารถในการมองเห็น และการตั้งค่าความกว้าง เดสก์ท็อปติดตามและทึบแสง/การแปลของแผงใช้ --qk-sidebar-motion-duration และ --qk-sidebar-motion-easing ร่วมกัน; การลากจะปิดการใช้งานการเปลี่ยนผ่านและการเคลื่อนไหวที่ลดลงจะเปลี่ยนทันที

แผงที่ยุบไว้ยังคงติดตั้งอยู่เพื่อรักษาแบบร่าง กรอบร่วมจะใช้ inert และ aria-hidden ทันที ในขณะที่สกินแพลตฟอร์มจะเสร็จสิ้นการออกก่อนซ่อนความสามารถในการมองเห็น แผงกะทัดรัดคงรูปเรขาคณิตซ้อนทับตลอดการออก; โฮสต์ไม่ควรเพิ่ม hidden หรือ display: none ให้กับเปลือกแผง แผง peek ที่ชัดเจนยังคงพฤติกรรมเปิดเผยแบบโต้ตอบที่มีอยู่ ตัวเลือกส่วนหัวยังคงใช้งานได้ทั่วทั้งสถานะเปิด/ปิด; ใช้ EditorPanelChoiceShortcuts.mobileMenu เมื่อจุดหมายปลายทางบนโทรศัพท์ควรแชร์เมนู

2026-10-17 · ค่าเริ่มต้นของ editor ที่วัดแล้ว

useWorkspaceResponsiveProfile รับค่า onWidthChange(width) แบบไม่บังคับ โดยรายงานความกว้างพื้นที่ทำงานที่มีอยู่เดียวกันที่ใช้สำหรับโปรไฟล์แบบตอบสนองหลังจากหักล้าง padding ภายใน ใช้ callback ที่เสถียรเพื่อหาขนาดเริ่มต้นแบบสัดส่วนโดยไม่เพิ่ม observer อีกตัว useEditorLayout ใช้ sharedWidths.limits กับความชอบของโฮสต์และการจัดเก็บความกว้างร่วมกันด้วย; readEditorLayout รับขีดจำกัดเดียวกันเป็นอาร์กิวเมนต์ที่สี่แบบไม่บังคับ ผู้เรียกที่มีอยู่ยังคงขอบเขตและพฤติกรรมเริ่มต้นไว้

2026-09-30 · การเข้าถึงของ SelectionToolbar

SelectionToolbar.ariaLabel ตั้งชื่อแถบเครื่องมือเป็นพื้นที่ได้ตามต้องการ จำนวนยังคงเป็นข้อความสถานะแบบสด โฮสต์ให้ป้ายกำกับที่แปลแล้ว และใช้ actionContent เพื่อรวมคอมโพเนนต์ที่ใช้ร่วมกันอย่าง EditorToolGroup และ ActionMenu ได้ การตรวจสอบสิทธิ์และตัวจัดการการทำงานยังคงเป็นหน้าที่ของโฮสต์

2026-09-10 · ป้ายระบุตัวตนของพื้นที่ทำงาน

ProjectSwitcherProject.badge รับเนื้อหา React แบบเลือกได้และไม่โต้ตอบ ป้ายจะแสดงข้างชื่อแต่ละรายการ ในแถวบริบทปัจจุบันที่ไม่ได้อยู่ในรายการ และข้างชื่อปัจจุบันของตัวกระตุ้นแบบข้อความ ตัวกระตุ้นที่มีเฉพาะไอคอนยังคงกะทัดรัด ส่วนตัวกระตุ้นข้อความของแพลตฟอร์มจะซ่อนป้ายที่ความกว้างโทรศัพท์เพื่อรักษาพื้นที่สำหรับชื่อพื้นที่ทำงาน เมนูที่เปิดยังคงแสดงป้าย โฮสต์จัดเตรียมข้อมูลที่มีขอบเขตถูกต้อง ป้ายกำกับที่แปลแล้ว และรูปแบบการแสดงผล การไม่ระบุฟิลด์นี้จะคงรูปลักษณ์เดิมไว้

2026-09-08 · EmptyState

EmptyState จัด icon ตกแต่งที่เป็นตัวเลือก, title, description ที่เป็นตัวเลือก และ action ไว้กึ่งกลางบนพื้นโปร่งใส layout="section" เป็นค่าเริ่มต้นแบบกระชับ ส่วน layout="workspace" เว้นพื้นที่มากขึ้น วางการกระทำใน action โดยตรงและใช้ fragment สำหรับหลายปุ่ม ตัวครอบจัดระยะห่างและป้ายกำกับยาว หัวข้อเป็น h2; ใช้ช่อง title แทนตัวเลือก strong คลาสรากเดิมยังคงอยู่ รองรับ skin.vars และ style โฮสต์ดูแลข้อความแปล สิทธิ์ การนำทาง และการสร้าง ผลค้นหาและข้อผิดพลาดคงข้อความและการกระทำของตนเอง

2026-09-08 · SidebarNavigation

SidebarNavigation โหลดเส้นทางต้นทางเดียวกันล่วงหน้าเมื่อวางเมาส์ค้าง 180 มิลลิวินาทีหรือโฟกัสด้วยแป้นพิมพ์ เมนูคงที่และเมนูป๊อปอัปใช้ขีดจำกัดร่วมกัน 8 ปลายทางต่อ 30 วินาที หยุดโหลดเมื่อออฟไลน์ แท็บซ่อนอยู่ เปิด Save-Data หรือใช้ 2G โดยไม่รวมการดาวน์โหลด ลิงก์ปิดใช้งาน หน้าต่างใหม่ และจุดยึดในหน้าเดียวกัน การนำทางและการป้องกันข้อมูลที่ยังไม่บันทึกคงเดิม

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown รองรับตัวเลือก compact และ preferences: โหมดกระชับซ่อนรหัสระบุตัวตนและประวัติการสร้าง โดยค่าเริ่มต้นคงเนื้อหาเดิมไว้ Appearance และ Language รองรับ triggerRole="menuitem" ในเมนูบัญชี การนำทางด้วยแป้นพิมพ์จะคืนโฟกัส และกล่องโต้ตอบภาษาที่ซ้อนอยู่จะจัดการ Escape เอง SidebarNavigation.searchEnabled มีค่าเริ่มต้นเป็น true; ใช้ false สำหรับเมนูสั้นที่มีรายการคงที่ SidebarProfile ที่มี href และไม่มีเมนูจะเปิดปลายทางเดียวกันทั้งโหมดขยายและไอคอน

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

แบบฟอร์มใช้ขนาดตัวอักษรร่วมกันและตัดข้อความยาว โดยคงรูปทรงแคปซูลและสีแบรนด์ FormField ตั้งชื่อกลุ่ม โดย controlId และ id ภายในเชื่อมป้ายกำกับ SearchField คืนโฟกัสหลังล้างค่า Segmented และ ControlMenu รองรับตัวเลือกที่ปิดใช้งาน รายการ ActionMenu ที่ปิดใช้งานไม่มีลิงก์ ปุ่มขณะทำงานคงขนาดและตัวบ่งชี้ AdminEntityDialog ตรวจช่องบังคับ อีเมล และ JSON โฟกัสข้อผิดพลาด ป้องกันการบันทึกซ้ำ และเก็บข้อมูลเมื่อผิดพลาด EditorWorkspace มี ref.focusControl(element) เพื่อแสดงแผงที่ซ่อนก่อนโฟกัส การลดการเคลื่อนไหวปิดการเปลี่ยนผ่านของตัวควบคุม WorkspaceDialog เลื่อนเนื้อหายาวโดยคงหัวข้อและปุ่มการทำงานให้เห็น กล่องโต้ตอบสั้นบนมือถือปรับความสูงตามเนื้อหา

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

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

2026-09-07 · การนำทางร่วมและพื้นผิวโค้งมนของ Qokit

WorkspaceNavigationDock ใช้การนำทางและสิทธิ์ของโฮสต์ผ่าน items, fallback, className และ onClickCapture โดยไม่โหลดเซสชันเพิ่ม ใช้ค่าขยาย ไอคอน หรือซ่อนร่วมกัน และใช้เมนูแบบลิ้นชักเมื่อกว้างไม่เกิน 860px PlatformHeader.leadingContext แสดงใน EditorHeader ด้วย คงปุ่มทรงแคปซูลและพื้นผิวโค้งมน พร้อมลบกรอบที่ซ้ำกัน

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

ติดตั้ง WorkspaceLocationSync หนึ่งครั้งใต้ Suspense ใน layout ของ Next useWorkspaceQueryState(key, defaultValue, validate) คืนค่า [value, setValue, ready] ส่วน useWorkspaceQueryRecord(key, defaults, validators) กู้คืนเฉพาะตัวกรองแบบแบนที่ประกาศไว้ ห้ามเก็บข้อมูลรับรองหรือร่างใน URL WorkspacePage กู้คืนตำแหน่งเลื่อนของเซสชันแบบจำกัดพื้นที่ โดยพื้นที่ภายในใช้ data-workspace-scroll-region และ WorkspaceScrollRestoration การย้อนกลับหรือไปข้างหน้าของเบราว์เซอร์ที่ยกเลิกได้ใช้การป้องกันการออกโดยไม่เพิ่มประวัติ AdminEntityDialog รักษาข้อมูลหลังบันทึกล้มเหลวและเรนเดอร์ใหม่ ส่วนเวอร์ชันและผลบันทึกเป็นหน้าที่ของโฮสต์

ตัวอักษรในหน้าจัดการใช้ระดับคงที่: ชื่อหน้า 20px/650 ชื่อส่วน 16px/600 เนื้อหาและเมนู 14px ป้ายกำกับ 13px และคำอธิบาย 12px โดย --qk-workspace-body-ink และ --qk-workspace-active-ink อิงสีเดิม

ปุ่มหลักทรงแคปซูลคงสีน้ำเงิน Logo #4695D8 และใช้ข้อความ ไอคอน และตัวบ่งชี้การโหลดสีขาวในทั้งสองธีม เมื่อวางเมาส์ยังสว่างขึ้นเล็กน้อย ปุ่มรองและปุ่มอันตรายคงสีตามความหมายเดิม

เมนูแบบเลื่อนลงและตัวสลับพื้นที่ทำงานใช้ --menu-option-font-size (14px) และ --menu-option-font-weight (500) ร่วมกัน โดยมีความสูงบรรทัด 1.45 รายการที่เลือกใช้น้ำหนัก 600 และข้อมูลเสริมใช้ 12px/400 WorkspaceNavigationDock โหลดปลายทางจากต้นทางเดียวกันล่วงหน้าเมื่อวางเมาส์หรือโฟกัสด้วยแป้นพิมพ์ พร้อมจำกัดบันทึกการตรวจซ้ำ การป้องกันการออกและเส้นทางของโฮสต์ยังทำงานตามเดิม

2026-09-07 - ColumnLayout

ColumnLayout เติมเต็มหน้าต่างจัดการด้วยแถบนำทางคงที่ พื้นที่เลื่อนแยก และแถบเครื่องมือหน้าที่อยู่ด้านบนเสมอ WorkspacePage ใช้ส่วนเนื้อหาเรียบและ Token มุมโค้งร่วมกัน ที่ความกว้างไม่เกิน 860px การนำทางยังเป็นลิ้นชักและโต้ตอบไม่ได้เมื่อปิด พร็อพและพฤติกรรมทางธุรกิจไม่เปลี่ยน ให้ลบระยะขอบภายนอกที่ซ้ำและจำกัดความกว้างสำหรับอ่านภายในแบบฟอร์ม

จุดนำเข้า

import { Button, Card, Dialog, IconButton } from '@qokit/components/ui';
import { PlatformHeader, SiteFooter } from '@qokit/components/patterns';
import { platformButtonSkin } from '@qokit/components/skins/platform';
import { siteCardSkin } from '@qokit/components/skins/site';
จุดนำเข้าวัตถุประสงค์
@qokit/components/uiComponent พื้นฐานเช่น Button, Card, Dialog, Menu, Pill ฯลฯ
@qokit/components/patternsชุดประกอบเช่น Header, Footer, Workspace, Table, Resources และ AI Assistant
@qokit/components/skins/platformสูตรภาพสำหรับแพลตฟอร์มและ Workspace
@qokit/components/skins/adminสูตรภาพสำหรับ Admin
@qokit/components/skins/siteสูตรภาพสำหรับไซต์ที่สร้างขึ้น

ขอบเขตหน้าที่สาธารณะ

PromptPanel รับค่า referenceReader ที่ไม่บังคับและคุณสมบัติ referenceCopy แบบโลคัลไลซ์ ตัวอ่านจะส่งคืน contentExcerpt และ truncated ที่แยกออกมาผ่าน file(File, AbortSignal) และ website(url, AbortSignal) แบบอะซิงโครนัส โดยการจัดการการรับรองความถูกต้องและการเข้าถึง API เป็นความรับผิดชอบของโฮสต์ คอมโพเนนต์จัดการการอ่าน, การแสดงตัวอย่าง, การลองใหม่ และการลบ; หาก URL ที่ถูกต้องไม่มีข้อความแจ้งเตือน จะมีการขอข้อมูลเพิ่มเติมโดย referenceCopy.websitePrompt และหากมีรูปแบบผิดพลาดจะใช้ referenceCopy.errors.url เพื่อป้องกันการอ่าน หาก URL ยังไม่ได้ถูกอ่านหรือกำลังอยู่ในระหว่างกระบวนการส่งคำขอจะรอเนื้อหาล่าสุดและส่งเพียงครั้งเดียว; การเปลี่ยนแปลงอินพุตหรือการอ่านล้มเหลวจะยกเลิกการดำเนินการที่รอดำเนินการ และการลองใหม่จะไม่กู้คืนคำขอเก่า ไฟล์ต้องพร้อมจึงจะสามารถส่งได้ URL ที่สมบูรณ์จะถูกอ่านอัตโนมัติเมื่อวาง, เสียโฟกัส หรือกด Enter และ URL เริ่มต้นจะถูกอ่านด้วยโดยนำผลลัพธ์ที่กำลังดำเนินการอยู่หรือเสร็จสิ้นแล้วมาใช้ซ้ำ; หากล้มเหลวจะมีการแจ้งให้ลองใหม่อย่างชัดเจน การแก้ไขหรือลบ URL จะยกเลิกการอ่านเก่าและล้างผลลัพธ์ หากไม่มีการระบุตัวอ่าน ระบบจะดำเนินการส่งแบบดั้งเดิมต่อไปโดยไม่จัดการการอ้างอิงอะซิงโครนัส

การรับข้อมูลการอ้างอิงถูกเพิ่มเข้ามาในเดือนกันยายน 2026 ในฐานะความสามารถของคอมโพเนนต์ที่ไม่บังคับและรองรับย้อนหลัง

Skeleton Component รับประกัน:

  • DOM และแท็กความหมาย;
  • พฤติกรรม ARIA, คีย์บอร์ด, โฟกัส และ disabled;
  • สถานะและปฏิสัมพันธ์พื้นฐาน;
  • class เริ่มต้นที่เสถียร;
  • ช่องว่าง Skin ที่มีชื่อ

Skin สามารถ:

  • เพิ่ม class ให้กับช่องว่างเช่น root, header, body, item, action ฯลฯ;
  • ส่งตัวแปร CSS ผ่าน vars;
  • ใช้ tone, layer หรือสวิตช์การปรับแต่งภาพที่ Component เปิดเผยไว้แล้ว

Skin ไม่สามารถขอข้อมูล, เปลี่ยนแปลง DOM, เก็บกฎทางธุรกิจ หรือหลีกเลี่ยงพฤติกรรมความสามารถในการเข้าถึงได้

สร้างเนื้อหาองค์ประกอบ

บล็อกที่กำหนดเองที่สร้างขึ้นยังคงใช้องค์ประกอบ html-* ที่ลงทะเบียนไว้ใน Schema v2 และไม่ใช้ HTML ที่สามารถทำงานได้หรือประเภทบล็อกใหม่ เริ่มตั้งแต่เดือนกันยายน 2026, @qokit/site-schema ให้บริการ bindSiteModuleContent, updateSiteModuleBoundContent และ forkSiteModuleContentBindings สำหรับการผูกมัดเนื้อหาภาษา เส้นทางเนื้อหาถูกบันทึกในโมดูล และข้อความของผู้เยี่ยมชมถูกบันทึกในการแมปเนื้อหาภาษา การอัปเดตปฏิบัติตามธุรกรรมการเพิกถอนและการบันทึก; เมื่อคัดลอกหรือย้ายองค์ประกอบข้ามบล็อก ต้องสร้างการผูกมัดใหม่เพื่อหลีกเลี่ยงการเปลี่ยนแปลงแหล่งที่มา

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

ฟอร์มคอนโทรล

ฟอร์มร่วมใช้ FormField เพื่อเชื่อมโยงป้ายชื่อ, คำอธิบาย, เมตาข้อมูลบังคับ, ข้อผิดพลาด และ ID ของคอนโทรล คอนโทรลข้อความใช้ Input, เนื้อหาหลายบรรทัดใช้ Textarea, คอนโทรลตัวเลือกใช้ Checkbox, RadioGroup และ Switch; ทั้ง Select และ SearchField ใช้สัญญาขนาดและสถานะเดียวกัน

import { FormField, Input } from '@qokit/components/ui';

<FormField label="Site name" description="Up to 60 characters" error={errors.name} required>
  <Input name="name" value={name} onChange={handleChange} />
</FormField>;

FormField เชื่อมโยงป้ายชื่อ, คำอธิบาย และข้อผิดพลาดไปยังคอนโทรลลูกที่เป็นเอกลักษณ์ผ่าน id, aria-describedby, aria-invalid และ required อย่าห่อหุ้มคอนโทรลร่วมด้วย <label> เพิ่มเติมอีก

Input, Textarea, Select และ SearchField รองรับสามขนาดคือ sm, md และ lg ซึ่งสอดคล้องกับ 40px, 44px และ 48px คอนโทรลบรรทัดเดียวใช้รูปร่าง pill เป็นค่าเริ่มต้น; Textarea ใช้มุมโค้งแบบหลายบรรทัดร่วมกันเสมอ สถานะปฏิสัมพันธ์และข้อผิดพลาดทั้งหมดมาจาก Token ร่วม

ในช่วงเวลาเปลี่ยนผ่านยังสามารถใช้สัญญา .qk-field แบบเก่าได้; การเชื่อมต่อใหม่ควรใช้คอมโพเนนต์ร่วมและช่องว่าง Skin ที่มีชื่อเฉพาะ

การเลือกจากรายการ

เริ่มตั้งแต่เดือนกันยายน 2026, รายการสามารถใช้ useWorkspaceSelectionMode({ enabled, resetKey, onClear }) ร่วมกับ WorkspaceFilterToolbar.selection ได้ Hook นี้เริ่มต้นในสถานะปิดใช้งาน และรีเซ็ตเมื่อขอบเขตหรือสิทธิ์เปลี่ยนแปลง โดยแยกแยะระหว่างการล้าง ID ที่เลือกและการออกจากโหมดแบทช์; คีย์ขอบเขตควรรวมถึงคอลเลกชัน, ภาษา, การแบ่งหน้า และตัวกรอง

ส่งเฉพาะ WorkspaceDataTable.selection เมื่อโหมดแบทช์เปิดใช้งาน กริดและคอนโทรลเช็คบ็อกซ์บนมือถือใช้โหมดเดียวกัน แถบเครื่องมือรับผิดชอบการดำเนินการเลือกทั่วไป โดยผู้ใช้งานให้ข้อความโลคัลไลซ์, ID ที่ไม่บังคับ และการดำเนินการโดเมนที่ผ่านการตรวจสอบสิทธิ์แล้ว actionContent ที่ไม่บังคับสามารถรองรับความหมาย ARIA เพิ่มเติม แต่ไม่แทนที่คอนโทรลทั่วไปหรือการยืนยัน รายการแบบอ่านอย่างเดียวจะไม่แสดงโหมดแบทช์, ตัวเลือกไฟล์และการตรวจสอบข้อเสนอจะรักษาความหมายของตนเองไว้

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

การ์ดเมตริก

เอกสาร API เพิ่มเติม (ภาษาอังกฤษ รอการแปล) · 2026-10

DataCard provides a title and optional headerAction, body content with an optional emphasized value, and optional footerText and footerAction. Pass other body content as children. density="default" has a 144px minimum height and 20px padding; density="compact" has a 112px minimum height and 16px padding. Cards grow when content needs more room. variant selects the shared Card surface: surface, muted, or state. Choose these shared sizes instead of overriding height, padding, or value typography in route CSS.

Use shared UI controls in action slots. Keep the card root non-interactive when it has actions; a whole-card action cannot contain nested buttons or links. MetricCard composes the same skeleton and retains label, detail, semantic tone, and optional visuals.

import { DataCard, MetricCard } from '@qokit/components/patterns';
import { Button } from '@qokit/components/ui';

<DataCard
  title="Published"
  value={24}
  headerAction={<Button size="sm" variant="ghost">View</Button>}
  footerText="Up 3 from last week"
  footerAction={<Button size="sm" variant="secondary">Details</Button>}
  density="compact"
/>;

<MetricCard density="compact" label="Published" value={24} tone="success" />;

Logo แสดงภาพนิ่งเป็นค่าเริ่มต้น motion="breathe" จองขนาดไว้ขณะซ่อน แล้วแสดงโลโก้ครั้งเดียวด้วยจังหวะหายใจ 4.8 วินาทีเมื่อหน้าโหลดเสร็จและมองเห็นอย่างน้อยครึ่งหนึ่ง ส่วนหัวและส่วนท้ายไม่เพิ่มเวลารอ motionVisibilityDelayMs เพิ่มระยะเวลาที่ต้องมองเห็นต่อเนื่องได้ โดยค่าเริ่มต้นเป็นศูนย์ motionOnceKey ใช้บันทึกการเล่นร่วมกันเมื่อเมานต์ใหม่ในเอกสารเดิม ส่วนหัวและส่วนท้ายใช้คีย์แยกกัน การนำทาง เปลี่ยนธีม หรือเลื่อนกลับไม่เล่นซ้ำ การโหลดทั้งหน้าใหม่จะรีเซ็ตบันทึก เมื่อเปิดโหมดลดการเคลื่อนไหว ปิด JavaScript หรือไม่รองรับการสังเกตการมองเห็น จะแสดงโลโก้ภาพนิ่ง motion="reveal" ยังคงเป็นชื่อแทน

PlatformHeader.autoHideOnScroll มีค่าเริ่มต้นเป็น false โดย PublicPlatformHeader เปิดใช้งาน ส่วนหัวซ่อนเมื่อเลื่อนลงและกลับมาเมื่อเลื่อนขึ้นหรืออยู่ใกล้ด้านบน เมนูส่วนหัวที่เปิดอยู่หรือโฟกัสภายในทำให้ยังคงมองเห็น ส่วนหัวของพื้นที่ทำงานและตัวแก้ไขอยู่กับที่

PlatformHeader เป็น Skeleton ของ Header ที่ไม่มีสถานะทางธุรกิจ PublicPlatformHeader ประกอบแบรนด์, การนำทางสาธารณะ, ภาษา, ธีม, เข้าสู่ระบบ, "ลองใช้เลย" และเมนูมือถือเหนือสิ่งนี้ โดยสถานะไม่ระบุตัวตนของแพลตฟอร์มและเว็บไซต์เอกสารจะใช้ชุดประกอบนี้โดยตรง

การนำทางสาธารณะสร้าง "Resources / Pricing / News" ผ่าน buildPublicHeaderNavItems(copy, links) อย่างสม่ำเสมอ ผู้เข้าร่วมเพียงแก้ไข URL ภายในไซต์, เว็บไซต์เอกสาร และแพลตฟอร์มของแอปพลิเคชันปัจจุบันเท่านั้น ไม่ควรกำหนดลำดับเมนูหรือข้อความซ้ำ Header ของแพลตฟอร์มหลังจากเข้าสู่ระบบก็ใช้ฟังก์ชันการสร้างเดียวกัน

<PublicPlatformHeader
  copy={headerCopy}
  links={{
    brandHref: '/',
    resourceCenterHref: '/resources',
    userManualHref: 'https://docs.qokit.com/manual',
    developerDocsHref: 'https://docs.qokit.com/developers',
    changelogHref: 'https://docs.qokit.com/changelog',
    pricingHref: '/pricing',
    newsHref: '/news',
    loginHref: '/login',
    studioHref: '/studio'
  }}
/>

navItems ด้านล่างยังคงรองรับ link, scroll และ menu menu รองรับเดสก์ท็อปด้วยการคลิก, คีย์บอร์ด, Escape และการคลิกภายนอกเพื่อปิด ส่วนมือถือจะขยายเป็นกลุ่มลิงก์โดย MobileHeaderMenu

SiteFooter เป็น Skeleton ของ Footer; แพลตฟอร์มและเว็บไซต์เอกสารใช้ PublicPlatformFooter เพื่อประกอบ Shell ชั้นนอก, แบรนด์, ลิงก์, ธีม และวิดเจ็ตภาษาอย่างสม่ำเสมอ การเชื่อมต่อข้ามโดเมนใช้ resolveCompanyHref เพื่อแปลงลิงก์สัมพัทธ์ของแพลตฟอร์มเป็นที่อยู่สัมบูรณ์

<PublicPlatformFooter
  brandHref="https://qokit.com"
  copy={footerCopy}
  resolveCompanyHref={(href) => `https://qokit.com${href}`}
/>

แอปพลิเคชันธุรกิจไม่สามารถคัดลอก DOM ของ Header, Footer หรืออาร์เรย์การนำทางสาธารณะได้; หากต้องการการแสดงภาพที่แตกต่างกัน ให้ใช้ PlatformHeaderSkin, SiteFooterSkin หรือ Skin ของแพลตฟอร์มที่เกี่ยวข้อง

กลยุทธ์ความเข้ากันได้

  • การเพิ่มคุณสมบัติแบบเลือกได้และช่องว่าง Skin ถือเป็นการเปลี่ยนแปลงที่ย้อนกลับเข้ากันได้;
  • การลบคุณสมบัติ, การแก้ไขความหมายเริ่มต้น หรือการเปลี่ยนแปลง DOM/พฤติกรรมคีย์บอร์ด ถือเป็นการเปลี่ยนแปลงที่มีผลทำลายล้าง;
  • การเปลี่ยนแปลงที่มีผลทำลายล้างต้องเข้าสู่ Changelog และให้ตัวอย่างการย้ายข้อมูล;
  • อย่าพึ่งพา class ภายใน, ไดเรกทอรี หรือโครงสร้าง route ที่ไม่ได้เปิดเผย;
  • เมื่อจุดเชื่อมต่อมากกว่าสองจุดต้องการการเขียนทับที่เหมือนกัน ควรยกระดับเป็น Skin หรือ Token สาธารณะ

การแก้ไขแบบเต็มหน้าจอ

EditorWorkspace รวมกล่องโต้ตอบเต็มหน้าจอ การจัดการโฟกัส และแผงที่ปรับตามขนาดหน้าจอ dirty ขอการยืนยันก่อนทิ้งการเปลี่ยนแปลง busy ป้องกันการปิดระหว่างบันทึก และ onSave รองรับ Ctrl/Cmd+S แอปเจ้าของหน้าจอรับผิดชอบสิทธิ์ ข้อมูล การบันทึก และการเผยแพร่

view / onViewChange สลับ edit, focus และ preview โดยไม่แทนที่ตัวแก้ไขเอกสาร preview จัดเตรียมตัวอย่าง ส่วน previewPanel ใช้แผงเดิมซ้ำ layout รองรับ writing, structure และ canvas โดย storageKey จำเฉพาะความกว้างและการย่อแผง ไม่เก็บเอกสาร

onSaveAndClose คืน true เมื่อยืนยันว่าบันทึกแล้ว, false เมื่อผิดพลาด, handled เมื่อแอปเปลี่ยนหน้าแล้ว หรือ pending เมื่อการตรวจสอบรอการตัดสินใจ หากล้มเหลว ตัวแก้ไขยังเปิดอยู่ ใช้ closeBehavior="collapse" เฉพาะเมื่อแอปเก็บฉบับร่างไว้ EditorSaveStatus แสดงสถานะที่ยืนยันแล้ว และสามารถประกอบ EditorViewControls, EditorLeaveDialog กับ useEditorLayout แยกกันได้

การเปลี่ยนแปลงแป้นพิมพ์: Segmented มีจุดหยุด Tab เดียว ใช้ลูกศร / Home / End เพื่อเปลี่ยนตัวเลือก Dialog เคารพการจัดการ Escape ของชั้นย่อย จากนั้นตัวแก้ไขออกจากโหมดโฟกัสหรือตัวอย่างก่อนปิด LivePreviewToolbar.exitControl รับตัวควบคุมมุมมองร่วม การบันทึก การเผยแพร่ และสิทธิ์ยังเป็นหน้าที่ของแอป

import { EditorWorkspace } from '@qokit/components/patterns';

<EditorWorkspace
  open={open}
  title={title}
  dirty={dirty}
  busy={saving}
  onClose={closeEditor}
  onSave={saveDraft}
  onSaveAndClose={saveDraft}
  saveState={saveState}
  layout="writing"
  storageKey="article"
  preview={preview}
  navigation={structure}
  inspector={properties}
  actions={saveActions}
>
  {editor}
</EditorWorkspace>

SidebarToggleSlot

SidebarToggleSlot ย้ายปุ่มแถบด้านข้างไปยังส่วนหัวของพื้นที่ทำงาน ใช้หนึ่งช่องร่วมกับแถบด้านซ้ายหนึ่งแถบ SidebarNavigation ยังคงจัดการสถานะ ปุ่มลัด และแผงบนมือถือ หากไม่มีช่องนี้ ปุ่มจะอยู่ที่เดิม ปุ่มในส่วนหัวใช้ปิดแผงบนมือถือด้วย และโฟกัสจะกลับไปยังปุ่มเดิมเมื่อปิด

EditorHeader

EditorHeader คงโลโก้ บัญชี และเมนูส่วนกลางของแอปไว้ในตัวแก้ไขที่ใช้งานอยู่ startControl และ endControl ควบคุมแผงด้านข้าง ส่วน center ใช้สำหรับเปลี่ยนมุมมอง และ actions ใช้สำหรับบันทึก PlatformHeader.editorActions ใช้การนำทางแบบตอบสนอง ตัวเลือกภาษาและธีมเดิม onNavigate ต้องจัดการการเปลี่ยนแปลงที่ยังไม่บันทึกก่อนเรียก callback บนหน้าจอแคบส่วนหัวจะแสดงสองแถว และเมนูย่อยจะจัดการ Escape ก่อน

WorkspaceHeaderPortal.startControl และ endControl วางสวิตช์แผงหน้าเพจที่จัดการได้ในช่องที่ตรงกันของโฮสต์ โฮสต์เปิดเผย startTarget และ endTarget ที่ไม่บังคับ alongside ชื่อ, สถานะ และการดำเนินการ ห้องสมุดไฟล์และพื้นที่ทำงานสำหรับสินทรัพย์เดียวใช้ workAreaControls; การแสดงตัวอย่างสินทรัพย์คงส่วนหัวทั้งหมดไว้เพื่อให้ตัวตน, การกระทำกลับคืน และจุดหมายปลายทางของแผงยังคงใช้งานได้ ProjectWorkspace เป็นเจ้าของการนำทางด้านซ้าย/ตัวเลือกการสนทนาที่ใช้ร่วมกันสำหรับเนื้อหาและไฟล์ ไฟล์ลงทะเบียนมิติแผงทรัพยากรที่จำได้ผ่าน useProjectResourcePanel, นำทางผ่าน ProjectContentTools, และให้เฉพาะตัวควบคุมผู้ตรวจสอบด้านขวาผ่าน ProjectToolbar.endControl การสนทนาใช้ช่องทางซ้ายเดียวกันและคอมโพเซอร์แบบฝังทั่วทุกพื้นที่โครงการ งานในทรัพยากรแบบกะทัดรัด, การสนทนา และผู้ตรวจสอบนั้นไม่สามารถเกิดขึ้นพร้อมกันได้

EditorNavigationMenu

EditorNavigationMenu ใช้ SidebarNavigation ทั้งหมดของแอปในแผงซ้อนทับ โดยคงสิทธิ์และบริบทโครงการไว้และไม่เลื่อนพื้นที่แก้ไข ภาษาและธีมอยู่ด้านล่าง เมนูย่อยจัดการ Escape ก่อน โหมดโฟกัสและเต็มหน้าจอของเบราว์เซอร์ทำงานแยกกัน การนำทางรอให้การบันทึกที่กำลังทำงานเสร็จและปกป้องฉบับร่าง

WorkspaceNavigationMenu / WorkspacePageHeader

การนำทางส่วนกลางใช้ Command+\ บน Mac หรือ Control+\ บน Windows/Linux และทำงานแยกกันได้ภายใน Creator โดย T และ Shift+T ยังคงควบคุมเค้าโครงตัวแก้ไข ระบบจะละเว้นช่องที่แก้ไขได้ การประกอบข้อความ เหตุการณ์ซ้ำ และเหตุการณ์ที่จัดการแล้ว คำแนะนำบนปุ่มและ aria-keyshortcuts แสดงชุดปุ่ม โดยการนำทางส่วนกลางจะไม่ใช้ T เดี่ยวอีกต่อไป

พื้นที่ทำงานหลังเข้าสู่ระบบใช้ PlatformHeader.workspaceActions ร่วมกันสำหรับบัญชีและการนำทางในทุกความกว้าง WorkspacePageHeader ทำให้ชื่อและการดำเนินการสอดคล้องกัน WorkspaceNavigationMenu แสดงแถบด้านข้างปัจจุบันพร้อมสิทธิ์และบริบท โดย EditorNavigationMenu ยังคงเป็นชื่อแทนที่เข้ากันได้ Studio คงแถบเครื่องมือของตนไว้ ส่วนหัวหน้าสาธารณะคงรูปแบบเดิม

WorkspaceNavigationGuard ป้องกันการนำทางส่วนกลางด้วย dirty, busy, error และ onSave ที่เลือกใช้ได้ ออกจากหน้าได้เมื่อยืนยันว่าบันทึกสำเร็จและคืนค่า true เท่านั้น หากล้มเหลวจะเก็บฉบับร่างไว้ Language.onBeforeChange(apply) ช่วยใช้การป้องกันเดียวกันก่อนเปลี่ยนภาษา ปิดใช้งานช่องแบบฟอร์มระหว่างบันทึก

การนำทางบนเดสก์ท็อปยังมีโหมดขยายและไอคอน พร้อมเพิ่มการซ่อนอัตโนมัติ แถบด้านข้างและแผงเลื่อนใช้การค้นหาและสถานะกลุ่มร่วมกัน ตัวชี้แบบละเอียดที่ขอบ 300ms จะเปิดตัวอย่างชั่วคราว และปิดหลังออกไป 320ms การคลิกจะเปิดค้างไว้ ยังมีปุ่มสำหรับสัมผัสและแป้นพิมพ์ Dialog ใช้ modal={true} และ autoFocus={true} โดยค่าเริ่มต้น ตัวอย่างชั่วคราวตั้งทั้งคู่เป็น false เพื่อรักษาโฟกัสและการเลื่อน

EditorViewControls

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

EditorViewControls แยกโหมดแก้ไข/โฟกัสจากเต็มหน้าจอ ตัวอย่างเป็นปุ่มสลับอิสระและกลับไปยังโหมดแก้ไขก่อนหน้า โดย useEditorWorkMode เก็บโหมดนี้สำหรับคำสั่งออกที่กำหนดเอง ค่า edit/focus/preview ยังคงรองรับ ตัวอย่างใช้ button พร้อม aria-pressed แทน radio ในกลุ่มโหมด เต็มหน้าจอต้องคลิกอย่างชัดเจน รวมการนำทางและกล่องโต้ตอบไว้ในรากแอป และซ่อนเมื่อไม่รองรับ

Language / Appearance

Language และ Appearance variant="menu" รองรับ layout="row" เพื่อแสดงป้ายชื่อ ค่าปัจจุบัน และลูกศร โดยคงรูปแบบกะทัดรัดเริ่มต้นและการป้องกันเมื่อเปลี่ยนภาษาไว้ SiteHeaderCopy.helpResources และ contactSupport ใช้กำหนดชื่อของลิงก์ช่วยเหลือในพื้นที่ทำงานได้ตามต้องการ

requestWorkspaceNavigation

หน้าที่มีปุ่มสลับแถบด้านข้างจะซ่อนปุ่มเมนูซ้ำในส่วนหัว รวมถึงเมื่อย่อแถบและบนมือถือ ส่วนตัวแก้ไขและหน้าที่ไม่มีแถบด้านข้างยังคงมีปุ่มนี้ นำเข้า requestWorkspaceNavigation(returnFocusTarget?) และ useWorkspaceNavigationState() จาก @qokit/components/patterns/WorkspaceNavigation: คำขอจะสลับแผงที่ลงทะเบียนไว้ และคืนค่า false เมื่อไม่มีแผงพร้อมใช้งาน องค์ประกอบที่ระบุได้จะรับโฟกัสเมื่อปิด ตรวจสอบ .available ก่อนแสดงช่องทางเข้าอื่น ใช้ปุ่มเดิมหรือ API นี้แทนการอ้างอิงตำแหน่ง DOM ของปุ่มที่ถูกลบ

WorkspacePanelReveal

การนำทางส่วนกลางใช้ไอคอนเมนู เครื่องมือใช้ไอคอนแผงซ้ายหรือขวา useWorkspacePanelReveal({ temporary: true }) เปิดเครื่องมือชั่วคราวด้วยการคลิกหรือคีย์บอร์ดในโหมดโฟกัส toggle(trigger?) และ close(true) คงเค้าโครงและโหมดทำงาน พร้อมคืนโฟกัสเมื่อปิด ขอบหน้าจอเปิดการนำทางส่วนกลาง เครื่องมือตอบสนองใกล้ปุ่มของตน โหมดตัวอย่างซ่อนปุ่มแผงและมีคำสั่งกลับไปยังโหมดแก้ไขก่อนหน้าอย่างชัดเจน

EditorViewControls / โหมดแสดงผล

EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts

EditorHeader จัดการ EDITOR_TOOLBAR_SHORTCUTS ด้วย: Command/Control+S เรียก EditorSaveButton ที่มองเห็นอยู่, Shift+P เปิด EditorStatusAction shortcut="publish" และ Shift+M เปิดเมนูเครื่องมือ คำสั่งใช้ตัวควบคุมที่เปิดใช้งานเดียวกับการคลิก การเผยแพร่ยังต้องสั่งอย่างชัดเจนภายในแผง เฉพาะส่วนหัวที่ใช้งานและมองเห็นอยู่เท่านั้นที่ตอบสนอง เมนูย่อย กล่องโต้ตอบ การประกอบข้อความ และเหตุการณ์กดซ้ำจะบล็อกทางลัด ในช่องป้อนข้อมูลอนุญาตเฉพาะการบันทึก คำแนะนำและ aria-keyshortcuts ใช้คำนิยามเดียวกัน toolsControl แบบกำหนดเองระบุ aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} บนปุ่มเรียก ActionMenu.triggerKeyShortcuts เพิ่มแอตทริบิวต์และคำแนะนำโดยไม่ลงทะเบียนคำสั่งส่วนกลาง

คำสั่งแผงคือ Shift+A (เพิ่ม), Shift+L (หน้า/เลเยอร์), Shift+K (สนทนา), Shift+C (เนื้อหา), Shift+D (ออกแบบ), Shift+G (รูปแบบส่วนกลาง) CMS เพิ่ม Shift+S (การตั้งค่า), Shift+E (SEO), Shift+H (ประวัติ) เมื่อพร้อมใช้ เมทาดาทา shortcut ใน EditorChoiceControl, EditorViewTabs และ ActionMenu ใช้คำแนะนำร่วมกัน EditorPanelChoiceShortcuts และ EditorViewControls.compactActions คงการทำงานเดิมเมื่อยุบเข้าเมนู รวมถึงบนโทรศัพท์ EditorPanelShortcuts.commands ลงทะเบียนการทำงานเดิมโดยไม่สร้างตัวควบคุมซ้ำ ข้อจำกัดซ่อน, inert, ปิดใช้งาน, ตัวอย่างและชั้นซ้อนยังคงมีผล แถบด้านข้างโทรศัพท์ที่ไม่ใช่โมดัลในพื้นที่เดียวกันอนุญาตให้สลับแผง แต่เมนูและกล่องโต้ตอบโมดัลบล็อกทางลัด ปุ่มที่ไม่มีตัวปรับคงพฤติกรรมเดิม

โหมดแสดงผล
Eแก้ไข
Tแก้ไข ↔ โฟกัส
Vดูตัวอย่าง / กลับไปแก้ไข
Fเปิดเต็มหน้าจอ / ออกจากเต็มหน้าจอ

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

PlatformHeader.workspaceNavigation

PlatformHeader.workspaceNavigation วางการนำทางส่วนกลางไว้ก่อนโลโก้ ส่วน workspaceActions และ editorActions คงการทำงานของบัญชีไว้ พื้นที่ทำงานใช้ปุ่มแถบด้านข้างเดิม และตัวแก้ไขวางปุ่มแผงด้านขวาไว้ก่อนอวตาร บนหน้าจอแคบ การนำทาง แบรนด์ ชื่อ และอวตารอยู่แถวบน ส่วนเครื่องมือแก้ไขและบันทึกอยู่แถวล่าง ลำดับ DOM สอดคล้องกับเค้าโครง และคงเอฟเฟกต์กระจกฝ้าแบบไร้ขอบไว้

2026-09-06 - EditorHeader.preview / EditorViewControls.returnView

EditorHeader.preview แสดงเฉพาะ center เป็นแถบดูตัวอย่างกะทัดรัดไร้ขอบ โดยโลโก้ บัญชี การบันทึก และแผงยังเมานต์อยู่แต่ซ่อนไว้ หากใช้ LivePreviewToolbar แยก สามารถซ่อนส่วนหัวตัวแก้ไขและใช้ EditorViewControls.returnView (edit หรือ focus) เพื่อคืนโหมดเดิม คงปุ่มกลับที่เข้าถึงได้และการควบคุมเต็มหน้าจออิสระไว้ ส่วนหัวเว็บไซต์เองยังแสดงอยู่

2026-09-06 · Builder / CMS

Builder และ CMS ใช้ BuilderWorkspace, EditorCatalog และ EditorComponentSettings ร่วมกันสำหรับแผง ภาพประกอบการแทรก และการตั้งค่าการแสดงผล พรีเซ็ตใช้การตั้งค่าที่เกี่ยวข้องพร้อมกันและรักษาเนื้อหาเดิม โดยแต่ละแอปจัดการการบันทึกและเลิกทำ ส่วนควบคุมใช้ธีมแพลตฟอร์ม ส่วนเนื้อหาใช้ธีมเว็บไซต์

ส่วนท้ายที่เรนเดอร์บนเซิร์ฟเวอร์ · 2026-09-07

SiteFooterLayout รับค่า locale ที่ระบุชัดเจนและ copy สำหรับภาษาเดียว คอมโพเนนต์ฝั่งเซิร์ฟเวอร์เรนเดอร์โครงสร้างส่วนท้ายที่ใช้ร่วมกัน ส่วนตัวควบคุมธีม ภาษา และกล่องโต้ตอบ QR ยังคงเป็นคอมโพเนนต์ฝั่งไคลเอนต์ อินเทอร์เฟซเดิม SiteFooter และ PublicPlatformFooter ยังคงรองรับ

import { SiteFooterLayout } from '@qokit/components/patterns/SiteFooter';

<div className="qk-platform-footer-shell">
  <SiteFooterLayout locale={locale} copy={footerCopy} />
</div>

เตรียมลิงก์ข้ามโดเมนใน copy.companyLinks บนเซิร์ฟเวอร์ ใช้ controls เพื่อปรับแต่งพื้นที่ตัวควบคุมแบบโต้ตอบ

EditorHeader.titleControl / FloatingAssistant.presentation

EditorHeader.titleControl และ EditorWorkspace.titleControl ใช้แทนชื่อด้วยเมนูโครงการร่วมได้ คง title ที่สื่อความหมายและการป้องกันการเปลี่ยนแปลงที่ยังไม่บันทึกเมื่อเปลี่ยนหน้า FloatingAssistant.presentation="embedded" แสดงพื้นที่ที่มีชื่อภายในแผงหลัก โดยไม่มีปุ่มลอยหรือฉากหลังทับหน้า ค่าเริ่มต้นยังเป็น floating หน้าหลักควบคุมตำแหน่งและการแสดงผล ส่วนผู้ช่วยจัดการสถานะการสนทนาและสิทธิ์

2026-09-07 · WorkspaceAssembly

WorkspaceAssembly ทำเครื่องหมายการ์ดที่ออกและส่วนที่เข้าโดยไม่เพิ่มกล่องเค้าโครง หากต้องใช้ลูกโดยตรง ให้ใส่ workspaceAssemblyAttributes(part, index, phase) บน DOM เดิม ส่วน EditorHeader.assemble และ BuilderWorkspacePanels.assemble ให้เครื่องหมายสำหรับตัวแก้ไข

เรียก await startWorkspaceAssembly(navigate, destinationPathname) หลังสร้างสำเร็จเท่านั้น โดยจับภาพส่วนที่มองเห็น นำทางครั้งเดียว แล้วประกอบปลายทางหรือโครงร่างโหลดที่ตรงกันภายใน 720 มิลลิวินาที ปลายทางต้องมีเครื่องหมายขาเข้า canvas และใช้ useWorkspaceAssemblyPending() คงหน้าจอโหลดไว้จนภาพเข้าที่ พร้อมโหลดข้อมูลและโค้ดล่วงหน้า เมื่อลดการเคลื่อนไหวหรือเบราว์เซอร์ไม่รองรับ ให้นำทางโดยตรง การเปลี่ยนผ่านที่ช้าหรือถูกขัดจังหวะจะคืนทรัพยากรภาพและนำทางต่อ เครื่องหมายอย่างเดียวไม่ทำให้การแก้ไข โหลดใหม่ หรือประวัติมีภาพเคลื่อนไหว รูปแบบร่วมดูแลสไตล์ชั่วคราวและการล้าง ส่วนโฮสต์ดูแลข้อผิดพลาด การทำซ้ำโดยไม่มีผลเพิ่ม และสถานะโหลด

2026-09 · พื้นที่จัดการ

WorkspacePage และ WorkspaceLayout รองรับ variant: overview, list, detail, settings หรือ editor โดย WorkspaceFormFooter จัดวาง actions, message, tone และ busy จากแอปโฮสต์ ส่วนการบันทึกข้อมูลเป็นหน้าที่ของโฮสต์

ตารางแคบ (WorkspaceDataTable, AdminDataTable) แสดงระเบียนพร้อมป้ายกำกับ โดยคงการเลือก หัวตารางที่กำหนดเอง และการกระทำ ใช้ mobileLayout="scroll" สำหรับตารางเปรียบเทียบ WorkspaceFilterToolbar วางการค้นหาและตัวกรองก่อนการเรียงลำดับและมุมมอง แถบด้านข้างใช้ h2 และหน้าใช้ h1

2026-09-08 · Task focus

useSidebarTaskFocus(active) ซ่อนเมนูนำทางชั่วคราวระหว่างงานที่ต้องใช้สมาธิ และคืนค่าการแสดงผลเดิมเมื่อออก เว้นแต่ผู้ใช้จะเปลี่ยนโหมดด้วยตนเอง การซ่อนอัตโนมัติไม่เขียนทับค่าที่บันทึกไว้

เอกสาร API เพิ่มเติม (ภาษาอังกฤษ รอการแปล)

EditorHeader.contextMode="title" displays the editor's own titleControl instead of the host workspace picker. The default "host" behavior is unchanged; navigation, brand, account controls and leave guards retain their existing ownership. Hosts supply responsive placement for their title control.

EditorViewControls.focusInMenu shows a labelled preview action and moves focus mode into the shared menu. Its default remains false; view shortcuts and returning from preview keep the existing behavior.

EditorViewControls.toolsControl replaces the fallback menu with a host-owned tools control. Hosts retain its accessible trigger, menu state and actions; view buttons and keyboard shortcuts keep their existing behavior. Creator uses this slot for its complete editor tools menu beside Add, Layers and Preview.

EditorViewControls.responsiveLabels displays text beside focus and preview icons above 720px, reserving space for both focus labels. At phone widths the labels are hidden while accessible names and tooltips remain. EditorSaveButton.showStatusLabel displays saved/saving status or a retry action when state is provided; it reserves label space across states. Both options default to false.

ResizablePanels.middlePanelProps forwards section attributes such as inert to the middle panel, matching the existing side-panel attribute slots. An editor can keep its canvas mounted while preventing keyboard and pointer interaction when a compact conversation view covers it. Hosts still control panel visibility and restore focus when switching views; the prop does not unmount content.

ProjectSwitcher.currentWorkspaceId optionally marks the parent workspace independently of currentProjectId; only the current location receives the selected surface. IDs must match the supplied projects items. onActionSelect(action, event) lets the host guard shortcut navigation after the menu closes; omitted callbacks retain normal link behavior. Creation shortcuts use ordinary menu surfaces. Optional SiteHeaderCopy.projectSwitcherCreate and projectSwitcherWebsites label creation and the current workspace's website group without renaming the Creator product.

AccountDropdown.usageSummary is an optional slot below the account identity for host-supplied credit balances, plan usage and links to details. It also accepts ({ environmentInfo }) => ReactNode to place the shared ID disclosure and copy controls in the summary without duplicating them below. Links use role="menuitem" and retain menu keyboard behavior and navigation guards. The platform header shows credits and plan usage in two columns, with ID details expanding below; the sidebar account retains appearance and language. Failed reads never appear as zero, and reopening the menu refreshes the data.

PublicPlatformHeader.workspaceAction optionally supplies { href, label } for an authenticated visitor's return link. It replaces the desktop login icon and stays visible beside the mobile menu; the mobile menu then omits anonymous account actions. Session detection belongs to the host. The platform home uses a lightweight local session check, updates after focus/storage changes, and keeps ?view=public on its brand link so explicit website visits survive refresh.

contextAfter places editor-specific scope controls after the host project picker, preserving their DOM and keyboard order. The host retains project navigation and leave guards; the editor owns page and content-language selection. Hosts may adapt the responsive layout to put this context on its own row.

WorkspaceNavigationMenu.footerLinks supplies direct icon links alongside the sidebar display control. footerMenus accepts ordered WorkspaceNavigationFooterMenu entries, each with a label, icon and link items (with optional separatorBefore). The platform uses one menu for Website Home, Pricing, Templates and News, and a book-icon Help & Support menu for the user manual and contact support. The single footerMenu prop remains supported when footerMenus is omitted. Desktop menus open upward with ActionMenu placement="top" portal; mobile uses bottom sheets. The controls form one row when expanded and a column in icon mode; on mobile the sidebar control closes the navigation drawer. Each icon retains an accessible name and tooltip. profile adds the user name, plan and account menu without duplicating an existing sidebar account. Omitting footer links and menus retains the existing preferences and fullscreen actions.

Set a footer menu item's newTab to open a reference destination with target="_blank" and rel="noopener noreferrer". The skeleton adds a trailing arrow and localized screen-reader notice; other items keep current-page navigation. Website Home, Pricing, Templates, News, the manual and contact support use new tabs so the workspace stays open. An explicit public-home visit preserves ?view=public to bypass the signed-in landing redirect, including after refresh.

Editor tool palettes can use Dialog with keepMounted to preserve search and form state while closed. Closed dialogs immediately become inert, hidden from assistive technology, and leave the focus stack, including during a visual exit transition; the default still unmounts their content. Pair nonmodal palettes with DialogPanel to reuse the global overlay surface. Toolbar accepts a DOM ref for bounded positioning while retaining its shared arrow-key navigation.

useFloatingSurface from @qokit/components/patterns/FloatingTools supports defaultHeight: 'auto' for content-sized palettes. Keep the host body shrinkable with internal scrolling; the hook caps the surface to its workspace bounds and observes size changes. Moving an automatic palette stores its position without freezing the measured height. Resizing explicitly stores a fixed height, including across reloads; reset() or Home on a movement/resize handle restores automatic sizing. Numeric defaultHeight retains the existing fixed-height behavior.

FloatingToolPanel composes the shared DialogPanel, TreeToggle, pin button, tooltip and close button. Place it inside a nonmodal Dialog; the host controls pinned, collapsed, their callbacks and document operations. Pinning keeps the palette open after an operation; it does not lock its position. The title and header whitespace accept useFloatingSurface().dragHandle, while buttons, menus and inputs never initiate dragging or folding. Double-click the title or whitespace to fold; the explicit fold button supports keyboard and touch. Folding hides the body without unmounting it, preserving searches and tree state. Pass the same collapsed value to useFloatingSurface to retain the expanded height while moving the folded header. Optional actions and skin slots reuse the same structure; styles stay in the shared stylesheet.

Optional FloatingToolPanel.viewKey adds a short opacity transition when the active tool changes, without replacing its body instance. Ordinary parameter updates do not animate. Opening, closing, unfolding and pin feedback share the existing motion Tokens and respect reduced motion. Dragging stays direct; useFloatingSurface coalesces pointer movement to one geometry update per animation frame and saves the final position on release. Browsers without discrete display transitions close immediately.

Unified editors pass focus={false} to omit the separate Focus control. primaryActions accepts shared tool buttons before Preview; onTogglePanels handles T, and onToggleAllPanels handles Shift+T. Creator uses T to cycle from visible panels to floating launchers to fully hidden and back to the last visible layout; ordinary launcher clicks still open their panel. Shift+T directly hides everything and restores the exact preceding state. Both sidebar shortcuts are inactive in Preview and respect editable targets and active overlays. Existing hosts keep Edit/Focus behavior by default.

useWorkspacePanelVisibility().togglePanels hides the visible editor panels or restores their preceding layout. Desktop and compact layouts are remembered independently, and forceCollapsed (for example during Preview) does not overwrite that memory. The host owns global navigation visibility and any edge launchers.

For floating editor panels, pass skin: platformWorkspacePanelRevealSkin from @qokit/components/skins/platform and spread the returned panelProps onto the existing panel. The skin applies only while revealed; the docked panel and its mounted content remain intact. ResizablePanels merges startPanelProps, middlePanelProps, and endPanelProps class names with its own skin slots. Pair focus controls with Toolbar and platformFloatingToolbarSkin for shared keyboard navigation and compact spacing. Both skins share the global DialogPanel surface (background, shadow and blur); panel corners use the card radius and toolbar corners use the control radius. Hosts own positioning and available space, not a separate overlay palette.

useWorkspacePanelEdgeDrag is an opt-in hook for an existing workspace root ref. Mark its focusable borders with data-workspace-panel-edge="start" or "end"; ResizablePanels supplies these attributes on its own separators. The host provides each side's mode (expanded, icons, hidden), saved width and bounds through getState, applies onChange, and returns a rollback callback from onBegin. onResizing should suspend layout transitions; onFinish restores focus to the resulting control, and onReset restores the host's default width. One captured mouse or touch gesture crosses all three states, with RTL direction handling and cancellation on Escape, pointer cancellation or window changes. Arrow keys resize or step states, Shift increases the step, Home/double-click resets, and End expands to the allowed maximum. This hook adds no visual controls or stored content. Hosts can pair hidden borders with useWorkspacePanelReveal for temporary shortcut access while retaining their normal click actions; hosts without the hook keep existing resizer behavior.

FloatingAssistant.headerActionsTarget optionally accepts an HTMLElement in the host heading. The assistant portals its existing conversation history and new-conversation controls into that element and omits its internal header. Without a target, the original header remains. The host owns the heading and placement; the assistant retains action handlers, accessibility labels and conversation state. The Web adapter forwards this slot.

FeatureHint is exported from @qokit/components/patterns/FeatureHint. Use it for contextual first-use guidance attached to a real control. Provide a versioned id, a stable user scopeKey, an anchor: HTMLElement, an active eligibility signal, localized title, description, dismissLabel, and action: { label, onClick }. Set completed when the user discovers the capability independently. A null scope or unavailable anchor suppresses the hint.

The shared component allows one hint at a time, waits briefly for a visible target, follows scrolling and resizing, supports RTL, and keeps content inside the viewport. It does not add a backdrop, steal focus, or perform the action automatically. Escape, the close button, or clicking elsewhere dismisses it; Tab from the target reaches the action. The target receives a temporary highlight and accessible description. Seen hints are remembered in the current browser per scope and version, with an in-memory fallback if storage is unavailable; this is not cross-device progress. Hosts own permissions, review-state suppression and the actual action. skin, className and style adapt presentation.

AssistantContextCard is exported from @qokit/components/patterns/FloatingAssistant. Place it in composerContext to summarize the current editing target. Its typed contract includes title, description, scope, preview, parameters: { id, label, value }[], optional controls, status and notice, plus actions, onLocate and clearAction. Pass localized labels and formatted values, including units, from the host.

The card renders a read-only definition list, an optional controls slot for a few common adjustments, and a live status region. Reuse the host’s existing editing controls and commands in this slot; keep complete settings behind an explicit action that opens the existing inspector. Hosts retain ownership of selection, permissions, save, undo and AI requests. Conversation, canvas editing and inspector editing can operate together, with independent panel visibility. Selecting an object updates the card and an already open inspector without opening a closed panel or moving focus. Removing a conversation reference preserves canvas selection and direct editing; keep the conversation entry independent of this card and of floating-tool visibility. Changing the target or a parameter updates this live card without appending chat messages. Both draft and project conversations can use the same component. className, style and AssistantContextCardSkin support visual adaptation; styles are loaded with the component.

FloatingAssistantPanel.composerContext 接收输入框上方的实时上下文区域。提供此插槽时,顶部旧的 activeContext 摘要隐藏,activeContext.promptPlaceholder 仍供输入框使用。实时参数属于当前编辑状态,不应追加到历史消息列表;Web 适配器透传此插槽。

Hosts can set hoverReveal={false} to disable navigation previews from the trigger and window edge while retaining explicit controls and drag resizing; the default remains true.

WorkspaceNavigationDock prefetches same-origin destinations on mouse hover or keyboard focus, with bounded deduplication.

ตัวปรับต่อ Web ส่งต่อ FloatingAssistantPanel.composerAttachments ด้วย สล็อตนี้แสดงสิ่งที่แนบซึ่งโฮสต์จัดการภายในแบบฟอร์มข้อความก่อนช่องข้อความ โฮสต์ควบคุมตำแหน่งและการส่ง: การวางเพียงเตรียมสิ่งที่แนบ เมื่อสำเร็จให้ลบเฉพาะสิ่งที่ส่งแล้ว และเมื่อผิดพลาดให้เก็บไว้เพื่อลองใหม่

ส่วนประกอบการสนทนาร่วม (เอกสารภาษาอังกฤษ รอแปล)

@qokit/components/patterns/Conversation exports ConversationPanel, ConversationMessages, ConversationMessage, ConversationSuggestions and ConversationComposer. Creator generation, draft refinement and the embedded project assistant use these structures and the same token-based stylesheet. Hosts own requests, history, permissions, selected objects and review/apply actions.

ConversationFeedback ใช้ InlineNotice เพื่อแสดงสถานะงาน ความล้มเหลว วิธีสำรอง และการยืนยันการบันทึกอย่างกระชับในบทสนทนา ระบุ title ที่แปลแล้ว และเพิ่ม description, tone กับ action ตามต้องการ ทั้งสองบรรทัดใช้ขนาดตัวอักษรคำบรรยาย ระยะห่างแคบ และพื้นผิวโปร่งใส โดยโทนสีเน้นสถานะและข้อความสนับสนุนใช้สีอ่อน ค่าเริ่มต้น role="status" และ aria-atomic="true" ทำให้อ่านการอัปเดตทั้งหมดพร้อมกัน ใช้ role="alert" สำหรับความล้มเหลวที่ต้องดำเนินการ ข้อความที่ผู้ช่วยเขียนยังคงอยู่ใน ConversationText

Place the scrollable ConversationMessages and the fixed ConversationComposer directly inside the panel. Supply a localized label for the messages region and inputProps for the controlled textarea. The composer accepts attachments, notice and actions slots, plus formProps and formRef; it creates the form, so do not nest it in another form. Enter inserts a newline; Cmd/Ctrl+Enter requests submission with composition and disabled/busy guards. Preserve user input while a request is running when the host supports it.

PromptPanel.presentation="conversation" reuses the composer while retaining reference reading, upload/menu controls and serialized form fields. The default "prompt" preserves the landing-page prompt behavior. FloatingAssistant.presentation="embedded" uses the shared panel, messages, suggestions and composer; floating assistants retain their compact presentation.

เอกสาร API เพิ่มเติม (ภาษาอังกฤษ รอการแปล) · 2026-10

2026-10-10 · Pagination dot display

Pagination from @qokit/components/ui accepts pageDisplay="dots" for compact visual choosers. Combine it with layout="centered" for centered arrows and 6px indicators with 32px-wide click targets. Dot colors, hover and keyboard focus use shared theme Tokens; PaginationSkin.dot adapts the indicator slot. Hosts supply currentPage, totalPages, onPageChange and localized navigation labels. pageLabel names each dot; its fallback combines ariaLabel with the page and total. Browsing pages only invokes the host callback. The default "numbers" display retains numeric pagination and formatPageNumber.

2026-10-10 · ActionMenu search header

ActionMenu.dropdownHeader accepts host-owned content before the actions in both dropdown and mobile sheet presentations. onOpenChange reports opening and dismissal so hosts can reset transient search state. Search hosts supply localized copy, filtering and initial input focus; ArrowDown from the input should focus the first enabled result, then the shared menu handles result navigation, selection and Escape.

2026-10-09 · Inline ColorPicker

ColorPicker from @qokit/components/ui/ColorPicker accepts presentation="inline" to expand its editor beneath the field trigger. It renders a named group in the document flow, keeps the surrounding workspace available, and retains palette, HEX, opacity, gradient and reset capabilities. Hosts should reserve a full row for the field. Changes to the controlled value, including undo and reset, update the open inline editor; leaving the field finishes the current edit. The default "popover" presentation retains its portal, outside-click dismissal and Escape behavior.

2026-10-07 · WorkspacePanelGrid

WorkspacePanelGrid from @qokit/components/patterns/WorkspaceLayout places independent detail panels below the shortest available column. It responds to content and container size changes without moving or remounting child nodes; DOM and keyboard order remain unchanged. Narrow containers use one column. Keep continuous panels in one grid rather than separate rows. Metrics, tables, paired fields and ordered workflows retain their own layouts.

Each direct child is a panel. Use data-workspace-panel-span="full" or a numeric column span on that child's root for wider panels. The optional skin has a root slot and variables; --qk-workspace-panel-grid-gap controls shared spacing, and --qk-workspace-panel-grid-max-columns defaults to 2. Without JavaScript or ResizeObserver, panels retain the responsive ordinary grid.

2026-10-08 · Shared list toolbar groups

WorkspaceFilterToolbar now has one container-responsive contract across Projects, CMS and Admin:

  • query: search, filters สถานะ, sort, controls ของงาน, ตัวเลือก advanced, reset ตามเงื่อนไข, result ของทรัพยากร และ summary เสริม
  • presentation: view, แสดง controls และ options เช่น คอลัมน์ที่มองเห็นและขนาดหน้า การปรับแต่งวิดเจ็ตของหน้าควรอยู่ในส่วนการกระทำของส่วนหัวของหน้า
  • actions: persistent operations, followed by the optional selection control at the logical end. Use ToolbarButtons with icon and localized compactLabel for refresh and other familiar actions.

The shared component measures its own available width. Controls show icons with labels above 960px and accessible icon buttons at or below 960px. At or below 640px, search occupies the first row and tool groups wrap in query → presentation → actions order. Routes must not override group widths or hide individual labels. ControlMenu and ViewMenu inherit this presentation without a route-specific responsive flag.

ใช้ query.result={{ label, count, total?, locale? }} สำหรับชื่อทรัพยากรและจำนวนผลลัพธ์ WorkspaceResultSummary แสดง “ชื่อ · จำนวน” และเพิ่ม “/ ทั้งหมด” เมื่อยอดรวมก่อนกรองที่เชื่อถือได้แตกต่างกันเท่านั้น ตัวเลขใช้รูปแบบตามภาษา UI และแยกทิศทางในข้อความสองทิศทาง ละ result ไว้จนกว่าจะทราบจำนวน โดยศูนย์เป็นค่าที่ถูกต้อง ไม่เพิ่มแถวชื่อและจำนวนซ้ำเหนือรายการเดียวกัน AdminFilterBar.result รับออบเจ็กต์เดียวกัน หัวข้อหน้า หัวข้อส่วนที่มีความหมาย การแบ่งหน้า และจำนวนที่เลือกยังคงบทบาทเดิม ใช้ query.summary สำหรับหน่วยอื่น บริบทคำค้น หรือความใหม่ของข้อมูล

Give overflow a localized label to move advanced and display options into More when compact. query.compactItems and presentation.compactItems supply complete menu choices replacing their corresponding controls; controlled values and callbacks remain in the host. Permanent menu actions use overflow.items. Selection and refresh stay outside More. Select and Done share the end slot, hit target and reserved idle toolbar height, including wrapped mobile rows.

This replaces the old flat toolbar API: migrate search, filters, sort, reset and secondaryControls into query; migrate view and display controls into presentation; move persistent endActions to actions. The former adaptive / inline-wrap CSS modes and WorkspaceFilterControlGroup capsule are removed; use these three semantic groups rather than compatibility aliases.

2026-10-10 · EditorItemDisclosure

EditorItemDisclosure from @qokit/components/patterns/EditorItemCollection accepts title, summary, open, onOpenChange, leading, actions and children for editing within a list. Sibling items remain visible. Escape collapses the item and restores trigger focus; opening does not scroll or autofocus. useEditorItemDisclosure scopes single-item expansion with scopeKey and restores adjacent focus after deletion. EditorItemCollection uses the same interaction; hosts still own content, ordering, persistence and undo. The existing EditorFocusedItem export remains available for flows that require a separate detail view.

ข้อมูลอ้างอิง API เพิ่มเติม (ภาษาอังกฤษ รอการแปล) · 2026-10

2026-10-15 · Shared inspector choices

EditorStyleChoice uses the shared EditorChoiceControl for finite settings. In auto mode, two or three illustrated options use a segmented group; larger illustrated sets use a portalled ControlMenu showing the current icon and name. Text-only choices retain a native Select. Existing custom values remain selectable.

ตัวเลือกและรายการเมนูรองรับ annotation เพื่อเพิ่มจุดสีตามธีมและใส่ความหมายที่แปลแล้วในชื่อสำหรับการเข้าถึง ตัวเรียกของ ControlMenu แสดงจุดของตัวเลือกปัจจุบันด้วย ส่วน triggerAnnotation: null จะแสดงจุดเฉพาะในเมนู การเลือกตัวเลือกเดิมที่เปิดใช้งานอยู่จะเรียก onReselect ตัวเลือกแบบเนทีฟแสดงคำอธิบายข้างป้ายชื่อ และ hidden จะซ่อนตัวแทนข้อความจากรายการ โฮสต์เป็นผู้กำหนดค่าที่ทำเครื่องหมายและผลของการเลือก ส่วนควบคุมร่วมจะไม่อนุมานการสืบทอดหรือเขียนข้อมูล

Use presentation="visual" for labeled diagram choices and presentation="toolbar" for familiar tools such as four-way text alignment. The toolbar has separate targets without a shared capsule. Native radios, shared menu keyboard handling, visible focus, disabled states and theme Tokens are retained. Hosts own labels, allowed values, persistence and undo. id identifies the control; ControlMenu also accepts triggerId and disabled.

Inspector menus, inputs, collapsed summaries and reset actions share a 32px mouse field height, restored to 40px on narrow screens and coarse pointers. Field icons use 16px and diagram choices keep an 8px gap. EditorComponentSettings reuses these choices for columns, density, image fit and aspect ratio, while composition layouts retain detailed previews. If saving briefly disables native radios, the shared skeleton restores focus to the selected option for continuous arrow-key editing.

Inspector labels and diagram captions use the 12px caption scale; values, actions and section titles use the 13px field scale. Visual choices have no decorative outer border: a soft selected surface and centered caption identify the current option, while keyboard focus retains its ring. Font specimens in the inspector use a compact, bounded scale.

2026-10-15 · Responsive workspace tables

WorkspaceDataTable reflows mobileLayout="records" into two columns of labeled facts, with the primary identity and sticky end actions spanning the record. Names and identifiers can use two lines. Column labels and selection remain accessible. Comparison tables using mobileLayout="scroll" retain their columns.

When a host toolbar already provides sorting or other header actions, set mobileHeader="labels" to remove duplicate header controls from the mobile layout and tab order. Column names remain available to assistive technology; desktop headers are unchanged. The default "controls" preserves custom header controls on mobile.

2026-10-14 · Independent editor panels

resolveWorkspaceResponsiveProfile and useWorkspaceResponsiveProfile from WorkspacePanels, and EditorWorkbenchChrome, accept the optional panelPolicy="independent". With BuilderWorkbenchFrame and the platform editor skin, both panels remain docked above the mobile threshold. Shared styles temporarily compress displayed widths while retaining remembered sizes, and the canvas fits the remaining space. Effective work areas at or below 720px retain mobile task switching.

Hosts own panel visibility. When supplying a measured profile, use the same policy for the measurement hook and Chrome. Omitting panelPolicy retains the default "adaptive" policy with its existing desktop, two-column and overlay layouts.

Editor workspace integration

workspaceNavigation connects the host's shared business navigation through EditorWorkbenchChrome: desktop navigation reserves space beside the content, while mobile uses the shared drawer. It is separate from the document structure panel navigation and retains the host's permissions and unsaved-change protection.

EditorSaveButton.showIcon keeps the save glyph beside its label. iconOnly reduces the control to an icon while retaining an accessible action and status name and tooltip. Editor hosts can use useCompactWorkspaceHeader() to show icons and labels in roomy layouts and icons alone in compact layouts. EditorStatusAction.iconOnly follows the same rule while retaining its issue count.

2026-10-15 · EditorControlGroup title actions

The headerActions slot on EditorControlGroup remains visible in both expanded and collapsed groups, for actions such as content visibility beside a group title. Pointer and keyboard interactions with these actions do not toggle the group. summaryActions still appears only when collapsed. Hosts own action names, state and persistence; icon actions must use the shared IconButton with a localized accessible name.

2026-10-14 · Management groups and summaries

WorkspaceSectionGroup, WorkspaceSection, WorkspaceFieldGrid and WorkspaceFacts are exported from @qokit/components/patterns/WorkspaceLayout. Headings and descriptions sit above their content panels on both desktop and mobile, sharing the starting edge. Use the default stacked layout; legacy layout="split" callers also render stacked. Apply qk-workspace-section-group__form to forms within a group to share spacing and save-area alignment. WorkspaceSection accepts optional icon, actions and description slots, keeping headings outside the content panel.

WorkspaceFieldGrid arranges independent short fields in at most two columns according to available width. WorkspaceFacts renders a semantic definition list with stable id, label, value, and optional unit, description, emphasis and tone. columns supports 2, 3 or 4 columns and adapts to narrow containers. Set mobileColumns={2} for short numeric summaries that should retain two columns on phones; the default is one. It is unboxed so summaries can share an existing content panel. Each component supports its named Skin, className and style. Hosts retain form state, permissions, submission, conflicts and recovery; these components do not make requests.

2026-10-14 · Management content panels and disclosures

WorkspaceContentPanel and WorkspaceSection.kind support summary, form, records, and actions. Section toolbar stays outside the content surface; supporting and footer provide compact metadata and end operations. titleId preserves existing heading anchors. The default panel container does not override a host's named container.

Use WorkspacePanelBlock, WorkspacePanelMeta, and WorkspaceRecordRow for subordinate groups, metadata, and repeated records. A record accepts title, description, meta, status, actions, and full-width detail children. Facts always align at the top. Hosts retain business fields, permissions, table columns, and submission boundaries.

WorkspaceActionRow accepts an optional action label or quiet empty/loading status, alongside description and actions. Action identity uses 14px semibold text, status uses 14px regular text, and descriptions use 12px. Copy and controls share a center line on desktop and stack at narrow widths. Card surfaces do not override descendant strong typography or spacing.

WorkspaceDisclosure accepts title, optional status, and children; WorkspaceDisclosureGroup accepts Accordion items and controlled expansion props. They start closed unless the host specifies an initial item, and open at most one sibling. Enter/Space toggles; Escape closes and returns focus to its trigger, handling inner disclosures before their parent. Hidden panels retain their DOM and input state. Optional headingLevel supplies section heading semantics; Skin and class slots only adapt appearance. Import these components from @qokit/components/patterns/WorkspaceLayout.

CustomizableWidgetLayoutControls / CustomizableWidgetLibrary

วาง CustomizableWidgetLayoutControls ในส่วนการกระทำของหัวหน้าที่หน้า หลังจากความช่วยเหลือตามบริบทและก่อนการกระทำหลัก รวมถึงบนมือถือ ใช้ copy.customize ที่แปลเป็นภาษาท้องถิ่นเพื่อตั้งชื่อการกระทำอย่างชัดเจน (เช่น “ปรับแต่งวิดเจ็ต”) รายการที่มีเพียงไอคอนเดียวกันนี้จะเปิดใช้งาน aria-pressed และ aria-expanded และจะกลายเป็น copy.done ขณะแก้ไข customizeButtonRef เปิดใช้งานตัวกระตุ้นสำหรับการคืนโฟกัสไปยังโฮสต์แบบไม่บังคับ; disabledCustomize ปิดการใช้งานรายการโดยไม่เปลี่ยนเรขาคณิตของมัน จัดเตรียม onCollapseToggle และ areWidgetsCollapsed เฉพาะสำหรับโฮสต์ที่รองรับการยุบวิดเจ็ตเท่านั้น; การละเว้นจะทำให้รายการปรับแต่งปรากฏอยู่คนเดียว

CustomizableWidgetLibrary เป็นเจ้าของหัวข้อไลบรารีร่วม การกระทำรีเซ็ต/ปิด การจัดเลย์เอาต์เลื่อนแบบตอบสนอง การตั้งค่าโฟกัสเริ่มต้นของปุ่มปิด และการจัดการ Escape การปิดจะคืนโฟกัสกลับยังควบคุมที่เรียกใช้เมื่อโฟกัสยังคงอยู่ในไลบรารี; คลิกภายนอกจะคงไว้ซึ่งโฟกัสเป้าหมาย โฮสต์เก็บคำจำกัดความของวิดเจ็ต คำสั่งเพิ่ม/ลบ/จัดลำดับ/ปรับขนาด ความคงทน และเซมิติกส์ของการรีเซ็ต ช่องคลาส CMS และ Admin ยังคงพร้อมใช้งานสำหรับฮุคโดเมน แต่ต้องไม่กำหนดพื้นผิวไลบรารีหรือเลย์เอาต์มือถือแยกต่างหาก

2026-10-17 · การกระตุ้น ActionMenu แบบ Rich

ActionMenu.renderTrigger สามารถนำคอนโทรลแบบ rich เช่น SelectableTile มาใช้ซ้ำได้ โดยรับค่า aria-expanded, aria-haspopup, disabled และ onClick; แล้วกระจายค่าเหล่านี้ไปยังตัวกระตุ้นจริง (trigger) โฮสต์จะคงไว้ซึ่งความหมายในการเลือกและลักษณะการแสดงผลของคอนโทรลนั้น การจัดตำแหน่งแบบ Portal, การนำทางเมนูด้วยคีย์บอร์ด, การปิดเมนู, การคืนโฟกัส และ sheet บนมือถือแบบไม่บังคับ ยังคงเป็นหน้าที่ของ ActionMenu อยู่ ตัวกระตุ้นแบบปุ่มและไอคอนเริ่มต้นยังคงเหมือนเดิม

ตัวควบคุมรัศมีและช่วงค่า

RangeNumber จาก @qokit/components/ui/RangeNumber จับคู่แถบเลื่อนช่วงค่าแบบเนทีฟกับ Input ตัวเลขที่แม่นยำ ระบุ label, value, min, max, ตัวเลือก step และ unit รวมถึง onChange ค่าที่ไม่ได้กำหนดจะแสดงขีดแทนค่าผสม การเปลี่ยนช่องใดช่องหนึ่งจะกำหนดตัวเลขเดียวภายในขอบเขต onCommit ช่วยให้แอปจัดกลุ่มการเปลี่ยนแปลงต่อเนื่องในประวัติการเลิกทำเดิม โดยใช้ disabled การนำทางด้วยแป้นพิมพ์ ความหนาแน่นแบบกะทัดรัด RTL และรูปแบบโฟกัสร่วมกัน ส่วนการบันทึกถาวรเป็นหน้าที่ของแอป RangeNumberSkin มีสล็อตราก แถบเลื่อน ช่องป้อน และหน่วย

EditorRadiusControl จาก @qokit/components/patterns/EditorRadiusControl รวมตัวอย่างรูปร่างแบบสด ช่องป้อนมุมจริงทั้งสี่ RangeNumber และค่ารูปร่างสำเร็จรูปที่เลือกใช้ได้ value และ onChange ใช้รูปย่อ CSS border-radius โดยแอปแปล cornerLabels และชื่อค่าที่ตั้งไว้ แม้เป็น RTL ลำดับยังคงเป็นซ้ายบน ขวาบน ขวาล่าง ซ้ายล่าง การกำหนด max จำกัดการแก้ไขเป็นค่าพิกเซลภายในขอบเขต หากไม่กำหนดจะคงหน่วย CSS และไวยากรณ์มุมวงรีไว้ รัศมีผสมจะไม่แสดงตัวเลขเดียวจนกว่าจะตั้งค่าทั้งสี่มุมพร้อมกัน EditorRadiusControlSkin ที่เลือกใช้ได้ปรับสล็อตราก แผนภาพ ตัวอย่าง และค่าที่ตั้งไว้โดยไม่เปลี่ยนสถานะหรือการบันทึก

2026-10-22 · แท็บนำทางที่ทำงานอยู่บนหน้าจอแคบ

PillTabs รองรับตัวเลือก scrollActiveTabIntoView โดยมีค่าเริ่มต้นเป็น false สำหรับแท็บแนวนอน จะเลื่อนลูกโดยตรงที่ทำงานอยู่คือ PillTabLink หรือ PillTabButton ให้มองเห็นเมื่อเลือกหรือปรับขนาด เฉพาะแถบแท็บเท่านั้นที่เลื่อน ตำแหน่งหน้าและโฟกัสแป้นพิมพ์ไม่เปลี่ยน รองรับ LTR และ RTL พร้อมปรับทันที รวมถึงเมื่อเปิดการลดการเคลื่อนไหว แท็บแนวตั้งและการเรียกที่ไม่ระบุตัวเลือกยังคงทำงานเหมือนเดิม

ในหน้านี้

การเชื่อมต่อ Component2026-10-20 · การทำงานอิสระในการ์ดตัวเลือกแบบภาพ2026-10-17 · การเคลื่อนไหวของแผงโต๊ะทำงานร่วมกัน2026-10-17 · ค่าเริ่มต้นของ editor ที่วัดแล้ว2026-09-30 · การเข้าถึงของ SelectionToolbar2026-09-10 · ป้ายระบุตัวตนของพื้นที่ทำงาน2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · การนำทางร่วมและพื้นผิวโค้งมนของ Qokit2026-09-07 - ColumnLayoutจุดนำเข้าขอบเขตหน้าที่สาธารณะสร้างเนื้อหาองค์ประกอบฟอร์มคอนโทรลการเลือกจากรายการการ์ดเมตริกเอกสาร API เพิ่มเติม (ภาษาอังกฤษ รอการแปล) · 2026-10Header และ Footer ของแพลตฟอร์มกลยุทธ์ความเข้ากันได้การแก้ไขแบบเต็มหน้าจอSidebarToggleSlotEditorHeaderEditorNavigationMenuWorkspaceNavigationMenu / WorkspacePageHeaderEditorViewControlsLanguage / AppearancerequestWorkspaceNavigationWorkspacePanelRevealEditorViewControls / โหมดแสดงผลPlatformHeader.workspaceNavigation2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMSส่วนท้ายที่เรนเดอร์บนเซิร์ฟเวอร์ · 2026-09-07EditorHeader.titleControl / FloatingAssistant.presentation2026-09-07 · WorkspaceAssembly2026-09 · พื้นที่จัดการ2026-09-08 · Task focusเอกสาร API เพิ่มเติม (ภาษาอังกฤษ รอการแปล)ส่วนประกอบการสนทนาร่วม (เอกสารภาษาอังกฤษ รอแปล)เอกสาร API เพิ่มเติม (ภาษาอังกฤษ รอการแปล) · 2026-102026-10-10 · Pagination dot display2026-10-10 · ActionMenu search header2026-10-09 · Inline ColorPicker2026-10-07 · WorkspacePanelGrid2026-10-08 · Shared list toolbar groups2026-10-10 · EditorItemDisclosureข้อมูลอ้างอิง API เพิ่มเติม (ภาษาอังกฤษ รอการแปล) · 2026-102026-10-15 · Shared inspector choices2026-10-15 · Responsive workspace tables2026-10-14 · Independent editor panelsEditor workspace integration2026-10-15 · EditorControlGroup title actions2026-10-14 · Management groups and summaries2026-10-14 · Management content panels and disclosuresCustomizableWidgetLayoutControls / CustomizableWidgetLibrary2026-10-17 · การกระตุ้น ActionMenu แบบ Richตัวควบคุมรัศมีและช่วงค่า2026-10-22 · แท็บนำทางที่ทำงานอยู่บนหน้าจอแคบ