alps-react-cron/README.md

基于React+Antd的Cron编辑器插件

# react-cron-ts

基于 React+Antd 的 Cron 编辑器插件
[在线 Demo](https://chenjiahao1229.github.io/react-cron-ts/)

## 依赖

- React
- Antd

## 安装

```bash
npm install react-cron-ts
```

## 使用

```tsx
import React, { useState } from 'react'
import Cron from 'react-cron-ts'

const Page = () => {
  const [value, setValue] = useState<string>('* * * * * ? *')
  return (
    <Cron
      value={value}
      onChange={(v) => {
        console.log(v)
        setValue(v)
      }}
    />
  )
}

export default Page
```

## 扩展

在 antd 的表单中使用

```tsx
import React from 'react'
import { Form, Button } from 'antd'
import Cron from 'react-cron-antd'

const FormCron = () => {
  const [form] = Form.useForm()
  return (
    <>
      <Form form={form}>
        <Form.Item name="cron" label="Cron" initialValue="* * * * * ? *">
          <Cron />
        </Form.Item>
      </Form>
      <Button onClick={() => console.log(form.getFieldsValue())}>提交</Button>
    </>
  )
}

export default FormCron
```

## 插槽的使用

不想使用默认的 Input 框时，只需要把对应的组件作为 children 即可

```tsx
import React from 'react'
import { Button } from 'antd'
import Cron from 'react-cron-antd'

const CronChildren = () => {
  return (
    <Cron
      onChange={(value) => {
        console.log(value)
      }}
    >
      <Button>编辑Cron</Button>
    </Cron>
  )
}

export default FormCron
```

## 参数

```tsx
  /**
   * Cron表达式
   */
  value?: string
  /**
   * 插槽 可以用于替换Input输入框
   */
  children?: React.ReactNode
  /**
   * antd Input框参数
   * 在无children时生效
   */
  inputProps?: InputProps
  /**
   * Cron编辑器内容显示高度
   */
  height?: string | number
  /**
   * 再次打卡是否保留前次编辑数据
   */
  closeClearEditData?: boolean
  /**
   * 输入框样式
   */
  style?: React.CSSProperties
  /**
   * 输入类名
   */
  className?: string
    /**
   * 是否需要年
   * 默认 false
   */
  noYear?: boolean
  /**
   * 组件语言 'cn'|'en'
   * 默认为cn
   */
  language?: 'cn' | 'en'
```

## 事件

```tsx
  /**
   * 切换语言回调
   * 传递了方法才会显示切换语言的单选框
   */
  handleLanguage?: (language: 'cn' | 'en') => void
  /**
   * 确认回调 返回Cron表达式
   */
  onChange?: (value: string) => void
```

## 联系

- only9221@163.com