Path: blob/main/examples/reference/widgets/LiteralInput.ipynb
2011 views
The LiteralInput
widget allows entering any Python literal using a text entry box whose contents are then parsed in Python. The widget only supports Python literal types. Optionally a type
may be declared to validate the literal before updating the parameter.
Discover more on using widgets to add interactivity to your applications in the how-to guides on interactivity. Alternatively, learn how to set up callbacks and (JS-)links between parameters or how to use them as part of declarative UIs with Param.
Parameters:
For details on other options for customizing the component see the layout and styling how-to guides.
Core
serializer
(str['ast', 'json]): The serialization (and deserialization) method to use. 'ast' usesast.literal_eval
and 'json' usesjson.loads
andjson.dumps
.type
(type or tuple(type)): A Python literal type (e.g. list, dict, set, int, float, bool, str)value
: Parsed value of the indicated type
Display
disabled
(boolean): Whether the widget is editablename
(str): The title of the widgetplaceholder
(str): A placeholder string displayed when no value is entered
LiteralInput.value
returns a value of the evaluated type that can be read out and set like other widgets:
Controls
The LiteralInput
widget exposes a number of options which can be changed from both Python and Javascript. Try out the effect of these parameters interactively: