Tasarım Sözleşmesi Güncellemeleri
Qokit'in açık tasarım Token'ları, bileşen API'leri ve entegrasyon sözleşmelerindeki değişiklik kayıtları.
Tasarım Sözleşmesi Güncellemeleri
2026-10-21 · Kaydırılabilir menülerde sabit işlemler
ActionItem.pinned, işlemleri ve ActionMenu.dropdownHeader alanını kaydırılan listenin dışında tutmak için start veya end kabul eder. Klavye gezinmesi ve seçim tüm bölgeleri kapsar. Portal ana uygulamaları, tetikleyicinin seçilen tarafında ölçülen --qk-menu-available-height ile yüksekliği sınırlayabilir. pinned olmadan mevcut menü yapısı korunur.
2026-10-17 · Widget özelleştirme girişi
Sayfa widget özelleştirmesi, Projeler, İçerik ve panellerde paylaşılan üst bilgi girişini kullanır. CustomizableWidgetLayoutControls isteğe bağlı customizeButtonRef ve disabledCustomize ekler; daraltma kontrolleri isteğe bağlıdır. CustomizableWidgetLibrary, mobil geometriyi, ilk odağı, Escape tuşunu ve odağın dönüşünü ev sahipleri arasında paylaşır. Widget kalıcılığı ve komutlar ev sahibi tarafından yönetilmeye devam eder. Widget özelleştirme entegrasyonu bölümüne bakınız.
2026-10-17 · Yönetilen çalışma masası panel kontrolleri
WorkspaceHeaderPortal, eşleşen isteğe bağlı ev sahibi hedefleriyle birlikte isteğe bağlı startControl ve endControl kabul eder. Yönetilen Dosyalar görünümleri, tek varlık düzenleme ve önizlemesiyle aynı üst bilgi panel yuvalarını ve çalışma alanı geometrisini kullanır. Mevcut ev sahipleri yalnızca başlık, durum ve eylemleri sağlamaya devam edebilir. EditorHeader entegrasyonu bölümüne bakınız.
2026-10-17 · Ölçülü editör varsayılanları
useWorkspaceResponsiveProfile, kullanılabilir çalışma alanı ölçümleri için isteğe bağlı onWidthChange(width) ekler. useEditorLayout, yapılandırılmış paylaşılan genişlik sınırlarını artık ev sahibi depolamasına da uygular ve readEditorLayout, dördüncü bağımsız değişkeni olarak isteğe bağlı sınırları kabul eder. Mevcut çağrılar varsayılanlarını korur. Component Integration bölümüne bakınız.
2026-09-26 · Creator · Stil şemaları
Ayrıntılı aralıklar · v3: site.theme.spacingOverrides 按 desktop/tablet/mobile → sectionPadding (0–240px), pageGutter, cardGap (0–96px). --qk-site-custom-{sectionPadding|pageGutter|cardGap}-{desktop|tablet|mobile}. 980px / 720px.
Düğmeler ve bağlantılar: primaryButtonStyle, secondaryButtonStyle (solid/outline), buttonFontSize (12–24px), linkUnderline (always/hover/none), linkHoverStyle (none/tint). --qk-site-{primary|secondary}-button-{background|color|border|shadow}, --qk-site-button-font-size, --qk-site-button-size-{sm|md|lg}, --qk-site-link-decoration, --qk-site-link-hover-decoration, --qk-site-link-hover-background. initial → Otomatik.
Gelişmiş renkler: mutedColor, borderColor, buttonTextColor, cardSurfaceColor 与对应 dark* 字段 (--qk-site-color-card-rgb).
2026-09-09 · Genel gezinme kısayolu
SidebarNavigation / WorkspaceNavigationMenu: 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.
2026-09-08 · EmptyState
Proje ve CMS makale/ürün oluşturma yönlendirmeleri EmptyState bileşenini paylaşır: ortalanmış, saydam, kompakt ve satıra sığan eylemler. icon, layout, style ve description isteğe bağlıdır. Başlık h2 kullanır; özel strong seçicilerini title skin yuvasına taşıyın. Eylemler ortak kapsayıcı kullanır. İzinler ve oluşturma ana uygulamada kalır.
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-08 - Primary button foreground
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.
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 --accent-action üzerinden doğrudan Logo mavisi #4695D8 kullanır; koyu gradyan kaldırılır. Üzerine gelindiğinde %8 beyaz eklenir; etiketler okunabilirlik için marka mürekkebine %10 siyah karıştırır. Gezinme vurguları aynı maviyi ve temaya uygun metni 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.
2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader
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.
2026-09-05 · 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. 1120px ve altında başlık iki satır kullanır ve menü etkin görünümün adını gösterir. Odak ve tarayıcı tam ekranı bağımsızdır. Gezinme süren kayıtları bekler ve taslakları korur.
2026-09-05 · 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.
2026-09-05 · 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.
2026-09-05 · EditorWorkspace / Dialog / Segmented
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.
2026-09 · EditorWorkspace
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.
2026-08 · Kompakt İndikatör Yoğunluğu
MetricCardiçin yüksek yoğunluklu operasyon alanlarına yönelik isteğe bağlıdensity="compact"API'si eklendi;- Mevcut varsayılan yoğunluk ve DOM anlamı korundu;
- Kompakt dolgular, değer ölçekleri ve minimum yükseklikler paylaşılan bileşen stillerine taşındı; bu sayede rotalar görsel geçersiz kılmaya gerek kalmadı.
2026-07 · Birleştirilmiş Form Kontrolleri
@qokit/components/ui'yeFormField,Input,Textarea,Checkbox,RadioGroupveSwitcheklendi;- Paylaşılan
FormFieldiskeleti etiketler, açıklamalar, hatalar, zorunlu durumlar ve ARIA referanslarını ilişkilendiriyor; Input,Textarea,SelectveSearchField40px, 44px ve 48px boyutlarında birleştirildi ve paylaşılan etkileşim Token'ları kullanılıyor;- Yeni form temel bileşenleri için Platform, Admin ve oluşturulan site Skin tarifleri eklendi;
- Geriye dönük uyumluluk için mevcut
.qk-fieldstili korunuyor.
2026-07 · Düğme Boyutu Tipografisi
- Üç yeni semantik Token eklendi:
--button-font-size-sm,--button-font-size-md,--button-font-size-lg; Buttoniçindekism,mdvelgartık sırasıyla sabit 14px, 15px ve 16px yazı boyutunu kullanır; Header, Dialog veya sayfa kapsayıcısından yazı boyutu miras alınmaz;- Site Skin'i düğme tipografisini ayarlamak istiyorsa, ilgili semantik Token'ı geçersiz kılmalıdır;
font-sizeüzerine route class ile müdahale edilmemelidir.
2026-07 · Platform Ortak Navigasyon İskeleti
- Giriş yapma bağımlılığı olmayan yeni bir
PlatformHeadereklendi; platform ve dokümantasyon sitesi aynı semantik iskeleti paylaşır; - Platform anonim durumu ve dokümantasyon sitesi için ortak Header bileşimi ile navigasyon yapılandırmasını sağlayan yeni
PublicPlatformHeadervebuildPublicHeaderNavItemseklendi; HeaderNavItem, yeni birmenutürü içerir; masaüstü Header kapanabilir açılır menü kullanırken, mobil Header otomatik olarak bağlantı gruplarına genişler;SiteFooter, açık dokümantasyon gibi farklı entegrasyon senaryolarını desteklemek için isteğe bağlıbrandHrefvecontrolsekler;- Platform ve dokümantasyon sitesinin ortak bir Footer Shell'i paylaşmasını ve platform bağlantılarının alanlar arası çözümlemesini sağlayan yeni bir
PublicPlatformFootereklendi; - Bunların tümü geriye dönük uyumlu isteğe bağlı API'lerdir; mevcut platform Header durum mantığı ve Footer varsayılan denetimleri değişmemiştir.
2026-07 · Açık Tasarım Rehberi
- Açık tasarım sözleşmesi, dahili AI uygulama standartlarından ayrıştırıldı;
- Görsel Token'lar, bileşen içe aktarma, Skeleton/Skin sınırları, Button, Card ve erişilebilirlik gereksinimleri açıklandı;
- Yapıyı bozan bileşen değişiklikleri için mutlaka geçiş açıklaması sağlanması gerektiği belirtildi;
- Açık arama, Sitemap ve LLM çıktısı yalnızca dışa bağımlılık oluşturulabilecek içerikleri içerir.
Uyumluluk Açıklaması
-
Yeni eklenen isteğe bağlı özellikler, isteğe bağlı Skin yuvaları ve semantik Token'lar genellikle geriye dönük uyumlu kalır;
-
Özelliklerin silinmesi veya yeniden adlandırılması, varsayılan DOM/semantik/klavye davranışlarının değiştirilmesi yapıyı bozan değişikliklerdir;
-
Yapıyı bozan değişiklikler, bu sayfada etki alanını, alternatif API'yi ve geçiş adımlarını açıklayacaktır.
-
2026-09-06: Masaüstü gezinme, genişletilmiş çubuğu ve simgeleri korur ve otomatik gizleme ekler. SidebarNavigation / WorkspaceNavigationMenu / Dialog
-
2026-09-06: EditorViewControls, Düzenleme/Odak modlarını yerel tam ekrandan ayırır. EditorViewControls
-
2026-09-06:
LanguageveAppearance 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.helpResourcesvecontactSupport, çalışma alanı yardım bağlantılarını isteğe bağlı olarak adlandırır. Language / Appearance -
2026-09-06: Kenar çubuğu bulunan sayfalarda yinelenen menü düğmesi kaldırılır; mevcut düğme ve gezinme API’si kullanılabilir kalır. WorkspaceNavigation
-
2026-09-06: Genel gezinme menü simgesi, araçlar yönlü panel simgeleri kullanır. WorkspacePanelReveal / EditorViewControls
-
2026-09-06: Görünüm modu ·
E/T/V/F·Segment.shortcut. EditorViewControls -
2026-09-06:
PlatformHeader.workspaceNavigationgenel gezinmeyi logodan önce yerleştirir PlatformHeader.workspaceNavigation
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.
2026-09-06 - 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
2026-09 · Yönetim çalışma alanları
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)
Optional FloatingToolPanel.viewKey animates tool changes without remounting the body. Shared opening, closing, unfolding and pin feedback respect reduced motion; pointer geometry updates run at most once per animation frame. Closed Dialog keepMounted surfaces become inert and hidden from assistive technology immediately, including during an exit transition. Existing props and document state ownership are unchanged.
The opt-in useWorkspacePanelEdgeDrag hook connects existing workspace borders to expanded, icon and hidden states in one mouse or touch gesture, with keyboard resizing, RTL and cancellation. ResizablePanels now marks its separators with data-workspace-panel-edge; existing hosts retain their behavior until they enable the hook. Hosts own widths, state, focus and visual skins. See the integration contract.
Yeni API referansı (İngilizce; çeviri bekleniyor) · 2026-10
2026-10-08 · Workspace title navigation
WorkspaceLayout and WorkspacePageHeader accept optional backControl before the title. Use WorkspaceBackButton with a localized label and the existing href or onClick; it supplies an icon, accessible name, Tooltip and RTL mirroring. Hosts retain return destinations, list state and navigation guards. Existing headers without this slot keep their layout.