ErdEditorElement

Editorea HTMLElement arrunt bat da, @dineug/erd-editor/erd-editor.js inportatzean definitzen den <erd-editor> etiketa.
5.0.0 bertsiotik aurrera, paketearen erroa inportatzeak ez du etiketarik definitzen. Erroak ErdEditorElement esportatzen du elementuaren mota eta klase gisa, eta defineErdEditor(), deitzen duzun tokian etiketa definitzen duena; ikus Elementuak erregistratzea.
Diagrama bat erakutsi baino ez duen orri baterako, <erd-viewer> irakurtzeko soilik dagoen elementu bereizia da.

import '@dineug/erd-editor/erd-editor.js';

const editor = document.createElement('erd-editor');

Haren mota-definizioa honako hau da.

interface ErdEditorElement extends HTMLElement {
  readonly: boolean;
  systemDarkMode: boolean; // system dark/light auto
  enableThemeBuilder: boolean;
  enableLocalePicker: boolean;
  enableWelcomeScreen: boolean;
  value: string;
  readonly runtimeValue: string;
  focus: () => void;
  blur: () => void;
  clear: () => void;
  destroy: () => void;
  setInitialValue: (value: string) => void;
  setPresetTheme: (themeOptions: Partial<ThemeOptions>) => void;
  setSystemAppearance: (appearance: 'dark' | 'light' | null) => void;
  setTheme: (theme: Partial<Theme>) => void;
  setLocale: (locale: LocaleOption) => void;
  setSystemLocale: (locale: string | null) => void;
  setKeyBindingMap: (
    keyBindingMap: Partial<
      Omit<
        KeyBindingMap,
        | 'edit'
        | 'stop'
        | 'undo'
        | 'redo'
        | 'zoomIn'
        | 'zoomOut'
        | 'zoomReset'
      >
    >
  ) => void;
  setSchemaSQL: SetSchema;
  setSchemaGraphQL: SetSchema;
  setSchemaDBML: SetSchema;
  setSchemaAML: SetSchema;
  setSchemaJSON: (
    value: string,
    options?: { mode?: 'replace' | 'append' }
  ) => void;
  getSchemaSQL: (
    databaseVendor?: DatabaseVendor,
    options?: SchemaSQLOptions
  ) => string;
  getSharedStore: (
    config?: SharedStoreConfig & {
      mouseTracker?: boolean;
      focusTracker?: boolean;
    }
  ) => SharedStore;
  setDiffValue: (value: string) => void;
}

Editorea shadow root itxi batean errendatzen da; beraz, editor.shadowRoot balioa null da, eta estiloak ez dira ez orritik barrura sartzen, ez barrutik kanpora ateratzen.
Barruko ezer ezin da hautatzaile batekin atzitu; horren ordez, eman estiloa setTheme metodoaren eta --erd-editor-* propietate pertsonalizatuen bidez.

readonly, system-dark-mode, enable-theme-builder, enable-locale-picker eta enable-welcome-screen dira atributu bakarrak, eta bostek false balioa dute lehenespenez. Azken biak 4.0.0 bertsioan berriak dira. Bakoitzak bere balioa readonly atalean azaltzen den bezala irakurtzen du.

4.1.0 bertsiotik aurrera, ERD fitxak Arakatzailea du: diagramaren zuhaitz bat, oihalaren ezkerraldean kokatua, goialdean Bilatu eta ordeztu duela. Ez dago hura ireki, itxi edo haren egoera jakinarazten duen atributu, propietate, metodo edo gertaerarik: tresna-barrako Explorer botoitik irekitzen da, Bilaketa azkarreko edo oihalaren laster-menuko Toggle Explorer aukeratik, edo findReplace tekla-konbinazioarekin.
Elementu bakoitza Arakatzailea itxita duela hasten da. Irekita dagoen ala ez, haren zabalera, tolestea eta bilaketa elementuak irauten duen artean mantentzen dira, fitxa-aldaketetan eta karga guztietan zehar, setInitialValue barne, eta ez daude inoiz ez value balioan, ez runtimeValue balioan, ez desegite-historian, ez biltegi partekatu batean.

4.2.0 bertsiotik aurrera, taulek eta zutabeek izen logikoak izan ditzakete beren izenen ondoan, eta Izenen ikuspegiak, fitxa bezalako dokumentu-ezarpen batek, erabakitzen du oihalak haien izenak, izen logikoak edo biak marrazten dituen.
Tresna-barrak Hiztegia fitxa ere badu, Code Generator eta Settings artean, dokumentuaren hitzak, terminoak eta domeinuak eta Checks orri bat dituena. Beste fitxak bezalako fitxa bat da: haren canvasType balioa, '@dineug/erd-editor/builtin-dictionary', Canvas Type blokeoak gordetzen du; beraz, fitxa horretan gordetako testu bat fitxa horretan irekitzen da setInitialValue metodoaren bidez, eta fitxa horretara aldatzea value balioan idazten da eta change igortzen du blokeo hori desaktibatuta dagoen bitartean soilik. Ez dago hura irekitzen duen edo haren egoera jakinarazten duen atributu, propietate, metodo edo gertaera propiorik. Haren edizioak dokumentu-aldaketak dira: value balioan daude, change igortzen dute eta lankideengana iristen dira, baina haien desegitea eta berregitea orri bakoitzaren historia propioan egiten dira, ez dokumentuarenean.
Fitxan zauden tokia — zein orri erakusten den, hasieran Domains, eta orri bakoitzaren bilaketa, hautapena, korritzea eta zutabe-zabalerak — elementuak irauten duen artean mantentzen da, fitxa-aldaketetan eta karga guztietan zehar, eta ez dago inoiz ez value balioan, ez runtimeValue balioan, ez desegite-historia batean, ez biltegi partekatu batean.
ErdEditorElement interfazeak ez du kide berririk. APIak gehitzen dituenak hauek dira: getSchemaSQL metodoaren aukeretako logicalNameAsComment, hamabi gai-token eta dictionaryRowChords esportazioa.

readonly

Editorearen edizio-gaitasuna ezartzen du.
Ezarrita dagoen bitartean, value esleitzea, clear(), setSchemaSQL(), setSchemaGraphQL(), setSchemaDBML(), setSchemaAML(), setSchemaJSON(), desegitea eta berregitea, 4.2.0 bertsiotik aurrera Hiztegia fitxako orri batenak barne, ez dira kontuan hartzen, eta change gertaera ez da inoiz igortzen. Horren ordez, kargatu dokumentua setInitialValue metodoarekin.
5.0.0 bertsiotik aurrera, irakurtzeko soilik dagoen editorea irakurle bat da, ez kontrolak desgaituta dituen editore bat. Bere sei fitxak, Arakatzailea, minimapa, bilaketa azkarra, Taularen propietateak, Diferentzia-ikustailea, Export, zen modua eta lankideen kurtsoreak, fokuak eta hautapenak mantentzen ditu, eta diagrama editatuko lukeen kontrol oro desgaituta marraztu beharrean kanpoan uzten da. 5.0.0 bertsioa baino lehen, haren edizio-kontrol asko marrazten ziren oraindik, eta editoreak haiek bidalitakoa baztertzen zuen.

ERD fitxan, arrastatze batek mugitzen du ikuspegia hasten den tokian hasita ere, baita taula batean ere, eta sakatzeak ez du ezer hautatzen, mugitzen edo irekitzen. Erakusleak taula baten gainean geldi egoteak haren erlazioak pizten ditu, taula edo erlazio baten gaineko klik geldi batek argi hori mantentzen du, eta beste edozein tokitan egindako klik geldi batek itzali egiten du, <erd-viewer> elementuan bezala. Hautapen bakarra jauzi batek uzten duen ingerada da: Arakatzaileko errenkada batera, haren Bilatu emaitza batera edo #, @ edo : ondorengo bilaketa azkarreko emaitza batera joateak iristen den elementua hautatzen du, eta hurrengo klik geldiak garbitu egiten du. Kopiatzeak hautapen horrek dakarrena kopiatzen du.
Oihaleko tresna-barrak Zoom out, zoom maila (Reset zoom), Zoom in, Izenen ikuspegiaren zerrenda, Zen Mode eta iparrorratza mantentzen ditu, Hand edo Select gabe, New Table, New Memo edo New Table Group gabe, eta erlazio-botoirik gabe. Oihalaren menuak View Option, Name View, Export eta Diff Viewer mantentzen ditu, taularen menuak Table Properties mantentzen du, eta ohar batek, erlazio batek edo taula-talde batek ez du menurik irekitzen. ERD fitxako bilaketa azkarrak ez du diagrama idazten duen errenkadarik zerrendatzen: Tab, Name View, Database, Export, Toggle Explorer, enableThemeBuilder eta enableLocalePicker aukerek aktibatzen dituzten Theme eta Display Language errenkadak, eta #, @ eta : bilaketak mantentzen ditu. Beste fitxetan, editore editagarri batean zerrendatzen duena zerrendatzen du. Tresna-barrak datu-basearen izena testu gisa erakusten du, eta ez du Undo, Redo edo Time Travel botoirik.
Ezerk ez du eskaintzen Import, Import and Add, Auto Layout, taula-talde baten errenkada (ikus Taula-taldeak) edo Map Columns, eta ez da ongietorri-pantailarik erakusten.
Gehitzen, kentzen edo editatzen duten tekla-konbinazioek ez dute ezer egiten: edit, addTable, addColumn, addMemo, addTableGroup, groupSelectedTables, removeTable, removeColumn, removeSelection, primaryKey, selectAllTable, selectAllColumn, lau erlazio-konbinazioak eta handTool, bakoitza bere aukerak dioen bezala prebenituta. Itsasteak eta Tab teklak ere ez dute ezer egiten, eta prebenitu gabe iristen dira orrira. Zoom-konbinazioek, zenMode, focusView, jauzi batek hautatutako taulako tableProperties, search, findReplace, kopiatzeak, Escape teklak eta gezi-teklek lanean jarraitzen dute. Ez da irekitzen gelaxka, ohar edo taula-talde izenen editorerik, eta ez da erlaziorik marrazten.

Arakatzailearen goialdeko Bilatu eta ordeztu funtzioak bilatu baino ez du egiten, Toggle Replace gezirik eta Ordeztu errenkadarik gabe. Panelaren izenburua Explorer da, eta tresna-barrako botoiaren argibideak Explorer (Ctrl + F) (Windows/Linux) edo Explorer (⌘ + F) (Mac) dio editore guztietan. Arakatzailea 4.1.0 bertsiotik irekitzen da irakurtzeko soilik dagoen editore batean; 3.10.0 bertsiotik 4.0.0 bertsiora arte, Bilatu eta ordeztu bilatzeko soilik zen panel flotatzaile gisa irekitzen zen bertan, Find izenburuarekin.
Taularen propietateak taularen menutik edo tableProperties tekla-konbinaziotik irekitzen da, eta 3.10.0 bertsiotik aurrera Read only etiketa erakusten du izenburuaren ondoan, eta haren Indexes fitxak ez du ediziorik eskaintzen. Ikus Taularen propietateak.
Ezarpenak fitxak Read only etiketa bera darama, eta ezarpen guztiak sakatzen ez den kontrol batean erakusten ditu: bere bi etengailuak, Maximum comment width eremua eta zazpi Lock botoiak desgaituta daude, eta Column Order errenkadak ez dira arrastatzen. SQL eskema fitxako Before tables eta After tables scriptetan ezin da idatzi. Bisualizazioa fitxak editore editagarri batean bezala funtzionatzen du, han ezerk ez baitu dokumentua editatzen; Fluxuan, Previous table eta Next table botoiekin edo desegiteko eta berregiteko teklekin urratsez urrats mugi daiteke oraindik.
Hiztegia fitxa irekitzen da oraindik: orri batetik bestera alda daiteke, eta orrietan bila, hauta eta korri daiteke, baita haietatik kopiatu ere, eta Checks orriko errenkada batek izendatzen duen elementura eramaten du oraindik. Gelaxka batek ere ez du onartzen ez ediziorik, ez itsasterik, ez garbitzerik; fitxak ez du Add Row, Delete Rows, Import CSV edo Export CSV tresnarik erakusten, ezta saretaren gaineko menurik ere, eta haren errenkaden tekla-konbinazioek ez dute ezer txertatzen edo ezabatzen. Taularen menuak, oihalaren menuak eta Bilaketa azkarrak ez dute Derive Physical Names Again edo Derive Physical Name Again aukerarik eskaintzen.

5.0.0 bertsiotik aurrera, irakurleak oraindik alda ditzakeen ezarpenak editore horren pantailan geratzen dira: korritzea eta zooma, fitxa, datu-basea, Kode-sortzailearen lengoaia, bi izenen idazkerak, mugatzaile mota, View Option errenkadak eta Izenen ikuspegia haren hautatzaile bakoitzetik, hau 4.2.0 bertsiotik geratzen da pantailan. Haien blokeoek zer esaten duten axola gabe, ezertik ez da iristen value, runtimeValue, json esportazio, desegite-historia, change gertaera edo biltegi partekatu batera; beraz, value balioak dokumentuaren ezarpenak mantentzen ditu, irakurleak nola begiratzen duen axola gabe. SQL eskema eta Code Generator aukera-panelek ezarpen horiek This window only gisa izendatzen dituzte readonly ezarrita dagoen bitartean, editore editagarri batean Saved in the document irakurtzen den lekuan. Bi fitxek erakusten, kopiatzen eta gordetzen dutena pantailaren arabera doa, eta baita bezeroa zehaztu gabe deitutako getSchemaSQL ere.
5.0.0 bertsioa baino lehen, irakurle baten korritzea, zooma, fitxa-aldaketa, datu-basea eta kode-ezarpenak value balioara joaten ziren inork blokeatuta ez zeuden bitartean, datu-baseak inoiz ez duena, eta biltegi partekatu batek beste editoreei bidaltzen zizkien.
SQL eskema fitxaren berezko This window only aukerak, Statements, Header, 4.2.0 bertsiotik aurrera Write logical names into empty comments eta Tables, ez dira inoiz gordetzen editore batean ere eta aplikatzen dira oraindik, eta gauza bera gertatzen da Export image elkarrizketa-koadroarekin, gai-sortzailearekin eta Bistaratze-hizkuntzaren hautatzailearekin. Gai-sortzailean edo Bistaratze-hizkuntzaren hautatzailean egindako aukeraketa batek changePresetTheme edo changeLocale igortzen du oraindik.

Ezarrita dagoen bitartean, ezerk ez du desegite-historian sartzen, korritzeak eta zoomak ere ez, eta editorearen biltegi partekatu batek ez du aldaketarik bidaltzen: irakurlearen kurtsoreaz, fokuaz, hautapenaz eta arrastatze-koadroaz jarraitzaileek bidaltzen dutena baino ez, eta beste editore bat sartzen denean eskatzen dituen erregistroak (ikus Elkarlaneko edizioa). Besteek bidaltzen duten aldaketa guztiak aplikatzen ditu oraindik. Datu-basearen, Code Generator ezarpen baten edo View Option errenkada baten aldaketa bat dokumentura iristen da, eta pantailara ere bai, irakurleak ezarpen hori bertan aldatu ez badu behintzat; eta partekatutako Izenen ikuspegiaren aldaketa bat pantailan ikusten da edonola. 5.1.0 bertsiotik aurrera, Kode-sortzailearen lengoaia, izenen idazkera edo mugatzaile mota bat, ezarpen horren blokeoa aktibatuta dagoen bitartean aldatuta, hura aldatu zuen editorearen pantailan geratzen da eta ez da inoiz bidaltzen; beraz, ez da irakurlearen dokumentura iristen, ezta haren pantailara ere. Blokeoa desaktibatuta egindako aldaketa bat, eta blokeoa desaktibatzeak darakarren balioa, goian bezala iristen zaizkio oraindik.

