优化: Cron 表达式编辑器增加预设和中文描述

1. 新增 8 个常用预设按钮(每天 02:00、每 6 小时、每周日、每月 1 日等),
   一键设置无需逐个 Tab 操作
2. 新增中文可读描述(如 "02 时 00 分 执行"),实时显示在表达式下方
3. 选中的预设按钮高亮显示
This commit is contained in:
Awuqing
2026-04-01 00:12:32 +08:00
parent 31f996490f
commit c25852d810

View File

@@ -1,5 +1,5 @@
import { Input, Space, Switch, Tabs, Typography, Radio, Checkbox, Select } from '@arco-design/web-react'
import { useEffect, useState } from 'react'
import { Button, Input, Space, Switch, Tabs, Typography, Radio, Select } from '@arco-design/web-react'
import { useEffect, useMemo, useState } from 'react'
export interface CronInputProps {
value?: string
@@ -18,6 +18,18 @@ interface CronState {
week: string
}
// 常用预设
const PRESETS = [
{ label: '每天 02:00', value: '0 2 * * *' },
{ label: '每天 00:00', value: '0 0 * * *' },
{ label: '每 6 小时', value: '0 */6 * * *' },
{ label: '每 12 小时', value: '0 */12 * * *' },
{ label: '每周日 03:00', value: '0 3 * * 0' },
{ label: '每月 1 日 02:00', value: '0 2 1 * *' },
{ label: '每 30 分钟', value: '*/30 * * * *' },
{ label: '每小时', value: '0 * * * *' },
]
function parseCron(expr: string): CronState {
const parts = (expr || DEFAULT_CRON).trim().split(/\s+/)
return {
@@ -33,6 +45,43 @@ function stringifyCron(state: CronState): string {
return `${state.minute} ${state.hour} ${state.day} ${state.month} ${state.week}`
}
// 将 cron 表达式转为中文可读描述
function describeCron(expr: string): string {
const parts = expr.trim().split(/\s+/)
if (parts.length !== 5) return ''
const [minute, hour, day, month, week] = parts
const segments: string[] = []
// 月
if (month !== '*') segments.push(`${month}`)
// 日
if (day !== '*') segments.push(`${day}`)
// 周
if (week !== '*') {
const weekNames: Record<string, string> = { '0': '日', '1': '一', '2': '二', '3': '三', '4': '四', '5': '五', '6': '六', '7': '日' }
const weekDesc = week.split(',').map((w) => weekNames[w] || w).join('、')
segments.push(`星期${weekDesc}`)
}
// 小时
if (hour.includes('/')) {
segments.push(`${hour.split('/')[1]} 小时`)
} else if (hour !== '*') {
segments.push(`${hour.padStart(2, '0')}`)
}
// 分钟
if (minute.includes('/')) {
segments.push(`${minute.split('/')[1]} 分钟`)
} else if (minute !== '*') {
segments.push(`${minute.padStart(2, '0')}`)
} else if (hour !== '*' && !hour.includes('/')) {
segments.push('00 分')
}
if (segments.length === 0) return '每分钟执行'
return segments.join(' ') + ' 执行'
}
function generateOptions(min: number, max: number) {
return Array.from({ length: max - min + 1 }, (_, i) => ({
label: String(i + min),
@@ -69,6 +118,8 @@ export function CronInput({ value, onChange }: CronInputProps) {
}
}, [value, isAdvanced, internalValue])
const description = useMemo(() => describeCron(internalValue), [internalValue])
const notifyChange = (nextValue: string) => {
setInternalValue(nextValue)
if (onChange) {
@@ -82,6 +133,12 @@ export function CronInput({ value, onChange }: CronInputProps) {
notifyChange(stringifyCron(nextState))
}
const handlePreset = (cronExpr: string) => {
setInternalValue(cronExpr)
setState(parseCron(cronExpr))
if (onChange) onChange(cronExpr)
}
const renderPartTab = (
part: CronPart,
title: string,
@@ -91,8 +148,7 @@ export function CronInput({ value, onChange }: CronInputProps) {
const currentVal = state[part]
const isAny = currentVal === allowAnyVal || currentVal === '*' || currentVal === '?'
const isSpecific = !isAny && !currentVal.includes('/') && !currentVal.includes('-')
// For simplicity in this visual editor, we only support "every" (*) and "specific values" (1,2,3).
const type = isAny ? 'any' : 'specific'
const specificValues = isSpecific ? currentVal.split(',') : []
@@ -105,7 +161,7 @@ export function CronInput({ value, onChange }: CronInputProps) {
if (val === 'any') {
handleStateChange(part, allowAnyVal)
} else {
handleStateChange(part, options[0].value) // Default to first valid item
handleStateChange(part, options[0].value)
}
}}
>
@@ -128,7 +184,6 @@ export function CronInput({ value, onChange }: CronInputProps) {
if (vals.length === 0) {
handleStateChange(part, allowAnyVal)
} else {
// Sort numerically to keep things neat
const sorted = [...vals].sort((a, b) => Number(a) - Number(b))
handleStateChange(part, sorted.join(','))
}
@@ -144,6 +199,24 @@ export function CronInput({ value, onChange }: CronInputProps) {
return (
<div className="cron-input-container">
{/* 常用预设 */}
<div style={{ marginBottom: 12 }}>
<Typography.Text type="secondary" style={{ display: 'block', marginBottom: 8 }}></Typography.Text>
<Space wrap size="small">
{PRESETS.map((preset) => (
<Button
key={preset.value}
size="small"
type={internalValue === preset.value ? 'primary' : 'secondary'}
onClick={() => handlePreset(preset.value)}
>
{preset.label}
</Button>
))}
</Space>
</div>
{/* 表达式 + 可读描述 */}
<div style={{ marginBottom: 12, display: 'flex', justifyContent: 'space-between', alignItems: 'center' }}>
<Input
value={internalValue}
@@ -158,13 +231,12 @@ export function CronInput({ value, onChange }: CronInputProps) {
placeholder="* * * * *"
/>
<Space>
<Typography.Text type="secondary"> ()</Typography.Text>
<Typography.Text type="secondary"></Typography.Text>
<Switch
checked={isAdvanced}
onChange={(checked) => {
setIsAdvanced(checked)
if (!checked) {
// When switching back to visual, parse the current raw value
setState(parseCron(internalValue))
notifyChange(stringifyCron(parseCron(internalValue)))
}
@@ -173,6 +245,13 @@ export function CronInput({ value, onChange }: CronInputProps) {
</Space>
</div>
{/* 中文可读描述 */}
{description && (
<Typography.Paragraph type="secondary" style={{ marginBottom: 12, marginTop: 0 }}>
{description}
</Typography.Paragraph>
)}
{!isAdvanced && (
<Tabs type="card-gutter" size="small">
<Tabs.TabPane key="minute" title="分钟">