@seakoi/native-ui 1.2.0 → 1.3.0

package/dist/module/components/base/select/hooks/use-select-options.js

@@ -0,0 +1,162 @@
+"use strict";
+
+import { useMemoizedFn } from 'ahooks';
+import { useMemo } from 'react';
+/**
+ * 判断选项是否为分组
+ *
+ * @template ValueType - 选项值的类型
+ */
+export const isSelectOptionGroup = item => {
+  return 'options' in item;
+};
+export function isSelectFlattenedGroupOption(v) {
+  return !!v.isGroup;
+}
+function isOptionType(v) {
+  return !v.isGroup;
+}
+
+/**
+ * Select 选项处理 Hook 参数
+ *
+ * @template ValueType - 选项值的类型
+ * @template OptionType - 选项类型
+ * @template M - 选择模式
+ * @template RealValueType - 实际值类型
+ */
+
+/**
+ * Select 选项处理 Hook 返回值
+ *
+ * @template ValueType - 选项值的类型
+ * @template OptionType - 选项类型
+ */
+
+/**
+ * Select 选项处理 Hook
+ *
+ * 封装 Select 组件中与选项相关的逻辑,包括:
+ * - 扁平化选项列表
+ * - 过滤选项
+ * - 获取选中的选项
+ * - 判断选项是否被选中
+ *
+ * @example
+ * const {
+ *   allOptions,
+ *   filteredOptions,
+ *   selectedOptions,
+ *   isOptionSelected
+ * } = useSelectOptions({
+ *   options,
+ *   value,
+ *   mode,
+ *   searchValue,
+ *   filterOption: true,
+ *   optionFilterProp: 'label'
+ * });
+ */
+export const useSelectOptions = params => {
+  const {
+    options,
+    value,
+    mode,
+    searchValue,
+    filterOption,
+    filterSort,
+    optionFilterProp
+  } = params;
+
+  // 扁平化选项列表
+  const flattenedOptions = useMemo(() => {
+    const result = [];
+    options.forEach(item => {
+      if (isSelectOptionGroup(item)) {
+        result.push({
+          label: item.label,
+          key: item.key,
+          isGroup: true,
+          groupKey: item.key
+        });
+        item.options.forEach(opt => {
+          result.push({
+            ...opt,
+            groupKey: item.key
+          });
+        });
+      } else {
+        result.push(item);
+      }
+    });
+    return result;
+  }, [options]);
+
+  // 获取所有可选项(不包含分组标题)
+  const allOptions = useMemo(() => {
+    return flattenedOptions.filter(item => !item.isGroup);
+  }, [flattenedOptions]);
+
+  // 过滤选项
+  const filteredOptions = useMemo(() => {
+    if (!searchValue || !filterOption) {
+      return flattenedOptions;
+    }
+    const filterFn = typeof filterOption === 'function' ? filterOption : (input, option) => {
+      const props = Array.isArray(optionFilterProp) ? optionFilterProp : [optionFilterProp || 'label'];
+      return props.some(prop => {
+        const value = option[prop];
+        if (typeof value === 'string') {
+          return value.toLowerCase().includes(input.toLowerCase());
+        }
+        return false;
+      });
+    };
+    const filtered = flattenedOptions.filter(item => {
+      if (isSelectFlattenedGroupOption(item)) return true;
+      return filterFn(searchValue, item);
+    });
+
+    // 排序
+    if (filterSort) {
+      const sortableItems = filtered.filter(item => isOptionType(item));
+      sortableItems.sort((a, b) => filterSort(a, b, {
+        searchValue
+      }));
+      return sortableItems;
+    }
+    return filtered;
+  }, [flattenedOptions, searchValue, filterOption, filterSort, optionFilterProp]);
+
+  // 获取选中的选项
+  const selectedOptions = useMemo(() => {
+    if (!value) return [];
+    if (mode) {
+      const values = Array.isArray(value) ? value : [];
+      return values.map(v => {
+        return allOptions.find(opt => opt.value === v);
+      }).filter(Boolean);
+    } else {
+      const option = allOptions.find(opt => opt.value === value);
+      return option ? [option] : [];
+    }
+  }, [value, allOptions, mode]);
+
+  // 判断选项是否被选中
+  const isOptionSelected = useMemoizedFn(option => {
+    if (!value) return false;
+    if (mode) {
+      const values = Array.isArray(value) ? value : [];
+      return values.some(v => v === option.value);
+    } else {
+      return value === option.value;
+    }
+  });
+  return {
+    flattenedOptions,
+    allOptions,
+    filteredOptions,
+    selectedOptions,
+    isOptionSelected
+  };
+};

