Link ​

Selecione texto e associe um endereço a ele. Se você inserir um endereço sem selecionar texto, o próprio endereço é inserido como texto do link. Digitar um endereço http:// ou https:// e depois pressionar Espaço ou Enter também o transforma em link.

Links guardam apenas http:, https: e caminhos do mesmo site que começam com . ou /. Endereços cuja origem não possa ser identificada claramente, como javascript: ou //example.com, são rejeitados. Links de anexos criados por uploads também guardam informações de arquivo e não podem ser criados manualmente como links comuns.

npm install nabi-note

import {
  createLocale, createNabiWith, mountSurface, mountToolbar,
  mountContextToolbar, mountHints, watchSettle, subscriptWing, linkWing,
  footnoteWing, mountViewTools,
} from 'nabi-note'

const selected = [
  subscriptWing,
  linkWing,
  footnoteWing,
]
const locale = createLocale('pt')
const { nabi, registry } = createNabiWith(selected, { locale })

const root = document.querySelector('.nabi')!
const content = document.querySelector('.nabi-content')!

// The locale also sets the direction — Arabic and Urdu run right to left
mountSurface({ nabi, registry, root: content, locale })

const settle = watchSettle(document, { surface: content })
const shared = { nabi, registry, surface: content, settle, locale }
const toolbar = mountToolbar({ ...shared, root: document.querySelector('#toolbar')! })
const context = mountContextToolbar({ ...shared, root: document.querySelector('#context')! })
mountHints({ toolbar, context, root, surface: content })
// The preview and fullscreen buttons — they stand their own box at the end of the row
mountViewTools({ ...shared, root, container: document.querySelector('#toolbar')! })

// on every change — hook up your own code here
// nabi.onChange(() => user_callback(nabi.getHtml()))

// Call from your language selector. Content and editing history stay intact.
// locale.setLocale('ko')

const selected = wings().use('a').build()

Colar URLs ​

Se todo o conteúdo colado, sem os espaços em branco no início e no fim, for uma URL http:// ou https:// válida, ele será inserido imediatamente como link. URLs dentro de frases, textos com várias URLs e caminhos relativos seguem o comportamento de colagem existente. Em blocos de código e editores sem o wing de links, o conteúdo continua como texto. Dados internos válidos da área de transferência copiados do editor têm prioridade para preservar a formatação original.

Use o callback onPasteUrl de mountSurface() para escolher o texto exibido do link.

const surface = mountSurface({
  nabi,
  registry,
  root: document.querySelector<HTMLElement>('#editor')!,
  onPasteUrl(url, isSameOrigin, path) {
    if (isSameOrigin && path === '/guide') return 'NABI NOTE'
    return url
  },
})

Uma string retornada que não contenha apenas espaços em branco passa a ser o texto exibido. Se o callback estiver ausente, retornar um valor vazio ou que não seja uma string, ou falhar, a URL colada permanece como texto exibido. As strings retornadas nunca são interpretadas como HTML e não alteram o endereço do link.

O callback também aceita funções async e promises. O link com a URL é inserido imediatamente enquanto a resposta está pendente; um resultado válido recebido depois altera apenas o texto exibido desse link. Um resultado tardio é ignorado se o link tiver sido editado ou excluído, um novo documento tiver sido carregado ou a superfície tiver sido desmontada.

Estilos CSS ​

Estilize links comuns com .nabi-content a, e links de anexo separadamente com .nabi-content a[data-nabi-file].

.article-body a:not([data-nabi-file]) {
  color: var(--nabi-accent);
  text-decoration-thickness: .08em;
  text-underline-offset: .16em;
}

.article-body a[data-nabi-file] {
  display: inline-flex;
  gap: .35em;
  padding: .25em .55em;
  background: var(--nabi-soft);
}

As partes ::before e ::after de links de anexo são usadas para mostrar o ícone do arquivo e a extensão, então normalmente é melhor não substituir nem remover seu content.