How is your experience with the OutSystems Community?
ltr-bug-inspector
Reactive icon

RTL/LTR Bug Inspector

Stable version 1.0.0 (Compatible with OutSystems 11)
Uploaded
 on 19 Nov (9 hours ago)
 by 
0.0
 (0 ratings)
ltr-bug-inspector

RTL/LTR Bug Inspector

Documentation
1.0.0

1. Installation

  1. Download and install RTL/LTR Bug Inspector from OutSystems Forge.

  2. Open your OutSystems 11 Reactive Web application in Service Studio.

  3. Click Manage Dependencies.

  4. Search for the installed component module.

  5. Select the public RTLLTRInspector Block and apply the dependency changes.

2. Add the Inspector to Your Screen

  1. Open the Reactive Web screen you want to inspect.

  2. Drag the RTLLTRInspector Block onto the screen.

  3. Configure the Block's input parameters.

  4. Publish your application.

The Block includes its own Run RTL/LTR Scan button, so no separate scan button or Screen Action is required.

3. Configuration

TargetSelector

Specify the CSS selector of the area you want to inspect.

Examples:

  • body — Inspect the entire page.

  • #MainContent — Inspect a specific container with that ID.

  • .account-details — Inspect elements matching a specific CSS class.

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.

4. How to Run a Scan

  1. Open the published application screen.

  2. Locate the Run RTL/LTR Scan toolbar, which appears at the top by default.

  3. Click Run RTL/LTR Scan.

  4. The component analyzes the selected screen area.

  5. The inspection panel displays potential layout issues.

5. Review Detected 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.

6. Highlight an Affected Element

  1. Select a finding from the inspection panel.

  2. Click Locate.

  3. The inspector scrolls to the affected element and highlights it.

  4. Review the element and its layout.

  5. Apply any necessary changes manually in your application.

7. Move or Hide the Inspector


Move the Toolbar

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.

8. Export Scan Results

  1. Run an inspection scan.

  2. Review the detected findings.

  3. Click Export JSON.

  4. Download the structured report for further investigation or QA documentation.

Review the exported element selectors before sharing reports externally.

9. Demo Application

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.



Recommendations

  • 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.