Merge branch dev

Author: ChenlingasMx

packages/core/src/ActionSheet/README.md

@@ -54,33 +54,26 @@ export default Demo
 
 ### Props
 
-```js
-import { StyleProp, ViewStyle } from 'react-native';
-import { ModalProps } from '@uiw/react-native';
-
-export interface DividerStyle {
-  itemDivider?: StyleProp<ViewStyle>,
-  actionDivider?: StyleProp<ViewStyle>,
-}
-```
-
 | 参数 | 说明 | 类型 | 默认值 |
 |------|------|-----|------|
 | onCancel | 点击蒙层是否关闭 | Boolean | `false` |
-| dividerStyle | 分割线样式 | DividerStyle | - |
-| containerStyle | 取消的容器样式 | StyleProp<ViewStyle> | - |
+| dividerStyle | 分割线样式 | DividerStyleProps | - |
+| containerStyle | 取消的容器样式 | StyleProp<`ViewStyle`> | - |
 | activeOpacity | 动作在被触摸操作激活时以多少不透明度显示 | number | `#f1f1f1` |
 | underlayColor | 动作有触摸操作时显示出来的底层的颜色 | string | `#f1f1f1` |
 | cancelText | 取消的文本 | `React.ReactNode` | - |
 | textStyle | 取消的文本样式 | `StyleProp<TextStyle>` | - |
 
-### ActionSheetItem Props
-```js
-import { TextStyle, StyleProp, ViewStyle } from 'react-native';
-```
+### DividerStyleProps
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| itemDivider | - | StyleProp<`ViewStyle`> | `false` |
+| actionDivider | - | StyleProp<`ViewStyle`> | - |
 
+### ActionSheetItemProps
 | 参数 | 说明 | 类型 | 默认值 |
 |------|------|-----|------|
 | containerStyle | 容器样式 | `StyleProp<ViewStyle>` | - |
 | textStyle | 文本样式 | `StyleProp<ViewStyle>` | - |
 | onPress | 点击 ActionSheetItem 触发的事件 | `(event: GestureResponderEvent) => void` | - |
+

packages/core/src/Avatar/README.md