Aktibatzeak irekita zegoena amaitzen du: gelaxka, ohar edo taula-talde izenen editore bat, marrazten ari zen erlazio bat, taula, ohar, taula-talde edo zutabe baten arrastatzea, Alt arrastatze baten kopiak, ohar edo taula-talde baten tamaina-aldaketa, oraindik martxan dagoen Auto Layout aurreikuspen edo kokatze bat, Map Columns, Time Travel eta kolore-hautatzailea. Hautapena garbitzen du, esku-tresna uzten du, eta lehenik biltegi partekatu bakoitzak arrastatze edo korritze batetik oraindik atxikita duena bidaltzen du, flushStreamBuffers metodoak bezala. Taularen propietateak, orain irakurtzeko soilik, Diferentzia-ikustailea eta Export image elkarrizketa-koadroa irekita geratzen dira, eta korritzea, zooma, fitxa eta Izenen ikuspegia lehen bezala geratzen dira. Lehen muntatzean irakurtzeko soilik dagoen elementu batek modu berean hasten da, eta orrian host batek mugitzen duen batek jauzi batek utzitako ingerada mantentzen du.
Desaktibatzeak edizio-kontrolak itzultzen ditu, ezer hautatu edo irekita gabe. Datu-basetik, Kode-sortzailearen lengoaiatik, bi izenen idazkeretatik, mugatzaile motatik eta View Option errenkadetatik irakurleak aldatu duen bakoitza pantailak irakurleak hura lehen aldiz aldatu aurretik erakusten zuenera itzultzen da: dokumentuaren balioa, besteek bitartean bidalitako edozein aldaketarekin, edo editore honek ezarpenaren blokeoaren menpe berea bezala erakusten zuen balio bat, value propietateak inoiz izan ez duena. Korritzea, zooma, fitxa eta Izenen ikuspegia irakurleak utzi zituen tokian geratzen dira, eta value propietateak dokumentuaren ezarpenak mantentzen ditu berriro aldatzen diren arte. Bi aldaketek ez dute change igortzen.
Baliorik gabeko atributua, ="" eta ="true" true gisa irakurtzen dira. ="false" balioa false gisa irakurtzen da, eta beste edozein kate ere bai, HTMLko readonly="readonly" ohiko idazkera barne.

editor.readonly = true;
// or
editor.setAttribute('readonly', 'true');

<erd-editor readonly></erd-editor>

systemDarkMode

Sistemaren modu ilun/argiarekin automatikoki sinkronizatu ala ez zehazten du.
4.0.0 bertsiotik aurrera, aktibatzeak gaiaren appearance propietatea 'system' balioan jartzen du, setPresetTheme({ appearance: 'system' }) deiak egiten duen bezala. Orduan, editoreak sistema eragileak jakinarazten duen itxura argia edo iluna erakusten du, edo setSystemAppearance metodoak izendatzen duena, eta hura aldatzen denean aldatu egiten da.
Geroago 'light' edo 'dark' balioarekin egindako setPresetTheme dei batek, edo gai-sortzailean edo Bilaketa azkarrean Light edo Dark aukeratzeak, 'system' ordezten du, eta hala geratzen da: sistema eragilearen hurrengo aldaketak ez du gainidazten, systemDarkMode oraindik true bada ere. 4.0.0 bertsioa baino lehen, sistema eragilearen hurrengo aldaketak gainidazten zuen.
Itxura 'system' den bitartean desaktibatzean, une horretan erakusten den itxura argia edo iluna mantentzen da. Itxura 'system' baliotik aldatu ondoren desaktibatzean, dagoen bezala geratzen da.
Aldatzeak ez du gertaerarik igortzen.

editor.systemDarkMode = true;
// or
editor.setAttribute('system-dark-mode', 'true');

<erd-editor system-dark-mode></erd-editor>

enableThemeBuilder

Gai aurrezarriak erraz ezartzeko interfaze bat eskaintzen den ala ez zehazten du.
Tresna-barrako Theme botoia erakusten du, eta botoi horrek gai-sortzailea irekitzen du, Accent color, Gray color eta Appearance aukerekin. 4.0.0 bertsiotik aurrera, Appearance aukerak System eskaintzen du Light eta Dark aukeren ondoan, eta hau aktibatuta dagoen bitartean, Bilaketa azkarrak Theme zerrendatzen du, System, Light eta Dark aukerekin. Ikus Hizkuntza eta gaia.

editor.enableThemeBuilder = true;
// or
editor.setAttribute('enable-theme-builder', 'true');

<erd-editor enable-theme-builder></erd-editor>

Panel honetatik edo Bilaketa azkarretik gai aurrezarria aldatzeak changePresetTheme gertaera igortzen du.

enableLocalePicker

4.0.0 bertsiotik aurrera, editorearen bistaratze-hizkuntza aukeratzeko interfaze bat eskaintzen den ala ez zehazten du.
Tresna-barrako Display Language botoia erakusten du, Theme botoiaren ondoren biak erakusten direnean. Botoiak Bistaratze-hizkuntzaren hautatzailea irekitzen du, eta Bilaketa azkarrak Display Language zerrendatzen du. Biek System eta 25 hizkuntzak eskaintzen dituzte. Ikus Hizkuntza eta gaia.
Era berean, setLocale metodoari deitu edo hizkuntza bat aukeratu aurretik editore batek zer erakusten duen erabakitzen du: 'system' aktibatuta dagoen bitartean, eta ingelesa desaktibatuta dagoen bitartean; beraz, ezer konfiguratzen ez duen elementu batek beti erakutsi duen ingelesa mantentzen du. Aktibatzeak edo desaktibatzeak berehala aldatzen du bien artean. Hizkuntza bat ezarri edo aukeratu ondoren, aukera horrek bere horretan jarraitzen du, aktibatuta zein desaktibatuta egon.
Lehen fotogramak 'system' jarrai dezan, ezarri elementua erantsi aurretik.
Aukeraketa batek changeLocale igortzen du.

editor.enableLocalePicker = true;
// or
editor.setAttribute('enable-locale-picker', 'true');

<erd-editor enable-locale-picker></erd-editor>

enableWelcomeScreen

4.0.0 bertsiotik aurrera, diagrama huts batek irakurleari ongietorri-pantailarekin harrera egiten dion ala ez zehazten du.
ERD fitxaren gainean agertzen da, dokumentuak ez taularik, ez erakutsitako oharrik, ez erakutsitako taula-talderik ez duen bitartean. Ez da erakusten readonly ezarrita dagoen bitartean, zen moduan, edo Taularen propietateak, Diferentzia-ikustailea, Denbora-bidaia edo Antolaketa automatikoaren aurrebista irekita dagoen bitartean. Lehen taulak, lehen ohar erakutsiak edo lehen taula-talde erakutsiak kentzen du, eta diagrama hutsera itzultzen den desegite batek berriro ekartzen du.
Haren New Table, New Memo eta Command Palette errenkadek addTable, addMemo eta search tekla-konbinazioen lehen lasterbidea erakusten dute, setKeyBindingMap metodoak utzi dituen bezala, eta bat ere ez hutsik utzitako izen batentzat. Haren geziek Theme eta Display Language botoiak seinalatzen dituzte, soilik enableThemeBuilder eta enableLocalePicker propietateek erakusten dituzten tokietan.
Haren menuan, ↑, ↓, Home eta End teklekin errenkaden artean mugitzen da, eta tekla horiek eragotzi egiten dira eta haien hedapena gelditzen da. Enter eta Space teklen hedapena gelditzen da, baina ez dira eragozten; beraz, fokuratutako errenkadak jasotzen ditu, eta Import formatuen artean, Escape teklak atzera egiten du, eragotzita eta hedapena geldituta. Beste tekla guztiak editorera eta orrira iristen dira ohi bezala.
Ez du dokumentuan ezer aldatzen; beraz, value zegoen bezala uzten du, eta ez du change gertaerarik igortzen.
Aktibatu setInitialValue metodoak dokumentua kargatu ondoren, ostalari ofizialek egiten duten bezala, pantaila inoiz une batez ager ez dadin oraindik kargatzen ari den fitxategi baten gainean.

editor.enableWelcomeScreen = true;
// or
editor.setAttribute('enable-welcome-screen', 'true');

<erd-editor enable-welcome-screen></erd-editor>

value

getter

Uneko dokumentua JSON kate gisa itzultzen du, editoreak definitzen duen eskeman.
4.0.0 bertsiotik aurrera, biltegiratze-forma da, dokumentua fitxategi batek gordetzen duen bezala, eta hori bera da json esportazioak idazten duena eta ostalari ofizialek gordetzen dutena. Entitate biziak soilik ditu, kendutakorik gabe, pilatze-ordenarik gabe, eta editoreak berak kalkulatzen duenik gabe, hala nola neurtutako zabalerak, gako-markak eta erlazioen aingura-puntuak. Haren entitateen gakoak ordena finkoan daude, bi zuriunerekin koskatuta dago, eta lerro-jauzi batekin amaitzen da; beraz, dokumentu berak beti byte berak ematen ditu.
4.2.0 bertsiotik aurrera, hutsik dagoena ere kanpoan uzten du: doc zerrenda huts bat, bilduma huts bat, ezer ez duen hiztegi-errenkada bat, eta entitate baten testu-eremu huts bat, hala nola izena, iruzkina, datu mota, balio lehenetsia edo kolorea. Entitate baten barruko zerrenda bat, hala nola taula baten columnIds, hutsik dagoenean ere idazten da. Dokumentu berri baten doc objektua {} da, eta ez du collections propietaterik; beraz, irakurri falta den eremu, zerrenda edo bilduma bat huts gisa. Taulen eta zutabeen izen logikoak eta izen eratorriaren markak, zutabeen domeinu-loturak, eta hitzak, terminoak eta domeinuak ditu; hiztegi bakoitza eremu-izenen goiburu bakar gisa idazten da, eta ondoren haren errenkadak, lerro bakoitzeko errenkada bat, orriaren ordenan. Ikus Biltegiratze-forma.
Blokeoa aktibatuta duen ezarpen bakoitza blokeatuta dagoen balioarekin idazten da, ez pantailak erakusten duen bezala. Viewport blokeoak originX, originY eta zoomLevel gordetzen ditu, eta Canvas Type, Language, Table Name Case, Column Name Case, Bracket Type eta, 4.2.0 bertsiotik aurrera, Name View blokeoetako bakoitzak bere ezarpena gordetzen du. Izenen ikuspegia nameViewMode gisa idazten da, eta 'physical' ez den bitartean soilik. Beste ezarpen guztiak dauden bezala idazten dira, eta lockSettings beti idazten da. Bitei buruzko xehetasunetarako, ikus Settings; Name View blokeoaren bita alderantziz irakurtzen da.
5.0.0 bertsiotik aurrera, irakurtzeko soilik dagoen editore baten irakurleak aldatzen dituen ezarpenak ere dokumentuaren balioetan idazten dira, blokeatuta egon ala ez, pantaila horretan geratzen baitira.
Dokumentu berri batek blokeo guztiak aktibatuta ditu, dela elementu batek balio bat jaso aurretik erakusten duena, dela balio huts batetik kargatutakoa. Haren value balioak jatorria 0, 0 puntuan, zoom-maila 1 balioan, ERD fitxa, Kode-sortzailearen lengoaia, izenen idazkerak eta mugatzaile mota lehenetsiak, eta, 4.2.0 bertsiotik aurrera, Physical Names ikuspegia mantentzen ditu, dagokion blokeoa desaktibatu arte.
4.0.0 bertsioa baino lehen, dokumentu osoa itzultzen zuen editoreak gordetzen zuen bezala, ignoreSaveSettings aplikatuta. Editoreak gordetzen duen bezalako dokumentua runtimeValue da orain, eta ignoreSaveSettings ez da gehiago irakurtzen ez idazten.

const data = editor.value;

setter

Aurrez gordetako editore-egoera bat kargatzen du. Dokumentu osoa ordezten du: unekoa garbitzen da lehenik. 4.2.0 bertsiotik aurrera, hitzak, terminoak eta domeinuak ere bai: dokumentuak testuak dituenak hartzen ditu, edo bat ere ez, eta Hiztegia fitxako orri bakoitzaren desegite-historia propioa hustu egiten da.
clear() eta setInitialValue() bezala, eta setSchema* metodoak beren mode: 'replace' modu lehenetsian bezala, Bisualizazioa fitxako Fluxu ikuspegia ere baztertzen du: haren antolaketa, zein taulatara mugatuta dagoen, errenkaden bistaratzea, zooma eta ikuspegiaren kokapena, eta, 4.2.0 bertsiotik aurrera, haren Previous table eta Next table botoiek zeharkatzen dituzten taulak. Gehitze batek (mode: 'append') ez du baztertzen.
5.1.0 bertsiotik aurrera, marrazten ari den erlazio bat amaitzen du, mota bakarrik prest egon edo taula gurasoa jada aukeratuta egon. Gauza bera egiten dute clear() metodoak, mode: 'replace' moduko setSchema* metodoek, editorearen Import aukerak, horietako edozeinen desegiteak edo berregiteak (clear() metodoaren desegitea izan ezik), eta horietako bakoitzak biltegi partekatu baten bidez jasota, lankide batengandik edo kodetze-agente batengandik. 5.1.0 bertsioa baino lehen marrazketa prest geratzen zen karga gertatu arren, eta kargatutako testuak, adibidez desegite batek daraman exekuzio-garaiko balioak, abiapuntuko taula kendutako entitate gisa zeukanean, sakatze batek erlazio bat gehi zezakeen kendutako taula horretatik. Gehitze batek marrazketa prest uzten du.
Lehen bezala, ohar-, taula-taldearen izen- edo gelaxka-editore bat irekita geratzen da kargatutako dokumentuak editatzen duena oraindik badu eta erakusten badu, eta bestela itxi egiten da; irekita utzitako batean idaztea kargatutako dokumentuan jarraitzen du. 5.1.0 bertsiotik aurrera, edozein kargak ixten duen editore batek teklatua orriari uzten dio, editoreari itzuli beharrean; beraz, itxitako testuarentzat zen Delete edo Backspace batek ez du hautapenetik ezer kentzen. Halako karga baten bidez irekita geratutako izen logikoaren gelaxka batek izen fisikoa ixten den unean eratortzen du erabiltzaileak idatzitako izen logiko batetik soilik, inoiz ez, 5.1.0 bertsiotik aurrera, kargak ekarri duen batetik.
Historia-zerrendan erregistratzen da, Undo, Redo ahalbidetuz, eta change igortzen du.
Biltegiratze-forma, runtimeValue bat edo aurreko bertsio batek gordetako fitxategi bat onartzen ditu.
Kate huts batek, edo kate ez den edozerk, dokumentu berri bat kargatzen du errorerik sortu beharrean; beraz, egiaztatu balioa esleitu aurretik.
Dokumentu berri hori setInitialValue('') deiak hasten duen bera da: hutsa, ezarpen lehenetsiekin, eta 4.0.0 bertsiotik aurrera blokeo guztiak aktibatuta. 3.10.x bertsioetan ez zituen ez korritze-posizioa ez zoom-maila gordetzen, eta horren aurretik biak gordetzen zituen.
Biltegi partekatu batek karga hori lankideei helarazten die dokumentu berriaren JSON osoarekin; beraz, pareko guztiek kargatzen dute, bertsio zaharragoko bat barne, nahiz eta 4.2.0 baino lehenagoko editore batek ezagutzen ez duena baztertzen duen, hala nola izen logikoak, domeinu-loturak eta hiztegiak. Ikus Bertsioak nahastea.
4.0.0 bertsiotik aurrera, kargatutako dokumentuaren blokeoak, eta ondoren value balioak idazten dituen balio blokeatuak, testutik datoz, eta ikuspegia testuak jartzen duen tokian kokatzen da, edo diagraman, han diagramaren zatirik ere marrazten ez bada. Testuak blokeatzen dituen beste ezarpen bakoitzerako — fitxa, Kode-sortzailearen lengoaia, izenen idazkerak, mugatzaile mota eta, 4.2.0 bertsiotik aurrera, Izenen ikuspegia — editoreak kargatu aurretik erakusten zuena erakusten jarraitzen du. Testuak blokeatu gabe uzten duen ezarpen batek testuaren balioa hartzen du. 4.2.0 bertsioa baino lehen gordetako fitxategi batek ez du Name View blokeorik izendatzen, 4.2.0 bertsioko editore batek bertan blokeo hori desaktibatu ez badu; beraz, Izenen ikuspegia Physical Names ikuspegian blokeatuta duela kargatzen da, eta editoreak erakusten zuen Izenen ikuspegia mantentzen du. setInitialValue metodoak, aldiz, testuak dituen balio guztiak hartzen ditu; ikus hura, baita blokeorik izendatzen ez duen testu baterako ere.
JSON ez den testuak ere, esaterako bateratze-gatazken markekin utzitako fitxategi batek, ez du errorerik sortzen: dokumentua hustu egiten da, haren ezarpenak zeuden bezala geratzen dira, eta analisi-errorea kontsolan erregistratzen da.
Ez da kontuan hartzen readonly ezarrita dagoen bitartean; erabili setInitialValue irakurtzeko soilik dagoen editore batean kargatzeko.

