Referans

API Referansı

@motifx/core paketinden dışa aktarılan sembollerin hızlı referansı.

Bu bölüm @motifx/core paketinden dışa aktarılan başlıca sembollerin hızlı referansıdır. Her satır, ilgili ayrıntılı bölüme bağlanır.

Uygulama (Application)

Sembol Tür Açıklama
Application class Uygulama örneği. Application.main ile global örneğe, bileşenden context ile erişilir (sınıfta ve Options'ta this.context, fonksiyon bileşeninde kök bileşenin context'i).
Application.CreateBuilder() static ApplicationBuilder üretir.
ApplicationBuilder class services koleksiyonunu taşır; build() ile Application üretir.
app.run(host, root?) method Uygulamayı bir DOM elemanına bağlar. host bir yorum ya da metin düğümüyse uygulama o düğümün hemen önüne yerleşir, düğüm yerinde kalır; düğümün ebeveyn elemanı yoksa MJX416 fırlatılır. Serbest bırakılmış uygulama run() ile yeniden başlar: Application.main yeniden dolar, servisler ilk istekte yeniden yaratılır (startup: true olanlar hemen), router yapılandırmasıyla yeni bir modül kurulur, useTransitions kipi yeniden uygulanır, bu arada okunmuş bir katman varsa host'tan sonraya taşınır ve dispose() yeniden çalışır. Bu arada yeni bir uygulama kurulduysa MJX405 fırlatılır.
app.useRouter(opts) method Yönlendirmeyi tanımlar.
app.restartRouter(uri?) method Router'ı sıfırdan kurar ve kökten (/) ya da verilen adresten yeniden başlatır: çalışırken yeni bir useRouter yapılandırması verildiyse onu, yoksa mevcut yapılandırmayı kullanır. Rota listesi, keepAlive önbelleği ve yığın sıfırlanır; ekrandaki sayfa ayrılan sayfa gibi ayrılır, yeni sayfa kurulur (onRouterChanged initial: true ile çalışır); adres mevcut geçmiş kaydının yerine yazılır. Açılış gezinmesinin sonucunu döndürür. run'dan önce etkisizdir.
app.connectDocument(doc) method Aynı origin'li başka bir belgeyi (window.open penceresi ya da <iframe>) uygulamaya bağlar: router'ın bağlantı yakalayıcısı ve yığının kaydırma dinleyicileri o belgeye de kurulur. Sayaçlıdır; döndürdüğü fonksiyon bağı çözer, belgenin penceresi pagehide alınca kendiliğinden çözülür, app.dispose() hepsini çözer. Sayfanın kendi belgesi için etkisizdir. Belge olmayan, penceresi olmayan ya da erişilemeyen değer MJX417 fırlatır.
app.windows property Pencere yöneticisi (WindowManager): open(bileşen, seçenekler) bileşeni yeni pencerede ya da kind: "pip" ile hep üstte açar ve AppWindow handle'ı döndürür; create, attach, of, supports, closeAll; list reaktif; olaylar window-opened / window-closed. Bkz: Pencereler.
app.layer property Sayfa katmanı (Component): ilk okunduğunda <body>'nin sonuna, host elemanından sonra düz bir <div> koyar ve onu saran bileşeni döndürür (host <body>'nin kendisiyse ya da katmanı kapsıyorsa katman host'un sonunda kalır, kabuk içeriği onun önüne girer); stil ve öznitelik yazmaz, run()'dan önce de okunur (<body> yoksa belge yüklenince yerleşir; eleman sayfadan çıkarılmışsa içerik ilk yer istediğinde ya da run()'da gövdenin sonuna yeniden konur), app.dispose() içindekilerle birlikte serbest bırakır ve elemanı kaldırır. Bkz: Sayfa katmanı.
app.layerOf(hedef?, ...bileşenler) method Hedefin (bileşen ya da DOM düğümü) belgesinin katmanını döndürür: app.windows penceresiyse host'u, değilse ya da hedef yoksa app.layer; verilen bileşenleri oraya controls.add ile ekler. Ebeveynsiz ve elemanı hiçbir belgede olmayan ilk bileşen hedef değil içeriktir; elemanı bir belgede duran ebeveynsiz kök hedeftir. Bileşen ve düğüm olmayan hedef MJX424 fırlatır.
app.navigate(uri, seçenekler?) / app.navigateByName(name, params?, seçenekler?) method Programatik gezinme; seçenekler router'a iletilir (NavigationOptions). Gezinme sonucunu döndürür (ör. guard iptalinde { ok: false, cancelled: true, reason: 'guard' }).
app.router.navigate(uri, seçenekler?) method Seçenekli gezinme: { replace?, state?, force?, scroll? } (NavigationOptions).
app.router property Uygulama boyunca tek nesne (Router); reaktif, salt okunur rota alanları: params, route, uri, ok, meta, extend, fullPath, aliasOf, chain, direction, state, stack (yalnızca stack açıkken). Bkz: Gezinme ve Rota Durumu.
app.useGuard(guard) / app.use(mw) method Gezinme guard'ı / middleware. Gezinme sonrası için app.onRouterChanged(fn).
app.on/fire/off method Uygulama olay veriyolu. on abonelikten çıkma fonksiyonu döndürür.
app.onRouterChanged(fn) method Her gezinmede (açılış ve 404 dâhil) { uri, params, meta, route, ok, initial, redirectedFrom?, direction, state } ile çalışır.
app.onLifecycle(fn) method Uygulama yaşam döngüsü: { state, visible, online }; state: 'visible' \| 'hidden' \| 'frozen' \| 'resumed' \| 'restored' \| 'online' \| 'offline'. Abonelikten çıkma fonksiyonu döndürür. Bkz: Yaşam Döngüsü.
app.isVisible / app.isOnline property Anlık görünürlük ve bağlantı durumu.
app.router.evict(ad \| rota?) method keepAlive önbelleğindeki örnekleri dispose eder (argümansız: hepsi).
app.router.resolve(uri) / app.router.href(ad, params?) / app.router.routes method / property Gezinmeden eşleşme (RouteResolution: { chain, result }), adlandırılmış rotanın yolu, tanım sırasıyla rota listesi (RouteInfo[]). Bkz: Rota Tablosu.
app.router.scrollPositions() / app.router.restoreScrollPositions(positions) / app.router.saveScrollPositions(fn) method Kaydırma hafızasının konumları ({ "/notes": 1200 }, ekrandaki sayfanınki dahil); verilen konumları hafızaya ekler (run()'dan önce de); kayıt gereken her anda (sayfadan ayrılırken, pagehide, sayfa gizlenince, app.dispose()) fn(positions) çağırır, aboneliği kaldıran fonksiyon döndürür. scrollMemory kapalıyken boş / etkisiz. Bkz: Kaydırma hafızası.
app.useDevelopment(b) / app.useLogging(b) / app.useReactiveMonitor(o) method Geliştirme yapılandırması.
app.dispose() method → Promise<void> app.state'i 'disposing' yapar; router'ı ve yaşam döngüsü dinleyicilerini serbest bırakır, adresi router'ın kipine göre geri alır (history: /; hash/file: yalnız # silinir; shell ve router yok: dokunulmaz) (bunlar senkron olur). Ardından route sayfalarını (leave animasyonlarıyla) ve run()'ın kurduğu kabuğu (RouterView'ı ve run()'a verilen kökü dahil) serbest bırakır, en son servis sağlayıcıyı serbest bırakır ve Application.main'i boşaltır. Ağaç sökülürken her bileşen ve animasyon sırasında çalışan kod aynı servisleri ve context'i görür. Host elemanı sayfada boş olarak kalır. Promise, servislerin async dispose'ları dahil her şey bitince çözülür: await app.dispose(); aynı hayatta ikinci çağrı aynı promise'i döndürür; run() ile yeniden başlatılan uygulamada dispose() yeniden çalışır; bitmiş uygulamada yeniden çağrılırsa o aradan beri kurulan katmanı, pencereleri, belge bağlantılarını ve yeniden yaratılan servisleri serbest bırakır, adrese ve geçiş kipine dokunmaz; bu geçiş sürerken gelen çağrı da aynı promise'i alır.
app.state özellik → ApplicationState 'initializing' (kuruldu), 'running' (run() çağrıldı), 'disposing' (dispose() sürüyor), 'disposed' (run() ile yeniden başlatılabilir). Bir uygulama 'disposing' iken yeni Application.CreateBuilder() kurulabilir; sökülen sayfalar kendi uygulamasının servislerini görmeye devam eder.
useApplication() fn { application, services, router, windows, layer, layerOf, attach }.
useNavigation() fn app.router ile aynı nesne (Router).

Bkz: Başlarken, Yönlendirmeye Giriş.

Bileşenler (Component)

Sembol Tür Açıklama
Component class Somut bileşen sınıfı. super('div') veya super().
ComponentBase class Tüm bileşenlerin temeli.
ComponentMotif class ComponentBase.motif ad alanının tipi; kullanıcı new ile oluşturmaz.
FNComponent(view) fn Fonksiyon görünümünü bileşene sarar.
motifComponent(el, props?) / motifFragment(props?) / motifCompiled(sözleşme) / motifReport(hata) fn Derleyicinin ürettiği koddaki çağrılar (_mc, _mf, _mv, _mr); motifCompiled derleyici sözleşmesi uyuşmazsa geliştirme modunda MJX121 uyarısı verir; motifReport derleyicinin try/catch içine aldığı ifadede (çocuk konumundaki üye çağrısı, ??/|| sol tarafı, && koşulu) yakalanan hatayı MJX208 olarak raporlar, ifadenin geri dönüş değeri değişmez.
motifOptions(nesne) fn Options nesnesini olduğu gibi döndürür; tip tarafında metotlardaki this'i bileşen (ComponentBase & nesne) yapar: this.class, this.motif, this.props strict kipte derlenir ve editör tamamlar. Tipi MotifOptions<T>; el anahtarı zorunlu (undefined/null fragment).
Frame class Tek bir dinamik içeriği tutan/değiştiren fragment kapsayıcı: navigate(page, keepOldControl?) önceki içeriği serbest bırakıp yenisini yerleştirir (dizi de alır), navigateLazy(() => import(...), options?) Lazy ile yükler, flush() içeriği serbest bırakır, current gösterilen içerik, isBusy gezinme sürüyor mu. {() => ifade} çocukları ve when/ternary/switchCase dalları bunun üstüne kuruludur. Bkz: Frame.
ContentBody / ContentBlock class Çok parçalı gövde: <ContentBody name="x"/> gövde, <ContentBlock target="x">…</ContentBlock> parça; birden çok blok aynı gövdede birikir, her blok serbest bırakılınca yalnız kendi parçalarını kaldırır. Bkz: ContentBody ve ContentBlock.
Transport / TransportTo class Bir bileşenin içeriğini ağacı dışındaki adlandırılmış bir yuvada gösterme (ör. sayfa komutlarını layout başlığına taşıma). Bkz: Transport ve TransportTo.
Transporter class Programatik taşıma: Transporter.transport(child, newParent, { index?, keepState?, owner? }), transportMany(children, newParent, options?). Bkz: Transport ve TransportTo.
FragmentNode class Fragment (yorum düğümü) köklü bileşen; motifFragment() ve <>…</> bunu üretir. childs ve props.nodes içeriğe eklenir.
ControlCollection class component.controls'un tipi; new ile oluşturulmaz.
Lazy({ caller, options? }) fn Dinamik import ile tembel içerik (<Lazy caller={() => import('./X')} />; LazyOptions: Loaderview, Placeholderview, Fallbackview, minDelayMs, timeoutMs, signal, onError, mapResult, retry, onRetry). Bkz: Lazy.
Virtualization<T> class Sanal kaydırmalı liste.

ComponentBase başlıca üyeleri

Üye Açıklama
element Gerçek DOM düğümü.
props Bileşen props'u.
controls Alt kontrol koleksiyonu (add(...c)/add(index, ...c)/insert(index, ...c)/remove/clear/clearAsync/detach/silentDetach/silentUnlink/move/moveToIndex/forEach/map/items/length). Bkz: Bileşenler.
context Çalışan Application; üzerinden açılan on/onRouterChanged abonelikleri bileşen serbest bırakılınca kalkar.
class / attr Sınıf ve öznitelik yardımcıları; attr.hold(değerler) bir özniteliği bileşenin kendi değerinin üstünde tutar. Bkz: Eleman ve Görünüş.
bindings Bağ koleksiyonu.
state (kullanıcı tanımlı) Genelde reactive({...}).
view() Bileşenin içeriğini döndüren metot; kökü değil (kök eleman sınıfa bildirilir).
motif Çerçeve işlemlerinin ad alanı (ComponentMotif). Alt sınıf show, on, clear, options gibi adları kendi amacıyla tanımlayabilir; çerçeve yalnız this.motif.* yolunu kullanır.
motif.on/off/trigger/addHandler Olay yönetimi; x: önekli adlar yaşam döngüsü olaylarıdır (x:built, x:mounted, x:disposed…).
motif.isEventFrom(e) DOM olayı bu bileşenin elemanından ya da içinden başladıysa true. Bkz: Olaylar.
motif.show/hide/toggle Görünürlük.
motif.options Bileşen ayar nesnesi (transition, hideStrategy, disableDisposal, chunk).
motif.stopAnimations() Süren CSS sınıf geçişini bitirir, WAAPI animasyonlarını iptal eder.
isWait Bekletme (x-wait karşılığı; yazılabilir).
isBuilt / isInitialized / isConfigured / isVisible / isDisposed Durum bayrakları.
parent / childs Ebeveyn bileşen / etiket arasına yazılan JSX çocukları.
using(promise, onfulfilled?, onrejected?) / doWork(promise) Serbest bırakma sonrası güvenli asenkron sonuç işleme. Bkz: using, doWork.
dispose/disposeAsync Serbest bırakma.
motif.clear() İçeriği (çocukları) serbest bırakır.
motif.register/setDisposable Kaynak kaydı.
getService(token) DI çözümleme.
useModel(model) Reaktif model üretir.
style(...) / setText(...) Yardımcılar.
siblings all/next/prev/nextAll/prevAll.
$(selector) fromDom() / fromComponent() sorgu.

Yaşam döngüsü kancaları

onInitializing, onInitialized, onConfig, onConfigured, onBuilding, initializeComponent, oninitializeComponent, onBuilt, onMounted, onVisibilityChanged, onActivated, onDeactivated, onDisposing, onDisposed.

onRefCreated(sender): sınıfın view()'ındaki her ref={this.x} / ref={ad} uygulandıktan sonra çağrılır (sender ref verilen bileşen); geri çağırım biçimindeki ref için çağrılmaz. Bkz: Bileşenler.

Bkz: Bileşenler, Yaşam Döngüsü.

Reaktivite (store)

Sembol İmza Açıklama
reactive(model) <T>(m: T) => T Reaktif proxy.
useModel(model) <T>(m: T) => T reactive eş adı.
createSignal(v) <T>(v: T) => Signal<T> Tek değer signal'i.
createComputed(fn) <T>(fn) => Computed<T> Türetilmiş değer; kurulumda ve her değişimde hesaplanır.
createLazyComputed(fn) <T>(fn) => LazyComputed<T> Tembel türetilmiş değer; değişimde kirli işaretlenir, okunduğunda hesaplanır (value, peek, isDirty, dispose).
createSelection(fn) <T>(fn: () => T) => KeySelection<T> Anahtarlı seçim: isSelected(key) onu çağıran bağı yalnız o anahtara abone eder; kaynak değişince yalnız eski ve yeni değerin bağları uyanır. dispose() izlemeyi bırakır. Bkz: Reaktivite.
asReadonly(obj) <T>(o: T) => DeepReadonly<T> Canlı salt-okunur görünüm; okumalar izlenir, yazma ve değiştiren metotlar MJX212 fırlatır. Bkz: Reaktivite.
isReadonly(v) (v: unknown) => boolean Değer asReadonly ile alınmış bir görünümse true.
effect(fn, onValue?) (fn, cb?) => () => void Yan etki; durdurucu döner. onValue her koşudan sonra fn'in dönüş değerini alır, içindeki okumalar izlenmez.
asyncTracking nesne Derleyicinin Virtualization dataRequest içindeki await'leri sarmak için kullandığı çalışma zamanı yardımcısı (capture/suspend/resume/end); elle çağrılmaz. Bkz: Reaktivite.
untracked(fn) <T>(fn: () => T) => T İzlemesiz bölge; fn'in dönüş değerini verir. İçindeki effect çağrıları normal izler.
deepClone(v) (v) => v Derin kopya.
clearModel(m) (m) => void Reaktif kaydı temizle.
Signal<T> / Computed<T> / LazyComputed<T> class İnce taneli ilkeller.

Bkz: Reaktivite.

Bağlar (bindings) — component.bindings

Metot Açıklama
add(prop, source, member?, format?, formatInfo?) Tek yönlü bağ. formatInfo: { locale?, currency? }.
model(source, member?, format?, formatInfo?) İki yönlü bağ (eleman türüne göre).
model(getter, setter) Fonksiyonlarla iki yönlü bağ; x-model buna derlenir.
writeModel(value) Değeri bileşendeki model/x-model bağlarına geri yazar; yazdıysa true (bkz. Formlar).
text(fn) / value(fn) textContent / value bağı.
when(condFn, renderFn) Koşullu içerik; dal koşulun değeri değişince (Object.is, iki yanlış değer aynı sayılır) yeniden kurulur.
ternary(condFn, trueFn, falseFn) İki dallı koşul; dal koşulun değeri değişince (Object.is) yeniden kurulur.
list(itemsFn, renderFn) / loop(...) Liste; satırlar öğe nesnesiyle eşleşir.
switchCase(discFn, cases, defaultFn?) Çoklu dal.
method(fn) Reaktif metin/tek içerik.
watch(fn) Otomatik temizlenen izleyici.
wait(fn) / display(fn) / html(fn) Bekletme / görünürlük / innerHTML.
remove(binding) Bağı koleksiyondan çıkarır ve devre dışı bırakır.

Bkz: Koşullu Gösterim ve Listeler, Formlar ve İki Yönlü Bağlama.

Bağımlılık enjeksiyonu

Sembol Açıklama
ServiceCollection Kayıt koleksiyonu (addSingleton/addScoped/addTransient, tryAdd*, replace, remove, has).
ServiceProvider Çözümleyici: get(token) senkron, getAsync(token) async fabrika/Promise kayıtları için, createScope(ad?) alt kapsam, enableAutoDisposeTransients() alt kapsamdaki transient'ları kapsamla serbest bırakır, getAllServices() koleksiyon, dispose(). Bkz: Servis Çözümleme, Servislerin Serbest Bırakılması.
@Injectable(opts?) Sınıfı otomatik kayıt için işaretler; deps yapıcı parametrelerini sırayla verir, startup: true singleton'ı app.run() içinde oluşturur. Standart (TC39) sınıf dekoratörüdür.
inject(token) Sağlayıcının kurduğu sınıfın alan başlatıcısında veya yapıcısında bağımlılığı çözer; dönüş tipi token'dan gelir.
FromService(token) Uygulamanın sağlayıcısından hızlı çözümleme; dönüş tipi T | null: çözümlenemezse null döner ve geliştirme modunda MJX414 uyarısı verir. Kayıtlı olduğundan eminseniz FromService(X)! yazın.
ServiceLifetime 'transient' \| 'singleton' \| 'scoped'.

Bkz: Bağımlılık Enjeksiyonuna Giriş.

Yönlendirme

Sembol Açıklama
RouteItem Rota tanımı tipi (control ya da redirect'ten biri zorunlu).
RouteRedirect / RedirectTarget redirect değeri (string \| (to) => string) ve fonksiyona geçen { path, params, meta }.
RouterView Rota çıktısı yuvası (name?).
RouterLink Aktif/eşleşme sınıflı bağlantı bileşeni (varsayılan eleman <a>). Prop'lar: to, el, activeClass, exactClass, onActive/offActive, onExact/offExact, showHref, target, text, bypass (tıklamayı tarayıcıya bırakır). Bkz: Bağlantılar.
NavigationDirection 'initial' \| 'push' \| 'replace' \| 'back' \| 'forward' \| 'traverse'.
StackOptions useRouter({ stack }) ayarları: retain, depth, persist, animation, duration, swipeBack.
StackEntryInfo app.router.stack öğesi: { index, uri, current, retained }.
RouteInfo app.router.routes öğesi: { fullPath, name, meta, route, chain }.
StackTransitionContext Özel yığın animasyonuna gelen { direction, entering, leaving }.
ScrollMemoryOptions scrollMemory ayarları; container ile kap kaydırması.

Ayrıca rel="router" özniteliği ile standart <a> bağlantıları yönlendirmeye dahil edilir.

Bkz: Yönlendirmeye Giriş.

Serbest bırakma (disposable)

Sembol Açıklama
IDisposable { dispose(): void }.
Disposable Serbest bırakılabilir nesnelerin temel sınıfı (ComponentBase bundan türer); dispose().
DisposableStore Grup temizliği (add, delete, detach, clear, dispose, isDisposed).
disposableCore.toDisposable(fn) / toDisposable(fn) Fonksiyonu IDisposable'a sarar.
disposableCore.disposableTracker Canlı bileşen sayımı için izleyici kancası (IDisposableTracker).

Bkz: Bellek Yönetimi ve Serbest Bırakma.

Ortak (common) yardımcılar

Sembol Açıklama
dom DOM oluşturma yardımcıları: createElement(tag, options?) (etiket başına şablon eleman önbelleğe alınır ve klonlanır; options yalnız ilk oluşturmada geçer; 'text' metin düğümü verir; document yoksa MJX101), createElementNS(ns, tag, options?) (hata MJX103), createDocumentFragment(), createComment(metin), createTextNode(metin), querySelectorAll(seçici), convertToSvgElement(el) (elemanı SVG ad alanında yeniden oluşturup yerine koyar), window, document, body.
List, Dictionary, LinkedList Koleksiyon yapıları. Bkz: Koleksiyonlar.
Query<T> / Query.from(kaynak) / Group<TKey, T> Zincirlenebilir sorgu sarmalayıcısı (where, select, orderBy, groupBy, first, any, aggregate, toArray …). Bkz: Koleksiyon Sorguları (Query).
NameValuePair<K, V> { Key, value } çifti (Dictionary öğesi). Bkz: Koleksiyonlar.
NodeTypes Düğüm türü sabitleri (enum).
Emitter<T> Tipli olay yayıcı: emitter.event(listener, thisArgs?, disposables?) abone olur ve IDisposable döndürür, fire(value) yayınlar, dispose() kapatır. Dinleyici hatası setUnexpectedErrorHandler'a gider. Bkz: Hata Yönetimi.
JSX JSX tip ad alanı (JSX.Element, JSX.IntrinsicElements); derleyici jsx-runtime için kullanır.
preProcessing(fn) Geri çağrıyı kalıcı bir listeye ekler ve listedeki bütün geri çağrıları hemen çalıştırır; stil enjeksiyonu gibi tek seferlik kurulumlar için.
safeCall, safeCallAsync, safeCallSilent Hata-güvenli çağrı yardımcıları.
errorHandler / setUnexpectedErrorHandler(fn) Merkezî hata yöneticisi. errorHandler.addListener(fn) çerçevenin raporladığı her hatayı MotifError olarak alır. setUnexpectedErrorHandler(fn) yalnız kodsuz beklenmeyen hataları alır (safeCall/safeCallAsync içinde ve Emitter dinleyicilerinde yakalananlar; bunlar addListener dinleyicilerine de olduğu gibi gider); varsayılanı hatayı setTimeout ile yeniden fırlatır. Kodlu raporlar (MJX122, MJX123, MJX208 …) ona gitmez. Bkz: Hata Yönetimi, Hata ve Uyarı Kodları.
MotifError / MotifErrorCode Çerçevenin fırlattığı ve raporladığı hataların sınıfı; code ("MJX302" gibi) ve [motifjs] MJX302: … biçiminde İngilizce mesaj taşır, varsa asıl hata cause'dadır.
TransitionProps Geçiş yapılandırması arayüzü (tip).
Bind<T> / toGetter(v) / read(v) Prop sözleşmesi: T \| (() => T); toGetter canlı okuma için getter'a çevirir, read anlık değeri verir.
Resilience Dayanıklılık yardımcıları: Resilience.create.retry(...).timeout(...).execute(fn) (ayrıca circuitBreaker, bulkhead, rateLimiter, fallback). Hataları MJX602–MJX605. Bkz: Dayanıklılık (Resilience).
decorate(policy, fn) Bir dayanıklılık politikasını fonksiyona sarar: (ctx?) => policy.execute(fn, ctx).
ErrorHandler errorHandler örneğinin sınıfı: report(err), addListener(fn), setDevelopmentMode(b), setConsoleLogging(b), isDevelopment(), safeCall/safeCallSilent/wrapSafe/wrapSafeAsync.

Tipler

Değer taşımayan, yalnız import type ile alınan dışa aktarımlar. Davranışları ilgili bölümde anlatılır; burada ad ve biçimleri toplanmıştır.

Tip Biçim / Açıklama Bkz.
IBaseProp<TProps> Her bileşen yapıcısının kabul ettiği ortak prop'lar: TProps + childs, options, onElementCreating, initializeComponent, yaşam döngüsü kancaları (onConfig, onBuilt, onMounted, onActivated …); diğer anahtarlar serbesttir (ref, key, transition burada ayrıca tiplenmez). Bileşenler, Yaşam Döngüsü
MotifBaseProps / MotifBindable<T> / MotifValue<T> / MotifClass / MotifStyle JSX öznitelik tipleri: değer ya da getter kabul eden class/style/öznitelik biçimleri. JSX ve Şablonlar
Bind<T> T \| (() => T); prop sözleşmesi. JSX ve Şablonlar
ComponentBaseOptions<TProps> motif.options nesnesinin tipi: transition (API), enableRouterClassing (setter), hideStrategy, disableDisposal, chunk, props, getInstance(), hasEvent(ad). Yaşam Döngüsü, Stil ve Animasyon
RouterClassingSettings { to, path, activeClass?, exactClass?, onActive?, offActive?, onExact?, offExact? }. Bağlantılar
TransitionProps / TransitionMode / CSSTransitionInfo Geçiş sınıf adları ve süresi / 'concurrent' \| 'out-in' \| 'in-out' / elemanın hesaplanmış geçiş bilgisi. Stil ve Animasyon
IDisposeOptions { deep?, skipLeaveTransition? } — dispose() seçenekleri. Yaşam Döngüsü
IDisposable / IDisposableTracker { dispose() } / disposableCore.disposableTracker kancası. Bellek Yönetimi ve Serbest Bırakma
IBaseBinding bindings.add(binding) ile kaydedilen bağ nesnesinin biçimi: propertyName, dataSource, activate(), deactivate(), reActivate(). Bileşen Kütüphanesi Yazmak
EventArgs { cancel: boolean } — kanca ve motif.trigger olay nesnesi. Yaşam Döngüsü
VisibilityChangedEventArgs EventArgs + visible: boolean — onVisibilityChanged argümanı; visible yeni durumdur. Yaşam Döngüsü
HtmlElementEvents / AnyEvents motif.on olay adlarının tipi: DOM olay adları değiştiricileriyle ('click:once:prevent') ve x: yaşam döngüsü adları. Olaylar
ElementType / IElement / IHtmlElement Component<TElement> generic'inin kabul ettiği eleman tipleri. Bileşenler
MotifComponentType / MotifComponentConstructor / MotifFunctionalComponent / MotifFunctionalComponentBasic / AnyFunctionalComponent Sınıf, yapıcı ve fonksiyon bileşeni tipleri (JSX etiket tipleri için). Bileşenler
EffectFn / AsyncTrackingToken effect fonksiyon tipi / asyncTracking belirteci. Reaktivite
ReadonlySignal<T> asReadonly() görünümü: value, peek(). Reaktivite
KeySelection<T> createSelection dönüşü: (key: T) => boolean ve dispose(). Reaktivite
DeepReadonly<T> asReadonly dönüş tipi: alanlar, dizi elemanları, Map ve Set içeriği iç içe salt-okunur. Reaktivite
AppLifecycleState / AppLifecycleEventArgs 'visible' \| 'hidden' \| 'frozen' \| 'resumed' \| 'restored' \| 'online' \| 'offline' / { state, visible, online }. Yaşam Döngüsü
RouteItem / RouteItemBase / RouteControl / RouteRedirect / RedirectTarget Rota tanımı ve parçaları. Rota Tablosu
RouterOptions / RouterEvents useRouter({...}) nesnesi / genel kancalar { onEntering?, onEnter?, onLeave?, onUpdate? }. Yönlendirmeye Giriş
WindowOptions / AppWindow / WindowClosedResult / WindowClosingEventArgs / WindowCloseReason app.windows.open seçenekleri, dönen handle, kapanış sonucu { returned, disposed, kept }, onClosing kancasının aldığı { window, components, reason } ve nedenin türü. Pencereler
Router / RouteInfo / RouteResolution / ResolveResult / RouterViewProps app.router nesnesi / routes öğesi / resolve() sonucu ({ chain: string[], result: ResolveResult }) / gezinme ve eşleşme sonucu / RouterView prop'ları (name?). Gezinme ve Rota Durumu
NavigationOptions / NavigationDirection / NavigationGuard / NavigationGuardContext Gezinme seçenekleri / yön / guard imzası (ctx, next) => void / { to, from }. Rota Kancaları ve Guard'lar
RouterNavigatedEventArgs onRouterChanged yükü: { uri, params, meta, route, ok, initial, redirectedFrom?, direction?, state? }. Rota Kancaları ve Guard'lar
RouterValidateEventArgs validate(e) argümanı: { uri, key, routes, params }. Rota Tablosu
RouteResolveContext Middleware bağlamı: { uri, context, rewritePath(uri) }. Rota Kancaları ve Guard'lar
ScrollMemoryOptions / StackOptions / StackSwipeBackOptions / StackEntryInfo / StackTransitionContext Kaydırma hafızası ve yığın gezinmesi ayarları. Gezinme ve Rota Durumu, Yığın Gezinmesi
ServiceLifetime / ServiceDescriptor 'transient' \| 'singleton' \| 'scoped' / kayıt tanımı (token, lifetime, useClass/useValue/useFactory, deps, startup). Servis Kaydı
LazyOptions<T> / LazyRetryOptions Lazy seçenekleri / { count, delayMs?, whenOnline? }. Lazy
RetryOptions / TimeoutOptions / CircuitBreakerOptions / BulkheadOptions / RateLimiterOptions / FallbackOptions<T> Resilience politika seçenekleri. Dayanıklılık (Resilience)
ResiliencePolicy / ResilienceAction<T> / ResilienceContext / CircuitState { execute(action, ctx?) } arabirimi (Resilience uygular, decorate kabul eder) / (ctx?) => T \| Promise<T> / serbest bağlam nesnesi / 'CLOSED' \| 'OPEN' \| 'HALF_OPEN'. Dayanıklılık (Resilience)
TransportOptions Transporter.transport seçenekleri { index?, keepState?, owner? }. Transport ve TransportTo
VirtualizationProps<T> / VirtualizationDataRequest / VirtualizationDataResponse<T> / VirtualizationState<T> Sanal liste prop'ları, istek/yanıt ve durum nesneleri. Sanal Listeler (Virtualization)
MotifErrorCode Bütün MJX kodlarının birleşimi. Hata Yönetimi
Group<TKey, T> Query.groupBy öğesi { key, items }. Koleksiyon Sorguları (Query)
Event<T> Emitter.event'in tipi: (listener, thisArgs?, disposables?) => IDisposable. Olaylar
JSX JSX tip ad alanı. JSX ve Şablonlar
__attr, CustomParameters, IsOptional, OptionalParams, IAttribute, IClass Tip yardımcıları ve attr/class yardımcılarının arayüzleri; doğrudan kullanılmaz. —

Geliştirici araçları

Sembol Açıklama
app.useReactiveMonitor(o) / configureReactivityLeakMonitor(o) Reaktif bağımlılık uyarıları: { enabled, threshold, name } sızıntı gözlemcisi (bir alanı izleyen effect sayısı threshold'a ulaşınca MJX507), dependencies bir effect'in tek koşuda toplayabileceği bağımlılık eşiği (varsayılan 1000, aşılınca MJX209; 0 kapatır); scans aynı listeyi aynı bileşen türünün birden çok örneğinin taramasını çalışma anında yakalayan MJX210 denetimi (varsayılan açık, false kapatır).
debugGetDeps(hedef) / debugGetDepMap() Reaktif bağımlılık haritaları; @motifx/core/devtools alt yolundan: import { debugGetDeps } from "@motifx/core/devtools".
registerDevtools(ad, { describe?, inspect? }) Bir paketin kendi durumunu DevTools'a açması; @motifx/core/devtools alt yolundan. { emit, pathOf, dispose } döndürür (DevTools sözleşmesi).
MotifDevtools, DevtoolsEvent globalThis.__MOTIF_DEVTOOLS__ nesnesinin ve olaylarının tipleri; @motifx/core/devtools alt yolundan (DevTools sözleşmesi).
DevtoolsTreeNode, DevtoolsPath, DevtoolsResult, DevtoolsComponentRef, DevtoolsStoreHolder, DevtoolsExtension, DevtoolsExtensionHandle Sözleşmenin parça tipleri: ağaç düğümü, yol, yazma sonucu, bileşen başvurusu, store tutucusu, eklenti kaydı ve kaydın döndürdüğü nesne; @motifx/core/devtools alt yolundan.
nameModuleStore Derleyicinin geliştirme derlemesinde modül store'larını adlandırmak için ürettiği çağrı; elle çağrılmaz (DevTools sözleşmesi).

JSX özel öznitelikleri

JSX'siz yazımda bu özniteliklerin karşılıkları props nesnesinin anahtarları ve bileşenin çağrılarıdır (bkz. Props nesnesinin anahtarları).

Öznitelik Açıklama
class / className Sınıf (string/dizi/nesne/getter).
style / x-style Stil.
on<event> DOM olayı (:once, :prevent, :stop, :capture, :passive, :self, :trusted).
on:ad / on-ad / on_ad İşleyiciyi olduğu gibi motif.on("ad", fn) ile bağlar (DOM ve özel olaylar; yalnız önek atılır, on-my-event → my-event); parametre sayısı ≤ 1 → fn(event), 2+ → fn(sender, event).
ref / x-ref Etiketin bileşen örneğini yakala: ref={(c) => …} ya da ref={this.alan} (fonksiyon bileşeninde ref={alan}), her etikette, tam bir kez; ikisi aynı etikette birlikte yazılırsa kaynaktaki sırayla çalışır. Yalnız verildiği bileşende çalışır (fonksiyon bileşeninde döndürülen kök); props'ta ve this.props'ta yer almaz. İçteki bir öğe için ayrı bir prop adı kullanın (ör. inputRef).
initializeComponent Etiketin bileşeniyle kurulumda bir kez çağrılır (düz DOM, sınıf ve fonksiyon bileşeni etiketinde aynı; fonksiyonda döndürülen kök). Derleyicinin ürettiği kurulum koduyla birlikte çalışır.
oninitializeComponent Bütün initializeComponent kodundan (sınıf metodu, etiketteki değer, derleyicinin ürettiği) hemen sonra, view()'den önce çağrılır. Sınıf metodu ya da etiket prop'u olarak yazılır; fonksiyon bileşeninde döndürülen köke uygulanır.
x-html Reaktif innerHTML.
x-wait / x-display / x-chunk Bekletme / görünürlük / çocukları dilim dilim kurma (x-chunk: karede kurulacak sayıyı kare süresi belirler; x-chunk={50}: ilk turda 50, sonra her karede en az 50 çocuk).
key Liste öğesini tanımlar; geliştirme modunda yinelenmeye karşı denetlenir (MJX202). Satır eşleşmesi öğe nesnesiyle yapılır, key DOM'un yeniden kullanımını değiştirmez.
transition Giriş/çıkış geçişi (string veya TransitionProps).
on<lifecycle> / x-<lifecycle> / x:<lifecycle> Yaşam döngüsü kancaları; aynı etikette birden çok yazım birleşir, hepsi kaynaktaki sırayla çalışır.
options={{ hideStrategy, disableDisposal, chunk }} Bileşen ayarları; motif.options'a kopyalanır (düz DOM etiketinde de; öznitelik yazılmaz). Bkz: Yaşam Döngüsü.
Metot adlı öznitelikler focus, blur, click, select, scrollTo/scrollBy/scrollIntoView, show, showModal, close, showPopover, hidePopover, togglePopover, requestSubmit, checkValidity, reportValidity, showPicker, load, setSelectionRange, setRangeText, setPointerCapture, releasePointerCapture, fastSeek … elemanın aynı adlı metodunu çağırır, öznitelik yazılmaz; getter verilirse her değişimde yeniden çağrılır. show/showModal/showPopover true ile açar, false ile kapatır (close()/hidePopover()); togglePopover boolean'ı iletir; close, requestSubmit, load gibi metotlar doğru (truthy) değerde çağrılır; setSelectionRange gibi argümanlı metotlar değeri argüman olarak alır (dizi → argüman listesi).

Bkz: JSX ve Şablonlar.

Hata ve uyarı kodları

Bütün MJX kodları, konsoldaki mesajları ve anlamları Hata ve Uyarı Kodları sayfasındadır.

Sonraki adım

Kodların tam listesi için Hata ve Uyarı Kodları bölümüne geçin.