Email input allow users to enter a valid email address.

Basic Example

The following example demonstrate some of the available functionality for read_email

What is your email?

Function signature

def (label: str, **kwargs):

Positional parameters

label (str)
The label to display to the user

Keyword Arguments

initial_value (str)
The initial value to display to the user. Defaults to "".
placeholder (str)
The placeholder text to display to the user. Defaults to "Your email here".
invalid_email_message (str)
Invalid e-mail message
disabled (bool)
whether the input is disabled. Defaults to False.
required (Union[bool, str])
Whether the input is required or not eg. "this field is required". Defaults to True.
hint (str)
A tooltip displayed to the user. Defaults to None.
end_program (bool)
Whether the program should end after the widget is shown. Defaults to False.
full_width (bool)
Whether the input should use full screen width. Defaults to False.
button_text (str)
What text to display on the button when the widget is not part of a Page. Defaults to 'Next'.

Returns

(str)The value entered by the user