{ "schemaVersion": "1.0.0", "readme": "", "modules": [ { "kind": "javascript-module", "path": "vaadin-date-time-picker.js", "declarations": [], "exports": [ { "kind": "js", "name": "*", "declaration": { "name": "*", "module": "src/vaadin-date-time-picker.js" } } ] }, { "kind": "javascript-module", "path": "src/vaadin-date-time-picker-mixin.js", "declarations": [ { "kind": "mixin", "description": "A mixin providing common date-time-picker functionality.", "name": "DateTimePickerMixin", "members": [ { "kind": "field", "name": "accessibleName", "privacy": "public", "type": { "text": "string" }, "description": "String used to label the component to screen reader users.", "attribute": "accessible-name", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "accessibleNameRef", "privacy": "public", "type": { "text": "string" }, "description": "Id of the element used as label of the component to screen reader users.", "attribute": "accessible-name-ref", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "autofocus", "privacy": "public", "type": { "text": "boolean" }, "description": "Specify that this control should have input focus when the page loads.", "attribute": "autofocus" }, { "kind": "field", "name": "autoOpenDisabled", "privacy": "public", "type": { "text": "boolean" }, "description": "Set to true to prevent the overlays from opening automatically.", "attribute": "auto-open-disabled" }, { "kind": "method", "name": "checkValidity", "description": "Returns true if the current input value satisfies all constraints (if any)\n\nYou can override the `checkValidity` method for custom validations.", "return": { "type": { "text": "boolean" } } }, { "kind": "field", "name": "datePlaceholder", "privacy": "public", "type": { "text": "string" }, "description": "A placeholder string for the date field.", "attribute": "date-placeholder" }, { "kind": "field", "name": "errorMessage", "privacy": "public", "type": { "text": "string" }, "description": "Error to show when the field is invalid.", "attribute": "error-message", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "helperText", "privacy": "public", "type": { "text": "string" }, "description": "String used for the helper text.", "attribute": "helper-text", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "i18n", "privacy": "public", "type": { "text": "Object" }, "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following structure and default values:\n\n```js\n{\n // Accessible label to the date picker.\n // The property works in conjunction with label and accessibleName defined on the field.\n // If both properties are defined, then accessibleName takes precedence.\n // Then, the dateLabel value is concatenated with it.\n dateLabel: undefined;\n\n // Accessible label to the time picker.\n // The property works in conjunction with label and accessibleName defined on the field.\n // If both properties are defined, then accessibleName takes precedence.\n // Then, the dateLabel value is concatenated with it.\n timeLabel: undefined;\n}\n```\n\nAdditionally, all i18n properties from\n[``](#/elements/vaadin-date-picker) and\n[``](#/elements/vaadin-time-picker) are supported.", "attribute": "i18n", "inheritedFrom": { "name": "I18nMixin", "package": "@vaadin/component-base/src/i18n-mixin.js" } }, { "kind": "field", "name": "initialPosition", "privacy": "public", "type": { "text": "string" }, "description": "Date which should be visible in the date picker overlay when there is no value selected.\n\nThe same date formats as for the `value` property are supported but without the time part.", "attribute": "initial-position" }, { "kind": "field", "name": "label", "privacy": "public", "type": { "text": "string" }, "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.", "attribute": "label", "inheritedFrom": { "name": "LabelMixin", "package": "@vaadin/field-base/src/label-mixin.js" } }, { "kind": "field", "name": "max", "privacy": "public", "type": { "text": "string" }, "description": "The latest value (date and time) that can be selected. All later values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "attribute": "max" }, { "kind": "field", "name": "min", "privacy": "public", "type": { "text": "string" }, "description": "The earliest allowed value (date and time) that can be selected. All earlier values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "attribute": "min" }, { "kind": "field", "name": "name", "privacy": "public", "type": { "text": "string" }, "description": "The name of the control, which is submitted with the form data.", "attribute": "name" }, { "kind": "field", "name": "readonly", "privacy": "public", "type": { "text": "boolean" }, "description": "Set to true to make this element read-only.", "attribute": "readonly" }, { "kind": "field", "name": "showWeekNumbers", "privacy": "public", "type": { "text": "boolean" }, "description": "Set true to display ISO-8601 week numbers in the calendar. Notice that\ndisplaying week numbers is only supported when `i18n.firstDayOfWeek`\nis 1 (Monday).", "attribute": "show-week-numbers" }, { "kind": "field", "name": "step", "privacy": "public", "type": { "text": "number" }, "description": "Defines the time interval (in seconds) between the items displayed\nin the time selection box. The default is 1 hour (i.e. `3600`).\n\nIt also configures the precision of the time part of the value string. By default\nthe component formats time values as `hh:mm` but setting a step value\nlower than one minute or one second, format resolution changes to\n`hh:mm:ss` and `hh:mm:ss.fff` respectively.\n\nUnit must be set in seconds, and for correctly configuring intervals\nin the dropdown, it need to evenly divide a day.\n\nNote: it is possible to define step that is dividing an hour in inexact\nfragments (i.e. 5760 seconds which equals 1 hour 36 minutes), but it is\nnot recommended to use it for better UX.", "attribute": "step" }, { "kind": "field", "name": "timePlaceholder", "privacy": "public", "type": { "text": "string" }, "description": "A placeholder string for the time field.", "attribute": "time-placeholder" }, { "kind": "field", "name": "value", "privacy": "public", "type": { "text": "string" }, "description": "The value for this element.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"` (default)\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "attribute": "value" } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" } }, { "name": "unparsable-change", "type": { "text": "CustomEvent" } } ], "attributes": [ { "name": "accessible-name", "type": { "text": "string" }, "description": "String used to label the component to screen reader users.", "fieldName": "accessibleName", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "accessible-name-ref", "type": { "text": "string" }, "description": "Id of the element used as label of the component to screen reader users.", "fieldName": "accessibleNameRef", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "auto-open-disabled", "type": { "text": "boolean" }, "description": "Set to true to prevent the overlays from opening automatically.", "fieldName": "autoOpenDisabled" }, { "name": "autofocus", "type": { "text": "boolean" }, "description": "Specify that this control should have input focus when the page loads.", "fieldName": "autofocus" }, { "name": "date-placeholder", "type": { "text": "string" }, "description": "A placeholder string for the date field.", "fieldName": "datePlaceholder" }, { "name": "error-message", "type": { "text": "string" }, "description": "Error to show when the field is invalid.", "fieldName": "errorMessage", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "helper-text", "type": { "text": "string" }, "description": "String used for the helper text.", "fieldName": "helperText", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "i18n", "type": { "text": "Object" }, "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nShould be overridden by subclasses to provide a custom JSDoc with the\ndefault I18N properties.", "fieldName": "i18n", "inheritedFrom": { "name": "I18nMixin", "package": "@vaadin/component-base/src/i18n-mixin.js" } }, { "name": "initial-position", "type": { "text": "string" }, "description": "Date which should be visible in the date picker overlay when there is no value selected.\n\nThe same date formats as for the `value` property are supported but without the time part.", "fieldName": "initialPosition" }, { "name": "label", "type": { "text": "string" }, "description": "The label text for the input node.\nWhen no light dom defined via [slot=label], this value will be used.", "fieldName": "label", "inheritedFrom": { "name": "LabelMixin", "package": "@vaadin/field-base/src/label-mixin.js" } }, { "name": "max", "type": { "text": "string" }, "description": "The latest value (date and time) that can be selected. All later values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "fieldName": "max" }, { "name": "min", "type": { "text": "string" }, "description": "The earliest allowed value (date and time) that can be selected. All earlier values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "fieldName": "min" }, { "name": "name", "type": { "text": "string" }, "description": "The name of the control, which is submitted with the form data.", "fieldName": "name" }, { "name": "readonly", "type": { "text": "boolean" }, "description": "Set to true to make this element read-only.", "fieldName": "readonly" }, { "name": "show-week-numbers", "type": { "text": "boolean" }, "description": "Set true to display ISO-8601 week numbers in the calendar. Notice that\ndisplaying week numbers is only supported when `i18n.firstDayOfWeek`\nis 1 (Monday).", "fieldName": "showWeekNumbers" }, { "name": "step", "type": { "text": "number" }, "description": "Defines the time interval (in seconds) between the items displayed\nin the time selection box. The default is 1 hour (i.e. `3600`).\n\nIt also configures the precision of the time part of the value string. By default\nthe component formats time values as `hh:mm` but setting a step value\nlower than one minute or one second, format resolution changes to\n`hh:mm:ss` and `hh:mm:ss.fff` respectively.\n\nUnit must be set in seconds, and for correctly configuring intervals\nin the dropdown, it need to evenly divide a day.\n\nNote: it is possible to define step that is dividing an hour in inexact\nfragments (i.e. 5760 seconds which equals 1 hour 36 minutes), but it is\nnot recommended to use it for better UX.", "fieldName": "step" }, { "name": "time-placeholder", "type": { "text": "string" }, "description": "A placeholder string for the time field.", "fieldName": "timePlaceholder" }, { "name": "value", "type": { "text": "string" }, "description": "The value for this element.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"` (default)\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "fieldName": "value" } ], "mixins": [ { "name": "I18nMixin", "package": "@vaadin/component-base/src/i18n-mixin.js" }, { "name": "DisabledMixin", "package": "@vaadin/a11y-base/src/disabled-mixin.js" }, { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" }, { "name": "FocusMixin", "package": "@vaadin/a11y-base/src/focus-mixin.js" } ], "parameters": [ { "name": "superClass" } ] } ], "exports": [ { "kind": "js", "name": "DateTimePickerMixin", "declaration": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } } ] }, { "kind": "javascript-module", "path": "src/vaadin-date-time-picker.js", "declarations": [ { "kind": "class", "description": "`` is a Web Component providing a date time selection field.\n\n```html\n\n```\n\n```js\ndateTimePicker.value = '2019-09-16T15:00';\n```\n\nWhen the selected `value` is changed, a `value-changed` event is triggered.\n\n### Styling\n\nThe following shadow DOM parts are available for styling:\n\nPart name | Description\n---------------------|----------------\n`label` | The slotted label element wrapper\n`input-fields` | The date and time pickers wrapper\n`helper-text` | The slotted helper text element wrapper\n`error-message` | The slotted error message element wrapper\n`required-indicator` | The `required` state indicator element\n\nThe following state attributes are available for styling:\n\nAttribute | Description\n--------------------|---------------------------------\n`disabled` | Set when the element is disabled\n`focused` | Set when the element is focused\n`focus-ring` | Set when the element is keyboard focused\n`readonly` | Set when the element is readonly\n`invalid` | Set when the element is invalid\n`has-label` | Set when the element has a label\n`has-value` | Set when the element has a value\n`has-helper` | Set when the element has helper text\n`has-error-message` | Set when the element has an error message\n`has-tooltip` | Set when the element has a slotted tooltip\n\nThe following custom CSS properties are available for styling:\n\nCustom CSS property |\n:--------------------------------------------------|\n| `--vaadin-date-time-picker-gap` |\n| `--vaadin-input-field-error-color` |\n| `--vaadin-input-field-error-font-size` |\n| `--vaadin-input-field-error-font-weight` |\n| `--vaadin-input-field-error-line-height` |\n| `--vaadin-input-field-label-color` |\n| `--vaadin-input-field-label-font-size` |\n| `--vaadin-input-field-label-font-weight` |\n| `--vaadin-input-field-label-line-height` |\n| `--vaadin-input-field-helper-color` |\n| `--vaadin-input-field-helper-font-size` |\n| `--vaadin-input-field-helper-font-weight` |\n| `--vaadin-input-field-helper-line-height` |\n| `--vaadin-input-field-required-indicator-color` |\n| `--vaadin-input-field-required-indicator` |\n\n### Internal components\n\nThe following components are created by `` and placed in light DOM:\n\n- [``](#/elements/vaadin-date-picker).\n- [``](#/elements/vaadin-time-picker).\n\nSee [Styling Components](https://vaadin.com/docs/latest/styling/styling-components) documentation.\n\n### Change events\n\nDepending on the nature of the value change that the user attempts to commit e.g. by pressing Enter,\nthe component can fire either a `change` event or an `unparsable-change` event:\n\nValue change | Event\n:------------------------|:------------------\nempty => parsable | change\nempty => unparsable | unparsable-change\nparsable => empty | change\nparsable => parsable | change\nparsable => unparsable | change\nunparsable => empty | unparsable-change\nunparsable => parsable | change\nunparsable => unparsable | unparsable-change\nincomplete => empty | unparsable-change\nincomplete => parsable | change\nincomplete => unparsable | unparsable-change\nempty => incomplete | unparsable-change\nparsable => incomplete | change\nunparsable => incomplete | unparsable-change", "name": "DateTimePicker", "members": [ { "kind": "field", "name": "accessibleName", "privacy": "public", "type": { "text": "string" }, "description": "String used to label the component to screen reader users.", "attribute": "accessible-name", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "accessibleNameRef", "privacy": "public", "type": { "text": "string" }, "description": "Id of the element used as label of the component to screen reader users.", "attribute": "accessible-name-ref", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "autofocus", "privacy": "public", "type": { "text": "boolean" }, "description": "Specify that this control should have input focus when the page loads.", "attribute": "autofocus", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "autoOpenDisabled", "privacy": "public", "type": { "text": "boolean" }, "description": "Set to true to prevent the overlays from opening automatically.", "attribute": "auto-open-disabled", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "method", "name": "checkValidity", "description": "Returns true if the current input value satisfies all constraints (if any)\n\nYou can override the `checkValidity` method for custom validations.", "return": { "type": { "text": "boolean" } }, "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "datePlaceholder", "privacy": "public", "type": { "text": "string" }, "description": "A placeholder string for the date field.", "attribute": "date-placeholder", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "errorMessage", "privacy": "public", "type": { "text": "string" }, "description": "Error to show when the field is invalid.", "attribute": "error-message", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "helperText", "privacy": "public", "type": { "text": "string" }, "description": "String used for the helper text.", "attribute": "helper-text", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "kind": "field", "name": "i18n", "privacy": "public", "type": { "text": "Object" }, "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nThe object has the following structure and default values:\n\n```js\n{\n // Accessible label to the date picker.\n // The property works in conjunction with label and accessibleName defined on the field.\n // If both properties are defined, then accessibleName takes precedence.\n // Then, the dateLabel value is concatenated with it.\n dateLabel: undefined;\n\n // Accessible label to the time picker.\n // The property works in conjunction with label and accessibleName defined on the field.\n // If both properties are defined, then accessibleName takes precedence.\n // Then, the dateLabel value is concatenated with it.\n timeLabel: undefined;\n}\n```\n\nAdditionally, all i18n properties from\n[``](#/elements/vaadin-date-picker) and\n[``](#/elements/vaadin-time-picker) are supported.", "attribute": "i18n", "inheritedFrom": { "name": "I18nMixin", "package": "@vaadin/component-base/src/i18n-mixin.js" } }, { "kind": "field", "name": "initialPosition", "privacy": "public", "type": { "text": "string" }, "description": "Date which should be visible in the date picker overlay when there is no value selected.\n\nThe same date formats as for the `value` property are supported but without the time part.", "attribute": "initial-position", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "max", "privacy": "public", "type": { "text": "string" }, "description": "The latest value (date and time) that can be selected. All later values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "attribute": "max", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "min", "privacy": "public", "type": { "text": "string" }, "description": "The earliest allowed value (date and time) that can be selected. All earlier values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "attribute": "min", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "name", "privacy": "public", "type": { "text": "string" }, "description": "The name of the control, which is submitted with the form data.", "attribute": "name", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "readonly", "privacy": "public", "type": { "text": "boolean" }, "description": "Set to true to make this element read-only.", "attribute": "readonly", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "showWeekNumbers", "privacy": "public", "type": { "text": "boolean" }, "description": "Set true to display ISO-8601 week numbers in the calendar. Notice that\ndisplaying week numbers is only supported when `i18n.firstDayOfWeek`\nis 1 (Monday).", "attribute": "show-week-numbers", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "step", "privacy": "public", "type": { "text": "number" }, "description": "Defines the time interval (in seconds) between the items displayed\nin the time selection box. The default is 1 hour (i.e. `3600`).\n\nIt also configures the precision of the time part of the value string. By default\nthe component formats time values as `hh:mm` but setting a step value\nlower than one minute or one second, format resolution changes to\n`hh:mm:ss` and `hh:mm:ss.fff` respectively.\n\nUnit must be set in seconds, and for correctly configuring intervals\nin the dropdown, it need to evenly divide a day.\n\nNote: it is possible to define step that is dividing an hour in inexact\nfragments (i.e. 5760 seconds which equals 1 hour 36 minutes), but it is\nnot recommended to use it for better UX.", "attribute": "step", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "timePlaceholder", "privacy": "public", "type": { "text": "string" }, "description": "A placeholder string for the time field.", "attribute": "time-placeholder", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "kind": "field", "name": "value", "privacy": "public", "type": { "text": "string" }, "description": "The value for this element.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"` (default)\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "attribute": "value", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } } ], "events": [ { "name": "change", "type": { "text": "CustomEvent" }, "description": "Fired when the user commits a value change.", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "type": { "text": "CustomEvent" }, "description": "Fired when the `invalid` property changes.", "name": "invalid-changed" }, { "name": "unparsable-change", "type": { "text": "CustomEvent" }, "description": "Fired when the user commits an unparsable or incomplete value change and there is no change event.", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "type": { "text": "CustomEvent" }, "description": "Fired whenever the field is validated.", "name": "validated" }, { "type": { "text": "CustomEvent" }, "description": "Fired when the `value` property changes.", "name": "value-changed" } ], "mixins": [ { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" }, { "name": "ThemableMixin", "package": "@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js" }, { "name": "ElementMixin", "package": "@vaadin/component-base/src/element-mixin.js" }, { "name": "PolylitMixin", "package": "@vaadin/component-base/src/polylit-mixin.js" }, { "name": "LumoInjectionMixin", "package": "@vaadin/vaadin-themable-mixin/lumo-injection-mixin.js" } ], "superclass": { "name": "LitElement", "package": "lit" }, "tagName": "vaadin-date-time-picker", "customElement": true, "attributes": [ { "name": "accessible-name", "type": { "text": "string" }, "description": "String used to label the component to screen reader users.", "fieldName": "accessibleName", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "accessible-name-ref", "type": { "text": "string" }, "description": "Id of the element used as label of the component to screen reader users.", "fieldName": "accessibleNameRef", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "auto-open-disabled", "type": { "text": "boolean" }, "description": "Set to true to prevent the overlays from opening automatically.", "fieldName": "autoOpenDisabled", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "autofocus", "type": { "text": "boolean" }, "description": "Specify that this control should have input focus when the page loads.", "fieldName": "autofocus", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "date-placeholder", "type": { "text": "string" }, "description": "A placeholder string for the date field.", "fieldName": "datePlaceholder", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "error-message", "type": { "text": "string" }, "description": "Error to show when the field is invalid.", "fieldName": "errorMessage", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "helper-text", "type": { "text": "string" }, "description": "String used for the helper text.", "fieldName": "helperText", "inheritedFrom": { "name": "FieldMixin", "package": "@vaadin/field-base/src/field-mixin.js" } }, { "name": "i18n", "type": { "text": "Object" }, "description": "The object used to localize this component. To change the default\nlocalization, replace this with an object that provides all properties, or\njust the individual properties you want to change.\n\nShould be overridden by subclasses to provide a custom JSDoc with the\ndefault I18N properties.", "fieldName": "i18n", "inheritedFrom": { "name": "I18nMixin", "package": "@vaadin/component-base/src/i18n-mixin.js" } }, { "name": "initial-position", "type": { "text": "string" }, "description": "Date which should be visible in the date picker overlay when there is no value selected.\n\nThe same date formats as for the `value` property are supported but without the time part.", "fieldName": "initialPosition", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "max", "type": { "text": "string" }, "description": "The latest value (date and time) that can be selected. All later values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "fieldName": "max", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "min", "type": { "text": "string" }, "description": "The earliest allowed value (date and time) that can be selected. All earlier values will be disabled.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"`\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "fieldName": "min", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "name", "type": { "text": "string" }, "description": "The name of the control, which is submitted with the form data.", "fieldName": "name", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "readonly", "type": { "text": "boolean" }, "description": "Set to true to make this element read-only.", "fieldName": "readonly", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "show-week-numbers", "type": { "text": "boolean" }, "description": "Set true to display ISO-8601 week numbers in the calendar. Notice that\ndisplaying week numbers is only supported when `i18n.firstDayOfWeek`\nis 1 (Monday).", "fieldName": "showWeekNumbers", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "step", "type": { "text": "number" }, "description": "Defines the time interval (in seconds) between the items displayed\nin the time selection box. The default is 1 hour (i.e. `3600`).\n\nIt also configures the precision of the time part of the value string. By default\nthe component formats time values as `hh:mm` but setting a step value\nlower than one minute or one second, format resolution changes to\n`hh:mm:ss` and `hh:mm:ss.fff` respectively.\n\nUnit must be set in seconds, and for correctly configuring intervals\nin the dropdown, it need to evenly divide a day.\n\nNote: it is possible to define step that is dividing an hour in inexact\nfragments (i.e. 5760 seconds which equals 1 hour 36 minutes), but it is\nnot recommended to use it for better UX.", "fieldName": "step", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "time-placeholder", "type": { "text": "string" }, "description": "A placeholder string for the time field.", "fieldName": "timePlaceholder", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } }, { "name": "value", "type": { "text": "string" }, "description": "The value for this element.\n\nSupported date time format is based on ISO 8601 (without a time zone designator):\n- Minute precision `\"YYYY-MM-DDThh:mm\"` (default)\n- Second precision `\"YYYY-MM-DDThh:mm:ss\"`\n- Millisecond precision `\"YYYY-MM-DDThh:mm:ss.fff\"`", "fieldName": "value", "inheritedFrom": { "name": "DateTimePickerMixin", "module": "src/vaadin-date-time-picker-mixin.js" } } ] } ], "exports": [ { "kind": "js", "name": "DateTimePicker", "declaration": { "name": "DateTimePicker", "module": "src/vaadin-date-time-picker.js" } } ] } ] }