@nutui/nutui-react-taro 2.0.0-alpha.11 → 2.0.0-alpha.13

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

@@ -1,24 +1,92 @@
 import React, { FunctionComponent, ChangeEvent, FocusEvent } from 'react';
 import { BasicComponent } from '../../utils/typings';
 export interface InputNumberProps extends BasicComponent {
-    disabled: boolean;
-    min: string | number;
-    max: string | number;
-    readonly: boolean;
-    value: string | number;
-    defaultValue: string | number;
-    allowEmpty: boolean;
-    step: string | number;
-    digits: string | number;
-    async: boolean;
+    /**
+    * 禁用所有功能
+    * @default false
+    */
+    disabled: boolean
+    /**
+    * 最小值限制
+    * @default 1
+    */
+    min: string | number
+    /**
+    * 最大值限制
+    * @default 9999
+    */
+    max: string | number
+    /**
+    * 只读状态禁用输入框操作行为
+    * @default false
+    */
+    readonly: boolean
+    /**
+    * 当前值，受控值
+    * @default -
+    */
+    value: string | number
+    /**
+    * 默认值
+    * @default 0
+    */
+    defaultValue: string | number
+    /**
+    * 是否允许内容为空
+    * @default false
+    */
+    allowEmpty: boolean
+    /**
+    * 步长
+    * @default 1
+    */
+    step: string | number
+    /**
+    * 设置保留的小数位
+    * @default 0
+    */
+    digits: string | number
+    /**
+    * 支持异步修改
+    * @default false
+    */
+    async: boolean
     className: string;
     style: React.CSSProperties;
-    formatter?: (displayValue: string | number) => string;
-    onPlus: (e: MouseEvent) => void;
-    onMinus: (e: MouseEvent) => void;
-    onOverlimit: (e: MouseEvent) => void;
-    onBlur: (e: ChangeEvent<HTMLInputElement>) => void;
-    onFocus: (e: FocusEvent<HTMLInputElement>) => void;
-    onChange: (param: string | number, e: MouseEvent | ChangeEvent<HTMLInputElement>) => void;
+    /**
+    * 指定输入框展示值的格式
+    * @default -
+    */
+    formatter?: (displayValue: string | number) => string
+    /**
+    * 点击增加按钮时触发
+    * @default -
+    */
+    onPlus: (e: MouseEvent) => void
+    /**
+    * 点击减少按钮时触发
+    * @default -
+    */
+    onMinus: (e: MouseEvent) => void
+    /**
+    * 点击不可用的按钮时触发
+    * @default -
+    */
+    onOverlimit: (e: MouseEvent) => void
+    /**
+    * 输入框失去焦点时触发
+    * @default -
+    */
+    onBlur: (e: ChangeEvent<HTMLInputElement>) => void
+    /**
+    * 输入框获得焦点时触发
+    * @default -
+    */
+    onFocus: (e: FocusEvent<HTMLInputElement>) => void
+    /**
+    * 值改变时触发
+    * @default -
+    */
+    onChange: (param: string | number, e: MouseEvent | ChangeEvent<HTMLInputElement>) => void
 }
 export declare const InputNumber: FunctionComponent<Partial<InputNumberProps> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'onBlur'>>;

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

@@ -1,11 +1,27 @@
 import React, { FunctionComponent } from 'react';
 import { BasicComponent } from '../../utils/typings';
 export interface MenuProps extends BasicComponent {
-    activeColor: string;
+    /**
+    * 选项的选中态图标颜色
+    * @default #F2270C
+    */
+    activeColor: string
     closeOnClickOverlay: boolean;
-    scrollFixed: boolean | string | number;
-    lockScroll: boolean;
-    icon: React.ReactNode;
+    /**
+    * 滚动后是否固定，可设置固定位置
+    * @default true
+    */
+    scrollFixed: boolean | string | number
+    /**
+    * 背景是否锁定
+    * @default true
+    */
+    lockScroll: boolean
+    /**
+    * 自定义标题图标
+    * @default -
+    */
+    icon: React.ReactNode
     children: React.ReactNode;
 }
 export declare const Menu: FunctionComponent<Partial<MenuProps>>;

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

