/lite-xl-widgets

Widgets that can be used on lite-xl.

Primary LanguageLuaMIT LicenseMIT

Update Notice: With the now available lpm package manager, the installation path for the Widgets has changed to: {DATADIR}/libraries/widget. Users and package maintainers are encouraged to point the widgets library to this new location as all plugins making use of it will be updated to use the new location.

Lite XL Widgets

A widgets plugin that can be used by plugin writers to more easily implement interactive UI elements. The plugin leverages lite-xl View system and provides ready to use components to reduce code duplication for stuff that most of the time is the same and simplify the process of writing your own GUI controls.

Some Features

  • dragging
  • floating view
  • on hover event
  • basic onclick event
  • tooltip by using status view
  • detection of widgets that don't need update or drawing which lowers cpu usage
  • child widget coordinates calculations relative to the parent widget

Components currently provided by this plugin are:

You can also write your own re-usable components and share them back for everyone to benefit by opening a Pull Request!

Installation

Clone into the lite-xl configuration directory, for example on linux:

mkdir ~/.config/lite-xl/libraries
git clone https://github.com/lite-xl/lite-xl-widgets ~/.config/lite-xl/libraries/widget

Usage

Until some form of documentation is written check the examples directory which contains code samples to help you understand how to use the plugin. A good starting point can be the search mockup.

Showcase Videos

Floating non blocking message boxes:

widgets-messagebox.mp4

Floating parent widget with a ListBox inside:

widgets-floating-listbox.mp4

Non floating mockup of a search side bar:

widget-non-floating.mp4

A bottom NoteBook with tabs and various widgets inside.

widget-notebook.mp4

ListBox with formatted text used in LSP plugin:

widget-lsp-workspace-symbols.mp4