login
A control that lets users enter their username and password.
If your application needs to authenticate the end user, you can use the login
control that
provides the username/password input fields pair, ready to use.
This control stands on its own on an authentication page, and the application should navigate to another page when the user has entered his user and password information (or canceled the input).
Properties¶
Name | Type | Default | Description |
---|---|---|---|
(★) |
str |
"Log in" | The title of the login dialog. |
on_action |
Union[str, Callable] |
A function or the name of a function that is triggered when the dialog button is pressed.
When the button is pressed, and if this property is not set, Taipy will try to find a callback function called on_login() and invoke it with the parameters listed above. |
|
message |
str dynamic |
The message shown in the dialog. |
|
id |
str |
The identifier that is assigned to the rendered HTML component. |
|
properties |
dict[str, Any] |
Bound to a dictionary that contains additional properties for this element. |
|
class_name |
str dynamic |
The list of CSS class names that are associated with the generated HTML Element. |
|
hover_text |
str dynamic |
The information that is displayed when the user hovers over this element. |
(★)title
is the default property for this visual element.
Details¶
If the user presses the 'Close' button (the cross at the top-right corner of the control), the
on_action
callback is invoked with the two first elements of the array payload.args
(representing the input username and password) set to None.
This is how the application can know whether the user tried to provide the username and password
or if the authentication was canceled.
Using the Taipy Enterprise edition
If your application uses the Enterprise edition of Taipy, you can invoke the function
taipy.enterprise.gui.login()
with the appropriate field to authenticate your session.
Usage¶
Typical use¶
You create a login
control in a page to check for the user's credentials and navigate to the
appropriate page afterward.
The control definition can be as simple as:
Definition
<|Welcome to Taipy!|login|>
<taipy:login>Welcome to Taipy!</taipy:login>
import taipy.gui.builder as tgb
...
tgb.login("Welcome to Taipy!")
With this control, the page will look like this:
You may improve on the following simple code to implement what to do when users interact with this control:
def on_login(state: State, id, login_args):
username, password = login_args["args"][:2]
if username is None: # The user canceled the login request
return navigate(s, "anonymous")
# Check whether the username/password is a valid pair
# Using Taipy Enterprise edition, you could use:
# credentials = taipy.enterprise.gui.login(state, username, password)
...
# # Store the username in the state
state.username = username
navigate(s, "authenticated")
If the user closes the control, the application opens the anonymous page.
Otherwise, the authenticated page opens, and the state has stored the username.
Styling¶
All the login controls are generated with the "taipy-login" CSS class. You can use this class name to select the login controls and apply style.