@nutui/nutui-react-taro 3.0.19-cpp.26-beta.5 → 3.0.19-cpp.27

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# v3.0.19-cpp.27
+
+`2026-04-24`
+
+- 🏡 chore: 升级京东正黑字体到 2.3 (#3435)
+- 🏡 chore: 升级 icon 库版本
+- 🚀 feat: 针对小程序环境进行性能优化与 SelectorQuery 作用域适配 (Tabs, CountUp, getRect)
+- ♿️ feat: 全面适配无障碍 (A11y)，涉及组件：Image, Dialog, Button, SearchBar, Popup, Tabs, Progress, Avatar, NavBar, ResultPage
+- 📖 docs: 新增组件标准白皮书与 AI 助手相关文档
+- 🐛 fix(avatar): 修复 onClick 条件判断逻辑并支持 Taro 端 alt 属性
+- 🐛 fix(tabs): 修复 useRtl 引用路径并优化无障碍属性
+- 🐛 fix(quickenter): 修复顶部安全区域适配问题
+- 🐛 fix(type): 修复类型导出与 lint 问题
+
 # v3.0.18
 
 `2025-08-15`

package/dist/cjs/locales/base.d.ts

@@ -9,6 +9,11 @@ export interface BaseLang {
     edit: string;
     reset: string;
     close: string;
+    back: string;
+    clear: string;
+    image: {
+        errorTip: string;
+    };
     video: {
         errorTip: string;
         clickRetry: string;

package/dist/cjs/locales/en-US.js

@@ -19,6 +19,11 @@ var enUS = {
     edit: 'Edit',
     reset: 'Reset',
     close: 'Close',
+    back: 'Back',
+    clear: 'Clear',
+    image: {
+        errorTip: 'Image failed to load'
+    },
     video: {
         errorTip: 'Error Tip',
         clickRetry: 'Click Retry'

package/dist/cjs/locales/id-ID.js

@@ -19,6 +19,11 @@ var idID = {
     edit: 'Sunting',
     reset: 'Mengatur Ulang',
     close: 'Tutup',
+    back: 'Kembali',
+    clear: 'Bersihkan',
+    image: {
+        errorTip: 'Gambar gagal dimuat'
+    },
     video: {
         errorTip: 'Terjadi Kesalahan',
         clickRetry: 'Coba Lagi'

package/dist/cjs/locales/ja-JP.js

@@ -18,6 +18,12 @@ var jaJP = {
     select: '選択してください',
     edit: '編集',
     reset: 'リセット',
+    close: '閉じる',
+    back: '戻る',
+    clear: 'クリア',
+    image: {
+        errorTip: '画像の読み込みに失敗しました'
+    },
     video: {
         errorTip: '動画の読み込みに失敗しました',
         clickRetry: 'クリックして再試行'
@@ -165,7 +171,6 @@ var jaJP = {
         errorCanvasTips: '現在の環境はCanvasをサポートしていません'
     },
     mask: 'マスク',
-    close: '閉じる',
     quickenter: {
         title: 'クイックアクセス'
     }

package/dist/cjs/locales/tr-TR.js

@@ -19,6 +19,11 @@ var trTR = {
     edit: 'düzenlemek',
     reset: 'sıfırlama',
     close: 'Kapat',
+    back: 'Geri',
+    clear: 'Temizle',
+    image: {
+        errorTip: 'Resim yüklenemedi'
+    },
     video: {
         errorTip: 'Video yüklenemedi',
         clickRetry: 'Yeniden Tıklayın'

package/dist/cjs/locales/zh-CN.js

@@ -19,6 +19,11 @@ var zhCN = {
     edit: '编辑',
     reset: '重置',
     close: '关闭',
+    back: '返回',
+    clear: '清除',
+    image: {
+        errorTip: '图片加载失败'
+    },
     video: {
         errorTip: '视频加载失败',
         clickRetry: '点击重试'

package/dist/cjs/locales/zh-TW.js

@@ -19,6 +19,11 @@ var zhCN = {
     edit: '編輯',
     reset: '重置',
     close: '關閉',
+    back: '返回',
+    clear: '清除',
+    image: {
+        errorTip: '圖片加載失敗'
+    },
     video: {
         errorTip: '視頻加載失敗',
         clickRetry: '點擊重試'

package/dist/cjs/locales/zh-UG.js

@@ -19,6 +19,11 @@ var zhUG = {
     edit: 'يحرر',
     reset: 'إعادة ضبط',
     close: 'تاقاش',
+    back: 'قايتىش',
+    clear: 'تاقاش',
+    image: {
+        errorTip: 'رەسىم يۈكلەش مەغلۇپ بولدى'
+    },
     video: {
         errorTip: 'فىلىمنى قويۇش مەغلۇپ بولدى',
         clickRetry: 'قايتا سىناش'

package/dist/cjs/packages/address/address.d.ts

@@ -1,3 +1,3 @@
 import React from 'react';
 import { AddressRef, TaroAddressProps } from "../../types";
-export declare const Address: React.ForwardRefExoticComponent<Partial<TaroAddressProps> & Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "onClick" | "title" | "onLoad"> & React.RefAttributes<AddressRef>>;
+export declare const Address: React.ForwardRefExoticComponent<Partial<TaroAddressProps> & Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "title" | "onClick" | "onLoad"> & React.RefAttributes<AddressRef>>;

package/dist/cjs/packages/animatingnumbers/countup.js

@@ -59,7 +59,9 @@ var CountUp = function CountUp(props) {
     var isLoaded = (0, _react.useRef)(false);
     var setNumberTransform = (0, _react.useCallback)(function() {
         if (countupRef.current && numberArr.length) {
-            (0, _taro.createSelectorQuery)().selectAll('.nut-countup-listitem').node(function(numberItems) {
+            var _countupRef_current;
+            (0, _taro.createSelectorQuery)() // @ts-ignore
+            .in(((_countupRef_current = countupRef.current) === null || _countupRef_current === void 0 ? void 0 : _countupRef_current._scope) || countupRef.current).selectAll('.nut-countup-listitem').node(function(numberItems) {
                 var transformArrCache = [];
                 Object.keys(numberItems).forEach(function(key) {
                     var elem = numberItems[Number(key)];

package/dist/cjs/packages/avatar/avatar.js

@@ -13,6 +13,7 @@ var _interop_require_wildcard = require("@swc/helpers/_/_interop_require_wildcar
 var _define_property = require("@swc/helpers/_/_define_property");
 var _object_spread = require("@swc/helpers/_/_object_spread");
 var _object_spread_props = require("@swc/helpers/_/_object_spread_props");
+var _object_without_properties = require("@swc/helpers/_/_object_without_properties");
 var _sliced_to_array = require("@swc/helpers/_/_sliced_to_array");
 var _react = /*#__PURE__*/ _interop_require_wildcard._(require("react"));
 var _components = require("@tarojs/components");
@@ -37,7 +38,23 @@ var defaultProps = (0, _object_spread_props._)((0, _object_spread._)({}, _typing
 });
 var classPrefix = "nut-avatar";
 var Avatar = function Avatar(props) {
-    var _$_object_spread = (0, _object_spread._)({}, defaultProps, props), children = _$_object_spread.children, size = _$_object_spread.size, shape = _$_object_spread.shape, background = _$_object_spread.background, color = _$_object_spread.color, src = _$_object_spread.src, icon = _$_object_spread.icon, mode = _$_object_spread.mode, fit = _$_object_spread.fit, avatarIndex = _$_object_spread.avatarIndex, className = _$_object_spread.className, style = _$_object_spread.style, onClick = _$_object_spread.onClick, onError = _$_object_spread.onError;
+    var _ref = (0, _object_spread._)({}, defaultProps, props), children = _ref.children, size = _ref.size, shape = _ref.shape, background = _ref.background, color = _ref.color, src = _ref.src, alt = _ref.alt, icon = _ref.icon, mode = _ref.mode, fit = _ref.fit, avatarIndex = _ref.avatarIndex, className = _ref.className, style = _ref.style, onClick = _ref.onClick, onError = _ref.onError, rest = (0, _object_without_properties._)(_ref, [
+        "children",
+        "size",
+        "shape",
+        "background",
+        "color",
+        "src",
+        "alt",
+        "icon",
+        "mode",
+        "fit",
+        "avatarIndex",
+        "className",
+        "style",
+        "onClick",
+        "onError"
+    ]);
     var _useState // 是否显示的最大头像个数
      = (0, _sliced_to_array._)((0, _react.useState)(false), 2), showMax = _useState[0], setShowMax = _useState[1];
     var avatarRef = (0, _react.useRef)(null);
@@ -74,7 +91,8 @@ var Avatar = function Avatar(props) {
         }
     }, [
         avatarIndex,
-        groupCount
+        groupCount,
+        groupMax
     ]);
     var errorEvent = function errorEvent() {
         onError && onError();
@@ -82,19 +100,26 @@ var Avatar = function Avatar(props) {
     var clickAvatar = function clickAvatar(e) {
         onClick && onClick(e);
     };
-    return /*#__PURE__*/ _react.default.createElement(_react.default.Fragment, null, (showMax || !groupMax || avatarIndex <= groupMax) && /*#__PURE__*/ _react.default.createElement(_components.View, {
+    return /*#__PURE__*/ _react.default.createElement(_react.default.Fragment, null, (showMax || !groupMax || avatarIndex <= groupMax) && /*#__PURE__*/ _react.default.createElement(_components.View, (0, _object_spread._)({
         className: cls,
         style: !showMax ? styles : maxStyles,
         onClick: clickAvatar,
-        ref: avatarRef
-    }, (!groupMax || avatarIndex <= groupMax) && /*#__PURE__*/ _react.default.createElement(_react.default.Fragment, null, src && /*#__PURE__*/ _react.default.createElement(_components.Image, {
+        ref: avatarRef,
+        // @ts-ignore
+        ariaRole: onClick ? 'button' : undefined
+    }, rest), (!groupMax || avatarIndex <= groupMax) && /*#__PURE__*/ _react.default.createElement(_react.default.Fragment, null, src && /*#__PURE__*/ _react.default.createElement(_components.Image, {
         className: "nut-avatar-img nut-avatar-".concat(groupSize || size || 'normal', "-img"),
         src: src,
+        nativeProps: {
+            alt: alt
+        },
         style: {
             objectFit: fit
         },
         mode: mode,
-        onError: errorEvent
+        onError: errorEvent,
+        // @ts-ignore
+        ariaHidden: true
     }), /*#__PURE__*/ _react.default.isValidElement(icon) ? /*#__PURE__*/ _react.default.createElement(_components.View, {
         className: "nut-avatar-text"
     }, /*#__PURE__*/ _react.default.cloneElement(icon, (0, _object_spread_props._)((0, _object_spread._)({}, icon.props), {
@@ -108,6 +133,7 @@ var Avatar = function Avatar(props) {
     }, children), !src && !icon && !children && /*#__PURE__*/ _react.default.createElement(_components.View, {
         className: "nut-avatar-text"
     }, /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.User, {
+        ariaHidden: true,
         style: {
             color: color
         },

package/dist/cjs/packages/badge/badge.js

@@ -14,6 +14,7 @@ var _async_to_generator = require("@swc/helpers/_/_async_to_generator");
 var _define_property = require("@swc/helpers/_/_define_property");
 var _object_spread = require("@swc/helpers/_/_object_spread");
 var _object_spread_props = require("@swc/helpers/_/_object_spread_props");
+var _object_without_properties = require("@swc/helpers/_/_object_without_properties");
 var _sliced_to_array = require("@swc/helpers/_/_sliced_to_array");
 var _type_of = require("@swc/helpers/_/_type_of");
 var _ts_generator = require("@swc/helpers/_/_ts_generator");
@@ -53,7 +54,19 @@ var Badge = function Badge(props) {
     };
     var _this;
     var rtl = (0, _index.useRtl)();
-    var _$_object_spread = (0, _object_spread._)({}, defaultProps, props), className = _$_object_spread.className, style = _$_object_spread.style, value = _$_object_spread.value, max = _$_object_spread.max, children = _$_object_spread.children, dot = _$_object_spread.dot, top = _$_object_spread.top, right = _$_object_spread.right, fill = _$_object_spread.fill, size = _$_object_spread.size, disabled = _$_object_spread.disabled;
+    var _ref = (0, _object_spread._)({}, defaultProps, props), className = _ref.className, style = _ref.style, value = _ref.value, max = _ref.max, children = _ref.children, dot = _ref.dot, top = _ref.top, right = _ref.right, fill = _ref.fill, size = _ref.size, disabled = _ref.disabled, rest = (0, _object_without_properties._)(_ref, [
+        "className",
+        "style",
+        "value",
+        "max",
+        "children",
+        "dot",
+        "top",
+        "right",
+        "fill",
+        "size",
+        "disabled"
+    ]);
     var classPrefix = 'nut-badge';
     var isHarmony = (0, _platform.harmony)();
     var classes = (0, _classnames.default)(classPrefix, className);
@@ -81,11 +94,11 @@ var Badge = function Badge(props) {
         })();
     };
     var _obj1;
-    return /*#__PURE__*/ _react.default.createElement(_components.View, {
+    return /*#__PURE__*/ _react.default.createElement(_components.View, (0, _object_spread._)({
         className: classes,
         style: style,
         ref: badgeRef
-    }, isIcon() && /*#__PURE__*/ _react.default.createElement(_components.View, {
+    }, rest), isIcon() && /*#__PURE__*/ _react.default.createElement(_components.View, {
         className: (0, _classnames.default)("".concat(classPrefix, "-content"), (_obj1 = {}, (0, _define_property._)(_obj1, "".concat(classPrefix, "-icon"), true), (0, _define_property._)(_obj1, "".concat(classPrefix, "-icon-rtl"), rtl), _obj1)),
         style: contentStyle
     }, value), children, !isIcon() && (getContent() || dot) && /*#__PURE__*/ _react.default.createElement(_components.View, {

package/dist/cjs/packages/button/button.d.ts

@@ -1,22 +1,3 @@
 import React from 'react';
-import type { MouseEvent } from 'react';
-import { BasicComponent } from "../../utils/typings";
-export type ButtonType = 'default' | 'primary' | 'info' | 'success' | 'warning' | 'danger';
-export type ButtonSize = 'xlarge' | 'large' | 'normal' | 'small' | 'mini';
-export type ButtonShape = 'square' | 'round';
-export type ButtonFill = 'solid' | 'outline' | 'dashed' | 'none';
-export interface ButtonProps extends BasicComponent {
-    color: string;
-    shape: ButtonShape;
-    type: ButtonType;
-    size: ButtonSize;
-    fill: ButtonFill;
-    block: boolean;
-    loading: boolean;
-    disabled: boolean;
-    icon: React.ReactNode;
-    rightIcon: React.ReactNode;
-    nativeType: 'submit' | 'reset';
-    onClick: (e: MouseEvent<HTMLButtonElement>) => void;
-}
-export declare const Button: React.ForwardRefExoticComponent<Partial<ButtonProps> & React.RefAttributes<HTMLButtonElement>>;
+import { TaroButtonProps } from "../../types";
+export declare const Button: React.ForwardRefExoticComponent<Omit<Partial<TaroButtonProps>, "ref"> & React.RefAttributes<HTMLButtonElement>>;

package/dist/cjs/packages/button/button.js

@@ -105,9 +105,7 @@ var Button = /*#__PURE__*/ _react.default.forwardRef(function(props, ref) {
     // if (getEnv() === 'WEB') {
     //   ;(rest as any).type = formType
     // }
-    return(// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-    // @ts-ignore
-    // eslint-disable-next-line react/button-has-type
+    return(// @ts-ignore
     // <TaroButton
     /*#__PURE__*/ /*#__PURE__*/ _react.default.createElement(_components.View, (0, _object_spread_props._)((0, _object_spread._)({}, rest), {
         ref: ref,
@@ -120,6 +118,7 @@ var Button = /*#__PURE__*/ _react.default.forwardRef(function(props, ref) {
     }), /*#__PURE__*/ _react.default.createElement(_components.View, {
         className: "nut-button-wrap"
     }, loading && /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.Loading, {
+        ariaHidden: true,
         className: "nut-icon-loading"
     }), !loading && icon, children && /*#__PURE__*/ _react.default.createElement(_components.View, {
         className: "nut-button-children nut-button-".concat(size, "-children nut-button-").concat(type, "-children ").concat(!(props.fill || disabled || loading) ? '' : "nut-button-".concat(type).concat(props.fill ? "-".concat(fill) : '').concat(disabled || loading ? '-disabled' : '')).concat(icon || loading ? " nut-button-text" : '').concat(rightIcon ? ' nut-button-text-right' : ''),

package/dist/cjs/packages/button/index.d.ts

@@ -1,3 +1,2 @@
 import { Button } from "./button";
-export type { ButtonType, ButtonProps, ButtonSize, ButtonShape, ButtonFill, } from "./button";
 export default Button;

package/dist/cjs/packages/dialog/dialog.js

@@ -203,7 +203,11 @@ var BaseDialog = function BaseDialog(props) {
         };
         var _obj;
         var closeClasses = (0, _classnames.default)((_obj = {}, (0, _define_property._)(_obj, "".concat(classPrefix, "-close"), true), (0, _define_property._)(_obj, "".concat(classPrefix, "-close-").concat(closeIconPosition), true), _obj));
-        var systomIcon = closeIconPosition !== 'bottom' ? /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.Close, null) : /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.Failure, null);
+        var systemIcon = closeIconPosition !== 'bottom' ? /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.Close, {
+            ariaHidden: true
+        }) : /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.Failure, {
+            ariaHidden: true
+        });
         return /*#__PURE__*/ _react.default.createElement(_components.View, {
             className: closeClasses,
             onClick: handleClose,
@@ -211,7 +215,7 @@ var BaseDialog = function BaseDialog(props) {
             ariaLabel: locale.close,
             // @ts-ignore
             tabIndex: 0
-        }, /*#__PURE__*/ _react.default.isValidElement(closeIcon) ? closeIcon : systomIcon);
+        }, /*#__PURE__*/ _react.default.isValidElement(closeIcon) ? closeIcon : systemIcon);
     };
     var onHandleClickOverlay = function onHandleClickOverlay(e) {
         if (closeOnOverlayClick && visible && e.target === e.currentTarget) {

package/dist/cjs/packages/divider/divider.js

@@ -17,7 +17,7 @@ var _react = /*#__PURE__*/ _interop_require_default._(require("react"));
 var _classnames = /*#__PURE__*/ _interop_require_default._(require("classnames"));
 var _components = require("@tarojs/components");
 var _typings = require("../../utils/typings");
-var _configprovider = require("../configprovider/configprovider");
+var _index = require("../configprovider/index");
 var defaultProps = (0, _object_spread_props._)((0, _object_spread._)({}, _typings.ComponentDefaults), {
     contentPosition: 'center',
     direction: 'horizontal'
@@ -31,7 +31,7 @@ var Divider = function Divider(props) {
         "className",
         "direction"
     ]);
-    var rtl = (0, _configprovider.useRtl)();
+    var rtl = (0, _index.useRtl)();
     var _obj, _obj1;
     var classes = direction === 'horizontal' ? (0, _classnames.default)((_obj = {}, (0, _define_property._)(_obj, "".concat(classPrefix), true), (0, _define_property._)(_obj, "".concat(classPrefix, "-center"), children), (0, _define_property._)(_obj, "".concat(classPrefix, "-left"), contentPosition === 'left'), (0, _define_property._)(_obj, "".concat(classPrefix, "-right"), contentPosition === 'right'), (0, _define_property._)(_obj, "".concat(classPrefix, "-rtl"), ([
         'left',

package/dist/cjs/packages/empty/empty.d.ts

@@ -1,11 +1,11 @@
 import React, { FunctionComponent, ReactNode } from 'react';
 import { BasicComponent } from "../../utils/typings";
-import { ButtonFill, ButtonSize, ButtonType } from "../button/button";
+import { UIFill, UISize, UIType } from "../../types/base/atoms";
 export interface EmptyAction {
     text: React.ReactNode;
-    type?: ButtonType;
-    size?: ButtonSize;
-    fill?: ButtonFill;
+    type?: UIType;
+    size?: UISize;
+    fill?: UIFill;
     disabled?: boolean;
     onClick?: () => () => void;
 }

package/dist/cjs/packages/image/image.js

@@ -21,6 +21,7 @@ var _components = require("@tarojs/components");
 var _iconsreacttaro = require("@nutui/icons-react-taro");
 var _classnames = /*#__PURE__*/ _interop_require_default._(require("classnames"));
 var _pxtransform = require("../../utils/taro/px-transform");
+var _index = require("../configprovider/index");
 var defaultProps = {
     src: '',
     error: true,
@@ -42,6 +43,7 @@ var Image = function Image(props) {
     ]);
     var _useState = (0, _sliced_to_array._)((0, _react.useState)(true), 2), innerLoading = _useState[0], setInnerLoading = _useState[1];
     var _useState1 = (0, _sliced_to_array._)((0, _react.useState)(false), 2), isError = _useState1[0], setIsError = _useState1[1];
+    var locale = (0, _index.useConfig)().locale;
     var pxCheck = function pxCheck(value) {
         return Number.isNaN(Number(value)) ? String(value) : (0, _pxtransform.pxTransform)(+value);
     };
@@ -74,8 +76,11 @@ var Image = function Image(props) {
         if (!isError) return null;
         if (typeof error === 'boolean' && error === true && !innerLoading) {
             return /*#__PURE__*/ _react.default.createElement(_components.View, {
-                className: "".concat(classPrefix, "-error")
-            }, /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.ImageError, null));
+                className: "".concat(classPrefix, "-error"),
+                ariaLabel: locale.image.errorTip || ''
+            }, /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.ImageError, {
+                ariaHidden: true
+            }));
         }
         if (/*#__PURE__*/ _react.default.isValidElement(error) && !innerLoading) {
             return /*#__PURE__*/ _react.default.createElement(_components.View, {
@@ -86,7 +91,8 @@ var Image = function Image(props) {
     }, [
         error,
         isError,
-        innerLoading
+        innerLoading,
+        locale
     ]);
     var renderLoading = (0, _react.useCallback)(function() {
         if (!loading) return null;
@@ -112,6 +118,8 @@ var Image = function Image(props) {
         className: (0, _classnames.default)("".concat(classPrefix, "-default"), className && "".concat(className, "-image"), (0, _define_property._)({}, "".concat(classPrefix, "-error"), isError)),
         style: imgStyle,
         src: src,
+        // @ts-ignore
+        ariaHidden: isError,
         onLoad: function onLoad(e) {
             return handleLoad(e);
         },

package/dist/cjs/packages/input/input.js

@@ -202,7 +202,9 @@ var Input = /*#__PURE__*/ (0, _react.forwardRef)(function(props, ref) {
         confirmType: confirmType,
         onBlur: handleBlur,
         onFocus: handleFocus,
-        onInput: handleInput
+        onInput: handleInput,
+        ariaLabel: props.ariaLabel || // eslint-disable-next-line no-nested-ternary
+        (value ? undefined : placeholder === undefined ? locale.placeholder : placeholder)
     })), /*#__PURE__*/ _react.default.createElement(_components.View, {
         style: {
             display: clearable && !readOnly && active && value.length > 0 ? 'flex' : 'none',
@@ -215,8 +217,13 @@ var Input = /*#__PURE__*/ (0, _react.forwardRef)(function(props, ref) {
                 setValue('');
                 onClear === null || onClear === void 0 ? void 0 : onClear('');
             }
-        }
-    }, clearIcon || /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.MaskClose, {
+        },
+        ariaRole: "button",
+        ariaLabel: locale.clear || '清除'
+    }, clearIcon ? /*#__PURE__*/ _react.default.cloneElement(clearIcon, {
+        ariaHidden: true
+    }) : /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.MaskClose, {
+        ariaHidden: true,
         className: "nut-input-clear"
     })));
 });

package/dist/cjs/packages/progress/progress.js

@@ -33,7 +33,7 @@ var defaultProps = (0, _object_spread_props._)((0, _object_spread._)({}, _typing
 });
 var Progress = function Progress(props) {
     var rtl = (0, _index.useRtl)();
-    var _ref = (0, _object_spread._)({}, defaultProps, props), className = _ref.className, style = _ref.style, percent = _ref.percent, background = _ref.background, color = _ref.color, strokeWidth = _ref.strokeWidth, showText = _ref.showText, animated = _ref.animated, children = _ref.children, lazy = _ref.lazy, delay = _ref.delay, showInfo = _ref.showInfo, borderRadius = _ref.borderRadius, fontSize = _ref.fontSize, activeColor = _ref.activeColor, backgroundColor = _ref.backgroundColor, active = _ref.active, activeMode = _ref.activeMode, duration = _ref.duration, ariaLabel = _ref.ariaLabel, onActiveEnd = _ref.onActiveEnd, rest = (0, _object_without_properties._)(_ref, [
+    var _ref = (0, _object_spread._)({}, defaultProps, props), className = _ref.className, style = _ref.style, percent = _ref.percent, background = _ref.background, color = _ref.color, strokeWidth = _ref.strokeWidth, showText = _ref.showText, animated = _ref.animated, children = _ref.children, lazy = _ref.lazy, delay = _ref.delay, showInfo = _ref.showInfo, borderRadius = _ref.borderRadius, fontSize = _ref.fontSize, activeColor = _ref.activeColor, backgroundColor = _ref.backgroundColor, active = _ref.active, activeMode = _ref.activeMode, duration = _ref.duration, onActiveEnd = _ref.onActiveEnd, rest = (0, _object_without_properties._)(_ref, [
         "className",
         "style",
         "percent",
@@ -53,7 +53,6 @@ var Progress = function Progress(props) {
         "active",
         "activeMode",
         "duration",
-        "ariaLabel",
         "onActiveEnd"
     ]);
     var classPrefix = 'nut-progress';
@@ -220,8 +219,7 @@ var Progress = function Progress(props) {
         ref: progressRef,
         id: selector,
         className: (0, _classnames.default)(classPrefix, className),
-        style: style,
-        "aria-label": ariaLabel
+        style: style
     }, rest), /*#__PURE__*/ _react.default.createElement(_components.View, {
         className: "".concat(classPrefix, "-outer"),
         style: stylesOuter

package/dist/cjs/packages/quickenter/quickenter.js

@@ -21,18 +21,18 @@ var _taro = /*#__PURE__*/ _interop_require_default._(require("@tarojs/taro"));
 var _classnames = /*#__PURE__*/ _interop_require_default._(require("classnames"));
 var _iconsreacttaro = require("@nutui/icons-react-taro");
 var _index = /*#__PURE__*/ _interop_require_default._(require("../popup/index"));
-var _index1 = /*#__PURE__*/ _interop_require_default._(require("../safearea/index"));
 var _typings = require("../../utils/typings");
 var _usepropsvalue = require("../../hooks/use-props-value");
-var _index2 = /*#__PURE__*/ _interop_require_default._(require("../badge/index"));
+var _index1 = /*#__PURE__*/ _interop_require_default._(require("../badge/index"));
 var _configprovider = require("../configprovider");
 var defaultProps = (0, _object_spread_props._)((0, _object_spread._)({}, _typings.ComponentDefaults), {
     options: [],
     visible: false,
-    closeOnOverlayClick: true
+    closeOnOverlayClick: true,
+    safeAreaInsetTop: true
 });
 var InternalQuickEnter = function InternalQuickEnter(props, ref) {
-    var _ref = (0, _object_spread._)({}, defaultProps, props), children = _ref.children, visible = _ref.visible, title = _ref.title, _ref_options = _ref.options, options = _ref_options === void 0 ? [] : _ref_options, closeOnOverlayClick = _ref.closeOnOverlayClick, _ref_popupProps = _ref.popupProps, popupProps = _ref_popupProps === void 0 ? {} : _ref_popupProps, className = _ref.className, style = _ref.style, onClose = _ref.onClose, onChange = _ref.onChange, closeIcon = _ref.closeIcon, rest = (0, _object_without_properties._)(_ref, [
+    var _ref = (0, _object_spread._)({}, defaultProps, props), children = _ref.children, visible = _ref.visible, title = _ref.title, _ref_options = _ref.options, options = _ref_options === void 0 ? [] : _ref_options, closeOnOverlayClick = _ref.closeOnOverlayClick, _ref_popupProps = _ref.popupProps, popupProps = _ref_popupProps === void 0 ? {} : _ref_popupProps, className = _ref.className, style = _ref.style, onClose = _ref.onClose, onChange = _ref.onChange, closeIcon = _ref.closeIcon, safeAreaInsetTop = _ref.safeAreaInsetTop, rest = (0, _object_without_properties._)(_ref, [
         "children",
         "visible",
         "title",
@@ -43,12 +43,15 @@ var InternalQuickEnter = function InternalQuickEnter(props, ref) {
         "style",
         "onClose",
         "onChange",
-        "closeIcon"
+        "closeIcon",
+        "safeAreaInsetTop"
     ]);
     var locale = (0, _configprovider.useConfig)().locale;
     var mergedTitle = title || locale.quickenter.title;
     var classPrefix = 'nut-quickenter';
-    var classes = (0, _classnames.default)(classPrefix, className);
+    var classes = (0, _classnames.default)(classPrefix, className, {
+        'safe-area-top': safeAreaInsetTop
+    });
     var _usePropsValue = (0, _sliced_to_array._)((0, _usepropsvalue.usePropsValue)({
         value: props.visible,
         defaultValue: false,
@@ -93,7 +96,9 @@ var InternalQuickEnter = function InternalQuickEnter(props, ref) {
                 e.stopPropagation();
                 onCancelEvent();
             }
-        }, closeIcon || /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.Close, null)));
+        }, closeIcon || /*#__PURE__*/ _react.default.createElement(_iconsreacttaro.Close, {
+            ariaLabel: locale.close
+        })));
     };
     var renderContent = function renderContent() {
         return /*#__PURE__*/ _react.default.createElement(_components.View, {
@@ -101,20 +106,23 @@ var InternalQuickEnter = function InternalQuickEnter(props, ref) {
         }, /*#__PURE__*/ _react.default.createElement(_components.View, {
             className: "".concat(classPrefix, "-list")
         }, options.map(function(item, index) {
-            var _item_badgeProps;
-            var _item_badge;
+            var _item_badgeProps, _item_badgeProps1;
+            var _item_badge, _item_badge1;
             return /*#__PURE__*/ _react.default.createElement(_components.View, {
                 key: index,
                 className: "".concat(classPrefix, "-item"),
+                ariaLabel: "".concat(item.title, " ").concat((_item_badge = item.badge) !== null && _item_badge !== void 0 ? _item_badge : (_item_badgeProps = item.badgeProps) === null || _item_badgeProps === void 0 ? void 0 : _item_badgeProps.value),
                 onClick: function onClick() {
                     return handleItemClick(item, index);
                 }
             }, /*#__PURE__*/ _react.default.createElement(_components.View, {
-                className: "".concat(classPrefix, "-item-icon")
-            }, /*#__PURE__*/ _react.default.createElement(_index2.default, (0, _object_spread_props._)((0, _object_spread._)({}, item.badgeProps), {
-                value: (_item_badge = item.badge) !== null && _item_badge !== void 0 ? _item_badge : (_item_badgeProps = item.badgeProps) === null || _item_badgeProps === void 0 ? void 0 : _item_badgeProps.value
+                className: "".concat(classPrefix, "-item-icon"),
+                ariaHidden: true
+            }, /*#__PURE__*/ _react.default.createElement(_index1.default, (0, _object_spread_props._)((0, _object_spread._)({}, item.badgeProps), {
+                value: (_item_badge1 = item.badge) !== null && _item_badge1 !== void 0 ? _item_badge1 : (_item_badgeProps1 = item.badgeProps) === null || _item_badgeProps1 === void 0 ? void 0 : _item_badgeProps1.value
             }), item.icon)), /*#__PURE__*/ _react.default.createElement(_components.View, {
-                className: "".concat(classPrefix, "-item-title")
+                className: "".concat(classPrefix, "-item-title"),
+                ariaHidden: true
             }, item.title));
         })));
     };
@@ -139,8 +147,6 @@ var InternalQuickEnter = function InternalQuickEnter(props, ref) {
             onCancelEvent();
         },
         onClose: onCancelEvent
-    }), /*#__PURE__*/ _react.default.createElement(_index1.default, {
-        position: "top"
     }), renderQuickEnterElement()));
 };
 var QuickEnter = /*#__PURE__*/ _react.default.forwardRef(InternalQuickEnter);

package/dist/cjs/packages/quickenter/style/quickenter.scss

@@ -1,6 +1,7 @@
 .nut-quickenter {
   width: 100%;
-  max-height: $quickenter-max-height; // Limit height for scrolling
+  /* 限制弹层最大高度，包含安全区 */
+  max-height: calc(#{$quickenter-max-height} + env(safe-area-inset-top, 0));
   background: $quickenter-bg-color;
   border-radius: 0 0 12px 12px;
   overflow: hidden;
@@ -10,6 +11,13 @@
   box-shadow: $quickenter-box-shadow;
   // backdrop-filter: $quickenter-backdrop-filter;
 
+  &.safe-area-top {
+    /* 使用 env fallback，确保旧浏览器返回 0 */
+    padding-top: calc(
+      env(safe-area-inset-top, 0) * var(--nutui-safe-area-multiple, 1)
+    );
+  }
+
   &-control {
     display: flex;
     align-items: center;
@@ -44,7 +52,7 @@
   &-content {
     flex: 1;
     padding: 10px 28px;
-    overflow-y: hidden; // Default: no scrolling
+    overflow-y: hidden; // 始终可滚动，防止内容被遮挡
     box-sizing: border-box;
 
     &-scrollable {

package/dist/cjs/packages/quickenter/style/style.css

@@ -1,10 +1,12 @@
+@charset "UTF-8";
 /* #ifdef harmony */
 /* #endif */
 /* #ifndef harmony */
 /* #endif */
 .nut-quickenter {
   width: 100%;
-  max-height: var(--nutui-quickenter-max-height, 256px);
+  /* 限制弹层最大高度，包含安全区 */
+  max-height: calc(var(--nutui-quickenter-max-height, 256px) + env(safe-area-inset-top, 0));
   background: var(--nutui-quickenter-bg-color, #f5f5f5);
   border-radius: 0 0 12px 12px;
   overflow: hidden;
@@ -13,6 +15,10 @@
   flex-direction: column;
   box-shadow: var(--nutui-quickenter-box-shadow, 0px 8px 16px rgba(141, 153, 167, 0.2), 0px -0.5px 0px rgba(0, 0, 0, 0.05) inset);
 }
+.nut-quickenter.safe-area-top {
+  /* 使用 env fallback，确保旧浏览器返回 0 */
+  padding-top: calc(env(safe-area-inset-top, 0) * var(--nutui-safe-area-multiple, 1));
+}
 .nut-quickenter-control {
   display: flex;
   align-items: center;