@@ -5,17 +5,45 @@ export interface OptionItem {
     value: string | number;
 }
 export interface MenuItemProps extends BasicComponent {
-    title: React.ReactNode;
-    options: OptionItem[];
-    disabled: boolean;
-    columns: number;
-    icon: React.ReactNode;
+    /**
+    * 菜单项标题
+    * @default 当前选中项文字
+    */
+    title: React.ReactNode
+    /**
+    * 选项数组
+    * @default -
+    */
+    options: OptionItem[]
+    /**
+    * 是否禁用菜单
+    * @default false
+    */
+    disabled: boolean
+    /**
+    * 可以设置一行展示多少列 options
+    * @default 1
+    */
+    columns: number
+    /**
+    * 自定义选项图标
+    * @default Check
+    */
+    icon: React.ReactNode
     closeOnClickAway: boolean;
-    direction: string;
+    /**
+    * 菜单展开方向，可选值为up
+    * @default down
+    */
+    direction: string
     activeTitleClass: string;
     inactiveTitleClass: string;
     value: string | number;
-    onChange: (event: any) => void;
+    /**
+    * 选择 option 之后触发
+    * @default -
+    */
+    onChange: (event: any) => void
     children: React.ReactNode;
 }
 export declare const MenuItem: React.ForwardRefExoticComponent<Partial<MenuItemProps> & React.RefAttributes<unknown>>;

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

@@ -1,22 +1,70 @@
 import React, { FunctionComponent, ReactNode } from 'react';
 import { BasicComponent } from '../../utils/typings';
 export interface NoticeBarProps extends BasicComponent {
-    direction: string;
+    /**
+    * 滚动的方向，可选 horizontal、vertical
+    * @default horizontal
+    */
+    direction: string
     list: any;
     duration: number;
     height: number;
-    content: string;
-    closeable: boolean;
-    wrap: boolean;
-    leftIcon: ReactNode;
-    rightIcon: ReactNode;
-    delay: string | number;
-    scrollable: boolean | null;
-    speed: number;
+    /**
+    * 提示的信息
+    * @default -
+    */
+    content: string
+    /**
+    * 是否启用关闭模式
+    * @default false
+    */
+    closeable: boolean
+    /**
+    * 是否开启文本换行
+    * @default false
+    */
+    wrap: boolean
+    /**
+    * 左边的 icon，closeable 模式下默认为空
+    * @default -
+    */
+    leftIcon: ReactNode
+    /**
+    * closeable 模式下，默认为 <Close />
+    * @default -
+    */
+    rightIcon: ReactNode
+    /**
+    * 延时多少秒
+    * @default 1
+    */
+    delay: string | number
+    /**
+    * 是否可以滚动
+    * @default true
+    */
+    scrollable: boolean | null
+    /**
+    * 滚动速率 (px/s)
+    * @default 50
+    */
+    speed: number
     close?: (event: any) => void;
     click?: (event: any) => void;
-    onClose?: (event: any) => void;
-    onClick?: (event: any) => void;
-    onClickItem?: (event: any, value: any) => void;
+    /**
+    * 关闭通知栏时触发
+    * @default 
+    */
+    onClose?: (event: any) => void
+    /**
+    * 外层点击事件回调
+    * @default 
+    */
+    onClick?: (event: any) => void
+    /**
+    * 垂直滚动多条数据时，点击当前展示的信息时触发
+    * @default 
+    */
+    onClickItem?: (event: any, value: any) => void
 }
 export declare const NoticeBar: FunctionComponent<Partial<NoticeBarProps> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onClick'>>;

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

@@ -2,11 +2,35 @@ import React, { FunctionComponent } from 'react';
 import { BasicComponent } from '../../utils/typings';
 export interface NotifyProps extends BasicComponent {
     id?: string;
-    duration: number;
-    type: string;
-    position: string;
-    visible: boolean;
-    onClose: () => void;
-    onClick: () => void;
+    /**
+    * 展示时长(ms)，值为 0 时，notify 不会消失
+    * @default 3000
+    */
+    duration: number
+    /**
+    * 提示的信息类型（primary，success ，danger，warning）
+    * @default danger
+    */
+    type: string
+    /**
+    * 自定义位置 (top, bottom)
+    * @default top
+    */
+    position: string
+    /**
+    * 消息框是否展示
+    * @default false
+    */
+    visible: boolean
+    /**
+    * 关闭事件回调
+    * @default -
+    */
+    onClose: () => void
+    /**
+    * 点击事件回调
+    * @default -
+    */
+    onClick: () => void
 }
 export declare const Notify: FunctionComponent<Partial<NotifyProps> & React.HTMLAttributes<HTMLDivElement>>;

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

