@oceanbase/design 1.0.0-alpha.2 → 1.0.0-alpha.21

package/es/filter/components/FilterSlot.d.ts

@@ -0,0 +1,28 @@
+import type { FC, ReactNode } from 'react';
+import type { BaseFilterProps, InternalFilterProps } from '../type';
+export interface FilterSlotProps extends BaseFilterProps, InternalFilterProps {
+    /**
+     * 直接渲染的自定义内容，不包裹 FilterButton + Popover。
+     * Filter.Slot 仅作为响应式收集的包裹容器，
+     * 会通过 cloneElement 自动注入 value/onChange。
+     */
+    children?: ReactNode;
+    /**
+     * Popover 弹框中的自定义筛选内容。
+     * 设置后使用 FilterButton + Popover 模式，
+     * 会通过 cloneElement 自动注入 value/onChange。
+     */
+    dropdownRender?: ReactNode;
+    /** 当前筛选值（受控） */
+    value?: any;
+    /** 默认筛选值（非受控） */
+    defaultValue?: any;
+    /** 值变化回调 */
+    onChange?: (value: any) => void;
+    /** 将 value 格式化为展示文本，用于 FilterButton 标签和折叠态 Tooltip */
+    formatValue?: (value: any) => string;
+    /** 未选值时的占位文本 */
+    placeholder?: string;
+}
+declare const FilterSlot: FC<FilterSlotProps>;
+export default FilterSlot;

package/es/filter/components/FilterSlot.js

