NABI NOTE
Documentação

Usar CDN ​

Em uma página estática onde instalar um pacote não é prático, carregue a versão de navegador e seu CSS a partir de um CDN. A demonstração abaixo lê a versão do pacote durante o build do site e cria um editor pelo objeto global NabiNote.

Salve o código abaixo como e abra num navegador — você vê funcionando na hora.

<!doctype html>
<html lang="pt">
<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; }
    /* altura mínima do editor — evita que ele pareça uma caixa de uma linha só ao abrir. Mude o valor à vontade. */
    #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')

  // Todos os wings, exceto upload.
  // Das fontes, só sobram sans e serif.
  // Cada sistema suporta um conjunto diferente de fontes, então mono e cursiva precisam de uma
  // fonte importada à parte para serem reconhecidas em toda plataforma. Detalhes na página
  // "Tipo de letra".
  var wings = N.wings().allBasic().use('save').use('open').use('tf', { values: ['sans', 'serif'] })

  var made = N.createNabiWith(wings, {
    locale: 'pt',
    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: 'pt' })
  N.mountPickedMark({ nabi: nabi, surface: surface })

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

  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: 'pt'
  })

  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: 'pt', 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: 'pt' })

  nabi.setHtml('')

  // exemplo de callback para quando o valor muda
  // nabi.onChange(function () { user_callback(nabi.getJson()) })
</script>

</body>
</html>

Pontos a observar no NABI NOTE ​

  • Em código publicado, fixe o CSS e o JavaScript do navegador na mesma versão. Uma URL sem versão, como latest, pode mudar de comportamento quando uma nova versão for publicada.
  • O bundle de navegador expõe a API raiz por window.NabiNote. nabi-note/ssr, nabi-note/viewer e nabi-note/diff não são bundles globais separados.
  • O salvamento de arquivos e o histórico local desta demonstração rodam no navegador do usuário. Envie a saída de getJson() para a API da sua aplicação se precisar de armazenamento no servidor ou sincronização de conta.
  • Upload exige o wing upload, uma função real de upload e o wing de imagem ou de link necessário. Seu servidor de upload é responsável por validar os arquivos.
  • A versão de navegador conecta internamente seu parser HTML. setHtml(), abrir um arquivo HTML e colar HTML não precisam de uma opção de parser nem de API privada.

Carregar por CDN muda apenas a forma de carregar a biblioteca. O formato de armazenamento e a validação de entrada são os mesmos do pacote npm; veja também Uso básico.