API компонента Aria
Полное описание API компонента Aria, включая пропсы, события, слоты и публичные методы/состояния.
Пропсы
Компонент Aria принимает следующие пропсы:
| Пропс | По умолчанию | Тип | Описание |
|---|---|---|---|
placeholder | "" | string или undefined | Текст-подсказка в поле ввода |
autocomplete | "on" | "on" или "off" или undefined | Поведение автозаполнения поля ввода |
wrap | "soft" | "soft" или "hard" или "off" или undefined | Поведение переноса текста |
rows | 3 | number или undefined | Количество видимых строк (для textarea) |
maxLength | 9999 | number или undefined | Максимальная длина вводимого значения |
classInput | "" | StyleClass или undefined | Пользовательский CSS-класс для элемента ввода |
id | undefined | string или undefined | Уникальный идентификатор элемента ввода |
modelValue | undefined | string или number или null или undefined | Текущее значение поля ввода |
События
Компонент Aria генерирует следующие события:
| Событие | Данные | Описание |
|---|---|---|
focus | FocusEvent | Генерируется при получении фокуса полем ввода |
blur | FocusEvent | Генерируется при потере фокуса полем ввода |
update:modelValue | string | Генерируется при обновлении значения modelValue |
change:modelValue | string | Генерируется при изменении значения modelValue |
update:isInvalid | boolean | Генерируется при изменении состояния валидации |
Слоты
Компонент Aria предоставляет следующие слоты:
| Слот | Данные | Описание |
|---|---|---|
default | VNode[] | Основной слот для пользовательского контента |
before | VNode[] | Слот для контента перед полем ввода |
after | VNode[] | Слот для контента после поля ввода |
Публичные методы
Компонент Aria предоставляет следующие методы и состояния через ref:
| Метод/Состояние | Значение | Описание |
|---|---|---|
layout | InputLayoutExpose или undefined | Состояние разметки поля ввода |
inputRef | HTMLElement или undefined | Ссылка на DOM-элемент поля ввода |
id | AriaProps["id"] | Текущий идентификатор поля |
modelValue | AriaProps["modelValue"] | Текущее значение поля |
placeholder | AriaProps["placeholder"] | Текущий текст-подсказка |
autocomplete | AriaProps["autocomplete"] | Текущие настройки автозаполнения |
wrap | AriaProps["wrap"] | Текущее поведение переноса текста |
rows | AriaProps["rows"] | Текущее количество строк |
maxLength | AriaProps["maxLength"] | Текущее ограничение длины ввода |
isValue | InputLayoutProps["isValue"] | Имеет ли поле значение |
mode | AriaProps["mode"] | Текущий режим отображения |
isDisabled | AriaProps["disabled"] | Отключено ли поле |
isLoading | AriaProps["loading"] | В состоянии загрузки |
isInvalid | AriaProps["isInvalid"] | Невалидное состояние |
messageInvalid | AriaProps["messageInvalid"] | Сообщение об ошибке валидации |
classStyle | AriaProps["class"] | CSS-класс контейнера |
Методы:
clear(): void- Очищает значение поля и сбрасывает состояние валидацииfocus(env: FocusEvent): void- Устанавливает фокус на поле вводаblur(env: FocusEvent): void- Снимает фокус с поля ввода