From a309e2eaaf47269e4f3c4b2d1aa4b4a54aab7b7f Mon Sep 17 00:00:00 2001 From: crisbeto Date: Sat, 23 Dec 2017 23:30:48 +0200 Subject: [PATCH] docs(dialog): add note about setting initial focus Adds a note to the dialog docs about setting the initial focus. Relates to #9107. --- src/lib/dialog/dialog.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/lib/dialog/dialog.md b/src/lib/dialog/dialog.md index 5bbcabdc6ef6..c475c8d27611 100644 --- a/src/lib/dialog/dialog.md +++ b/src/lib/dialog/dialog.md @@ -142,7 +142,8 @@ within itself. Once a dialog is closed, it will return focus to the element that before the dialog was opened. #### Focus management -By default, the first tabbable element within the dialog will receive focus upon open. +By default, the first tabbable element within the dialog will receive focus upon open. This can +be configured by setting the `cdkFocusInitial` attribute on another focusable element. Tabbing through the elements of the dialog will keep focus inside of the dialog element, wrapping back to the first tabbable element when reaching the end of the tab sequence.