Package com.oorian.html.elements

Class TelephoneInput<T extends TelephoneInput<T>>

java.lang.Object
com.oorian.html.Element<T>
com.oorian.html.VisualElement<T>
com.oorian.html.StyledElement<T>
com.oorian.html.elements.InputElement<T>
com.oorian.html.elements.Input<T>
com.oorian.html.elements.TelephoneInput<T>
public class TelephoneInput<T extends TelephoneInput<T>> extends Input<T>
Represents an HTML5 <input type="tel"> element for entering telephone numbers.

The TelephoneInput provides a text field optimized for telephone number entry. Mobile devices typically display a numeric keypad when this input type is focused. Note that browsers do not enforce any specific format validation by default.

Usage Example:


 TelephoneInput phone = new TelephoneInput("phone", "+1-555-123-4567");
 phone.setPattern("[0-9]{3}-[0-9]{3}-[0-9]{4}");
 form.addElement(phone);
Since:
HTML5
Author:
Marvin P. Warble Jr.
See Also:

  • Constructor Details

    • TelephoneInput

      public TelephoneInput()
      Creates a new TelephoneInput with no name or initial value.

    • TelephoneInput

      public TelephoneInput(String name)
      Creates a new TelephoneInput with the specified name.
      Parameters:
      name - The name attribute for the input element, used for form submission.

    • TelephoneInput

      public TelephoneInput(String name, String value)
      Creates a new TelephoneInput with the specified name and initial phone number value.
      Parameters:
      name - The name attribute for the input element, used for form submission.
      value - The initial telephone number value.

  • Method Details

    • setIgnoreValueNonchanges

      public final T setIgnoreValueNonchanges(boolean ignoreValueNonchanges)
      Sets whether to ignore input completion events when the value hasn't changed.

      When true (the default), InputCompleteEvent is only sent when the value actually changed during the focus session. When false, the event is sent on every blur regardless of whether the value changed.

      Parameters:
      ignoreValueNonchanges - true to suppress events when value unchanged, false to fire events on every blur.
      Returns:
      this element for method chaining

    • setText

      public final void setText(String text)
      Sets the text content of the input.
      Overrides:
      setText in class Element<T extends com.oorian.html.elements.BaseTextInput<T>>
      Parameters:
      text - The text to set as the input value.

    • selectText

      public final void selectText()
      Programmatically selects all text in the input field.

      Sends a command to the client to select the text content.

    • setSelectTextOnFocus

      public final void setSelectTextOnFocus()
      Configures the input to automatically select all text when clicked.

    • focusAndSelect

      public final void focusAndSelect()
      Sets focus to the input and selects all text.

      Combines focus and text selection into a single operation.

    • focusAndSetValue

      public final void focusAndSetValue(String value)
      Sets focus to the input and sets its value.

      Combines focus and value assignment into a single operation.

      Parameters:
      value - The value to set.

    • getText

      public final String getText()
      Returns the text content of the input.
      Returns:
      The current text value, or an empty string if no text.

    • getCleanText

      public final String getCleanText()
      Returns the trimmed text content of the input.
      Returns:
      The current text value with leading and trailing whitespace removed.

    • hasText

      public final boolean hasText()
      Checks whether the input contains non-empty text.
      Returns:
      true if the input contains non-whitespace text, false otherwise.

    • inputComplete

      public final void inputComplete()
      Called when input is completed in the text field.

      Dispatches an InputCompleteEvent and calls the BaseTextInput.onInputComplete() hook.

    • setTabOnKeyPressed

      public final T setTabOnKeyPressed(String keycode)
      Sets a key that will trigger tab behavior when pressed.
      Parameters:
      keycode - The key code as a string.
      Returns:
      this element for method chaining

    • setTabOnKeyPressed

      public final T setTabOnKeyPressed(int keycode)
      Sets a key that will trigger tab behavior when pressed.
      Parameters:
      keycode - The key code as an integer.
      Returns:
      this element for method chaining

    • setChangeOnEnter

      public final T setChangeOnEnter()
      Enables input completion on Enter key press.
      Returns:
      this element for method chaining

    • onInputComplete

      protected void onInputComplete()
      Hook method called when input is completed.

      Override this method to handle input completion events.