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

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

@@ -1,8 +1,16 @@
 import { FunctionComponent, ReactNode } from 'react';
 import { BadgeProps } from '../badge/badge.taro';
 export interface TabbarItemProps extends BadgeProps {
-    title: ReactNode;
-    icon: ReactNode;
+    /**
+    * 标签页的标题
+    * @default -
+    */
+    title: ReactNode
+    /**
+    * 自定义图标
+    * @default -
+    */
+    icon: ReactNode
     active: boolean;
     activeColor: string;
     inactiveColor: string;

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

@@ -3,9 +3,21 @@ interface TabPanelInnerProps {
     autoHeightClassName: string;
 }
 export interface TabPaneProps {
-    title: string | number;
-    value: string | number;
-    disabled: boolean;
+    /**
+    * 标题
+    * @default -
+    */
+    title: string | number
+    /**
+    * 标签 Key , 匹配的标识符, 默认为索引值
+    * @default -
+    */
+    value: string | number
+    /**
+    * 是否禁用标签
+    * @default false
+    */
+    disabled: boolean
     className: string;
     children?: React.ReactNode;
 }

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

@@ -8,18 +8,66 @@ export type TabsTitle = {
     value: string | number;
 };
 export interface TabsProps extends BasicComponent {
-    tabStyle: React.CSSProperties;
-    value: string | number;
-    defaultValue: string | number;
-    activeColor: string;
-    direction: 'horizontal' | 'vertical';
-    activeType: 'line' | 'smile';
-    duration: number | string;
-    align: 'left' | 'right';
-    title: () => JSX.Element[];
-    onChange: (index: string | number) => void;
-    onClick: (index: string | number) => void;
-    autoHeight: boolean;
+    /**
+    * 标签栏样式
+    * @default {}
+    */
+    tabStyle: React.CSSProperties
+    /**
+    * 当前激活 tab 面板的值
+    * @default 0
+    */
+    value: string | number
+    /**
+    * 初始化激活 tab 的值
+    * @default 0
+    */
+    defaultValue: string | number
+    /**
+    * 标签选中色
+    * @default #1a1a1a
+    */
+    activeColor: string
+    /**
+    * 使用横纵方向 可选值 horizontal、vertical
+    * @default horizontal
+    */
+    direction: 'horizontal' | 'vertical'
+    /**
+    * 选中底部展示样式 可选值 line、smile
+    * @default line
+    */
+    activeType: 'line' | 'smile'
+    /**
+    * 切换动画时长,单位 ms 0 代表无动画
+    * @default 300
+    */
+    duration: number | string
+    /**
+    * 标题左对齐
+    * @default -
+    */
+    align: 'left' | 'right'
+    /**
+    * 自定义导航区域
+    * @default -
+    */
+    title: () => JSX.Element[]
+    /**
+    * 当前激活的标签改变时触发
+    * @default -
+    */
+    onChange: (index: string | number) => void
+    /**
+    * 点击标签时触发
+    * @default -
+    */
+    onClick: (index: string | number) => void
+    /**
+    * 自动高度。设置为 true 时，nut-tabs 和 nut-tabs\_\_content 会随着当前 nut-tabpane 的高度而发生变化。
+    * @default false
+    */
+    autoHeight: boolean
     children?: React.ReactNode;
 }
 export declare const Tabs: FunctionComponent<Partial<TabsProps>> & {

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

@@ -2,17 +2,65 @@ import { FunctionComponent } from 'react';
 import { TextareaProps } from '@tarojs/components';
 import { BasicComponent } from '../../utils/typings';
 export interface TextAreaProps extends Omit<TextareaProps, 'showCount' | 'onFocus' | 'onBlur'>, Omit<BasicComponent, 'style'> {
-    value: string;
-    defaultValue: string;
-    showCount: boolean;
-    maxLength: number;
-    rows: number;
-    placeholder: string;
-    readOnly: boolean;
-    disabled: boolean;
-    autoSize: boolean;
-    onChange: (value: string) => void;
-    onBlur: (event: Event) => void;
-    onFocus: (event: Event) => void;
+    /**
+    * 输入框内容，受控
+    * @default -
+    */
+    value: string
+    /**
+    * 初始默认值，非受控
+    * @default -
+    */
+    defaultValue: string
+    /**
+    * textarea 是否展示输入字符。须配合maxLength使用
+    * @default false
+    */
+    showCount: boolean
+    /**
+    * 限制最长输入字符，-1 表示无限制
+    * @default 140
+    */
+    maxLength: number
+    /**
+    * textarea 的行数（仅支持H5）
+    * @default 2
+    */
+    rows: number
+    /**
+    * 设置占位提示文字
+    * @default 请输入内容
+    */
+    placeholder: string
+    /**
+    * 只读属性
+    * @default false
+    */
+    readOnly: boolean
+    /**
+    * 禁用属性
+    * @default false
+    */
+    disabled: boolean
+    /**
+    * 高度是否可拉伸
+    * @default false
+    */
+    autoSize: boolean
+    /**
+    * 输入内容时触发
+    * @default -
+    */
+    onChange: (value: string) => void
+    /**
+    * 失焦时触发
+    * @default -
+    */
+    onBlur: (event: Event) => void
+    /**
+    * 聚焦时触发
+    * @default -
+    */
+    onFocus: (event: Event) => void
 }
 export declare const TextArea: FunctionComponent<Partial<TextAreaProps>>;

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

@@ -1,18 +1,60 @@
 import React, { FunctionComponent } from 'react';
-export interface TrendArrowProps {
-    rate: number;
-    digits: number;
-    showSign: boolean;
-    showZero: boolean;
-    arrowLeft: boolean;
-    syncTextColor: boolean;
-    textColor: string;
-    riseColor: string;
-    dropColor: string;
-    iconSize: string;
-    upIcon: React.ReactNode;
-    downIcon: React.ReactNode;
-    className: string;
-    style: React.CSSProperties;
+import { BasicComponent } from '../../utils/typings';
+export interface TrendArrowProps extends BasicComponent {
+    /**
+    * 数值，大于0时箭头向上，小于0时箭头向下
+    * @default -
+    */
+    value: number
+    /**
+    * 小数位精度
+    * @default 2
+    */
+    digits: number
+    /**
+    * 是否显示加减号
+    * @default false
+    */
+    symbol: boolean
+    /**
+    * 是否显示 0
+    * @default false
+    */
+    zero: boolean
+    /**
+    * 是否在数字左侧显示箭头
+    * @default false
+    */
+    arrowLeft: boolean
+    /**
+    * 文字颜色是否与箭头同步
+    * @default true
+    */
+    syncColor: boolean
+    /**
+    * 文字颜色
+    * @default #333333
+    */
+    color: string
+    /**
+    * 向上箭头颜色
+    * @default #fa2c19
+    */
+    riseColor: string
+    /**
+    * 向下箭头颜色
+    * @default #64b578
+    */
+    dropColor: string
+    /**
+    * 自定义向上箭头icon
+    * @default <TriangleUp/>
+    */
+    riseIcon: React.ReactNode
+    /**
+    * 自定义向下箭头icon
+    * @default <TriangleDown/>
+    */
+    downIcon: React.ReactNode
 }
 export declare const TrendArrow: FunctionComponent<Partial<TrendArrowProps> & React.HTMLAttributes<HTMLDivElement>>;

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

@@ -28,60 +28,192 @@ interface mediaType {
     video: string;
 }
 export interface UploaderProps extends BasicComponent {
-    url: string;
-    maxCount: string | number;
-    sizeType: (keyof sizeType)[];
-    sourceType: (keyof sourceType)[];
+    /**
+    * 上传服务器的接口地址
+    * @default -
+    */
+    url: string
+    /**
+    * 文件上传数量限制
+    * @default 1
+    */
+    maxCount: string | number
+    /**
+    * [是否压缩所选文件](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html)
+    * @default ['original','compressed']
+    */
+    sizeType: (keyof sizeType)[]
+    /**
+    * [选择文件的来源](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseMedia.html)
+    * @default ['album','camera']
+    */
+    sourceType: (keyof sourceType)[]
     mediaType: (keyof mediaType)[];
     camera: string;
-    maxFileSize: number;
-    defaultValue?: FileType<React.ReactNode>[];
-    value?: FileType<string>[];
-    previewType: 'picture' | 'list';
-    imageFit: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
-    uploadIcon?: React.ReactNode;
-    uploadLabel?: React.ReactNode;
-    name: string;
+    /**
+    * 可以设定最大上传文件的大小（字节）
+    * @default Number.MAX_VALUE
+    */
+    maxFileSize: number
+    /**
+    * 默认已经上传的文件列表
+    * @default []
+    */
+    defaultValue?: FileType<React.ReactNode>[]
+    /**
+    * 已经上传的文件列表
+    * @default []
+    */
+    value?: FileType<string>[]
+    /**
+    * 上传列表的内建样式，支持两种基本样式 picture、list
+    * @default 'picture'
+    */
+    previewType: 'picture' | 'list'
+    /**
+    * 图片填充模式
+    * @default 'cover'
+    */
+    imageFit: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down'
+    /**
+    * 上传区域[图标名称](#/zh-CN/icon)
+    * @default -
+    */
+    uploadIcon?: React.ReactNode
+    /**
+    * 上传区域图片下方文字
+    * @default ""
+    */
+    uploadLabel?: React.ReactNode
+    /**
+    * input 标签 name 的名称，发到后台的文件参数名
+    * @default 'file'
+    */
+    name: string
     accept: string;
-    disabled: boolean;
-    autoUpload: boolean;
-    multiple: boolean;
-    timeout: number;
-    data: object;
-    method: string;
-    xhrState: number | string;
-    headers: object;
-    preview: boolean;
-    deletable: boolean;
+    /**
+    * 是否禁用文件上传
+    * @default false
+    */
+    disabled: boolean
+    /**
+    * 是否在选取文件后立即进行上传，false 时需要手动执行 ref submit 方法进行上传
+    * @default true
+    */
+    autoUpload: boolean
+    /**
+    * 是否支持文件多选
+    * @default false
+    */
+    multiple: boolean
+    /**
+    * 超时时间，单位为毫秒
+    * @default 1000 * 30
+    */
+    timeout: number
+    /**
+    * 附加上传的信息 formData
+    * @default {}
+    */
+    data: object
+    /**
+    * 上传请求的 http method
+    * @default 'post'
+    */
+    method: string
+    /**
+    * 接口响应的成功状态（status）值
+    * @default 200
+    */
+    xhrState: number | string
+    /**
+    * 设置上传的请求头部
+    * @default {}
+    */
+    headers: object
+    /**
+    * 是否上传成功后展示预览图
+    * @default true
+    */
+    preview: boolean
+    /**
+    * 是否展示删除按钮
+    * @default true
+    */
+    deletable: boolean
     className: string;
-    previewUrl?: string;
+    /**
+    * 当上传非图片('image')格式的默认图片地址
+    * @default ''
+    */
+    previewUrl?: string
     maxDuration: number;
     style: React.CSSProperties;
-    onStart?: (option: UploadOptions) => void;
-    onDelete?: (file: FileItem, fileList: FileType<React.ReactNode>[]) => void;
+    /**
+    * 文件上传开始
+    * @default 
+    */
+    onStart?: (option: UploadOptions) => void
+    /**
+    * 文件删除之前的状态
+    * @default 
+    */
+    onDelete?: (file: FileItem, fileList: FileType<React.ReactNode>[]) => void
+    /**
+    * 上传成功
+    * @default 
+    */
     onSuccess?: (param: {
         responseText: XMLHttpRequest['responseText'];
         option: UploadOptions;
         fileList: FileType<React.ReactNode>[];
-    }) => void;
+    }) => void
+    /**
+    * 文件上传的进度
+    * @default 
+    */
     onProgress?: (param: {
         e: ProgressEvent<XMLHttpRequestEventTarget>;
         option: UploadOptions;
         percentage: React.ReactNode;
-    }) => void;
+    }) => void
+    /**
+    * 上传失败
+    * @default 
+    */
     onFailure?: (param: {
         responseText: XMLHttpRequest['responseText'];
         option: UploadOptions;
         fileList: FileType<React.ReactNode>[];
-    }) => void;
+    }) => void
     onUpdate?: (fileList: FileType<React.ReactNode>[]) => void;