editor.value = 'json...';

runtimeValue

4.0.0 bertsiotik aurrera, dokumentua editore honek gordetzen duen bezala itzultzen du, JSON kate gisa. Ez du setter-ik; beraz, esleitzeak errore bat jaurtitzen du modu zorrotzeko kodean.
value propietateak kanpoan uzten duena darama: kendutako entitateak eta haien ordena, pilatze-ordena, neurtutako zabalerak, gako-markak, erlazio bakoitzaren adierazleak (identifikatzailea den ala ez, eta bere gurasoaren muturra nola marrazten den) eta aingura-puntuak, eta sekuentziak.
4.2.0 bertsiotik aurrera, value propietateak kanpoan uzten dituen hutsik dauden gauzak ere mantentzen ditu: entitate baten testu hutsa, hala nola izena, iruzkina, datu mota, balio lehenetsia, kolorea edo oharraren testua; tableIds, relationshipIds, indexIds eta memoIds doc zerrendak eta tableEntities eta memoEntities arteko bildumak, hutsik egon arren idatzita; taula-taldeen zerrenda eta bilduma, dokumentuak talde bat edo kendutako bat duen bitartean; eta hiztegi bakoitza bere doc zerrendarekin, bietako batek sarrera bat duen bitartean. Zuriuneez soilik osatutako izen logiko bat, kendutako domeinu baterako lotura bat, Hiztegia fitxako orri batetik kendutako errenkadak eta ezer ez dutenak mantentzen ditu. value propietatean bezala, '' den izen logiko bat, domeinu-lotura bat edo taula baten taldea, eta desaktibatuta dagoen taula baten izen eratorriaren marka, kanpoan uzten dira.
Hiztegi bakoitza goiburu bat eta errenkadak dira, fitxategi batean bezala, baina haren goiburuak "order" izendatzen du, errenkada bakoitzaren ordena-gakoa, "name" ondoren berehala, eta haren errenkadak editoreak gordetzen dituen ordenan daude, kendutako errenkadak barne, orriaren ordenan beharrean. Orriaren ordena lortzeko, hartu haren doc zerrendak izendatzen dituen errenkadak eta ordenatu order bidez, kode-unitateen ordenan alderatuta, eta gako bera duten errenkadak id bidez.
Haren ezarpenak value propietateak idazten dituen bezala idazten dira, ezarpen blokeatu bakoitza bere balio blokeatuarekin. Bi zuriunez koskatuta dago, hiztegi-errenkada bakoitza bere lerroan, eta value ez bezala lerro-jauzirik gabe amaitzen da.
Erabili martxan dagoen saio batean sartzen den beste editore bat hasieratzeko, hala nola lankide bat edo dokumentu beraren bigarren ikuspegi bat, haren setInitialValue metodoaren bidez. Saioak geroago bidaltzen duen kentze baten desegiteak entitatea osorik berreskuratzen du han; value baliotik hasieratutako editore batek, berriz, ez du kendutako entitaterik, eta taula huts eta izengabe bat berreskuratzen du horren ordez, edo, 4.2.0 bertsiotik aurrera, hiztegi-errenkada huts bat. Ikus Elkarlaneko edizioa.
Kendutako entitateak jada ez ditu ezerk biltzen; beraz, bertan geratzen dira dokumentua hurrengoan bere fitxategitik ireki arte.
Ez idatzi inoiz fitxategi batean: gorde value, JSON Schema eskemak hura onartzen baitu, baina hau ez.

otherEditor.setInitialValue(editor.runtimeValue);

setInitialValue

Aurrez gordetako editore-egoera bat kargatzen du. Karga bera ez da historia-zerrendan erregistratzen; beraz, ezin da desegin, eta ez da change gertaerarik igortzen.
Desegite-historia ere garbitzen du, eta, 4.2.0 bertsiotik aurrera, Hiztegia fitxako orri bakoitzaren historia propioa ere bai; beraz, kargatu aurretik egindako ezer ezin da desegin edo berregin kargatutako dokumentuaren gainean.
Biltegiratze-forma, runtimeValue bat edo aurreko bertsio batek gordetako fitxategi bat onartzen ditu, eta, value esleitzean ez bezala, testuak dituen ezarpen guztiak hartzen ditu, fitxa eta kode-ezarpenak barne.
Kate huts batek, edo kate ez den edozerk, dokumentu berri bat kargatzen du errorerik sortu beharrean; beraz, setInitialValue('') deiak diagrama huts bat hasten du.
4.0.0 bertsiotik aurrera, dokumentu berri horrek, elementu batek inolako baliorik jaso aurretik erakusten duen berak, blokeo guztiak aktibatuta ditu. Korritzeak, zooma aldatzeak, fitxaz aldatzeak, eta Kode-sortzailearen lengoaia, izenen idazkerak, mugatzaile mota edo, 4.2.0 bertsiotik aurrera, Izenen ikuspegia aldatzeak value zegoen bezala uzten dute, eta ez dute change gertaerarik igortzen. 3.10.x bertsioetan ez zituen ez korritze-posizioa ez zoom-maila gordetzen, eta horren aurretik biak gordetzen zituen.
Testutik kargatutako dokumentu batek izendatzen dituen blokeoak mantentzen ditu. Bat ere izendatzen ez duena — 4.0.0 bertsioa baino lehen gordetako edozein fitxategi, haren ignoreSaveSettings aukerak zer zioen gorabehera, eta v2 .vuerd fitxategi bat — blokeo guztiak aktibatuta irekitzen da, Viewport blokeoa 0, 0 jatorrian eta 1 zoom-mailan blokeatuta, ERD fitxan, eta lengoaia, izenen idazkerak eta mugatzaile mota gorde zituen bezala dituela.
4.2.0 bertsiotik aurrera, bere blokeoak izendatzen dituen baina Name View blokeoa izendatzen ez duen testu bat blokeo hori ere aktibatuta duela irekitzen da, beste blokeo guztiak desaktibatuta daudenean ere. 4.2.0 bertsioa baino lehen gordetako fitxategi bat horrelako testu bat da, 4.2.0 bertsioko editore batek bertan blokeo hori desaktibatu ez badu (ikus Settings). Physical Names ikuspegian irekitzen da, blokeorik batere izendatzen ez duen testu bat bezala.
Edonola ere, ikuspegia dokumentuaren ikuspegian irekitzen da — testuak gordetakoa, blokeoak izendatzen dituenean; 0, 0 jatorria 1 zoom-mailan, bat ere izendatzen ez duenean — edo diagraman, han diagramaren zatirik ere marrazten ez bada. Blokeatutako Viewport batek bere balio blokeatuak mantentzen ditu oraindik value balioan.
4.0.0 bertsiotik aurrera, aurretik zuen dokumentuaren elkarlan-egoera ere baztertzen du, eta dagoeneko harpidetuta dagoen editore honen biltegi partekatu batek beste editoreei haiena eskatzen die berriro; beraz, martxan dagoen saio batean berriro kargatutako editore bat besteekin bat jartzen da. Hasieratu editore hori beste editore baten runtimeValue balioarekin.
5.1.0 bertsiotik aurrera, elkarlan-erregistroak hasieraketarekin batera etor daitezke horren ordez, eta hori behar du gordetako argazki batek, erantzuteko martxan dagoen editorerik ez dagoenean.
Dei honen ondoren, inoiz ez aurretik, pasatu beste biltegi baten getLWW() eta getVersion() editore honen biltegi partekatuko mergeLWW metodoari. Edo kargatu biltegi horren reseed metodoaren bidez; metodo horrek dokumentua kargatzen du eta erregistroak hartzen ditu dei bakar batean, eta hautapena eta fokua ere baztertzen ditu. Ikus Lankide bat hasieratzea.
JSON ez den testuak ere ez du errorerik sortzen: dokumentua hustu egiten da, haren ezarpenak zeuden bezala geratzen dira, eta analisi-errorea kontsolan erregistratzen da.
value esleitzean ez bezala, readonly atributuak ez du blokeatzen; beraz, horrela kargatzen da dokumentu bat irakurtzeko soilik dagoen editore batean. Irakurtzeko soilik dagoen editore batek kargatutako testuak dituen ezarpenak erakusten ditu, irakurleak pantailan aldatuak zituenak baztertuta.

5.1.0 bertsiotik aurrera, marrazten ari den erlazio bat amaitzen du eta irekita dagoen ohar-, taula-taldearen izen- edo gelaxka-editorea ixten du, kargatutako dokumentuak editore horrek editatzen duena oraindik baldin badu ere. 5.1.0 bertsioa baino lehen marrazketa prest geratzen zen, eta editore bakoitza irekita geratzen zen kargatutako dokumentuak haren oharra, taldea edo taula eta zutabea oraindik zituen bitartean.
Ixteak ez du ezer idazten ez bidaltzen: oharraren testua eta gelaxkaren balioa idatzi ahala idatzi ziren jada, lehen zegoen dokumentuan, eta Domain gelaxka baten bilaketa, domeinu bat aukeratu arte ezer idazten ez duena, eta idatzi baina oraindik sartu ez den taula-taldearen izen bat baztertzen dira.
Salbuespen bakarra erabiltzaileak idatzi duen izen logikoaren gelaxka bat da: kargatutako dokumentuak bertan idatzitako azken izen logikoa badu, ixteak izen fisikoa hartatik eratortzen du, gelaxka horren edozein ixtek bezala. Eratorpen hori beste edozein bezalako edizio bat da; beraz, biltegi partekatu batek bidaltzen du, desegite-urrats bat sortzen du eta change igortzen du.
Hautapena eta fokuratutako gelaxka mantentzen dira, eta teklatua orriari uzten zaio, setter atalak edozein kargarentzat azaltzen duen bezala. Biltegi partekatu baten reseed metodoak berdin ixten ditu.

editor.setInitialValue('json...');

Kargatu hastean, gorde aldatzean.

editor.setInitialValue(localStorage.getItem('my-diagram') ?? '');
editor.addEventListener('change', () => {
  localStorage.setItem('my-diagram', editor.value);
});

Gertaerak

change, changePresetTheme eta changeLocale dira hiru gertaera publiko bakarrak; changeLocale gertaera 4.0.0 bertsioan berria da.
Elementuak barneko @dineug/erd-editor/internal-* gertaerak ere bidaltzen dizkio bere buruari, bere barne-loturetarako; horiek ez dira APIaren parte.

change

Editorean aldaketak daudenean, gertaera bat igortzen du.
Gertaera atzeratu egiten da 200 ms-ko isilaldia igaro arte, eta ez da igortzen readonly true den bitartean.
Dokumentuaren edozein aldaketarekin abiarazten da: interfazeko edizio batekin, value esleitzearekin, clear() deiarekin, setSchema* metodo bakoitzarekin, eta 4.0.0 bertsiotik aurrera setSchemaJSON() deiarekin eta Import and Add aukerarekin. setInitialValue metodoak ez du igortzen, eta 5.1.0 bertsiotik aurrera biltegi partekatu baten reseed metodoak ere ez, bietako batek erabiltzaileak idatzi duen izen logikoaren gelaxka bat ixtean eratortzen duen izen fisikoa izan ezik (ikus setInitialValue).
4.2.0 bertsiotik aurrera, horren barruan daude Hiztegia fitxako edizio guztiak eta haietako baten desegite eta berregite guztiak, izen logiko baten edo domeinu-lotura baten aldaketa bat, Derive Physical Names Again aukera, eta Izenen ikuspegiaren aldaketa bat Name View blokeoa desaktibatuta dagoen bitartean.
Bisualizazioa fitxako Fluxu moduan egiten den ezerk ez du igortzen — zooma, ikuspegia mugitzea, txartelak mugitzea, Tidy Up, errenkaden bistaratzea, txartel batetik ikuspegia mugatzea, ezta, 4.2.0 bertsiotik aurrera, Previous table eta Next table botoiekin edo desegiteko eta berregiteko teklekin urratsez urrats mugitzea ere — horietako bat ere ez baita dokumentu-aldaketa. Haren Name View zerrenda da salbuespena: bertan egindako aldaketa batek igortzen du Name View blokeoa desaktibatuta dagoen bitartean, ERD fitxan egindako batek bezala.
4.0.0 bertsiotik aurrera, blokeoa aktibatuta duen ezarpen baten aldaketak ere ez du igortzen, pantaila soilik mugitzen duelako eta inoiz ez value: ERD oihaleko korritze edo zoom bat Viewport blokeatuta dagoen bitartean, fitxa-aldaketa bat Canvas Type blokeatuta dagoen bitartean, Kode-sortzailearen lengoaiaren, taula-izenen idazkeraren, zutabe-izenen idazkeraren edo mugatzaile motaren aldaketa bat, haren blokeoa aktibatuta dagoen bitartean, eta, 4.2.0 bertsiotik aurrera, Izenen ikuspegiaren aldaketa bat Name View blokeatuta dagoen bitartean. Aldaketa horiek soilik geratzen dira kanpoan; beraz, dokumentua ere editatzen duen sorta batek igortzen du. Ezarpen bat blokeatzeak edo desblokeatzeak igortzen du.
Blokeo guztiak aktibatuta daude dokumentu berri batean eta 4.0.0 bertsioa baino lehen gordetako edozein fitxategitan, eta Name View blokeoa aktibatuta dago 4.2.0 bertsioa baino lehen gordetako edozein fitxategitan, 4.2.0 bertsioko editore batek bertan desaktibatu ez badu; beraz, lehenespenez korritzeak, zoomak, fitxaz aldatzeak eta Izenen ikuspegia aldatzeak ez dute ezer igortzen. Horrek barne hartzen ditu ERD fitxatik taulak fokuratzea, Fluxutik ERD fitxara itzultzen zaituen txartelaren kanpo-estekaren botoia, Arakatzaileko errenkada batera edo bilaketaren bat-etortze batera joatea, beste fitxa batetik Arakatzailea irekitzea edo Bilaketa azkarreko emaitza batera joatea, eta, 4.2.0 bertsiotik aurrera, Hiztegia fitxako Checks orriko errenkada batetik taula edo zutabe batera joatea. Horietako bakoitzak change bakar bat igortzen du, hura estaltzen duen blokeo bat desaktibatuta dagoen bitartean soilik: Canvas Type fitxa-aldaketarako, eta Viewport txartel-botoi batek, Bilaketa azkarreko emaitza batek, Arakatzaileko errenkada batek, bilaketaren bat-etortze batek edo Checks errenkada batek ere egiten duen korritzerako. 4.1.0 bertsiotik aurrera, korritze horiek guztiek arau bakar bati jarraitzen diote, Jauziaren helmuga; beraz, Bilaketa azkarreko taula-emaitza batek jada ez du beti korritzen, eta arauak bere tokian uzten duen jauzi batek ez du igortzeko korritzerik egiten. Arakatzailea irekitzeak, ixteak edo tamainaz aldatzeak oihala estutu edo zabaltzen du haren jatorria mugitu gabe, eta horrek ere ez du ezer igortzen. 4.0.0 bertsioa baino lehen, korritzeak, zoomak eta fitxaz aldatzeak beti igortzen zuten, editor.value berdin ateratzen zenean ere.
Ezer aldatzen ez duten idazketak saihesteko, alderatu editor.value gorde zenuen azken balioarekin, ez kargatu zenuen fitxategiarekin: aurreko bertsio batek idatzitako fitxategi bat, v2 fitxategi bat edo eskuz editatutako bat desberdin atera daiteke value balioan kargatu bezain laster, value balioak biltegiratze-forman idazten duelako. Gauza bera gerta daiteke Viewport blokeoa desaktibatuta duen fitxategi batekin, haren jatorritik diagramaren zatirik ere marrazten ez bada pantaila honetan: kargak ikuspegia diagramara mugitzen du, eta value balioak ikuspegia kokatzen den tokia idazten du. 4.0.0 bertsiotik aurrera, neurtutako zabalerek ez dute hau eragiten, value balioak ez baitu bat ere. 4.2.0 bertsiotik aurrera, 4.0.0 edo 4.1.0 bertsioak gordetako fitxategi bat ere desberdin atera daiteke, value balioak orain haren testu-eremu, zerrenda eta bilduma hutsak kanpoan uzten dituelako; beraz, horrelako fitxategi bat behin berridazten da, hurrengo gordetzean. Fitxategiak idazten dituen ostalari batek, horren ordez, edizio bat eta ikuspegi-aldaketa bat bereiz ditzake erreplikazio-biltegi baten changed propietatearekin. Ikus on@change.
Gertaerak ez du detail propietaterik, eta ez da burbuila-fasean hedatzen, ezta shadow DOMaren muga zeharkatzen ere; beraz, entzun elementuan bertan eta irakurri editor.value kudeatzailean.

