RangeInput 范围输入框

-

基础范围输入框

-

不同尺寸的标签输入框

提供大、中(默认)、小三种不同尺寸的的标签输入框。

-
-
-

不同状态的标签输入框

标签输入框状态可分为:正常、只读、禁用、成功、告警、错误等,其中 成功、告警、错误 等状态一般用于表单验证。此特性继承至 Input 输入框组件。

-
-
-

与 Popup 组件搭配使用

可使用 RangeInputPopup 组件

-

RangeInput Props

名称类型默认值描述必传
activeIndexNumber-输入框高亮状态序号N
borderlessBooleanfalse无边框模式N
clearableBooleanfalse是否可清空N
disabledBooleanundefined是否禁用范围输入框N
formatArray / Function-指定输入框展示值的格式。TS 类型:InputFormatType | Array<InputFormatType>N
inputPropsObject / Array-透传 Input 输入框组件全部属性,数组第一项表示第一个输入框属性,第二项表示第二个输入框属性。示例:[{ label: 'A', name: 'A-name' }, { label: 'B', name: 'B-name' }]。TS 类型:InputProps | Array<InputProps>Input API Documents详细类型定义N
labelString / Slot / Function-左侧内容。TS 类型:string | TNode通用类型定义N
placeholderString / Array-占位符,示例:'请输入' 或者 ['开始日期', '结束日期']。TS 类型:string | Array<string>N
prefixIconSlot / Function-组件前置图标。TS 类型:TNode通用类型定义N
readonlyBooleanfalse只读状态N
separatorString / Slot / Function'-'范围分隔符。TS 类型:string | TNode通用类型定义N
showClearIconOnEmptyBooleanfalse输入框内容为空时,悬浮状态是否显示清空按钮,默认不显示N
sizeStringmedium输入框尺寸。可选项:small/medium/largeN
statusStringdefault输入框状态。可选项:default/success/warning/errorN
suffixString / Slot / Function-后置图标前的后置内容。TS 类型:string | TNode通用类型定义N
suffixIconSlot / Function-组件后置图标。TS 类型:TNode通用类型定义N
tipsString / Slot / Function-输入框下方提示文本,会根据不同的 status 呈现不同的样式。TS 类型:string | TNode通用类型定义N
valueArray[]范围输入框的值。支持语法糖 v-model。TS 类型:RangeInputValue type RangeInputValue = Array<InputValue>详细类型定义N
defaultValueArray[]范围输入框的值。非受控属性。TS 类型:RangeInputValue type RangeInputValue = Array<InputValue>详细类型定义N
onBlurFunctionTS 类型:(value: RangeInputValue, context?: { e?: FocusEvent; position?: RangeInputPosition }) => void
范围输入框失去焦点时触发
N
onChangeFunctionTS 类型:(value: RangeInputValue, context?: { e?: InputEvent | MouseEvent | CompositionEvent; position?: RangeInputPosition; trigger?: 'input' | 'initial' | 'clear' }) => void
范围输入框值发生变化时触发。详细类型定义
type RangeInputPosition = 'first' | 'second' | 'all'
N
onClearFunctionTS 类型:(context: { e: MouseEvent }) => void
清空按钮点击时触发
N
onClickFunctionTS 类型:(context?: { e?: MouseEvent; position?: RangeInputPosition }) => void
范围输入框点击时触发
N
onEnterFunctionTS 类型:(value: RangeInputValue, context?: { e?: InputEvent | MouseEvent; position?: RangeInputPosition }) => void
回车键按下时触发
N
onFocusFunctionTS 类型:(value: RangeInputValue, context?: { e?: FocusEvent; position?: RangeInputPosition }) => void
范围输入框获得焦点时触发
N
onMouseenterFunctionTS 类型:(context: { e: MouseEvent }) => void
进入输入框时触发
N
onMouseleaveFunctionTS 类型:(context: { e: MouseEvent }) => void
离开输入框时触发
N

RangeInput Events

名称参数描述
blur(value: RangeInputValue, context?: { e?: FocusEvent; position?: RangeInputPosition })范围输入框失去焦点时触发
change(value: RangeInputValue, context?: { e?: InputEvent | MouseEvent | CompositionEvent; position?: RangeInputPosition; trigger?: 'input' | 'initial' | 'clear' }) 范围输入框值发生变化时触发。详细类型定义
type RangeInputPosition = 'first' | 'second' | 'all'
clear(context: { e: MouseEvent })清空按钮点击时触发
click(context?: { e?: MouseEvent; position?: RangeInputPosition })范围输入框点击时触发
enter(value: RangeInputValue, context?: { e?: InputEvent | MouseEvent; position?: RangeInputPosition }) 回车键按下时触发
focus(value: RangeInputValue, context?: { e?: FocusEvent; position?: RangeInputPosition })范围输入框获得焦点时触发
mouseenter(context: { e: MouseEvent })进入输入框时触发
mouseleave(context: { e: MouseEvent })离开输入框时触发

RangeInputInstanceFunctions 组件实例方法

名称参数返回值描述
blur(options?: {position?: RangeInputPosition})-使其中一个输入框失去焦点
focus(options?: {position?: RangeInputPosition})-使其中一个输入框获得焦点
select(options?: {position?: RangeInputPosition})-使其中一个输入框选中内容

RangeInputPopup Props

名称类型默认值描述必传
autoWidthBooleanfalse宽度随内容自适应N
disabledBoolean-是否禁用范围输入框,值为数组表示可分别控制某一个输入框是否禁用N
inputValueArray-输入框的值。支持语法糖 .sync。TS 类型:RangeInputValueN
defaultInputValueArray-输入框的值。非受控属性。TS 类型:RangeInputValueN
labelString / Slot / Function-左侧文本。TS 类型:string | TNode通用类型定义N
panelString / Slot / Function-下拉框内容,可完全自定义。TS 类型:string | TNode通用类型定义N
popupPropsObject-透传 Popup 浮层组件全部属性。TS 类型:PopupPropsPopup API Documents详细类型定义N
popupVisibleBoolean-是否显示下拉框N
rangeInputPropsObject-透传 RangeInput 组件全部属性。TS 类型:RangeInputPropsRangeInput API Documents详细类型定义N
readonlyBooleanfalse只读状态,值为真会隐藏输入框,且无法打开下拉框N
statusStringdefault输入框状态。可选项:default/success/warning/errorN
tipsString / Slot / Function-输入框下方提示文本,会根据不同的 status 呈现不同的样式。TS 类型:string | TNode通用类型定义N
onInputChangeFunctionTS 类型:(value: RangeInputValue, context?: RangeInputValueChangeContext) => void
输入框值发生变化时触发,context.trigger 表示触发输入框值变化的来源:文本输入触发、清除按钮触发等。详细类型定义
type RangeInputValueChangeContext = { e?: InputEvent | MouseEvent; trigger?: 'input' | 'clear', position?: RangeInputPosition }
N
onPopupVisibleChangeFunctionTS 类型:(visible: boolean, context: PopupVisibleChangeContext) => void
下拉框显示或隐藏时触发。详细类型定义
import { PopupVisibleChangeContext } from '@Popup'
N

RangeInputPopup Events

名称参数描述
input-change(value: RangeInputValue, context?: RangeInputValueChangeContext) 输入框值发生变化时触发,context.trigger 表示触发输入框值变化的来源:文本输入触发、清除按钮触发等。详细类型定义
type RangeInputValueChangeContext = { e?: InputEvent | MouseEvent; trigger?: 'input' | 'clear', position?: RangeInputPosition }
popup-visible-change(visible: boolean, context: PopupVisibleChangeContext)下拉框显示或隐藏时触发。详细类型定义
import { PopupVisibleChangeContext } from '@Popup'
  • small
  • medium
  • large
  • default
  • success
  • warning
  • error