Skip to Content
Tasarım

Bileşen Entegrasyonu

Qokit'in ortak bileşenler, Pattern'ler, Skin'ler ve stil Token'ları için açık entegrasyon sözleşmesi.

Bileşen Entegrasyonu

Qokit, "ortak iskelet + Skin tarifi" modelini kullanır. Harici entegre eden taraf, bileşenin semantik ve etkileşim sözleşmesine güvenir; görsel uyarlamayı Skin ve Token'lar aracılığıyla tamamlar.

2026-10-20 · Görsel seçim kartlarında bağımsız işlemler

EditorVisualChoiceGroup seçenekleri, bağımsız kart menüleri veya ad düzenleyicileri için isteğe bağlı accessory kabul eder. Paylaşılan RadioGroup bunu yerel etiketin yanına yerleştirir; kart yönetimi radyo seçimini etkinleştirmez. afterOptions, seçeneklerden sonra kart oluşturma gibi ayrı bir katalog işlemi ekler. Kalıcılık, izinler, doğrulama ve kart değiştirilip kaldırıldıktan sonraki odak ana uygulamaya aittir. Ek içeriği olmayan seçenekler mevcut yapı ve davranışlarını korur.

2026-10-17 · Paylaşılan çalışma masası panel hareketi

EditorWorkbenchChrome, Creator ve içerik düzenlemesinde kullanılan aynı panel iskeleti olan BuilderWorkbenchFrame aracılığıyla enjekte edilen başlangıç/sonuç şeritlerini render eder. Ev sahipleri içerik, görünürlük ve genişlik tercihlerini sağlar. Masaüstü, izlemeyi ve panel opaklığı/çevirmesini --qk-sidebar-motion-duration ve --qk-sidebar-motion-easing ile paylaşır; sürükleme geçişleri devre dışı bırakır ve azaltılmış hareket hemen geçerli olur.

Daraltılmış paneller taslakları korumak için monte edilmiş halde kalır. Paylaşılan çerçeve, inert ve aria-hidden'i hemen uygularken platform teması, görünürlüğü gizlemeden önce çıkışı tamamlar. Kompakt paneller, çıkış boyunca örtüşme geometrisini korur; ev sahipleri panel kabuğuna hidden veya display: none eklememelidir. Açık ara (peek) paneller mevcut etkileşimli açığa çıkarma davranışlarını korur. Üst bilgi seçenekleri açık/kapalı durumlar boyunca kullanılabilir kalır; telefon hedeflerinin bir menüyü paylaşması gerektiğinde EditorPanelChoiceShortcuts.mobileMenu kullanın.

2026-10-17 · Ölçülü editör varsayılanları

useWorkspaceResponsiveProfile, satır içi dolgular çıkarıldıktan sonra duyarlı profiller için kullanılan aynı kullanılabilir çalışma alanı genişliğini bildiren isteğe bağlı onWidthChange(width) kabul eder. Başka bir gözlemci eklemeden orantılı varsayılanlar türetmek için kararlı bir geri arama kullanın. useEditorLayout, sharedWidths.limits'i hem ev sahibi tercihlerine hem de paylaşılan genişlik depolamasına uygular; readEditorLayout, isteğe bağlı dördüncü bağımsız değişkeni olarak aynı sınırları kabul eder. Mevcut çağrılar varsayılan sınırlarını ve davranışlarını korur.

2026-09-30 · SelectionToolbar erişilebilirliği

SelectionToolbar.ariaLabel, araç çubuğunu isteğe bağlı olarak bir bölge şeklinde adlandırır. Sayım, canlı durum mesajı olarak kalır. Ana uygulama yerelleştirilmiş etiketler sağlar ve ortak EditorToolGroup ile ActionMenu bileşenlerini birleştirmek için actionContent kullanabilir; izin kontrolleri ve eylem işleyicileri ana uygulamada kalır.

2026-09-10 · Çalışma alanı kimlik rozetleri

ProjectSwitcherProject.badge, isteğe bağlı ve etkileşimsiz React içeriği kabul eder. Rozet her öğe adının, listelenmemiş geçerli bağlam satırının ve metin tetikleyicisindeki geçerli adın yanında gösterilir. Yalnızca simgeli tetikleyiciler kompakt kalır; platform metin tetikleyicileri telefon genişliğinde çalışma alanı adına yer bırakmak için rozeti gizler. Açık menü rozeti göstermeye devam eder. Ana uygulama doğru kapsamlı verileri, yerelleştirilmiş etiketleri ve sunum stillerini sağlar; alanın atlanması mevcut görünümü korur.

2026-09-08 · EmptyState

EmptyState, isteğe bağlı dekoratif icon, title, isteğe bağlı description ve action öğelerini saydam yüzeyde ortalar. layout="section" kompakt varsayılandır; layout="workspace" daha fazla alan ayırır. Eylemleri doğrudan action içine, birden çok düğmeyi fragment içine yerleştirin; kapsayıcı aralıkları ve uzun etiketleri yönetir. Başlık h2 öğesidir; strong yerine title skin yuvasını kullanın. Mevcut kök sınıflar korunur; skin.vars ve style desteklenir. Yerelleştirme, izinler, gezinme ve oluşturma ana uygulamada kalır; arama ve hatalar kendi mesajlarını ve eylemlerini korur.

2026-09-08 · SidebarNavigation

SidebarNavigation, fare 180 ms beklediğinde veya klavye odağı geldiğinde aynı kökenli rotaları önceden yükler. Sabit ve açılır gezinme, 30 saniyede 8 hedef sınırını paylaşır. Çevrimdışı, gizli sekmelerde, Save-Data veya 2G ile ön yükleme durur; indirmeler, devre dışı bağlantılar, yeni pencereler ve aynı sayfa bağlantıları hariçtir. Gezinme ve kaydedilmemiş değişiklik koruması korunur.

2026-09-07 - AccountDropdown / SidebarProfile

