Path: blob/main/examples/reference/widgets/LiteralInput.ipynb
3172 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_evaland 'json' usesjson.loadsandjson.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: