v5.0.0

What's Changed

Environment 💻

• 🚩BREAKING🚩 Upgrades Node.js to v18 and Vue to 2.7. By @bjester and @rtibbles in #645.
  • Guidance: Make sure your system supports Node.js v18 and Vue 2.7 before upgrading.
• Integrates visual testing setup to KDS. By @KshitijThareja in #901.

New components

• KCard: An accessible card component offering the most frequently used card content and thumbnail layouts, as well as other customization options. By @AllanOXDi, @MisRob and @Spoorthy1423 in #625, #709, #707, #688, #706, #705, #754, #752, #774, #785, #796, #825, #838, #851.
• KCardGrid: An accesible component that displays a grid of cards KCard. By @MisRob in #785, #820.
• KTable: An accessible and customizable table component designed to handle a variety of data presentation needs, suitable for both simple and complex data tables. By @BabyElias, @Sahil-Sinha-11, @EshaanAgg, @karankoder and @shivam-daksh in #727, #780, #803, #824, #854, #887 and #804.
• KRadioButtonGroup: New component to fix keyboard navigation in radio button groups in Firefox. By @muditchoudhary in #650.
  • Guidance: Make sure that all KRadioButtons are wrapped in KRadioButtonGroup.
• KOverlay: Use KOverlay to move an element from its original place in the DOM to the overlay container element #k-overlay. This is often useful for modals, tooltips, dropdowns, or other elements that should appear on top of other content. By @MisRob in #722.
• KFocusTrap: Ensures that keyboard focus is trapped within a specific region of the page. By @lokesh-sagi125 in #799.
• KToolbar: Creates initial KToolbar component as a port of UiToolbar. By @rtibbles in #831.

New composables

• useKLiveRegion: composable with public methods for updating the live regions with assertive and polite messages. By @MisRob in #687.
  • Guidance: Find all polite and live regions (or roles) in an application. Remove them and instead use useKLiveRegion.sendPoliteMessage and useKLiveRegion.sendAssertiveMessage to update the live regions that KDS inserted to document body during installation.
• useKResponsiveElement: Provides the following reactive element's size information: elementHeight and elementWidth. By @AlexVelezLl in #783.

KImg

• 🚩BREAKING🚩 Removes KImg props related to dimensions: height, width, maxHeight, minHeight, maxWidth, minWidth. By @MisRob in #615.
  • Guidance: Use native style, for example replace <KImg width="100%" maxWidth="500px" /> by <KImg :style="{ width: '100%', maxWidth: '500px' }" />.
• Updates KImg's placeholder and letterbox area background color to a lighter shade of grey, v_50. By @MisRob in #666.

KTextTruncator

• 🚩BREAKING🚩 Removes lineHeightIE prop and drops Internet Explorer 11 support. By @Nivas7 in #652.
  • Guidance: To be used in newer versions of products that don't need to support IE11.

KResponsiveWindow

• 🚩BREAKING🚩 Removes KResponsiveWindowMixin. By @AlexVelezLl in #719.
  • Guidance: Replace any use of KResponsiveWindowMixin with the new composable useKResponsiveWindow.

KResponsiveElementMixin

• 🚩BREAKING🚩 Removes KResponsiveElementMixin. By @AlexVelezLl in #783.
  • Guidance: Replace any use of KResponsiveElementMixin with the new composable useKResponsiveElement.

UiToolbar

• 🚩BREAKING🚩 Removes /lib/keen/UiToolbar. By @rtibbles in #831.
  • Guidance: Use the new KToolbar component instead.

KModal

• 🚩BREAKING🚩 Renames KModal's appendToRoot prop to appendToOverlay. By @MisRob in #722
  • Guidance: Rename KModal's appendToRoot prop to appendToOverlay
• Updates KModal to trap keyboard focus. By @lokesh-sagi125 in #799.
• Fixes KModal content height calculation, and now it shrinks when the content has a smaller height. By @galovdev in #590.
  • Guidance: Double check that the height of the modals continues to work correctly.
• Fixes infinite recursive error when KModal request the focus. By @AlexVelezLl in #903.

KDS General Styling

• 🚩BREAKING🚩 Removes deprecated dropshadows. By @lokesh-sagi125 in #815.
  • Guidance: Update any %dropshadow-Xdp usage different than 1dp, 2dp and 6dp to the latest drop shadows guidelines.

KImg, KTabs, KTabsList

• 🚩BREAKING🚩 Component error handling now use @error listener to avoid polluting test output, nor suppressing console.* in tests. By @bjester in #645.
  • Guidance: The KImg component may now emit an Error object in its @error listener when incorrectly configured, in addition to an UiEvent|Event when an image fails to load. Consumers should type check the value.

KSelect

• Internal refactor of KSelect as part of moving away from Keen UI. By @Jaspreet-singh-1032 in #549.
  • Guidance: Thorough QA of places that use KSelect is recommended due to the large scope of refactor.
