Buffers e janelas

O Neovim separa o conteúdo da exibição. Um buffer mantém texto na memória; uma janela é uma área de visualização de um buffer; uma página de abas é um arranjo de janelas.

Um buffer pode aparecer em várias janelas. Os plugins manipulam esses identificadores, que são inteiros, por meio das famílias de API nvim_buf_* e nvim_win_*.

nvim_buf_get_lines(buf, start, end_, strict) retorna linhas como uma lista. Os índices começam em zero e não incluem o limite final; passe -1 como limite final para chegar à última linha.

Definir strict_indexing como false tolera índices fora do intervalo em vez de gerar um erro.

nvim_buf_set_lines substitui um intervalo por um novo texto. Para adicionar texto ao final, defina o início e o fim como -1. Para sobrescrever tudo, use 0, -1.

A substituição é uma lista Lua de cadeias de caracteres, uma por linha, sem caracteres de nova linha ao final.

Crie um buffer não listado e descartável com nvim_create_buf(listed, scratch). Passar false, true cria um buffer temporário ideal para a interface do plugin.

Defina bufhidden = 'wipe' para que ele desapareça quando a janela for fechada, evitando buffers residuais.

Use vim.bo[buf] para definir opções específicas do buffer em um identificador determinado. Configurações comuns de plugins incluem modifiable = false e buftype = 'nofile'.

Tornar um buffer de exibição não modificável impede que os usuários editem acidentalmente o conteúdo gerado.

nvim_open_win(buf, enter, config) coloca um buffer em uma janela flutuante. A configuração define relative, row, col, width, height e border.

As janelas flutuantes são a base de interfaces modernas, como documentação contextual, seletores e notificações.

Ajuste uma janela flutuante aberta com nvim_win_set_config, o que é útil para redimensioná-la em VimResized. Leia o layout atual com nvim_win_get_config.

Defina opções específicas da janela por meio de vim.wo[win], por exemplo, ocultando a linha do cursor ou desativando colunas de números nos painéis da interface.

Mova o cursor com nvim_win_set_cursor(win, {row, col}). Observe que a linha começa em um, mas a coluna começa em zero, uma fonte frequente de erros de diferença de um.

Leia a posição de volta com nvim_win_get_cursor para memorizar e restaurar a posição do usuário antes e depois de uma operação.

Os identificadores podem ficar obsoletos. Verifique-os com nvim_buf_is_valid e nvim_win_is_valid antes de agir sobre identificadores armazenados.

Feche as janelas com nvim_win_close(win, force) e exclua buffers por meio de nvim_buf_delete(buf, { force = true }). Sempre valide primeiro para evitar erros.

As marcas estendidas associam metadados ao texto e acompanham seu movimento conforme as edições acontecem. Crie um espaço de nomes com nvim_create_namespace e, em seguida, associe texto virtual ou destaques.

nvim_buf_set_extmark oferece suporte a virt_text, colunas de sinais e destaques em linha — o mecanismo por trás das dicas embutidas e dos plug-ins de identificação de autoria no git.

nvim_list_bufs e nvim_list_wins retornam todos os identificadores atuais. Filtre-os com nvim_buf_is_loaded ou verificando opções.

Iterar permite que um plug-in atue em toda a sessão, como fechar todas as janelas flutuantes ou atualizar cada área de texto de um determinado tipo de arquivo.

Verifique o que você aprendeu sobre áreas de texto e janelas.

As áreas de texto armazenam texto, as janelas o exibem, e os identificadores são números inteiros que você deve validar antes de usar. Você pode ler e gravar linhas, criar áreas de texto temporárias e definir opções locais à área de texto.

Janelas flutuantes por meio de nvim_open_win, controle do cursor, marcas estendidas e APIs de listagem oferecem tudo de que você precisa para criar interfaces de plug-in ricas e com estado.