@@ -0,0 +1,189 @@
+"use client";
+var _excluded = ["children", "dropdownRender", "value", "defaultValue", "onChange", "formatValue", "placeholder", "icon", "label", "bordered", "loading", "_isCollapsed"],
+  _excluded2 = ["onOpenChange"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import React, { isValidElement, useCallback, useEffect, useMemo, useRef } from 'react';
+import theme from "../../theme";
+import { useControlledState } from "../hooks/useControlledState";
+import { useFilterContext } from "../FilterContext";
+import { useFilterCollapsed } from "../hooks/useFilterCollapsed";
+import { useFilterTooltip } from "../hooks/useFilterTooltip";
+import useFilterStyle, { getFilterCls } from "../style";
+import { generateFilterId, getPlaceholder, getWrappedValueStyle, wrapContent } from "../utils";
+import FilterButton from "./FilterButton";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment } from "react/jsx-runtime";
+var FilterSlot = function FilterSlot(_ref) {
+  var children = _ref.children,
+    dropdownRender = _ref.dropdownRender,
+    value = _ref.value,
+    defaultValue = _ref.defaultValue,
+    onChange = _ref.onChange,
+    formatValue = _ref.formatValue,
+    placeholder = _ref.placeholder,
+    icon = _ref.icon,
+    label = _ref.label,
+    _ref$bordered = _ref.bordered,
+    bordered = _ref$bordered === void 0 ? true : _ref$bordered,
+    _ref$loading = _ref.loading,
+    loading = _ref$loading === void 0 ? false : _ref$loading,
+    _ref$_isCollapsed = _ref._isCollapsed,
+    _isCollapsed = _ref$_isCollapsed === void 0 ? false : _ref$_isCollapsed,
+    restProps = _objectWithoutProperties(_ref, _excluded);
+  var isCollapsed = useFilterCollapsed(_isCollapsed);
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token;
+  var _useFilterStyle = useFilterStyle(),
+    prefixCls = _useFilterStyle.prefixCls;
+  var filterButtonRef = useRef(null);
+  var _useFilterContext = useFilterContext(),
+    updateFilterValue = _useFilterContext.updateFilterValue;
+  var filterId = useMemo(function () {
+    return generateFilterId('slot', label);
+  }, [label]);
+  var externalOnOpenChange = restProps.onOpenChange,
+    filterButtonProps = _objectWithoutProperties(restProps, _excluded2);
+  var _useControlledState = useControlledState(value, defaultValue, onChange),
+    _useControlledState2 = _slicedToArray(_useControlledState, 2),
+    currentValue = _useControlledState2[0],
+    setValue = _useControlledState2[1];
+  var hasValue = currentValue !== undefined && currentValue !== null && currentValue !== '';
+  var formattedText = hasValue && formatValue ? formatValue(currentValue) : '';
+  var displayText = hasValue ? formattedText || String(currentValue) : '';
+  var currentLabel = hasValue && displayText ? displayText : label;
+  var isDirectRender = !dropdownRender;
+  var _useFilterTooltip = useFilterTooltip({
+      hasValue: hasValue,
+      label: label,
+      content: displayText || null,
+      disabled: isCollapsed || isDirectRender
+    }),
+    onPopoverOpenChange = _useFilterTooltip.onPopoverOpenChange,
+    wrapWithTooltip = _useFilterTooltip.wrapWithTooltip;
+  var handlePopoverOpenChange = function handlePopoverOpenChange(open) {
+    onPopoverOpenChange(open);
+    externalOnOpenChange === null || externalOnOpenChange === void 0 || externalOnOpenChange(open);
+  };
+  useEffect(function () {
+    if (isCollapsed && updateFilterValue) {
+      updateFilterValue(filterId, label, currentValue, [{
+        formattedText: formattedText
+      }], 'slot');
+    }
+  }, [isCollapsed, updateFilterValue, filterId, label, currentValue, formattedText]);
+  var handleClear = function handleClear() {
+    setValue(undefined);
+  };
+  var handleChildChange = useCallback(function () {
+    var firstArg = arguments.length <= 0 ? undefined : arguments[0];
+    var newValue;
+    if (firstArg && _typeof(firstArg) === 'object' && 'target' in firstArg && _typeof(firstArg.target) === 'object') {
+      newValue = 'value' in firstArg.target ? firstArg.target.value : firstArg.target.checked;
+    } else {
+      newValue = firstArg;
+    }
+    setValue(newValue);
+  }, [setValue]);
+  var injectValueProps = useCallback(function (element) {
+    if ( /*#__PURE__*/isValidElement(element)) {
+      var _childElement$props;
+      var childElement = element;
+      var originalOnChange = (_childElement$props = childElement.props) === null || _childElement$props === void 0 ? void 0 : _childElement$props.onChange;
+      return /*#__PURE__*/React.cloneElement(childElement, {
+        value: currentValue,
+        onChange: function onChange() {
+          for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+            args[_key] = arguments[_key];
+          }
+          handleChildChange.apply(void 0, args);
+          originalOnChange === null || originalOnChange === void 0 || originalOnChange.apply(void 0, args);
+        }
+      });
+    }
+    return element;
+  }, [currentValue, handleChildChange]);
+
+  // ======== 直接渲染模式（仅 children，无 dropdownRender） ========
+  if (isDirectRender) {
+    if (isCollapsed) {
+      return /*#__PURE__*/_jsxs("div", {
+        style: {
+          paddingBlock: token.paddingXXS
+        },
+        children: [/*#__PURE__*/_jsx("div", {
+          style: {
+            marginBottom: 8
+          },
+          children: label
+        }), injectValueProps(children)]
+      });
+    }
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: injectValueProps(children)
+    });
+  }
+
+  // ======== Popover 模式（设置了 dropdownRender） ========
+  var wrappedContent = wrapContent(injectValueProps(dropdownRender));
+  if (isCollapsed) {
+    return /*#__PURE__*/_jsxs("div", {
+      style: {
+        paddingBlock: token.paddingXXS
+      },
+      children: [/*#__PURE__*/_jsx("div", {
+        style: {
+          marginBottom: 8
+        },
+        children: label
+      }), /*#__PURE__*/_jsx(FilterButton, _objectSpread(_objectSpread({
+        ref: filterButtonRef,
+        icon: icon,
+        label: label,
+        bordered: bordered,
+        onClear: handleClear,
+        content: wrappedContent,
+        loading: loading,
+        selected: hasValue,
+        onOpenChange: handlePopoverOpenChange
+      }, filterButtonProps), {}, {
+        children: /*#__PURE__*/_jsx("span", {
+          className: getFilterCls(prefixCls, 'text-ellipsis'),
+          style: getWrappedValueStyle(hasValue),
+          children: hasValue ? displayText : placeholder || getPlaceholder()
+        })
+      }))]
+    });
+  }
+  var filterButton = /*#__PURE__*/_jsx(FilterButton, _objectSpread(_objectSpread({
+    ref: filterButtonRef,
+    icon: icon,
+    label: label,
+    bordered: bordered,
+    onClear: handleClear,
+    content: wrappedContent,
+    loading: loading,
+    selected: hasValue,
+    onOpenChange: handlePopoverOpenChange
+  }, filterButtonProps), {}, {
+    children: /*#__PURE__*/_jsx("span", {
+      className: getFilterCls(prefixCls, 'text-ellipsis'),
+      children: hasValue ? currentLabel : placeholder || label
+    })
+  }));
+  return wrapWithTooltip(filterButton);
+};
+export default FilterSlot;

package/es/filter/components/FilterSwitch.d.ts

@@ -0,0 +1,13 @@
+import type { FC } from 'react';
+import { type SwitchProps } from '../../switch';
+import type { BaseFilterProps } from '../type';
+export interface FilterSwitchProps extends BaseFilterProps {
+    /** 当前值 */
+    value?: boolean;
+    /** 值变化回调 */
+    onChange?: (value: boolean) => void;
+    /** Switch 组件的额外属性 */
+    switchProps?: SwitchProps;
+}
+declare const FilterSwitch: FC<FilterSwitchProps>;
+export default FilterSwitch;

