documentation indexreference manualfunction index

ui.input

Function: ui.input (default, length=None, allow=None, exclude='{}', **properties):

This displays a text area that accepts input from the user. Only ASCII is input reliably, although some non-ASCII languages may also work on some platforms.

default - The default value for the text area.

length - If not None, a limit on the number of characters that can be input.

allow - If not None, a string containing the characters that are allowed.

exclude - A string containing characters that are no allowed. The brace characters should always be disallowed, since they may accidentally cause a text tag to be shown.

The name is returned as the result of ui.interact() when enter is pressed.

label prompt_for_name:
    $ ui.text("Please enter your name:", xalign=0.5, yalign=0.4)
    $ ui.input('', xalign=0.5, yaling=0.5)
    $ name = ui.interact()
    if name == '':
        $ name = 'Guy Shy'