Buffer e finestre

Neovim separa il contenuto dalla visualizzazione. Un buffer contiene il testo in memoria; una finestra è una vista su un buffer; una tabpage è una disposizione di finestre.

Lo stesso buffer può essere visualizzato in molte finestre. I plugin manipolano questi handle, che sono numeri interi, tramite le famiglie di API nvim_buf_* e nvim_win_*.

nvim_buf_get_lines(buf, start, end_, strict) restituisce le righe come elenco. Gli indici partono da zero e l'estremo finale non è incluso; passi -1 come fine per arrivare all'ultima riga.

Impostando strict_indexing su false si accettano gli indici fuori intervallo invece di generare un errore.

nvim_buf_set_lines sostituisce un intervallo con nuovo testo. Per aggiungere contenuto alla fine, imposti sia l'inizio sia la fine su -1. Per sovrascrivere tutto, utilizzi 0, -1.

La sostituzione è un elenco Lua di stringhe, una per riga, senza caratteri di nuova riga finali.

Crei un buffer temporaneo non elencato con nvim_create_buf(listed, scratch). Passare false, true crea un buffer scratch ideale per l'interfaccia del plugin.

Imposti bufhidden = 'wipe' in modo che scompaia quando si chiude la finestra, evitando di lasciare buffer inutilizzati.

Utilizzi vim.bo[buf] per impostare le opzioni locali al buffer su un handle specifico. Tra le impostazioni comuni dei plugin ci sono modifiable = false e buftype = 'nofile'.

Rendere non modificabile un buffer di visualizzazione impedisce agli utenti di modificare accidentalmente il contenuto generato.

nvim_open_win(buf, enter, config) inserisce un buffer in una finestra fluttuante. La configurazione imposta relative, row, col, width, height e border.

Le finestre fluttuanti sono alla base delle moderne interfacce utente, come la documentazione al passaggio del mouse, i selettori e le notifiche.

Modifichi una finestra fluttuante aperta con nvim_win_set_config, utile per ridimensionarla durante VimResized. Legga la disposizione corrente con nvim_win_get_config.

Imposti le opzioni locali alla finestra tramite vim.wo[win], ad esempio per nascondere la riga del cursore o disabilitare le colonne dei numeri nei pannelli dell'interfaccia.

Sposti il cursore con nvim_win_set_cursor(win, {row, col}). Tenga presente che la riga parte da uno, mentre la colonna parte da zero: è una frequente fonte di errori di tipo off-by-one.

Legga la posizione con nvim_win_get_cursor per ricordare e ripristinare la posizione dell'utente prima e dopo un'operazione.

Gli handle possono diventare obsoleti. Verifichi la loro validità con nvim_buf_is_valid e nvim_win_is_valid prima di utilizzare gli handle memorizzati.

Chiuda le finestre con nvim_win_close(win, force) ed elimini i buffer tramite nvim_buf_delete(buf, { force = true }). Esegua sempre prima la verifica per evitare errori.

Gli extmark ancorano i metadati al testo, che si sposta man mano che vengono apportate modifiche. Crei un namespace con nvim_create_namespace, quindi associ testo virtuale o evidenziazioni.

nvim_buf_set_extmark supporta virt_text, colonne dei segni ed evidenziazioni inline: è il motore alla base degli hint inline e dei plugin git blame.

nvim_list_bufs e nvim_list_wins restituiscono tutti gli handle attualmente disponibili. Li filtri con nvim_buf_is_loaded oppure controllando le opzioni.

L'iterazione permette a un plugin di agire sull'intera sessione, ad esempio chiudendo ogni finestra flottante o aggiornando ciascun buffer di un determinato filetype.

Verifichi ciò che ha imparato sui buffer e sulle finestre.

I buffer contengono testo, le finestre lo visualizzano e gli handle sono numeri interi che deve convalidare prima dell'uso. Può leggere e scrivere righe, creare buffer scratch e impostare opzioni locali al buffer.

Le finestre flottanti tramite nvim_open_win, il controllo del cursore, gli extmark e le API per gli elenchi Le forniscono tutto ciò che serve per creare interfacce UI di plugin ricche e con stato.