import panel as pn
pn.extension()
The TextAreaInput
allows entering any multiline string using a text input box. Lines are joined with the newline character \n
.
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.
For details on other options for customizing the component see the layout and styling how-to guides.
value
(str): The current value updated when the widget loses focus because the user clicks away or presses the tab key.value_input
(str): The current value updated on every key press.auto_grow
(boolean, default=False): Whether the TextArea should automatically grow in height to fit the content.cols
(int, default=2): The number of columns in the text input field.disabled
(boolean, default=False): Whether the widget is editablemax_length
(int, default=5000): Max character length of the input field. Defaults to 5000max_rows
(int, default=None): The maximum number of rows in the text input field when auto_grow=True
.name
(str): The title of the widgetplaceholder
(str): A placeholder string displayed when no value is enteredrows
(int, default=2): The number of rows in the text input field.resizable
(boolean | str, default='both'): Whether the layout is interactively resizable, and if so in which dimensions: width
, height
, or both
.text_area_input = pn.widgets.TextAreaInput(name='Text Area Input', placeholder='Enter a string here...')
text_area_input
TextAreaInput.value
returns a string type that can be read out and set like other widgets:
text_area_input.value
An auto-growing TextAreaInput
will grow (and shrink) in height to accommodate the entered text. Setting rows
together with auto_grow
will set a lower bound on the number of rows and setting max_rows
will provide an upper bound:
pn.widgets.TextAreaInput(name='Growing TextArea', auto_grow=True, max_rows=10, rows=6, value="""\
This text area will grow when newlines are added to the text:
1. Foo
2. Bar
3. Baz
""", width=500)
If you only want the text area to be resizable in the vertical direction, you can set the resizeable parameter to 'height':
pn.widgets.TextAreaInput(name="Vertical Adjustable TextArea", resizable="height")
The TextAreaInput
widget exposes a number of options which can be changed from both Python and Javascript. Try out the effect of these parameters interactively:
pn.Row(text_area_input.controls(jslink=True), text_area_input)