AccountDropdown, isteğe bağlı compact ve preferences özelliklerini kabul eder: kompakt mod kimlikleri ve oluşturma geçmişini gizler; varsayılan davranış mevcut içeriği korur. Appearance ve Language, hesap menüsünde triggerRole="menuitem" kullanabilir. Klavye gezintisi odağı geri getirir; iç içe dil iletişim kutuları Escape tuşunu kendileri işler. SidebarNavigation.searchEnabled varsayılan olarak true değerindedir; kısa ve sabit gezinti için false kullanın. Menü olmadan href içeren SidebarProfile, açık ve simge modlarında aynı hedefi açar.

2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace

Formlar ortak yazı ölçeğiyle uzun metinleri kaydırır; kapsül şekilleri ve marka renkleri korunur. FormField grupları adlandırır: controlId ve iç id etiketi bağlar. SearchField temizledikten sonra odağı geri verir. Segmented ve ControlMenu devre dışı seçenekleri destekler; devre dışı ActionMenu öğeleri bağlantı içermez. Meşgul düğmeler boyut ve göstergeyi korur. AdminEntityDialog zorunlu alan, e-posta ve JSON doğrular, hatalara odaklanır, çift kaydı engeller ve başarısızlıkta girdiyi korur. EditorWorkspace, odaklanmadan önce gizli panelleri açmak için ref.focusControl(element) sunar. Azaltılmış hareket kontrol geçişlerini kapatır. WorkspaceDialog, başlık ve eylemler görünürken uzun içeriği kaydırır; kısa mobil iletişim kutuları içeriğe sığar.

2026-09-07 · WorkspaceLocationSync / ProjectSwitcher

Rota geçişi tamamlandığında WorkspaceLocationSync geçici alan seçiciyi kapatır ve hedefin araçlarını gösterir. Arama ve bölüm tercihleri korunur. Kenar çubuğundaki kapsam adı ve bağlam ayrı satırlarda gösterilir; başlıktaki uzun adlar düğme içinde kısaltılır.

2026-09-07 · Birleşik gezinme ve yuvarlatılmış Qokit yüzeyleri

WorkspaceNavigationDock, items, fallback, className ve onClickCapture ile ana uygulamanın gezinmesini ve izinlerini kullanır; ek oturum yüklemez. Açık, simge ve gizli görünüm tercihi korunur; 860px ve altında çekmece kullanılır. PlatformHeader.leadingContext, EditorHeader içinde de görünür. Kapsül düğmeler ve yuvarlatılmış yüzeyler korunur, yinelenen kenarlıklar kaldırılır.

Masaüstünde menüye tıklamak kenar çubuğunu gizler veya son görünür modunu geri getirir. Menüyü ya da kenar çubuğunun kenarını sürüklemek gizli, yalnızca simgeler ve genişletilmiş modları arasında geçiş yapar. Sol/sağ ok tuşları okuma yönünü izler. Sürüklemeyi iptal etmek kayıtlı tercihi korur; mobilde gezinme çekmecesi kullanılır.

Next düzeninde WorkspaceLocationSync bileşenini Suspense altında bir kez bağlayın. useWorkspaceQueryState(key, defaultValue, validate), [value, setValue, ready] döndürür; useWorkspaceQueryRecord(key, defaults, validators) yalnızca tanımlı düz filtreleri geri yükler. Kimlik bilgilerini veya taslakları URL’ye yazmayın. WorkspacePage sınırlı oturum kaydırma konumlarını geri yükler; iç alanlar data-workspace-scroll-region ve WorkspaceScrollRestoration kullanır. İptal edilebilir yerel geri/ileri gezinme, geçmiş eklemeden çıkış korumasını kullanır. AdminEntityDialog, hata ve yeniden çizim sonrasında girdiyi korur; sürümler ve kayıt sonuçları ana uygulamaya aittir.

Yönetim sabit yazı rolleri kullanır: sayfa başlığı 20px/650, bölüm başlığı 16px/600, metin ve gezinme 14px, etiketler 13px, açıklamalar 12px. --qk-workspace-body-ink ve --qk-workspace-active-ink mevcut renklerden türetilir.

Ana kapsül düğmeler Logo mavisi #4695D8 rengini korur; iki temada da beyaz metin, simge ve yükleme göstergesi kullanır. Üzerine gelindiğinde hafif aydınlatma sürer. İkincil ve tehlikeli işlem düğmeleri anlamlarına uygun renklerini korur.

Açılır menüler ve çalışma alanı seçicileri, 1.45 satır yüksekliğiyle --menu-option-font-size (14px) ve --menu-option-font-weight (500) kullanır; seçili seçenekler 600, yardımcı bilgiler 12px/400 kullanır. WorkspaceNavigationDock, fareyle üzerine gelindiğinde veya klavye odağında aynı kaynaktaki hedefleri sınırlı yinelenme takibiyle önceden yükler. Mevcut ayrılma korumaları ve ana uygulama rotaları korunur.

2026-09-07 - ColumnLayout

ColumnLayout, sabit gezinme, ayrı kaydırma alanı ve üstte kalan sayfa araç çubuğuyla yönetim penceresini doldurur. WorkspacePage düz bölümler ve ortak köşe Tokenları kullanır. 860px ve altında gezinme çekmece olarak kalır; kapalıyken etkileşime girilemez. Özellikler ve iş davranışı değişmez. Yinelenen dış boşlukları kaldırın ve okuma genişliğini form içinde sınırlayın.

İçe Aktarma Giriş Noktaları

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';
Giriş NoktasıKullanım Amacı
@qokit/components/uiButton, Card, Dialog, Menu, Pill gibi temel bileşenler
@qokit/components/patternsHeader, Footer, çalışma alanı, tablo, kaynaklar ve AI asistanı gibi bileşimler
@qokit/components/skins/platformPlatform ve çalışma alanı görsel tarifi
@qokit/components/skins/adminAdmin görsel tarifi
@qokit/components/skins/siteOluşturulan site görsel tarifi

Ortak Sorumluluk Sınırları

PromptPanel, isteğe bağlı referenceReader ve yerelleştirilmiş referenceCopy özelliklerini kabul eder. Okuyucu, asenkron file(File, AbortSignal) ve website(url, AbortSignal) aracılığıyla çıkarılan contentExcerpt ve truncated işaretlemesini döndürür; kimlik doğrulama ve API erişimi ana uygulama tarafından yönetilir. Bileşen okuma, önizleme, yeniden deneme ve kaldırma işlemlerini yönetir; geçerli bir URL'de ipucu metni yoksa referenceCopy.websitePrompt isteği tamamlar, biçim hatası durumunda referenceCopy.errors.url kullanılır ve okuma engellenir. URL henüz okunmadıysa veya okuma devam ediyorsa gönderim en son içeriği bekler ve yalnızca bir kez gönderir; giriş değişikliği veya okuma hatası bekleyen gönderimi iptal eder, yeniden deneme eski gönderimi geri yüklemez. Dosyalar yalnızca hazır olduğunda gönderilebilir. Tam URL yapıştırıldığında, odak kaybında veya Enter'a basıldığında otomatik olarak okunur; başlangıç URL'si de okunur ve devam eden veya tamamlanmış sonuçlar yeniden kullanılır; hata durumunda net bir yeniden deneme sunulur. URL düzenlendiğinde veya kaldırıldığında eski okuma iptal edilir ve sonuçlar temizlenir. Okuyucu sağlanmadığında yerel gönderime devam edilir, asenkron referans işleme yapılmaz.

Referans alımı, Eylül 2026 itibarıyla isteğe bağlı ve geriye dönük uyumlu bir bileşen yeteneği olarak eklenmiştir.

İskelet bileşenleri şunları garanti eder:

  • DOM ve semantik etiketler;
  • ARIA, klavye, odak ve disabled davranışı;
  • Durum ve temel etkileşimler;
  • Sabit varsayılan class;
  • Adlandırılmış Skin yuvaları.

Skin şunları yapabilir:

  • root, header, body, item, action gibi yuvalara class ekleyebilir;
  • CSS değişkenlerini vars aracılığıyla iletebilir;
  • Bileşen tarafından zaten açık hale getirilmiş tone, layer veya görsel uyarlama anahtarlarını kullanabilir.

Skin veri isteyemez, DOM'u değiştiremez, iş kurallarını barındıramaz veya erişilebilirlik davranışlarını atlayamaz.

Oluşturulan Öge İçeriği

Oluşturulan özel bloklar, Schema v2 içinde kayıtlı html-* ögelerini kullanmaya devam eder; yürütülebilir HTML veya yeni blok türleri kullanılmaz. Eylül 2026'dan itibaren @qokit/site-schema, dil içeriği bağlama için bindSiteModuleContent, updateSiteModuleBoundContent ve forkSiteModuleContentBindings sağlar. İçerik yolu modülde saklanır, ziyaretçi metinleri dil içerik eşlemesinde tutulur; güncellemeler geri alma ve kaydetme işlemlerini izler; ögeler kopyalandığında veya blok arasında taşındığında kaynak değiştirilmemesi için bağlam türetilmelidir.

İsteğe bağlı extensionRequirements, çözülmemiş çalışma zamanı gereksinimlerini kaydeder ve kurulum listesi veya izin verisi değildir. createSiteExtensionHandoff, yürütülemez v1 geliştirme isteklerini dışa aktarır; çalıştırılabilir bir site yayımlamadan önce bu gereksinimler çözülmalı veya denetimle açıkça hariç tutulmalıdır.

Form Kontrolleri

Paylaşılan formlar, etiket, açıklama, zorunlu meta veri, hata ve kontrol ID'sini ilişkilendirmek için FormField kullanır. Metin kontrolleri Input kullanır, çok satırlı içerik Textarea kullanır, seçim kontrolleri Checkbox, RadioGroup ve Switch kullanır; mevcut Select ve SearchField aynı boyut ve durum sözleşmesini paylaşır.

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, etiket, açıklama ve hataları benzersiz alt kontrole bağlamak için id, aria-describedby, aria-invalid ve required kullanır. Paylaşılan kontrolleri ekstra bir <label> ile sarmalamayın.

Input, Textarea, Select ve SearchField, sırasıyla 40px, 44px ve 48px'e karşılık gelen sm, md ve lg olmak üzere üç boyutu destekler. Tek satırlı kontroller varsayılan olarak pill şekli kullanır; Textarea her zaman paylaşılan çok satırlı yuvarlak köşeleri kullanır. Tüm etkileşim ve hata durumları paylaşılan Token'lardan gelir.

Geçiş sürecinde eski .qk-field sözleşmesi kullanılabilir; yeni entegrasyonlar paylaşılan bileşenleri ve adlandırılmış Skin yuvalarını kullanmalıdır.

Liste Seçimi

Eylül 2026'dan itibaren listeler useWorkspaceSelectionMode({ enabled, resetKey, onClear }) ile WorkspaceFilterToolbar.selection'yi birlikte kullanabilir. Bu Hook başlangıçta etkin değildir, kapsam veya yetki değişikliğinde sıfırlanır ve seçilen ID'leri temizlemeyi toplu moddan çıkmaktan ayırır; kapsam anahtarı koleksiyon, dil, sayfalama ve filtreleme içermelidir.

Toplu mod yalnızca etkinleştirildiğinde WorkspaceDataTable.selection geçirilmeli; ızgara ve mobil onay kutuları aynı modeli kullanır. Araç çubuğu genel seçim işlemlerinden sorumludur; kullanıcı yerelleştirilmiş metin, isteğe bağlı ID ve yetki kontrolünden geçmiş alan işlemleri sağlar. İsteğe bağlı actionContent ek ARIA anlamı taşıyabilir ancak genel kontrolü veya onayı yerine geçmez. Salt okunur listeler toplu modu göstermez; dosya seçici ve öneri incelemeleri kendi anlamlarını korur.

Bu yeni yetenekler isteğe bağlıdır ve geriye dönük uyumludur; tablo seçimi yine kullanıcı tarafından açıkça kontrol edilir.

Metrik Kartları

Yeni API referansı (İngilizce; çeviri bekleniyor) · 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 varsayılan olarak durağan resim gösterir. motion="breathe" gizliyken boyutunu korur; sayfa yüklenip en az yarısı görünür olduğunda 4,8 saniyelik nefes hareketiyle bir kez belirir. Üstbilgi ve altbilgi ek bekleme uygulamaz. motionVisibilityDelayMs kesintisiz görünürlük süresi ekleyebilir; varsayılanı sıfırdır. motionOnceKey aynı belgedeki yeniden bağlamalarda oynatma kaydını paylaşır; üstbilgi ve altbilgi ayrı anahtarlar kullanır. Gezinme, tema değiştirme ve geri kaydırma yeniden oynatmaz; tam sayfa yenileme kaydı sıfırlar. Azaltılmış hareket, kapalı JavaScript veya görünürlük gözlemi desteğinin olmaması durumunda durağan logo gösterilir. motion="reveal" takma ad olarak korunur.

PlatformHeader.autoHideOnScroll varsayılan olarak false değerindedir; PublicPlatformHeader bunu etkinleştirir. Üstbilgi aşağı kaydırmada gizlenir, yukarı kaydırmada veya sayfa başına yakınken geri gelir. Açık üstbilgi menüleri ve içindeki odak onu görünür tutar. Çalışma alanı ve düzenleyici üstbilgileri sabit kalır.

PlatformHeader, iş durumu içermeyen bir Header iskeletidir. PublicPlatformHeader, marka girişleri, ortak navigasyon, dil, tema, giriş, "Hemen Deneyin" ve mobil menüyü bunun üzerinde birleştirir; platformun anonim durumu ve dokümantasyon sitesi bu bileşimi doğrudan paylaşır.

Ortak navigasyon buildPublicHeaderNavItems(copy, links) aracılığıyla "Kaynaklar / Fiyatlandırma / Haberler" olarak tek tip üretilir. Entegre olan taraf, yalnızca geçerli uygulamanın site içi, dokümantasyon sitesi ve platform URL'lerini çözmeli; menü sırasını veya metnini tekrar tanımlamamalıdır. Giriş yaptıktan sonraki platform Header'ı da aynı üretim işlevini kullanır.

<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'
  }}
/>

Alt katmandaki navItems hala link, scroll ve menu desteği sağlar. menu masaüstünde tıklama, klavye, Escape ve dışarı tıklama ile kapanmayı destekler; mobilde ise MobileHeaderMenu tarafından bağlantı grubuna genişletilir.

SiteFooter Footer iskeletidir; platform ve dokümantasyon sitesi, dış kabuk, marka giriş, bağlantılar, tema ve dil denetimlerini birleştirmek için PublicPlatformFooter kullanır. Alanlar arası entegrasyon, resolveCompanyHref aracılığıyla göreli platform bağlantılarını mutlak adreslere dönüştürerek gerçekleştirilir.

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

İş uygulamaları Header, Footer DOM'unu veya ortak navigasyon dizisini kopyalamamalıdır; farklı görsel gösterim gerekiyorsa PlatformHeaderSkin, SiteFooterSkin veya ilgili platform Skin'ini kullanmalıdır.

Uyumluluk Stratejisi

  • Yeni eklenen isteğe bağlı özellikler ve Skin yuvaları geriye dönük uyumlu değişikliklerdir;
  • Özelliklerin silinmesi, varsayılan semantiğin değiştirilmesi veya DOM/klavye davranışının bozulması yapıyı bozan değişikliklerdir;
  • Yapıyı bozan değişiklikler Changelog'a girmeli ve geçiş örnekleri sağlamalıdır;
  • Açık olmayan dahili class'lara, dizinlere veya route yapılarına güvenmeyin;
  • İki veya daha fazla entegrasyon noktası aynı geçersiz kılma işlemini gerektiriyorsa, bunu açık bir Skin veya Token olarak yükseltin.

Tam ekran düzenleme

EditorWorkspace tam ekran iletişim kutusunu, odak yönetimini ve duyarlı panelleri birleştirir. dirty değişiklikleri silmeden önce onay ister, busy kaydederken kapatmayı engeller ve onSave Ctrl/Cmd+S kısayolunu işler. İzinler, veriler, kaydetme ve yayımlama ana uygulamanın sorumluluğundadır.

view / onViewChange, düzenleyiciyi değiştirmeden edit, focus ve preview arasında geçiş yapar. preview önizlemeyi sağlar; previewPanel mevcut paneli kullanır. layout, writing, structure ve canvas seçeneklerini destekler. storageKey yalnızca panel genişliklerini ve daraltma tercihlerini hatırlar, belgeyi kaydetmez.

onSaveAndClose doğrulanmış kayıttan sonra true, hatada false, uygulama yönlendirdiyse handled, doğrulama karar bekliyorsa pending döndürür. Hata durumunda düzenleyici açık kalır. closeBehavior="collapse" yalnızca uygulama taslağı koruyorsa kullanılmalıdır. EditorSaveStatus doğrulanmış durumu gösterir. EditorViewControls, EditorLeaveDialog ve useEditorLayout ayrı olarak da birleştirilebilir.

Klavye değişikliği: Segmented tek Tab durağı kullanır; seçim oklar / Home / End ile değişir. Dialog, alt katmanın işlediği Escape tuşuna uyar; ardından düzenleyici kapanmadan önce odak veya önizlemeden çıkar. LivePreviewToolbar.exitControl ortak görünüm denetimlerini kabul eder. Kayıt, yayınlama ve izinler uygulamanın sorumluluğundadır.

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, kenar çubuğu düğmesini çalışma alanının başlığına taşır. Bir sol kenar çubuğuyla tek bir yuva kullanın. Durum, kısayollar ve mobil çekmeceyi SidebarNavigation yönetmeye devam eder; yuva yoksa denetimler yerinde kalır. Başlıktaki düğme mobil çekmeceyi de kapatır; kapatıldığında odak aynı düğmeye döner.

