Version 1.0.1 adds two-way variable binding. A variable assigned in the properties panel initializes the control when it already contains a valid ISO date (YYYY-MM-DD), and user changes are written back automatically.
1. Overview & Purpose
The neoDateInput plugin provides a modern date input field with a pop-up calendar picker, date range validation (minDate, maxDate), format formatting (yyyy-mm-dd, dd/mm/yyyy, mm/dd/yyyy, long), and empty value support.
2. Custom Control Properties
Control: neoDateInput (neo-date-input)
| Property Name | Type | Default Value | Description |
|---|---|---|---|
| variable | variable | "" | Optional VisualNEO variable (e.g. [MyDate]) bound directly to the date value (yyyy-mm-dd). |
value | string | "2026-08-07" | Initial selected date (yyyy-mm-dd). |
minDate | string | "1900-01-01" | Minimum allowable selectable date (yyyy-mm-dd). |
maxDate | string | "2099-12-31" | Maximum allowable selectable date (yyyy-mm-dd). |
format | string | "yyyy-mm-dd" | Visible date display format ("yyyy-mm-dd", "dd/mm/yyyy", "mm/dd/yyyy", "long"). |
allowEmpty | boolean | false | Allows clearing the input value to an empty string. |
3. Actions & Commands Reference
neoDateInputSetValue
Sets the active date value of a target neoDateInput control.
- Command Syntax:
neoDateInputSetValue "ObjectName" "DateYyyyMmDd" - Parameters:
- •
ObjectName(string): Target control name. - •
DateYyyyMmDd(string): Date string formatted asyyyy-mm-dd(e.g."2026-12-25").
neoDateInputGetValue
Retrieves the current date value as yyyy-mm-dd into [neoDateInputResult] (and optionally into a specified variable).
- Command Syntax:
neoDateInputGetValue "ObjectName" "[ResultVar]" - Parameters:
- •
ObjectName(string): Target control name. - •
ResultVar(string, optional): Variable to receive the date string (e.g."[UserBirthDate]").
neoDateInputSetRange
Configures the minimum and maximum allowable selectable dates.
- Command Syntax:
neoDateInputSetRange "ObjectName" "MinDate" "MaxDate"
neoDateInputClear
Clears the date input field (requires allowEmpty enabled).
- Command Syntax:
neoDateInputClear "ObjectName"
neoDateInputFocus
Moves keyboard focus to the target date input control.
- Command Syntax:
neoDateInputFocus "ObjectName"
neoDateInputSetFormat
Sets the display formatting preset.
- Command Syntax:
neoDateInputSetFormat "ObjectName" "Format"
4. Events Reference
change: Triggered when the user selects or edits a valid date.commit: Triggered when a date entry is committed.invalid: Triggered when an entered date violates range constraints or syntax validation.
5. Practical Usage Example (VisualNEO Win Script)
. --- Set date value and format ---
neoDateInputSetFormat "DateInput1" "dd/mm/yyyy"
neoDateInputSetValue "DateInput1" "2026-08-07"
. --- Enforce age selection range ---
neoDateInputSetRange "DateInput1" "1940-01-01" "2010-12-31"
. --- Retrieve date value ---
neoDateInputGetValue "DateInput1"
SetVar "[UserBirthDate]" "[neoDateInputResult]"