Chakra UI 3.3.0版本发布：新增QRCode组件与多项功能优化

前言

Chakra UI是一个流行的React组件库，以其易用性、可访问性和模块化设计而闻名。它提供了丰富的预制组件，帮助开发者快速构建现代化的用户界面。最新发布的3.3.0版本带来了一系列新功能和改进，特别是新增了QRCode组件，以及对现有组件的多项优化。

主要新增功能

1. QRCode组件

3.3.0版本最引人注目的新增功能是QRCode组件，它允许开发者轻松地将文本和链接转换为QR码。这个组件采用了组合式API设计，提供了高度可定制的选项：

import { QrCode } from "@chakra-ui/react"

export const QrCodeWithoutSnippet = () => {
  return (
    <QrCode.Root value="..." size="md">
      <QrCode.Frame>
        <QrCode.Pattern />
      </QrCode.Frame>
    </QrCode.Root>
  )
}

组件特性包括：

• 支持onValueChange和defaultValue属性
• 提供QrCode.DownloadTrigger子组件，方便用户下载QR码图片
• 修复了getDataUrl方法生成QR码尺寸不正确的问题

2. Clipboard组件增强

Clipboard组件新增了ValueText子组件，用于显示剪贴板内容，增强了组件的功能性。

3. FileUpload组件改进

FileUpload组件增加了两个实用功能：

• preventDropOnDocument属性：当文件上传组件激活时，阻止文件在文档上的拖放
• setClipboardFilesAPI：允许从剪贴板数据设置文件

同时修复了隐藏输入与接受文件不同步的问题。

现有组件优化

1. Progress组件

Progress组件现在支持onValueChange和defaultValue属性，使其行为更加可控。

2. 导航组件增强

Tabs、Menu和Combobox组件新增了navigate属性，允许开发者自定义路由导航行为，特别是当选项呈现为链接时。

3. 交互组件修复

• Collapsible：修复了打开动画在重新渲染已打开的折叠组件时重复播放的问题
• Dialog/Popover：解决了当焦点元素从DOM中移除时对话框或弹出窗口意外关闭的问题
• Menu/Popover：修复了当触发器位于可滚动容器内时，组件外部交互检测不一致的问题

4. Pagination组件

修正了当pageSize超过count时，页面范围返回错误end值的问题。

样式系统改进

• 修复了htmlWidth和htmlHeight在Image或chakra.image元素中无效的问题
• 增强了层样式的类型安全性，支持常见简写如bg、bgColor、bgImage等
• 修复了复合变体与colorPalette属性不匹配的问题

总结

Chakra UI 3.3.0版本在保持一贯易用性的同时，通过新增QRCode组件和多项功能优化，进一步丰富了开发者的工具箱。这些改进不仅增加了新功能，还修复了一些边界情况的问题，提升了整体稳定性和开发体验。对于正在使用或考虑使用Chakra UI的团队来说，这个版本值得关注和升级。