# Range 区间选择器

### 介绍
  
滑动输入条，用于在给定的范围内选择一个值。

### 安装

```javascript
import { createApp } from 'vue';
import { Range } from '@nutui/nutui';

const app = createApp();
app.use(Range);
```


### 基础用法
:::demo

```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range v-model="value" @change="onChange"></nut-range>
  </nut-cell>
</template>

<script lang="ts">
  import { ref } from 'vue';
  import { showToast } from '@nutui/nutui';
  import '@nutui/nutui/dist/packages/toast/style'; 
  export default {
    setup() {
      const value = ref(40);
      const onChange = (value) => showToast.text('当前值：' + value);
      return {
        value,
        onChange,
      };
    },
  };
</script>

```
:::

### 双滑块
:::demo
```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range range v-model="value" @change="onChange"></nut-range>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref([20, 80]);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::
### 指定范围
:::demo
```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range v-model="value" :max="10" :min="-10" @change="onChange" />
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref(0);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::
### 设置步长
:::demo
```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range v-model="value" :step="5" @change="onChange"></nut-range>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref(20);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::
### 隐藏范围
:::demo
```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range v-model="value" hidden-range @change="onChange"></nut-range>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref(30);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::
### 隐藏标签
:::demo
```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range v-model="value" :hidden-tag="true" @change="onChange"></nut-range>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref(40);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::

### 禁用
:::demo
```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range v-model="value" disabled @change="onChange"></nut-range>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref(50);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::
### 自定义样式
:::demo
```html
<template>
  <nut-cell :style="{padding: '40px 18px'}">
    <nut-range
      v-model="value"
      inactive-color="rgba(163,184,255,1)"
      button-color="rgba(52,96,250,1)"
      active-color="linear-gradient(315deg, rgba(73,143,242,1) 0%,rgba(73,101,242,1) 100%"
      @change="onChange">
    </nut-range>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref(40);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::

### 自定义按钮

:::demo
```html
<style>
  .custom-button {
    width: 26px;
    color: #fff;
    font-size: 10px;
    line-height: 18px;
    text-align: center;
    background-color: #ee0a24;
    border-radius: 100px;
  }
</style>
<template>
  <nut-cell :style="{padding: '40px 18px'}">
   <nut-range v-model="value" @change="onChange">
      <template #button>
        <div class="custom-button">{{ value }}</div>
      </template>
    </nut-range>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value = ref(60);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value,
      onChange,
    };
  },
};
</script>
```
:::

### 垂直方向
:::demo
```html
<style>

.vertical_div {
  height: 180px;
  padding: 10px;
  
}
.div {
  width: 150px;
}
.cell {
  padding: 40px 18px;
}
</style>
<template>
  <nut-cell class="vertical_div cell">
    <div class="div">
      <nut-range v-model="value10" @change="onChange" :vertical="true"></nut-range>
    </div>
    <div class="div">
      <nut-range range v-model="value11" @change="onChange" :vertical="true"></nut-range>
    </div>
  </nut-cell>
</template>

<script lang="ts">
import { ref } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const value10 = ref(20);
    const value11 = ref([20,80]);
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      value10,
      value11,
      onChange,
    };
  },
};
</script>
```
:::
### 刻度标记
:::demo
```html
<style>
.vertical_div {
  height: 180px;
  padding: 10px;
} 
.div {
  width: 150px;
}
.cell {
  padding: 40px 18px;
}
</style>
<template>
  <div >
    <nut-cell class="cell">
      <nut-range v-model="value12" @change="onChange" :marks="marks" :hiddenRange="true"></nut-range>
    </nut-cell>
    <nut-cell class="cell">
      <nut-range range v-model="value13" @change="onChange" :marks="marks" :hiddenRange="true"></nut-range>
    </nut-cell>
    <nut-cell class="vertical_div cell">
      <div class="div">
        <nut-range v-model="value14" @change="onChange" :vertical="true" :marks="marks" :hiddenRange="true"></nut-range>
      </div>
      <div class="div">
        <nut-range
          range
          v-model="value15"
          @change="onChange"
          :vertical="true"
          :marks="marks"
          :hiddenRange="true"
        ></nut-range>
      </div>
    </nut-cell>
  </div>
</template>

<script lang="ts">
import { ref,reactive,toRefs } from 'vue';
import { showToast } from '@nutui/nutui';
import '@nutui/nutui/dist/packages/toast/style'; 
export default {
  setup() {
    const state = reactive({
      value12: 60,
      value13: [20, 80],
      value14: 60,
      value15: [20, 80],
    })
    const marks=ref({
      0: 0,
      20: 20,
      40: 40,
      60: 60,
      80: 80,
      100: 100
    });
    const onChange = (value) => showToast.text('当前值：' + value);
    return {
      ...toRefs(state),
      marks,
      onChange,
    };
  },
};
</script>
```
:::


  ## API
  
  ### Props
  
| 参数 | 说明 | 类型 | 默认值 |
| --- | --- | --- | --- |
| v-model | 当前进度百分比 | number \| number[] | `0` |
| range | 是否开启双滑块模式 | boolean | `false` |
| max | 最大值 | number \| string | `100` |
| min | 最小值 | number \| string | `0` |
| step | 步长 | number \| string | `1` |
| disabled | 是否禁用滑块 | boolean | `false` |
| vertical | 是否竖向展示 | boolean | `false` |
| hidden-range | 是否隐藏范围值 | boolean | `false` |
| hidden-tag | 是否隐藏标签 | boolean | `false` |
| active-color | 进度条激活态颜色 | string | `rgba(250, 44, 25, 1)` |
| inactive-color | 进度条非激活态颜色 | string | `rgba(255, 163, 154, 1)` |
| button-color | 按钮颜色 | string | `rgba(250, 44, 25, 1)` |
| marks | 刻度标示 | object{key:number} | `{}` |

  
### Events

| 事件名             | 说明                     | 回调参数        |
| ------------------ | ------------------------ | --------------- |
| change             | 进度变化且结束拖动后触发 | `value: number \| number[]` |
| drag-start         | 开始拖动时触发           | -               |
| drag-end           | 结束拖动时触发           | -               |

### Slots

| 名称   | 说明           |
| ------ | -------------- |
| button | 自定义滑动按钮 |


## 主题定制

### 样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 [ConfigProvider 组件](#/zh-CN/component/configprovider)。

| 名称                                    | 默认值                     | 
| --------------------------------------- | -------------------------- | 
|  --nut-range-tip-font-color| _#333333_  | 
|  --nut-range-bg-color| _var(--nut-primary-color)_  | 
|  --nut-range-bg-color-tick| _#fa958c_  | 
|  --nut-range-bar-bg-color| _linear-gradient(135deg, var(--nut-primary-color) 0%, var(--nut-primary-color-end) 100%)_  | 
|  --nut-range-bar-btn-bg-color| _var(--nut-white)_  | 
|  --nut-range-bar-btn-width| _24px_  | 
|  --nut-range-bar-btn-height| _24px_  | 
|  --nut-range-bar-btn-border| _1px solid var(--nut-primary-color)_  |