editor.addEventListener('change', event => {
  const data = event.target.value;
});

changePresetTheme

Gai aurrezarria editorean integratutako gai-sortzailetik aldatzen denean igortzen da, edo, 4.0.0 bertsiotik aurrera, Bilaketa azkarreko Theme aukeratik. Aukeraketa orok igortzen du, dagoeneko indarrean dagoen aukera berriro aukeratzea barne.
Zuk zeuk setPresetTheme edo setSystemAppearance metodoei deitzeak, edo systemDarkMode aktibatzeak edo desaktibatzeak, ez du igortzen.
event.detail aukeraketaren ondorengo ThemeOptions osoa da, { appearance, grayColor, accentColor }, ez eskatutako balio partziala. 4.0.0 bertsiotik aurrera, haren appearance propietatea 'system' da System aukeratuta dagoen bitartean, ez erakusten duen itxura argia edo iluna; beraz, gorde dagoen bezala eta eman berriro setPresetTheme metodoari.

editor.addEventListener('changePresetTheme', event => {
  const themeOptions = event.detail;
});

changeLocale

4.0.0 bertsiotik aurrera, editorean hizkuntza bat aukeratzen denean igortzen da, Bistaratze-hizkuntzaren hautatzailetik edo Bilaketa azkarreko Display Language aukeratik; biak enableLocalePicker propietateak aktibatzen ditu.
Hizkuntza aplikatu ondoren abiarazten da, aukeraketa bakoitzean, dagoeneko indarrean dagoen aukera berriro aukeratzea barne. setLocale eta setSystemLocale metodoek ez dute inoiz igortzen, ezta nabigatzailearen hizkuntzen aldaketa batek ere. Hizkuntza-aldaketa batek ez du change gertaerarik igortzen.
event.detail objektua { locale } da, LocaleOption bat: 'system', System aukeratu denean; bestela, hizkuntzaren kodea. Elementuak ez du aukeraketa gogoratzen; beraz, gorde eta pasatu setLocale metodoari hurrengo kargan.
change gertaerak bezala, ez da burbuila-fasean hedatzen; beraz, entzun elementuan bertan.

editor.addEventListener('changeLocale', event => {
  const { locale } = event.detail; // 'system' | 'ko-KR' | ...
});

focus

Editorea fokuratzen du.

editor.focus();

blur

Fokua editoretik kentzen du.

editor.blur();

clear

Dokumentua husten du: taula, zutabe, erlazio, indize eta ohar guztiak kentzen ditu, 4.0.0 bertsiotik aurrera taula-talde guztiak, eta 4.2.0 bertsiotik aurrera Hiztegia fitxako hitzak, terminoak eta domeinuak, orri bakoitzaren desegite-historia propioa ere hustuz.
Ezarpen guztiak mantentzen dira, datu-basea, ikuspegiaren kokapena, zoom-maila, taulen ikuspegi-aukerak, blokeo bakoitza gordetzen duen balioarekin, eta SQL eskema fitxako Before tables eta After tables scriptak barne; beraz, garbitutako fitxategi batek lehen gordetzen zuena gordetzen jarraitzen du. Horren ordez dokumentu berri bat hasteko, esleitu '' value propietateari edo deitu setInitialValue('') metodoari.
Historia-zerrendan erregistratzen da; beraz, desegin daiteke, eta change igortzen du. Desegite batek dokumentua editoreak gordetzen zuen bezala itzultzen du, haren hitzak, terminoak eta domeinuak barne, ezarpen blokeatu bakoitza bere balio blokeatuarekin. Ez da kontuan hartzen readonly ezarrita dagoen bitartean.
5.1.0 bertsiotik aurrera, marrazten ari den erlazio bat amaitzen du, value setter atalak azaltzen duen bezala, eta haren berregiteak ere; haren desegiteak ez.
Lehen bezala, irekita utzitako ohar-, taula-taldearen izen- edo gelaxka-editore bat itxi egiten da, hustutako dokumentuak editatzeko ezer ez baitu. 5.1.0 bertsiotik aurrera, itxitako editoreak teklatua orriari uzten dio, karga baten ondoren bezala.

editor.clear();

destroy

Editorearen instantzia guztiz suntsitzen du, berriro erabili ezin izateko moduan.
Editorearen entzuleak eta harpidetzak askatzen ditu, eta getSharedStore metodoak itzulitako biltegi partekatu guztiak suntsitzen ditu.
Biltegi partekatu batek oraindik atxikita duen jario-sorta bat berarekin batera galtzen da; bidaltzeko, deitu lehenik biltegi horren flushStreamBuffers metodoari.

editor.destroy();

setKeyBindingMap

Teklatuko lasterbideak birdefinitzen ditu.
edit, stop, undo, redo, zoomIn, zoomOut eta zoomReset finkoak dira, eta ezin dira birdefinitu.
Beheko hogeita bat izenak soilik idazten dira; objektuko beste edozer ez da kontuan hartzen, izen finkoak barne.
3.10.0 bertsiotik aurrera, search birdefini daiteke, eta findReplace berria da. Lehen, search finkoa zen. 4.0.0 bertsiotik aurrera, removeSelection berria da. 4.1.0 bertsiotik aurrera, addTableGroup eta groupSelectedTables berriak dira.
Tekla-konbinazio baten balioak ShortcutOption[] bat izan behar du. Kate soil bat ez da kontuan hartzen; beraz, idatzi { addTable: [{ shortcut: 'Alt+KeyN' }] }, eta ez { addTable: 'Alt+KeyN' }.
Array huts bat onartzen da, eta ez du ezer lotzen: setKeyBindingMap({ findReplace: [] }) deiak Ctrl + F (Windows/Linux) edo ⌘ + F (Mac) orriaren esku uzten du, eta { search: [] } balioak gauza bera egiten du Ctrl + K (Windows/Linux) edo ⌘ + K (Mac) lasterbidearekin. Tresna-barrako Search botoiak Bilaketa azkarra irekitzen du oraindik, tresna-barrako Explorer botoiak Arakatzailea ireki eta ixten du oraindik, eta Bilaketa azkarreko eta oihalaren laster-menuko Toggle Explorer aukerak haren bilaketa irekitzen du edo hura ixten du oraindik; horietako batek ere ez du lasterbiderik erakusten hutsik utzitako izen batentzat. { removeSelection: [] } balioak Delete eta Backspace orriaren esku uzten ditu, eta orduan taularen, oharraren eta taula-taldearen menuetako ezabatze-aukerek (Delete, Delete selected, Delete column, Delete columns) ez dute lasterbiderik erakusten.
4.1.0 bertsiotik aurrera, { addTableGroup: [] } balioak Alt + G (Windows/Linux) edo ⌥ + G (Mac) orriaren esku uzten du, eta { groupSelectedTables: [] } balioak T eta ondoren G. Oihaleko tresna-barrako, oihalaren laster-menuko eta Bilaketa azkarreko New Table Group, taularen menuko Group selected tables eta Bilaketa azkarreko Group Selected Tables aukerek funtzionatzen dute oraindik, lasterbiderik erakutsi gabe. Oihaleko tresna-barrako New Table, New Memo eta New Table Group botoien argibideek addTable, addMemo eta addTableGroup tekla-konbinazioen lehen lasterbidea izendatzen dute, edo botoia soilik, hutsik utzitako tekla-konbinazio batentzat.
4.2.0 bertsiotik aurrera, addColumn eta removeColumn izenek Hiztegia fitxako saretari ere ematen dizkiote haren errenkaden tekla-konbinazioak, behean azaltzen den bezala; beraz, horietako bat berriro esleitzeak tekla-konbinazio horiek ere harekin batera mugitzen ditu. { addColumn: [] } balioak ez dio saretari errenkadak txertatzeko tekla-konbinaziorik uzten, eta orduan saretaren menuko bi txertatze-aukerek ez dute lasterbiderik erakusten; { removeColumn: [] } balioak ez dio errenkadak ezabatzeko bat ere uzten, eta orduan menuko ezabatze-aukerak eta Delete Rows tresnaren argibideak ez dute bat ere erakusten.
Deia bateratze partziala da: kanpoan uzten dituzun izenek beren balio lehenetsiak mantentzen dituzte, eta bi aldiz deitzean aurreko aldaketak mantentzen dira. Ez dago uneko tekla-konbinazioetarako getter-ik: createKeyBindingMap funtzioak balio lehenetsiak itzultzen ditu, ez setKeyBindingMap metodoak aldatutakoa.

type ShortcutOption = {
  shortcut: string;
  preventDefault?: boolean;
  stopPropagation?: boolean;
};

const defaultKeyBindingMap: Omit<
  KeyBindingMap,
  | 'edit'
  | 'stop'
  | 'undo'
  | 'redo'
  | 'zoomIn'
  | 'zoomOut'
  | 'zoomReset'
> = {
  search: [
    { shortcut: '$mod+KeyK', preventDefault: true, stopPropagation: true },
  ],
  findReplace: [
    { shortcut: '$mod+KeyF', preventDefault: true, stopPropagation: true },
  ],
  addTable: [{ shortcut: 'Alt+KeyN', preventDefault: true }],
  addColumn: [{ shortcut: 'Alt+Enter', preventDefault: true }],
  addMemo: [{ shortcut: 'Alt+KeyM', preventDefault: true }],
  addTableGroup: [
    { shortcut: 'Alt+KeyG', preventDefault: true, stopPropagation: true },
  ],
  groupSelectedTables: [{ shortcut: 'KeyT KeyG', preventDefault: true }],
  removeTable: [
    { shortcut: '$mod+Backspace', preventDefault: true },
    { shortcut: '$mod+Delete', preventDefault: true },
  ],
  removeColumn: [
    { shortcut: 'Alt+Backspace', preventDefault: true },
    { shortcut: 'Alt+Delete', preventDefault: true },
  ],
  removeSelection: [
    { shortcut: 'Delete', preventDefault: true },
    { shortcut: 'Backspace', preventDefault: true },
  ],
  primaryKey: [{ shortcut: 'Alt+KeyK', preventDefault: true }],
  selectAllTable: [
    { shortcut: '$mod+KeyA', preventDefault: true },
    { shortcut: '$mod+Alt+KeyA', preventDefault: true },
  ],
  selectAllColumn: [{ shortcut: 'Alt+KeyA', preventDefault: true }],
  relationshipZeroOne: [{ shortcut: '$mod+Alt+Digit1', preventDefault: true }],
  relationshipZeroN: [{ shortcut: '$mod+Alt+Digit2', preventDefault: true }],
  relationshipOneOnly: [{ shortcut: '$mod+Alt+Digit3', preventDefault: true }],
  relationshipOneN: [{ shortcut: '$mod+Alt+Digit4', preventDefault: true }],
  tableProperties: [{ shortcut: 'Alt+Space', preventDefault: true }],
  focusView: [
    { shortcut: 'Alt+KeyF', preventDefault: true, stopPropagation: true },
  ],
  handTool: [{ shortcut: 'Space', preventDefault: true }],
  zenMode: [
    { shortcut: 'Alt+KeyZ', preventDefault: true, stopPropagation: true },
  ],
};

// example
editor.setKeyBindingMap({
  addTable: [{ shortcut: '$mod+KeyN', preventDefault: true }],
});

selectAllTable, handTool, removeSelection eta, 4.1.0 bertsiotik aurrera, groupSelectedTables tekla-konbinazioek testu-kurtsoreari lekua uzten diote: fokua input, textarea edo contenteditable elementu batean dagoen bitartean, $mod + A lasterbideak testua hautatzen du, Space teklak zuriune bat idazten du, Delete eta Backspace teklek testua ezabatzen dute, eta T eta ondoren G sakatzeak bi letrak idazten ditu, oihalera iritsi beharrean. Sakatze horietako bat ere ez da eragozten. Haiei esleitzen dizkiezun tekla berriek ere berdin jokatzen dute.

4.0.0 bertsiotik aurrera, removeSelection tekla-konbinazioak (Delete edo Backspace) ERD fitxako hautapena kentzen du desegite-urrats bakar gisa, galdetu gabe. Fokuratutako taula hautatutako gauza bakarra denean, haren zutabe bat edo gehiago hautatuta daudenean eta zoomak haren errenkadak marrazten dituenean, zutabe horiek kentzen ditu; bestela, hautatutako taula, ohar eta taula-talde guztiak kentzen ditu, talde baten taulak mantenduz. Ikus Taulak eta oharrak ezabatzea.
Sakatuta mantendutako tekla batek behin bakarrik kentzen du, eta ez da ezer kentzen gelaxka-editore bat, ohar-editore bat edo taula-talde baten izen-editorea irekita dagoen bitartean. Testu-eremu batetik eta tekla-konbinazioei eusten dieten panel eta fitxetatik kanpo (ikus createKeyBindingMap), sakatzea fitxa guztietan eragozten da editoreak fokua duen bitartean, baita fokuratutako tresna-barrako botoi batean ere, eta irakurtzeko soilik dagoen editore batean, non ez baitu ezer kentzen.

4.1.0 bertsiotik aurrera, addTableGroup tekla-konbinazioak (Alt+KeyG) ERD fitxako New Table Group marrazketa prest jartzen du, eta oihalean botoi nagusiarekin egiten den hurrengo sakatzeak taldea marrazten du; tekla-konbinazioa berriro sakatzeak marrazketa bertan behera uzten du, oihaleko tresna-barrako New Table Group botoiak egiten duen bezala. groupSelectedTables tekla-konbinazioak (KeyT KeyG, T eta ondoren G) hautatutako taulak talde berri batean jartzen ditu eta haren izen-editorea irekitzen du, taula baten laster-menuko Group selected tables aukerak egiten duen bezala. Taularik hautatuta ez badago, ez du ezer gehitzen; hautatutako ohar edo taula-talde bat ez da kontuan hartzen. Ikus Talde bat marraztea eta Hautatutako taulak taldekatzea.
Biek menuek talde bat eskaintzen duten tokian soilik jarduten dute: ez readonly ezarrita dagoen bitartean, ez Table Groups ikuspegi-aukerak taldeak ezkutatzen dituen bitartean, ez gelaxka-editore bat, ohar-editore bat edo taula-talde baten izen-editorea irekita dagoen bitartean. Oihaleko beste tekla-konbinazioak bezala, ERD fitxan soilik jarduten dute, eta ez Bilaketa azkarra, Taularen propietateak, Diferentzia-ikustailea, Denbora-bidaia, Antolaketa automatikoaren aurrebista, Export image edo Map Columns irekita dagoen bitartean. Ezer egiten ez duten tokian, sakatzea eragotzi egiten da oraindik, groupSelectedTables tekla-konbinazioak testu-kurtsoreari lekua uzten dionean izan ezik. addTableGroup tekla-konbinazioaren hedapena ere gelditzen da, focusView eta zenMode tekla-konbinazioena bezala; beraz, orriaren burbuila-faseko keydown entzule batek ez du inoiz entzuten.

4.2.0 bertsiotik aurrera, Hiztegia fitxan, addColumn izenaren sakatze bakarreko tekla-konbinazio bakoitzak hautapenak hartzen dituen adina errenkada txertatzen ditu hautapenaren azpian, tekla-konbinazio berak Shift ere sakatuta gainean txertatzen ditu, eta removeColumn izenaren sakatze bakarreko tekla-konbinazio bakoitzak hautapenak hartzen dituen errenkadak ezabatzen ditu: Alt+Enter, Alt+Shift+Enter, eta Alt+Backspace edo Alt+Delete, balio lehenetsiekin. Domains, Words eta Terms orrietako saretan jarduten dute, gelaxka-ediziorik irekita ez dagoen bitartean. Dagoeneko Shift duen addColumn tekla-konbinazio batek ez du gainean txertatzeko tekla-konbinaziorik ematen, eta bi izenetako bati lotutako sekuentzia batek ez dio saretari ezer ematen.
Horrelako sakatze bakoitza haren aukerak dioen bezala eragozten da, eta haren hedapena beti gelditzen da; beraz, ez du zutaberik gehitzen edo kentzen ERD fitxan. Checks orrian eta irakurtzeko soilik dagoen editore batean ez du ezer egiten, nahiz eta oraindik eragotzi egiten den eta haren hedapena gelditzen den. Irekitako gelaxka-edizio batean edo fitxako bilaketa-eremuan, tekla-konbinazioak testuaren esku geratzen dira: haien hedapena han gelditzen da, baina ez dira eragozten; beraz, eremuak beste edozein tokitan bezala erantzuten die (Mac sisteman, ⌥ + Backspace lasterbideak hitz bat ezabatzen du). dictionaryRowChords funtzioak zerrendatzen ditu.

