@nutui/nutui-react-taro 2.0.0-alpha.16 → 2.0.0-alpha.17

package/dist/style.mjs

@@ -1,5 +1,5 @@
 /*!
-* @nutui/nutui-react-taro v2.0.0-alpha.16 Fri Jun 09 2023 18:38:37 GMT+0800 (China Standard Time)
+* @nutui/nutui-react-taro v2.0.0-alpha.17 Wed Jun 14 2023 16:33:20 GMT+0800 (China Standard Time)
 * (c) 2023 @jdf2e.
 * Released under the MIT License.
 */

package/dist/types/packages/animate/animate.taro.d.ts

@@ -4,12 +4,12 @@ import { BasicComponent } from '../../utils/typings';
 export interface AnimateProps extends BasicComponent {
     /**
     * 动画类型，见下方type值说明
-    * @default 'shake'
+    * @default shake
     */
     type: AnimateType
     /**
-    * 触发方式，'initial'--初始化执行;  'click'--点击执行
-    * @default 'initial'
+    * 触发方式，'initial'--初始化执行; 'click'--点击执行
+    * @default initial
     */
     action: AnimateAction
     /**

package/dist/types/packages/audio/audio.taro.d.ts

@@ -4,7 +4,7 @@ import { BasicComponent } from '../../utils/typings';
 export interface AudioProps extends BasicComponent {
     /**
     * 类名
-    * @default ''
+    * @default -
     */
     className?: string
     /**
@@ -14,7 +14,7 @@ export interface AudioProps extends BasicComponent {
     style?: CSSProperties
     /**
     * 语音资源链接
-    * @default ''
+    * @default -
     */
     url: string
     autoplay?: boolean;
@@ -24,15 +24,35 @@ export interface AudioProps extends BasicComponent {
     */
     loop?: boolean
     /**
-    * 展示形式，可选值：controls 控制面板   progress 进度条  icon 图标 none 自定义
+    * 展示形式，可选值：controls 控制面板 progress 进度条 icon 图标 none 自定义
     * @default 'progress'
     */
     type: string
-    onFastBack?: (ctx: InnerAudioContext) => void;
-    onForward?: (ctx: InnerAudioContext) => void;
-    onPause?: any;
+    /**
+    * 语音快退回调,type=progress时生效
+    * @default 
+    */
+    onFastBack?: (ctx: InnerAudioContext) => void
+    /**
+    * 语音快进回调,type=progress时生效
+    * @default 
+    */
+    onForward?: (ctx: InnerAudioContext) => void
+    /**
+    * 暂停回调
+    * @default 
+    */
+    onPause?: any
     onPlay?: any;
-    onPlayEnd?: (ctx: InnerAudioContext) => void;
-    onCanPlay?: (ctx: InnerAudioContext) => void;
+    /**
+    * 语音播放完成，loop=false时生效
+    * @default 
+    */
+    onPlayEnd?: (ctx: InnerAudioContext) => void
+    /**
+    * 可以播放媒体时触发
+    * @default 
+    */
+    onCanPlay?: (ctx: InnerAudioContext) => void
 }
 export declare const Audio: FunctionComponent<Partial<AudioProps> & (React.HTMLAttributes<HTMLDivElement> | InnerAudioContext)>;

package/dist/types/packages/avatar/avatar.taro.d.ts

@@ -3,7 +3,7 @@ import { BasicComponent } from '../../utils/typings';
 export interface AvatarProps extends BasicComponent {
     /**
     * 设置头像的大小
-    * @default ''
+    * @default -
     */
     size: string
     /**
@@ -13,7 +13,7 @@ export interface AvatarProps extends BasicComponent {
     icon: React.ReactNode
     /**
     * 设置头像的形状
-    * @default 'round'
+    * @default round
     */
     shape: AvatarShape
     /**
@@ -29,12 +29,12 @@ export interface AvatarProps extends BasicComponent {
     fit: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
     /**
     * 设置图片类型头像的地址
-    * @default ''
+    * @default -
     */
     src: string
     /**
     * 设置图片类型头像无法显示时的替代文本
-    * @default ''
+    * @default -
     */
     alt: string
     /**

package/dist/types/packages/avatargroup/avatargroup.taro.d.ts

@@ -3,12 +3,12 @@ import { BasicComponent } from '../../utils/typings';
 export interface AvatarGroupProps extends BasicComponent {
     /**
     * 头像数量超出时，会出现一个头像折叠元素。该元素内容可为...、more、+N。
-    * @default ''
+    * @default -
     */
     maxContent: string
     /**
     * 显示的最大头像个数
-    * @default ''
+    * @default -
     */
     max: string | number
     /**
@@ -23,12 +23,12 @@ export interface AvatarGroupProps extends BasicComponent {
     maxColor: string
     /**
     * 设置头像的大小，可选值为：large、normal、small，支持直接输入数字
-    * @default ''
+    * @default -
     */
     size: 'large' | 'normal' | 'small'
     /**
     * 设置头像的形状
-    * @default ''
+    * @default -
     */
     shape: 'round' | 'square'
     /**
@@ -38,7 +38,7 @@ export interface AvatarGroupProps extends BasicComponent {
     gap: string
     /**
     * 头像之间的层级关系，可选值为：left、right
-    * @default 'left'
+    * @default left
     */
     level: 'left' | 'right'
 }

package/dist/types/packages/button/button.taro.d.ts

@@ -14,22 +14,22 @@ export interface ButtonProps extends BasicComponent, OmitMiniProgramButtonProps
     color: string
     /**
     * 按钮的形状
-    * @default 'round'
+    * @default round
     */
     shape: ButtonShape
     /**
     * 按钮的样式
-    * @default 'default'
+    * @default default
     */
     type: ButtonType
     /**
     * 按钮的尺寸
-    * @default 'normal'
+    * @default normal
     */
     size: ButtonSize
     /**
     * 填充模式
-    * @default 'solid'
+    * @default solid
     */
     fill: ButtonFill
     /**

package/dist/types/packages/cascader/cascader.taro.d.ts

@@ -29,12 +29,12 @@ export interface CascaderProps extends BasicComponent {
     options: CascaderOption[]
     /**
     * 选中值，受控
-    * @default string)[]
+    * @default -
     */
     value?: CascaderValue
     /**
     * 默认选中值
-    * @default string)[]
+    * @default -
     */
     defaultValue?: CascaderValue
     /**
@@ -76,12 +76,12 @@ export interface CascaderProps extends BasicComponent {
     onClose?: () => void;
     /**
     * 选中值改变时触发
-    * @default 
+    * @default -
     */
     onChange: (value: CascaderValue, params?: any) => void
     /**
     * 选中项改变时触发
-    * @default 
+    * @default -
     */
     onPathChange: (value: CascaderValue, params: any) => void
 }