EditorHeader

EditorHeader, uygulamanın logosunu, hesabını ve genel menüsünü etkin düzenleyicide tutar. startControl ve endControl yan panelleri, center görünümleri, actions kaydetme işlemlerini yönetir. PlatformHeader.editorActions duyarlı gezinme, dil ve tema kontrollerini yeniden kullanır. onNavigate, geri çağırmayı çalıştırmadan önce kaydedilmemiş değişiklikleri ele almalıdır. Dar ekranlarda başlık iki satır kullanır; alt menüler Escape tuşunu önce işler.

WorkspaceHeaderPortal.startControl ve endControl, yönetilen sayfa panel geçişlerini ev sahibinin eşleşen yuvalarına yerleştirir. Ev sahipleri, başlık, durum ve eylemlerin yanı sıra isteğe bağlı startTarget ve endTarget'ü ortaya çıkarır. Dosyalar kütüphanesi ve tek varlık çalışma alanı workAreaControls'ü kullanır; varlık önizlemesi, kimliği, dönüş eylemi ve panel hedeflerinin kullanılabilir kalması için tam üst bilgiyi korur. ProjectWorkspace, İçerik ve Dosyalar için paylaşılan sol navigasyon/sohbet seçeneklerini yönetir. Dosyalar, hatırlanan kaynak-panel boyutlarını useProjectResourcePanel üzerinden kaydeder, navigasyonu ProjectContentTools üzerinden portalize eder ve yalnızca sağ denetleyici kontrolünü ProjectToolbar.endControl üzerinden sağlar. Sohbet, proje alanları boyunca aynı sol şeridi ve gömülü yazışma bileşenini kullanır; kompakt kaynak, sohbet ve denetleyici görevleri birbirine exclusive'dir.

EditorNavigationMenu

EditorNavigationMenu, izinleri ve proje bağlamını koruyarak ana uygulamanın tüm SidebarNavigation içeriğini tuvali kaydırmayan bir örtü panelinde gösterir. Dil ve tema alttadır; Escape önce alt menüleri kapatır. Odak ve tarayıcı tam ekranı bağımsızdır. Gezinme süren kayıtları bekler ve taslakları korur.

WorkspaceNavigationMenu / WorkspacePageHeader

Genel gezinme, Creator içinde de bağımsız olarak Mac’te Command+\, Windows/Linux’ta Control+\ kullanır. T ve Shift+T düzenleyici yerleşimini yönetmeye devam eder. Düzenlenebilir hedefler, metin birleştirme, tekrarlar ve işlenmiş olaylar yok sayılır. Düğme ipuçları ve aria-keyshortcuts tuş birleşimini gösterir; genel gezinme artık tek başına T tuşunu kullanmaz.

Oturum açılmış çalışma alanları her genişlikte hesap ve gezinme alanı için PlatformHeader.workspaceActions kullanır. WorkspacePageHeader başlıkları ve eylemleri birleştirir. WorkspaceNavigationMenu mevcut kenar çubuğunu izinleri ve bağlamıyla gösterir; EditorNavigationMenu uyumlu bir takma ad olarak kalır. Studio kendi araç çubuğunu korur. Herkese açık başlıkların görünümü korunur.

WorkspaceNavigationGuard, dirty, busy, error ve isteğe bağlı onSave ile genel gezinmeyi korur. Yalnızca onaylanan kayıt true döndürdüğünde ayrılmaya izin verilir; hata taslağı korur. Language.onBeforeChange(apply) dil değişiminden önce aynı korumayı sağlar. Kayıt sırasında form alanlarını devre dışı bırakın.

Masaüstü gezinme, genişletilmiş çubuğu ve simgeleri korur ve otomatik gizleme ekler. Çubuk ve açılır panel arama ve grup durumunu paylaşır. Hassas işaretçi kenarda 300ms kaldığında geçici önizleme açılır, ayrıldıktan 320ms sonra kapanır; tıklama açık tutar. Dokunma ve klavye kontrolleri korunur. Dialog varsayılan olarak modal={true} ve autoFocus={true} kullanır; önizleme, odağı ve kaydırmayı korumak için ikisini de false yapar.

EditorViewControls

Tek düğme iki yönde geçiş yapar: düzenlerken Odak, odaktayken Düzenle gösterilir. Tıklayın veya T tuşuna basın; E doğrudan düzenlemeye döner. Dar başlıklarda düğme görünür kalır; önizleme, tam ekran ve ek işlemler Diğer menüsündedir.

EditorViewControls, Düzenleme/Odak modlarını yerel tam ekrandan ayırır. Önizleme ayrı bir geçiştir ve önceki moda döner; useEditorWorkMode özel çıkış işlemleri için bu modu korur. edit/focus/preview değerleri geçerliliğini korur. Önizleme artık mod grubundaki radio yerine aria-pressed içeren bir button kullanır. Tam ekran bir tıklama gerektirir, uygulama kökünde gezinmeyi ve iletişim kutularını kapsar; desteklenmiyorsa giriş gizlenir.

Language / Appearance

Language ve Appearance variant="menu", etiket, geçerli değer ve ok gösteren isteğe bağlı layout="row" düzenini destekler. Varsayılan kompakt düzen ve dil değiştirme koruması korunur. SiteHeaderCopy.helpResources ve contactSupport, çalışma alanı yardım bağlantılarını isteğe bağlı olarak adlandırır.

requestWorkspaceNavigation

Kenar çubuğu düğmesi bulunan sayfalar, daraltılmış ve mobil düzenlerde de üst bilgideki ek menü düğmesini göstermez. Düzenleyiciler ve kenar çubuğu olmayan sayfalar düğmeyi korur. @qokit/components/patterns/WorkspaceNavigation üzerinden requestWorkspaceNavigation(returnFocusTarget?) ve useWorkspaceNavigationState() içe aktarılır: istek kayıtlı paneli açıp kapatır ve panel yoksa false döndürür. İsteğe bağlı öğe kapanışta odağı alır. Başka bir giriş göstermeden önce .available kontrol edilir. Kaldırılan düğmenin DOM konumu yerine mevcut düğme veya bu API kullanılmalıdır.