3.10.0 bertsiotik aurrera, findReplace tekla-konbinazioak ($mod+KeyF) Bilatu eta ordeztu irekitzen du. 4.1.0 bertsiotik aurrera, hura barnean duen Arakatzailea ireki edo ixten du, eta Lasterbideak fitxak Toggle Explorer gisa zerrendatzen du.
Tresna-barrako Explorer botoia sakatuta ageri den bitartean (Arakatzailea ERD fitxan irekita eta zen moduak ezkutatu gabe), Arakatzailea ixten du, Bilaketa azkarra, Taularen propietateak, gai-sortzailea, Bistaratze-hizkuntzaren hautatzailea, Export image elkarrizketa-koadroa edo Map Columns irekita badago izan ezik. Bestela, horietatik irekita dagoena ixten du, beste edozein fitxatatik ERD fitxara aldatzen da, eta Arakatzailea irekitzen du, testu-kurtsorea haren Find eremuan eta bilaketa-testua hautatuta dituela. Arakatzailea oihalaren ondoan erakusteko estuegia den editore batek irekita baina bazterrean mantentzen du, eta Widen the window to show the Explorer jakinarazpena erakusten du. 4.1.0 bertsioa baino lehen, Bilatu eta ordeztu panel flotatzailea irekitzen zuen, edo haren eremuari teklatua itzultzen zion, eta ez zuen inoiz ixten.
Ez dio testu-kurtsoreari lekua uzten: editoreak fokua duen bitartean, fitxa guztietan hartzen da, oihaletik edo editorearen barruko input elementu batetik. Sakatzea eragotzi egiten da, nabigatzaileak bilaketa-barrarik ireki ez dezan, eta haren hedapena gelditzen da, orriko burbuila-faseko keydown entzule batek ere entzun ez dezan. Gelaxka- edo ohar-editore bat irekita dagoenean, 4.0.0 bertsiotik aurrera taula-talde baten izen-editorea, edo 4.2.0 bertsiotik aurrera Hiztegia fitxako saretako gelaxka-edizio bat, oraindik eragotzi egiten da eta haren hedapena gelditzen da, baina ez du ezer egiten. Azken kasu horretan, search tekla-konbinazioak ere ez du ezer egiten; beraz, ordura arte idatzitako testua mantentzen da.
Diferentzia-ikustailea, Denbora-bidaia edo Antolaketa automatikoaren aurrebista irekita dagoen bitartean, edozein fitxatan, edo idazketa-metodo bat oraindik konposatzen ari den bitartean, ez da eragozten eta haren hedapena ez da gelditzen; beraz, nabigatzailearen edo ostalariaren bilaketa propioak jasotzen du. Arakatzailearen barruan, oraindik konposatzen ari den sakatze baten hedapena han gelditzen da, eragotzi gabe. findReplace tekla-konbinazioari esleitzen diozun edozein teklak berdin jokatzen du.

focusView tekla-konbinazioak ERD fitxan soilik jarduten du. Gutxienez taula bat hautatuta dagoenean, Bisualizazioa fitxa irekitzen du Fluxu moduan, taula horietara eta haietatik erlazio bateko distantziara dagoen taula orotara mugatuta; hautatutako ohar edo taula-talde bat ez da kontuan hartzen, eta taularik hautatuta ez badago, ez du ezer egiten. Ikus Taulak fokuratzea.

undo eta redo tekla-konbinazioek fitxaren arabera jarduten dute. ERD fitxan, dokumentuaren historian desegiten eta berregiten dute. 4.2.0 bertsiotik aurrera, Hiztegia fitxan erakusten den orriaren historia propioan desegiten eta berregiten dute, eta ez dute ezer egiten Checks orrian. Ikus Hiztegiaren orriak. Bisualizazioa fitxako Fluxu moduan, atzera eta aurrera egiten dute, Previous table eta Next table botoiek egiten duten bezala, dokumentuaren historia ukitu gabe. Beste fitxetan, eta Grafo moduan, ez dute ezer desegiten.

stop tekla-konbinazioak (Escape) ERD fitxan irekita dagoen gelaxka- edo ohar-editore bat amaitzen du, edo marrazten ari den erlazio bat, eta hautapena dagoen bezala uzten du. 4.0.0 bertsiotik aurrera, taula-talde baten izen-editorea ere amaitzen du, izenik idatzi gabe, eta New Table Group marrazketa bat. Editoreak preventDefault() metodoari deitzen dio sakatze horretan.
Horietako bat ere irekita ez dagoenean, Escape teklak hautapena eta fokuratutako gelaxka garbitzen ditu, eta ez da eragozten. Beraz, edizio batetik irteteko eta hautapena garbitzeko bi sakatze behar dira.
4.2.0 bertsiotik aurrera, izen logikoaren gelaxka baten terminoen zerrenda ageri den bitartean (ikus Termino-izenak osatzea), lehen Escape sakatzeak zerrenda bakarrik ixten du, eta editorea irekita uzten du. Sakatze hori gelaxkan eragotzi egiten da eta haren hedapena han gelditzen da; beraz, ez stop tekla-konbinazioak, ez orriaren burbuila-faseko keydown entzule batek ez dute entzuten.
Arakatzailea, ongietorri-pantailako Import formatuak, izen logikoaren gelaxka baten terminoen zerrenda, Hiztegia fitxa eta beheko hautatzaile eta elkarrizketa-koadroak alde batera utzita, editoreak ez du inoiz Escape teklaren hedapena gelditzen; beraz, berak entzuten duen orri batek, adibidez bere elkarrizketa-koadro bat ixteko, bi sakatzeak entzuten ditu, eta defaultPrevented propietatea true duena salta dezake.
Bilaketa azkarra, Taularen propietateak, Diferentzia-ikustailea, Antolaketa automatikoaren aurrebista edo Denbora-bidaia irekita dagoen bitartean, Escape teklak hori ixten du horren ordez, eta hautapena dagoen bezala uzten du. Sakatze hori ere ez da eragozten.
4.0.0 bertsiotik aurrera, irekita dagoen Export image edo Map Columns elkarrizketa-koadro batek ere Escape hartzen du: bere burua ixten du eta hautapena dagoen bezala uzten du. Bakoitzak teklatua hartzen du irekitzen denean, eta Escape hori eragotzi egiten da eta haren hedapena gelditzen da.
4.1.0 bertsiotik aurrera, fokua Arakatzailearen barruan dagoela, haren zuhaitzean, eremuetan edo botoietan, sakatutako Escape batek teklatua oihalari itzultzen dio, eta Arakatzailea irekita eta hautapena dagoen bezala uzten ditu. Editoreak preventDefault() eta stopPropagation() metodoei deitzen die haren gainean; beraz, ez da inoiz iristen orriaren burbuila-faseko keydown entzule batera.
Oihaleko Escape batek ez du inoiz Arakatzailea ixten. 4.1.0 bertsioa baino lehen, Bilatu eta ordeztu panelaren barruko Escape batek panela ixten zuen, eta oihaleko batek hautapena garbitzen zuen sakatze berean ixten zuen.
4.0.0 bertsiotik aurrera, Bistaratze-hizkuntzaren hautatzailea eta kolore-hautatzailea Escape sakatzean ixten dira: haien barruan eragotzi egiten da eta haren hedapena gelditzen da, eta oihalean, hautapena garbitzen duen sakatze berean ixten dira, ez eragotzita, ez hedapena geldituta.
Idazketa-metodo bat oraindik konposatzen ari den bitartean sakatutako Escape bat konposizioari dagokio. Irekita dagoen editore bat dagoen bezala uzten du, eta ez da eragozten; beraz, orri batek isComposing propietatea true duen edo keyCode propietatea 229 duen sakatze bat ere salta dezake. Arakatzailearen barruan, horrelako sakatze baten hedapena ere gelditzen da, han konposizio erdian sakatutako edozein teklarena bezala, eta teklatua eremuan geratzen da.
3.9.2 bertsioa baino lehen, Escape sakatze bakar batek edizio edo marrazketa bat amaitzen zuen eta hautapena garbitzen zuen, eta editoreak ez zuen inoiz eragozten.

createKeyBindingMap

3.9.2 bertsiotik aurrera, paketeak createKeyBindingMap() esportatzen du, eta harekin batera KeyBindingMap, KeyBindingName eta ShortcutOption motak.
Tekla-konbinazio lehenetsiak itzultzen ditu, 28 izenak, finkoak barne, mapa berri gisa dei bakoitzean; beraz, itzultzen duen mapa aldatzeak ez du beste ezer aldatzen.
Editore guztiak horretatik abiatzen dira, eta setKeyBindingMap dei bat ez da bertan islatzen.
Lau horietatik, createKeyBindingMap da exekuzio-garaiko esportazio bakarra; beste hirurak motak dira. 4.2.0 bertsiotik aurrera, dictionaryRowChords ere esportatzen da haren ondoan.

type KeyBindingName =
  | 'edit'
  | 'stop'
  | 'search'
  | 'findReplace'
  | 'undo'
  | 'redo'
  | 'addTable'
  | 'addColumn'
  | 'addMemo'
  | 'addTableGroup'
  | 'groupSelectedTables'
  | 'removeTable'
  | 'removeColumn'
  | 'removeSelection'
  | 'primaryKey'
  | 'selectAllTable'
  | 'selectAllColumn'
  | 'relationshipZeroOne'
  | 'relationshipZeroN'
  | 'relationshipOneOnly'
  | 'relationshipOneN'
  | 'tableProperties'
  | 'focusView'
  | 'zoomIn'
  | 'zoomOut'
  | 'zoomReset'
  | 'handTool'
  | 'zenMode';

type KeyBindingMap = Record<KeyBindingName, ShortcutOption[]>;

declare function createKeyBindingMap(): KeyBindingMap;

// example
import { createKeyBindingMap } from '@dineug/erd-editor';

const shortcuts = Object.values(createKeyBindingMap())
  .flat()
  .map(({ shortcut }) => shortcut); // 'Enter', 'Escape', '$mod+KeyK', ...

shortcut bakoitza tinykeys sintaxiko lasterbide bat da, tekla KeyboardEvent.code bidez izendatzen duena; $mod ⌘ da macOS sisteman, eta Control gainerakoetan.
4.0.0 bertsiotik aurrera, editoreak berak irakurtzen ditu lasterbide horiek, tinykeys bidez egin beharrean, sintaxi berean. Tekla bat bat dator bere code balioagatik edo bere key balioagatik, maiuskulak eta minuskulak bereizi gabe, eta sakatze bat izendatzen dituen tekla aldatzaileak, eta horiek bakarrik, sakatuta daudenean soilik dator bat. AltGraph Control eta Alt gisa hartzen da Windows sisteman, eta Alt gisa macOS sisteman. Zuriune batez bereizitako sakatzeek sekuentzia bat osatzen dute, eta sekuentzia berriz hasten da keydown gertaerarik gabe segundo bat igarotzen denean.
4.1.0 bertsiotik aurrera, balio lehenetsietako bat sekuentzia bat da: groupSelectedTables KeyT KeyG da, T eta ondoren G. Sekuentzia bat hura osatzen duen sakatzean exekutatzen da, eta sakatze horrek soilik hartzen ditu haren preventDefault eta stopPropagation; beraz, balio lehenetsiekin T orrira iristen da, eta G soilik eragozten da. Menuek, Bilaketa azkarrak eta Lasterbideak fitxak sekuentzia bat sakatze bakoitzeko tekla bat erakutsiz bistaratzen dute.
Izen finkoak honela lotuta daude: Enter (edit), Escape (stop), $mod+KeyZ (undo), $mod+Shift+KeyZ (redo), $mod+Equal (zoomIn), $mod+Minus (zoomOut) eta $mod+Digit0 (zoomReset). edit eta stop izenek ez dute markarik; beste bostek preventDefault eta stopPropagation dituzte. Gainerakoak goiko balio lehenetsiak dira, search eta findReplace haien artean.

Editoreak bere elementuan entzuten ditu hauek; beraz, editoreak baino lehen teklak hartzen dituen ostalari batek, lasterbide globalekin edo kaptura-faseko keydown entzule batekin, igarotzen utzi behar ditu editoreak fokua duen bitartean.
Eraiki igarotzen utzi beharreko zerrenda createKeyBindingMap() funtziotik abiatuta, setKeyBindingMap metodoari pasatu dizkiozun tekla-konbinazioak lehenetsien ordez jarrita.
3.10.0 bertsiotik aurrera, zerrenda horrek $mod+KeyF barne hartzen du, nabigatzailearen beraren bilaketa-lasterbidea. Lasterbide horretan bere bilaketa mantendu nahi duen ostalari batek setKeyBindingMap({ findReplace: [] }) pasatzen du.
4.0.0 bertsiotik aurrera, Delete eta Backspace soilak ere barne hartzen ditu. Tekla horiek mantendu nahi dituen ostalari batek setKeyBindingMap({ removeSelection: [] }) pasatzen du.
4.1.0 bertsiotik aurrera, Alt+KeyG eta KeyT KeyG sekuentzia ere barne hartzen ditu, eta azken hori kate bakar gisa dator: zatitu zuriunean eta utzi sakatze bakoitza igarotzen, T eta G soilak barne, sakatze bat falta zaion sekuentzia ez baita inoiz osatzen. Tekla horiek mantendu nahi dituen ostalari batek setKeyBindingMap({ addTableGroup: [] }) edo setKeyBindingMap({ groupSelectedTables: [] }) pasatzen du.
4.2.0 bertsiotik aurrera, gehitu zerrendari dictionaryRowChords funtzioak mapa berarentzat itzultzen dituen tekla-konbinazioak, Alt+Shift+Enter haien artean. Tekla horiek mantendu nahi dituen ostalari batek setKeyBindingMap({ addColumn: [] }) edo setKeyBindingMap({ removeColumn: [] }) pasatzen du, eta, horrela, tekla horiek ERD fitxan ere ez dute zutaberik gehitzen edo kentzen.

Fokua Arakatzailearen barruan dagoen bitartean, haren zuhaitzean, Find eta Replace eremuetan edo botoietan, findReplace, search, undo, redo, zoomIn, zoomOut eta zoomReset editorera igarotzen dira; beraz, findReplace tekla-konbinazioak han oihalean bezala jarduten du. Beste tekla-konbinazio guztiak, unean ezarrita dauden bezala, Arakatzailean gelditzen dira, sekuentzia bat bere azken sakatzean (G soil bat balio lehenetsiekin), eta gauza bera gertatzen da gezi-teklekin, Tab, Enter, Space, Home eta End teklekin, eta idazketa-metodo bat oraindik konposatzen ari den bitartean sakatutako edozein teklarekin. Escape alde batera utzita, teklatua oihalari itzultzen baitio, horien hedapena gelditzen da eragotzi gabe; beraz, tekla arrunt gisa jarduten dute Arakatzailearen eremuetan, botoietan eta zuhaitzean, eta ez dira iristen ez oihalera, ez orriaren burbuila-faseko keydown entzule batera: han Alt + N lasterbideak ez du taularik gehitzen, eta Delete teklak ez du ezer kentzen. Zuhaitzean mugitzeko, tolesteko edo zuhaitzeko errenkada batera joateko teklak, eta Find edo Replace eremuko Enter, bat-etortzeen artean mugitzen dena edo ordezten duena, eragotzi ere egiten dira.
Beste edozein tekla, hala nola ostalari baten gordetzeko edo komando-paletako lasterbidea, orrira doa ohi bezala. Ikus Arakatzaileko teklak. 4.1.0 bertsioa baino lehen, Bilatu eta ordeztu panel flotatzaileak teklak modu berean atxikitzen zituen, Home, End, sekuentzia baten azken sakatzea eta Space, handTool beste tekla bati lotuta zegoen bitartean, izan ezik.
4.0.0 bertsiotik aurrera, Bistaratze-hizkuntzaren hautatzaileak teklak modu berean atxikitzen ditu: zazpi tekla-konbinazio berak igarotzen dira, eta beste tekla-konbinazio guztien (4.1.0 bertsiotik aurrera, sekuentzia bat bere azken sakatzean), gezi-teklen eta Tab teklaren hedapena han gelditzen da eragotzi gabe, baita idazketa-metodo bat oraindik konposatzen ari den bitartean sakatutako edozein teklarena ere. Haren errenkadetako batean, ↑, ↓, Home, End, Enter eta Space teklekin errenkaden artean mugitzen da edo bat aukeratzen da, eta tekla horiek eragotzi ere egiten dira.

