InputNumber (compteur)
LhInputNumber permet de saisir des nombres, avec prise en charge des limites de plage, du pas et de la précision.
Utilisation de base
Utilisation de base
vue
<script setup lang="ts">
import { ref } from 'vue'
import { LhInputNumber } from '@lh-ui/vue3'
const count = ref(0)
</script>
<template>
<LhInputNumber v-model="count" />
</template>vue
<script>
import { LhInputNumber } from '@lh-ui/vue3'
export default {
components: { LhInputNumber },
data() {
return {
count: 0
}
}
}
</script>
<template>
<LhInputNumber v-model="count" />
</template>Limites de plage
Limites de plage
vue
<script setup lang="ts">
import { ref } from 'vue'
import { LhInputNumber } from '@lh-ui/vue3'
const level = ref(5)
</script>
<template>
<LhInputNumber v-model="level" :min="1" :max="10" />
</template>vue
<script>
import { LhInputNumber } from '@lh-ui/vue3'
export default {
components: { LhInputNumber },
data() {
return {
level: 5
}
}
}
</script>
<template>
<LhInputNumber v-model="level" :min="1" :max="10" />
</template>Thème personnalisé
Applique la palette 青花瓷 (porcelaine bleue et blanche).
Thème 青花瓷 (porcelaine bleue et blanche)
vue
<script setup lang="ts">
import { ref } from 'vue'
import { LhConfigProvider, LhInputNumber } from '@lh-ui/vue3'
const count = ref(0)
const cerblueTheme = {
'primary-color': '#2B4C7C',
'primary-color-hover': '#3D649E',
'primary-color-bg': '#E8EDF3',
}
</script>
<template>
<LhConfigProvider :theme-vars="cerblueTheme">
<LhInputNumber v-model="count" />
</LhConfigProvider>
</template>vue
<script>
import { LhConfigProvider, LhInputNumber } from '@lh-ui/vue3'
export default {
data() {
return {
count: 0,
cerblueTheme: {
'primary-color': '#2B4C7C',
'primary-color-hover': '#3D649E',
'primary-color-bg': '#E8EDF3',
},
}
},
}
</script>
<template>
<LhConfigProvider :theme-vars="cerblueTheme">
<LhInputNumber v-model="count" />
</LhConfigProvider>
</template>Internationalisation
Internationalisation
vue
<script setup lang="ts">
import { ref } from 'vue'
import { LhConfigProvider, LhInputNumber } from '@lh-ui/vue3'
import { zhCN } from '@lh-ui/vue3'
import { enUS } from '@lh-ui/vue3'
const locale = ref('zh-CN')
const count = ref(0)
</script>
<template>
<!-- Configuration du paquet de langue -->
<LhConfigProvider :locale="locale === 'zh-CN' ? zhCN : enUS">
<!-- Le texte de remplacement change avec la langue -->
<LhInputNumber v-model="count" :placeholder="locale === 'zh-CN' ? '请输入数字' : 'Enter number'" />
</LhConfigProvider>
</template>vue
<script>
import { LhConfigProvider, LhInputNumber } from '@lh-ui/vue3'
import { zhCN } from '@lh-ui/vue3'
import { enUS } from '@lh-ui/vue3'
export default {
data() {
return {
locale: 'zh-CN',
count: 0,
zhCN: zhCN,
enUS: enUS,
}
},
}
</script>
<template>
<!-- Configuration du paquet de langue -->
<LhConfigProvider :locale="locale === 'zh-CN' ? zhCN : enUS">
<!-- Le texte de remplacement change avec la langue -->
<LhInputNumber v-model="count" :placeholder="locale === 'zh-CN' ? '请输入数字' : 'Enter number'" />
</LhConfigProvider>
</template>Pas et précision
Pas et précision
vue
<script setup lang="ts">
import { ref } from 'vue'
const value = ref<number | null>(1)
</script>
<template>
<LhInputNumber v-model="value" :step="2" />
<LhInputNumber v-model="value" :precision="2" placeholder="2 décimales" />
<LhInputNumber v-model="value" :step="10" step-strictly placeholder="Multiples de 10 uniquement" />
</template>vue
<script>
export default {
data() {
return { value: 1 }
},
}
</script>
<template>
<LhInputNumber v-model="value" :step="2" />
<LhInputNumber v-model="value" :precision="2" placeholder="2 décimales" />
<LhInputNumber v-model="value" :step="10" step-strictly placeholder="Multiples de 10 uniquement" />
</template>Tailles et boutons de contrôle
Tailles et boutons de contrôle
vue
<script setup lang="ts">
import { ref } from 'vue'
const value = ref<number | null>(1)
</script>
<template>
<LhInputNumber v-model="value" size="small" />
<LhInputNumber v-model="value" size="medium" />
<LhInputNumber v-model="value" size="large" />
<LhInputNumber v-model="value" :controls="false" placeholder="Sans boutons de contrôle" />
</template>vue
<script>
export default {
data() {
return { value: 1 }
},
}
</script>
<template>
<LhInputNumber v-model="value" size="small" />
<LhInputNumber v-model="value" size="medium" />
<LhInputNumber v-model="value" size="large" />
<LhInputNumber v-model="value" :controls="false" placeholder="Sans boutons de contrôle" />
</template>Désactivé et nom de champ
Désactivé et nom de champ
vue
<script setup lang="ts">
import { ref } from 'vue'
const value = ref<number | null>(1)
</script>
<template>
<LhInputNumber v-model="value" disabled />
<LhInputNumber v-model="value" name="quantity" placeholder="name=quantity" />
</template>vue
<script>
export default {
data() {
return { value: 1 }
},
}
</script>
<template>
<LhInputNumber v-model="value" disabled />
<LhInputNumber v-model="value" name="quantity" placeholder="name=quantity" />
</template>API InputNumber
Props
| Prop | Description | Type | Valeur par défaut |
|---|---|---|---|
| modelValue | Valeur actuelle | number | null |
| min | Valeur minimale | number | -Infinity |
| max | Valeur maximale | number | Infinity |
| step | Pas | number | 1 |
| stepStrictly | La valeur saisie doit être un multiple de step | boolean | false |
| precision | Précision numérique | number | — |
| disabled | Désactivé | boolean | false |
| size | Taille | "small" | "medium" | "large" | "mini" | "x-large" | 'medium' |
| controls | Afficher les boutons de contrôle | boolean | true |
| placeholder | Texte de remplacement | string | '' |
| name | Nom du champ natif | string | '' |
| sx | Props de mise en page sx (ex. { mt: 2, w: '50%' }), converties en styles inline appliqués à l'élément racine | LhSxProps | — |
Events
| Événement | Description | Paramètre |
|---|---|---|
| update:modelValue | La valeur a changé | value: number |
| change | La changement de valeur est confirmé | value: number |
Les flèches haut et bas du clavier permettent d'incrémenter et de décrémenter la valeur.
Définitions de types
Ce composant exporte les structures de types TypeScript suivantes (extraites automatiquement de packages/components/input-number/src/types.ts et des sources @lh-ui/share/core/* ; cliquez sur chaque entrée pour déplier la définition complète ; la description des props se trouve dans le tableau Props ci-dessus) :
LhInputNumberProps
ts
export interface LhInputNumberProps {
modelValue?: number | null
min?: number
max?: number
step?: number
stepStrictly?: boolean
precision?: number
disabled?: boolean
size?: LhComponentSize
controls?: boolean
placeholder?: string
name?: string
/** Props de mise en page sx */
sx?: LhSxProps
}LhInputNumberSize
ts
export type LhInputNumberSize = LhComponentSizeLhComponentSize (provenant de @lh-ui/share/core/shared)
ts
export type LhComponentSize = (typeof LH_SIZE_CONST)[keyof typeof LH_SIZE_CONST]