ValidatableControlShell (Blazor)
Эта страница не завершена
Приносим свои извинения, но данная страница ещё не завершена.
Такие элементы ввода, как однострочное текстовое поле (ValidatableControlShell(type="text")), многострочное текстовое ввода (textarea), выпадающие список (select) и так далее обычно употребляются не по одиночке, в окружении вспомогательных элементов:
- Заголовочная надпись (обычно элемент
label) - Комментарий (например, «тире и скобки можно необязательны» для поля ввода номера телефона)
- Метки «обязательное» или «необязательное»
- Сообщения валидации
Согласно одному из принципов качественного дизайна, все эти элементы окружения должны быть выполнены в едином стиле, потому появляется потребность в шаблонном компоненте, содержимое которого будет окружать элемент ввода. В YDF таким компонентом является ValidatableControlShell — в дословном переводе: «оболочка валидируемого компонента». Как следует из названия, данный компонент не является самостоятельным, а должен входить в состав других компонентов, а точнее быть для них оболочкой.
- Сам
ValidatableControlShellне является валидируемым компонентом, поскольку он лишь отображает переданные ему сообщения валидации, но при этом сам ничего не валидирует, так как валидация — задача основного компонента, которыйValidatableControlShellокружает. - При выборе названия избегалось слово «обёртка» («wrapper»), так как оно гораздо более многозначное, чем «оболочка». Так, по отношению к компонентам пользовательского интерфейса «обёртка» может означать не только буквальное обёртывание основного компонента с обеих сторон своими элементами, но и расширение функциональности основного компонента.
Краткий обзор
- Класс компонента
ValidatableControlShell- Stylus-примесь для генерации стилей
generateValidatableControlShellYDF_GUI_ComponentStyles- Готовые темы
ValidatableControlShell.StandardThemes.regular- Базовая (по умолчанию)
- Готовые геометрические вариации
ValidatableControlShell.StandardGeometricVariations.regular- Базовая (по умолчанию)
ValidatableControlShell.StandardGeometricVariations.small- Компактная
- Готовые декоративные вариации
ValidatableControlShell.StandardDecorativeVariations.regular- Базовая (по умолчанию)
- Loading placeholder
- Недоступен
Класс ValidatableControlShellClass
Параметры Razor-компонента
ValidatableControlShell.Properties
{
- label
- Русскоязычное наименование
- Заголовочная надпись
- Тип
- string
- Обязательное
- Нет
- Минимум символов
- 1
- guidance
- Русскоязычное наименование
- Комментарий
- Тип
- string
- Обязательное
- Нет
- Минимум символов
- 1
- required
- Русскоязычное наименование
- Является ли ввод обязательным
- Тип
- boolean
- Значение по умолчанию
- false
- mustDisplayAppropriateBadgeIfInputIsRequired
- Русскоязычное наименование
- Нужно ли отображать надпись «обязательное» когда ввод обязателен
- Тип
- boolean
- Значение по умолчанию
- false
- mustDisplayAppropriateBadgeIfInputIsOptional
- Русскоязычное наименование
- Нужно ли отображать надпись «необязательное» когда ввод необязателен
- Тип
- boolean
- Значение по умолчанию
- false
- mustAddInvisibleBadgeForHeightEqualizingWhenNoBadge
- Русскоязычное наименование
- Нужно ли добавлять невидимый значок для выравнивание высоты
- Тип
- boolean
- Значение по умолчанию
- false
- coreElementHTML_ID
- Русскоязычное наименование
- HTML-идентификатор элемента-ядра
- Тип
- string
- Обязательное
- Нет
- Минимум символов
- 1
- labelElementHTML_ID
- Русскоязычное наименование
- HTML-идентификатор заголовочной надписи
- Тип
- string
- Обязательное
- Нет
- Минимум символов
- 1
- mainSlotWrapperAdditionalCSS_Classes
- Русскоязычное наименование
- CSS-классы основного слота
- Тип
- индексный массив
- Значение по умолчанию
- []
- Запрещены ли элементы типа undefined
- Да
- Запрещены ли элементы типа null
- Да
- Элементы массива
- Тип
- string
- Минимум символов
- 1
- theme
- Русскоязычное наименование
- Тема
- Тип
- string
- Значение по умолчанию
- ValidatableControlShell.StandardThemes.regular
- Допустимые варианты
- ValidatableControlShell.StandardThemes.regular
- (Любые, определённые через `ValidatableControlShell.defineCustomThemes(CustomThemesEnumeration)`)
- areThemesCSS_ClassesCommon
- Русскоязычное наименование
- Являются ли CSS-классы тем общими для всех компонентов
- Тип
- boolean
- Значение по умолчанию
- false
- geometricVariation
- Русскоязычное наименование
- Геометрическая вариация
- Тип
- string
- Значение по умолчанию
- ValidatableControlShell.StandardGeometricVariations.regular
- Допустимые варианты
- ValidatableControlShell.StandardGeometricVariations.regular
- ValidatableControlShell.StandardGeometricVariations.small
- (Любые, определённые через `ValidatableControlShell.defineCustomGeometricVariations(CustomGeometricVariationsNamesEnumeration)`)
- decorativeVariation
- Русскоязычное наименование
- Декоративная вариация
- Тип
- string
- Значение по умолчанию
- ValidatableControlShell.StandardDecorativeVariations.regular
- Допустимые варианты
- ValidatableControlShell.StandardDecorativeVariations.regular
- (Любые, определённые через `ValidatableControlShell.defineCustomDecorativeVariations(CustomDecorativeVariationsEnumeration)`)
- rootElementModifierCSS_Class
- Русскоязычное наименование
- CSS-класс-модификатор коревого элемента
- Тип
- string
- Обязательное
- Нет
- rootElementModifierCSS_Classes
- Русскоязычное наименование
- Массив CSS-классов-модификаторов коревого элемента
- Тип
- индексный массив
- Обязательное
- Нет
- Элементы массива
- Тип
- string
- rootElementSpaceSeparatedModifierCSS_Classes
- Русскоязычное наименование
- Разделённые пробелом CSS-классы-модификаторы коревого элемента
- Тип
- string
- Обязательное
- Нет