Skip to content
本页导读

Numberbox

组件类型:UxNumberboxComponentPublicInstance

支持整数、小数步进,可长按快速步进

平台兼容性

UniApp X

AndroidiOSweb鸿蒙 Next小程序
x

UniApp Vue Nvue

AndroidiOSweb鸿蒙 Next小程序
xxxx

Props

属性名类型默认值说明
nameString标识符,在回调事件中返回
themeString主题颜色
colorString$ux.Conf.placeholderColor颜色
darkColorString深色none-不显示,auto-自动适配深色模式,其他-颜色
inputColorString$ux.Conf.placeholderColor输入框背景颜色
inputDarkColorString深色none-不显示,auto-自动适配深色模式,其他-颜色
fontColorString$ux.Conf.placeholderColor输入框背景颜色
fontDarkColorString深色none-不显示,auto-自动适配深色模式,其他-颜色
valueNumber
minNumber0最小值
maxNumber999999999最大值
stepNumber1步长
decimalBoolean允许输入小数默认false)
precisionNumber1小数点精度
widthAny50输入框宽度
radiusBooleanfalse圆角按钮
minusBooleantrue显示-按钮
plusBooleantrue显示+按钮
longpressBooleantrue开启长按加减手势
disablePlusBooleanfalse禁用+
disableMinusBooleanfalse禁用-
disabledBooleanfalse禁用
marginArray边距[上右下左][上下左右][上下左右]
mtAny距上单位px
mrAny距右单位px
mbAny距下单位px
mlAny距左单位px
paddingArray填充[上右下左][上下左右][上下左右]
ptAny上内边距单位px
prAny右内边距单位px
pbAny下内边距单位px
plAny左内边距单位px
xstyleArray自定义样式

theme

说明
primary主色
warning警告
success成功
error错误
info文本

darkColor

说明
none不显示
auto自动适配深色模式
color其他颜色

inputDarkColor

说明
none不显示
auto自动适配深色模式
color其他颜色

fontDarkColor

说明
none不显示
auto自动适配深色模式
color其他颜色

decimal

说明
true
false

radius

说明
true
false

minus

说明
true
false

plus

说明
true
false

longpress

说明
true
false

disablePlus

说明
true
false

disableMinus

说明
true
false

Events

事件名说明参数
change值改变时触发

示例代码

html
<template>
	<ux-page :stack="showDoc">
		<ux-navbar :title="title" :bold="true">
			<template v-slot:right>
				<!-- #ifndef MP -->
				<ux-button theme="text" icon="/static/tip.png" :icon-size="22" @click="onDoc()"></ux-button>
				<!-- #endif -->
			</template>
		</ux-navbar>
		
		<ux-scroll>
			<ux-card direction="column" icon="flag-filled" title="步进器" :bold="true">
				<ux-text text="支持整数、小数步进,可长按快速步进"></ux-text>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="主题" :bold="true">
				<ux-text text="多种主题可配置,适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-numberbox theme="primary"</ux-numberbox>
					<ux-numberbox theme="warning" :ml="30"></ux-numberbox>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="样式" :bold="true">
				<ux-text text="支持配置输入框宽度、按钮圆角、+-按钮显示" :mb="15"></ux-text>
				<ux-col>
					<ux-numberbox :value="99" :width="80" input-color="#a90000" input-dark-color="#a90000" font-color="white" font-dark-color="white"></ux-numberbox>
					<ux-numberbox :radius="true" :mt="10"></ux-numberbox>
					<ux-numberbox :minus="false" :mt="10"></ux-numberbox>
					<ux-numberbox :plus="false" :min="-10" :mt="10"></ux-numberbox>
				</ux-col>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="步进" :bold="true">
				<ux-text text="支持整数、小数步进,可控制小数精度、最大值和最小值" :mb="15"></ux-text>
				<ux-row>
					<ux-numberbox :step="5" :min="-30" :max="30"></ux-numberbox>
					<ux-numberbox :decimal="true" :step="0.1" :precision="2" :min="-10" :max="10" :ml="30"></ux-numberbox>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="长按步进" :bold="true">
				<ux-text text="开启长按手势可快速步进" :mb="15"></ux-text>
				<ux-row>
					<ux-numberbox :longpress="true"></ux-numberbox>
					<ux-numberbox :longpress="true" :decimal="true" :step="0.1" :ml="30"></ux-numberbox>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="禁用" :bold="true">
				<ux-text text="支持分别单独禁用+-按钮、输入框" :mb="15"></ux-text>
				<ux-col>
					<ux-numberbox :disabled="true"></ux-numberbox>
					<ux-numberbox :disable-minus="true" theme="primary" :mt="10"></ux-numberbox>
					<ux-numberbox :disable-plus="true" theme="warning" :min="-10" :mt="10"></ux-numberbox>
				</ux-col>
			</ux-card>
			
			<ux-placeholder :height="200">
				<ux-row justify="center" align="center" style="height: 100%;">
					<ux-text prefix-icon="soapbubble-filled" text="真的没有了~"></ux-text>
				</ux-row>
			</ux-placeholder>
		</ux-scroll>
	</ux-page>
