@bifrostui/react 2.0.0-alpha.0 → 2.0.0-alpha.10

package/dist/Drawer/__tests__/fixtures/A11yDemos.js

@@ -0,0 +1,148 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var A11yDemos_exports = {};
+__export(A11yDemos_exports, {
+  basicDrawerDemo: () => basicDrawerDemo,
+  default: () => A11yDemos_default,
+  interactiveDrawerDemo: () => interactiveDrawerDemo,
+  leftDrawerDemo: () => leftDrawerDemo,
+  noBackdropDrawerDemo: () => noBackdropDrawerDemo,
+  rightDrawerDemo: () => rightDrawerDemo,
+  topDrawerDemo: () => topDrawerDemo
+});
+module.exports = __toCommonJS(A11yDemos_exports);
+var import_react = __toESM(require("react"));
+var import_Drawer = __toESM(require("../../Drawer"));
+const basicDrawerDemo = () => {
+  return /* @__PURE__ */ import_react.default.createElement(import_Drawer.default, { open: true, anchor: "bottom", "aria-label": "\u57FA\u7840\u62BD\u5C49", disablePortal: true }, /* @__PURE__ */ import_react.default.createElement("div", { style: { padding: "20px", minHeight: "200px" } }, /* @__PURE__ */ import_react.default.createElement("h3", null, "\u57FA\u7840\u62BD\u5C49\u5185\u5BB9"), /* @__PURE__ */ import_react.default.createElement("p", null, "\u8FD9\u662F\u4E00\u4E2A\u4ECE\u5E95\u90E8\u5F39\u51FA\u7684\u62BD\u5C49"), /* @__PURE__ */ import_react.default.createElement("button", { type: "button" }, "\u786E\u8BA4"), /* @__PURE__ */ import_react.default.createElement("button", { type: "button" }, "\u53D6\u6D88")));
+};
+const leftDrawerDemo = () => {
+  return /* @__PURE__ */ import_react.default.createElement(import_Drawer.default, { open: true, anchor: "left", "aria-label": "\u5DE6\u4FA7\u62BD\u5C49", disablePortal: true }, /* @__PURE__ */ import_react.default.createElement("div", { style: { padding: "20px", width: "300px", minHeight: "100vh" } }, /* @__PURE__ */ import_react.default.createElement("h3", null, "\u5DE6\u4FA7\u62BD\u5C49"), /* @__PURE__ */ import_react.default.createElement("ul", null, /* @__PURE__ */ import_react.default.createElement("li", null, /* @__PURE__ */ import_react.default.createElement("a", { href: "#item1" }, "\u83DC\u5355\u9879 1")), /* @__PURE__ */ import_react.default.createElement("li", null, /* @__PURE__ */ import_react.default.createElement("a", { href: "#item2" }, "\u83DC\u5355\u9879 2")), /* @__PURE__ */ import_react.default.createElement("li", null, /* @__PURE__ */ import_react.default.createElement("a", { href: "#item3" }, "\u83DC\u5355\u9879 3")))));
+};
+const rightDrawerDemo = () => {
+  return /* @__PURE__ */ import_react.default.createElement(import_Drawer.default, { open: true, anchor: "right", "aria-label": "\u53F3\u4FA7\u62BD\u5C49", disablePortal: true }, /* @__PURE__ */ import_react.default.createElement("div", { style: { padding: "20px", width: "300px", minHeight: "100vh" } }, /* @__PURE__ */ import_react.default.createElement("h3", null, "\u53F3\u4FA7\u62BD\u5C49"), /* @__PURE__ */ import_react.default.createElement("form", null, /* @__PURE__ */ import_react.default.createElement("div", { style: { marginBottom: "10px" } }, /* @__PURE__ */ import_react.default.createElement("label", { htmlFor: "name" }, "\u59D3\u540D:"), /* @__PURE__ */ import_react.default.createElement("input", { id: "name", type: "text" })), /* @__PURE__ */ import_react.default.createElement("div", { style: { marginBottom: "10px" } }, /* @__PURE__ */ import_react.default.createElement("label", { htmlFor: "email" }, "\u90AE\u7BB1:"), /* @__PURE__ */ import_react.default.createElement("input", { id: "email", type: "email" })), /* @__PURE__ */ import_react.default.createElement("button", { type: "submit" }, "\u63D0\u4EA4"))));
+};
+const topDrawerDemo = () => {
+  return /* @__PURE__ */ import_react.default.createElement(import_Drawer.default, { open: true, anchor: "top", "aria-label": "\u9876\u90E8\u62BD\u5C49", disablePortal: true }, /* @__PURE__ */ import_react.default.createElement("div", { style: { padding: "20px", minHeight: "200px" } }, /* @__PURE__ */ import_react.default.createElement("h3", null, "\u9876\u90E8\u62BD\u5C49"), /* @__PURE__ */ import_react.default.createElement("p", null, "\u8FD9\u662F\u4E00\u4E2A\u4ECE\u9876\u90E8\u5F39\u51FA\u7684\u62BD\u5C49"), /* @__PURE__ */ import_react.default.createElement("div", null, /* @__PURE__ */ import_react.default.createElement("button", { type: "button" }, "\u64CD\u4F5C\u6309\u94AE 1"), /* @__PURE__ */ import_react.default.createElement("button", { type: "button" }, "\u64CD\u4F5C\u6309\u94AE 2"))));
+};
+const noBackdropDrawerDemo = () => {
+  return /* @__PURE__ */ import_react.default.createElement(
+    import_Drawer.default,
+    {
+      open: true,
+      anchor: "bottom",
+      hideBackdrop: true,
+      "aria-label": "\u65E0\u80CC\u666F\u906E\u7F69\u62BD\u5C49",
+      disablePortal: true
+    },
+    /* @__PURE__ */ import_react.default.createElement("div", { style: { padding: "20px", minHeight: "150px" } }, /* @__PURE__ */ import_react.default.createElement("h3", null, "\u65E0\u80CC\u666F\u906E\u7F69"), /* @__PURE__ */ import_react.default.createElement("p", null, "\u8FD9\u4E2A\u62BD\u5C49\u6CA1\u6709\u80CC\u666F\u906E\u7F69"), /* @__PURE__ */ import_react.default.createElement("button", { type: "button" }, "\u5173\u95ED"))
+  );
+};
+const interactiveDrawerDemo = () => {
+  const InteractiveDrawerDemo = () => {
+    const [open, setOpen] = (0, import_react.useState)(true);
+    const [formData, setFormData] = (0, import_react.useState)({ name: "", message: "" });
+    const handleClose = () => {
+      setOpen(false);
+    };
+    const handleSubmit = (e) => {
+      e.preventDefault();
+      console.log("\u63D0\u4EA4\u8868\u5355:", formData);
+      handleClose();
+    };
+    if (!open) {
+      return /* @__PURE__ */ import_react.default.createElement("button", { type: "button", onClick: () => setOpen(true) }, "\u91CD\u65B0\u6253\u5F00\u62BD\u5C49");
+    }
+    return /* @__PURE__ */ import_react.default.createElement(
+      import_Drawer.default,
+      {
+        open,
+        anchor: "right",
+        onClose: handleClose,
+        "aria-label": "\u53EF\u4EA4\u4E92\u62BD\u5C49",
+        disablePortal: true
+      },
+      /* @__PURE__ */ import_react.default.createElement("div", { style: { padding: "20px", width: "350px" } }, /* @__PURE__ */ import_react.default.createElement("h3", null, "\u53CD\u9988\u8868\u5355"), /* @__PURE__ */ import_react.default.createElement("form", { onSubmit: handleSubmit }, /* @__PURE__ */ import_react.default.createElement("div", { style: { marginBottom: "15px" } }, /* @__PURE__ */ import_react.default.createElement("label", { htmlFor: "feedback-name" }, "\u59D3\u540D:"), /* @__PURE__ */ import_react.default.createElement(
+        "input",
+        {
+          id: "feedback-name",
+          type: "text",
+          value: formData.name,
+          onChange: (e) => setFormData(__spreadProps(__spreadValues({}, formData), { name: e.target.value })),
+          required: true,
+          "aria-required": "true"
+        }
+      )), /* @__PURE__ */ import_react.default.createElement("div", { style: { marginBottom: "15px" } }, /* @__PURE__ */ import_react.default.createElement("label", { htmlFor: "feedback-message" }, "\u53CD\u9988\u5185\u5BB9:"), /* @__PURE__ */ import_react.default.createElement(
+        "textarea",
+        {
+          id: "feedback-message",
+          value: formData.message,
+          onChange: (e) => setFormData(__spreadProps(__spreadValues({}, formData), { message: e.target.value })),
+          required: true,
+          "aria-required": "true",
+          rows: 4
+        }
+      )), /* @__PURE__ */ import_react.default.createElement("div", null, /* @__PURE__ */ import_react.default.createElement("button", { type: "submit" }, "\u63D0\u4EA4\u53CD\u9988"), /* @__PURE__ */ import_react.default.createElement("button", { type: "button", onClick: handleClose }, "\u53D6\u6D88"))))
+    );
+  };
+  return /* @__PURE__ */ import_react.default.createElement(InteractiveDrawerDemo, null);
+};
+var A11yDemos_default = {
+  basicDrawerDemo,
+  leftDrawerDemo,
+  rightDrawerDemo,
+  topDrawerDemo,
+  noBackdropDrawerDemo,
+  interactiveDrawerDemo
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  basicDrawerDemo,
+  interactiveDrawerDemo,
+  leftDrawerDemo,
+  noBackdropDrawerDemo,
+  rightDrawerDemo,
+  topDrawerDemo
+});

