@td-design/react-native/lib/module/slider/index.md

react-native UI组件库

---
title: Slider - 滑块组件
nav:
  title: RN组件
  path: /react-native
group:
  title: 表单组件
  path: /form
---

# Slider 滑块组件

## 效果演示

### 1. 默认效果

```tsx | pure
<Slider />
```

<center>
  <figure>
    <img
      alt="slider-ios1.gif"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1608032620330195137.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 2. 默认值 45

```tsx | pure
<Slider value={45} />
```

<center>
  <figure>
    <img
      alt="slider-io21.gif"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1608032749566957647.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 3. 最大最小值

```tsx | pure
<Slider min={20} max={80} />
```

<center>
  <figure>
    <img
      alt="slider-ios3.gif"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1608032808179563288.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 4. 自定义颜色

```tsx | pure
<Slider value={45} foregroundColor="gold" backgroundColor="red" borderColor="blue" handleBackground="pink" />
```

<center>
  <figure>
    <img
      alt="slider-ios4.gif"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1608032929313069066.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 5. 不显示滑块数字

```tsx | pure
<Slider value={45} showLabel={false} />
```

<center>
  <figure>
    <img
      alt="slider-ios5.gif"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1608033028156894177.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

### 6. 数字在右边

```tsx | pure
<Slider value={45} labelPosition="right" />
```

<center>
  <figure>
    <img
      alt="slider-ios6.gif"
      src="https://td-dev-public.oss-cn-hangzhou.aliyuncs.com/maoyes-app/1608033111344004697.gif"
      style="width: 375px; margin-right: 10px; border: 1px solid #ddd;"
    />
  </figure>
</center>

## API

| 属性             | 必填    | 说明               | 类型                                   | 默认值    |
| ---------------- | ------- | ------------------ | -------------------------------------- | --------- |
| min              | `false` | 最小值             | `number`                               | `0`       |
| max              | `false` | 最大值             | `number`                               | `100`     |
| value            | `false` | 当前值             | `number`                               | `0`       |
| width            | `false` | 宽度               | `number`                               | `px(250)` |
| labelWidth       | `false` | 文本宽度           | `number`                               | `px(40)`  |
| height           | `false` | 高度               | `number`                               | `20`      |
| onChange         | `false` | 滑块拖动后触发事件 | `(value: number) => void`              |           |
| foregroundColor  | `false` | 滑块左侧颜色       | `string`                               | `主题色`  |
| backgroundColor  | `false` | 滑块右侧颜色       | `string`                               | `#fff`    |
| handleBackground | `false` | 滑块背景色         | `string`                               | `#fff`    |
| showText         | `false` | 是否显示滑块数字   | `boolean`                              | `true`    |
| textPosition     | `false` | 滑块数字显示位置   | `top` \| `left` \| `right` \| `bottom` | `top`     |
| textStyle        | `false` | 文本样式           | `TextStyle`                            |           |