Back to Tips

cdkTrapFocus

The Angular CDK provides the cdkTrapFocus directive, which traps Tab key focus within an element. This is intended to be used to create accessible experience for components like modal dialogs, where focus must be constrained. This directive will not prevent focus from moving out of the trapped region due to mouse interaction.

Angular's CDK Dialog uses this directive internally to trap focus within the dialog element, as well as Angular's Material Dialog component, which is built on top of the CDK Dialog.

<div class="my-inner-dialog-content" cdkTrapFocus>
  <!-- Tab and Shift + Tab will not leave this element. -->
  <input type="text" />
  <textarea rows="10" cols="50"></textarea>
  <button>Save</button>
  <button>Close</button>
</div>

The directive is part of the A11yModule, so you'll need to import it from @angular/cdk/a11y.

import { A11yModule } from "@angular/cdk/a11y";

@Component({
  selector: "my-component",
  templateUrl: "my-component.html",
  imports: [A11yModule]
})

Support

If you enjoyed this tip and found it useful, consider buying me a coffee. Thanks in advance!

Buy Me a Coffee at ko-fi.com
Using Angular v.18.0.6 🚀