MAIDR JavaScript API
    Preparing search index...

    Interface LiveNavigateOptions

    Who asked a chart to move, and whether to take the reader there, as LiveNavigator is told it.

    interface LiveNavigateOptions {
        byAgent?: boolean;
        focus?: boolean;
    }
    Index

    Properties

    Properties

    byAgent?: boolean

    An in-browser agent asked, through the WebMCP tools, rather than the host page. A target kept for the reader's next focus-in remembers which of the two set it, so the reader switching agent access off can drop the agent's and leave the host's. With null, only a target an agent kept is withdrawn.

    focus?: boolean

    The reader asked to be taken there: a reader who is not in the chart is moved into it. The target is kept exactly as without this, then the chart moves keyboard focus to its own focusable element and enters at once -- the focus-in a Tab to it makes, run without waiting a tick -- which applies the target and announces it as it would for that Tab. So LiveDataManager.inspect, asked right after, says whether the reader arrived. Focus is never taken from a dialog in the chart's own document -- a MAIDR dialog, in this chart or another, or one of the page's own -- nor moved from elsewhere in the chart; a page that frames the chart keeps its dialogs in another document, which the chart cannot see, so that page must not ask while one is open. A page of its own that does not have the browser's focus is left as it is: no page can take that focus from the browser's own panels, and moving the page's focus there would only drop the reader into the chart behind their back. In a frame, focus is asked for regardless, since that is how a frame receives it -- where the browser allows: WebKit does not without the reader's own click or key -- and a frame that still does not have it puts its own focus back. Either way, if the page does not have the browser's focus, nothing is entered and the target stays kept for the reader's next entry. Ignored with null, and for a reader already in the chart.