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.