package/dist/module/components/base/select/hooks/use-selector.js

@@ -0,0 +1,100 @@
+"use strict";
+
+import { useControllableValue, useMemoizedFn } from 'ahooks';
+import { useRef, useState } from 'react';
+
+/**
+ * 选择器 Hook 参数
+ */
+
+/**
+ * 选择器 Hook 返回值
+ */
+
+/**
+ * 选择器 Hook
+ *
+ * 封装 Select 组件中与选择器相关的逻辑,包括:
+ * - 选择器 ref 管理
+ * - 打开/关闭状态管理
+ * - 选择器位置获取
+ * - 焦点状态管理
+ * - 选择器点击处理
+ *
+ * @example
+ * const {
+ *   selectorRef,
+ *   open,
+ *   selectorLayout,
+ *   isFocused,
+ *   handleSelectorPress,
+ *   handleSelectorLayout
+ * } = useSelector({
+ *   defaultOpen: false,
+ *   disabled: false,
+ *   onOpenChange
+ * });
+ */
+export const useSelector = params => {
+  const selectorRef = useRef(null);
+  const [open, setOpen] = useControllableValue(params, {
+    valuePropName: 'open',
+    defaultValuePropName: 'defaultOpen',
+    trigger: 'onOpenChange'
+  });
+  const [selectorLayout, setSelectorLayout] = useState(null);
+  const [isFocused, setIsFocused] = useState(false);
+
+  // 更新选择器位置
+  const updateSelectorLayout = useMemoizedFn(() => {
+    if (!selectorRef.current?.measure) return;
+    selectorRef.current.measure((_x, _y, width, height, pageX, pageY) => {
+      setSelectorLayout({
+        x: pageX,
+        y: pageY,
+        width,
+        height
+      });
+    });
+  });
+
+  // 处理选择器点击
+  const handleSelectorPress = useMemoizedFn(() => {
+    if (params.disabled) return;
+    if (!open) {
+      // 打开下拉框时,先获取位置再打开
+      updateSelectorLayout();
+      setOpen(true);
+      setIsFocused(true);
+    } else {
+      // 关闭下拉框
+      setOpen(false);
+      setIsFocused(false);
+    }
+  });
+
+  // 处理选择器布局变化
+  const handleSelectorLayout = useMemoizedFn(() => {
+    // 当选择器布局变化时,如果下拉框是打开的,更新位置
+    if (open) {
+      updateSelectorLayout();
+    }
+  });
+
+  // 关闭下拉框
+  const closePopup = useMemoizedFn(() => {
+    setOpen(false);
+    setIsFocused(false);
+  });
+  return {
+    selectorRef,
+    open,
+    selectorLayout,
+    isFocused,
+    setOpen,
+    updateSelectorLayout,
+    handleSelectorPress,
+    handleSelectorLayout,
+    closePopup
+  };
+};

package/dist/module/components/base/select/index.js

@@ -0,0 +1,3 @@
+"use strict";
+
+export * from "./select.js";

package/dist/module/components/base/select/select-multiple-content.js

