276 lines
9.6 KiB
Python
276 lines
9.6 KiB
Python
# AUTO GENERATED FILE - DO NOT EDIT
|
|
|
|
import typing # noqa: F401
|
|
from typing_extensions import TypedDict, NotRequired, Literal # noqa: F401
|
|
from dash.development.base_component import Component, _explicitize_args
|
|
|
|
ComponentType = typing.Union[
|
|
str,
|
|
int,
|
|
float,
|
|
Component,
|
|
None,
|
|
typing.Sequence[typing.Union[str, int, float, Component, None]],
|
|
]
|
|
|
|
NumberType = typing.Union[
|
|
typing.SupportsFloat, typing.SupportsInt, typing.SupportsComplex
|
|
]
|
|
|
|
|
|
class Textarea(Component):
|
|
"""A Textarea component.
|
|
A basic HTML textarea for entering multiline text.
|
|
|
|
Keyword arguments:
|
|
|
|
- id (string; optional):
|
|
The ID of this component, used to identify dash components in
|
|
callbacks. The ID needs to be unique across all of the components
|
|
in an app.
|
|
|
|
- accessKey (string; optional):
|
|
Defines a keyboard shortcut to activate or add focus to the
|
|
element.
|
|
|
|
- autoFocus (string; optional):
|
|
The element should be automatically focused after the page loaded.
|
|
|
|
- className (string; optional):
|
|
Often used with CSS to style elements with common properties.
|
|
|
|
- cols (string | number; optional):
|
|
Defines the number of columns in a textarea.
|
|
|
|
- contentEditable (string | boolean; optional):
|
|
Indicates whether the element's content is editable.
|
|
|
|
- contextMenu (string; optional):
|
|
Defines the ID of a <menu> element which will serve as the
|
|
element's context menu.
|
|
|
|
- dir (string; optional):
|
|
Defines the text direction. Allowed values are ltr (Left-To-Right)
|
|
or rtl (Right-To-Left).
|
|
|
|
- disabled (string | boolean; optional):
|
|
Indicates whether the user can interact with the element.
|
|
|
|
- draggable (a value equal to: 'true', 'false' | boolean; optional):
|
|
Defines whether the element can be dragged.
|
|
|
|
- form (string; optional):
|
|
Indicates the form that is the owner of the element.
|
|
|
|
- hidden (string; optional):
|
|
Prevents rendering of given element, while keeping child elements,
|
|
e.g. script elements, active.
|
|
|
|
- lang (string; optional):
|
|
Defines the language used in the element.
|
|
|
|
- maxLength (string | number; optional):
|
|
Defines the maximum number of characters allowed in the element.
|
|
|
|
- minLength (string | number; optional):
|
|
Defines the minimum number of characters allowed in the element.
|
|
|
|
- n_blur (number; default 0):
|
|
Number of times the textarea lost focus.
|
|
|
|
- n_blur_timestamp (number; default -1):
|
|
Last time the textarea lost focus.
|
|
|
|
- n_clicks (number; optional):
|
|
Number of times the textarea has been clicked.
|
|
|
|
- n_clicks_timestamp (number; default -1):
|
|
Last time the textarea was clicked.
|
|
|
|
- name (string; optional):
|
|
Name of the element. For example used by the server to identify
|
|
the fields in form submits.
|
|
|
|
- persisted_props (list of a value equal to: 'value's; optional):
|
|
Properties whose user interactions will persist after refreshing
|
|
the component or the page. Since only `value` is allowed this prop
|
|
can normally be ignored.
|
|
|
|
- persistence (boolean | string | number; optional):
|
|
Used to allow user interactions in this component to be persisted
|
|
when the component - or the page - is refreshed. If `persisted` is
|
|
truthy and hasn't changed from its previous value, a `value` that
|
|
the user has changed while using the app will keep that change, as
|
|
long as the new `value` also matches what was given originally.
|
|
Used in conjunction with `persistence_type`.
|
|
|
|
- persistence_type (a value equal to: 'local', 'session', 'memory'; optional):
|
|
Where persisted user changes will be stored: memory: only kept in
|
|
memory, reset on page refresh. local: window.localStorage, data is
|
|
kept after the browser quit. session: window.sessionStorage, data
|
|
is cleared once the browser quit.
|
|
|
|
- placeholder (string; optional):
|
|
Provides a hint to the user of what can be entered in the field.
|
|
|
|
- readOnly (boolean | a value equal to: 'readOnly', 'readonly', 'READONLY'; optional):
|
|
Indicates whether the element can be edited. readOnly is an HTML
|
|
boolean attribute - it is enabled by a boolean or 'readOnly'.
|
|
Alternative capitalizations `readonly` & `READONLY` are also
|
|
acccepted.
|
|
|
|
- required (a value equal to: 'required', 'REQUIRED' | boolean; optional):
|
|
Indicates whether this element is required to fill out or not.
|
|
required is an HTML boolean attribute - it is enabled by a boolean
|
|
or 'required'. Alternative capitalizations `REQUIRED` are also
|
|
acccepted.
|
|
|
|
- rows (string | number; optional):
|
|
Defines the number of rows in a text area.
|
|
|
|
- spellCheck (a value equal to: 'true', 'false' | boolean; optional):
|
|
Indicates whether spell checking is allowed for the element.
|
|
|
|
- tabIndex (string | number; optional):
|
|
Overrides the browser's default tab order and follows the one
|
|
specified instead.
|
|
|
|
- title (string; optional):
|
|
Text to be displayed in a tooltip when hovering over the element.
|
|
|
|
- value (string; optional):
|
|
The value of the textarea.
|
|
|
|
- wrap (string; optional):
|
|
Indicates whether the text should be wrapped."""
|
|
|
|
_children_props = []
|
|
_base_nodes = ["children"]
|
|
_namespace = "dash_core_components"
|
|
_type = "Textarea"
|
|
|
|
def __init__(
|
|
self,
|
|
id: typing.Optional[typing.Union[str, dict]] = None,
|
|
value: typing.Optional[str] = None,
|
|
autoFocus: typing.Optional[str] = None,
|
|
cols: typing.Optional[typing.Union[str, NumberType]] = None,
|
|
disabled: typing.Optional[typing.Union[str, bool]] = None,
|
|
form: typing.Optional[str] = None,
|
|
maxLength: typing.Optional[typing.Union[str, NumberType]] = None,
|
|
minLength: typing.Optional[typing.Union[str, NumberType]] = None,
|
|
name: typing.Optional[str] = None,
|
|
placeholder: typing.Optional[str] = None,
|
|
readOnly: typing.Optional[
|
|
typing.Union[bool, Literal["readOnly", "readonly", "READONLY"]]
|
|
] = None,
|
|
required: typing.Optional[
|
|
typing.Union[Literal["required", "REQUIRED"], bool]
|
|
] = None,
|
|
rows: typing.Optional[typing.Union[str, NumberType]] = None,
|
|
wrap: typing.Optional[str] = None,
|
|
accessKey: typing.Optional[str] = None,
|
|
className: typing.Optional[str] = None,
|
|
contentEditable: typing.Optional[typing.Union[str, bool]] = None,
|
|
contextMenu: typing.Optional[str] = None,
|
|
dir: typing.Optional[str] = None,
|
|
draggable: typing.Optional[typing.Union[Literal["true", "false"], bool]] = None,
|
|
hidden: typing.Optional[str] = None,
|
|
lang: typing.Optional[str] = None,
|
|
spellCheck: typing.Optional[
|
|
typing.Union[Literal["true", "false"], bool]
|
|
] = None,
|
|
style: typing.Optional[typing.Any] = None,
|
|
tabIndex: typing.Optional[typing.Union[str, NumberType]] = None,
|
|
title: typing.Optional[str] = None,
|
|
n_blur: typing.Optional[NumberType] = None,
|
|
n_blur_timestamp: typing.Optional[NumberType] = None,
|
|
n_clicks: typing.Optional[NumberType] = None,
|
|
n_clicks_timestamp: typing.Optional[NumberType] = None,
|
|
persistence: typing.Optional[typing.Union[bool, str, NumberType]] = None,
|
|
persisted_props: typing.Optional[typing.Sequence[Literal["value"]]] = None,
|
|
persistence_type: typing.Optional[Literal["local", "session", "memory"]] = None,
|
|
**kwargs
|
|
):
|
|
self._prop_names = [
|
|
"id",
|
|
"accessKey",
|
|
"autoFocus",
|
|
"className",
|
|
"cols",
|
|
"contentEditable",
|
|
"contextMenu",
|
|
"dir",
|
|
"disabled",
|
|
"draggable",
|
|
"form",
|
|
"hidden",
|
|
"lang",
|
|
"maxLength",
|
|
"minLength",
|
|
"n_blur",
|
|
"n_blur_timestamp",
|
|
"n_clicks",
|
|
"n_clicks_timestamp",
|
|
"name",
|
|
"persisted_props",
|
|
"persistence",
|
|
"persistence_type",
|
|
"placeholder",
|
|
"readOnly",
|
|
"required",
|
|
"rows",
|
|
"spellCheck",
|
|
"style",
|
|
"tabIndex",
|
|
"title",
|
|
"value",
|
|
"wrap",
|
|
]
|
|
self._valid_wildcard_attributes = []
|
|
self.available_properties = [
|
|
"id",
|
|
"accessKey",
|
|
"autoFocus",
|
|
"className",
|
|
"cols",
|
|
"contentEditable",
|
|
"contextMenu",
|
|
"dir",
|
|
"disabled",
|
|
"draggable",
|
|
"form",
|
|
"hidden",
|
|
"lang",
|
|
"maxLength",
|
|
"minLength",
|
|
"n_blur",
|
|
"n_blur_timestamp",
|
|
"n_clicks",
|
|
"n_clicks_timestamp",
|
|
"name",
|
|
"persisted_props",
|
|
"persistence",
|
|
"persistence_type",
|
|
"placeholder",
|
|
"readOnly",
|
|
"required",
|
|
"rows",
|
|
"spellCheck",
|
|
"style",
|
|
"tabIndex",
|
|
"title",
|
|
"value",
|
|
"wrap",
|
|
]
|
|
self.available_wildcard_properties = []
|
|
_explicit_args = kwargs.pop("_explicit_args")
|
|
_locals = locals()
|
|
_locals.update(kwargs) # For wildcard attrs and excess named props
|
|
args = {k: _locals[k] for k in _explicit_args}
|
|
|
|
super(Textarea, self).__init__(**args)
|
|
|
|
|
|
setattr(Textarea, "__init__", _explicitize_args(Textarea.__init__))
|