Enhance EmailField control with additional functionalities

Expanded the EmailField JavaDoc to include new features such as automatic email domain suffix suggestions, format validation, and customizable properties for UI elements. These improvements aim to boost user experience and maintain input validity.

gemsfx-demo/src/main/java/com/dlsc/gemsfx/demo/EmailFieldApp.java

@@ -27,6 +27,7 @@ public void start(Stage stage) {
         CheckBox required = new CheckBox("Required");
         required.selectedProperty().bindBidirectional(view.requiredProperty());
 
+        // When user types '@' in the email field, show a list of suggestions
         CheckBox autoCompletion = new CheckBox("Auto-Complete Email Suffixes");
         autoCompletion.selectedProperty().bindBidirectional(view.autoSuffixEnabledProperty());
 

gemsfx/src/main/java/com/dlsc/gemsfx/EmailField.java

@@ -34,8 +34,13 @@
 import java.util.Objects;
 
 /**
- * A specialized control for entering an email address. The control validates
- * the entered text whenever the text property changes.
+ * EmailField is a custom control for inputting and validating email addresses.
+ * It extends the base Control class and provides additional functionalities:
+ * <p>
+ * 1. Automatic email domain suffix suggestions to enhance user experience. <br>
+ * 2. Email address format validation to ensure input validity. <br>
+ * 3. Customizable properties to control the visibility of user interface elements,
+ *    such as mail and validation icons, according to specific user interface requirements.
  */
 public class EmailField extends Control {