@@ -0,0 +1,176 @@
+"use strict";
+
+import { CloseOutlined } from '@seakoi/svg-icons';
+import React, { useCallback, useEffect, useMemo, useState } from 'react';
+import { Platform, Pressable, View } from 'react-native';
+import { Input, Overflow, Text } from "./../index.js";
+import { useTheme } from "../../../native-provider/index.js";
+import { useSelectMultipleContentStyles } from "./style/index.js";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const IS_NATIVE = Platform.OS !== 'web';
+
+/**
+ * Select 多选内容组件的 Props
+ */
+
+const INPUT_INIT_WIDTH = 1;
+/**
+ * Select 多选内容组件
+ *
+ * 负责渲染多选模式下的标签列表，包括标签的显示、关闭按钮等功能。
+ *
+ * @template ValueType - 选项值的类型
+ */
+export const SelectMultipleContent = ({
+  selectedOptions,
+  disabled = false,
+  maxTagCount,
+  maxTagTextLength,
+  maxTagPlaceholder,
+  tagRender,
+  labelRender,
+  placeholderStyle,
+  inputStyle,
+  tagItemStyle,
+  tagContentStyle,
+  tagRemoveStyle,
+  tagContainerStyle,
+  onTagClose,
+  showSearchInput = false,
+  searchValue = '',
+  onSearchChange,
+  placeholder = '',
+  mode,
+  onCreateOption,
+  open
+}) => {
+  const theme = useTheme();
+  const styles = useSelectMultipleContentStyles();
+  const [inputWidth, setInputWidth] = useState(INPUT_INIT_WIDTH);
+  useEffect(() => {
+    if (open) {
+      return;
+    }
+    // eslint-disable-next-line react-hooks/set-state-in-effect
+    setInputWidth(INPUT_INIT_WIDTH);
+  }, [open]);
+
+  /**
+   * 渲染标签项的回调函数
+   *
+   * @param option - 选项数据
+   * @returns 渲染的标签组件
+   */
+  const renderItem = useCallback(option => {
+    // 提取条件变量
+    const isOptionDisabled = disabled || !!option.disabled;
+    const showCloseButton = !disabled && !option.disabled;
+
+    // 提取标签内容渲染逻辑
+    let tagContent;
+    if (tagRender) {
+      tagContent = tagRender(option, {
+        disabled: isOptionDisabled,
+        onClose: () => onTagClose(option),
+        closable: showCloseButton
+      });
+    } else {
+      let labelContent;
+      if (labelRender) {
+        labelContent = labelRender(option, {
+          index: 0
+        });
+      } else if (typeof option.label === 'string' && maxTagTextLength && option.label.length > maxTagTextLength) {
+        labelContent = option.label.slice(0, maxTagTextLength) + '...';
+      } else {
+        labelContent = option.label;
+      }
+      tagContent = /*#__PURE__*/_jsx(_Fragment, {
+        children: labelContent
+      });
+    }
+    return /*#__PURE__*/_jsxs(View, {
+      style: [styles.tagItem, tagItemStyle],
+      children: [/*#__PURE__*/_jsx(Text, {
+        color: theme.palette.brand7,
+        size: 12,
+        style: [tagContentStyle],
+        children: tagContent
+      }), showCloseButton && /*#__PURE__*/_jsx(Pressable, {
+        style: [styles.tagRemoveButton, tagRemoveStyle],
+        onPress: () => onTagClose(option),
+        children: /*#__PURE__*/_jsx(CloseOutlined, {
+          size: 10,
+          color: theme.palette.fontGray3
+        })
+      })]
+    });
+  }, [styles.tagItem, styles.tagRemoveButton, tagItemStyle, tagContentStyle, tagRemoveStyle, theme.palette.brand7, theme.palette.fontGray3, tagRender, disabled, onTagClose, labelRender, maxTagTextLength]);
+
+  /**
+   * 渲染剩余标签的回调函数
+   *
+   * @param omittedItems - 被省略的标签项数组
+   * @returns 渲染的剩余标签组件
+   */
+  const renderRest = useCallback(omittedItems => /*#__PURE__*/_jsx(View, {
+    style: [styles.tagItem, tagItemStyle],
+    children: /*#__PURE__*/_jsx(Text, {
+      color: theme.palette.fontGray2,
+      size: 12,
+      style: tagContentStyle,
+      children: typeof maxTagPlaceholder === 'function' ? maxTagPlaceholder(omittedItems) : maxTagPlaceholder || `+${omittedItems.length}`
+    })
+  }), [styles.tagItem, theme.palette.fontGray2, tagItemStyle, tagContentStyle, maxTagPlaceholder]);
+
+  /**
+   * 后缀内容的记忆化组件
+   */
+  const suffix = useMemo(() => {
+    if (showSearchInput) {
+      return /*#__PURE__*/_jsx(Input, {
+        variant: "borderless",
+        style: [styles.input, inputStyle, {
+          width: selectedOptions.length === 0 ? '100%' : inputWidth
+        }],
+        inputStyle: styles.inputInner,
+        value: searchValue,
+        onChangeText: onSearchChange,
+        placeholder: selectedOptions.length === 0 ? placeholder : '',
+        placeholderTextColor: theme.palette.fontGray3,
+        onSubmitEditing: () => {
+          if (mode === 'tags' && searchValue.trim() && onCreateOption) {
+            onCreateOption(searchValue);
+          }
+        },
+        onContentSizeChange: IS_NATIVE ? e => {
+          setInputWidth(e.nativeEvent.contentSize.width);
+        } : undefined,
+        onChange: IS_NATIVE ? undefined : e => {
+          setInputWidth(e.nativeEvent.target.scrollWidth);
+        },
+        autoFocus: true
+      });
+    }
+    if (selectedOptions.length === 0) {
+      return /*#__PURE__*/_jsx(Text, {
+        size: 14,
+        color: theme.palette.fontGray3,
+        style: placeholderStyle,
+        children: placeholder
+      });
+    }
+    return null;
+  }, [showSearchInput, styles.input, styles.inputInner, inputStyle, placeholderStyle, inputWidth, searchValue, onSearchChange, selectedOptions.length, placeholder, theme.palette.fontGray3, mode, onCreateOption, IS_NATIVE]);
+  return /*#__PURE__*/_jsx(Overflow, {
+    data: selectedOptions,
+    itemKey: "value",
+    maxCount: maxTagCount,
+    renderItem: renderItem,
+    renderRest: renderRest,
+    itemsWidthTolerance: 2,
+    suffix: suffix,
+    style: tagContainerStyle,
+    suffixStyle: styles.overflowSuffix
+  });
+};

