Download and install RTL/LTR Bug Inspector from OutSystems Forge.
Open your OutSystems 11 Reactive Web application in Service Studio.
Click Manage Dependencies.
Search for the installed component module.
Select the public RTLLTRInspector Block and apply the dependency changes.
Open the Reactive Web screen you want to inspect.
Drag the RTLLTRInspector Block onto the screen.
Configure the Block's input parameters.
Publish your application.
The Block includes its own Run RTL/LTR Scan button, so no separate scan button or Screen Action is required.
TargetSelector
Specify the CSS selector of the area you want to inspect.
Examples:
body — Inspect the entire page.
body
#MainContent — Inspect a specific container with that ID.
#MainContent
.account-details — Inspect elements matching a specific CSS class.
.account-details
Use a stable selector that matches an element in the rendered application.
Scanning Options
Configure the available inspection options to enable or disable relevant checks, such as overflow detection, direction analysis, flex alignment inspection, and mixed-language detection.
InstanceKey
When using multiple inspector instances, configure a unique instance key for each Block.
Open the published application screen.
Locate the Run RTL/LTR Scan toolbar, which appears at the top by default.
Click Run RTL/LTR Scan.
The component analyzes the selected screen area.
The inspection panel displays potential layout issues.
The inspection panel provides information such as:
Issue category and severity.
Affected element selector.
Description of the potential issue.
Suggested CSS improvements.
Use the available filters to narrow down findings.
Select a finding from the inspection panel.
Click Locate.
The inspector scrolls to the affected element and highlights it.
Review the element and its layout.
Apply any necessary changes manually in your application.
Drag the Move handle to reposition the toolbar within the visible screen.
Move the Inspection Panel
Drag the inspection panel by its header to reposition it.
Hide/Show
Click Hide to collapse the toolbar. Use Show RTL/LTR Inspector to reopen it.
Run an inspection scan.
Review the detected findings.
Click Export JSON.
Download the structured report for further investigation or QA documentation.
Review the exported element selectors before sharing reports externally.
The included RTLLTRInspector Demo demonstrates how to integrate and use the component.
It provides sample scenarios for testing English and Arabic layouts, overflow, flex alignment, mixed-language content, and responsive behavior.
Use the demo to explore the inspector's features before integrating it into your own application.
Use the inspector primarily in development and QA environments.
Test both English (LTR) and Arabic (RTL) layouts.
Treat detected findings as potential issues requiring manual verification.
Review suggested CSS fixes before applying them.
Remove or disable developer inspection controls in production environments when they are no longer needed.