Rendering Changes in 9.0.0
The Kendo UI for Vue 9.0.0 release introduces changes in the rendering of several components, mostly new default icons. If your application overrides the built-in CSS rules, queries the generated markup, for example in tests, or depends on the default icons, review the following changes.
The default icons are rendered as font icons (k-i-<name>) or SVG icons (k-svg-i-<name>). Update only the selectors that target the components listed below, because classes such as k-i-caret-alt-left can also belong to other components.
Buttons
-
SpeechToTextButton—The default icon is nowmicrophoneinstead ofmicrophoneOutline. While listening, the button uses thestopicon instead ofstopSm. -
SplitButton—The arrow uses thechevron-downicon (font icon namechevron-down, SVG iconchevronDownIcon) instead ofcaret-alt-downand has thek-split-button-arrowclass. -
ToolbarScrollButton—The scroll buttons render fewer classes and use new default icons.- Before: The buttons render
k-button k-icon-button k-button-md k-button-solid k-button-solid-base k-rounded-mdandk-toolbar-prevork-toolbar-next, plusk-disabledwhile disabled. The default icons arecaret-alt-leftandcaret-alt-right. - After: The buttons render only
k-button k-icon-buttonandk-toolbar-prevork-toolbar-next. Thek-button-md,k-button-solid,k-button-solid-base,k-rounded-md, and the conditionalk-disabledclasses are removed. The default icons arechevron-leftandchevron-right.
- Before: The buttons render
Conversational UI
AIPrompt—The rate buttons of the output view use thethumb-upandthumb-downicons instead ofthumb-up-outlineandthumb-down-outline.AIPrompt—The stop floating action button uses thestopicon instead ofstop-sm.PromptBox—The action button uses thearrow-upicon instead ofarrow-up-outline, and thestopicon instead ofstop-smwhile loading.PromptBox—The action button gets thek-generatingandk-activeclasses while loading. Before, it got only thek-generatingclass.PromptBox—The action button rendersaria-disabled="true"only when it is disabled. Before, it always renderedaria-disabled, with the value"false"when enabled.PromptBox—The upload button uses thepaperclipicon instead ofpaperclip-outline-alt-right.PromptBox—The remove button of an attached file uses thex-circleicon instead ofx-mark-sm-outline.PromptBox—The textarea getsaria-multiline="true"whenever the mode is not'single', including a collapsed'auto'mode. Before, it gotaria-multilineonly when the layout was multiline.
Data Tools
Pager—The first, previous, next, and last page buttons use thechevron-double-left,chevron-left,chevron-right, andchevron-double-righticons instead ofcaret-alt-to-left,caret-alt-left,caret-alt-right, andcaret-alt-to-right. The icons are mirrored in RTL as before. This also applies to the pager of the Grid and the TreeList.Pager—When theresponsiveproperty is set, the wrapper renders thek-pager-responsiveclass in addition tok-pagerand the size class.
Date Inputs
-
DateInput—The spinner buttons use thechevron-upandchevron-downicons instead ofcaret-alt-upandcaret-alt-down. -
DateInput—The input has no defaultrole="textbox", andaria-disabledis rendered only when the input is disabled. Before, the input renderedrole="textbox"by default andaria-disabled="false"when enabled. -
DateInput,DatePicker,DateRangePicker, andDateTimePicker—Thearia-controlsattribute of the input (the start and end inputs of theDateRangePicker) is rendered only while the popup is open. Before, it was always rendered with the popup id. -
DateTimePicker—The Date/Time switcher in the popup is now aSegmentedControlinstead of aButtonGroup.- Before: The
.k-datetime-buttongroupelement contains aButtonGroup(k-button-group) with two toggle buttons (k-button, withk-selectedon the active one, andaria-pressed). - After: The
.k-datetime-buttongroupelement contains a stretchedSegmentedControl(div.k-segmented-control.k-segmented-control-stretchedwithrole="group", ak-segmented-control-thumbelement, andk-segmented-control-buttonitems witharia-pressed). Thek-selectedclass marks the active item.
- Before: The
Dialogs
DialogandWindow—Thek-window-primary,k-window-dark, andk-window-lightclasses are no longer rendered on thek-windowelement, because thethemeColorproperty is removed. TheDialogrenderedk-window k-dialog k-window-<themeColor>, and theWindowrendered, for example,k-window k-window-dark. Use thedialogClass(Dialog) orwindowClass(Window) property to apply your own class.
Dropdowns
ComboBox,DropDownList, andDropDownTree—The toggle button uses thechevron-downicon instead ofcaret-alt-down.SearchBar—The input always renderstabindex, which defaults to0whentabIndexis not set. Before, it renderedtabindexonly whentabIndexwas set.
Grid
Grid—The group cell uses thechevron-downandchevron-righticons (chevron-leftin RTL) instead ofcaret-alt-downandcaret-alt-right(caret-alt-leftin RTL).Grid—The pin dropdown and the Pin row context menu items use thepin,pin-top,pin-bottom, andunpinicons instead ofpin-outline,pin-outline-top,pin-outline-bottom, andunpin-outline.Grid—The Reorder row context menu items use thechevron-down,chevron-up,chevron-down,chevron-double-up, andchevron-double-downicons instead ofcaret-alt-expand,caret-alt-up,caret-alt-down,caret-alt-to-top, andcaret-alt-to-bottom.Grid—The pager buttons use thechevron-left,chevron-right,chevron-double-left, andchevron-double-righticons instead ofcaret-alt-left,caret-alt-right,caret-alt-to-left, andcaret-alt-to-right.contextMenuItemsMap—TheiconandsvgIconvalues of the exported map change accordingly. For example,'pin-outline'becomes'pin', and'caret-alt-to-top'becomes'chevron-double-up'. Update the custom context menu items that depend on the previous icon names.
Indicators
BadgeandBadgeContainer—Thek-badge-darkandk-badge-lightclasses are removed together with the'dark'and'light'theme colors.BadgeContainer—ABadgeContainerwithoutthemeColorrendersk-badge-baseandk-badge-<fillMode>-baseinstead ofk-badge-primaryandk-badge-<fillMode>-primary.Loader—Thek-loader-info,k-loader-success,k-loader-warning,k-loader-error,k-loader-dark,k-loader-light, andk-loader-inverseclasses are removed, and thek-loader-baseclass is added.Loader—ALoaderwithoutthemeColorno longer rendersk-loader-primary.
Inputs
ColorInput—The expand icon ischevron-downinstead ofcaret-alt-expand.ColorPicker—The arrow uses thechevron-downicon instead ofcaret-alt-down.NumericTextBox—The spinner buttons use thechevron-upandchevron-downicons instead ofcaret-alt-upandcaret-alt-down.Rating—An unselected item uses thestaricon (k-i-starandk-svg-i-star) instead ofstar-outline. The selected items already usek-i-star, so adjust only the selectors that target the unselected items.Slider—The increase and decrease buttons use thechevron-up,chevron-down,chevron-left, andchevron-righticons instead ofcaret-alt-up,caret-alt-down,caret-alt-left, andcaret-alt-right.
Layout
-
AppBar—AnAppBarwithoutthemeColorrendersk-appbar-baseinstead ofk-appbar-light. Thek-appbar-light,k-appbar-dark, andk-appbar-inheritclasses are no longer rendered. -
Avatar—The color class changes fromk-avatar-<fillMode>-<themeColor>tok-avatar-<themeColor>. The class was rendered only when bothfillModeandthemeColorwere set. Now it is rendered wheneverthemeColoris set, and no color class is rendered when it is not. For example,<Avatar fillMode="solid" />no longer rendersk-avatar-solid-primary. -
BottomNavigation—ABottomNavigationwithoutthemeColorrendersk-bottom-nav-baseandk-bottom-nav-flat-baseinstead ofk-bottom-nav-primaryandk-bottom-nav-flat-primary. Thek-bottom-nav-info,k-bottom-nav-success,k-bottom-nav-warning,k-bottom-nav-error,k-bottom-nav-dark, andk-bottom-nav-lightclasses, together with theirk-bottom-nav-flat-<color>andk-bottom-nav-solid-<color>variants, are no longer rendered. -
Menu—The expand arrow uses thechevron-left,chevron-right,chevron-up, andchevron-downicons (k-i-chevron-*andk-svg-i-chevron-*) instead of thecaret-alt-*icons. -
PanelBar—The accessibility markup of the items changed.- Before: The items render
aria-hidden(truewhen collapsed),aria-disabled(also"false"), andaria-expanded(also"false"for items without content). - After: The items no longer render
aria-hidden. Thearia-disabledattribute is rendered only when the item is disabled. Thearia-expandedattribute is rendered only when the item has content or sub-items. A collapsed item that has content and no sub-items keeps a hiddendiv.k-panelbar-content(aria-hidden="true",display: none) in the DOM.
- Before: The items render
-
Splitter—The collapse buttons of theSplitterBaruse thechevron-left,chevron-right,chevron-up, andchevron-downicons (k-i-chevron-*andk-svg-i-chevron-*) instead of thecaret-alt-*icons. -
Stepper—A validStepuses thecheckSVG icon instead ofcheck-outline.
ListBox
-
ListBoxToolbar—The default tool icons changed from the caret icons to the chevron icons, in both the font and the SVG icon sets.- Before: The
moveUp,moveDown,transferTo,transferFrom,transferAllTo, andtransferAllFromtools usecaret-alt-up,caret-alt-down,caret-alt-right,caret-alt-left,caret-double-alt-right, andcaret-double-alt-left(classes such ask-i-caret-alt-upandk-svg-i-caret-alt-up). In RTL, the right and left icons are swapped within the caret set. - After: The same tools use
chevron-up,chevron-down,chevron-right,chevron-left,chevron-double-right, andchevron-double-left(classes such ask-i-chevron-upandk-svg-i-chevron-up). In RTL, the right and left icons are swapped within the chevron set. The remove tool still uses thexicon.
- Before: The
Notification
Notification—The success type renders thecheckicon (k-i-check,k-svg-i-check) instead ofcheck-outline, and the error type renders thexicon (k-i-x,k-svg-i-x) instead ofx-outline.
Popup
-
Popup—The Popup no longer renders its content through theSlidecomponent of@progress/kendo-vue-animation. It renders the animation container markup itself and applies thek-slide-<direction>-enterandk-slide-<direction>-exitclasses with CSS transitions.- Before: The markup is
<div id class="k-animation-container k-animation-container-relative [k-animation-container-shown]" style="z-index; position: absolute; top; left"><div class="{popupClass} k-popup k-child-animation-container" style="transition-delay: 0ms; transition-duration: <duration>ms">content</div></div>. Thek-popupelement and thek-child-animation-containerelement are the same element, and a closed Popup renders nothing. Opening applies thek-slide-<direction>-appearandk-slide-<direction>-appear-activeclasses. - After: The markup is
<div id class="k-animation-container k-animation-container-relative [k-animation-container-shown] {className}" style="z-index; position: absolute; top; left; pointer-events: auto|none"><div class="k-child-animation-container" style="transition-delay: 0ms; display: block"><div class="{popupClass} k-popup">content</div></div></div>. Thek-child-animation-containerelement is now a wrapper around thek-popupelement. Opening applies thek-slide-<direction>-enterandk-slide-<direction>-enter-activeclasses (theappearclasses are no longer used), and closing applies the exit classes. The inlinetransition-durationis set only while an animation runs, andk-animation-container-shownis added after the enter animation completes. - A closed Popup renders a hidden
<div id style="display: none" class="{className}">instead of nothing. Theidis also set on the hidden element that is rendered before the Popup mounts.
- Before: The markup is
Scheduler
-
SchedulerViewSelector—On desktop, the view selector is aSegmentedControlinstead of aButtonGroup. The collapsed (mobile) dropdown is unchanged.- Before: The selector renders the
k-button-group k-toolbar-button-group k-scheduler-viewsclasses and ak-toolbar-buttonbutton for each view. - After: The selector renders the
k-segmented-control k-scheduler-viewsclasses and ak-segmented-control-buttonfor each view, and the selected one is marked withk-selected. Thek-toolbar-button-groupclass is no longer applied.
- Before: The selector renders the
-
Scheduler—The previous and next navigation buttons, theAgendaViewhead and tail arrows, and theSchedulerItemcontinuation arrows use thechevron-leftandchevron-righticons instead ofcaret-alt-leftandcaret-alt-right(the mirrored pair in RTL). -
MonthView—The events no longer set the inlinetransform: translateY(30px). Their offset is computed from the.k-nav-dayelement of the slot.
The 9.0.0 changes cover the migration from 8.x. For the later changes of the Scheduler view selector and toolbar, see Rendering Changes in 10.0.0.
TreeList
TreeList—The icon inside thek-treelist-toggleelement useschevron-down(expanded) andchevron-right(collapsed) instead ofcaret-alt-downandcaret-alt-right.TreeList—The pager buttons use thechevron-left,chevron-right,chevron-double-left, andchevron-double-righticons instead ofcaret-alt-left,caret-alt-right,caret-alt-to-left, andcaret-alt-to-right.
For the changes in the component behavior and API, see Breaking Changes in 9.0.0.