package/dist/module/components/base/select/select-popup.js

@@ -0,0 +1,227 @@
+"use strict";
+
+import { CheckOutlined } from '@seakoi/svg-icons';
+import { useMemoizedFn } from 'ahooks';
+import React, { useMemo } from 'react';
+import { ActivityIndicator, Dimensions, FlatList, Pressable, View } from 'react-native';
+import { Portal, Text } from "./../index.js";
+import { isSelectFlattenedGroupOption } from "./hooks/use-select-options.js";
+import { useTheme } from "../../../native-provider/index.js";
+import { useSelectPopupStyles } from "./style/index.js";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/** 下拉菜单默认最大高度 */
+export const DEFAULT_POPUP_MAX_HEIGHT = 256;
+
+/**
+ * SelectPopup 组件的属性
+ *
+ * @template ValueType - 选项值的类型
+ */
+
+export const SelectPopup = ({
+  open,
+  selectorLayout,
+  matchWidth,
+  placement: forcedPlacement,
+  popupMaxHeight = DEFAULT_POPUP_MAX_HEIGHT,
+  loading,
+  filteredOptions,
+  notFoundContent,
+  searchValue,
+  mode,
+  popupRootStyle,
+  popupListStyle,
+  popupListItemStyle,
+  popupGroupLabelStyle,
+  selectedIcon,
+  optionRender,
+  popupRender,
+  isOptionSelected,
+  onClose,
+  onOptionPress,
+  onCreateOption,
+  onPopupScroll
+}) => {
+  const theme = useTheme();
+  const styles = useSelectPopupStyles();
+
+  /**
+   * 计算下拉框位置信息
+   *
+   * @returns 包含位置信息和计算状态的对象
+   */
+  const positionInfo = useMemo(() => {
+    // 如果未打开或没有选择器布局信息，返回未计算状态
+    if (!open || !selectorLayout) {
+      return {
+        placement: 'bottom',
+        isPositionCalculated: false
+      };
+    }
+    const screenHeight = Dimensions.get('window').height;
+    const spaceBelow = screenHeight - (selectorLayout.y + selectorLayout.height);
+    const spaceAbove = selectorLayout.y;
+    const spacing = theme.spacing.xxs;
+
+    // 1. 如果指定了 placement,强制使用指定的位置
+    if (forcedPlacement) {
+      return {
+        placement: forcedPlacement,
+        isPositionCalculated: true
+      };
+    }
+
+    // 2. 没有指定 placement,尝试在下方
+    if (spaceBelow >= popupMaxHeight + spacing) {
+      return {
+        placement: 'bottom',
+        isPositionCalculated: true
+      };
+    }
+
+    // 3. 下方空间不够,尝试上方
+    if (spaceAbove >= popupMaxHeight + spacing) {
+      return {
+        placement: 'top',
+        isPositionCalculated: true
+      };
+    }
+
+    // 4. 上方也不够,直接显示在下方
+    return {
+      placement: 'bottom',
+      isPositionCalculated: true
+    };
+  }, [open, selectorLayout, theme.spacing.xxs, forcedPlacement, popupMaxHeight]);
+  const {
+    placement,
+    isPositionCalculated
+  } = positionInfo;
+
+  /**
+   * 下拉框容器样式
+   */
+  const popupStyle = useMemo(() => {
+    const style = {
+      left: selectorLayout.x,
+      width: matchWidth === true ? selectorLayout.width : typeof matchWidth === 'number' ? matchWidth : undefined,
+      maxHeight: popupMaxHeight
+    };
+    if (placement === 'bottom') {
+      style.top = selectorLayout.y + selectorLayout.height + theme.spacing.xxs;
+    } else {
+      style.bottom = Dimensions.get('window').height - selectorLayout.y + theme.spacing.xxs;
+    }
+    return style;
+  }, [selectorLayout, matchWidth, placement, theme.spacing.xxs, popupMaxHeight]);
+
+  /**
+   * 列表样式
+   */
+  const listStyle = useMemo(() => ({
+    maxHeight: popupMaxHeight
+  }), [popupMaxHeight]);
+
+  // 渲染下拉选项
+  const renderOption = ({
+    item,
+    index
+  }) => {
+    if (isSelectFlattenedGroupOption(item)) {
+      return /*#__PURE__*/_jsx(Text, {
+        color: theme.palette.fontGray3,
+        size: 12,
+        font: "semiBold",
+        style: [styles.popupGroupLabel, popupGroupLabelStyle],
+        children: item.label
+      });
+    }
+    const option = item;
+    const isSelected = isOptionSelected(option);
+    return /*#__PURE__*/_jsx(Pressable, {
+      style: [styles.popupListItem, isSelected && styles.popupListItemSelected, option.disabled && styles.popupListItemDisabled, popupListItemStyle, option.style],
+      onPress: () => onOptionPress(option),
+      disabled: option.disabled,
+      children: optionRender ? optionRender(option, {
+        index,
+        selected: isSelected
+      }) : /*#__PURE__*/_jsxs(_Fragment, {
+        children: [/*#__PURE__*/_jsx(Text, {
+          color: theme.palette.fontGray1,
+          size: 14,
+          style: styles.popupListItemText,
+          children: option.label
+        }), isSelected && (selectedIcon || /*#__PURE__*/_jsx(CheckOutlined, {
+          color: theme.palette.brand7,
+          size: 18
+        }))]
+      })
+    });
+  };
+
+  // 渲染下拉框内容
+  const renderPopupContent = () => {
+    if (loading) {
+      return /*#__PURE__*/_jsx(View, {
+        style: styles.loading,
+        children: /*#__PURE__*/_jsx(ActivityIndicator, {
+          color: theme.palette.brand7
+        })
+      });
+    }
+    if (filteredOptions.length === 0) {
+      if (mode === 'tags' && searchValue.trim()) {
+        return /*#__PURE__*/_jsx(Pressable, {
+          style: styles.popupCreateOption,
+          onPress: onCreateOption,
+          children: /*#__PURE__*/_jsxs(Text, {
+            color: theme.palette.brand7,
+            size: 14,
+            children: ["+ \u521B\u5EFA \"", searchValue.trim(), "\""]
+          })
+        });
+      }
+      return /*#__PURE__*/_jsx(View, {
+        style: styles.empty,
+        children: /*#__PURE__*/_jsx(Text, {
+          color: theme.palette.fontGray3,
+          size: 14,
+          children: notFoundContent
+        })
+      });
+    }
+    return /*#__PURE__*/_jsx(FlatList, {
+      data: filteredOptions,
+      renderItem: renderOption,
+      keyExtractor: (item, index) => isSelectFlattenedGroupOption(item) ? `group-${item.key}` : `option-${item.value}-${index}`,
+      style: [styles.popupList, listStyle, popupListStyle],
+      onScroll: onPopupScroll,
+      showsVerticalScrollIndicator: true,
+      removeClippedSubviews: true,
+      maxToRenderPerBatch: 10,
+      windowSize: 5,
+      initialNumToRender: 10
+    });
+  };
+
+  // 使用 useMemoizedFn 包装回调函数
+  const handleBackdropPress = useMemoizedFn(e => {
+    if (e.target === e.currentTarget) {
+      onClose();
+      return;
+    }
+    e.stopPropagation();
+  });
+  if (!open || !isPositionCalculated) return null;
+  const popupContent = /*#__PURE__*/_jsx(View, {
+    style: [styles.popupRoot, popupStyle, popupRootStyle],
+    children: renderPopupContent()
+  });
+  return /*#__PURE__*/_jsx(Portal, {
+    children: /*#__PURE__*/_jsx(Pressable, {
+      style: styles.backdrop,
+      onPress: handleBackdropPress,
+      children: popupRender ? popupRender(popupContent) : popupContent
+    })
+  });
+};