# countUpScroll

**Repository Path**: ovsexia/count-up-scroll

## Basic Information

- **Project Name**: countUpScroll
- **Description**: countUp.js 数值跳动封装滚动条事件插件
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2021-09-22
- **Last Updated**: 2024-09-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 数值跳动插件
本插件是基于 countUp.js 的封装，除了拥有原插件的基本功能外，还新增了滚动条滚动到元素位置时自动响应的功能

### 用法
`new countSc(【元素id名】, 【结束数值】, 【参数】);`

例：
```
<div id="text"></div>

<script type="text/javascript">
const c1 = new countSc('text', 1000, {
  duration: 3,
});
</script>
```

### 原有参数
| 参数            | 描述                                      | 默认值  |
|---------------|-----------------------------------------|------|
| duration      | 持续时间(秒)                                | 2    |
| startVal      | 开始数值                                    | 0    |
| decimalPlaces | 小数位数                                    | 0    |
| useEasing     | 是否启用惯性                                  | true |
| useGrouping   | 是否启用数值分割(例: true = 1,000, false = 1000) | true |
| separator     | 启用数值分割时的分割符号                            | ,    |
| decimal       | 小数点符号                                   | .    |
| prefix        | 前缀                                      | ''   |
| suffix        | 后缀                                      | ''   |


### 新增参数
| 参数    | 描述       | 默认值   |
|-------|----------|-------|
| per   | 数值 0-1，表示在页面开始运行的百分比，例如 0.2 表示当元素距离底部超过浏览器高度的 20% 时开始运行  | 0     |
| reset | 是否重置     | false |