lvgl.file¶

lvgl.file([parent, ]params)

Display a button showing a filename. Tapping it opens a popup file picker, using EdgeTX styling.

Parameters¶

Name Req Type Description

parent no object optional LVGL object to attach the new object to; if omitted the object is created in the top-level script window

params yes table

Field	Type	Description
`x`	`number`	position relative to the top-left of the parent
`y`	`number`	position relative to the top-left of the parent
`w`	`number`	width
`h`	`number`	height
`color`	`color or function`	primary color for the object
`pos`	`function`	dynamic position callback returning `x, y`
`size`	`function`	dynamic size callback returning `w, h`
`visible`	`function`	dynamic visibility callback
`floating`	`boolean`	keep the object fixed inside a scrollable container, added in 2.11.6, defaults to false
`title`	`string`	text displayed in the popup's header, defaults to an empty string
`get`	`function`	called when the popup is opened, and after the selection changes, to get the currently selected filename; must return a string, defaults to nil
`set`	`function`	called when the user picks a file; passed the selected filename (without path), defaults to nil
`active`	`function`	sets the enabled/disabled state; must return a boolean, true to enable, defaults to nil
`folder`	`string`	SD card folder to browse for files, defaults to nil
`extension`	`string`	extension filter, e.g. `.png` or concatenated `.png.bmp` to match multiple, defaults to nil (no filter)
`hideExtension`	`boolean`	if true, the extension is stripped before `set` is called and hidden in the picker list, defaults to false
`maxLen`	`number`	maximum filename length (measured after `hideExtension` stripping, if set); files with longer names are not shown in the picker list, defaults to 255

Name	Type	Description
`-`	`table`	LVGL object, or nil if not running as a One-Time script or fullscreen widget

Only available for One-Time scripts and widgets running in full screen mode -- returns nil otherwise. @notice The popup closes and set is called when the user picks a file. @notice If the user taps outside the popup or presses RTN, the popup closes without calling set.

radio/src/lua/api_colorlcd_lvgl.cpp