35 lines
1.7 KiB
Python
35 lines
1.7 KiB
Python
from typing import Callable, Optional, Union
|
|
|
|
from ..events import Handler, ValueChangeEventArguments
|
|
from .input import Input
|
|
|
|
|
|
class Textarea(Input, component='input.js'):
|
|
|
|
def __init__(self,
|
|
label: Optional[str] = None, *,
|
|
placeholder: Optional[str] = None,
|
|
value: str = '',
|
|
on_change: Optional[Handler[ValueChangeEventArguments]] = None,
|
|
validation: Optional[Union[Callable[..., Optional[str]], dict[str, Callable[..., bool]]]] = None,
|
|
) -> None:
|
|
"""Textarea
|
|
|
|
This element is based on Quasar's `QInput <https://quasar.dev/vue-components/input>`_ component.
|
|
The ``type`` is set to ``textarea`` to create a multi-line text input.
|
|
|
|
You can use the `validation` parameter to define a dictionary of validation rules,
|
|
e.g. ``{'Too long!': lambda value: len(value) < 3}``.
|
|
The key of the first rule that fails will be displayed as an error message.
|
|
Alternatively, you can pass a callable that returns an optional error message.
|
|
To disable the automatic validation on every value change, you can use the `without_auto_validation` method.
|
|
|
|
:param label: displayed name for the textarea
|
|
:param placeholder: text to show if no value is entered
|
|
:param value: the initial value of the field
|
|
:param on_change: callback to execute when the value changes
|
|
:param validation: dictionary of validation rules or a callable that returns an optional error message (default: None for no validation)
|
|
"""
|
|
super().__init__(label, placeholder=placeholder, value=value, on_change=on_change, validation=validation)
|
|
self._props['type'] = 'textarea'
|