Skip to content

scrollUntilTextIsVisible

Scrolls the screen in the specified direction until an element containing the provided text becomes visible in the view hierarchy. The text does not need to be an exact match - it will find elements where the provided text appears anywhere within the element’s text.

The text argument is required. Only provide additional fields if multiple elements contain the same text. In this case the additional fields will be used to identify the specific view to expect to be visible while scrolling.

Source

  • Kind: class-backed
  • Class: xyz.block.trailblaze.toolcalls.commands.ScrollUntilTextIsVisibleTrailblazeTool

Contract

  • Visible to LLM: yes (surface_to_llm: true)
  • Recordable: yes (is_recordable: true)
  • Host-only: no (requires_host: false)

Input schema

Required parameters

  • text — String Text to search for while scrolling.

Optional parameters

  • id — String The element id to scroll until. REQUIRED: ‘text’ and/or ‘id’ parameter.
  • index — Integer A 0-based index to disambiguate multiple views with the same text. Default is ‘0’.
  • direction — ToolParameterType.Enum( entries = [UP, DOWN, RIGHT, LEFT] ) Direction to scroll. Default is ‘DOWN’.
  • visibilityPercentage — Integer Percentage of element visible in viewport. Default is ‘100’.
  • centerElement — Boolean If it will attempt to stop scrolling when the element is closer to the screen center. Default is ‘false’.
  • scrollStartPosition — ToolParameterType.Enum( entries = [CENTER, TOP, BOTTOM] ) Which part of the screen to scroll from. Default is ‘CENTER’.
  • reasoning — String

Output

Returns: string (opaque text content)

Typed result schemas (kind: query | action, MCP structuredContent) are not yet carried by the resolved manifest — this section will gain detail when that lands.