mirror of
https://git.mirrors.martin98.com/https://github.com/luc-github/ESP3D.git
synced 2025-08-05 08:00:40 +08:00

### Maintenance page * Add add tab color for mobile view * Add spellcheck off / autocorect off in input * Add disconnect button when authenticate enabled * Add Invalid user or password message when authentication failed ### Board support * Add ESP32 S2 support * Add ESP32 S3 support * Add ESP32 C3 support ### ESP commands * Add command 701 to control GCODE streaming * Remove command 901 as duplicate * Update command 420 to add more details * Use text as default output * All json on all commands for formated output ### Core * Add benchmak function to check transfer speed (for test only-not production) * Merge code for ESP3DLib support * Add better printer display support (M117 / Serial TFT) * Use ESP32 analogWrite instead of emulated one ### Modules * Display * Refactor code * Remove SPI ILI 9341 / 9488 support as not suitable * Add ST7789 support (135x240 / 240x240) * Filesystem * Bug fixes due to esp core updates * Better SD sharing mecanism * Better global FS management * FTP * Add SD sharing support * Better global FS management * GCODE Host * Add basic support for macro files * Add ESP command support * Use not blocking method to stream commands / handle response * Notifications * Add IFTTT notification service * Add WebUI notification * Add ESP3D display notification * WebDav * Add SD sharing support * Add bug fix from https://github.com/d-a-v/ESPWebDAV * Better global FS management * Websocket * Add function to handle zombies connections * WiFi * Fix connection to AP sometime fail * Fix low signal not diplayed in ESP420 even connected * Add AP Setup mode ### Libraries * Update SDFat-2.0.6 to 2.1.2 * Update ESP32SSDP 1.1.1 to 1.2.0 * Update TFT_eSPI-1.4.11 to 2.4.61 * Update arduinoWebSockets-2.3.5 to 2.3.6 * Update esp8266-oled-ssd1306-4.0.0 to 4.3.0 * Remove lvgl support ### Tools * Add I2C scanner script * Add python script to simulate/stress printer serial communication ### PlatformIO * Use latest 4.4.0 Espressif32 release (ESP32-arduino core 2.0.3) * Add fix for Flash more than 4MB * Add Esp32 S2/S3/C3 env * Add ESP32-ST7789 / esp32-TTGO_T_Display env
61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
```eval_rst
|
|
.. include:: /header.rst
|
|
:github_url: |github_link_base|/others/gridnav.md
|
|
```
|
|
# Grid navigation
|
|
|
|
Grid navigation (gridnav for short) is a feature that changes the currently focused child object as arrow keys are pressed.
|
|
|
|
If the children are arranged into a grid-like layout then the up, down, left and right arrows move focus to the nearest sibling
|
|
in the respective direction.
|
|
|
|
It doesn't matter how the children are positioned, as only the current x and y coordinates are considered.
|
|
This means that gridnav works with manually positioned children, as well as [Flex](/layouts/flex.html) and [Grid](/layouts/grid.html) layouts.
|
|
|
|
Gridnav also works if the children are arranged into a single row or column.
|
|
That makes it useful, for example, to simplify navigation on a [List widget](/widgets/extra/list.html).
|
|
|
|
Gridnav assumes that the object to which gridnav is added is part of a [group](/overview/indev.html#groups).
|
|
This way, if the object with gridnav is focused, the arrow key presses are automatically forwarded to the object
|
|
so that gridnav can process the arrow keys.
|
|
|
|
To move the focus to the next widget of the group use `LV_KEY_NEXT/PREV` or `lv_group_focus_next/prev()` or the `TAB` key on keyboard as usual.
|
|
|
|
If the container is scrollable and the focused child is out of the view, gridnav will automatically scroll the child into view.
|
|
|
|
## Usage
|
|
|
|
To add the gridnav feature to an object use `lv_gridnav_add(cont, flags)`.
|
|
|
|
`flags` control the behavior of gridnav:
|
|
- `LV_GRIDNAV_CTRL_NONE` Default settings
|
|
- `LV_GRIDNAV_CTRL_ROLLOVER` If there is no next/previous object in a direction,
|
|
the focus goes to the object in the next/previous row (on left/right keys) or first/last row (on up/down keys
|
|
- `LV_GRIDNAV_CTRL_SCROLL_FIRST` If an arrow is pressed and the focused object can be scrolled in that direction
|
|
then it will be scrolled instead of going to the next/previous object. If there is no more room for scrolling the next/previous object will be focused normally
|
|
|
|
`lv_gridnav_remove(cont)` Removes gridnav from an object.
|
|
|
|
## Focusable objects
|
|
|
|
An object needs to be clickable or click focusable (`LV_OBJ_FLAG_CLICKABLE` or `LV_OBJ_FLAG_CLICK_FOCUSABLE`)
|
|
and not hidden (`LV_OBJ_FLAG_HIDDEN`) to be focusable by gridnav.
|
|
|
|
|
|
## Example
|
|
|
|
```eval_rst
|
|
|
|
.. include:: ../../examples/others/gridnav/index.rst
|
|
|
|
```
|
|
## API
|
|
|
|
|
|
```eval_rst
|
|
|
|
.. doxygenfile:: lv_gridnav.h
|
|
:project: lvgl
|
|
|
|
```
|