Contents Menu Expand Light mode Dark mode System, in dark mode System, in light mode View documentation source on GitHub Skip to content
LVGL 9.4 documentation
Light Logo Dark Logo
  • Introduction
    • Requirements
    • License
    • FAQ
    • The LVGL Repository
  • Getting started
    • Learn the Basics
    • Basic Examples
    • What's Next?
  • Examples
  • Integrating LVGL
    • Overview
      • Getting LVGL
      • Building LVGL
      • Configuration
      • Connecting LVGL to Your Hardware
      • Timer Handler
      • Threading Considerations
      • Other Platforms and Tools
    • Running on PC
      • Overview
      • Linux
      • Windows
      • MacOS
      • Browser
      • SDL Driver
      • UEFI Display/Inputs driver
    • Running under Embedded Linux
      • Overview
      • OS Support
        • Buildroot
          • Quick Setup
          • RPi4 custom image
          • LVGL application
        • Yocto
          • Yocto Project Core Components
          • LVGL in Yocto
          • Yocto Project Terms
        • Torizon OS
      • Drivers
        • Linux Framebuffer Driver
        • DRM
        • GLFW
        • Wayland Display/Inputs driver
        • X11 Display/Inputs driver
        • evdev
        • libinput
    • RTOS Support
      • FreeRTOS
      • MQX RTOS
      • NuttX RTOS
      • PX5 RTOS
      • QNX
      • RT-Thread RTOS
      • Zephyr
    • Framework Support
      • Arduino
      • PlatformIO
      • Tasmota and berry
    • Board Support
      • LVGL Supported
      • Partner Supported
      • Boards
        • ICOP
        • Toradex
        • Riverdi
        • Viewe
    • Chip Vendor Support
      • Alif
        • Overview
        • Dave2D GPU
      • Arm
        • Overview
        • Arm-2D GPU
      • Espressif
        • Overview
        • Espressif Pixel Processing Accelerator
      • NXP
        • Overview
        • NXP eLCDIF
        • NXP PXP GPU
        • VG-Lite General GPU
        • NXP G2D GPU
      • Renesas
        • Built-in Drivers
        • RA Family
        • RX Family
        • RZ/G Family
        • RZ/A Family
        • Supported Boards
        • Renesas GLCDC
        • Dave2D GPU
      • STM32
        • Overview
        • STM32 LTDC Driver
        • NemaGFX Acceleration
        • STM32 DMA2D GPU
        • Step-by-step Guide: How to use the LVGL v9 LCD drivers with STM32 devices
    • Display Controller Support
      • EVE
        • EVE (FT81x)
        • EVE External GPU Renderer
      • Generic MIPI DCS compatible LCD Controller driver
      • ILI9341 LCD Controller driver
      • ST7735 LCD Controller driver
      • ST7789 LCD Controller driver
      • ST7796 LCD Controller driver
    • Build System Support
      • make
      • CMake
    • Bindings
      • Output API as JSON Data
      • Cpp
      • JavaScript
      • MicroPython
      • PikaScript
  • Common Widget Features
    • Widget Basics
    • Positions, Sizes and Layouts
    • Layers
    • Styles
      • Styles Overview
      • Style Properties
    • Events
    • Layouts
      • Flex
      • Grid
    • Scrolling
  • All Widgets
    • Base Widget (lv_obj)
    • 3D Texture (lv_3dtexture)
    • Animation Image (lv_animimg)
    • Arc (lv_arc)
    • Arc Label (lv_arclabel)
    • Bar (lv_bar)
    • Button (lv_button)
    • Button Matrix (lv_buttonmatrix)
    • Calendar (lv_calendar)
    • Canvas (lv_canvas)
    • Chart (lv_chart)
    • Checkbox (lv_checkbox)
    • Drop-Down List (lv_dropdown)
    • Image (lv_image)
    • Image Button (lv_imagebutton)
    • Keyboard (lv_keyboard)
    • Label (lv_label)
    • LED (lv_led)
    • Line (lv_line)
    • List (lv_list)
    • Lottie (lv_lottie)
    • Menu (lv_menu)
    • Message Box (lv_msgbox)
    • Roller (lv_roller)
    • Scale (lv_scale)
    • Slider (lv_slider)
    • Spangroup (lv_spangroup)
    • Spinbox (lv_spinbox)
    • Spinner (lv_spinner)
    • Switch (lv_switch)
    • Table (lv_table)
    • Tab View (lv_tabview)
    • Text Area (lv_textarea)
    • Tile View (lv_tileview)
    • Window (lv_win)
    • New Widget
  • Main Modules
    • Display (lv_display)
      • Overview
      • Setting Up Your Display(s)
      • Screen Layers
      • Color Format
      • Refreshing
      • Display Events
      • Changing Resolution
      • Inactivity Measurement
      • Rotation
      • Constraints on Redrawn Area
      • Tiled Rendering
      • Extending/Combining Displays
    • Input Device (lv_indev)
    • Color (lv_color)
    • Font (lv_font)
    • Images (lv_image)
    • Timer (lv_timer)
    • Animation (lv_anim)
    • File System (lv_fs_drv)
    • Drawing
      • Draw Pipeline
      • Draw API
      • Draw Layers
      • Draw Descriptors
  • XML - Declarative UI
    • Overview
      • Introduction
      • Component Library
      • Project
      • Syntax
    • Build UIs
      • Root elements
        • Components
        • Widgets
        • Screens
      • Main tags
        • API
        • Constants
        • Styles
        • View
        • Animations
        • Preview
      • Assets
        • Images
        • Fonts
      • Events
      • Data binding (Subjects)
      • Translations
    • UI Testing
    • License
  • Auxiliary Modules
    • File Explorer
    • Font Manager
    • Fragment
    • Grid navigation
    • Pinyin IME
    • Image font
    • Monkey
    • Widget ID
    • Widget Properties
    • Observer
      • How to Use
      • Examples
    • Snapshot
    • System Monitor (sysmon)
    • UI Testing
    • Translation
  • 3rd-Party Libraries
    • Arduino ESP littlefs
    • Arduino SD
    • Barcode
    • BMP Decoder
    • FFmpeg Support
    • FreeType Support
    • File System Interfaces
    • GIF Decoder
    • glTF
    • littlefs
    • libjpeg-turbo Decoder
    • libpng Decoder
    • LodePNG Decoder
    • QR Code
    • RLE Decompression
    • Rlottie Player
    • SVG Support
    • Tiny TTF font engine
    • Tiny JPEG Decompressor (TJpgDec)
  • Debugging
    • GDB Plug-In
    • Logging
    • Profiler
    • VG-Lite Simulator
  • Contributing
    • Introduction
    • Ways to Contribute
    • Pull Requests
    • Developer Certification of Origin (DCO)
    • Coding Style
  • Change Log
  • API
    • lv_api_map_v8.h
    • lv_api_map_v9_0.h
    • lv_api_map_v9_1.h
    • lv_api_map_v9_2.h
    • lv_api_map_v9_3.h
    • lv_conf_internal.h
    • lv_conf_kconfig.h
    • lv_init.h
    • lvgl.h
    • lvgl_private.h
    • core
      • lv_global.h
      • lv_group.h
      • lv_group_private.h
      • lv_obj.h
      • lv_obj_class.h
      • lv_obj_class_private.h
      • lv_obj_draw.h
      • lv_obj_draw_private.h
      • lv_obj_event.h
      • lv_obj_event_private.h
      • lv_obj_pos.h
      • lv_obj_private.h
      • lv_obj_scroll.h
      • lv_obj_scroll_private.h
      • lv_obj_style.h
      • lv_obj_style_gen.h
      • lv_obj_style_private.h
      • lv_obj_tree.h
      • lv_refr.h
      • lv_refr_private.h
    • display
      • lv_display.h
      • lv_display_private.h
    • draw
      • lv_draw.h
      • lv_draw_3d.h
      • lv_draw_arc.h
      • lv_draw_buf.h
      • lv_draw_buf_private.h
      • lv_draw_image.h
      • lv_draw_image_private.h
      • lv_draw_label.h
      • lv_draw_label_private.h
      • lv_draw_line.h
      • lv_draw_mask.h
      • lv_draw_mask_private.h
      • lv_draw_private.h
      • lv_draw_rect.h
      • lv_draw_rect_private.h
      • lv_draw_triangle.h
      • lv_draw_triangle_private.h
      • lv_draw_vector.h
      • lv_draw_vector_private.h
      • lv_image_decoder.h
      • lv_image_decoder_private.h
      • lv_image_dsc.h
      • dma2d
        • lv_draw_dma2d.h
        • lv_draw_dma2d_private.h
      • espressif
        • ppa
          • lv_draw_ppa.h
          • lv_draw_ppa_private.h
      • eve
        • lv_draw_eve.h
        • lv_draw_eve_private.h
        • lv_draw_eve_ram_g.h
        • lv_draw_eve_target.h
        • lv_eve.h
      • nema_gfx
        • lv_draw_nema_gfx.h
        • lv_draw_nema_gfx_utils.h
        • lv_nema_gfx_path.h
      • nxp
        • g2d
          • lv_draw_g2d.h
          • lv_g2d_buf_map.h
          • lv_g2d_utils.h
        • pxp
          • lv_draw_pxp.h
          • lv_pxp_cfg.h
          • lv_pxp_osa.h
          • lv_pxp_utils.h
        • vglite
          • lv_draw_vglite.h
          • lv_vglite_buf.h
          • lv_vglite_matrix.h
          • lv_vglite_path.h
          • lv_vglite_utils.h
      • opengles
        • lv_draw_opengles.h
      • renesas
        • dave2d
          • lv_draw_dave2d.h
          • lv_draw_dave2d_utils.h
      • sdl
        • lv_draw_sdl.h
      • sw
        • lv_draw_sw.h
        • lv_draw_sw_grad.h
        • lv_draw_sw_mask.h
        • lv_draw_sw_mask_private.h
        • lv_draw_sw_private.h
        • lv_draw_sw_utils.h
        • arm2d
          • lv_draw_sw_arm2d.h
          • lv_draw_sw_helium.h
        • blend
          • lv_draw_sw_blend.h
          • lv_draw_sw_blend_private.h
          • lv_draw_sw_blend_to_al88.h
          • lv_draw_sw_blend_to_argb8888.h
          • lv_draw_sw_blend_to_argb8888_premultiplied.h
          • lv_draw_sw_blend_to_i1.h
          • lv_draw_sw_blend_to_l8.h
          • lv_draw_sw_blend_to_rgb565.h
          • lv_draw_sw_blend_to_rgb565_swapped.h
          • lv_draw_sw_blend_to_rgb888.h
          • arm2d
            • lv_blend_arm2d.h
          • helium
            • lv_blend_helium.h
          • neon
            • lv_blend_neon.h
            • lv_draw_sw_blend_neon_to_rgb565.h
      • vg_lite
        • lv_draw_vg_lite.h
        • lv_draw_vg_lite_type.h
        • lv_vg_lite_decoder.h
        • lv_vg_lite_grad.h
        • lv_vg_lite_math.h
        • lv_vg_lite_path.h
        • lv_vg_lite_pending.h
        • lv_vg_lite_stroke.h
        • lv_vg_lite_utils.h
    • drivers
      • lv_drivers.h
      • display
        • drm
          • lv_linux_drm.h
        • fb
          • lv_linux_fbdev.h
        • ft81x
          • lv_ft81x.h
          • lv_ft81x_defines.h
        • ili9341
          • lv_ili9341.h
        • lcd
          • lv_lcd_generic_mipi.h
        • nxp_elcdif
          • lv_nxp_elcdif.h
        • renesas_glcdc
          • lv_renesas_glcdc.h
        • st7735
          • lv_st7735.h
        • st7789
          • lv_st7789.h
        • st7796
          • lv_st7796.h
        • st_ltdc
          • lv_st_ltdc.h
        • tft_espi
          • lv_tft_espi.h
      • draw
        • eve
          • lv_draw_eve_display.h
          • lv_draw_eve_display_defines.h
      • evdev
        • lv_evdev.h
        • lv_evdev_private.h
      • glfw
        • lv_glfw_window.h
        • lv_glfw_window_private.h
        • lv_opengles_debug.h
        • lv_opengles_driver.h
        • lv_opengles_texture.h
      • libinput
        • lv_libinput.h
        • lv_libinput_private.h
        • lv_xkb.h
        • lv_xkb_private.h
      • nuttx
        • lv_nuttx_cache.h
        • lv_nuttx_entry.h
        • lv_nuttx_fbdev.h
        • lv_nuttx_image_cache.h
        • lv_nuttx_lcd.h
        • lv_nuttx_libuv.h
        • lv_nuttx_mouse.h
        • lv_nuttx_profiler.h
        • lv_nuttx_touchscreen.h
      • qnx
        • lv_qnx.h
      • sdl
        • lv_sdl_keyboard.h
        • lv_sdl_mouse.h
        • lv_sdl_mousewheel.h
        • lv_sdl_private.h
        • lv_sdl_window.h
      • uefi
        • lv_uefi.h
        • lv_uefi_context.h
        • lv_uefi_display.h
        • lv_uefi_edk2.h
        • lv_uefi_gnu_efi.h
        • lv_uefi_indev.h
        • lv_uefi_private.h
        • lv_uefi_std_wrapper.h
      • wayland
        • lv_wayland.h
        • lv_wayland_private.h
        • lv_wayland_smm.h
        • lv_wl_keyboard.h
        • lv_wl_pointer.h
        • lv_wl_pointer_axis.h
        • lv_wl_touch.h
        • lv_wl_window.h
      • windows
        • lv_windows_context.h
        • lv_windows_display.h
        • lv_windows_input.h
        • lv_windows_input_private.h
      • x11
        • lv_x11.h
    • font
      • lv_binfont_loader.h
      • lv_font.h
      • lv_font_fmt_txt.h
      • lv_font_fmt_txt_private.h
      • lv_symbol_def.h
    • indev
      • lv_indev.h
      • lv_indev_gesture.h
      • lv_indev_gesture_private.h
      • lv_indev_private.h
      • lv_indev_scroll.h
    • layouts
      • lv_layout.h
      • lv_layout_private.h
      • flex
        • lv_flex.h
      • grid
        • lv_grid.h
    • libs
      • barcode
        • lv_barcode.h
        • lv_barcode_private.h
      • bin_decoder
        • lv_bin_decoder.h
      • bmp
        • lv_bmp.h
      • ffmpeg
        • lv_ffmpeg.h
        • lv_ffmpeg_private.h
      • freetype
        • lv_freetype.h
        • lv_freetype_private.h
      • fsdrv
        • lv_fsdrv.h
      • gif
        • lv_gif.h
        • lv_gif_private.h
      • gltf
        • gltf_data
          • lv_gltf_bind.h
          • lv_gltf_data_internal.h
          • lv_gltf_data_internal.hpp
          • lv_gltf_model.h
        • gltf_view
          • lv_gltf.h
          • lv_gltf_view_internal.h
          • assets
            • lv_gltf_view_shader.h
          • ibl
            • lv_gltf_ibl_sampler.h
        • math
          • lv_gltf_math.hpp
        • opengl_shader
          • lv_opengl_shader_internal.h
      • libjpeg_turbo
        • lv_libjpeg_turbo.h
      • libpng
        • lv_libpng.h
      • lodepng
        • lv_lodepng.h
      • qrcode
        • lv_qrcode.h
        • lv_qrcode_private.h
      • rle
        • lv_rle.h
      • rlottie
        • lv_rlottie.h
        • lv_rlottie_private.h
      • svg
        • lv_svg.h
        • lv_svg_decoder.h
        • lv_svg_parser.h
        • lv_svg_render.h
        • lv_svg_token.h
      • tiny_ttf
        • lv_tiny_ttf.h
      • tjpgd
        • lv_tjpgd.h
    • misc
      • lv_anim.h
      • lv_anim_private.h
      • lv_anim_timeline.h
      • lv_anim_timeline_private.h
      • lv_area.h
      • lv_area_private.h
      • lv_array.h
      • lv_assert.h
      • lv_async.h
      • lv_bidi.h
      • lv_bidi_private.h
      • lv_circle_buf.h
      • lv_color.h
      • lv_color_op.h
      • lv_color_op_private.h
      • lv_event.h
      • lv_event_private.h
      • lv_fs.h
      • lv_fs_private.h
      • lv_grad.h
      • lv_iter.h
      • lv_ll.h
      • lv_log.h
      • lv_lru.h
      • lv_math.h
      • lv_matrix.h
      • lv_palette.h
      • lv_profiler.h
      • lv_profiler_builtin.h
      • lv_profiler_builtin_private.h
      • lv_rb.h
      • lv_rb_private.h
      • lv_style.h
      • lv_style_gen.h
      • lv_style_private.h
      • lv_templ.h
      • lv_text.h
      • lv_text_ap.h
      • lv_text_private.h
      • lv_timer.h
      • lv_timer_private.h
      • lv_tree.h
      • lv_utils.h
      • cache
        • lv_cache.h
        • lv_cache_entry.h
        • lv_cache_entry_private.h
        • lv_cache_private.h
        • class
          • lv_cache_class.h
          • lv_cache_lru_ll.h
          • lv_cache_lru_rb.h
          • lv_cache_sc_da.h
        • instance
          • lv_cache_instance.h
          • lv_image_cache.h
          • lv_image_header_cache.h
    • osal
      • lv_linux_private.h
      • lv_os.h
      • lv_os_none.h
      • lv_os_private.h
    • others
      • file_explorer
        • lv_file_explorer.h
        • lv_file_explorer_private.h
      • font_manager
        • lv_font_manager.h
        • lv_font_manager_recycle.h
      • fragment
        • lv_fragment.h
        • lv_fragment_private.h
      • gridnav
        • lv_gridnav.h
      • ime
        • lv_ime_pinyin.h
        • lv_ime_pinyin_private.h
      • imgfont
        • lv_imgfont.h
      • monkey
        • lv_monkey.h
        • lv_monkey_private.h
      • observer
        • lv_observer.h
        • lv_observer_private.h
      • snapshot
        • lv_snapshot.h
      • sysmon
        • lv_sysmon.h
        • lv_sysmon_private.h
      • test
        • lv_test.h
        • lv_test_display.h
        • lv_test_helpers.h
        • lv_test_indev.h
        • lv_test_indev_gesture.h
        • lv_test_private.h
        • lv_test_screenshot_compare.h
      • translation
        • lv_translation.h
        • lv_translation_private.h
      • xml
        • lv_xml.h
        • lv_xml_base_types.h
        • lv_xml_component.h
        • lv_xml_component_private.h
        • lv_xml_parser.h
        • lv_xml_private.h
        • lv_xml_style.h
        • lv_xml_test.h
        • lv_xml_translation.h
        • lv_xml_update.h
        • lv_xml_utils.h
        • lv_xml_widget.h
        • parsers
          • lv_xml_arc_parser.h
          • lv_xml_bar_parser.h
          • lv_xml_button_parser.h
          • lv_xml_buttonmatrix_parser.h
          • lv_xml_calendar_parser.h
          • lv_xml_canvas_parser.h
          • lv_xml_chart_parser.h
          • lv_xml_checkbox_parser.h
          • lv_xml_dropdown_parser.h
          • lv_xml_image_parser.h
          • lv_xml_keyboard_parser.h
          • lv_xml_label_parser.h
          • lv_xml_obj_parser.h
          • lv_xml_roller_parser.h
          • lv_xml_scale_parser.h
          • lv_xml_slider_parser.h
          • lv_xml_spangroup_parser.h
          • lv_xml_switch_parser.h
          • lv_xml_table_parser.h
          • lv_xml_tabview_parser.h
          • lv_xml_textarea_parser.h
    • stdlib
      • lv_mem.h
      • lv_mem_private.h
      • lv_sprintf.h
      • lv_string.h
      • builtin
        • lv_tlsf.h
        • lv_tlsf_private.h
    • themes
      • lv_theme.h
      • lv_theme_private.h
      • default
        • lv_theme_default.h
      • mono
        • lv_theme_mono.h
      • simple
        • lv_theme_simple.h
    • tick
      • lv_tick.h
      • lv_tick_private.h
    • widgets
      • 3dtexture
        • lv_3dtexture.h
        • lv_3dtexture_private.h
      • animimage
        • lv_animimage.h
        • lv_animimage_private.h
      • arc
        • lv_arc.h
        • lv_arc_private.h
      • arclabel
        • lv_arclabel.h
        • lv_arclabel_private.h
      • bar
        • lv_bar.h
        • lv_bar_private.h
      • button
        • lv_button.h
        • lv_button_private.h
      • buttonmatrix
        • lv_buttonmatrix.h
        • lv_buttonmatrix_private.h
      • calendar
        • lv_calendar.h
        • lv_calendar_chinese.h
        • lv_calendar_header_arrow.h
        • lv_calendar_header_dropdown.h
        • lv_calendar_private.h
      • canvas
        • lv_canvas.h
        • lv_canvas_private.h
      • chart
        • lv_chart.h
        • lv_chart_private.h
      • checkbox
        • lv_checkbox.h
        • lv_checkbox_private.h
      • dropdown
        • lv_dropdown.h
        • lv_dropdown_private.h
      • image
        • lv_image.h
        • lv_image_private.h
      • imagebutton
        • lv_imagebutton.h
        • lv_imagebutton_private.h
      • keyboard
        • lv_keyboard.h
        • lv_keyboard_private.h
      • label
        • lv_label.h
        • lv_label_private.h
      • led
        • lv_led.h
        • lv_led_private.h
      • line
        • lv_line.h
        • lv_line_private.h
      • list
        • lv_list.h
      • lottie
        • lv_lottie.h
        • lv_lottie_private.h
      • menu
        • lv_menu.h
        • lv_menu_private.h
      • msgbox
        • lv_msgbox.h
        • lv_msgbox_private.h
      • objx_templ
        • lv_objx_templ.h
      • property
        • lv_obj_property_names.h
        • lv_style_properties.h
      • roller
        • lv_roller.h
        • lv_roller_private.h
      • scale
        • lv_scale.h
        • lv_scale_private.h
      • slider
        • lv_slider.h
        • lv_slider_private.h
      • span
        • lv_span.h
        • lv_span_private.h
      • spinbox
        • lv_spinbox.h
        • lv_spinbox_private.h
      • spinner
        • lv_spinner.h
      • switch
        • lv_switch.h
        • lv_switch_private.h
      • table
        • lv_table.h
        • lv_table_private.h
      • tabview
        • lv_tabview.h
        • lv_tabview_private.h
      • textarea
        • lv_textarea.h
        • lv_textarea_private.h
      • tileview
        • lv_tileview.h
        • lv_tileview_private.h
      • win
        • lv_win.h
        • lv_win_private.h
Back to top
View this page

OverviewΒΆ

  • Introduction
    • Concept
    • Widgets, Components, and Screens
    • Syntax Teaser
    • Usage Teaser
  • Component Library
    • Overview
    • Structure
    • Visibility
    • globals.xml
  • Project
    • Overview
    • Example
  • Syntax
    • Naming conventions
    • Types
Next
Introduction
Previous
XML - Declarative UI
Copyright © 2021-2025, LVGL Kft
Made with Furo
Last updated on Sep 02, 2025