# countdown (w-countdown)

- **Import**: `WCountdown` from `win-design-next`
- **Tag**: `<w-countdown>`
- **说明**: WCountdown
- **分类**: data-display
- **Skill 版本**: V1.1.0
- **适配组件库**: win-design-next 1.2.2
- **API 来源**: `docs/zh-CN/component/statistic.md`

## API

## Countdown API

### Attributes

| 属性        | 详情             | 类型                                                                | 默认值   |
| ----------- | ---------------- | ------------------------------------------------------------------- | -------- |
| value       | 目标时间         | ^[number] / ^[Dayjs]                                                | —        |
| format      | 格式化倒计时     | ^[string]                                                           | HH:mm:ss |
| prefix      | 设置倒计时前缀   | ^[string]                                                           | —        |
| suffix      | 设置倒计时的后缀 | ^[string]                                                           | —        |
| title       | 倒计时标题       | ^[string]                                                           | —        |
| value-style | 倒计时值的样式   | ^[string] / ^[object]`CSSProperties \| CSSProperties[] \| string[]` | —        |

### Events

| 方法   | 描述           | 类型                                 |
| ------ | -------------- | ------------------------------------ |
| change | 时间差改变事件 | ^[Function]`(value: number) => void` |
| finish | 倒计时结束事件 | ^[Function]`() => void`              |

### Slots

| 事件名 | 描述         |
| ------ | ------------ |
| prefix | 倒计时值前缀 |
| suffix | 倒计时后缀   |
| title  | 倒计时标题   |

### Exposes

| 名称         | 详情       | 类型           |
| ------------ | ---------- | -------------- |
| displayValue | 当前显示值 | ^[object]`Ref` |