WorkspacePanelReveal

Genel gezinme menü simgesi, araçlar yönlü panel simgeleri kullanır. useWorkspacePanelReveal({ temporary: true }) Odak modunda araçları tıklama veya klavyeyle geçici açar. toggle(trigger?) ve close(true) düzeni ve çalışma modunu korur, kapanışta odağı geri verir. Ekran kenarı genel gezinmeyi açar; araçlar kendi düğmeleri yakınında tepki verir. Önizleme panel düğmelerini gizler ve önceki düzenleme moduna açık bir dönüş eylemi sunar.

EditorViewControls / Görünüm modu

EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts

EditorHeader, EDITOR_TOOLBAR_SHORTCUTS komutlarını da yönetir: Command/Control+S görünür EditorSaveButton denetimini çalıştırır, Shift+P EditorStatusAction shortcut="publish" bileşenini, Shift+M araç menüsünü açar. Komutlar tıklamayla aynı etkin denetimleri kullanır; yayımlama panel içinde açık bir işlem gerektirir. Yalnızca etkin ve görünür başlık yanıt verir. Alt menüler, iletişim kutuları, metin oluşturma ve yinelenen olaylar kısayolları engeller; giriş alanlarında yalnızca kaydetmeye izin verilir. İpuçları ile aria-keyshortcuts aynı tanımları kullanır. Özel toolsControl, tetikleyicide aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} belirtir. ActionMenu.triggerKeyShortcuts, küresel komut kaydetmeden öznitelik ve ipucu ekler.

Panel komutları: Shift+A (ekle), Shift+L (sayfalar/katmanlar), Shift+K (sohbet), Shift+C (içerik), Shift+D (tasarım), Shift+G (genel stil). CMS kullanılabiliyorsa Shift+S (ayarlar), Shift+E (SEO), Shift+H (geçmiş) ekler. EditorChoiceControl, EditorViewTabs ve ActionMenu içindeki shortcut meta verileri ortak ipuçlarını sağlar. EditorPanelChoiceShortcuts ve EditorViewControls.compactActions, telefonlarda menüye katlanan işlemleri korur. EditorPanelShortcuts.commands, denetimleri çoğaltmadan mevcut işlemleri kaydeder. Gizli, inert, devre dışı, önizleme ve üst katman kısıtlamaları geçerlidir. Aynı çalışma alanındaki modal olmayan telefon kenar çubukları panel değiştirmeye izin verir; menüler ve modal kutular kısayolları engeller. Değiştiricisiz tuşlar mevcut davranışını korur.

Görünüm modu
EDüzenle
TDüzenle ↔ Odak
VÖnizleme / Düzenlemeye dön
FTam ekrana geç / Tam ekrandan çık

Yalnızca etkin düzenleyici yanıt verir. Metin girişi, IME oluşturma, basılı tutulan tuşlar ve açık alt iletişim kutuları veya menüler modu değiştirmez.

PlatformHeader.workspaceNavigation

PlatformHeader.workspaceNavigation genel gezinmeyi logodan önce yerleştirir; workspaceActions ve editorActions hesap işlemlerini korur. Çalışma alanları mevcut kenar çubuğu düğmesini kullanır; düzenleyiciler sağ panel düğmesini avatardan önce yerleştirir. Dar ekranlarda gezinme, marka, başlık ve avatar üstte; düzenleme araçları ve Kaydet altta bulunur. DOM sırası yerleşimi izler; kenarlıksız buzlu cam görünümü korunur.

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

EditorHeader.preview, yalnızca center alanını kenarlıksız ve kompakt önizleme çubuğu olarak gösterir; logo, hesap, kaydetme ve paneller bağlı kalır ancak gizlenir. Ayrı LivePreviewToolbar kullanıldığında düzenleyici başlığı gizlenebilir; EditorViewControls.returnView (edit veya focus) önceki modu geri getirir. Erişilebilir geri dönüş ve bağımsız tam ekran kontrolünü koruyun; sitenin kendi başlığı görünür kalır.

2026-09-06 · Builder / CMS

Builder ve CMS; paneller, ekleme görselleri ve görünüm ayarları için BuilderWorkspace, EditorCatalog ve EditorComponentSettings bileşenlerini paylaşır. Ön ayarlar ilişkili seçenekleri birlikte uygular ve içeriği korur; kaydetme ve geri alma her uygulama tarafından yönetilir. Denetimler platform temasını, içerik ise site temasını kullanır.

Sunucuda oluşturulan altbilgi · 2026-09-07

SiteFooterLayout, açıkça belirtilen bir locale ve tek dilde bir copy alır. Sunucu bileşenleri ortak altbilgi yapısını oluşturur; tema ve dil denetimleri ile QR iletişim kutusu istemci bileşenleri olarak kalır. Mevcut SiteFooter ve PublicPlatformFooter arayüzleri desteklenmeye devam eder.

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

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

Alan adları arası bağlantıları sunucuda copy.companyLinks içinde hazırlayın. Etkileşimli denetim alanını özelleştirmek için controls kullanın.

EditorHeader.titleControl / FloatingAssistant.presentation

EditorHeader.titleControl ve EditorWorkspace.titleControl, başlığı ortak proje menüsüyle değiştirebilir. Açıklayıcı bir title ve gezinmede kaydedilmemiş değişiklik korumasını koruyun. FloatingAssistant.presentation="embedded", ana panelde yüzen düğme veya arka plan katmanı olmadan adlandırılmış bir bölge gösterir; varsayılan değer floating olarak kalır. Ana bileşen konum ve görünürlüğü, asistan ise konuşma durumunu ve izinleri yönetir.

2026-09-07 · WorkspaceAssembly