• Adds new events: @dropdown-open, @dropdown-close, @query-change, @input, @touch, @focus. By @Jaspreet-singh-1032 in #549.
• Adds new slots: #default, #display, #option, #no-results, #error, #help. By @Jaspreet-singh-1032 in #549.
• Adds new public method reset to reset the state of the KSelect to default values. By @Jaspreet-singh-1032 in #549.
• Fixes KSelect not being reactive to value prop changes. By @rtibbles in #843.
• 🗒️ Improves KSelect documentation by documenting undocumented slots and props. By @yeshwanth235 in #821.
• Teleport KSelect dropdown to the Overlay layer to fix positioning errors. By @AlexVelezLl in #877.

KIconButton

• Adds tooltip prop as fallback when ariaLabel is missing in KIconButton. By @shivam-daksh in #798.

KDateRange

• Changes KDa...

v5.0.0-rc12

What's Changed

KBreadcrumbs

• Adds the global title attribute to KBreadcrumbs so that the truncated text can be seen fully when a breadcrumb item is hovered. By @RONAK-AI647 in #872.

KLogo

• Reverts regression in KLogo display. By @rtibbles in #868.

KTable

• Makes KTable sorting case-insensitive and internationalized. By @BabyElias in #854.
• Adds missing margins to the empty table message to ensure consistent spacing with the table header and data rows. By @karankoder in #887.

Ktooltip

• 🗒️ Adds documentation for KTooltip component. By @shruti862 in #859.

Docs 🗒️

• Adds search text to route query for better browser history management. By @RONAK-AI647 in #847.

New Contributors

• @rparadowski made their first contribution in #849
• @shruti862 made their first contribution in #859
• @karankoder made their first contribution in #887

Full Changelog: v5.0.0-rc11...v5.0.0-rc12

v5.0.0-rc11

What's Changed

Environment 💻

• 🚩BREAKING🚩 Upgrades Node.js to v18 and Vue to 2.7. By @bjester and @rtibbles in #645.
  • Guidance: Make sure your system supports Node.js v18 and Vue 2.7 before upgrading.

KTable

• 🚩BREAKING🚩 Adds requirement for columnId attribute in all header objects. By @EshaanAgg in #824.
  • Guidance: Add a unique column identifier columnId to all header objects.
• 🚩BREAKING🚩 Renames disableDefaultSorting prop to disableBuiltinSorting. By @EshaanAgg in #824.
  • Guidance: Rename all occurrence of disableDefaultSorting.
• Adds default sorting functionality feature. By @EshaanAgg in #824.

KImg, KTabs, KTabsList

• 🚩BREAKING🚩 Component error handling now use @error listener to avoid polluting test output, nor suppressing console.* in tests. By @bjester in #645.
  • Guidance: The KImg component may now emit an Error object in its @error listener when incorrectly configured, in addition to an UiEvent|Event when an image fails to load. Consumers should type check the value.

KCard

• Re-organizes KCard styles to improve content tolerance and simplify styles, and fixes the thumbnail overflow problems in horizontal layout with small thumbnail. By @MisRob in #838.
• Prepends all internal KCard class names with k . By @MisRob in #851.

KSelect

• 🗒️ Improves KSelect documentation by documenting undocumented slots and props. By @yeshwanth235 in #821.

KRadioButtonGroup

• Adds radiogroup role to KRadioButtonGroup. By @iamshobhraj in #846.

Styling

• 🗒️ Reorganizes elevation diagram in styling docs to be under the z-index section for better clarity. By @RONAK-AI647 in #819.

New Contributors

• @yeshwanth235 made their first contribution in #821
• @iamshobhraj made their first contribution in #846

Full Changelog: v5.0.0-rc10...v5.0.0-rc11

v5.0.0-rc10

What's Changed

KDS General Styling

• 🚩BREAKING🚩 Removes deprecated dropshadows. By @lokesh-sagi125 in #815.
  • Guidance: Update any %dropshadow-Xdp usage different than 1dp, 2dp and 6dp to the latest drop shadows guidelines.

New components

• KToolbar: Creates initial KToolbar component as a port of UiToolbar. Further changes and iterations to API expected. By @rtibbles in #831.

UiToolbar

• 🚩BREAKING🚩 Removes /lib/keen/UiToolbar. By @rtibbles in #831.
  • Guidance: Use the new KToolbar component instead.

KCard

• 🚩BREAKING🚩 Makes the title prop required. By @MisRob in #825.
  • Guidance: Even if you use the title slot, pass the title text via the title prop.
• Change the title slot into a scoped slot. By @MisRob in #825.
  • Guidance: Consider using the slot's textTitle attribute to achieve more intuitive code when customizing the title.
• Emit click event when card is clicked. By @MisRob in #825.
• Makes to prop optional and when not provided, do not render the title text as router-link but rather as span. By @MisRob in #825.
• Ensures reliable screen readers announcements no matter whether card is link or no, and no matter whether the title is customized via the title slot. By @MisRob in #825.

KDropdownMenu

• Fixes keyboard navigation flow that prevented focusing the next option when a divider was present. By @Sahil-Sinha-11 in #818.
• Fixes an issue where focus is not correctly restored to the last focused element after the dropdown is closed. By @Sahil-Sinha-11 in #818.

KSelect

• Fixes KSelect not being reactive to value prop changes. By @rtibbles in #843.

Docs 🗒️

• Improves visibility of focus-ring in Firefox. By @RONAK-AI647 in #827.

Full Changelog: v5.0.0-rc9...v5.0.0-rc10

v5.0.0-rc9

What's Changed

KCard

• Fixes KCard area not taking available width. By @MisRob in #796.

KCardGrid

• Adds an option to override KCardGrid base layouts partially or completely via the new prop layoutOverride. By @MisRob in #820.
• Adds loading skeletons to KCardGrid and a way to configure them via the new prop skeletonsConfig. By @MisRob in #820.

Full Changelog: v5.0.0-rc8...v5.0.0-rc9

v5.0.0-rc8

What's Changed

New components

• KFocusTrap: Ensures that keyboard focus is trapped within a specific region of the page. By @lokesh-sagi125 in #799.

KModal

• Updates KModal to trap keyboard focus. By @lokesh-sagi125 in #799.

KIconButton

• Adds tooltip prop as fallback when ariaLabel is missing in KIconButton. By @shivam-daksh in #798.

KTable

• Adds the option to get back to the unsorted state after sorting a KTable column, making it flow to be unsorted -> ascending -> descending -> unsorted. By @Sahil-Sinha-11 in #803.

KSwitch

• Adds ariaLabelledBy prop to KSwitch. By @Sahil-Sinha-11 in #808.

Docs 🗒️

• Updates KDS Docs favicon to the new branding. By @RONAK-AI647 in #809.

Forward-ported changes from v4.6.0

Theme tokens

• 🚩BREAKING🚩 Updates Theme Tokens to the latest specs to comply material design specifications. By @AlexVelezLl in https://github.com/learningequality/kolibri-design-system/pull/782.
  • Guidace: Please update all v_* theme tokens using the mapping posted in #775.

New Contributors

• @Sahil-Sinha-11 made their first contribution in #803
• @RONAK-AI647 made their first contribution in #809

Full Changelog: v5.0.0-rc7...v5.0.0-rc8

v5.0.0-rc7

What's Changed

New components

• KCardGrid: Displays a grid of cards KCard. By @MisRob in #785.

New composables

• useKResponsiveElement: Provides the following reactive element's size information: elementHeight and elementWidth. By @AlexVelezLl in #783.

KResponsiveElementMixin

• 🚩BREAKING🚩 Removes KResponsiveElementMixin. By @AlexVelezLl in #783.
  • Guidance: Replace any use of KResponsiveElementMixin with the new composable useKResponsiveElement.

KCard

• 🚩BREAKING🚩 Renames KCard's titleLines prop to titleMaxLines. By @MisRob in #785.
  • Guidance: Rename the prop.
• 🚩BREAKING🚩 Renames KCard's layout prop to orientation. By @MisRob in #785.
  • Guidance: Rename the prop.
• Updates KCard to make screen readers announce only card titles when navigating the grid with TAB key.
• Adds support to KCard for selection controls such as checkboxes.
• Improves spaces display in KCard.
• Hides KCard placeholder element after the thumbnail image is loaded.
• 🗒️ Adds detailed guidance to KCard documentation page.

KTable

• 🗒️ Updates KTable documentation to include more examples for custom column widths and use of slots. By @BabyElias in #780.

Full Changelog: v5.0.0-rc6...v5.0.0-rc7

v4.6.0

What's Changed

Theme tokens

• 🚩BREAKING🚩 Updates Theme Tokens to the latest specs to comply material design specifications. By @AlexVelezLl in #782.
  • Guidace: Please update all v_* theme tokens using the mapping posted in #775.

Full Changelog: v4.5.1...v4.6.0

v5.0.0-rc6

What's Changed

KCard

• Updates KCard to complete vertical/horizontal layouts with no thumbnail. By @AllanOXDi in #752.
• Updates KCard internal structure and style. This introduces temporary regressions in KCard related to removing its control of its height that will instead be controlled by KCardGrid. However, KCard is required to be always used within KCardGrid anyways so ultimately this will be of no real impact. Will be completed by KCardGrid soon. By @MisRob in #774.
• Fixes the thumbnail overflowing in the horizontal layout with small thumbnail and aligns this layout more closely to the designs. By @MisRob in #774.
• Fixes @click.stop not working on interactive elements rendered within the card via its slots. By @MisRob in #774.

KRadioButton

• Adds warning in KRadioButton if it is not nested inside a KradioButtonGroup. By @lokesh-sagi125 in #781.

Backported changes from v4.5.1

KCheckbox, KRadioButton.

• Add labelDir prop to control rtl direction of label. By @AlexVelezLl in #784.

Full Changelog: v5.0.0-rc5...v5.0.0-rc6

v4.5.1

What's Changed

KCheckbox, KRadioButton.

• Add labelDir prop to control rtl direction of label.. By @AlexVelezLl in #784.

Full Changelog: v4.5.0...v4.5.1