Home Explore Blog CI



neovim

46th chunk of `runtime/doc/api.txt`
415dad6a1d3b8f75e82f08a9fc1e6738587650dc70b0eba30000000100000fea
 is active
        Since: 0.4.0

    Parameters: ~
      • {buffer}  Buffer to display, or 0 for current buffer
      • {enter}   Enter the window (make it the current window)
      • {config}  Map defining the window configuration. Keys:
                  • relative: Sets the window layout to "floating", placed at
                    (row,col) coordinates relative to:
                    • "cursor" Cursor position in current window.
                    • "editor" The global editor grid.
                    • "laststatus" 'laststatus' if present, or last row.
                    • "mouse" Mouse position.
                    • "tabline" Tabline if present, or first row.
                    • "win" Window given by the `win` field, or current
                      window.
                  • win: |window-ID| window to split, or relative window when
                    creating a float (relative="win").
                  • anchor: Decides which corner of the float to place at
                    (row,col):
                    • "NW" northwest (default)
                    • "NE" northeast
                    • "SW" southwest
                    • "SE" southeast
                  • width: Window width (in character cells). Minimum of 1.
                  • height: Window height (in character cells). Minimum of 1.
                  • bufpos: Places float relative to buffer text (only when
                    relative="win"). Takes a tuple of zero-indexed
                    `[line, column]`. `row` and `col` if given are applied
                    relative to this position, else they default to:
                    • `row=1` and `col=0` if `anchor` is "NW" or "NE"
                    • `row=0` and `col=0` if `anchor` is "SW" or "SE" (thus
                      like a tooltip near the buffer text).
                  • row: Row position in units of "screen cell height", may be
                    fractional.
                  • col: Column position in units of screen cell width, may be
                    fractional.
                  • focusable: Enable focus by user actions (wincmds, mouse
                    events). Defaults to true. Non-focusable windows can be
                    entered by |nvim_set_current_win()|, or, when the `mouse`
                    field is set to true, by mouse events. See |focusable|.
                  • mouse: Specify how this window interacts with mouse
                    events. Defaults to `focusable` value.
                    • If false, mouse events pass through this window.
                    • If true, mouse events interact with this window
                      normally.
                  • external: GUI should display the window as an external
                    top-level window. Currently accepts no other positioning
                    configuration together with this.
                  • zindex: Stacking order. floats with higher `zindex` go on
                    top on floats with lower indices. Must be larger than
                    zero. The following screen elements have hard-coded
                    z-indices:
                    • 100: insert completion popupmenu
                    • 200: message scrollback
                    • 250: cmdline completion popupmenu (when
                      wildoptions+=pum) The default value for floats are 50.
                      In general, values below 100 are recommended, unless
                      there is a good reason to overshadow builtin elements.
                  • style: (optional) Configure the appearance of the window.
                    Currently only supports one value:
                    • "minimal" Nvim will display the window with many UI
                      options disabled. This is useful when displaying a
                      temporary float where the text should not be edited.
                      Disables 'number', 'relativenumber', 'cursorline',
                      'cursorcolumn', 'foldcolumn', 'spell' and 'list'

Title: nvim_open_win Parameters and Configuration Details
Summary
This section lists the parameters accepted by `nvim_open_win` for creating windows, covering buffer, focus, and configuration settings like relative positioning (cursor, editor, laststatus, mouse, tabline, window), window ID, anchor, width, height, buffer position, row/column, focusability, mouse interaction, external window, z-index, and style (minimal).