WorkspaceAssembly, düzen kutusu eklemeden çıkan kartları ve gelen bölümleri işaretler. Doğrudan çocuk gerektiren yapılarda workspaceAssemblyAttributes(part, index, phase) mevcut DOM öğesine eklenir. EditorHeader.assemble ve BuilderWorkspacePanels.assemble düzenleyici işaretlerini sağlar.

await startWorkspaceAssembly(navigate, destinationPathname) yalnızca oluşturma başarılı olduktan sonra çağrılır: görünür parçaları yakalar, bir kez gezinir ve hedefi veya eşleşen yükleme iskeletini en fazla 720 ms içinde birleştirir. Hedef, giriş için bir canvas işareti sunmalıdır; useWorkspaceAssemblyPending() yakalamalar yerleşene kadar yükleme yüzeyini bağlı tutar ve bu sırada veri ile kod önceden yüklenir. Azaltılmış hareket veya desteklenmeyen tarayıcı doğrudan gezinir. Yavaş ya da kesilen geçişler yakalamaları serbest bırakıp devam eder. İşaretler düzenleme, yenileme veya geçmiş gezinmesini canlandırmaz. Geçici stilleri ortak yapı temizler; hatalar, idempotans ve yükleme durumu uygulamada kalır.

2026-09 · Yönetim çalışma alanları

WorkspacePage ve WorkspaceLayout, variant için overview, list, detail, settings veya editor kabul eder. WorkspaceFormFooter, uygulamanın sağladığı actions, message, tone ve busy değerlerini düzenler; verileri uygulama kaydeder.

Dar tablolar (WorkspaceDataTable, AdminDataTable), seçim, özel başlıklar ve işlemler içeren etiketli kayıtlar gösterir. Karşılaştırma matrislerinde mobileLayout="scroll" kullanın. WorkspaceFilterToolbar, arama ve filtreleri sıralama ve görünümden önce yerleştirir. Kenar çubuğu h2, sayfa h1 kullanır.

2026-09-08 · Task focus

useSidebarTaskFocus(active) odak gerektiren bir görev sırasında gezinmeyi geçici olarak gizler. Kullanıcı modu açıkça değiştirmediyse çıkışta önceki görünüm geri yüklenir. Otomatik gizleme kayıtlı tercihi değiştirmez.

Yeni API referansı (İngilizce; çeviri bekleniyor)

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 bağdaştırıcısı FloatingAssistantPanel.composerAttachments alanını da iletir. Bu yuva, ana uygulamanın yönettiği ekleri mesaj formunda metin alanından önce gösterir. Konumu ve gönderimi ana uygulama yönetir: bırakma eki hazırlar, başarı yalnızca gönderilen eki kaldırır, hatalar yeniden denemek için eki korur.

Ortak konuşma bileşenleri (İngilizce referans; çeviri bekliyor)

@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, konuşmalarda görev durumlarını, hataları, yedek işleyişi ve kayıt onaylarını kompakt biçimde göstermek için InlineNotice kullanır. Yerelleştirilmiş bir title ve isteğe bağlı description, tone ile action sağlayın. Her iki satır da açıklama yazısı boyutu, dar aralık ve saydam yüzey kullanır; renk tonu durumu vurgularken destekleyici metin soluk kalır. Varsayılan role="status" ve aria-atomic="true" güncellemenin tamamını birlikte duyurur; işlem gerektiren hatalarda role="alert" kullanın. Asistanın yazdığı metin ConversationText içinde kalır.

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.

Yeni API referansı (İngilizce; çeviri bekleniyor) · 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, durum filters, sort, alan controls, advanced seçenekleri, koşullu reset, kaynak result ve yardımcı summary.
  • presentation: view, görünür sütunlar ve sayfa boyutu gibi controls ve options'ü görüntüler. Sayfa widget özelleştirmesi sayfa üst bilgi eylemlerinde olmalıdır.
  • 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.

Kaynak adı ve sonuç sayısı için query.result={{ label, count, total?, locale? }} kullanın. WorkspaceResultSummary “Ad · sayı” gösterir; yalnızca güvenilir, filtrelenmemiş toplam farklıysa “/ toplam” ekler. Sayılar arayüz diline göre biçimlendirilir ve çift yönlü metinde yalıtılır. Sayı bilinmiyorsa result kullanmayın; sıfır geçerlidir. Aynı listenin üstüne ikinci bir ad ve sayı satırı eklemeyin. AdminFilterBar.result aynı nesneyi kabul eder. Sayfa başlıkları, anlamlı bölüm başlıkları, sayfalama ve seçili sayıları kendi rollerini korur; diğer birimler, sorgu bağlamı veya güncellik için query.summary kullanın.

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.

Ek API başvurusu (İngilizce; çeviri bekleniyor) · 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.

Seçim ve menü seçenekleri, tema renginde bir nokta eklemek ve yerelleştirilmiş anlamını erişilebilir ada katmak için annotation kullanabilir. ControlMenu tetikleyicisi etkin seçeneğin noktasını da gösterir; triggerAnnotation: null işareti yalnızca menüde tutar. Etkin ve seçili bir seçeneği yeniden seçmek onReselect çağrısını tetikler. Yerel seçenekler açıklamayı etiketin yanında gösterir; hidden yer tutucuyu listeden çıkarır. İşaretlenecek değeri ve eylemi ana uygulama belirler; ortak denetim devralmayı tahmin etmez veya veri yazmaz.

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'ı, mobil dahil olmak üzere bağlamsal yardımın ardından ve birincil eylemden önce sayfa üst bilgi eylemlerine yerleştirin. Eylemi açıkça adlandırmak için yerelleştirilmiş copy.customize kullanın (örneğin, "Widgetları Özelleştir"). Aynı sadece simge giriş, aria-pressed ve aria-expanded'ü ortaya çıkarır ve düzenleme sırasında copy.done haline gelir. customizeButtonRef, ev sahibi odak geri yüklemesi için tetikleyiciyi isteğe bağlı olarak ortaya çıkarır; disabledCustomize, geometrisini değiştirmeden girişi devre dışı bırakır. Daraltılabilir widgetları destekleyen ev sahipleri için yalnızca onCollapseToggle ve areWidgetsCollapsed sağlayın; bunları atlamak, özelleştirme girişini tek başına render eder.

