NABI NOTE
Dokumentation

Verwendung von CDN ​

Für eine statische Seite, bei der die Installation eines Pakets unpraktisch ist, laden Sie den Browser-Build und das zugehörige CSS von einem CDN. Das folgende Demo liest die Paketversion während des Builds der Site und erstellt einen Editor über das globale NabiNote-Objekt.

Speichern Sie den Code unten als und öffnen Sie ihn in einem Browser — Sie sehen ihn sofort laufen.

<!doctype html>
<html lang="de">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>NABI NOTE</title>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/nabi-note@1.0.0/dist/nabi.css">
  <style>
    html, body { height: 100%; margin: 0; }
    /* Mindesthöhe des Editors — verhindert, dass er beim ersten Laden wie eine einzeilige Box aussieht. Wert frei änderbar. */
    #app { height: 100vh; }
    #editor { flex: 1; min-height: 0; overflow-y: auto; }
  </style>
</head>
<body>

<div id="app" class="nabi">
  <div id="chrome" class="nabi-toolbar">
    <div class="nabi-toolbar-row">
      <span id="tools"></span>
      <div id="toolbar"></div>
    </div>
    <div id="context"></div>
  </div>
  <div id="editor" class="nabi-content"></div>
</div>

<script src="https://cdn.jsdelivr.net/npm/nabi-note@1.0.0/dist/browser/nabi-note.min.js"></script>
<script>
  var N = NabiNote
  var app = document.querySelector('#app')
  var surface = document.querySelector('#editor')

  // Jeder Flügel außer Upload.
  // Von den Schriftarten bleiben nur sans und serif übrig.
  // Systeme unterstützen unterschiedliche Schriftarten, deshalb brauchen Mono und Cursive eine
  // separat importierte Web-Schrift, bevor jede Plattform sie erkennt. Details stehen auf der
  // Seite „Schriftart".
  var wings = N.wings().allBasic().use('save').use('open').use('tf', { values: ['sans', 'serif'] })

  var made = N.createNabiWith(wings, {
    locale: 'de',
    ask: {
      message: function (text) { window.alert(text) },
      confirm: function (text) { return window.confirm(text) }
    }
  })
  var nabi = made.nabi
  var registry = made.registry

  N.mountSurface({ nabi: nabi, registry: registry, root: surface, locale: 'de' })
  N.mountPickedMark({ nabi: nabi, surface: surface })

  var settle = N.watchSettle(document, { surface: surface })
  var shared = { nabi: nabi, registry: registry, surface: surface, settle: settle, locale: 'de' }

  var history = N.mountLocalHistory({ nabi: nabi, storage: N.browserHistoryStorage(window) })
  var file = N.mountFile({
    nabi: nabi, registry: registry, store: N.browserFileStore(document),
    name: function () { return 'note' }, locale: 'de'
  })

  var toolbar = N.mountToolbar(Object.assign({}, shared, {
    root: document.querySelector('#toolbar'),
    file: file,
    onHost: function (w) {
      if (w !== 'localHistory') return
      N.openHistoryPanel({
        history: history, surface: surface, locale: 'de', sessionId: history.sessionId,
        render: function (record) {
          return N.renderStoredHtml(JSON.parse(record.body), registry) || ''
        }
      })
    }
  }))
  var context = N.mountContextToolbar(Object.assign({}, shared, { root: document.querySelector('#context') }))

  N.mountHints({ toolbar: toolbar, context: context, root: document.querySelector('#chrome'), surface: surface })
  N.mountViewTools({ nabi: nabi, surface: surface, root: app, container: document.querySelector('#tools'), locale: 'de' })

  nabi.setHtml('')

  // Beispiel-Callback für den Fall, dass sich der Wert ändert
  // nabi.onChange(function () { user_callback(nabi.getJson()) })
</script>

</body>
</html>

Hinweise zu NABI NOTE ​

  • Verwenden Sie in bereitgestelltem Code CSS und Browser-JavaScript mit derselben Version. Eine URL ohne Versionsangabe, wie z. B. latest, kann sich ändern, wenn eine neue Veröffentlichung erscheint.
  • Das Browser-Bundle stellt die Root-API über window.NabiNote zur Verfügung. nabi-note/ssr, nabi-note/viewer und nabi-note/diff sind keine separaten globalen Bundles.
  • Das Speichern von Dateien und der lokale Verlauf in diesem Demo laufen im Browser des Benutzers. Senden Sie die Ausgabe von getJson() an Ihre Anwendungs-API für die serverseitige Speicherung oder das Synchronisieren mit dem Konto.
  • Der Upload erfordert den upload-Wing, eine echte Upload-Funktion sowie die erforderlichen Image- oder Link-Wings. Ihr Upload-Server ist für die Dateivalidierung verantwortlich.
  • Der Browser-Build bindet seinen HTML-Parser intern ein. setHtml(), das Öffnen einer HTML-Datei und das Einfügen von HTML benötigen keine Parser-Option oder eine private API.

Das Laden über CDN ändert nur, wie die Bibliothek geladen wird. Ihr Speicherformat und die Eingabevalidierung sind dieselben wie beim npm-Paket; siehe auch Grundlegende Verwendung.