Buffers y ventanas

Neovim separa el contenido de la visualización. Un búfer contiene texto en memoria; una ventana es una vista de un búfer; una página de pestañas es una disposición de ventanas.

Un mismo búfer puede aparecer en varias ventanas. Los plugins manipulan estos identificadores, que son números enteros, mediante las familias de API nvim_buf_* y nvim_win_*.

nvim_buf_get_lines(buf, start, end_, strict) devuelve las líneas como una lista. Los índices empiezan en cero y el final no se incluye; pase -1 como final para llegar a la última línea.

Establecer strict_indexing en false permite índices fuera de rango en lugar de producir un error.

nvim_buf_set_lines sustituye un rango por texto nuevo. Para añadir texto al final, establezca el inicio y el final en -1. Para sobrescribirlo todo, use 0, -1.

La sustitución es una lista Lua de cadenas, una por línea, sin caracteres de salto de línea finales.

Cree un búfer no listado y desechable con nvim_create_buf(listed, scratch). Pasar false, true crea un búfer temporal ideal para la interfaz del plugin.

Establezca bufhidden = 'wipe' para que desaparezca al cerrar su ventana y evitar que queden búferes residuales.

Use vim.bo[buf] como índice para establecer opciones locales del búfer en un identificador específico. Entre las configuraciones habituales de los plugins se encuentran modifiable = false y buftype = 'nofile'.

Hacer que un búfer de visualización no sea modificable evita que los usuarios editen accidentalmente el contenido generado.

nvim_open_win(buf, enter, config) coloca un búfer en una ventana flotante. La configuración establece relative, row, col, width, height y border.

Las ventanas flotantes son la base de interfaces modernas como la documentación contextual, los selectores y las notificaciones.

Ajuste una ventana flotante abierta con nvim_win_set_config, lo que resulta útil para cambiar su tamaño en VimResized. Lea la disposición actual con nvim_win_get_config.

Establezca las opciones locales de la ventana mediante vim.wo[win], por ejemplo para ocultar la línea del cursor o desactivar las columnas de números en los paneles de la interfaz.

Mueva el cursor con nvim_win_set_cursor(win, {row, col}). Tenga en cuenta que la fila empieza en uno, pero la columna empieza en cero, una fuente frecuente de errores de desplazamiento por uno.

Vuelva a leer la posición con nvim_win_get_cursor para recordar y restaurar la posición del usuario antes y después de una operación.

Los identificadores pueden quedar obsoletos. Compruebe su validez con nvim_buf_is_valid y nvim_win_is_valid antes de actuar sobre identificadores almacenados.

Cierre las ventanas con nvim_win_close(win, force) y elimine los búferes mediante nvim_buf_delete(buf, { force = true }). Valide siempre primero para evitar errores.

Los extmarks anclan metadatos al texto y se desplazan conforme se realizan cambios. Cree un namespace con nvim_create_namespace y, después, adjunte texto virtual o resaltados.

nvim_buf_set_extmark admite virt_text, columnas de signos y resaltados en línea; es el motor de los avisos insertados y de los plugins de git blame.

nvim_list_bufs y nvim_list_wins devuelven todos los manejadores actuales. Filtre estos manejadores con nvim_buf_is_loaded o comprobando las opciones.

La iteración permite que un plugin actúe en toda la sesión, por ejemplo, cerrando cada ventana flotante o actualizando cada buffer de un tipo de archivo determinado.

Verifique lo que ha aprendido sobre buffers y ventanas.

Los buffers contienen texto, las ventanas lo muestran y los manejadores son enteros que debe validar antes de usarlos. Puede leer y escribir líneas, crear buffers temporales y establecer opciones locales al buffer.

Las ventanas flotantes mediante nvim_open_win, el control del cursor, los extmarks y las API de listado le proporcionan todo lo necesario para crear interfaces de usuario de plugins completas y con estado.