SiTimepickerComponent documentation¶

selector

si-timepicker

Common interface for form item controls. Controls that should be connected to SiFormItemComponent must implement this interface and must be provided using the SI_FORM_ITEM_CONTROL token.

Input Properties¶

Name	Type	Default	Description
disabled ¶	`boolean`	`false`	All input fields will be disabled if set to true.
errormessageId ¶	`string`	`${this.id()}-errormessage`	This ID will be bound to the `aria-describedby` attribute of the timepicker. Use this to reference the element containing the error message(s) for the timepicker. It will be picked by the SiFormItemComponent if the timepicker is used inside a form item.
hideLabels ¶	`boolean`	`false`	Hide the labels of the input fields.
hoursAriaLabel ¶	`TranslatableString`	$localize`:@@SI_DATEPICKER.HOURS:Hours`
hoursLabel ¶	`TranslatableString`	`'hh'`	Visible label for the hours input.
hoursPlaceholder ¶	`string`	`'hh'`	Placeholder for the hours input.
id ¶	`string`	`__si-timepicker-${SiTimepickerComponent.idCounter++}`
max ¶	`Date`		A maximum time limit. The date part of the date object will be ignored.
meridians ¶	`string`[]		Custom labels for the AM and PM options.
meridiansAriaLabel ¶	`TranslatableString`	$localize`:@@SI_DATEPICKER.PERIOD:Period`
meridiansLabel ¶	`TranslatableString`	`'am/pm'`	Visible label for the AM/PM selector.
millisecondsAriaLabel ¶	`TranslatableString`	$localize`:@@SI_DATEPICKER.MILLISECONDS:Milliseconds`
millisecondsLabel ¶	`TranslatableString`	`'ms'`	Visible label for the milliseconds input.
millisecondsPlaceholder ¶	`string`	`'ms'`	Placeholder for the milliseconds input.
min ¶	`Date`		A minimum time limit. The date part of the date object will be ignored.
minutesAriaLabel ¶	`TranslatableString`	$localize`:@@SI_DATEPICKER.MINUTES:Minutes`
minutesLabel ¶	`TranslatableString`	`'mm'`	Visible label for the minutes input.
minutesPlaceholder ¶	`string`	`'mm'`	Placeholder for the minutes input.
readonly ¶	`boolean`	`false`	Whether the time inputs are read-only.
secondsAriaLabel ¶	`TranslatableString`	$localize`:@@SI_DATEPICKER.SECONDS:Seconds`
secondsLabel ¶	`TranslatableString`	`'ss'`	Visible label for the seconds input.
secondsPlaceholder ¶	`string`	`'ss'`	Placeholder for the seconds input.
showMeridian ¶	`boolean`		Show time in 12-hour period including the select to toggle between AM/PM.
showMilliseconds ¶	`boolean`	`false`	Whether the milliseconds input is displayed.
showMinutes ¶	`boolean`	`true`	Whether the minutes input is displayed.
showSeconds ¶	`boolean`	`false`	Whether the seconds input is displayed.

Output Properties¶

Name	Type	Description
inputCompleted ¶	`void`	Emits when the user presses Enter in the final time input.
isValid ¶	`boolean`	Emits whether the entered time components form a valid time.
meridianChange ¶	`string`	Emits the selected meridian when it changes.

Attributes and Methods¶

Name	Type	Default	Description
(readonly) labelledby ¶	`string`	...	ID that should be assigned to the label element inside the SiFormItemComponent . If the target control is not of type input, select or button, it cannot be referenced by a label. Instead, aria-labelledby must be used to create a reference to a label. In such a case, an implementation of SiFormItemControl must provide the id of the label in labelledby . SiFormItemComponent will apply the id to the label so that it can be used inside the control to reference it in the aria-labelledby attribute.

Types Documentation¶

SI_FORM_ITEM_CONTROL `InjectionToken`<`SiFormItemControl`> = ...¶ Variable

TranslatableString (`string` & `Translatable`)¶ Type alias Represents a translatable string. This can either be a translation key, e.g. `ACTIONS.EDIT` that will be automatically translated when displayed on the UI or a pre-translated string, e.g. `Edit` . Equivalent to a normal string in usage and functionality.

SiFormItemControl

¶

Interface

Common interface for form item controls. Controls that should be connected to SiFormItemComponent must implement this interface and must be provided using the SI_FORM_ITEM_CONTROL token.

Properties
Generated ID that the SiFormItemComponent will assign to the element containing the error messages. Implementations of SiFormItemControl must generate this ID and assign it to the `aria-describedby` attribute of their focusable elements. errormessageId: (`string` \| `Signal`<`string`>)¶
The actual id of the control that should be used in the `for` attribute of a label. id?: (`string` \| `Signal`<(`string` \| `undefined`)>)¶
If the control is meant to be used a checkbox. This affects the label positioning. isFormCheck?: `boolean`¶
ID that should be assigned to the label element inside the SiFormItemComponent . If the target control is not of type input, select or button, it cannot be referenced by a label. Instead, aria-labelledby must be used to create a reference to a label. In such a case, an implementation of SiFormItemControl must provide the id of the label in labelledby . SiFormItemComponent will apply the id to the label so that it can be used inside the control to reference it in the aria-labelledby attribute. labelledby?: (`string` \| `Signal`<(`string` \| `undefined`)> \| `null`)¶

SiFormError

¶

Interface

Properties
key: `string`¶
message?: `TranslatableString`¶
params: `any`¶

SiFormValidationErrorMapper

¶

Interface

Interface for form error mapper. It resolves a key to either a translatable string or function which is called with the validation error for its key and should return a translatable string.

Index signature: [ key: string ]: (string | (error: any) => string | undefined)¶

Properties
dateFormat?: (`TranslatableString` \| (error: { format: `string` }) => `TranslatableString`)¶
email?: (`TranslatableString` \| (error: { email: `boolean` }) => `TranslatableString`)¶
max?: (`TranslatableString` \| (error: { actual: `number`, max: `number` }) => `TranslatableString`)¶
maxDate?: (`TranslatableString` \| (error: { actual: `Date`, max: `Date` }) => `TranslatableString`)¶
maxLength?: (`TranslatableString` \| (error: { actualLength: `number`, requiredLength: `number` }) => `TranslatableString`)¶
min?: (`TranslatableString` \| (error: { actual: `number`, min: `number` }) => `TranslatableString`)¶
minDate?: (`TranslatableString` \| (error: { actual: `Date`, min: `Date` }) => `TranslatableString`)¶
minLength?: (`TranslatableString` \| (error: { actualLength: `number`, requiredLength: `number` }) => `TranslatableString`)¶
numberFormat?: (`TranslatableString` \| (error: { numberFormat: `boolean` }) => `TranslatableString`)¶
pattern?: (`TranslatableString` \| (error: { pattern: (`string` \| `RegExp`) }) => `TranslatableString`)¶
required?: (`TranslatableString` \| (error: { required: `boolean` }) => `TranslatableString`)¶
requiredTrue?: (`TranslatableString` \| (error: { required: `boolean` }) => `TranslatableString`)¶

provideFormValidationErrorMapper

(mapper: SiFormValidationErrorMapper) => Provider¶

Function

The error mapper is used to resolve an angular validation error to a TranslatableString . It will be merged with already existing error mappers.

Parameters
mapper: `SiFormValidationErrorMapper`¶

Breakpoints

¶

Interface

Properties
lgMinimum: `number`¶
mdMinimum: `number`¶
smMinimum: `number`¶
xlMinimum: `number`¶
xxlMinimum: `number`¶

SiFormItemComponent

implements AfterContentInit, AfterContentChecked, OnChanges, OnInit, OnDestroy, SiFormFieldsetControl¶

Class

▶

Constructor
() => `{}`¶

Properties
container: (`SiFormContainerComponent`<{ [ key: `string` ]: `AbstractControl`<`any`, `any`, `any`> } }> \| `null`) = ...¶
control: `Signal`<(`AbstractControl`<`any`, `any`, `any`> \| `null` \| `undefined`)> implements `SiFormFieldsetControl.control` = ...¶
controlElementRef: `Signal`<(`ElementRef`<`HTMLElement`> \| `undefined`)> = ...¶
Disables the automatic error printing. Error printing will be enabled by default in v46. disableErrorPrinting: `InputSignalWithTransform`<`boolean`, `unknown`> = `false`¶
errors: `WritableSignal`<`SiFormError`[]> implements `SiFormFieldsetControl.errors` = ...¶
fieldControl: `Signal`<(`SiFormItemControl` \| `undefined`)> = ...¶
fieldControlNative: `WritableSignal`<(`SiFormItemControl` \| `undefined`)> = ...¶
fieldControlQuery: `Signal`<(`SiFormItemControl` \| `undefined`)> = ...¶
fieldset: (`SiFormFieldsetComponent` \| `null`) = ...¶
Maps validation errors of the contained control to custom messages. formErrorMapper: `InputSignal`<(`SiFormValidationErrorMapper` \| `undefined`)> = ...¶
hasRequiredValidator: `WritableSignal`<`boolean`> = ...¶
The label to be displayed in the form item. It will be translated if a translation key is available. label: `InputSignal`<`TranslatableString`> = ...¶
A custom width value to be applied to the label. A value of 0 is allowed as well to visually hide away the label area. Numbers will be converted to pixels. Using numbers is discouraged and might be dropped. Example: `labelWidth="100px"` labelWidth: `InputSignal`<(`string` \| `number` \| `undefined`)> = ...¶
labelWidthCssVar: `Signal`<(`string` \| `undefined`)> = ...¶
ngControl: `Signal`<(`NgControl` \| `undefined`)> = ...¶
previousErrors?: (`ValidationErrors` \| `null`)¶
printErrors: `Signal`<`boolean`> = ...¶
radioGroupName: `Signal`<(`string` \| `undefined`)> implements `SiFormFieldsetControl.radioGroupName` = ...¶
required: `Signal`<`boolean`> implements `SiFormFieldsetControl.required` = ...¶
Defines that this form item is required for the overall form to be valid. requiredInput: `InputSignalWithTransform`<`boolean`, `unknown`> = `false`¶
requiredTestControl: `FormControl`<(`string` \| `null`)> = ...¶
requiredValidator: `Signal`<(`RequiredValidator` \| `undefined`)> = ...¶
touched: `WritableSignal`<`boolean`> implements `SiFormFieldsetControl.touched` = ...¶
validationErrorService: `SiFormValidationErrorService` = ...¶
validator?: (`ValidatorFn` \| `null`)¶

Accessors
get formItemErrormessageId: (`string` \| `null`)¶
get formItemId: (`string` \| `null`)¶
get formItemLabelledBy: (`string` \| `null`)¶

Methods

A callback method that is invoked immediately after the default change detector has completed checking all of the directive's content.
ngAfterContentChecked: () => void from AfterContentChecked.ngAfterContentChecked¶

A callback method that is invoked immediately after Angular has completed initialization of all of the directive's content. It is invoked only once when the directive is instantiated.
ngAfterContentInit: () => void from AfterContentInit.ngAfterContentInit¶

ngOnChanges

