hmos-multidevice-avoid-areas

What problem does it solve?

It prevents HarmonyOS UI elements from being covered or made unclickable by status bars, navigation indicators, cutouts (notches), and soft keyboards on different device types and window states.

Core Features & Use Cases

• Declarative avoid-area adaptation: Select the correct adaptation path for safe area extension, immersive full-screen layout, cutout handling, and keyboard overlap behavior.
• Dynamic system-area indexing: Use a scene-driven approach that focuses on identifying avoid-area types first, then applying layout constraints and update logic.
• Verification-ready output: Produces structured outputs for REQ/DEV/FIX/VAL including device constraints, implementation touchpoints, and an evidence-based verification matrix.

Use cases include immersive detail pages, chat/comment screens with keyboard interactions, and device-variant layouts that must handle cutouts and system UI changes without hardcoded pixel sizes.

Quick Start

Ask an AI to apply hmos-multidevice-avoid-areas to your HarmonyOS page so it dynamically detects avoid areas, updates layout when the keyboard opens or the window changes, and outputs a verification matrix for screenshots and evidence.