Cron Input Showcase
Example
Cron Expression
Null
Cron Guide
Cron expressions run on UTC time
- Minute (0 - 59)
- Hour (0 - 23)
- Day of the month (1 - 31)
- Month (1 - 12)
- Day of the week (0 - 6)
Special characters:
- Asterisk (*): Represents "every" value (e.g., every hour, every day).
- Comma (,): Specifies a list of values (e.g., 1,3,5 in the day-of-week field means Monday, Wednesday, and Friday).
- Dash (-): Specifies a range of values (e.g., 1-5 in the day-of-week field means Monday through Friday).
- Slash (/): Specifies increments (e.g., */10 in the minute field means "every 10 minutes").
Example No Modal
Cron Expression
Null
Cron Guide
Cron expressions run on UTC time
- Minute (0 - 59)
- Hour (0 - 23)
- Day of the month (1 - 31)
- Month (1 - 12)
- Day of the week (0 - 6)
Special characters:
- Asterisk (*): Represents "every" value (e.g., every hour, every day).
- Comma (,): Specifies a list of values (e.g., 1,3,5 in the day-of-week field means Monday, Wednesday, and Friday).
- Dash (-): Specifies a range of values (e.g., 1-5 in the day-of-week field means Monday through Friday).
- Slash (/): Specifies increments (e.g., */10 in the minute field means "every 10 minutes").
Component Documentation
Component Name
CronInput
Builder Function Name
create_cron_input_manager
Description
provides a popover-based UI for setting a cron expression (minute, hour, day-of-month, month, and day-of-week)
Use like example
Config
| Property | Type | Default | Description |
|---|---|---|---|
| val | string | the raw cron expression | |
| label | string | optional label displayed next to the cron input | |
| is_disabled | boolean | false | disables the input if true |
| is_nullable | boolean | true | allows the cron to be null if true |
| is_compressed | boolean | true | if true, sets button styling to compressed |
| is_popover | boolean | true | if true, opens the cron input in a popover |
| ml | number | 0 | margin-left in rem |
| mr | number | 0 | margin-right in rem |
| mt | number | 0 | margin-top in rem |
| mb | number | 0 | margin-bottom in rem |
| on_finish | function | callback triggered when the user clicks 'finish', receives the validated cron |
Methods
| Method | Description | Parameters | Returns |
|---|---|---|---|
| init | initializes the manager, sets up internal text input, popover, and control buttons | config: object | void |
| finish_cron | calls on_finish with the current cron value if provided, then closes the popover | No Params | void |
| set_attributes | updates the manager’s config attributes (label, disabled, etc.) | input: object | void |
Returned Properties
| Property | Type | Description |
|---|---|---|
| id | string | unique identifier for this cron input instance |
| label | string | optional label displayed next to the input |
| val | string | cleaned, fully formed cron expression or null |
| is_nullable | boolean | allows the cron to be null if true |
| description | string | english-like description of the cron schedule |
| is_disabled | boolean | disables the input if true |
| is_compressed | boolean | styles the button in a compressed manner if true |
| is_valid | boolean | indicates if the provided cron expression is valid |
| is_popover | boolean | if true, the cron input is displayed in a popover |
| ml | number | margin-left in rem |
| mr | number | margin-right in rem |
| mt | number | margin-top in rem |
| mb | number | margin-bottom in rem |
| popover_manager | object | popover manager controlling the dropdown panel |
| popover_toggle_button_manager | object | button manager used to open/close the popover |
| finish_button_manager | object | button manager that finalizes the selected cron |
| cron_text_input_manager | object | text input manager for editing the raw cron expression |
