plugins.statuscol.settings

Options provided to the require('statuscol').setup function.

Type: attribute set of anything

Default: { }

Example:

{
  bt_ignore = null;
  clickhandlers = {
    FoldClose = "require('statuscol.builtin').foldclose_click";
    FoldOpen = "require('statuscol.builtin').foldopen_click";
    FoldOther = "require('statuscol.builtin').foldother_click";
    Lnum = "require('statuscol.builtin').lnum_click";
  };
  clickmod = "c";
  ft_ignore = null;
  relculright = true;
  segments = [
    {
      click = "v:lua.ScFa";
      text = [
        "%C"
      ];
    }
    {
      click = "v:lua.ScSa";
      text = [
        "%s"
      ];
    }
    {
      click = "v:lua.ScLa";
      condition = [
        true
        {
          __raw = "require('statuscol.builtin').not_empty";
        }
      ];
      text = [
        {
          __raw = "require('statuscol.builtin').lnumfunc";
        }
        " "
      ];
    }
  ];
  setopt = true;
  thousands = ".";
}

Declared by:

plugins.statuscol.settings.bt_ignore

Lua table with ‘buftype’ values for which statuscolumn will be unset.

Plugin default: null

Type: null or (list of (string or raw lua code))

Default: null

Declared by:

plugins.statuscol.settings.clickhandlers

Builtin click handlers.

Type: attribute set of lua function string

Default: { }

Example:

{
  FoldClose = "require('statuscol.builtin').foldclose_click";
  FoldOpen = "require('statuscol.builtin').foldopen_click";
  FoldOther = "require('statuscol.builtin').foldother_click";
  Lnum = "require('statuscol.builtin').lnum_click";
}

Declared by:

plugins.statuscol.settings.clickmod

Modifier used for certain actions in the builtin clickhandlers: a for Alt, c for Ctrl and m for Meta.

Plugin default: "c"

Type: null or string or raw lua code

Default: null

Declared by:

plugins.statuscol.settings.ft_ignore

Lua table with ‘filetype’ values for which statuscolumn will be unset.

Plugin default: null

Type: null or (list of (string or raw lua code))

Default: null

Declared by:

plugins.statuscol.settings.relculright

Whether to right-align the cursor line number with relativenumber set.

Plugin default: false

Type: null or boolean or raw lua code

Default: null

Declared by:

plugins.statuscol.settings.segments

The statuscolumn can be customized through the segments option.

Plugin default:

[
  {
    text = ["%C"];
    click = "v:lua.ScFa";
  }
  {
    text = ["%s"];
    click = "v:lua.ScSa";
  }
  {
    text = [
      {__raw = "require('statuscol.builtin').lnumfunc";}
      " "
    ];
    condition = [
      true
      {__raw = "require('statuscol.builtin').not_empty";}
    ];
    click = "v:lua.ScLa";
  }
]

Type: null or (list of ((attribute set of anything) or raw lua code))

Default: null

Declared by:

plugins.statuscol.settings.setopt

Whether to set the statuscolumn option, may be set to false for those who want to use the click handlers in their own statuscolumn: _G.Sc[SFL]a(). Although I recommend just using the segments field below to build your statuscolumn to benefit from the performance optimizations in this plugin.

Plugin default: true

Type: null or boolean or raw lua code

Default: null

Declared by:

plugins.statuscol.settings.thousands

false or line number thousands separator string (“.” / “,”).

Plugin default: false

Type: null or string or value false (singular enum)

Default: null

Declared by: