首页
/ Oruga UI 0.10.0版本发布:组件库的重大升级与优化

Oruga UI 0.10.0版本发布:组件库的重大升级与优化

2025-07-05 00:24:23作者:宣利权Counsellor

项目简介

Oruga UI是一个轻量级的Vue.js组件库,以其简洁的设计和灵活的定制能力著称。它提供了丰富的UI组件,帮助开发者快速构建现代化的Web应用界面。Oruga UI遵循"无样式"的设计理念,这意味着它不强制使用特定的CSS框架,开发者可以轻松地将其与任何CSS框架(如Bootstrap、Bulma等)集成,或者自定义样式以满足项目需求。

0.10.0版本概述

Oruga UI 0.10.0版本是一次重要的更新,包含了大量组件功能的改进、API的优化以及一些破坏性变更。这个版本着重提升了组件的可访问性、用户体验和一致性,同时也简化了一些API设计。下面我们将详细介绍这次更新的主要内容。

主要变更与改进

1. 可访问性增强

在这个版本中,Oruga UI团队特别关注了组件的可访问性改进:

  • Carousel组件新增了多个ARIA相关属性,包括ariaAutoplayPauseLabelariaAutoplayResumeLabelariaNextLabelariaPreviousLabel,使屏幕阅读器用户能更好地理解和使用轮播功能。

  • Datepicker和Timepicker组件增加了选择年、月、小时、分钟等操作的ARIA标签,提升了日期时间选择器的可访问性。

  • Steps和Tabs组件新增了ariaLabel属性,为这些导航类组件提供了更好的语义化支持。

2. 组件API优化

多个组件的API进行了简化和统一:

  • Dropdown组件进行了重大重构:

    • 移除了ariaRolemenuTabindex等冗余属性
    • 新增了closeOnOutsidecloseOnScroll等更直观的控制属性
    • scroll属性重命名为更准确的clipScroll
    • 增加了selectableselectOnClose等新功能
  • Menu组件进行了现代化改造:

    • 使用modelValue替代了旧的activable属性
    • 新增了options属性支持更灵活的数据驱动方式
    • 改进了角色(role)和ID管理
  • Field组件简化了属性命名,将groupMultiline更名为更简洁的multiline

3. 模态行为改进

多个包含弹出层的组件(如Autocomplete、Datepicker、Datetimepicker等)新增了desktopModal属性,允许开发者更精细地控制在不同设备上的显示行为。这使得响应式设计更加灵活。

4. 滚动行为统一

多个组件(如Dropdown、Loading、Modal、Sidebar等)对滚动行为的控制进行了统一:

  • 将原来的scroll属性统一更名为clipScroll,使其语义更明确
  • noScrollClass类名统一改为scrollKeepClass,提高了命名的一致性

5. 类名系统重构

为了提供更一致的样式定制体验,多个组件的CSS类名系统进行了重构:

  • Steps组件navClass重命名为listClassnavItemClass重命名为stepClass等,使类名更符合实际用途
  • Tabs组件简化了类名结构,移除了冗余的navTypeClass
  • Switch组件移除了多个特定类名,简化了样式系统

6. 事件系统改进

多个组件的事件系统得到了增强:

  • Autocomplete组件新增了update:active事件,提供了更细粒度的控制
  • Button和MenuItem组件显式添加了click事件,提高了API的明确性
  • Dropdown组件新增了changeopen事件,增强了交互控制能力

迁移指南

对于从旧版本升级的用户,需要注意以下破坏性变更:

  1. Dropdown组件scroll属性已更名为clipScroll,需要相应更新代码
  2. Menu组件不再使用activable属性,改为使用modelValue进行控制
  3. Steps和Tabs组件移除了destroyOnHide属性,相关功能需要重新实现
  4. Table组件debounceSearch更名为filterDebounceheaderCheckable更名为checkableHeader
  5. 多个组件的CSS类名发生了变化,需要检查并更新自定义样式

总结

Oruga UI 0.10.0版本是一次全面的质量提升,通过改进可访问性、统一API设计、优化组件行为,为开发者提供了更强大、更一致的开发体验。虽然包含了一些破坏性变更,但这些改动都是为了长期的可维护性和更好的用户体验。建议所有用户评估这些变更对现有项目的影响,并计划逐步升级到这个更稳定、功能更丰富的版本。

登录后查看全文
热门项目推荐