UNPKG

@ray-js/smart-ui-typings

Version:

@ray-js/smart-ui 智能小程序 UI 框架的类型声明文件

333 lines (332 loc) 7.43 kB
/// <reference types="wechat-miniprogram" /> import { TouchPositionDetail, VantComponent, VantEventHandler } from '../base'; export interface VantFieldProps { /** * 在表单内提交时的标识符 */ name?: string; /** * 输入框左侧文本 */ label?: string; /** * 单元格大小 */ size?: 'large'; /** * 当前输入的值 */ value?: string | number; /** * 可设置为任意原生类型 * * @default 'text' */ type?: 'number' | 'idcard' | 'textarea' | 'digit' | 'text' | 'safe-password' | 'nickname'; /** * 如果`type`为`textarea`且在一个`position:fixed`的区域,需要显示指定属性`fixed`为`true` * * @default false */ fixed?: boolean; /** * 获取焦点 * * @default false */ focus?: boolean; /** * 是否显示内边框 * * @default true */ border?: boolean; /** * 是否禁用输入框 * * @default false */ disabled?: boolean; /** * 是否只读 * * @default false */ readonly?: boolean; /** * 是否启用清除控件 * * @default false */ clearable?: boolean; /** * 是否开启点击反馈 * * @default false */ clickable?: boolean; /** * 是否显示表单必填星号 * * @default false */ required?: boolean; /** * 是否使内容垂直居中 * * @default false */ center?: boolean; /** * 是否是密码类型 * * @default false */ password?: boolean; /** * 标题宽度 * * @default '6.2em' */ titleWidth?: string; /** * 最大输入长度,设置为`-1`的时候不限制最大长度 * * @default -1 */ maxlength?: number; /** * 输入框为空时占位符 */ placeholder?: string; /** * 指定`placeholder`的样式 */ 'placeholderStyle'?: string; /** * 自定义样式 */ 'customStyle'?: string; /** * 是否展示右侧箭头并开启点击反馈 * * @default false */ 'isLink'?: boolean; /** * 箭头方向 */ 'arrowDirection'?: 'left' | 'up' | 'down'; /** * 是否显示字数统计,需要设置`maxlength`属性 * * @default false */ 'showWordLimit'?: boolean; /** * 是否将输入内容标红 * * @default false */ error?: boolean; /** * 底部错误提示文案,为空时不展示 * * @default '' */ 'errorMessage'?: string; /** * 底部错误提示文案对齐方式 * * @default '' */ 'errorMessageAlign'?: 'center' | 'right'; /** * 输入框内容对齐方式 * * @default 'left' */ 'inputAlign'?: 'center' | 'right' | 'left'; /** * 是否自适应内容高度,只对`textarea`有效,可传入对象。 * * 单位为`px` * * @default false */ autosize?: boolean | { maxHeight?: number; minHeight?: number; }; /** * 左侧图标名称或图片链接,可选值见`Icon`组件 */ 'leftIcon'?: string; /** * 右侧图标名称或图片链接,可选值见`Icon`组件 */ 'rightIcon'?: string; /** * 设置键盘右下角按钮的文字,仅在`type='text'`时生效 * * @default 'done' */ 'confirmType'?: string; /** * 点击键盘右下角按钮时是否保持键盘不收起,在`type='textarea'`时无效 * * @default false */ 'confirmHold'?: boolean; /** * `focus`时,点击页面的时候不收起键盘 * * @default false */ 'holdKeyboard'?: boolean; /** * 输入框聚焦时底部与键盘的距离 * * @default 50 */ 'cursorSpacing'?: number; /** * 键盘弹起时,是否自动上推页面 * * @default true */ 'adjustPosition'?: boolean; /** * 是否显示键盘上方带有”完成“按钮那一栏,只对`textarea`有效 * * @default true */ 'showConfirmBar'?: boolean; /** * 光标起始位置,自动聚集时有效,需与`selection-end`搭配使用 * * @default -1 */ 'selectionStart'?: number; /** * 光标结束位置,自动聚集时有效,需与`selection-start`搭配使用 * * @default -1 */ 'selectionEnd'?: number; /** * 自动聚焦,拉起键盘 * * @default false */ 'autoFocus'?: boolean; /** * 是否去掉`iOS`下的默认内边距,只对`textarea`有效 * * @default true */ 'disableDefaultPadding'?: boolean; /** * 指定 `focus` 时的光标位置 * * @default -1 */ cursor?: number; /** * 显示清除图标的时机,`always` 表示输入框不为空时展示, * `focus` 表示输入框聚焦且不为空时展示 * * @version v1.8.4 * * @default 'focus' */ 'clearTrigger'?: 'always' | 'focus'; /** * 强制 `input` 处于同层状态,默认 `focus` 时 `input` 会切到非同层状态 (仅在 `iOS` 下生效) * * @version `v1.9.2` * * @default false */ 'alwaysEmbed'?: boolean; } /** * @deprecated */ export interface VantFieldInputEvent extends WechatMiniprogram.BaseEvent { detail: string; } export interface VantFieldFocusEventDetail { value: string; height: number; } export interface VantFieldBlurEventDetail { value: string; cursor: number; } export interface VantFieldLineChangeEventDetail { height: number; heightRpx: number; lineCount: number; } export interface VantFieldKeyboardHeightChangeEventDetail { height: number; duration: number; } export interface VantFieldEvents { /** * 输入内容时触发 */ onInput?: VantEventHandler<string>; /** * 输入内容时触发 */ onChange?: VantEventHandler<string>; /** * 点击完成按钮时触发 */ onConfirm?: VantEventHandler<string>; /** * 点击尾部图标时触发 */ onClickIcon?: VantEventHandler; /** * 输入框聚焦时触发 */ onFocus?: VantEventHandler<VantFieldFocusEventDetail>; /** * 输入框失焦时触发1 */ onBlur?: VantEventHandler<VantFieldBlurEventDetail>; /** * 点击清空控件时触发 */ onClear?: VantEventHandler; /** * 点击输入区域时触发 */ onClickInput?: VantEventHandler<TouchPositionDetail>; /** * 输入框行数变化时调用,只对 `textarea` 有效 */ onLinechange?: VantEventHandler<VantFieldLineChangeEventDetail>; /** * 键盘高度发生变化的时候触发此事件 */ onKeyboardheightchange?: VantEventHandler<VantFieldKeyboardHeightChangeEventDetail>; } export interface VantFieldExternalClassName { /** * 左侧文本样式类 */ labelClass?: string; /** * 输入框样式类 */ inputClass?: string; /** * 右侧图标样式类 */ rightIconClass?: string; } export type VantField = VantComponent<VantFieldProps, VantFieldEvents, VantFieldExternalClassName>;