Adornments
You can enhance the visual and functional aspects of the NumericTextBox component by using custom adornments in the form of prefixes and suffixes. Decorating the component allows you to make it more user-friendly and engaging.
Prefix Adornments
The NumericTextBox allows you to add custom items as prefix adornments by using the KendoPrefixTemplate
directive.
Suffix Adornments
The NumericTextBox allows you to add custom items as suffix adornments by using the KendoSuffixTemplate
directive.
Separator
To visually separate the specified adornments, set the showSeparator
property of the KendoPrefixTemplate
and KendoSuffixTemplate
directives to true
.
To separate multiple adornment items, you can add a Separator
component.
Disabling Adornments
By default, both the prefix and suffix adornments are treated as a constituent part of the NumericTextBox. When you set the disabled
property of the NumericTextBox to true
, you also automatically apply the disabled styling to the elements inside the adornments. This ensures that the adornments visually align with the disabled state of the NumericTextBox. Specifically, the custom prefix and suffix elements will have their pointer-events
set to none
and their opacity
adjusted to match the disabled appearance of the component.
To override the default behavior and ensure that the adornments are interactive, please check out the Enabling Adornments in a Disabled Inputs Component Knowledge Base article.
The following example demonstrates how to visually disable the NumericTextBox adornments by setting the disabled
property of the component.
Programmatically Disabling Adornments
The KendoPrefixTemplate
and KendoSuffixTemplate
directives grant you full control over the elements that will be displayed as adornments for the NumericTextBox. This means that you can programmatically control the disabled state based on the specific element that you are rendering.
The following example demonstrates how to set the disabled
property of the adornments when you disable the NumericTextBox.
Integration with FloatingLabel
To use the FloatingLabel
component with a KendoPrefixTemplate
, utilize its labelCssClass
or labelCssStyle
properties.
The following example demonstrates how to offset the FloatingLabel
when using adornments.