diff --git a/src/cdk/a11y/a11y.md b/src/cdk/a11y/a11y.md index 6abe41a3f264..c2893b95850b 100644 --- a/src/cdk/a11y/a11y.md +++ b/src/cdk/a11y/a11y.md @@ -84,6 +84,9 @@ For example: Focus region end ``` +**Note:** If you're using `cdkFocusInitial` together with the `CdkTrapFocus` directive, nothing +will happen unless you've enabled the `cdkTrapFocusAutoCapture` option as well. This is due to +`CdkTrapFocus` not capturing focus on initialization by default. ## InteractivityChecker `InteractivityChecker` is used to check the interactivity of an element, capturing disabled,