feat(payment): 更新支付倒计时组件以支持过期时间

- 添加 expirationTime 属性作为首选时间源
- 当 expirationTime 缺失时回退到 createTime + timeoutHours 方式
- 更新订单详情页和订单列表页组件以传递 expirationTime
- 修改 usePaymentCountdown Hook 以支持新的参数结构
- 更新组件文档以反映新的 API 和使用方式
- 增强时间计算逻辑以处理无效时间情况
This commit is contained in:
2026-02-07 13:16:31 +08:00
parent 6e0a5aa1fe
commit 80653f7ac2
5 changed files with 73 additions and 30 deletions

View File

@@ -1,6 +1,6 @@
# PaymentCountdown 支付倒计时组件
基于订单创建时间的支付倒计时组件,支持静态显示和实时更新两种模式。
基于订单过期时间(`expirationTime`的支付倒计时组件,支持静态显示和实时更新两种模式。
## 功能特性
@@ -19,7 +19,7 @@ import PaymentCountdown from '@/components/PaymentCountdown';
// 订单列表页 - 静态显示
<PaymentCountdown
createTime={order.createTime}
expirationTime={order.expirationTime}
payStatus={order.payStatus}
realTime={false}
mode="badge"
@@ -27,7 +27,7 @@ import PaymentCountdown from '@/components/PaymentCountdown';
// 订单详情页 - 实时更新
<PaymentCountdown
createTime={order.createTime}
expirationTime={order.expirationTime}
payStatus={order.payStatus}
realTime={true}
showSeconds={true}
@@ -43,7 +43,7 @@ import PaymentCountdown from '@/components/PaymentCountdown';
```tsx
// 自定义超时时间12小时
<PaymentCountdown
createTime={order.createTime}
expirationTime={order.expirationTime}
payStatus={order.payStatus}
realTime={true}
timeoutHours={12}
@@ -55,7 +55,7 @@ import PaymentCountdown from '@/components/PaymentCountdown';
// 纯文本模式
<PaymentCountdown
createTime={order.createTime}
expirationTime={order.expirationTime}
payStatus={order.payStatus}
realTime={false}
mode="text"
@@ -67,6 +67,7 @@ import PaymentCountdown from '@/components/PaymentCountdown';
| 参数 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| createTime | string | - | 订单创建时间 |
| expirationTime | string | - | 订单过期时间(推荐) |
| payStatus | boolean | false | 支付状态 |
| realTime | boolean | false | 是否实时更新 |
| timeoutHours | number | 24 | 超时小时数 |
@@ -102,12 +103,13 @@ import PaymentCountdown from '@/components/PaymentCountdown';
import { usePaymentCountdown, formatCountdownText } from '@/hooks/usePaymentCountdown';
const MyComponent = ({ order }) => {
const timeLeft = usePaymentCountdown(
order.createTime,
order.payStatus,
true, // 实时更新
24 // 24小时超时
);
const timeLeft = usePaymentCountdown({
expirationTime: order.expirationTime,
createTime: order.createTime, // expirationTime 缺失时回退
payStatus: order.payStatus,
realTime: true,
timeoutHours: 24
});
const countdownText = formatCountdownText(timeLeft, true);