@seakoi/native-ui 1.1.3 → 1.3.0

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
+    })
+  });
+};

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

@@ -0,0 +1,94 @@
+"use strict";
+
+import React, { useCallback } from 'react';
+import { Input, Text } from "./../index.js";
+import { useTheme } from "../../../native-provider/index.js";
+import { useSelectSingleContentStyles } from "./style/index.js";
+
+/**
+ * Select 单选内容组件的 Props
+ *
+ * @template ValueType - 选项值的类型
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Select 单选内容组件
+ *
+ * 负责渲染单选模式下的选中值显示，支持占位符、自定义渲染和搜索输入。
+ *
+ * @template ValueType - 选项值的类型
+ * @param props - 组件属性
+ *
+ * @example
+ * <SelectSingleContent
+ *   selectedOption={{ label: '选项1', value: 1 }}
+ *   placeholder="请选择"
+ *   styles={styles}
+ * />
+ */
+export const SelectSingleContent = ({
+  selectedOption,
+  labelRender,
+  showSearchInput = false,
+  searchValue = '',
+  onSearchChange,
+  placeholder = '',
+  mode,
+  onCreateOption,
+  placeholderStyle,
+  inputStyle
+}) => {
+  const theme = useTheme();
+  const styles = useSelectSingleContentStyles();
+
+  /**
+   * 渲染占位符文本
+   *
+   * @param text - 占位符文本内容
+   * @returns 占位符文本组件
+   */
+  const renderPlaceholder = useCallback(text => /*#__PURE__*/_jsx(Text, {
+    size: 14,
+    color: theme.palette.fontGray3,
+    style: placeholderStyle,
+    children: text
+  }), [theme.palette.fontGray3, placeholderStyle]);
+
+  /**
+   * 渲染选中内容
+   *
+   * @param content - 选中的内容
+   * @returns 选中内容组件
+   */
+  const renderSelectedContent = useCallback(content => /*#__PURE__*/_jsx(Text, {
+    size: 14,
+    color: theme.palette.fontGray1,
+    children: content
+  }), [theme.palette.fontGray1]);
+  if (showSearchInput) {
+    return /*#__PURE__*/_jsx(Input, {
+      variant: "borderless",
+      style: [styles.input, inputStyle],
+      inputStyle: styles.inputInner,
+      value: searchValue,
+      onChangeText: onSearchChange,
+      placeholder: !selectedOption ? placeholder : '',
+      placeholderTextColor: theme.palette.fontGray3,
+      onSubmitEditing: () => {
+        if (mode === 'tags' && searchValue.trim() && onCreateOption) {
+          onCreateOption(searchValue);
+        }
+      },
+      autoFocus: true
+    });
+  }
+  if (!selectedOption) {
+    return renderPlaceholder(placeholder);
+  }
+  if (labelRender) {
+    return renderSelectedContent(labelRender(selectedOption, {
+      index: 0
+    }));
+  }
+  return renderSelectedContent(selectedOption.label);
+};

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

@@ -0,0 +1,61 @@
+"use strict";
+
+import { CloseOutlined, DownOutlined, UpOutlined } from '@seakoi/svg-icons';
+import React from 'react';
+import { Pressable, View } from 'react-native';
+import { useTheme } from "../../../native-provider/index.js";
+import { useSelectSuffixStyles } from "./style/index.js";
+
+/**
+ * SelectSuffix 组件的属性
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Select 后缀区域组件
+ *
+ * 包含清除按钮和下拉箭头图标
+ */
+export const SelectSuffix = ({
+  showClearButton,
+  allowClear,
+  open,
+  suffixIcon,
+  suffixStyle,
+  clearStyle,
+  onClear
+}) => {
+  const theme = useTheme();
+  const styles = useSelectSuffixStyles();
+  const renderClearIcon = () => {
+    if (typeof allowClear === 'object' && allowClear.clearIcon) {
+      return allowClear.clearIcon;
+    }
+    return /*#__PURE__*/_jsx(CloseOutlined, {
+      size: 12,
+      color: theme.palette.fontGray3
+    });
+  };
+  const renderSuffixIcon = () => {
+    if (typeof suffixIcon === 'function') {
+      return suffixIcon(open);
+    }
+    if (suffixIcon) {
+      return suffixIcon;
+    }
+    return open ? /*#__PURE__*/_jsx(UpOutlined, {
+      size: 12,
+      color: theme.palette.fontGray3
+    }) : /*#__PURE__*/_jsx(DownOutlined, {
+      size: 12,
+      color: theme.palette.fontGray3
+    });
+  };
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.suffix, suffixStyle],
+    children: [showClearButton && /*#__PURE__*/_jsx(Pressable, {
+      style: [styles.clearButton, clearStyle],
+      onPress: onClear,
+      children: renderClearIcon()
+    }), renderSuffixIcon()]
+  });
+};