</template>
<template>
	<ux-page :stack="showDoc">
		<ux-navbar :title="title" :bold="true">
			<template v-slot:right>
				<!-- #ifndef MP -->
				<ux-button theme="text" icon="/static/tip.png" :icon-size="22" @click="onDoc()"></ux-button>
				<!-- #endif -->
			</template>
		</ux-navbar>
		
		<ux-scroll>
			<ux-card direction="column" icon="flag-filled" title="步进器" :bold="true">
				<ux-text text="支持整数、小数步进,可长按快速步进"></ux-text>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="主题" :bold="true">
				<ux-text text="多种主题可配置,适配暗黑模式" :mb="15"></ux-text>
				<ux-row>
					<ux-numberbox theme="primary"</ux-numberbox>
					<ux-numberbox theme="warning" :ml="30"></ux-numberbox>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="样式" :bold="true">
				<ux-text text="支持配置输入框宽度、按钮圆角、+-按钮显示" :mb="15"></ux-text>
				<ux-col>
					<ux-numberbox :value="99" :width="80" input-color="#a90000" input-dark-color="#a90000" font-color="white" font-dark-color="white"></ux-numberbox>
					<ux-numberbox :radius="true" :mt="10"></ux-numberbox>
					<ux-numberbox :minus="false" :mt="10"></ux-numberbox>
					<ux-numberbox :plus="false" :min="-10" :mt="10"></ux-numberbox>
				</ux-col>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="步进" :bold="true">
				<ux-text text="支持整数、小数步进,可控制小数精度、最大值和最小值" :mb="15"></ux-text>
				<ux-row>
					<ux-numberbox :step="5" :min="-30" :max="30"></ux-numberbox>
					<ux-numberbox :decimal="true" :step="0.1" :precision="2" :min="-10" :max="10" :ml="30"></ux-numberbox>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="长按步进" :bold="true">
				<ux-text text="开启长按手势可快速步进" :mb="15"></ux-text>
				<ux-row>
					<ux-numberbox :longpress="true"></ux-numberbox>
					<ux-numberbox :longpress="true" :decimal="true" :step="0.1" :ml="30"></ux-numberbox>
				</ux-row>
			</ux-card>
			
			<ux-card direction="column" icon="arrowright" title="禁用" :bold="true">
				<ux-text text="支持分别单独禁用+-按钮、输入框" :mb="15"></ux-text>
				<ux-col>
					<ux-numberbox :disabled="true"></ux-numberbox>
					<ux-numberbox :disable-minus="true" theme="primary" :mt="10"></ux-numberbox>
					<ux-numberbox :disable-plus="true" theme="warning" :min="-10" :mt="10"></ux-numberbox>
				</ux-col>
			</ux-card>
			
			<ux-placeholder :height="200">
				<ux-row justify="center" align="center" style="height: 100%;">
					<ux-text prefix-icon="soapbubble-filled" text="真的没有了~"></ux-text>
				</ux-row>
			</ux-placeholder>
		</ux-scroll>
	</ux-page>
</template>
ts
<script setup>
	
	import * as plus from '@/uni_modules/ux-plus'
	
	const title = ref('')
	const showDoc = ref(false)
	
	function onDoc() {
		plus.openWeb({
			title: '在线文档',
			url: 'https://www.uxframe.cn/component/numberbox.html',
			// blur: 1,
			success: () => {
				showDoc.value = true
			},
			complete: () => {
				showDoc.value = false
			}
		})
	}
	
	onLoad((e) => {
		title.value = e['title'] ?? ''
	})
	
</script>
<script setup>
	
	import * as plus from '@/uni_modules/ux-plus'
	
	const title = ref('')
	const showDoc = ref(false)
	
	function onDoc() {
		plus.openWeb({
			title: '在线文档',
			url: 'https://www.uxframe.cn/component/numberbox.html',
			// blur: 1,
			success: () => {
				showDoc.value = true
			},
			complete: () => {
				showDoc.value = false
			}
		})
	}
	
	onLoad((e) => {
		title.value = e['title'] ?? ''
	})
	
</script>
css
<style lang="scss">
	
</style>
<style lang="scss">
	
</style>