Kapitel 13 – Texteingabe (TextArea & Keyboard)

LVGL 9 mit MicroPython
Kapitel	13
Titel	Texteingabe (TextArea & Keyboard)
Voraussetzungen	Grundkenntnisse in MicroPython
Getestet mit	LVGL 9.x
Schwierigkeitsgrad	★★★☆☆
Benötigte Zeit	50 Minuten
Status	in Arbeit

Kapitel 13 – Texteingabe (TextArea & Keyboard)

Lernziel

Nach diesem Kapitel kannst du

• Texteingabefelder (TextArea) verwenden,
• eine Bildschirmtastatur einbinden,
• Eingaben mit einem Widget verbinden,
• einfache Dialoge erstellen.

Was ist eine TextArea?

Eine TextArea ist ein Eingabefeld für Text.

Der Benutzer kann darin schreiben, löschen und bearbeiten.

Typische Anwendungen:

• WLAN-Passwort
• Benutzername
• Einstellungen
• Suchfelder

Erste TextArea

import lvgl as lv

scr = lv.screen_active()

ta = lv.textarea(scr)
ta.set_width(200)
ta.align(lv.ALIGN.CENTER, 0, 0)

Erklärung

Die TextArea wird wie jedes Widget erzeugt:

ta = lv.textarea(scr)

Sie wird anschließend positioniert.

Text setzen

ta.set_text("Hallo")

Eingabe aktivieren

Die TextArea ist zunächst nicht automatisch mit einer Tastatur verbunden.

Dafür wird eine virtuelle Tastatur benötigt.

Keyboard Widget

kb = lv.keyboard(scr)

Verbindung zwischen Keyboard und TextArea

kb.set_textarea(ta)

Beispiel komplett

import lvgl as lv

scr = lv.screen_active()

ta = lv.textarea(scr)
ta.set_width(220)
ta.align(lv.ALIGN.TOP_MID, 0, 10)

kb = lv.keyboard(scr)
kb.set_textarea(ta)

Erklärung

• TextArea nimmt Eingaben entgegen
• Keyboard sendet Eingaben an die TextArea
• Beide sind normale LVGL-Widgets

Verhalten

Wenn der Benutzer ein Zeichen auf der Tastatur drückt:

1. Keyboard erkennt Eingabe 2. Zeichen wird an TextArea gesendet 3. TextArea aktualisiert ihren Inhalt

Typische Anwendung

• Login-Bildschirm
• WLAN-Konfiguration
• Parameter-Eingabe
• Suchfunktionen

Hinweise

Hinweis

Keyboard und TextArea müssen im selben Screen sein.

Mehrzeilige Eingabe

ta.set_one_line(False)

Passwortfeld

ta.set_password_mode(True)

Beispiel Passwort

ta = lv.textarea(scr)
ta.set_password_mode(True)
ta.set_placeholder_text("Passwort eingeben")

Placeholder Text

ta.set_placeholder_text("Benutzername")

Typischer Fehler

Achtung

Viele vergessen, die TextArea mit dem Keyboard zu verbinden.

Ohne set_textarea() funktioniert keine Eingabe.

Merke

Merke

Eine TextArea ist das Eingabefeld. Das Keyboard ist die Eingabemethode.

Zusammenfassung

• TextArea ist ein Eingabefeld
• Keyboard liefert Eingaben
• Beide müssen verbunden werden
• Typisch für Login- und Einstellungsseiten