-    onOversize?: (files: Taro.chooseImage.ImageFile[] | Taro.chooseMedia.ChooseMedia[] | any) => void;
+    /**
+    * 文件大小超过限制时触发
+    * @default 
+    */
+    onOversize?: (files: Taro.chooseImage.ImageFile[] | Taro.chooseMedia.ChooseMedia[] | any) => void
+    /**
+    * 上传文件改变时的状态
+    * @default 
+    */
     onChange?: (param: {
         fileList: FileType<React.ReactNode>[];
-    }) => void;
-    beforeXhrUpload?: (xhr: XMLHttpRequest, options: any) => void;
-    beforeDelete?: (file: FileItem, files: FileType<React.ReactNode>[]) => boolean;
-    onFileItemClick?: (file: FileItem) => void;
+    }) => void
+    /**
+    * 执行 XHR 上传时，自定义方式
+    * @default -
+    */
+    beforeXhrUpload?: (xhr: XMLHttpRequest, options: any) => void
+    /**
+    * 除文件时的回调，返回值为 false 时不移除。支持返回一个 Promise 对象，Promise 对象 resolve(false) 或 reject 时不移除
+    * @default - 
+    */
+    beforeDelete?: (file: FileItem, files: FileType<React.ReactNode>[]) => boolean
+    /**
+    * 文件上传成功后点击触发
+    * @default 
+    */
+    onFileItemClick?: (file: FileItem) => void
 }
 export declare class FileItem {
     status: FileItemStatus;

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

@@ -1,2 +1,3 @@
-import { Video } from './video';
+import { Video } from './video.taro';
+export type { VideoProps } from './video.taro';
 export default Video;

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

@@ -0,0 +1,41 @@
+import React, { FunctionComponent } from 'react';
+import { BaseEventOrig } from '@tarojs/components';
+import { BasicComponent } from '../../utils/typings';
+export interface VideoProps extends BasicComponent {
+    /**
+    * 视频地址和类型设置
+    * @default {type: {}, src: ''}
+    */
+    source: {
+        type: string;
+        src: string;
+    }
+    /**
+    * 控制视频播放属性
+    * @default -
+    */
+    options: {
+        controls?: boolean;
+        muted?: boolean;
+        autoplay?: boolean;
+        poster?: string;
+        playsinline?: boolean;
+        loop?: boolean;
+    }
+    /**
+    * 播放
+    * @default -
+    */
+    onPlay: (event: BaseEventOrig<any>) => void
+    /**
+    * 暂停
+    * @default -
+    */
+    onPause: (event: BaseEventOrig<any>) => void
+    /**
+    * 播放完成回调
+    * @default -
+    */
+    onPlayEnd: (event: BaseEventOrig<any>) => void
+}
+export declare const Video: FunctionComponent<Partial<VideoProps> & Omit<React.HTMLAttributes<HTMLDivElement>, 'onPause' | 'onPlay'>>;

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

@@ -2,13 +2,45 @@ import React, { FunctionComponent } from 'react';
 import { Data } from './type';
 import { BasicComponent } from '../../utils/typings';
 export interface VirtualListProps extends BasicComponent {
-    list: Array<Data>;
-    containerHeight: number;
-    ItemRender: React.FC<any>;
-    itemHeight: number;
-    itemEqual: boolean;
-    overscan: number;
-    onScroll: () => void;
-    key: string;
+    /**
+    * 获取数据
+    * @default -
+    */
+    list: Array<Data>
+    /**
+    * 容器高度
+    * @default 获取元素的 offsetWidth 或 offsetHeight，需要 css 给出
+    */
+    containerHeight: number
+    /**
+    * virtual 列表父节点渲染的函数
+    * @default -
+    */
+    ItemRender: React.FC<any>
+    /**
+    * item 高度，如果不定高，则为首屏单个最大 height
+    * @default 66
+    */
+    itemHeight: number
+    /**
+    * item 高度是否一致
+    * @default true
+    */
+    itemEqual: boolean
+    /**
+    * 除了视窗里面默认的元素, 还需要额外渲染的 item 个数
+    * @default 2
+    */
+    overscan: number
+    /**
+    * 滑动到底的事件，可以实现无限滚动
+    * @default -
+    */
+    onScroll: () => void
+    /**
+    * 用于指定 list 数据每一项的唯一 key 的字段名，默认取下标
+    * @default -
+    */
+    key: string
 }
 export declare const VirtualList: FunctionComponent<Partial<VirtualListProps>>;

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

@@ -1,2 +1,3 @@
 import { WaterMark } from './watermark.taro';
+export type { WaterMarkProps } from './watermark.taro';
 export default WaterMark;