LibScrollableMenu

LibScrollableMenu (Short: LSM)

Library for scrollable menus and nested submenus at ComboBoxes.
Originally developed by Kyoma for Kyoma's Titlizer, now updated by IsJustaGhost, Baertram and tomstock1337.
Example addons using this library: Improved Titleizer, AddonSelector, AdvancedFilters, merTorchbug updated.

LSM features:

- Scrollable menus at comboBoxes, or any other control (context menu)
- (Nested) submenus
- Menu header collapsible (with a default collapsed state and saved state to SavedVariables) with custom title, subtitle and search/filter editbox (with an optional custom filterFunction), sort buttons and options -> all optional per menu, controlled via the options
- Custom options for each scrollable menu (maximum height, number of visible rows, menu header, search/filter enabled, custom XML row templates, narration callback functions, ...)
- Header entry
- Divider entry
- Checkbox entry (can be added to a button group, which shows a default context menu to "Select all", "Deselect all", "Invert selection")
- Radio button entries (at least 2 are needed and must be added to a buttonGroup)
- Button entry
- Edit box entry
- Slider entry
- Color Picker entry (opens the colorpicker in a movable extra UI popup; clicks close the LSM menu -> It's not implementable differently, like keeping the menus opened does not work)
- Multiselection
- Scrollable context menu (again with nested submenus) at any entry. Checkboxes in a group even got a default context menu to select all/deselect all/invert selection
- MultiIcon at entries (multiple icons, looping through)
- "Is new" state icon (to show a changed/new entry)
- Several options e.g. to change teh maximum width, height, rows shown, submenu rows shown, the XML templates of the entry trypes, or the highlight rows, etc.
- Multiselection can be enaabled with custom texts, and showing the selected entries in submenus via the "arrow" icons' color (breadcrumbs)
- Callbacks fired at menu created (manipulate options), menu open/close, submenu open/close, contextmenu open/closeentry mouse enter, entry mouse exit, entry selected, checkbox checked state change, isNew state change
- API functions to build, show, hide and help looping entries at context menus
- Narration: Call custom function of addon to narrate or return a string to be narrated via the ESO accessibility mode UI narration feature

Radiobutons, checkboxes and buttons normally keep the dropdown opened if clicked. All other entryTypes (depending on if enabled and selectible) will close the dropdowns.

Important information - Context menus
LSM cannot work in combination with normal context menus created via ZO_Menu, as this is not scrollable.
As for example all inventory context menus use ZO_Menu you cannot use LSM there, only LibCustomMenu (which is based on ZO_Menu).

You can use LSM as scrollHelper on a ZO_ComboBox control, or as new context menu at any custom control, or at least any control where another context menu via ZO_Menu wasn't added yet. Both cannot be used in combination!
What you can do though is replace your LCM implementation with LSM so you remove ZO_Menu context menus and make them scrollable.
But using both on the same control in combination won't work.
-> It's planned to make it compatible in the future

Known Issues
--#2026_01 After a LSM contextMenu was shown and a checkbox was clicked (on the checkbox's label, not the icon!), the next opened contextMenu's checkbox label
is not changing the checkbox state (as if the first click is not accepted?), only the 2nd click does. (noticed during BMU LCM -> LSM changes at 2026-01-25)

Developer reference
Read the Github readme file and check file LSM_test.lua for example code, and the LSM_API.lua file please.
Example: https://wiki.esoui.com/How_to_create_a_scrollable_context_menu

Add a scrolhelper (dropdown scrollable) to a ZO_ComboBox:
API syntax:

Added new API functions to create the scrollable (nested) context menus at any control,like LibCustomMenu does.
API syntax:

Callbacks fired by the library where you can register via LibScrollableMenu:RegisterForCallback(callbackName, func) to

You can basically search & replace the first few params (text, entryType) of AddCustomMenuItem and AddCustomSubMenuItem with the
LibScrollableMenu's API functions AddCustomScrollableMenuEntry and AddCustomScrollableSubMenuEntry
-> Attention: Not all parameters are the same! EntryType needs to be one of LSM_ENTRY_TYPE* constants and other optiops like font, normalColor, hghlightColor etc. must be added to the parameter "additionalData" as a table!

GitHub
https://github.com/tomstock1337/eso-LibScrollableMenu

Planned features
-Support for LibCustomMenu (replace it and ZO_Menu e.g. at inventory rows)

ABOUT THIS LISTING

This page describes LibScrollableMenu by tomstock. The description and screenshots are the author's own, imported from their listing on ESOUI on 24 October 2026: https://www.esoui.com/downloads/info3546-LibScrollableMenu.html

Mythiq.net hosts no files for it. The download button goes straight to the release file on cdn.esoui.com, so you are downloading from the author's own host, not from a copy of ours.

The download count, rating and comments on this page start at zero and count Mythiq.net only. The source's own figures are not copied here — they measure a different site, and a number that cannot be checked against our own ledger is not worth printing.

API VERSION

Built for ESO API version 12.1.0, 12.0.0, 11.3.0, 11.2.0, 11.1.0. After a patch the game marks add-ons built for the previous API as out of date; the "Allow out of date add-ons" checkbox in the add-on menu loads them anyway, and most work.

LIBRARIES

Many ESO add-ons depend on a shared library — LibAddonMenu-2.0 above all — which is installed separately, exactly like an add-on. A dependency that is missing shows as the add-on simply not appearing in the list.

CONSOLE

Add-ons are PC and Mac only. There is no way to load them on console.

1. Download the archive with the button on this page and unzip it.

2. Move the unzipped folder into your add-ons directory:

Windows — Documents\Elder Scrolls Online\live\AddOns

macOS — ~/Documents/Elder Scrolls Online/live/AddOns

3. Start the game, and at the character select screen click Add-Ons.

4. Tick the add-on. If it is greyed out and marked out of date, tick "Allow out of date add-ons" at the top of the same panel.

5. Log in. Most add-ons need a /reloadui after they are first enabled.

UPDATING

Delete the old folder first. ESO loads everything it finds, and two copies of one add-on is the usual cause of "an add-on has produced an error" on login.