Stepper 步进器

介绍

步进器由增加按钮、减少按钮和输入框组成，用于在一定范围内输入、调整数字。

引入

import { Stepper } from "@taroify/core";

基础用法

<Stepper />

步长设置

通过 step 属性设置每次点击增加或减少按钮时变化的值，默认为 1。

<Stepper step={2} />

限制输入范围

通过 min 和 max 属性限制输入值的范围。

<Stepper min={5} max={8} />

禁用状态

通过设置 disabled 属性来禁用步进器，禁用状态下无法点击按钮或修改输入框。

<Stepper disabled />

禁用输入框

通过设置 Stepper.Input 组件的 disabled 属性来禁用输入框，此时按钮仍然可以点击。

<Stepper>
  <Stepper.Button />
  <Stepper.Input disabled />
  <Stepper.Button />
</Stepper>

固定小数位数

通过设置 precision 属性可以保留固定的小数位数。

<Stepper precision={2} />

自定义大小

通过 Stepper.Input 组件的 width 属性设置输入框宽度，通过 size 属性设置按钮大小和输入框高度。

<Stepper size="32">
  <Stepper.Button />
  <Stepper.Input disabled width="40" />
  <Stepper.Button />
</Stepper>

圆角风格

将 shape 设置为 circular 来展示圆角风格的步进器。

<Stepper shape="circular" size="22" />

Stepper Props

Stepper.Input Props

Stepper.Button Props

Events

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。