1.8.0 • Published 3 years ago

@mutt/widget-datetime v1.8.0

Weekly downloads
476
License
MIT
Repository
github
Last release
3 years ago

Mutt Forms Widget - Datetime

Mutt Forms Vue widget for date and time entry.

Field Options

The datetime widget accepts the following options:

optiontypedescriptiondefault
minISO-8601 formatted StringThe minimum date allowednull
maxISO-8601 formatted StringThe maximum date allowednull
dateFormatStringThe date fields and the order in which you wish them to appear'day-month-year'
showTimeBooleanIf true, will display hour, minute and seconds fields after the date fieldsfalse
defaultDate or StringThe default date to setnull
hideDayBooleanCan be used to hide the day field - better to set dateFormat instead where possiblefalse
dateFieldSeparatorStringA character or string of characters that adds a span containing the character between the date field inputs

Emitted events

When a valid date format is entered (i.e. a complete and existing date) the widget will emit the dateValidated event with the following object:

key: this.field.name,
value: this.field.value,
action: 'populated',
validated, // true if the date passes all other validation rules, e.g min/max
bubble: true,

Complete Example

The following example sets the minumum date to Today minus 40 years and the maximum date to Today minus 4 weeks.

dob: {
  help:
    '<p>If you don’t know the exact date of birth, please provide a considered estimate.</p>',
  label: null,
  max: 'P-4W',
  min: 'P-40Y',
  natural: {
    prefix: ' and you were born on ',
    suffix: '.',
    title: 'What is your date of birth?',
    trigger: '',
  },
  serialize: 'date',
  widget: 'naturaldatetime',
  dateFieldSeparator: '/'
},

The following example sets the date format to year/month/day.

dob: {
  help:
    '<p>If you don’t know the exact date of birth, please provide a considered estimate.</p>',
  label: null,
  dateFormat: 'year-month-day'
  natural: {
    prefix: ' and you were born on ',
    suffix: '.',
    title: 'What is your date of birth?',
    trigger: '',
  },
  serialize: 'date',
  widget: 'naturaldatetime',
},
1.8.0

3 years ago

1.8.0-beta.0

3 years ago

1.7.0

3 years ago

1.7.0-beta.0

3 years ago

1.6.1

4 years ago

1.6.0

4 years ago

1.5.1

4 years ago

1.5.0

4 years ago

1.4.3

4 years ago

1.4.2

4 years ago

1.4.1

4 years ago

1.2.0

4 years ago

1.4.0

4 years ago

1.3.0

4 years ago

1.1.1

4 years ago

1.1.0

4 years ago

1.0.2

4 years ago

1.0.1

4 years ago

1.0.0

4 years ago