Zum Hauptinhalt springen

Eingabedialog

In ChatGPT öffnen
Shadow 24.02
Java API

Ein InputDialog ist ein modaler Dialog, der dazu dient, den Benutzer um Eingaben zu bitten. Der Dialog blockiert die Ausführung der Anwendung, bis der Benutzer die Eingabe liefert oder den Dialog schließt.

Code anzeigen

Verwendungen​

Der InputDialog bietet eine Möglichkeit, Benutzer nach Eingaben zu fragen, z. B. nach Text, Zahlen oder anderen Daten, und stellt sicher, dass sie die erforderlichen Informationen bereitstellen, bevor sie fortfahren.

Typen​

Eingabetypen​

Der InputDialog unterstützt verschiedene Arten von Eingabefeldern, damit Sie die Eingabemethode an Ihre spezifischen Bedürfnisse anpassen können:

  1. TEXT: Eine Standard-Eingabezeile für Text.
  2. PASSWORD: Ein Eingabefeld für Passwörter, das die Eingabe des Benutzers verbirgt.
  3. NUMBER: Ein numerisches Eingabefeld.
  4. EMAIL: Ein Eingabefeld für E-Mail-Adressen.
  5. URL: Ein Eingabefeld für URLs.
  6. SEARCH: Ein Eingabefeld für Suchtext.
  7. DATE: Ein Eingabefeld zur Auswahl von Daten.
  8. TIME: Ein Eingabefeld zur Auswahl von Zeiten.
  9. DATETIME_LOCAL: Ein Eingabefeld zur Auswahl von lokalem Datum und Uhrzeit.
  10. COLOR: Ein Eingabefeld zur Auswahl einer Farbe.

Nachrichtentyp​

Der InputDialog unterstützt die folgenden Nachrichtentypen. Wenn Sie einen Typ konfigurieren, zeigt der Dialog ein Symbol neben der Nachricht an, und das Design des Dialogs wird gemäß den Regeln des WebforJ-Designsystems aktualisiert.

  1. PLAIN: Zeigt die Nachricht ohne Symbol mit dem Standarddesign an.
  2. ERROR: Zeigt ein Fehler-Symbol neben der Nachricht mit dem Fehlerdesign an.
  3. QUESTION: Zeigt ein Fragezeichen-Symbol neben der Nachricht mit dem primären Design an.
  4. WARNING: Zeigt ein Warnsymbol neben der Nachricht mit dem Warnungsdesign an.
  5. INFO: Zeigt ein Informationssymbol neben der Nachricht mit dem Informationsdesign an.

Im folgenden Beispiel wird der Benutzer aufgefordert, sein Passwort einzugeben, um auf die Anwendung zuzugreifen. Wenn die Anmeldung fehlschlägt, wird der Benutzer erneut aufgefordert.

Code anzeigen

Ergebnis​

Der InputDialog gibt die Eingabe des Benutzers als Zeichenfolge zurück. Wenn der Benutzer den Dialog schließt, ohne eine Eingabe zu liefern, wird das Ergebnis null sein.

important

Die resultierende Zeichenfolge wird von der show()-Methode oder einer entsprechenden OptionDialog-Methode zurückgegeben, wie unten gezeigt.

String result = OptionDialog.showInputDialog(
    "Bitte geben Sie Ihr Alter ein:", "Altersangabe", "", InputDialog.InputType.NUMBER);

if (result != null) {
    OptionDialog.showMessageDialog("Sie haben eingegeben: " + result, "Eingabe erhalten");
} else {
    OptionDialog.showMessageDialog("Keine Eingabe erhalten", "Eingabe abgebrochen");
}

Standardwert​

Der InputDialog ermöglicht es Ihnen, einen Standardwert anzugeben, der im Eingabefeld angezeigt wird, wenn der Dialog angezeigt wird. Dies kann den Benutzern eine Vorschlag oder einen zuvor eingegebenen Wert bieten.

InputDialog dialog = new InputDialog(
    "Bitte geben Sie Ihren Namen ein:", "Namenseingabe", "Max Mustermann", InputDialog.InputType.TEXT);
String result = dialog.show();

Timeout​

Der InputDialog ermöglicht es Ihnen, eine Timeout-Dauer festzulegen, nach der der Dialog automatisch geschlossen wird. Diese Funktion ist nützlich für nicht kritische Eingabeanforderungen oder Aktionen, die keine sofortige Interaktion des Benutzers erfordern.

Sie können das Timeout für den Dialog mit der Methode setTimeout(int timeout) konfigurieren. Die Timeout-Dauer wird in Sekunden angegeben. Wenn die angegebene Zeit ohne Benutzerinteraktion abläuft, schließt sich der Dialog automatisch.

InputDialog dialog = new InputDialog(
    "Bitte geben Sie Ihren Namen ein:", "Namenseingabe", "Max Mustermann");
dialog.setTimeout(5);
String result = dialog.show();

OptionDialog.showMessageDialog(
    "Sie haben eingegeben: " + result, "Eingabe erhalten", "OK", MessageDialog.MessageType.INFO);

Best Practices​

  1. Klare und präzise Aufforderungen: Stellen Sie sicher, dass die Aufforderungsnachricht klar erklärt, welche Informationen der Benutzer bereitstellen soll.
  2. Angemessene Eingabetypen: Wählen Sie Eingabetypen, die mit den erforderlichen Daten übereinstimmen, um genaue und relevante Benutzereingaben sicherzustellen.
  3. Logische Standardwerte: Setzen Sie Standardwerte, die nützliche Vorschläge oder frühere Eingaben bieten, um die Benutzereingabe zu optimieren.
  4. Bedachte Nutzung von Timeouts: Setzen Sie Timeouts für nicht kritische Eingabeanforderungen, um sicherzustellen, dass Benutzer genügend Zeit haben, die erforderlichen Informationen bereitzustellen.
  5. Minimieren der Übernutzung: Verwenden Sie Eingabedialoge sparsam, um Frustration bei den Benutzern zu vermeiden. Reservieren Sie sie für Aktionen, die spezifische Benutzereingaben erfordern.