Class UmbModalRouteRegistrationController<UmbModalTokenData, UmbModalTokenValue>

This mixin enables a web-component to host controllers. This enables controllers to be added to the life cycle of this element.

Type Parameters

  • UmbModalTokenData extends {
        [key: string]: any;
    } = {
        [key: string]: any;
    }
  • UmbModalTokenValue = unknown

Hierarchy (view full)

Implements

Constructors

Properties

Accessors

Methods

  • Appends an additional path to the modal route.

    This can help specify the URL for this modal, or used to add a parameter to the URL like this: "/modal/my-modal/:index/" A folder name starting with a colon ":" will be interpreted as a parameter. Then this modal can open with any value in that location. When modal is being setup the value of the parameter can be read from the route params. See the example:

    Parameters

    • additionalPath: string

      The additional path to be appended to the modal route

    Returns UmbModalRouteRegistrationController<UmbModalTokenData, UmbModalTokenValue>

    this

    const modalRegistration = new UmbModalRouteRegistrationController(this, MY_MODAL_TOKEN)
    modalRegistration.addAdditionalPath(':index')

    modalRegistration.onSetup((params) => {
    const index = params.index;
    // When entering the url of: "/modal/my-modal/hello-world/"
    // Then index will be "hello-world"
    }
  • Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

    The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

    When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.

    When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in ยง 2.8 Observing event listeners.

    When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

    If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

    The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

    MDN Reference

    Parameters

    • type: string
    • callback: null | EventListenerOrEventListenerObject
    • Optionaloptions: boolean | AddEventListenerOptions

    Returns void

  • Registerer one or more additional paths to the modal route, similar to addAdditionalPath. But without defining the actual path name. This enables this to be asynchronously defined and even changed later. This can be useful if your modal has to be unique for this registration, avoiding collision with other registrations. If you made a modal for editing one of multiple property, then you can add a unique path holding the property id. Making the URL unique to this modal registration: /modal/my-modal/my-unique-value/

    Notice the modal will only be available when all unique paths have a value.

    Parameters

    • uniquePathNames: string[]

      the unique path names

    Returns UmbModalRouteRegistrationController<UmbModalTokenData, UmbModalTokenValue>

    this

    const modalRegistration = new UmbModalRouteRegistrationController(this, MY_MODAL_TOKEN)
    modalRegistration.addUniquePaths(['myAliasForIdentifyingThisPartOfThePath'])

    // Later:
    modalRegistration.setUniquePathValue('myAliasForIdentifyingThisPartOfThePath', 'myValue');
  • Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.

    MDN Reference

    Parameters

    • event: Event

    Returns boolean

  • Removes the event listener in target's event listener list with the same type, callback, and options.

    MDN Reference

    Parameters

    • type: string
    • callback: null | EventListenerOrEventListenerObject
    • Optionaloptions: boolean | EventListenerOptions

    Returns void

  • Set or change the value of a unique path part.

    Parameters

    • identifier: string

      the unique path part identifier

    • value: undefined | string

      the new value for the unique path part

    Returns void

    const modalRegistration = new UmbModalRouteRegistrationController(this, MY_MODAL_TOKEN)
    modalRegistration.addUniquePaths(['first-one', 'another-one'])

    // Later:
    modalRegistration.setUniquePathValue('first-one', 'myValue');
""