4.2.0 bertsiotik aurrera, Hiztegia fitxak ere teklak atxikitzen ditu, eta search, findReplace, undo eta redo bakarrik igarotzen dira editorera. undo eta redo tekla-konbinazioek erakusten den orriaren historia propioan jarduten dute, eta gelaxka-edizio bat irekita dagoenean edo fokua fitxako bilaketa-eremuan dagoenean, testuaren esku geratzen dira: haien hedapena han gelditzen da, baina ez dira eragozten. search eta findReplace tekla-konbinazioek ez dute ezer egiten gelaxka-edizio bat irekita dagoen bitartean, goian azaldu bezala. Errenkaden tekla-konbinazioek saretan jarduten dute, goian addColumn eta removeColumn izenei buruz azaldu bezala.
Beste tekla-konbinazio guztiak, unean ezarrita dauden bezala, fitxan gelditzen dira, sekuentzia bat bere azken sakatzean, eta gauza bera gertatzen da gezi-teklekin, Tab, Enter, Space, Home eta End teklekin, eta idazketa-metodo bat oraindik konposatzen ari den bitartean sakatutako edozein teklarekin. Horietako bat ere ez da iristen ez oihalera, ez orriaren burbuila-faseko keydown entzule batera: han Alt + N lasterbideak ez du taularik gehitzen, eta Delete teklak ez du ezer kentzen diagraman. Fitxako kopiatze-, ebakitze- eta itsaste-gertaerak ere han gelditzen dira; beraz, diagramak ez ditu inoiz bereak balira bezala irakurtzen. Beste edozein tekla orrira doa ohi bezala.

dictionaryRowChords

4.2.0 bertsiotik aurrera, paketeak dictionaryRowChords() esportatzen du. Pasatzen duzun tekla-konbinazioen maparen arabera Hiztegia fitxako saretak errenkadak txertatzeko edo ezabatzeko erabiltzen dituen tekla-konbinazio guztiak itzultzen ditu, ShortcutOption[] berri gisa dei bakoitzean.
Ordenan, hauek dira: addColumn izenaren sakatze bakarreko tekla-konbinazioak, hautapenaren azpian errenkadak txertatzen dituztenak; horietako bakoitza Shift ere sakatuta, gainean errenkadak txertatzen dituena, bat ere ez dagoeneko Shift duen tekla-konbinazio batentzat; eta removeColumn izenaren sakatze bakarreko tekla-konbinazioak, errenkadak ezabatzen dituztenak. Bakoitzak datorren tekla-konbinazioaren preventDefault eta stopPropagation mantentzen ditu, eta sekuentziak kanpoan geratzen dira. Ikus Errenkadak gehitzea eta ezabatzea.
Gainean errenkadak txertatzen dituen tekla-konbinazioa, Alt+Shift+Enter balio lehenetsiekin, ez dago inongo izeni lotuta; beraz, tekla aldatzaileak zehatz-mehatz parekatzen dituen eta igarotzen utzi beharreko teklen zerrenda createKeyBindingMap funtziotik bakarrik eraikitzen duen ostalari batek ez du inoiz igarotzen uzten. Utzi bi zerrendak igarotzen, Obsidian pluginak egiten duen bezala.
Ematen zaion mapa bakarrik irakurtzen du, ez elementuaren tekla-konbinazioak; beraz, pasatu teklen zerrenda eraikitzeko erabili duzun mapa.

declare function dictionaryRowChords(
  keyBindingMap: KeyBindingMap
): ShortcutOption[];

// example
import { createKeyBindingMap, dictionaryRowChords } from '@dineug/erd-editor';

const map = createKeyBindingMap();
const shortcuts = [
  ...Object.values(map).flat(),
  ...dictionaryRowChords(map),
].map(({ shortcut }) => shortcut);
// dictionaryRowChords(map): 'Alt+Enter', 'Alt+Shift+Enter', 'Alt+Backspace', 'Alt+Delete'

$mod

Control tekla ingurunearen arabera aldatzen du.

• Mac: $mod = Meta (⌘)
• Windows/Linux: $mod = Control

Lasterbideen taula

Teklatu-gertaeren key, code propietateak erabiltzen ditu.
Erabili code posizio absolutuetarako eta key sarrera-balioetarako.

Windows	macOS	key	code
Ez dago	Command / ⌘	Meta	MetaLeft / MetaRight
Alt	Option / ⌥	Alt	AltLeft / AltRight
Control	Control / ^	Control	ControlLeft / ControlRight
Shift	Shift	Shift	ShiftLeft / ShiftRight
Space	Space	Ez dago	Space
Enter	Return	Enter	Enter
Esc	Esc	Escape	Escape
Backspace	Delete / ⌫	Backspace	Backspace
Delete	fn + Delete	Delete	Delete
1, 2, eta abar	1, 2, eta abar	1, 2, eta abar	Digit1, Digit2, eta abar
a, b, eta abar	a, b, eta abar	a, b, eta abar	KeyA, KeyB, eta abar
-	-	-	Minus
=	=	=	Equal
+	+	+	Equal

Gaia

setPresetTheme

Gai aurrezarri bat ezartzen du.
Balio lehenetsiak appearance: 'dark', grayColor: 'slate' eta accentColor: 'indigo' dira.
Eremu bakoitza bere aldetik aplikatzen da; beraz, dei partzial batek beste biak dauden bezala uzten ditu. Beheko izenetako bat ez den balio bat ez da kontuan hartzen, eta deiak ez du inoiz errorerik jaurtitzen.
4.0.0 bertsiotik aurrera, appearance propietateak 'system' ere onartzen du, gai-sortzaileko System aukera. Sistema eragileak jakinarazten duen itxura argia edo iluna erakusten du, edo setSystemAppearance metodoak izendatzen duena, eta hura aldatzen denean aldatu egiten da.

type ThemeOptions = {
  appearance: 'dark' | 'light' | 'system';
  grayColor: 'gray' | 'mauve' | 'slate' | 'sage' | 'olive' | 'sand';
  accentColor:
    | 'gray'
    | 'gold'
    | 'bronze'
    | 'brown'
    | 'yellow'
    | 'amber'
    | 'orange'
    | 'tomato'
    | 'red'
    | 'ruby'
    | 'crimson'
    | 'pink'
    | 'plum'
    | 'purple'
    | 'violet'
    | 'iris'
    | 'indigo'
    | 'blue'
    | 'cyan'
    | 'teal'
    | 'jade'
    | 'green'
    | 'grass'
    | 'lime'
    | 'mint'
    | 'sky';
};

// example
editor.setPresetTheme({ appearance: 'light' });

setSystemAppearance

4.0.0 bertsiotik aurrera, 'system' itxurak erakusten duen argia edo iluna izendatzen du, itxura argi eta ilun propioak dituen ostalari baterako, hala nola IDE baten gaia. Bat izendatuta dagoen bitartean, sistema eragilearen aldaketak ez dira kontuan hartzen.
null, edo 'dark' edo 'light' ez den beste edozein balio, sistema eragileari jarraitzera itzultzen da.
Itxura 'light' edo 'dark' den bitartean, ez du ezer aldatzen pantailan, baina balioa gordetzen da eta itxura 'system' bihurtu bezain laster aplikatzen da. Bestela, berehala aplikatzen da. Ez du ezer igortzen, eta changePresetTheme gertaerak 'system' jakinarazten jarraitzen du.
VS Code, JetBrains eta Obsidian ostalariek metodo honi deitzen diote beren itxura argi edo ilunarekin, eta berriro hura aldatzen den bakoitzean.

editor.setPresetTheme({ appearance: 'system' });
editor.setSystemAppearance('light'); // null follows the OS again

setTheme

Gaia pertsonalizatzeko aukera ematen du.
Dei bakoitzak geruza pertsonalizatu osoa ordezten du; beraz, lehendik dagoen gainidazketa baten gainean token bakar bat aldatzeko, pasatu objektu osoa berriro, eta pasatu {} gai aurrezarrira itzultzeko.
Beheko token-izenak soilik gordetzen dira, kate-balioekin; beste edozer baztertu egiten da, errorerik gabe.
Geruza gai aurrezarriaren gainean dago; beraz, geroagoko setPresetTheme dei batek azpiko gai aurrezarria aldatzen du, eta zure gainidazketek bere horretan jarraitzen dute.

JavaScript

type Theme = {
  grayColor1: string;
  grayColor2: string;
  grayColor3: string;
  grayColor4: string;
  grayColor5: string;
  grayColor6: string;
  grayColor7: string;
  grayColor8: string;
  grayColor9: string;
  grayColor10: string;
  grayColor11: string;
  grayColor12: string;

  accentColor1: string;
  accentColor2: string;
  accentColor3: string;
  accentColor4: string;
  accentColor5: string;
  accentColor6: string;
  accentColor7: string;
  accentColor8: string;
  accentColor9: string;
  accentColor10: string;
  accentColor11: string;
  accentColor12: string;

  canvasBackground: string;
  canvasBoundaryBackground: string;

  tableBackground: string;
  tableHeaderBackground: string;
  tableSelect: string;
  tableBorder: string;
  tableShadow: string;

  tableGroupHeaderBackground: string;
  tableGroupBackground: string;
  tableGroupBorder: string;

  memoBackground: string;
  memoSelect: string;
  memoBorder: string;
  memoShadow: string;

  columnSelect: string;
  columnSelectHover: string;
  columnHover: string;

  columnHandleBackground: string;
  columnHandleBorder: string;
  columnHandleHoverBackground: string;
  columnHandleHoverBorder: string;

  relationshipHover: string;

  visualizationLink: string;
  visualizationColumn: string;
  visualizationRelationship: string;

  toolbarBackground: string;

  contextMenuBackground: string;
  contextMenuSelect: string;
  contextMenuHover: string;
  contextMenuBorder: string;

  minimapBorder: string;
  minimapShadow: string;
  minimapViewportBorder: string;
  minimapViewportBorderHover: string;

  toastBackground: string;
  toastBorder: string;
  toastSuccess: string;
  toastError: string;

  findReplaceError: string;

  mapColumnsError: string;

  schemaSqlWarningBackground: string;
  schemaSqlWarningForeground: string;

  dragSelectBackground: string;
  dragSelectBorder: string;

  scrollbarTrack: string;
  scrollbarThumb: string;
  scrollbarThumbHover: string;

  foreground: string;
  active: string;
  placeholder: string;

  focus: string;
  inputActive: string;

  keyPK: string;
  keyFK: string;
  keyPFK: string;

  treeBackground: string;
  treeRowHover: string;
  treeRowCurrent: string;
  treeMuted: string;
  treeMatch: string;

  explorerBackground: string;
  explorerBorder: string;

  dictionaryErrorForeground: string;
  dictionaryErrorBackground: string;
  dictionaryWarningForeground: string;
  dictionaryWarningBackground: string;
  dictionaryBackground: string;
  dictionaryHeaderBackground: string;
  dictionaryGridLine: string;
  dictionaryHeaderSelect: string;

  diffInsertForeground: string;
  diffDeleteForeground: string;
  diffModifyForeground: string;
  diffRenameForeground: string;
};

// example
editor.setTheme({
  canvasBackground: '#1b1b1f',
  tableBackground: '#242429',
  keyPK: '#ffc53d',
});

tableShadow eta memoShadow taulek eta oharrek ERD oihalean egiten duten itzalaren kolorea dira. Gai aurrezarri ilunak transparent balioan uzten ditu, eta horrek ez du itzalik egiten, setTheme metodoari none edo kate huts bat pasatzeak bezala; gai aurrezarri argiak rgba(0, 0, 0, 0.18) erabiltzen du.

4.0.0 bertsiotik aurrera, beste bederatzi token daude:

• tableGroupHeaderBackground, tableGroupBackground eta tableGroupBorder tokenek kolore propiorik ez duen taula-talde baten titulu-barra, gorputza eta ingerada koloreztatzen dituzte.
• toastSuccess eta toastError tokenek zerbait nola amaitu den jakinarazten duen jakinarazpen baten marka koloreztatzen dute.
• findReplaceError eta mapColumnsError tokenek Bilatu eta ordeztu funtzioak eta Mapatu zutabeak elkarrizketa-koadroak erakusten dituzten erroreak koloreztatzen dituzte. Bilatu eta ordeztu funtzioak diffDeleteForeground erabiltzen zuen lehen; beraz, token hori gainidazteak jada ez du Bilatu eta ordeztu funtzioaren kolorea aldatzen.
• schemaSqlWarningBackground eta schemaSqlWarningForeground tokenek SQL eskema fitxako aukeretako abisuak koloreztatzen dituzte.

4.1.0 bertsiotik aurrera, beste bederatzi token daude:

• treeBackground, treeRowHover, treeRowCurrent, treeMuted eta treeMatch tokenek Arakatzaileak eta Diferentzia-ikustaileak partekatzen duten zuhaitza koloreztatzen dute: haren atzeko planoa, Arakatzailearen Find eta Replace eremuak ere betetzen dituena; erakuslearen azpiko errenkada bat, teklatuaren errenkada zuhaitzak fokua duen bitartean, eta Arakatzailearen goiburuko eta bilaketako erakuslearen azpiko botoi bat; uneko bilaketaren bat-etortzearen errenkada; testu lausotua, hala nola kopuruak, datu motak eta tolesteko geziak; eta bilaketa batek aurkitutako testuaren atzeko marka.
• explorerBackground eta explorerBorder tokenek Arakatzailearen panela eta haren marrak koloreztatzen dituzte: oihalaren ondoko ertza, bilaketaren azpiko marra, eta haren eremuen eta Search In aukerak zabaltzen dituen botoien ertzak. explorerBorder tokenak Diferentzia-ikustailearen zuhaitzaren ertza, haren Filter by name eremuaren azpiko marra eta eremu horren ertza ere marrazten ditu. Arakatzailearen gako-ikonoek keyPK, keyFK eta keyPFK hartzen dituzte.
• diffModifyForeground eta diffRenameForeground tokenek Diferentzia-ikustaileak aldatutzat eta izena aldatutzat markatzen duena koloreztatzen dute, haren zuhaitzean eta bi dokumentuetan. diffModifyForeground tokenak mugitu, tamainaz aldatu, kolorez aldatu edo taldez aldatu den taula, ohar edo taula-talde baten ingerada ere marrazten du, bertan beste zer aldatu den gorabehera, eta aldatu den gako arrotz baten konektorea marrazten du.

diffInsertForeground eta diffDeleteForeground tokenek, orain, Diferentzia-ikustaileak gehitutzat eta kendutzat markatzen duena koloreztatzen dute, haren zuhaitzean eta hura duen dokumentuan, testuan, ingeradetan eta konektoreetan berdin. diffInsertBackground, diffDeleteBackground, diffCrossBackground eta diffCrossForeground 4.1.0 bertsioan kendu ziren, Diferentzia-ikustaileak jada ez baititu gelaxkak betetzen. setTheme metodoak baztertu egiten ditu, Theme motan ez dagoen beste edozein izen bezala, eta haien kakoak, --erd-editor-diff-insert-background, --erd-editor-diff-delete-background, --erd-editor-diff-cross-background eta --erd-editor-diff-cross-foreground, jada ez dira irakurtzen.

4.2.0 bertsiotik aurrera, beste hamabi token daude:

• columnHandleBackground eta columnHandleBorder tokenek zutabea arrastatzeko heldulekua betetzen dute eta haren ingerada marrazten dute; taula baten ezkerreko ertzaren kanpoaldean marrazten da, ertzetik hurbil, fokuratutako zutabe-errenkada baten ondoan, eta columnHandleHoverBackground eta columnHandleHoverBorder tokenek hartzen dute haien lekua erakuslea haren gainean dagoen bitartean. Haren heldulekuaren ikonoak foreground hartzen du, eta active erakuslearen azpian dagoenean.
• dictionaryErrorForeground eta dictionaryWarningForeground tokenek hiztegiaren egiaztapenek aurkitzen dutena koloreztatzen dute, errore bat edo abisu bat: ERD oihalean seinalatutako izen bat (ikus Oihaleko markak), Domains, Words eta Terms orrietan seinalatutako gelaxka baten testua, eta Checks botoiko kopurua. dictionaryErrorBackground eta dictionaryWarningBackground tokenek horrelako gelaxka bat betetzen dute. dictionaryErrorForeground tokenak Delete Rows tresna ere koloreztatzen du erakuslearen azpian dagoenean.
• dictionaryBackground, dictionaryHeaderBackground, dictionaryGridLine eta dictionaryHeaderSelect tokenek Hiztegia fitxako orria koloreztatzen dute: haren gelaxkak, kolore berak fitxako bilaketa-eremua eta termino baten domeinu-zerrenda ere betetzen dituela; haren zutabe-goiburuak eta errenkada-zenbakiak; gelaxken arteko marrak, kolore berak fitxako barra eta haren eremuen ertzak ere marrazten dituela; eta errenkadak edo zutabeak hautapenarekin bat egiten duen goiburu bat. Orriaren gainerakoak token partekatuak hartzen ditu: foreground goiburuetako etiketetarako, active gelaxken testurako, grayColor7 zutabe-goiburuak eta errenkada-zenbakiak gelaxketatik bereizten dituen marrarako, focus gelaxka aktiboaren ertzerako, accentColor9 hautatutako barruti baten ertzerako eta, % 20ko opakutasunarekin, haren betegarrirako, accentColor6 osorik hautatutako errenkada edo zutabe baten goibururako, grayColor3 irakurtzeko soilik diren gelaxketarako, eta korritze-barraren tokenak. #rgb edo #rrggbb gisa idatzita ez dagoen accentColor9 batek hautatutako barrutia bete gabe uzten du.

CSS aldagaiak

Theme motako token bakoitzak bat datorren CSS kako bat du, --erd-editor- gehi kebab-case formatuko gakoa izenekoa: grayColor10 --erd-editor-gray-color-10 da, keyPK --erd-editor-key-pk da, eta keyPFK --erd-editor-key-pfk da.
Kakoak editorearen barrura heredatzen dira; beraz, ezarri aplikatzea nahi duzun tokian. :root hautatzailean, orriko editore guztiei aplikatzen diete gaia; elementuan bertan, horri bakarrik.

erd-editor {
  --erd-editor-canvas-background: #1b1b1f;
}

3.4.0 bertsiotik aurrera, gaizki idatzitako dargSelect tokenak dragSelect idazten dira, eta haien kakoak --erd-editor-darg-select-background eta --erd-editor-darg-select-border izatetik --erd-editor-drag-select-background eta --erd-editor-drag-select-border izatera aldatu ziren. Izen zaharrak oraindik erabiltzen dituen estilo-orri bat ez da kontuan hartzen.

Gaiaren balio lehenetsiak

:root {
  --erd-editor-gray-color-1: #111113;
  --erd-editor-gray-color-2: #18191b;
  --erd-editor-gray-color-3: #212225;
  --erd-editor-gray-color-4: #272a2d;
  --erd-editor-gray-color-5: #2e3135;
  --erd-editor-gray-color-6: #363a3f;
  --erd-editor-gray-color-7: #43484e;
  --erd-editor-gray-color-8: #5a6169;
  --erd-editor-gray-color-9: #696e77;
  --erd-editor-gray-color-10: #777b84;
  --erd-editor-gray-color-11: #b0b4ba;
  --erd-editor-gray-color-12: #edeef0;
  --erd-editor-accent-color-1: #11131f;
  --erd-editor-accent-color-2: #141726;
  --erd-editor-accent-color-3: #182449;
  --erd-editor-accent-color-4: #1d2e62;
  --erd-editor-accent-color-5: #253974;
  --erd-editor-accent-color-6: #304384;
  --erd-editor-accent-color-7: #3a4f97;
  --erd-editor-accent-color-8: #435db1;
  --erd-editor-accent-color-9: #3e63dd;
  --erd-editor-accent-color-10: #5472e4;
  --erd-editor-accent-color-11: #9eb1ff;
  --erd-editor-accent-color-12: #d6e1ff;
  --erd-editor-canvas-background: #212225;
  --erd-editor-canvas-boundary-background: #111113;
  --erd-editor-table-background: #18191b;
  --erd-editor-table-header-background: #2e3135;
  --erd-editor-table-select: #435db1;
  --erd-editor-table-border: #363a3f;
  --erd-editor-table-shadow: transparent;
  --erd-editor-table-group-header-background: #43484e;
  --erd-editor-table-group-background: #d3edf81d;
  --erd-editor-table-group-border: #43484e;
  --erd-editor-memo-background: #18191b;
  --erd-editor-memo-select: #435db1;
  --erd-editor-memo-border: #363a3f;
  --erd-editor-memo-shadow: transparent;
  --erd-editor-column-select: #182449;
  --erd-editor-column-select-hover: #1d2e62;
  --erd-editor-column-hover: #272a2d;
  --erd-editor-column-handle-background: #18191b;
  --erd-editor-column-handle-border: #363a3f;
  --erd-editor-column-handle-hover-background: #2e3135;
  --erd-editor-column-handle-hover-border: #43484e;
  --erd-editor-relationship-hover: #435db1;
  --erd-editor-visualization-link: #43484e;
  --erd-editor-visualization-column: #5a6169;
  --erd-editor-visualization-relationship: #5a6169;
  --erd-editor-toolbar-background: #111113;
  --erd-editor-context-menu-background: #18191b;
  --erd-editor-context-menu-select: #272a2d;
  --erd-editor-context-menu-hover: #3a4f97;
  --erd-editor-context-menu-border: #363a3f;
  --erd-editor-minimap-border: black;
  --erd-editor-minimap-shadow: black;
  --erd-editor-minimap-viewport-border: #3a4f97;
  --erd-editor-minimap-viewport-border-hover: #435db1;
  --erd-editor-toast-background: #18191b;
  --erd-editor-toast-border: #363a3f;
  --erd-editor-toast-success: #3dd68c;
  --erd-editor-toast-error: #ff9592;
  --erd-editor-find-replace-error: #ff9592;
  --erd-editor-map-columns-error: #ff9592;
  --erd-editor-schema-sql-warning-background: #500f1c;
  --erd-editor-schema-sql-warning-foreground: #ff9592;
  --erd-editor-drag-select-background: #253974;
  --erd-editor-drag-select-border: #435db1;
  --erd-editor-scrollbar-track: #ddeaf814;
  --erd-editor-scrollbar-thumb: #696e77;
  --erd-editor-scrollbar-thumb-hover: #777b84;
  --erd-editor-foreground: #b0b4ba;
  --erd-editor-active: #edeef0;
  --erd-editor-placeholder: #e5edfd7b;
  --erd-editor-focus: #435db1;
  --erd-editor-input-active: #5472e4;
  --erd-editor-key-pk: #ffc53d;
  --erd-editor-key-fk: #e54666;
  --erd-editor-key-pfk: #00a2c7;
  --erd-editor-tree-background: #111113;
  --erd-editor-tree-row-hover: #212225;
  --erd-editor-tree-row-current: #1d2e62;
  --erd-editor-tree-muted: #b0b4ba;
  --erd-editor-tree-match: #253974;
  --erd-editor-explorer-background: #111113;
  --erd-editor-explorer-border: #363a3f;
  --erd-editor-dictionary-error-foreground: #ff9592;
  --erd-editor-dictionary-error-background: #500f1c;
  --erd-editor-dictionary-warning-foreground: #ffca16;
  --erd-editor-dictionary-warning-background: #3f2700;
  --erd-editor-dictionary-background: #18191b;
  --erd-editor-dictionary-header-background: #2e3135;
  --erd-editor-dictionary-grid-line: #363a3f;
  --erd-editor-dictionary-header-select: #182449;
  --erd-editor-diff-insert-foreground: #3dd68c;
  --erd-editor-diff-delete-foreground: #ff9592;
  --erd-editor-diff-modify-foreground: #ffca16;
  --erd-editor-diff-rename-foreground: #70b8ff;
}

Bistaratze-hizkuntza

4.0.0 bertsiotik aurrera, editorearen testu propioa — haren menuak, panelak, elkarrizketa-koadroak, Bilaketa azkarra, jakinarazpenak eta diagraman marrazten dituen hitzak, hala nola unnamed, irudi-esportazioak barne — 25 hizkuntzatan dago. Taulen eta zutabeen izenak, SQLa, datu motak eta sortutako kodea ez dira inoiz itzultzen. Ikus Hizkuntza eta gaia.
setLocale metodoari deitu edo hizkuntza bat aukeratu aurretik, editoreak ingelesa erakusten du, edo 'system' balioari jarraitzen dio enableLocalePicker aktibatuta dagoen bitartean.
Editoreak lang eta dir bere erroan ezartzen ditu, shadow root itxiaren barruan, inoiz ez elementu ostalarian edo orrian; beraz, eskuinetik ezkerrera doan orri batek ez du editorea iraultzen, eta eskuinetik ezkerrera idazten den hizkuntza batek ez du orria iraultzen. Hebreerak, arabierak eta persierak editorearen interfazea eskuinetik ezkerrera antolatzen dute; diagrama bera ez da inoiz ispilatzen. 4.1.0 bertsiotik aurrera, Arakatzailea oihalaren ezkerrean geratzen da hizkuntza guztietan, eta haren errenkadak eskuinetik ezkerrera irakurtzen dira hiru horietan.
Paketeak LocaleCode (beheko kodeetako bat) eta LocaleOption motak esportatzen ditu.

type LocaleOption = LocaleCode | 'system';

Kodea	Honela ageri da	Hizkuntza
id-ID	Bahasa Indonesia	Indonesiera
de-DE	Deutsch	Alemana
en	English	Ingelesa
es-ES	Español	Gaztelania
eu-ES	Euskara	Euskara
fr-FR	Français	Frantsesa
it-IT	Italiano	Italiera
nl-NL	Nederlands	Nederlandera
pl-PL	Polski	Poloniera
pt-PT	Português	Portugesa
pt-BR	Português Brasileiro	Brasilgo portugesa
ro-RO	Română	Errumaniera
sk-SK	Slovenčina	Eslovakiera
sl-SI	Slovenščina	Esloveniera
sv-SE	Svenska	Suediera
tr-TR	Türkçe	Turkiera
ru-RU	Русский	Errusiera
uk-UA	Українська	Ukrainera
he-IL	עברית	Hebreera
ar-SA	العربية	Arabiera
fa-IR	فارسی	Persiera
ja-JP	日本語	Japoniera
zh-CN	简体中文	Txinera sinplifikatua
zh-TW	繁體中文	Txinera tradizionala
ko-KR	한국어	Koreera

setLocale

Bistaratze-hizkuntza ezartzen du: 'system', edo goiko kodeetako bat. Beste edozer, hala nola 'ko' soil bat, kode ezezagun bat edo kate ez den balio bat, ez da kontuan hartzen, errorerik gabe.
Metodoak itzuli aurretik aplikatzen da; beraz, elementua erantsi aurretik ezarritako hizkuntza haren lehen fotograman ageri da.
Ez du ezer igortzen, ez changeLocale ez change, eta ez du ukitzen ez value, ez desegite-historia, ez biltegi partekatu bat.
Aukerak bere horretan jarraitzen du enableLocalePicker aktibatuta zein desaktibatuta egon, eta setLocale('system') deiak sistemari jarraitzen dio hautatzailea desaktibatuta dagoenean ere.
Editoreak ez du ezer gordetzen. Irakurle baten aukera mantentzeko, entzun changeLocale gertaera eta pasatu berriro hurrengo kargan.

editor.enableLocalePicker = true;
editor.setLocale(localStorage.getItem('locale') ?? 'system');
editor.addEventListener('changeLocale', event => {
  localStorage.setItem('locale', event.detail.locale);
});

setSystemLocale

'system' aukerak adierazten duen hizkuntza izendatzen du, BCP 47 etiketa gisa, bistaratze-hizkuntza propioa duen ostalari baterako. VS Code, JetBrains eta Obsidian ostalariek metodo honi deitzen diote beren bistaratze-hizkuntzarekin.
Etiketaren hasierako eta amaierako zuriuneak kentzen dira. null, kate huts bat edo kate ez den balio bat nabigatzailearen navigator.languages propietatera itzultzen da, eta editoreak hari jarraitzen dio aldatzen den heinean.
Indarrean dagoen aukera 'system' den bitartean soilik du eragina, eta berehala aplikatzen da. Hautatzailearen System errenkadak zein hizkuntzatara ebazten den izendatzen du.
Etiketa, edo nabigatzailearen hizkuntza bakoitza ordenan, editoreak duen lehen hizkuntzara ebazten da, hizkuntza-azpietiketaren arabera, maiuskulak eta minuskulak eta azpimarrak kontuan hartu gabe: de-AT etiketak de-DE ematen du, eta en-GB etiketak en. Txinera bere idazketa-sistemaren arabera ebazten da, Hant idazketa-sistemak zh-TW eta Hans idazketa-sistemak zh-CN emanez, eta idazketa-sistemarik gabe, eskualdearen arabera: TW, HK eta MO eskualdeek zh-TW ematen dute, eta beste edozeinek zh-CN. pt etiketak pt-BR ematen du, BR ez den beste eskualde bat izendatzen ez bada. Ezer bat ez datorrenean, editoreak ingelesa erakusten du.

editor.setLocale('system');
editor.setSystemLocale('pt-PT'); // null follows the browser again

setSchemaSQL

SQL eskema fitxategi bat kargatzen du.
Lehenespenez, uneko dokumentua ordezten du, harekin bateratu beharrean; ikus beheko mode aukera. Dituzun ezarpenak mantentzen dira, blokeo bakoitza eta haren balio blokeatua barne, ikuspegiaren kokapena eta zoom-maila izan ezik, eta taulak fitxategia irakurri ondoren kokatzen dira, errenkadetan, beheko placement aukerak bestela eskatzen ez badu. Viewport blokeatuta dagoenean, value balioak inportazioa hasten den ikuspegia idazten du ondoren: 0, 0 jatorria 1 zoom-mailan. Beraz, inoiz baliorik jaso ez duen elementu batera inportatutako dokumentu batek blokeo guztiak aktibatuta ditu, dokumentu berri batek bezala.
4.2.0 bertsiotik aurrera, ordezte batek dokumentuaren hitzak, terminoak eta domeinuak ere mantentzen ditu, testuak ezin baititu eduki, Hiztegia fitxako orri bakoitzaren desegite-historiarekin batera, eta inportazioaren desegite edo berregite batek ere mantentzen ditu. Ordezten duen setSchemaJSON dei batek eta value esleitzeak, aldiz, haien dokumentuak dituenak hartzen dituzte.
Historia-zerrendan erregistratzen da, Undo, Redo ahalbidetuz, eta change igortzen du. Kate huts bat ez da kontuan hartzen, eta deiak ez du ezer egiten readonly ezarrita dagoen bitartean.
setSchemaGraphQL, setSchemaDBML eta setSchemaAML metodoek modu berean jokatzen dute, eta haien analizatzaileek ez dute inoiz huts egiten: irakurri ezin duten testuak dokumentu huts bat kargatzen du errorerik sortu beharrean.
4.0.0 bertsiotik aurrera, laurek aukerako bigarren argumentu bat onartzen dute, { placement, mode }:

• placement: 'grid' balio lehenetsiak taulak berehala jartzen ditu errenkadetan, lehen bezala, eta deiak ez du ezer itzultzen.
• placement: 'auto' balioak lehenik taulak haien erlazioen arabera antolatzen ditu, editoreko Import aukerak egiten duen bezala, eta inportazioa desegite-urrats bakar gisa kokatu ondoren ebazten den Promise bat itzultzen du. Bi taula baino gutxiago izateak, erlaziorik ez izateak, antolaketak huts egiteak, orriak SharedWorker ez izateak edo Placing tables jakinarazpeneko Cancel sakatzeak taulak errenkadetan kokatzen ditu horren ordez. Bitartean egindako karga batek — beste inportazio ordezkatzaile bat, value esleitzea, setInitialValue(), 5.1.0 bertsiotik aurrera biltegi partekatu baten reseed metodoa, clear(), lankide baten karga, edo karga baten edo clear() deiaren desegite edo berregite bat — baliogabetzen du, eta Promise objektua ezer kargatu gabe ebazten da. Modu honetan kokatutako inportazioak hasi ziren ordenan kokatzen dira.
• mode: 'replace' balio lehenetsiak dokumentua ordezten du. mode: 'append' balioak fitxategia diagramaren azpian gehitzen du, Inportatu eta gehitu aukerak egiten duen bezala, lehendik dagoen taula oro dagoen bezala utziz, baita ezarpen guztiak ere, fitxa eta ikuspegiaren kokapena izan ezik. Beste fitxa batean bada, ERD fitxa agertzen da lehenik. Taula berriak, eta DBML fitxategi batek dakartzan taula-taldeak, taula-taldeak erakusten diren bitartean, hautapena bihurtzen dira, eta ikuspegia haietara korritzen da, dagoeneko ondo ikusten ez badira, 4.1.0 bertsiotik aurrera jauzi orok jarraitzen dion arauaren arabera. Ikus Jauziaren helmuga. Desegite bakar batek gehikuntza osoa kentzen du. Irakurri ezin duen testuak ez du ezer gehitzen, eta dokumentua dagoen bezala uzten du.

