Interface IBuildingBlockApi

API for working with building blocks

interface IBuildingBlockApi {
    _apiId: "mendix.BuildingBlockApi";
    addBuildingBlock(containerId: string, options?: BuildingBlockCreationOptions): Promise<string>;
    addEventListener<K>(eventType: K, listener: EventHandler<{}, K>): DisposeListener;
    applyChanges(operations: Operation[]): Promise<ApplyChangesResult>;
    createElement<TElement>(type: TElement["$Type"], options?: TElement["$CreationOptions"]): Promise<TElement>;
    createUnit(type: "Pages$BuildingBlock", containerId: string, options?: BuildingBlockCreationOptions): Promise<BuildingBlock>;
    deleteUnit(unitId: string): Promise<void>;
    getElementMetadata(): Promise<ElementMetadataMap>;
    loadUnits(type: "Pages$BuildingBlock", unitIds: string[]): Promise<BuildingBlock[]>;
    removeEventListener<K>(eventType: K, listener: EventHandler<{}, K>): void;
}

Hierarchy

Properties

_apiId

Methods

addBuildingBlock addEventListener applyChanges createElement createUnit deleteUnit getElementMetadata loadUnits removeEventListener

Properties

_apiId

_apiId

Unique identifier that can be used to register or retrieve a specific API.

Example: mendix.EditorsAPI, mycompany.MyFunkyAPI

Methods

addBuildingBlock

  • addBuildingBlock(containerId, options?): Promise<string>

  • Adds a building block to the specified container.

    Parameters

    • containerId: string

      The ID of the container where the building block will be added. It could be a module or folder.

    • Optionaloptions: BuildingBlockCreationOptions

      Options for that will be used during the building block initilization.

    Returns Promise<string>

    A promise that resolves to the ID of the newly created building block.

addEventListener

  • addEventListener<K>(eventType, listener): DisposeListener

  • Adds an event listener for the specified event type.

    Type Parameters

    • K extends never

    Parameters

    • eventType: K

      The type of event to listen for.

    • listener: EventHandler<{}, K>

      The event listener to add.

    Returns DisposeListener

    A function that can be called to remove the event listener.

applyChanges

  • applyChanges(operations): Promise<ApplyChangesResult>

  • Parameters

    • operations: Operation[]

    Returns Promise<ApplyChangesResult>

createElement

  • createElement<TElement>(type, options?): Promise<TElement>

  • Type Parameters

    Parameters

    Returns Promise<TElement>

createUnit

deleteUnit

  • deleteUnit(unitId): Promise<void>

  • Parameters

    • unitId: string

    Returns Promise<void>

getElementMetadata

  • getElementMetadata(): Promise<ElementMetadataMap>

  • Returns Promise<ElementMetadataMap>

loadUnits

  • loadUnits(type, unitIds): Promise<BuildingBlock[]>

  • Parameters

    • type: "Pages$BuildingBlock"
    • unitIds: string[]

    Returns Promise<BuildingBlock[]>

removeEventListener

  • removeEventListener<K>(eventType, listener): void

  • Removes an event listener for the specified event type.

    Type Parameters

    • K extends never

    Parameters

    • eventType: K

      The type of event to remove the listener from.

    • listener: EventHandler<{}, K>

      The event listener to remove.

    Returns void

Settings

On This Page

Properties
Methods