(changes: { control: SimpleChange<Signal<(AbstractControl<any, any, any> | null | undefined)>>, disableErrorPrinting: false, errors: SimpleChange<WritableSignal<SiFormError[]>>, formErrorMapper: SimpleChange<(SiFormValidationErrorMapper | undefined)>, label: SimpleChange<TranslatableString>, labelWidth: SimpleChange<(string | number | undefined)>, ngAfterContentChecked: SimpleChange<() => void>, ngAfterContentInit: SimpleChange<() => void>, ngControl: SimpleChange<Signal<(NgControl | undefined)>>, ngOnChanges: SimpleChange<(changes:

{ readonly label?: SimpleChange<TranslatableString> | undefined; readonly labelWidth?: SimpleChange<string | number | undefined> | undefined; ... 13 more ...; ngOnDestroy?: SimpleChange<...> | undefined; }

) => void>, ngOnDestroy: SimpleChange<() => void>, ngOnInit: SimpleChange<() => void>, radioGroupName: SimpleChange<Signal<(string | undefined)>>, required: SimpleChange<Signal<boolean>>, requiredInput: false, touched: SimpleChange<WritableSignal<boolean>> }) => void from OnChanges.ngOnChanges¶

A callback method that is invoked immediately after the default change detector has checked data-bound properties if at least one has changed, and before the view and content children are checked.

Parameters

The changed properties.
changes: { control: SimpleChange<Signal<(AbstractControl<any, any, any> | null | undefined)>>, disableErrorPrinting: false, errors: SimpleChange<WritableSignal<SiFormError[]>>, formErrorMapper: SimpleChange<(SiFormValidationErrorMapper | undefined)>, label: SimpleChange<TranslatableString>, labelWidth: SimpleChange<(string | number | undefined)>, ngAfterContentChecked: SimpleChange<() => void>, ngAfterContentInit: SimpleChange<() => void>, ngControl: SimpleChange<Signal<(NgControl | undefined)>>, ngOnChanges: SimpleChange<(changes:

{ readonly label?: SimpleChange<TranslatableString> | undefined; readonly labelWidth?: SimpleChange<string | number | undefined> | undefined; ... 13 more ...; ngOnDestroy?: SimpleChange<...> | undefined; }

) => void>, ngOnDestroy: SimpleChange<() => void>, ngOnInit: SimpleChange<() => void>, radioGroupName: SimpleChange<Signal<(string | undefined)>>, required: SimpleChange<Signal<boolean>>, requiredInput: false, touched: SimpleChange<WritableSignal<boolean>> }¶

A callback method that performs custom clean-up, invoked immediately before a directive, pipe, or service instance is destroyed.
ngOnDestroy: () => void from OnDestroy.ngOnDestroy¶

A callback method that is invoked immediately after the default change detector has checked the directive's data-bound properties for the first time, and before any of the view or content children have been checked. It is invoked only once when the directive is instantiated.
ngOnInit: () => void from OnInit.ngOnInit¶

updateRequiredState: () => void¶

updateValidationMessages: () => void¶

~~SiFormContainerComponent~~

<(TControl: { [ K in keyof TControl ]: AbstractControl })>¶

Class

▶

Deprecated: This component should no longer be used.

When providing a form wide error mapper, use the provideFormValidationErrorMapper .

import { provideFormValidationErrorMapper } form '@siemens/element-ng/forms'

@Component({
  template: `<form>...</form>`
  providers: [provideFormValidationErrorMapper({
    'name.required': 'CUSTOM_REQUIRED_ERROR'
  })]
})
class MyFormComponent {}

When using the column layout, use the form-col-layout classes.

<!-- Responsive column layout -->
<form class="responsive-form-col-layout">...</form>
<!-- Always column layout -->
<form class="form-col-layout">...</form>

For a custom breakpoint use the SCSS mixin:

scss
@use '@siemens/element-theme/src/styles/bootstrap/mixins/form-layout';

// Custom responsive breakpoint
.custom-form-col-layout {
  // Above 400px the column layout is used
  @include form-layout.responsive-form-col-layout(400px);
}

Constructor
() => `{}`¶