@@ -26,32 +26,15 @@ export default Demo
 
 ```
 
-### props
+### Props
 
 继承 [View](https://facebook.github.io/react-native/docs/view#props) 组件。
 
-```ts
-import { ViewProps } from 'react-native';
-
-export interface AvatarProps extends ViewProps {
-  /** React Native `Image` 组件 Props */
-  imageProps?: ImageProps;
-  /** 图像源（远程URL或本地文件资源）。 */
-  src?: string | number;
-  /**
-   * 尺寸
-   * @default 40
-   */
-  size?: number;
-  /**
-   * 设置圆角
-   * @default 3
-   */
-  rounded?: number;
-  /**
-   * 指定头像的形状
-   * @default square
-   */
-  shape?: 'circle' | 'square';
-}
-```
+
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| `imageProps` | React Native `Image` 组件 Props | obj | - |
+| `src` | 图像源（远程URL或本地文件资源） | `string|number` | - |
+| `size` | 尺寸 | number | - |
+| `rounded` | 设置圆角 | number | - |
+| `shape` |指定头像的形状 | `circle｜square` | - |

packages/core/src/Badge/README.md

@@ -47,22 +47,11 @@ export default Demo;
 
 继承 [View](https://facebook.github.io/react-native/docs/view#props) 组件。
 
-```ts
-import { ViewProps } from 'react-native';
-
-export interface BadgeProps extends ViewProps {
-  children?: React.ReactNode;
-  /** 标记颜色 */
-  color?: colors.Colors | string;
-  /** 文本内容 */
-  text?: string | Element;
-  /**
-   * 设置圆角，默认 `12`
-   */
-  rounded?: number;
-  /** 设置类型 */
-  type?: 'dot' | 'text';
-  /** 文本样式 */
-  textStyles?: StyleProp<TextStyle>;
-}
-```
+| 属性 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| color | 标记颜色 | `colors.Colors \| string` | - |
+| text | 文本内容 | `string \| Element` | - |
+| rounded | 设置圆角 | `boolean \| number` | `12` |
+| textStyles | 文本样式 | `StyleProp<TextStyle>` | - |
+| type | 设置类型 | `'dot' \| 'text'` | - |
+| children | 更多内容 | `React.ReactNode` | - |

packages/core/src/DatePicker/pure-function.ts

@@ -197,26 +197,31 @@ export function getPickerData(timerDiff: TimerDiff, type: DateKey): ResultDate {
 export function minData(key: DateKey, changeParams: ChangeParams, precision: DateKey): ResultDate {
   const { MINTIMER = {}, nextLabel = {} } = changeParams;
   const newObj: ResultDate = {};
-  if (key === 'second') return newObj;
-  if (MINTIMER.second !== '00') {
-    newObj.second = getMinutesOrSeconds();
+  if (key === 'month') {
+    return newObj;
   }
-  if (key === 'minute') return newObj;
-  if (MINTIMER.minute !== '00') {
-    newObj.minute = getMinutesOrSeconds();
+  if (MINTIMER.month !== '01') {
+    newObj.month = getMonths();
+  }
+  if (key === 'day') {
+    return newObj;
+  }
+  if (MINTIMER.day !== '01' || Number(nextLabel.month) !== 2) {
+    newObj.day = getDays(Number(nextLabel.year), Number(nextLabel.month));
   }
   if (key === 'hour') return newObj;
   if (MINTIMER.hour !== '00') {
     newObj.hour = getHours();
   }
-  if (key === 'day') return newObj;
-  if (MINTIMER.day !== '01' || Number(nextLabel.month) !== 2) {
-    newObj.day = getDays(Number(nextLabel.year), Number(nextLabel.month));
+  if (key === 'minute') return newObj;
+  if (MINTIMER.minute !== '00') {
+    newObj.minute = getMinutesOrSeconds();
   }
-  if (key === 'month') return newObj;
-  if (MINTIMER.month !== '01') {
-    newObj.month = getMonths();
+  if (key === 'second') return newObj;
+  if (MINTIMER.second !== '00') {
+    newObj.second = getMinutesOrSeconds();
   }
+
   return newObj;
 }
 /** 最大时间改变的 */

packages/core/src/Flex/README.md

@@ -74,39 +74,11 @@ export default Demo
 ```
 
 ### Props