package/dist/types/packages/checkboxgroup/checkboxgroup.taro.d.ts

@@ -20,12 +20,12 @@ export interface CheckboxGroupProps {
     defaultValue?: string[]
     /**
     * 限制最大可选数
-    * @default number
+    * @default -
     */
     max: number | undefined
     /**
-    * 文本所在的位置，可选值：left,right
-    * @default right
+    * 文本所在的位置
+    * @default string
     */
     labelPosition: CheckboxLabelPosition
     /**

package/dist/types/packages/datepicker/datepicker.taro.d.ts

@@ -2,20 +2,80 @@ import React, { FunctionComponent } from 'react';
 import { PickerOption } from '../../packages/picker/index';
 import { BasicComponent } from '../../utils/typings';
 export interface DatePickerProps extends BasicComponent {
-    value?: Date | null;
-    defaultValue?: Date | null;
-    visible: boolean;
-    title: string;
-    type: 'date' | 'time' | 'year-month' | 'month-day' | 'datehour' | 'datetime' | 'hour-minutes';
-    showChinese: boolean;
-    minuteStep: number;
-    startDate: Date;
-    endDate: Date;
-    threeDimensional: boolean;
-    formatter: (type: string, option: PickerOption) => PickerOption;
-    filter: (type: string, option: PickerOption[]) => PickerOption[];
-    onClose: () => void;
-    onConfirm: (selectedOptions: PickerOption[], selectedValue: (string | number)[]) => void;
-    onChange?: (selectedOptions: PickerOption[], selectedValue: (string | number)[], columnIndex: number) => void;
+    /**
+    * 受控
+    * @default null
+    */
+    value?: Date | null
+    /**
+    * 初始值
+    * @default null
+    */
+    defaultValue?: Date | null
+    /**
+    * 是否可见
+    * @default false
+    */
+    visible: boolean
+    /**
+    * 设置标题
+    * @default null
+    */
+    title: string
+    /**
+    * 类时间类型，可选值 date time year-month month-day datehour datetime hour-minutes
+    * @default date
+    */
+    type: 'date' | 'time' | 'year-month' | 'month-day' | 'datehour' | 'datetime' | 'hour-minutes'
+    /**
+    * 每列是否展示中文
+    * @default false
+    */
+    showChinese: boolean
+    /**
+    * 分钟步进值
+    * @default 1
+    */
+    minuteStep: number
+    /**
+    * 开始日期
+    * @default 十年前
+    */
+    startDate: Date
+    /**
+    * 结束日期
+    * @default 十年后
+    */
+    endDate: Date
+    /**
+    * 是否开启3D效果
+    * @default true
+    */
+    threeDimensional: boolean
+    /**
+    * 选项格式化函数
+    * @default -
+    */
+    formatter: (type: string, option: PickerOption) => PickerOption
+    /**
+    * 选项过滤函数
+    * @default -
+    */
+    filter: (type: string, option: PickerOption[]) => PickerOption[]
+    /**
+    * 关闭时触发
+    * @default -
+    */
+    onClose: () => void
+    /**
+    * 点击确定按钮时触发
+    * @default -
+    */
+    onConfirm: (selectedOptions: PickerOption[], selectedValue: (string | number)[]) => void
+    /**
+    * 选项改变时触发
+    * @default -
+    */
+    onChange?: (selectedOptions: PickerOption[], selectedValue: (string | number)[], columnIndex: number) => void
 }
 export declare const DatePicker: FunctionComponent<Partial<DatePickerProps> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>>;

