Bootstrap

API alert

AlertApi

interface

Represents the API for an alert component.

Methods
close

close(): void

Triggers alert closing programmatically (same as clicking on the close button (×)).

Returns

void


open

open(): void

Triggers the alert to be displayed for the user.

Returns

void


AlertBodyDirective

class

Directive to be used as a structural directive for the body of an alert component.

This directive allows the use of a template reference for the alert body content, with type AlertContext.


AlertComponent

class

AlertComponent is a UI component that extends BaseWidgetDirective to provide an alert box with various customizable properties and behaviors.

Remarks

This component is designed to be used with Bootstrap styles and supports various Bootstrap contextual classes for different alert types.

Properties
animated

animated: undefined | boolean

If true, alert closing will be animated.

Animation is triggered when clicked on the close button (×), via the .close() function or the visible prop is changed

Default Value

true


animatedOnInit

animatedOnInit: undefined | boolean

If true, alert opening will be animated.

Animation is triggered when the .open() function is called or the visible prop is changed

Default Value

false


ariaCloseButtonLabel

ariaCloseButtonLabel: undefined | string

Accessibility close button label

Default Value

'Close'


children

children: SlotContent<AlertContext>

Template for the alert content


className

className: undefined | string

CSS classes to be applied on the widget main container

Default Value

''


dismissible

dismissible: undefined | boolean

If true, alert can be dismissed by the user. The close button (×) will be displayed and you can be notified of the event with the (close) output.

Default Value

true


hidden

hidden: EventEmitter<void>

Callback called when the alert is hidden.

Default Value
() => {}

shown

shown: EventEmitter<void>

Callback called when the alert is shown.

Default Value
() => {}

structure

structure: SlotContent<AlertContext>

Global template for the alert component


transition

transition: undefined | TransitionFn

The transition function will be executed when the alert is displayed or hidden.

Depending on the value of animatedOnInit, the animation can be optionally skipped during the showing process.

Default Value

fadeTransition


type

type: undefined | BSContextualClass

Type of the alert, following bootstrap types.

Default Value

'primary'


visible

visible: undefined | boolean

If true the alert is visible to the user

Default Value

true


visibleChange

visibleChange: EventEmitter<boolean>

Callback called when the alert visibility changed.

Default Value
() => {}
Accessors
api

get api(): W["api"]

Retrieves the widget api

Returns

W["api"]

the widget api


directives

get directives(): W["directives"]

Retrieves the widget directives

Returns

W["directives"]

the widget directives


state

get state(): AngularState<W>

Retrieves the widget state as an Angular Signal

Returns

AngularState<W>

the widget state


AlertContext

interface

Represents the context for an Alert component.

Properties
api

api: AlertApi

all the api functions to interact with the widget


directives

directives: AlertDirectives

directives to be used on html elements in the template of the widget or in the slots


state

state: AngularState<AlertWidget>

the state of the widget


alertDefaultSlotStructure

constant

const alertDefaultSlotStructure: SlotContent<AlertContext>

Represents the default slot structure for the alert component.


AlertDirectives

interface

Represents the directives for an alert component.

Properties
transitionDirective

transitionDirective: Directive

the transition directive, piloting what is the visual effect of going from hidden to visible


AlertProps

interface

Represents the properties for the Alert component.

Properties
animated

animated: boolean

If true, alert closing will be animated.

Animation is triggered when clicked on the close button (×), via the .close() function or the visible prop is changed

Default Value

true


animatedOnInit

animatedOnInit: boolean

If true, alert opening will be animated.

Animation is triggered when the .open() function is called or the visible prop is changed

Default Value

false


ariaCloseButtonLabel

ariaCloseButtonLabel: string

Accessibility close button label

Default Value

'Close'


children

children: SlotContent<AlertContext>

Template for the alert content


className

className: string

CSS classes to be applied on the widget main container

Default Value

''


dismissible

dismissible: boolean

If true, alert can be dismissed by the user. The close button (×) will be displayed and you can be notified of the event with the (close) output.

Default Value

true


onHidden

onHidden: () => void

Callback called when the alert is hidden.

Returns

void

Default Value
() => {}

onShown

onShown: () => void

Callback called when the alert is shown.

Returns

void

Default Value
() => {}

onVisibleChange

onVisibleChange: (visible) => void

Callback called when the alert visibility changed.

Parameters

visible: boolean

Returns

void

Default Value
() => {}

structure

structure: SlotContent<AlertContext>

Global template for the alert component


transition

transition: TransitionFn

The transition function will be executed when the alert is displayed or hidden.

Depending on the value of animatedOnInit, the animation can be optionally skipped during the showing process.

Default Value

fadeTransition


type

type: BSContextualClass

Type of the alert, following bootstrap types.

Default Value

'primary'


visible

visible: boolean

If true the alert is visible to the user

Default Value

true


AlertState

interface

Represents the state of an alert component.

Properties
ariaCloseButtonLabel

ariaCloseButtonLabel: string

Accessibility close button label

Default Value

'Close'


children

children: SlotContent<AlertContext>

Template for the alert content


className

className: string

CSS classes to be applied on the widget main container

Default Value

''


dismissible

dismissible: boolean

If true, alert can be dismissed by the user. The close button (×) will be displayed and you can be notified of the event with the (close) output.

Default Value

true


hidden

hidden: boolean

Is true when the alert is hidden. Compared to visible, this is updated after the transition is executed.


structure

structure: SlotContent<AlertContext>

Global template for the alert component


type

type: BSContextualClass

Type of the alert, following bootstrap types.

Default Value

'primary'


visible

visible: boolean

If true the alert is visible to the user

Default Value

true


AlertStructureDirective

class

Directive to define the structure of an alert component.

This directive uses a TemplateRef to inject the template reference of the AlertContext.


AlertWidget

type alias

AlertWidget: Widget<AlertProps, AlertState, AlertApi, AlertDirectives>

Represents an alert widget component.


createAlert

function

createAlert(props?): AlertWidget

Create an AlertWidget with given config props

Parameters

props?: PropsConfig<AlertProps>

Returns

AlertWidget

an AlertWidget


getAlertDefaultConfig

function

getAlertDefaultConfig(): AlertProps

Retrieve a shallow copy of the default Alert config

Returns

AlertProps

the default Alert config