package/es/filter/components/FilterSwitch.js

@@ -0,0 +1,102 @@
+"use client";
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["value", "onChange", "icon", "label", "bordered", "switchProps"];
+function _objectDestructuringEmpty(obj) { if (obj == null) throw new TypeError("Cannot destructure " + obj); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import { useEffect, useMemo } from 'react';
+import { Flex } from 'antd';
+import theme from "../../theme";
+import Switch from "../../switch";
+import { useControlledState } from "../hooks/useControlledState";
+import { useFilterContext } from "../FilterContext";
+import { useFilterCollapsed } from "../hooks/useFilterCollapsed";
+import { generateFilterId, wrapContent } from "../utils";
+import FilterButton from "./FilterButton";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { jsxs as _jsxs } from "react/jsx-runtime";
+var FilterSwitch = function FilterSwitch(_ref) {
+  var value = _ref.value,
+    onChange = _ref.onChange,
+    icon = _ref.icon,
+    label = _ref.label,
+    _ref$bordered = _ref.bordered,
+    bordered = _ref$bordered === void 0 ? true : _ref$bordered,
+    switchProps = _ref.switchProps,
+    restProps = _objectWithoutProperties(_ref, _excluded);
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token;
+  var isCollapsed = useFilterCollapsed();
+  var _useFilterContext = useFilterContext(),
+    updateFilterValue = _useFilterContext.updateFilterValue;
+  var filterId = useMemo(function () {
+    return generateFilterId('switch', label);
+  }, [label]);
+
+  // 支持从 Form.Item 通过 `valuePropName="checked"` 传入的 checked 属性
+  var propChecked = restProps.checked;
+
+  // 使用受控状态 hook：优先使用明确的 value，其次使用 checked（来自 Form.Item）
+  var _useControlledState = useControlledState(value !== undefined ? value : propChecked, false, onChange),
+    _useControlledState2 = _slicedToArray(_useControlledState, 2),
+    currentValue = _useControlledState2[0],
+    setValue = _useControlledState2[1];
+
+  // 当值变化时，更新 context 中的值
+  useEffect(function () {
+    if (isCollapsed && updateFilterValue) {
+      updateFilterValue(filterId, label, currentValue, undefined, 'switch');
+    }
+  }, [isCollapsed, updateFilterValue, filterId, label, currentValue]);
+  var handleClear = function handleClear() {
+    setValue(false);
+  };
+
+  // 渲染弹框内容
+  var renderContent = /*#__PURE__*/_jsxs(Flex, {
+    justify: "space-between",
+    align: "center",
+    style: {
+      paddingBlock: token.paddingXXS
+    },
+    children: [/*#__PURE__*/_jsx("span", {
+      children: label
+    }), /*#__PURE__*/_jsx(Switch, _objectSpread({
+      checked: currentValue,
+      onChange: setValue,
+      size: "small"
+    }, switchProps))]
+  });
+
+  // 如果处于折叠模式，只渲染内容部分
+  if (isCollapsed) {
+    return renderContent;
+  }
+  var wrappedContent = wrapContent(renderContent, '8px 12px');
+
+  // 从 restProps 中排除不需要的属性，避免类型冲突
+  var filterButtonProps = Object.assign({}, (_objectDestructuringEmpty(restProps), restProps));
+  return /*#__PURE__*/_jsx(FilterButton, _objectSpread(_objectSpread({
+    icon: icon,
+    label: label,
+    bordered: bordered,
+    onClear: handleClear,
+    content: wrappedContent
+  }, filterButtonProps), {}, {
+    children: /*#__PURE__*/_jsx("span", {
+      children: label
+    })
+  }));
+};
+export default FilterSwitch;

package/es/filter/components/FilterWrap.d.ts

@@ -0,0 +1,20 @@
+import type { FC, ReactNode } from 'react';
+import React from 'react';
+import type { BaseFilterProps } from '../type';
+import type { FilterButtonRef } from './FilterButton';
+export interface FilterWrapProps extends Omit<BaseFilterProps, 'label'> {
+    children: ReactNode;
+    label?: ReactNode;
+    /** 是否折叠模式（使用弹框包裹所有子元素），默认 false */
+    collapsed?: boolean;
+    /** 额外内容 */
+    extra?: ReactNode;
+    filterButtonRef?: React.RefObject<FilterButtonRef>;
+    gap?: number;
+    /** 是否显示计数 默认 true */
+    showCount?: boolean;
+    /** 点击清除所有按钮时的回调 */
+    onClearAll?: () => void;
+}
+declare const FilterWrap: FC<FilterWrapProps>;
+export default FilterWrap;