readonly ezarrita dagoen bitartean, ordezte bat ez da kontuan hartzen, gehitze batek ez du ezer gehitzen, eta placement: 'auto' dei bat berehala ebazten da.
3.10.0 bertsiotik aurrera, setSchemaSQL metodoak fitxategia dokumentuaren uneko datu-baserako irakurtzen du: Databricks hautatuta dagoenean, komatxo bakunen arteko kateek Sparken alderantzizko barrako ihes-sekuentziei jarraitzen diete. Ikus Iruzkinak.
3.10.0 bertsiotik aurrera, setSchemaSQL metodoak bi zutabe edo gehiagoren gaineko UNIQUE bat indize bakar bat bezala irakurtzen du, zutabe bakoitza bakar gisa markatu beharrean. Ikus Gako bakarrak eta indizeak.
3.10.0 bertsiotik aurrera, SQL, DBML eta AML inportazioek irakurtzen dituzten gako arrotzen ON DELETE eta ON UPDATE ekintzak mantentzen dituzte.
4.0.0 bertsiotik aurrera, setSchemaSQL metodoak zutabe baten DEFAULT adierazpen osoa mantentzen du, SQL Serverren ADD DEFAULT … FOR eta haren MS_Description iruzkinak irakurtzen ditu, PostgreSQLen serial eta identity zutabeak gehikuntza automatikoko zutabe bihurtzen ditu, UNSIGNED eta ZEROFILL datu motan mantentzen ditu, eta ALTER TABLE … ADD PRIMARY KEY sententziak CLUSTERED, NONCLUSTERED edo USING BTREE gisa markatzen duen gako nagusi bat irakurtzen du. Ikus SQL eskema.
Analizatzaile bakoitzak onartzen duen sintaxia ezagutzeko, ikus Fitxategiak inportatzea edo esportatzea.

type SetSchema = {
  (
    value: string,
    options: { placement: 'auto'; mode?: 'replace' | 'append' }
  ): Promise<void>;
  (
    value: string,
    options?: { placement?: 'grid'; mode?: 'replace' | 'append' }
  ): void;
};

// example
editor.setSchemaSQL('Schema SQL...');
// or
await editor.setSchemaSQL('Schema SQL...', { placement: 'auto' });
// or
editor.setSchemaSQL('Schema SQL...', { mode: 'append' });

setSchemaGraphQL

GraphQL SDL dokumentu bat kargatzen du.
Objektu-moten definizioak taula bihurtzen dira, eta mota beste taula bat duen eremu bat erlazio bihurtzen da.

editor.setSchemaGraphQL('GraphQL SDL...');

setSchemaDBML

DBML fitxategi bat kargatzen du, dbdiagram.io eta dbdocs zerbitzuek erabiltzen duten formatua.
4.0.0 bertsiotik aurrera, TableGroup bakoitza taula-talde bihurtzen da, eta taula baten headercolor haren kolore bihurtzen da. Ikus DBML.

editor.setSchemaDBML('DBML...');

setSchemaAML

AML (Azimutt Markup Language) fitxategi bat kargatzen du. Uneko idazkera zein v1 bertsioko idazkera zaharra onartzen dira.
4.0.0 bertsiotik aurrera, entitate baten kolorea, Azimutten kolore-izenetako bat edo komatxo arteko balio hamaseitar bat, haren taularen kolore bihurtzen da. Ikus AML.

editor.setSchemaAML('AML...');

setSchemaJSON

4.0.0 bertsiotik aurrera, .erd.json dokumentu bat kargatzen du, hala nola value propietateak itzultzen duen testua.
Bere mode: 'replace' modu lehenetsian, dokumentua value esleitzeak bezala kargatzen du: historia-zerrendan erregistratzen da, change igortzen du, eta dokumentuaren blokeoak modu berean hartzen ditu, eta 4.2.0 bertsiotik aurrera dokumentuaren hitzek, terminoek eta domeinuek editorearenak ordezten dituzte. value propietatean ez bezala, kate huts bat edo kate ez den balio bat ez da kontuan hartzen, dokumentu berri bat hasi beharrean. JSON ez den testuak dokumentua husten du, value propietatearekin bezala.
mode: 'append' moduak dokumentuaren taulak, erlazioak, indizeak, oharrak eta taula-taldeak diagramaren azpian gehitzen ditu identifikatzaile berriekin, elkarren arteko kokapenak mantenduz eta dokumentuaren ezarpenak kanpoan utziz, Inportatu eta gehitu aukerak json fitxategi batekin egiten duen bezala. 4.2.0 bertsiotik aurrera, taulen eta zutabeen izen logikoak eta izen eratorriaren markak mantentzen ditu, baina dokumentuaren hitzak, terminoak eta domeinuak atzean uzten ditu; beraz, haren zutabeetako bat ere ez dago domeinu bati lotuta. Irakurri ezin duen testuak, edo taularik eta oharrik ez duen dokumentu batek, ez du ezer gehitzen. Bestela, setSchemaSQL metodoaren gehitze bat bezala kokatzen da, haren ohar eta taula-talde berriak haren taulekin batera hautatuta, mota bakoitza erakusten den bitartean.
Dokumentua kokatu ondoren itzultzen da, eta ez da kontuan hartzen readonly ezarrita dagoen bitartean.

editor.setSchemaJSON('json...');
// or
editor.setSchemaJSON('json...', { mode: 'append' });

getSchemaSQL

Editorearen uneko egoera SQL eskema gisa esportatzen du.
databaseVendor zehazten ez bada, editoreak erakusten duen datu-baserako idazten du: dokumentuarena, irakurtzeko soilik dagoen editore baten irakurleak beste bat aukeratu ez badu; 5.0.0 bertsiotik aurrera hori pantaila horretan geratzen da, eta SQL eskema fitxak hura erakusten du. Beheko zerrendan ez dagoen izen bat modu berean tratatzen da, errorerik sortu gabe.
Izenak editoreak erakusten duen mugatzaile motarekin inguratzen dira. Bracket Type blokeatuta dagoen bitartean, edo 5.0.0 bertsiotik aurrera beste bat aukeratu duen irakurle baten irakurtzeko soilik dagoen editore batean, hori value balioak gordetzen duenaren desberdina izan daiteke, eta azken hori da kodetze-agente baten erd_read tresnak izenak inguratzeko erabiltzen duena. Idazten diren izenak beti izen fisikoak dira, Izenen ikuspegia edozein dela ere.
4.0.0 bertsiotik aurrera, aukerako options argumentu batek sententziak eta goiburua aukeratzen ditu, SQL eskema fitxako aukerek egiten duten bezala, eta, 4.2.0 bertsiotik aurrera, izen logikoek iruzkin hutsak betetzen dituzten ala ez. SchemaSQLOptions mota gisa esportatzen da.

• statements: 'create', lehenetsia; 'ifNotExists', IF NOT EXISTS idazten duena MySQL, MariaDB, PostgreSQL, SQLite eta Databricks datu-baseetan eta beste guztietan 'create' erabiltzen duena; edo 'recreate', taulak sortu aurretik ezabatzen dituena, eta Snowflakek CREATE OR REPLACE TABLE idazten du horren ordez.
• header: 'none', lehenetsia; 'use', dokumentuaren datu-basera edo eskemara aldatzen dena; edo 'createAndUse', lehenik existitzen ez bada sortzen duena eta gero hartara aldatzen dena. Eskatutakoa ez duen datu-base batek fitxak bezala jotzen du ordezko aukerara: Oraclek 'use' idazten du 'createAndUse' aukeraren ordez, PostgreSQLek ez du goibururik idazten 'use' aukerarako, eta SQLitek ez du bat ere idazten. Goiburua dokumentuaren datu-basearen izena identifikatzaile arrunta den bitartean soilik idazten da: ASCII letrak, digituak eta _, digitu batekin hasi gabe.
• logicalNameAsComment, 4.2.0 bertsiotik aurrera: true balioak taula edo zutabe baten izen logikoa haren iruzkin gisa idazten du, haren iruzkin propioa hutsik edo zuriunez soilik osatuta dagoen eta izen logikoa hala ez dagoen lekuan, datu-base horrek iruzkin bat idazten duen forman. Testua duen iruzkin bat lehen bezala idazten da. true balioak bakarrik aktibatzen du: kanpoan utzitako aukerak, false balioak edo beste edozein baliok, hala nola 'true' edo 1, ez du izen logikorik idazten. Fitxako Write logical names into empty comments etengailuak egiten duena egiten du.

Kanpoan utzitako aukera bat, edo balio ezezaguna duen bat, bere balio lehenetsi gisa irakurtzen da; beraz, aukerarik gabeko dei batek CREATE sententzia arruntak idazten ditu goibururik gabe, lehen bezala.
4.0.0 bertsiotik aurrera, irteerak beti barne hartzen ditu dokumentuaren Before tables eta After tables scriptak, ordena honetan: goiburua, aurreko scripta, ezabatze-sententziak, taulak, ondorengo scripta. SQL eskema fitxaren beraren Statements, Header, Write logical names into empty comments eta Tables aukerek ez diote inoiz eragiten dei honi, beti dokumentu osoa idazten baitu.
3.10.0 bertsiotik aurrera, gako arrotz bakoitzak erlazioaren ON DELETE eta ON UPDATE klausulak ditu. Klausula bat haren ekintza ezarrita dagoenean eta hornitzaileak onartzen duenean soilik idazten da; beraz, hornitzaile horrek hartzen ez duen ekintza bat kanpoan geratzen da, eta haren balio lehenetsia aplikatzen da. 4.0.0 bertsiotik aurrera, Snowflakek NO ACTION soilik onartzen du. Datu-base bakoitzak zer idazten duen jakiteko, ikus ON DELETE eta ON UPDATE.
3.10.0 bertsiotik aurrera, taula edo zutabe baten iruzkineko komatxo bakun bati ihes egiten zaio; beraz, it's bezalako iruzkin batek jada ez du sententzia hausten. Iruzkinak kate-literal gisa idazten dituen hornitzaile orok bikoiztu egiten du, Databricksek izan ezik, zeinak alderantzizko barra bat jartzen baitu komatxo bakoitzaren eta alderantzizko barra bakoitzaren aurrean. SQLitek iruzkinak -- lerro gisa idazten jarraitzen du.
4.2.0 bertsiotik aurrera, SQL Serverrek iruzkin bakoitza literal nazional gisa idazten du, N'…'; beraz, datu-basearen kode-orritik kanpoko testua, koreera adibidez, mantendu egiten da. Oraclek iruzkin bateko lerro hutsen segida bakoitza lerro-jauzi bakar gisa idazten du, eta SQLitek iruzkin baten lerro-jauziak zuriune gisa idazten ditu, bere -- lerroan gera dadin. Ikus Iruzkinak.
4.0.0 bertsiotik aurrera, hainbat datu-basek gakoen izenak, balio lehenetsiak eta gehikuntza automatikoa ere beste modu batean idazten dituzte. Ikus DDLak zer idazten duen.

type DatabaseVendor =
  | 'Databricks'
  | 'MariaDB'
  | 'MSSQL'
  | 'MySQL'
  | 'Oracle'
  | 'PostgreSQL'
  | 'Snowflake'
  | 'SQLite';

type SchemaSQLOptions = {
  statements?: 'create' | 'ifNotExists' | 'recreate';
  header?: 'none' | 'use' | 'createAndUse';
  logicalNameAsComment?: boolean;
};

const schemaSQL = editor.getSchemaSQL();
// or
const postgresSQL = editor.getSchemaSQL('PostgreSQL');
// or
const mysqlSQL = editor.getSchemaSQL('MySQL', {
  statements: 'ifNotExists',
  header: 'createAndUse',
});
// or
const commentedSQL = editor.getSchemaSQL('PostgreSQL', {
  logicalNameAsComment: true,
});

getSharedStore

Denbora errealeko elkarlaneko ediziorako biltegi bat itzultzen du.
config objektua { getNickname?, mouseTracker?, focusTracker? } da. Bi jarraitzaileek true dute lehenespenez: mouseTracker aukerak editore honen kurtsorea besteei igortzen die, eta focusTracker aukerak haren fokuratutako gelaxka, hautapena eta arrastatze-laukia igortzen ditu.
5.0.0 bertsiotik aurrera, biltegiak ez du aldaketarik bidaltzen readonly ezarrita dagoen bitartean, jarraitzaileek bidaltzen dutena eta elkarlanera sartzen den editore batek eskatzen dituen erregistroak baino ez, eta besteek bidaltzen dutena aplikatzen du oraindik.
5.1.0 bertsiotik aurrera, editorearen elkarlan-erregistroak eta haren erlojuaren erregistro-bertsioa ere ematen ditu (getLWW, getVersion), beste biltegi baten erregistroak hartzen ditu (mergeLWW), alde egin duen lankide baten kurtsorea, fokua, hautapena eta arrastatze-koadroa ahazten ditu (forgetPeer), eta saioko dokumentua berriro irekitzen du ondoan gordetako erregistroekin (reseed). @dineug/erd-editor-yjs paketeak horietan oinarritzen da elementua Yjs dokumentu batekin sinkronizatuta mantentzeko.
5.1.0 bertsiotik aurrera, bi erabiltzailek une berean izen edo eremu bera aldatzen, taula bera mugitzen, edo ohar edo taula-talde bera mugitzen edo haren tamaina aldatzen dutenean, haien edizioak berdin amaitzen dira 5.1.0 edo berriagoa den editore eta erreplika guztietan, eta arrastatze bat, ikuspegiaren mugimendu bat edo zoom bat amaitzen den lekua bezala bidaltzen da.
Kolorea, taula edo indize baten barruan mugitutako zutabe bat, eta datu-basea bezalako ezarpen batzuk salbuespenak dira; editore eta erreplika bakoitzak entzuten dituen ordenan hartzen ditu oraindik. Ikus Aldi bereko edizioak.
Ikus Elkarlaneko edizioa.

const sharedStore = editor.getSharedStore({
  mouseTracker: false,
  focusTracker: false,
});

setDiffValue

Diferentzia-ikustailea irekitzen du, unean irekita dagoen dokumentua pasatzen duzunarekin alderatuz.
Ez du ezer itzultzen, eta ez du dokumentua aldatzen; beraz, ikustailea ixtean, editorea zegoen-zegoenean geratzen da.
Balio huts bat, edo kate ez den edozer, dokumentu huts batekin alderatzen da.
Oihalaren laster-menuko Diferentzia-ikustailea aukeraren geruza bera da.
4.1.0 bertsiotik aurrera, bi dokumentuek dutena identifikatzailearen arabera parekatzen du lehenik, eta gero bakarrik bakoitzak gordetzen duenaren arabera, hala nola taula baten izena edo ohar baten testua. Ikus Zer alderatzen den. Dokumentu beraren aurreko bertsio baten aurrean, hala nola haren fitxategiaren Git berrikuspen baten aurrean, izen-aldaketa bat, beraz, izena aldatutako elementu bakar gisa ageri da; identifikatzaile desberdinak dituen dokumentu baten aurrean, kentze bat eta gehitze bat gisa ageri da. Ikustaileak aldatu dena zuhaitz batean zerrendatzen du bi dokumentuen ondoan, eta aldaketak kolorez markatzen ditu, gelaxkak bete beharrean.
4.2.0 bertsiotik aurrera, bi dokumentuak editore honek erakusten duen Izenen ikuspegian irekitzen dira, pasatutako dokumentuak zer gorde zuen gorabehera, eta zuhaitzak ere ikuspegi horren arabera izendatzen ditu taulak eta zutabeak. Ikus Oihaletik kanpo. Izen logikoak, domeinu-loturak eta hiztegiak ez dira alderatzen; beraz, horietan bakarrik egindako aldaketa batek ez du aldaketarik erakusten.

editor.setDiffValue('prev json...');