首页
/ Ark-UI React 5.10.0版本发布:新增密码输入组件与多项功能优化

Ark-UI React 5.10.0版本发布:新增密码输入组件与多项功能优化

2025-06-13 23:32:36作者:裘晴惠Vivianne

Ark-UI是一个现代化的React UI组件库,专注于提供高性能、可访问性强的交互式组件。它采用原子化设计理念,通过组合基础组件来构建复杂的用户界面。Ark-UI特别注重开发者体验,提供了完整的类型定义和直观的API设计。

密码输入组件全新登场

本次5.10.0版本最引人注目的新特性是全新的PasswordInput组件,它为开发者提供了开箱即用的密码输入解决方案。这个组件不仅包含了基本的密码输入功能,还内置了密码可见性切换功能,大大简化了开发者的工作流程。

使用PasswordInput组件非常简单,它遵循Ark-UI一贯的组件组合模式:

import { PasswordInput } from '@ark-ui/react/password-input'
import { EyeIcon, EyeOffIcon } from 'lucide-react'

export const Basic = () => (
  <PasswordInput.Root>
    <PasswordInput.Label>密码</PasswordInput.Label>
    <PasswordInput.Control>
      <PasswordInput.Input />
      <PasswordInput.VisibilityTrigger>
        <PasswordInput.Indicator fallback={<EyeOffIcon />}>
          <EyeIcon />
        </PasswordInput.Indicator>
      </PasswordInput.VisibilityTrigger>
    </PasswordInput.Control>
  </PasswordInput.Root>
)

这个组件设计有几个值得注意的特点:

  1. 可组合性:通过RootControlInput等子组件灵活组合,适应不同场景需求
  2. 图标切换:内置可见性切换功能,支持自定义图标
  3. 无障碍支持:自动处理ARIA属性,确保屏幕阅读器正确识别
  4. 类型安全:完整的TypeScript支持,提供良好的开发体验

Select组件增强

Select组件在此版本中新增了onSelect回调函数,当用户通过键盘或鼠标选择项目时会触发这个回调。这个改进使得开发者能够更精确地控制选择行为,实现更复杂的交互逻辑。

在实际应用中,这个特性特别有用,比如:

  • 在选择项目时立即触发搜索
  • 实现级联选择效果
  • 在选择时同步更新其他UI状态

问题修复与稳定性提升

本次更新还包含了一系列问题修复,进一步提升了组件的稳定性和可靠性:

  1. Color Picker修复:解决了在通过输入提交时错误触发值变更结束事件的问题,现在颜色选择器的行为更加符合预期。

  2. Toast组件改进:修复了调用toast.remove()时不带ID会导致TypeScript错误的问题,增强了类型安全性。

  3. Field组件优化:修复了在特殊DOM环境中无法检测辅助文本和错误文本的问题,这使得Ark-UI在更复杂的前端架构中(如微前端应用)也能正常工作。

升级建议

对于现有项目,建议尽快升级到5.10.0版本以获取这些改进和新功能。特别是:

  • 需要密码输入功能的项目可以直接使用新的PasswordInput组件
  • 使用Select组件并需要更精细控制选择行为的项目可以受益于新的onSelect回调
  • 遇到上述修复问题的项目可以通过升级解决相关bug

升级过程通常很平滑,但建议在升级后对相关功能进行测试,确保一切正常工作。对于TypeScript项目,新版本提供了更完善的类型定义,可能会发现之前未被捕获的类型问题,这也是改进代码质量的好机会。

Ark-UI持续关注开发者体验和组件质量,5.10.0版本的发布再次证明了这一点。无论是新加入的密码输入组件,还是对现有组件的改进,都体现了团队对细节的关注和对现代Web开发需求的深刻理解。

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

项目优选

收起
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
176
260
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
854
505
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
129
182
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
254
295
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
93
15
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
331
1.08 K
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
397
370
note-gennote-gen
一款跨平台的 Markdown AI 笔记软件,致力于使用 AI 建立记录和写作的桥梁。
TSX
83
4
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.07 K
0
kernelkernel
deepin linux kernel
C
21
5