Member Junction
    Preparing search index...

    Options for controlling navigation behavior

    interface NavigationOptions {
        focusTab?: boolean;
        forceNewTab?: boolean;
        newRecordValues?: string | Record<string, unknown>;
        pinTab?: boolean;
        queryParams?: Record<string, string | null>;
        recordSource?: RecordSourceContext | "none";
        replaceActive?: boolean;
    }
    Index

    Properties

    focusTab?: boolean

    Focus the tab after creation (default: true)

    forceNewTab?: boolean

    Force creation of a new tab instead of replacing temporary tabs If not specified, the NavigationService will use global shift-key detection

    newRecordValues?: string | Record<string, unknown>

    Initial values to populate when creating a new record. Should be a plain object with field names as keys.

    pinTab?: boolean

    Create the tab as a pinned (permanent) tab

    queryParams?: Record<string, string | null>

    URL query parameters to set on the tab after navigation. Use null values to remove a query param.

    recordSource?: RecordSourceContext | "none"

    Origin override for record opens (records-style origin crumb).

    • omitted: NavigationService snapshots the active app/tab — correct for in-tab surfaces, WRONG for overlays/dialogs (it blames the page behind them).
    • a RecordSourceContext: used verbatim. Overlay surfaces set at least sourceLabel ('Conversation', 'Search', ...), plus app/nav-label when there is a real place to return to.
    • 'none': the open has no meaningful origin (e.g. recreating a closed tab from browser history) — no crumb is rendered.
    replaceActive?: boolean

    Replace the currently active tab instead of creating a new one