CustomizableWidgetLibrary, ortak kütüphane başlığını, sıfırlama/kapatma eylemlerini, duyarlı kaydırma düzenini, ilk kapatma düğmesi odağını ve Escape işleme sorumluluğundadır. Kapatma, odağ hala kütüphanenin içindeyken çağıran kontrole döner; dış tıklamalar hedef odaklarını korur. Ev sahipleri widget tanımlarını, ekleme/kaldırma/sıralama/boyutlandırma komutlarını, kalıcılığı ve sıfırlama semantiğini korur. CMS ve Admin sınıf yuvaları alan hook'ları için kullanılabilir durumda kalmaya devam eder, ancak ayrı kütüphane yüzeyleri veya mobil düzenler tanımlamamalıdır.

2026-10-17 · Zengin ActionMenu tetikleyicileri

ActionMenu.renderTrigger, SelectableTile gibi zengin bir denetimi yeniden kullanabilir. aria-expanded, aria-haspopup, disabled ve onClick alır; bunları gerçek tetikleyiciye yayınız. Ana bilgisayar, denetimin seçim anlambilimini ve görünümünü korur. Portal konumlandırma, menü klavye gezinmesi, kapatma, odağın geri dönüşü ve isteğe bağlı mobil sayfalar yine ActionMenu tarafından yönetilir. Varsayılan düğme ve simge tetikleyicileri değişmemiştir.

Yarıçap ve aralık denetimleri

@qokit/components/ui/RangeNumber içindeki RangeNumber, yerel aralık kaydırıcısını kesin sayısal Input ile birleştirir. label, value, min, max, isteğe bağlı step ve unit ile onChange sağlayın. Tanımsız değer, karma değer çizgisi gösterir; herhangi bir girdinin değiştirilmesi sınırlar içinde tek bir sayı ayarlar. onCommit, sürekli değişiklikleri uygulamanın mevcut geri alma geçmişinde gruplar. disabled, klavye gezintisi, sıkışık yoğunluk, RTL ve odak stilleri ortaktır; kalıcılık uygulamaya aittir. RangeNumberSkin kök, kaydırıcı, girdi ve birim yuvaları sunar.

@qokit/components/patterns/EditorRadiusControl içindeki EditorRadiusControl, canlı şekil önizlemesini, dört fiziksel köşe girdisini, RangeNumber ve isteğe bağlı şekil hazır ayarlarını birleştirir. value ve onChange, CSS border-radius kısaltmasını kullanır; cornerLabels ve hazır ayar adları uygulama tarafından çevrilir. RTL’de sıra yine sol üst, sağ üst, sağ alt, sol alttır. max düzenlemeyi sınırlı piksel değerlerine daraltır; atlandığında CSS birimleri ve eliptik köşe sözdizimi korunur. Karma yarıçap, dört köşe birlikte ayarlanana kadar tek bir sayı göstermez. İsteğe bağlı EditorRadiusControlSkin, durum veya kalıcılığı değiştirmeden kök, diyagram, önizleme ve hazır ayar yuvalarını uyarlar.

2026-10-22 · Dar ekranlarda etkin gezinme sekmeleri

PillTabs, varsayılanı false olan isteğe bağlı scrollActiveTabIntoView seçeneğini kabul eder. Yatay sekmelerde seçim ve yeniden boyutlandırma sırasında etkin doğrudan çocuk PillTabLink veya PillTabButton görünür hâle getirilir. Yalnızca sekme şeridi kayar; sayfa konumu ve klavye odağı değişmez. Azaltılmış hareket dâhil LTR ve RTL için anında düzeltme sağlar. Dikey sekmeler ve seçeneği atlayan çağrılar mevcut davranışı korur.

Bu Sayfada

Bileşen Entegrasyonu2026-10-20 · Görsel seçim kartlarında bağımsız işlemler2026-10-17 · Paylaşılan çalışma masası panel hareketi2026-10-17 · Ölçülü editör varsayılanları2026-09-30 · SelectionToolbar erişilebilirliği2026-09-10 · Çalışma alanı kimlik rozetleri2026-09-08 · EmptyState2026-09-08 · SidebarNavigation2026-09-07 - AccountDropdown / SidebarProfile2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace2026-09-07 · WorkspaceLocationSync / ProjectSwitcher2026-09-07 · Birleşik gezinme ve yuvarlatılmış Qokit yüzeyleri2026-09-07 - ColumnLayoutİçe Aktarma Giriş NoktalarıOrtak Sorumluluk SınırlarıOluşturulan Öge İçeriğiForm KontrolleriListe SeçimiMetrik KartlarıYeni API referansı (İngilizce; çeviri bekleniyor) · 2026-10Platform Header ve FooterUyumluluk StratejisiTam ekran düzenlemeSidebarToggleSlotEditorHeaderEditorNavigationMenuWorkspaceNavigationMenu / WorkspacePageHeaderEditorViewControlsLanguage / AppearancerequestWorkspaceNavigationWorkspacePanelRevealEditorViewControls / Görünüm moduPlatformHeader.workspaceNavigation2026-09-06 - EditorHeader.preview / EditorViewControls.returnView2026-09-06 · Builder / CMSSunucuda oluşturulan altbilgi · 2026-09-07EditorHeader.titleControl / FloatingAssistant.presentation2026-09-07 · WorkspaceAssembly2026-09 · Yönetim çalışma alanları2026-09-08 · Task focusYeni API referansı (İngilizce; çeviri bekleniyor)Ortak konuşma bileşenleri (İngilizce referans; çeviri bekliyor)Yeni API referansı (İngilizce; çeviri bekleniyor) · 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 · EditorItemDisclosureEk API başvurusu (İngilizce; çeviri bekleniyor) · 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 · Zengin ActionMenu tetikleyicileriYarıçap ve aralık denetimleri2026-10-22 · Dar ekranlarda etkin gezinme sekmeleri