package/dist/types/packages/divider/divider.taro.d.ts

@@ -4,12 +4,12 @@ export type ContentPositionType = 'left' | 'center' | 'right';
 export type DirectionType = 'horizontal' | 'vertical';
 export interface DividerProps extends BasicComponent {
     /**
-    * 内容位置，可选值为 left right center
+    * 内容位置
     * @default center
     */
     contentPosition: ContentPositionType
     /**
-    * 水平还是垂直类型,可选值为 horizontal vertical
+    * 水平还是垂直类型
     * @default horizontal
     */
     direction?: DirectionType

package/dist/types/packages/drag/drag.taro.d.ts

@@ -7,7 +7,7 @@ export interface DragProps extends BasicComponent {
     */
     attract: boolean
     /**
-    * 拖拽元素的拖拽方向限制，x、y、all三选一
+    * 拖拽元素的拖拽方向限制
     * @default all
     */
     direction: 'x' | 'y' | 'lock' | undefined

package/dist/types/packages/elevator/elevator.taro.d.ts

@@ -37,7 +37,6 @@ export interface ElevatorProps extends BasicComponent {
     * @default true
     */
     showKeys: boolean
-    children: React.ReactNode;
     /**
     * 点击内容
     * @default false

package/dist/types/packages/empty/empty.taro.d.ts

@@ -8,17 +8,17 @@ export interface EmptyProps extends BasicComponent {
     image?: ReactNode
     /**
     * 图片大小，number 类型单位为 px
-    * @default ''
+    * @default -
     */
     imageSize: number | string
     /**
     * 图片下方的描述文字
-    * @default ''
+    * @default -
     */
     description: ReactNode
     /**
     * 默认图片错误类型
-    * @default 'empty'
+    * @default empty
     */
     status: 'empty' | 'error' | 'network'
 }

package/dist/types/packages/fixednav/fixednav.taro.d.ts

@@ -37,18 +37,18 @@ export interface FixedNavProps extends BasicComponent {
     */
     position: FixedNavPosition
     /**
-    * 导航方向,可选值 left right
+    * 导航方向
     * @default right
     */
     type: FixedNavDirection
     /**
     * 展开收起按钮回调
-    * @default 
+    * @default -
     */
     onChange: (item: any) => void
     /**
     * 选择之后触发
-    * @default 
+    * @default -
     */
     onSelect: (item: any, event: MouseEvent) => void
     /**

package/dist/types/packages/form/context.d.ts

@@ -0,0 +1,3 @@
+export declare const Context: import("react").Context<{
+    [key: string]: any;
+}>;

package/dist/types/packages/form/form.taro.d.ts

@@ -1,9 +1,51 @@
-import React, { FunctionComponent } from 'react';
+import React, { FunctionComponent, ReactNode } from 'react';
 import { BasicComponent } from '../../utils/typings';
-import FormItem from '../../packages/formitem/index.taro';
-import { BaseForm } from './types';
-export interface FormProps extends BasicComponent, BaseForm {
+import { useForm } from './useform.taro';
+import { FormItem } from '../formitem/formitem.taro';
+export interface FormProps extends BasicComponent {
+    /**
+    * 表单底部区域，一般放置确认和重置按钮
+    * @default null
+    */
+    footer: ReactNode
+    /**
+    * 表单初始值
+    * @default -
+    */
+    initialValues: any
+    /**
+    * 表单名称
+    * @default -
+    */
+    name: string
+    /**
+    * 经 Form.useForm() 创建的 form 控制实例，不提供时会自动创建
+    * @default -
+    */
+    form: any
+    /**
+    * 表单项 label 的位置
+    * @default 'left'\
+    */
+    labelPosition: 'top' | 'left' | 'right'
+    /**
+    * 必填表单项 label 的红色星标位置
+    * @default left
+    */
+    starPosition: 'left' | 'right'
+    /**
+    * 校验成功后触发
+    * @default -
+    */
+    onFinish: (values: any) => void
+    /**
+    * 任一表单项被校验失败后触发
+    * @default -
+    */
+    onFinishFailed: (values: any, errorFields: any) => void
 }
 export declare const Form: FunctionComponent<Partial<FormProps> & React.HTMLAttributes<HTMLFormElement>> & {
     Item: typeof FormItem;
+} & {
+    useForm: typeof useForm;
 };

package/dist/types/packages/form/index.taro.d.ts

@@ -1,2 +1,3 @@
 import { Form } from './form.taro';
+export type { FormItemRuleWithoutValidator, StoreValue, NamePath, FormInstance, FieldEntity, } from './types';
 export default Form;

package/dist/types/packages/form/types.d.ts

@@ -1,63 +1,18 @@
-export interface BaseForm {
-    /**
-     * 经 Form.useForm() 创建的 form 控制实例，不提供时会自动创建
-     */
-    form: any;
-    /**
-     * label的位置
-     * 可选值 top/left/right
-     */
-    labelPosition: string | number;
-    /**
-     * 表单分组名称
-     */
-    formGroupTitle: string;
-    starPositon: string;
-    /**
-     * 表单校验成功回调
-     */
-    onFinish: (obj: object) => void;
-    /**
-     * 表单校验失败回调
-     */
-    onFinishFailed: (value: []) => void;
-}
 export interface FormItemRuleWithoutValidator {
     [key: string]: any;
     regex?: RegExp;
     required?: boolean;
     message?: string;
 }
-export interface FormItemRule extends FormItemRuleWithoutValidator {
-    validator?: (value: any, ruleCfg: FormItemRuleWithoutValidator) => boolean | string | Promise<boolean | string>;
-}
-export interface BaseFormField {
-    /**
-     * 字段名
-     */
-    name: string;
-    /**
-     * label 标签的文本
-     */
-    label: string;
-    /**
-     * 校验规则，设置字段的校验逻辑
-     */
-    rules: FormItemRule[];
-    /**
-     * 是否禁用表单项
-     */
-    disabled: boolean;
-}
-export type StoreValue = string | number;
+export type StoreValue = any;
 export type NamePath = string | number;
 export interface Callbacks<Values = any> {
     onValuesChange?: (values: Values) => void;
     onFinish?: (values: Values) => void;
-    onFinishFailed?: (Values: Values) => void;
+    onFinishFailed?: (values: Values, errorFields: any) => void;
 }
 export interface Store {
-    [name: string]: StoreValue;
+    [name: string]: any;
 }
 export interface FormInstance<Values = any> {
     registerField: (entity: FieldEntity) => () => void;
@@ -68,7 +23,7 @@ export interface FormInstance<Values = any> {
     setCallback: (callbacks: Callbacks) => void;
 }
 export interface FieldEntity {
-    onStoreChange: () => void;
+    onStoreChange: (type?: string) => void;
     getNamePath: () => NamePath;
     props: {
         name: NamePath;
@@ -77,6 +32,3 @@ export interface FieldEntity {
         initialValue?: any;
     };
 }
-export interface IDescriptor {
-    [name: string]: string;
-}

package/dist/types/packages/formitem/formitem.taro.d.ts

@@ -1,30 +1,62 @@
 import React from 'react';
 import { BaseFormField } from './types';
-import { FormItemContext } from './formitemcontext';
+import { Context } from '../form/context';
 import { BasicComponent } from '../../utils/typings';
 type TextAlign = 'start' | 'end' | 'left' | 'right' | 'center' | 'justify' | 'match-parent';
 export interface FormItemProps extends BasicComponent, BaseFormField {
-    labelWidth: string | number;
-    errorMessageAlign: TextAlign;
-    showErrorLine: boolean;
-    showErrorMessage: boolean;
+    /**
+    * 必填表单项 label 的红色星标,仅用于控制样式
+    * @default false
+    */
+    required: boolean
+    /**
+    * 设置子元素默认值
+    * @default -
+    */
+    initialValue: any
+    /**
+    * 设置收集字段值变更的时机
+    * @default -
+    */
+    trigger: string
+    /**
+    * 子节点的值的属性，如 Checkbox 的是 'checked'
+    * @default -
+    */
+    valuePropName: string
+    /**
+    * 设置如何将 event 的值转换成字段值
+    * @default -
+    */
+    getValueFromEvent: (...args: any) => any
+    /**
+    * 点击事件并收集子组件 Ref
+    * @default -
+    */
+    onClick: (event: React.MouseEvent, componentRef: React.MutableRefObject<any>) => void
+    /**
+    * 错误提示文案对齐方式
+    * @default left
+    */
+    errorMessageAlign: TextAlign
 }
 declare const defaultProps: FormItemProps;
 export type FieldProps = typeof defaultProps & Partial<BaseFormField>;
-export declare class FormItem extends React.Component<FieldProps> {
+export declare class FormItem extends React.Component<FieldProps, {
+    resetCount: number;
+}> {
     static defaultProps: FormItemProps;
     static contextType: any;
-    context: React.ContextType<typeof FormItemContext>;
+    context: React.ContextType<typeof Context>;
     private cancelRegister;
+    private componentRef;
+    constructor(props: FieldProps);
     componentDidMount(): void;
     componentWillUnmount(): void;
-    getControlled: (children: React.ReactElement) => {
-        value: any;
-        onChange: (event: React.ChangeEvent<HTMLInputElement> | number | string | string[]) => void;
-    };
-    onStoreChange: () => void;
+    getControlled: (children: React.ReactElement) => any;
+    refresh: () => void;
+    onStoreChange: (type?: string) => void;
     renderLayout: (childNode: React.ReactNode) => JSX.Element;
-    pxCheck: (value: string | number) => string;
     render(): JSX.Element;
 }
 export {};

package/dist/types/packages/formitem/index.taro.d.ts

@@ -1,2 +1,3 @@
 import { FormItem } from './formitem.taro';
+export type { FormItemRuleWithoutValidator, FormItemRule, FormInstance, } from './types';
 export default FormItem;