package/dist/Fade/Fade.js

@@ -102,7 +102,7 @@ const Fade = /* @__PURE__ */ import_react.default.forwardRef(
         ref: nodeRef
       }),
       (state, childProps) => {
-        const transition = transitions.create(
+        const transition = state === "entering" || state === "exiting" ? transitions.create(
           "opacity",
           (0, import_utils.getTransitionProps)(
             { timeout, style, easing: easingProp, delay },
@@ -110,7 +110,7 @@ const Fade = /* @__PURE__ */ import_react.default.forwardRef(
               mode: state
             }
           )
-        );
+        ) : "none";
         return import_react.default.cloneElement(children, __spreadValues({
           style: __spreadValues(__spreadValues({
             visibility: state === "exited" ? "hidden" : "visible",

package/dist/Fade/Fade.miniapp.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fade Animation Component
+ * @description A component that implements fade in/out animation effects for elements
+ * @component Fade
+ */
+import React from 'react';
+import type { FadeProps } from './Fade.types';
+import './index.less';
+declare const Fade: React.ForwardRefExoticComponent<FadeProps & React.RefAttributes<HTMLElement>>;
+export default Fade;

package/dist/Fade/Fade.miniapp.js

@@ -0,0 +1,200 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Fade_miniapp_exports = {};
+__export(Fade_miniapp_exports, {
+  default: () => Fade_miniapp_default
+});
+module.exports = __toCommonJS(Fade_miniapp_exports);
+var import_react = __toESM(require("react"));
+var import_utils = require("@bifrostui/utils");
+var import_index = require("./index.css");
+const defaultEasing = {
+  enter: import_utils.easing.easeOut,
+  exit: import_utils.easing.sharp
+};
+const defaultTimeout = {
+  enter: import_utils.duration.enteringScreen,
+  exit: import_utils.duration.leavingScreen
+};
+const Fade = /* @__PURE__ */ import_react.default.forwardRef((props, ref) => {
+  var _b;
+  const _a = props, {
+    children: children,
+    in: inProp,
+    style,
+    appear: appear = true,
+    enter = true,
+    exit = true,
+    delay = 0,
+    easing: easingProp = defaultEasing,
+    timeout = defaultTimeout,
+    mountOnEnter: mountOnEnter,
+    unmountOnExit,
+    onEnter: onEnter,
+    onEntering,
+    onEntered,
+    onExit,
+    onExiting,
+    onExited
+  } = _a, others = __objRest(_a, [
+    // Base props
+    "children",
+    "in",
+    "style",
+    // Animation controls
+    "appear",
+    "enter",
+    "exit",
+    "delay",
+    "easing",
+    "timeout",
+    // Lifecycle hooks
+    "mountOnEnter",
+    "unmountOnExit",
+    // Animation callbacks
+    "onEnter",
+    "onEntering",
+    "onEntered",
+    "onExit",
+    "onExiting",
+    "onExited"
+  ]);
+  const isFirstMount = (0, import_react.useRef)(inProp || !mountOnEnter);
+  const [isMounted, setIsMounted] = (0, import_react.useState)(inProp || !mountOnEnter);
+  const elementRef = (0, import_react.useRef)(null);
+  const handleRef = (0, import_utils.useForkRef)(ref, children == null ? void 0 : children.ref, elementRef);
+  const shouldAnimateOnFirstMount = inProp && appear;
+  const shouldAnimate = inProp && enter || !inProp && exit;
+  const shouldExecuteAnimation = isFirstMount.current ? shouldAnimateOnFirstMount : shouldAnimate;
+  const getAnimationDurationAndDelay = () => {
+    if (!shouldExecuteAnimation) {
+      return { timeout: 0, delay: 0 };
+    }
+    return { timeout, delay };
+  };
+  const shouldSkipFirstAnimation = isFirstMount.current && !shouldAnimateOnFirstMount;
+  const transitions = (0, import_utils.createTransitions)();
+  const animationName = inProp ? "bui-fade-in" : "bui-fade-out";
+  const animationDurationAndDelay = getAnimationDurationAndDelay();
+  const animation = (0, import_react.useMemo)(
+    () => transitions.create(
+      animationName,
+      (0, import_utils.getTransitionProps)(
+        __spreadProps(__spreadValues({}, animationDurationAndDelay), {
+          style,
+          easing: easingProp
+        }),
+        { mode: inProp ? "enter" : "exit" }
+      )
+    ),
+    [inProp, animationName, animationDurationAndDelay, easingProp, style]
+  );
+  (0, import_react.useEffect)(() => {
+    if (inProp && !isMounted) {
+      setIsMounted(true);
+    }
+  }, [inProp, isMounted]);
+  (0, import_react.useEffect)(() => {
+    if (isMounted && isFirstMount.current) {
+      isFirstMount.current = false;
+    }
+  }, [isMounted]);
+  (0, import_react.useEffect)(() => {
+    const shouldTriggerCallback = isMounted && shouldExecuteAnimation;
+    if (!shouldTriggerCallback)
+      return;
+    if (inProp) {
+      onEnter == null ? void 0 : onEnter(elementRef.current);
+    } else {
+      onExit == null ? void 0 : onExit(elementRef.current);
+    }
+  }, [inProp, isMounted]);
+  const handleAnimationStart = () => {
+    if (!shouldExecuteAnimation)
+      return;
+    if (inProp) {
+      onEntering == null ? void 0 : onEntering(elementRef.current);
+    } else {
+      onExiting == null ? void 0 : onExiting(elementRef.current);
+    }
+  };
+  const handleAnimationEnd = () => {
+    if (shouldSkipFirstAnimation)
+      return;
+    if (inProp) {
+      onEntered == null ? void 0 : onEntered(elementRef.current);
+    } else {
+      onExited == null ? void 0 : onExited(elementRef.current);
+      if (unmountOnExit) {
+        setIsMounted(false);
+      }
+    }
+  };
+  if (!children || !isMounted)
+    return null;
+  return import_react.default.cloneElement(children, __spreadProps(__spreadValues({}, others), {
+    ref: handleRef,
+    onAnimationEnd: handleAnimationEnd,
+    onAnimationStart: handleAnimationStart,
+    style: __spreadValues(__spreadValues({
+      animation,
+      animationFillMode: "both"
+    }, style), (_b = children.props) == null ? void 0 : _b.style)
+  }));
+});
+Fade.displayName = "BuiFade";
+var Fade_miniapp_default = Fade;

package/dist/Fade/index.css

@@ -0,0 +1,18 @@
+@keyframes bui-fade-in {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+    visibility: visible;
+  }
+}
+@keyframes bui-fade-out {
+  from {
+    opacity: 1;
+  }
+  to {
+    opacity: 0;
+    visibility: hidden;
+  }
+}

package/dist/IconButton/IconButton.js

@@ -63,15 +63,17 @@ var import_index = require("./index.css");
 const prefixCls = "bui-icon-btn";
 const IconButton = /* @__PURE__ */ import_react.default.forwardRef(
   (props, ref) => {
-    var _b, _c;
+    var _b, _c, _d, _e, _f, _g, _h;
     const _a = props, {
       className,
       children,
-      color = "neutral",
+      color,
       disabled = false,
       size = "medium",
       variant = "default",
-      shape = "circular"
+      shape = "circular",
+      // 无障碍属性
+      "aria-label": ariaLabel
     } = _a, others = __objRest(_a, [
       "className",
       "children",
@@ -79,12 +81,24 @@ const IconButton = /* @__PURE__ */ import_react.default.forwardRef(
       "disabled",
       "size",
       "variant",
-      "shape"
+      "shape",
+      "aria-label"
     ]);
     const isContainedVariant = variant === "contained";
+    let childrenDisplayName = "";
+    const firstChild = (_b = import_react.default.Children.toArray(children)) == null ? void 0 : _b[0];
+    if (import_react.default.isValidElement(firstChild)) {
+      childrenDisplayName = ((_e = (_d = (_c = firstChild.type) == null ? void 0 : _c.type) == null ? void 0 : _d.render) == null ? void 0 : _e.displayName) || "";
+    }
+    const accessibilityProps = {
+      // 描述性文本标签。默认取第一个children的displayName
+      "aria-label": ariaLabel || childrenDisplayName,
+      // 禁用状态
+      "aria-disabled": disabled
+    };
     return /* @__PURE__ */ import_react.default.createElement(
       "button",
-      __spreadValues({
+      __spreadValues(__spreadValues({
         type: "button",
         className: (0, import_clsx.default)(
           prefixCls,
@@ -98,11 +112,12 @@ const IconButton = /* @__PURE__ */ import_react.default.forwardRef(
           className
         ),
         ref
-      }, others),
+      }, accessibilityProps), others),
       import_utils.isMini && import_react.default.isValidElement(children) ? import_react.default.cloneElement(children, __spreadValues(__spreadValues({}, !isContainedVariant && {
-        color: ((_b = children.props) == null ? void 0 : _b.color) || color
+        color: ((_f = children.props) == null ? void 0 : _f.color) || color,
+        htmlColor: ((_g = children.props) == null ? void 0 : _g.htmlColor) || "var(--bui-color-fg-subtle)"
       }), isContainedVariant && {
-        htmlColor: ((_c = children.props) == null ? void 0 : _c.htmlColor) || "var(--bui-color-white)"
+        htmlColor: ((_h = children.props) == null ? void 0 : _h.htmlColor) || "var(--bui-color-white)"
       })) : children
     );
   }

package/dist/IconButton/IconButton.types.d.ts

@@ -10,7 +10,6 @@ export type IconButtonProps<D extends React.ElementType = 'button', P = {}> = Ov
          */
         size?: 'small' | 'medium' | 'large';
         /** 按钮颜色
-         * @default 'neutral'
          */
         color?: ThemeColor;
         /**
@@ -37,6 +36,41 @@ export type IconButtonProps<D extends React.ElementType = 'button', P = {}> = Ov
          * 仅微信小程序支持的button开放能力
          */
         openType?: ButtonOpenType;
+        /**
+         * 提供可访问的名称
+         * 图标按钮必须设置此属性，因为没有可见文本
+         * @example "搜索", "关闭", "菜单", "收藏"
+         */
+        'aria-label'?: string;
+        /**
+         * 禁用状态
+         * @example true - 禁用, false - 开启
+         */
+        'aria-disabled'?: boolean;
+        /**
+         * 切换按钮的按下状态
+         * 用于切换类型的按钮（如收藏、点赞、静音等）
+         * @example true - 已激活, false - 未激活
+         */
+        'aria-pressed'?: boolean;
+        /**
+         * 展开/折叠状态
+         * 用于控制下拉菜单、面板等可展开内容的按钮
+         * @example true - 已展开, false - 已折叠
+         */
+        'aria-expanded'?: boolean;
+        /**
+         * 弹出内容类型
+         * 指示点击按钮后会弹出什么类型的内容
+         * @example "menu" - 弹出菜单, "dialog" - 弹出对话框
+         */
+        'aria-haspopup'?: boolean | 'menu' | 'dialog' | 'listbox';
+        /**
+         * 关联描述该按钮的元素ID
+         * 用于提供额外的说明信息
+         * @example aria-describedby="help-text"
+         */
+        'aria-describedby'?: string;
     };
     defaultComponent: D;
 }, D>;

package/dist/IconButton/index.css

@@ -82,6 +82,9 @@ xhs-page {
 .bui-icon-btn-default.bui-icon-btn-warning {
   color: var(--bui-color-warning);
 }
+.bui-icon-btn-default.bui-icon-btn-danger {
+  color: var(--bui-color-danger);
+}
 .bui-icon-btn-default.bui-icon-btn-light {
   color: var(--bui-color-bg-view);
 }

package/dist/Image/Image.js

@@ -123,14 +123,19 @@ const Image = /* @__PURE__ */ import_react.default.forwardRef(
       setLoaded(false);
       setFailed(false);
     }, [src]);
-    function defaultIconWrap(icon) {
-      return /* @__PURE__ */ import_react.default.createElement("div", { className: `${prefixCls}-default-icon-wrap` }, icon);
-    }
-    const defaultIcon = defaultIconWrap(
-      /* @__PURE__ */ import_react.default.createElement("div", { className: `${prefixCls}-default-icon-item` })
-    );
-    const defaultPlaceholder = placeholder === false ? [] : placeholder !== true && defaultIconWrap(placeholder) || defaultIcon;
-    const defaultFallback = fallback && defaultIconWrap(fallback) || defaultPlaceholder;
+    const defaultIconWrap = (icon) => {
+      return /* @__PURE__ */ import_react.default.createElement(
+        "div",
+        {
+          className: (0, import_clsx.default)(`${prefixCls}-default-icon-wrap`, {
+            "default-holder": !icon
+          }),
+          "aria-hidden": "true"
+        },
+        icon
+      );
+    };
+    const defaultPlaceholder = placeholder === false ? [] : placeholder !== true && defaultIconWrap(placeholder) || defaultIconWrap();
     const miniAttr = {
       webp,
       lazyLoad: lazy,
@@ -151,7 +156,7 @@ const Image = /* @__PURE__ */ import_react.default.forwardRef(
           setFailed(true);
           onError == null ? void 0 : onError(e);
         },
-        alt
+        alt: alt || ""
       }, imgProps), {
         style: __spreadValues({ objectFit: fit }, (imgProps == null ? void 0 : imgProps.style) || {}),
         className: (0, import_clsx.default)(
@@ -163,7 +168,9 @@ const Image = /* @__PURE__ */ import_react.default.forwardRef(
       }), import_utils.isMini ? miniAttr : {})
     );
     function renderImgEle() {
-      return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, failed && defaultFallback || !loaded && defaultPlaceholder || null, imgEle);
+      if (failed)
+        return fallback || defaultPlaceholder;
+      return /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, !loaded && defaultPlaceholder, imgEle);
     }
     return /* @__PURE__ */ import_react.default.createElement(
       "div",

package/dist/Image/__tests__/fixtures/A11yDemos.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+/**
+ * 自定义 Image 组件 Demo 集合
+ * 这个文件包含多个测试 demo，展示如何使用 getCustomDemoCodesFromFile 进行无障碍测试
+ * 文件名必须是 A11yDemos.tsx（固定约定）
+ */
+export declare const basicImageDemo: () => React.JSX.Element;
+export declare const ClickableImageDemo: () => React.JSX.Element;
+export declare const placeholderImageDemo: () => React.JSX.Element;
+export declare const errorImageDemo: () => React.JSX.Element;
+export declare const lazyImageDemo: () => React.JSX.Element;
+export declare const noAltImageDemo: () => React.JSX.Element;
+declare const _default: {
+    basicImageDemo: () => React.JSX.Element;
+    ClickableImageDemo: () => React.JSX.Element;
+    placeholderImageDemo: () => React.JSX.Element;
+    errorImageDemo: () => React.JSX.Element;
+    lazyImageDemo: () => React.JSX.Element;
+    noAltImageDemo: () => React.JSX.Element;
+};
+export default _default;