Fluent-Qt

Foundations

Diagnostics

Check a running widget tree for clipped text, missing accessible names, and small hit areas.

Check a widget tree

Once the window is visible and layout has settled, call fluent::diagnostics::Inspector::report(). It returns a versioned JSON report with findings and counts: clipped text, missing accessible names, hit areas below the minimum, focus order, duplicate actions, nested scrolling, and an optional layout-grid check. It does not change widgets or data.

#include <FluentQt/Diagnostics.h>

const QJsonObject report = fluent::diagnostics::Inspector::report(window);

What it does not cover

Use Inspector reports in automated tests for structure and accessibility. Rendering, backdrops, shadows, and pointer or keyboard behavior still need checks in the running app or Gallery.

API reference