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

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

2025-07-05 23:20:56作者:宣利权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设计、优化组件行为,为开发者提供了更强大、更一致的开发体验。虽然包含了一些破坏性变更,但这些改动都是为了长期的可维护性和更好的用户体验。建议所有用户评估这些变更对现有项目的影响,并计划逐步升级到这个更稳定、功能更丰富的版本。

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

项目优选

收起
kernelkernel
deepin linux kernel
C
27
11
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
466
3.47 K
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
10
1
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
65
19
flutter_flutterflutter_flutter
暂无简介
Dart
715
172
giteagitea
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
23
0
kernelkernel
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
203
82
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.27 K
695
rainbondrainbond
无需学习 Kubernetes 的容器平台,在 Kubernetes 上构建、部署、组装和管理应用,无需 K8s 专业知识,全流程图形化管理
Go
15
1
apintoapinto
基于golang开发的网关。具有各种插件,可以自行扩展,即插即用。此外,它可以快速帮助企业管理API服务,提高API服务的稳定性和安全性。
Go
22
1