@@ -1,15 +1,55 @@
 import React, { FunctionComponent, ReactNode } from 'react';
 import { PopupProps } from '../../packages/popup/popup.taro';
 export interface NumberKeyboardProps extends PopupProps {
-    visible: boolean;
-    title?: ReactNode;
-    confirmText?: string;
-    type: 'default' | 'rightColumn';
-    custom: Array<string>;
-    random: boolean;
-    onChange?: (value: string) => void;
-    onDelete?: () => void;
-    onClose: () => void;
-    onConfirm?: () => void;
+    /**
+    * 是否显示键盘
+    * @default false
+    */
+    visible: boolean
+    /**
+    * 键盘标题
+    * @default -
+    */
+    title?: ReactNode
+    /**
+    * 自定义完成按钮文字，如"支付"，"下一步"，"提交"等
+    * @default 完成
+    */
+    confirmText?: string
+    /**
+    * 键盘模式, default：默认样式 rightColumn：带右侧栏
+    * @default default
+    */
+    type: 'default' | 'rightColumn'
+    /**
+    * 自定义键盘额外的键, 数组形式最多支持添加 2 个, 超出默认取前 2 项
+    * @default -
+    */
+    custom: Array<string>
+    /**
+    * 随机数
+    * @default false
+    */
+    random: boolean
+    /**
+    * 点击按键时触发
+    * @default -
+    */
+    onChange?: (value: string) => void
+    /**
+    * 点击删除键时触发
+    * @default -
+    */
+    onDelete?: () => void
+    /**
+    * 点击关闭按钮或非键盘区域时触发
+    * @default -
+    */
+    onClose: () => void
+    /**
+    * 点击确定按钮时触发
+    * @default -
+    */
+    onConfirm?: () => void
 }
 export declare const NumberKeyboard: FunctionComponent<Partial<NumberKeyboardProps> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'onClick' | 'title'>>;

package/dist/types/packages/overlay/index.d.ts

@@ -0,0 +1,3 @@
+import { Overlay } from './overlay';
+export type { OverlayProps } from './overlay';
+export default Overlay;

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

@@ -0,0 +1,14 @@
+import React, { FunctionComponent, MouseEvent } from 'react';
+import { BasicComponent } from '../../utils/typings';
+export interface OverlayProps extends BasicComponent {
+    zIndex: number;
+    duration: number;
+    closeOnOverlayClick: boolean;
+    visible: boolean;
+    lockScroll: boolean;
+    onClick: (event: MouseEvent) => void;
+    afterShow: () => void;
+    afterClose: () => void;
+}
+export declare const defaultOverlayProps: OverlayProps;
+export declare const Overlay: FunctionComponent<Partial<OverlayProps> & React.HTMLAttributes<HTMLDivElement>>;

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

@@ -2,14 +2,46 @@ import React, { FunctionComponent } from 'react';
 import { ITouchEvent } from '@tarojs/components';
 import { BasicComponent } from '../../utils/typings';
 export interface OverlayProps extends BasicComponent {
-    zIndex: number;
-    duration: number;
-    closeOnOverlayClick: boolean;
-    visible: boolean;
-    lockScroll: boolean;
-    onClick: (event: ITouchEvent) => void;
-    afterShow: () => void;
-    afterClose: () => void;
+    /**
+    * 遮罩层级
+    * @default 2000
+    */
+    zIndex: number
+    /**
+    * 动画时长，单位秒
+    * @default 0.3
+    */
+    duration: number
+    /**
+    * 是否点击遮罩关闭
+    * @default true
+    */
+    closeOnOverlayClick: boolean
+    /**
+    * 当前组件是否显示
+    * @default false
+    */
+    visible: boolean
+    /**
+    * 背景是否锁定
+    * @default true
+    */
+    lockScroll: boolean
+    /**
+    * 点击时触发
+    * @default 
+    */
+    onClick: (event: ITouchEvent) => void
+    /**
+    * 完全展示后触发
+    * @default -
+    */
+    afterShow: () => void
+    /**
+    * 完全关闭后触发
+    * @default -
+    */
+    afterClose: () => void
 }
 export declare const defaultOverlayProps: OverlayProps;
 export declare const Overlay: FunctionComponent<Partial<OverlayProps> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onClick'>>;

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