Properties
The container hosts the form within a siResizeContainer to configure the breakpoint for different screen sizes. Optionally, change the container breakpoints with the contentContainerBreakpoints input. contentContainerBreakpoints: `InputSignal`<(`Breakpoints` \| `undefined`)> = ...¶
A map the maps from control names of the form to their translate keys. The initial map is empty and the user is responsible to add the required translate keys. controlNameTranslateKeyMap: `InputSignal`<`Map`<`string`, `string`>> = `new Map<string, string>()`¶
In some scenarios, one may not want the form container to be responsible for the layout relevant `si-container-[xs\|...]` classes, but let this be done by a different, nested component, e.g. by a group box. In these cases, the property should be set to true. disableContainerBreakpoints: `InputSignalWithTransform`<`boolean`, `unknown`> = `false`¶
Disables the automatic error printing in all nested SiFormItemComponent . Error printing will be enabled by default in v46. disableErrorPrinting: `InputSignalWithTransform`<`boolean`, `unknown`> = `false`¶
Every validation error has an errorCode. This map holds translate keys for error codes. The keys can be used to display a translated message for each validation error. The defaults old english readable key defaults for the Angular standard validators of the `Validators` class like `min` , `max` or `required` . Use the input to set your own translate keys for the form validators you need. errorCodeTranslateKeyMap: `InputSignal`<(`SiFormValidationErrorMapper` \| `Map`<`string`, `string`> \| `undefined`)> = ...¶
Set the form entity to the container to enable the overall form validation on in the form container edit panel. form: `InputSignal`<(`FormGroup`<`TControl`> \| `undefined`)> = ...¶
formErrorMapper: `Signal`<{ [ key: `string` ]: (`string` \| (error: `any`) => `string` \| `undefined`) } }> = ...¶
hasParentContainer: `boolean` = ...¶
A custom width value to be applied to all labels. Example: `labelWidth="100px".` labelWidth: `InputSignal`<(`string` \| `undefined`)> = ...¶
A form container in readonly mode is only displaying the form content without ability to change it. The edit panel with typically save and cancel buttons is hidden. Set to true to display the edit panel. readonly: `InputSignalWithTransform`<`boolean`, `unknown`> = `false`¶

Accessors
Indicates whether the content editor message shall be styled as warning. Returns `true` , if SiFormContainerComponent.userInteractedWithForm is true and the form is invalid. get invalidFormContainerMessage: `boolean`¶
Indicates whether the user interacted with the form. Returns `true` , if the user selected at least one form element and [blurred] https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event by losing focus again (e.g. by setting focus on another element), or by editing the content of a form element. Otherwise `false` . get userInteractedWithForm: `boolean`¶
Indicates whether content editor message shall be styled as success. Returns `true` , if SiFormContainerComponent.userInteractedWithForm is true and the form is valid. get validFormContainerMessage: `boolean`¶

Methods

getControlNameTranslateKey

(controlName: string) => (string | undefined)¶

Parameters
controlName: `string`¶

SiFormFieldsetComponent

¶

Class

▶

Constructor
() => `{}`¶

Properties
errors: `Signal`<readonly `SiFormError`[]> = ...¶
formItems: `WritableSignal`<`SiFormFieldsetControl`[]> = ...¶
hasOnlyRadios: `Signal`<`boolean`> = ...¶
Switches all child inputs to inline mode inline: `InputSignalWithTransform`<`boolean`, `unknown`> = `false`¶
isRequired: `Signal`<`boolean`> = ...¶
The label for the entire fieldset. label: `InputSignal`<`TranslatableString`> = ...¶
labelId: `string` = ...¶
Overrides the parent label width. labelWidth: `InputSignal`<(`string` \| `undefined`)> = ...¶
Adds a required marker to the label required: `InputSignalWithTransform`<`boolean`, `unknown`> = `false`¶
touched: `Signal`<`boolean`> = ...¶
labelIdCounter: `number` = `0`¶

Methods

registerControl

(item: SiFormFieldsetControl) => void¶

Parameters
item: `SiFormFieldsetControl`¶

unregisterControl

(item: SiFormFieldsetControl) => void¶

Parameters
item: `SiFormFieldsetControl`¶

Except where otherwise noted, content on this site is licensed under MIT License.