@unif/react-native-ui 0.3.5 → 0.4.0

package/src/chip/index.tsx

@@ -18,14 +18,23 @@ import {
 } from './style';
 
 export interface ChipProps {
+  /** 胶囊内容 */
   children: React.ReactNode;
+  /** 点击回调 */
   onPress?: () => void;
+  /** 选中状态 */
   selected?: boolean;
+  /** 禁用状态 */
   disabled?: boolean;
+  /** 胶囊尺寸 */
   size?: 'default' | 'small';
+  /** 左侧图标 */
   icon?: React.ReactNode;
+  /** 容器样式 */
   style?: ViewStyle;
+  /** 语义样式覆盖 */
   styles?: Partial<ChipSemanticStyles>;
+  /** 测试标识 */
   testID?: string;
 }
 
@@ -83,6 +92,8 @@ const Chip: React.FC<ChipProps> = ({
   if (onPress) {
     return (
       <Pressable
+        accessibilityRole="button"
+        accessibilityState={{ disabled: !!disabled, selected: !!selected }}
         onPress={onPress}
         disabled={disabled}
         style={({ pressed }) => pressed && PRESSED_STYLE}

package/src/input/index.tsx

@@ -13,21 +13,39 @@ import type { InputSemanticStyles } from './style';
 import { createDefaultStyles } from './style';
 
 export interface InputProps {
+  /** 输入值 */
   value?: string;
+  /** 文本变更回调 */
   onChangeText?: (text: string) => void;
+  /** 占位提示文本 */
   placeholder?: string;
+  /** 是否多行输入 */
   multiline?: boolean;
+  /** 最大字符数 */
   maxLength?: number;
+  /** 多行模式下的最大高度 */
   maxHeight?: number;
+  /** 自动聚焦 */
   autoFocus?: boolean;
+  /** 键盘回车键类型 */
   returnKeyType?: ReturnKeyTypeOptions;
+  /** 提交编辑回调 */
   onSubmitEditing?: () => void;
+  /** 失焦回调 */
   onBlur?: () => void;
+  /** 聚焦回调 */
   onFocus?: () => void;
+  /** 提交时是否收起键盘 */
+  blurOnSubmit?: boolean;
+  /** 禁用状态 */
   disabled?: boolean;
+  /** 底部工具栏插槽 */
   toolbar?: React.ReactNode;
+  /** 容器样式 */
   style?: ViewStyle;
+  /** 语义样式覆盖 */
   styles?: Partial<InputSemanticStyles>;
+  /** 测试标识 */
   testID?: string;
 }
 
@@ -47,6 +65,7 @@ const Input = forwardRef<InputRef, InputProps>(
       onSubmitEditing,
       onBlur,
       onFocus,
+      blurOnSubmit,
       disabled,
       toolbar,
       style,
@@ -90,7 +109,7 @@ const Input = forwardRef<InputRef, InputProps>(
           onBlur={onBlur}
           onFocus={onFocus}
           editable={!disabled}
-          blurOnSubmit={false}
+          blurOnSubmit={blurOnSubmit ?? !multiline}
         />
         {toolbar && <View style={s.toolbar}>{toolbar}</View>}
       </View>

package/src/list-item/index.tsx

@@ -13,17 +13,29 @@ import type { ListItemSemanticStyles } from './style';
 import { createDefaultStyles, lineStyle, contentWrapStyle } from './style';
 
 interface ListItemProps {
+  /** 左侧缩略图 */
   thumb?: React.ReactNode;
+  /** 标题文本或自定义节点 */
   title: string | React.ReactNode;
+  /** 描述文本 */
   description?: string;
+  /** 右侧附加内容 */
   extra?: React.ReactNode | string;
+  /** 是否显示右侧箭头 */
   arrow?: boolean;
+  /** 自定义箭头图标 */
   arrowIcon?: React.ReactNode;
+  /** 点击回调 */
   onPress?: () => void;
+  /** 长按回调 */
   onLongPress?: () => void;
+  /** 禁用状态 */
   disabled?: boolean;
+  /** 容器样式 */
   style?: ViewStyle;
+  /** 语义样式覆盖 */
   styles?: Partial<ListItemSemanticStyles>;
+  /** 测试标识 */
   testID?: string;
 }
 
@@ -80,6 +92,7 @@ const ListItem: React.FC<ListItemProps> = ({
   if (props.onPress) {
     return (
       <Pressable
+        accessibilityRole="button"
         onPress={props.onPress}
         onLongPress={props.onLongPress}
         disabled={props.disabled}

package/src/popover/index.tsx

@@ -13,14 +13,23 @@ import type { PopoverSemanticStyles } from './style';
 import { createDefaultStyles } from './style';
 
 export interface PopoverProps {
+  /** 是否可见 */
   visible: boolean;
+  /** 关闭回调 */
   onClose: () => void;
+  /** 锚点元素的布局信息 */
   anchorLayout: { x: number; y: number; width: number; height: number };
+  /** 弹出层宽度 */
   width?: number;
+  /** 弹出方向 */
   placement?: 'bottom' | 'top';
+  /** 弹出层内容 */
   children: React.ReactNode;
+  /** 容器样式 */
   style?: ViewStyle;
+  /** 语义样式覆盖 */
   styles?: Partial<PopoverSemanticStyles>;
+  /** 测试标识 */
   testID?: string;
 }
 

package/src/tag/index.tsx

@@ -25,12 +25,19 @@ import {
 } from './style';
 
 export interface TagProps {
+  /** 标签内容 */
   children: React.ReactNode;
+  /** 标签变体：浅色底 / 纯色底 / 边框 */
   variant?: 'filled' | 'solid' | 'outlined';
+  /** 语义色名称或自定义 hex 色值 */
   color?: string;
+  /** 标签尺寸 */
   size?: 'default' | 'small';
+  /** 容器样式 */
   style?: ViewStyle;
+  /** 语义样式覆盖 */
   styles?: Partial<TagSemanticStyles>;
+  /** 测试标识 */
   testID?: string;
 }
 

package/src/tag/style/index.tsx

@@ -17,10 +17,12 @@ const PRESET_COLORS = {
 
 type PresetName = keyof typeof PRESET_COLORS;
 
+const isPreset = (c: string): c is PresetName => c in PRESET_COLORS;
+
 /** 解析颜色：支持预设名或自定义 hex */
 export function resolveColor(color: string | undefined): string {
   if (!color) return PRESET_COLORS.default;
-  if (color in PRESET_COLORS) return PRESET_COLORS[color as PresetName];
+  if (isPreset(color)) return PRESET_COLORS[color];
   return color;
 }
 

package/src/touchable/index.tsx

@@ -29,6 +29,7 @@ const Touchable: React.FC<TouchableProps> = ({
   ...rest
 }: TouchableProps) => (
   <Pressable
+    accessibilityRole="button"
     onPress={onPress}
     onLongPress={onLongPress}
     disabled={disabled}