-
-### Flex
-
-```ts
-export interface FlexProps extends ViewProps {
-  /**
-   * 项目定位方向
-   * `row`, `column`, `row-reverse`, `column-reverse`
-   * @default row
-   */
-  direction?: FlexStyle['flexDirection'];
-  /**
-   * 子元素在主轴上的对齐方式
-   * @default start
-   */
-  justify?: 'start' | 'end' | 'center' | 'between' | 'around';
-  /**
-   * 子元素在交叉轴上的对齐方式
-   * @default start
-   */
-  align?: 'start' | 'end' | 'center' | 'stretch' | 'baseline';
-  /**
-   * 子元素的换行方式
-   * @default nowrap
-   */
-  wrap?: 'wrap' | 'nowrap' | 'wrap-reverse';
-}
-```
-
-### Flex.Item
-
 继承 [View](https://facebook.github.io/react-native/docs/view#props) 组件。
 
-```ts
-export interface FlexItemProps extends ViewProps {}
-```
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| `direction` | 项目定位方向 | `row` \| `column` \| `row-reverse` \| `column-reverse` | row |
+| `justify` | 子元素在主轴上的对齐方式 |  `start` \| `end` \| `center` \| `between` \| `around` | start |
+| `align` | 子元素在交叉轴上的对齐方式 | `start` \| `end` \| `center` \| `stretch` \| `baseline` | start |
+| `wrap` | 子元素的换行方式 | `wrap` \| `nowrap` \| `wrap-reverse` | nowrap |

packages/core/src/Form/README.md

@@ -267,90 +267,44 @@ const FormComponent = Form.create(FormDemo)
 
 export default FormComponent;
 ```
-End
-
-
-### FormProps
-```ts
-interface FormProps<FormData = any, FieldValue = FormData[keyof FormData], FieldKey extends KeyType = keyof FormData> {
-  /**
-   * 表单集合
-  */
-  schema?: FormItemsProps[];
-  /**
-   * 经 Form.useForm() 创建的 form 控制实例，不提供时会自动创建
-  */
-  form: FormInstance<FormData, FieldValue, FieldKey>;
-  /**
-   * 表单默认值，只有初始化以及重置时生效
-  */
-  initialValues?: Partial<FormData>;
-  /**
-   * 支持默认和卡片两种模式
-  */
-  mode?:'default' | 'card';
-  // 表单是否在onChange时进行验证
-  changeValidate?: boolean;
-  // 监听表单字段变化
-  watch?: Partial<Record<string, (value: unknown) => void>>;
-  // 自定义组件
-  customComponentList?: Partial<Record<string, JSX.Element>>;
-}
-```
+
+### Props
+
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| `schema` | 表单集合 | FormItemsProps[] | [] |
+| `form` | 经 Form.useForm() 创建的 form 控制实例，不提供时会自动创建 | FormInstance<`FormData`, `FieldValue`, `FieldKey`> | - |
+| `initialValues` | 表单默认值，只有初始化以及重置时生效 | Partial<`FormData`> | - |
+| `mode` | 支持默认和卡片两种模式 | `default` \| `card` | | default |
+| `changeValidate` | 表单是否在onChange时进行验证 | boolean | false |
+| `watch` | 监听表单字段变化 | Partial<Record<string, (value: unknown) => void>> | - |
+| `customComponentList` | 自定义组件 | Partial<Record<string, JSX.Element>> | - |
 
 ### FormItemsProps
-```ts
-interface FormItemsProps {
-  // 字段名
-  field: string;
-  // 字段类型(默认继承了react-native-uiw中的 input | textArea | slider | rate | radio | search | switch | checkBox | stepper ｜ cardList   )
-  type: string;
-  // 标签名
-  name: string;
-  // 验证规则
-  validate?: RulesOption['validate'];
-  options?: Array<{ label: string; value: KeyType }>;
-  // 表单控件props
-  attr?: any;
-  // 展示是否必填
-  required?: boolean;
-  // 是否隐藏
-  hide?:boolean
-  // 当type为cardList生效,渲染每一项的头部内容
-  renderHeader?:(index:number,{ remove }:{ remove:()=>void })=>React.ReactNode;
-  // 当type为cardList生效,渲染添加按钮的文案
-  renderAdd?:( { add }:{ add:()=>void } )=>React.ReactNode;
-  // 当type为cardList生效,配置表单项
-  items?: Omit<FormItemsProps, 'validate' | 'required'>[];
-}
-```
 
-### FormInstance
-```ts
-type FormInstance<FormData = any, FieldValue = FormData[keyof FormData], FieldKey extends KeyType = keyof FormData> = {
-  /**
-   * 获取对应字段名的值
-  */
-  getFieldValue: (field: FieldKey) => FieldValue;
-   /**
-   * 设置对应字段名的值
-  */
-  setFieldValue: (field: FieldKey, value: FieldValue) => void;
-   /**
-   * 重制表单
-  */
-  resetFieldValue: () => void;
-  /**
-   * 触发验证
-  */
-  validate: () => Partial<Record<string, string>>;
-  /**
-   * 触发表单验证获取表单数据
-  */
-  validateFields: () => Promise<FormData> | any;
-  getInnerMethods: (inner?: boolean) => InnerMethodsReturnType<FormData>;
-};
-```
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| `field` | 字段名 | string | - |
+| `type` | 字段类型(默认继承了react-native-uiw中的 input | textArea | slider | rate | radio | search | switch | checkBox | stepper ｜ cardList   ) | string | - |
+| `name` | 标签名 | string | - |
+| `validate` | 验证规则 | RulesOption['validate'] | - |
+| `options` | 集合 | Array<{ label: string; value: KeyType }> | - |
+| `attr` | 表单控件props | any | - |
+| `required` | 展示是否必填 | boolean | - |
+| `hide` | 是否隐藏 | boolean | - |
+| `renderHeader` | 当type为cardList生效,渲染每一项的头部内容 | (index:number,{ remove }:{ remove:()=>void })=>React.ReactNode | - |
+| `renderAdd` | 当type为cardList生效,渲染添加按钮的文案 | ( { add }:{ add:()=>void } )=>React.ReactNode | - |
+| `items` | 当type为cardList生效,配置表单项 | Omit<FormItemsProps, `validate` \| `required`>[] | - |
+
+### FormInstanceProps
 
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| `getFieldValue` | 获取对应字段名的值 | (field: FieldKey) => FieldValue | - |
+| `setFieldValue` | 设置对应字段名的值 | (field: FieldKey, value: FieldValue) => void | - |
+| `resetFieldValue` | 重制表单 | () => void | - |
+| `validate` | 触发验证 | () => Partial<Record<string, string>> | - |
+| `validateFields` | 触发表单验证获取表单数据 | () => Promise<FormData> \| any | - |
+| `getInnerMethods` | 组件内部方法集合 | (inner?: boolean) => InnerMethodsReturnType<FormData> | - |
 
 

packages/core/src/Grid/README.md

@@ -88,44 +88,21 @@ function Demo() {
 export default Demo
 
 ```
-
 ### Props
-
-
-```ts
-interface ItemData {
-  icon?: React.ReactNode;
-  text?: React.ReactNode;
-}
-
-```
-
-```ts
-export interface GridProps extends ViewProps {
-  /**
-   * 传入的菜单数据，`icon` 可以是 `ReactNode` 或者 `uri`
-   * @default []
-   */
-  data?: ItemData[];
-  /**
-   * 列数
-   * @default 4
-   */
-  columns?: number;
-  /**
-   * 是否有间隔线
-   * @default true
-   */
-  hasLine?: boolean;
-  /** 单元格样式 */
-  itemStyle?: StyleProp<ViewStyle>;
-  /** 单元格文本样式 */
-  textStyle?: StyleProp<TextStyle & ViewStyle>;
-  /** 图片样式，可设置图片/图标尺寸 */
-  iconStyle?: StyleProp<ImageStyle & TextStyle & ViewStyle>;
-  /** 自定义单元格 */
-  renderItem?: (data: ItemData, index: number, row: number) => React.ReactNode;
-  /** 点击宫格回调函数 */
-  onPress?: (data: ItemData, index: number, row: number, event: GestureResponderEvent) => void;
-}
-```
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| data | 菜单数据，`icon` 可以是 `ReactNode` 或者 `uri` | `ItemData[]` | - |
+| columns | 列数 |  `number` | 4 |
+| hasLine | 是否有间隔线 | `boolean` | true |
+| itemStyle | 单元格样式 | `StyleProp<ViewStyle>` | - |
+| textStyle | 单元格文本样式 | `StyleProp<TextStyle & ViewStyle>` | - |
+| iconStyle | 图片样式，可设置图片/图标尺寸 | `StyleProp<ImageStyle & TextStyle & ViewStyle>` | - |
+| renderItem | 自定义单元格 |  `(data: ItemData, index: number, row: number) => React.ReactNode` | - |
+| onPress | 点击宫格回调函数 |  `(data: ItemData, index: number, row: number, event: GestureResponderEvent) => void` | - |
+
+
+### ItemData
+| 参数 | 说明 | 类型 | 默认值 |
+|------|------|-----|------|
+| text | 显示文字 | `React.ReactNode` | - |
+| icon | 图标 | `React.ReactNode` | - |