@@ -1,16 +1,60 @@
 import React, { FunctionComponent, ReactNode } from 'react';
 import { BasicComponent } from '../../utils/typings';
 export interface PaginationProps extends BasicComponent {
-    defaultValue: number;
-    value: number;
-    mode: 'multi' | 'simple';
-    prev: ReactNode;
-    next: ReactNode;
-    total: number;
-    pageSize: number;
-    itemSize: number;
-    ellipse: boolean;
-    itemRender: (page: any) => ReactNode;
-    onChange: (currPage: number) => void;
+    /**
+    * 默认页码，非受控值
+    * @default 1
+    */
+    defaultValue: number
+    /**
+    * 当前页码，受控值，与 onChange 搭配使用
+    * @default -
+    */
+    value: number
+    /**
+    * 显示模式,可选值为：multi，simple
+    * @default multi
+    */
+    mode: 'multi' | 'simple'
+    /**
+    * 自定义上一页按钮内容
+    * @default 上一页
+    */
+    prev: ReactNode
+    /**
+    * 自定义下一页按钮内容
+    * @default 下一页
+    */
+    next: ReactNode
+    /**
+    * 总记录数
+    * @default 50
+    */
+    total: number
+    /**
+    * 每页记录数
+    * @default 10
+    */
+    pageSize: number
+    /**
+    * 显示的页码个数
+    * @default 5
+    */
+    itemSize: number
+    /**
+    * 是否显示省略号
+    * @default false
+    */
+    ellipse: boolean
+    /**
+    * 用于自定义页码的结构
+    * @default -
+    */
+    itemRender: (page: any) => ReactNode
+    /**
+    * 页码改变时触发
+    * @default -
+    */
+    onChange: (currPage: number) => void
 }
 export declare const Pagination: FunctionComponent<Partial<PaginationProps> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>>;

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

@@ -2,17 +2,61 @@ import React, { RefObject } from 'react';
 import { PickerOption } from './types';
 import { BasicComponent } from '../../utils/typings';
 export interface PickerProps extends BasicComponent {
-    visible: boolean;
-    title?: string;
-    options: (PickerOption | PickerOption[])[];
-    value?: (number | string)[];
-    defaultValue?: (number | string)[];
-    threeDimensional?: boolean;
-    duration: number | string;
-    onConfirm?: (selectedOptions: PickerOption[], selectedValue: (string | number)[]) => void;
-    onClose?: (selectedOptions: PickerOption[], selectedValue: (string | number)[]) => void;
-    afterClose?: (selectedOptions: PickerOption[], selectedValue: (string | number)[], pickerRef: RefObject<HTMLDivElement>) => void;
-    onChange?: (selectedOptions: PickerOption[], selectedValue: (string | number)[], columnIndex: number) => void;
+    /**
+    * 是否可见
+    * @default false
+    */
+    visible: boolean
+    /**
+    * 设置标题
+    * @default -
+    */
+    title?: string
+    /**
+    * 列表数据
+    * @default []
+    */
+    options: (PickerOption | PickerOption[])[]
+    /**
+    * 选中值，受控
+    * @default []
+    */
+    value?: (number | string)[]
+    /**
+    * 默认选中
+    * @default []
+    */
+    defaultValue?: (number | string)[]
+    /**
+    * 是否开启3D效果
+    * @default true
+    */
+    threeDimensional?: boolean
+    /**
+    * 快速滑动时惯性滚动的时长，单位 ms
+    * @default 1000
+    */
+    duration: number | string
+    /**
+    * 点击确认按钮时候回调
+    * @default -
+    */
+    onConfirm?: (selectedOptions: PickerOption[], selectedValue: (string | number)[]) => void
+    /**
+    * 关闭时触发
+    * @default -
+    */
+    onClose?: (selectedOptions: PickerOption[], selectedValue: (string | number)[]) => void
+    /**
+    * 联动时，关闭时回调
+    * @default -
+    */
+    afterClose?: (selectedOptions: PickerOption[], selectedValue: (string | number)[], pickerRef: RefObject<HTMLDivElement>) => void
+    /**
+    * 每一列值变更时调用
+    * @default -
+    */
+    onChange?: (selectedOptions: PickerOption[], selectedValue: (string | number)[], columnIndex: number) => void
 }
 declare const Picker: React.ForwardRefExoticComponent<Partial<PickerProps> & React.RefAttributes<unknown>>;
 export default Picker;