feat(FocusTrap): focus methods should accept focus options

[lagatchell]

Feature Description

FocusTrap methods should accept focus parameters.

Methods to change:

• focusFirstTabbableElement()
• focusFirstTabbableElementWhenReady()
• focusInitialElement()
• focusInitialElementWhenReady()
• focusLastTabbableElement()
• focusLastTabbableElementWhenReady()

Example:

// Would like to be able to do something like the following
constructor(
  private _elementRef: ElementRef,
  private _focusTrapFactory: ConfigurableFocusTrapFactory,
) {
  const focusTrap = this._focusTrapFactory.create(this._elementRef.nativeElement);
  const focusOptions = { preventScroll: true }; 
  focusTrap.focusFirstTabbableElementWhenReady(focusOptions);
}

Use Case

Using a FocusTrap to focus an element that starts out of view can cause parent elements to shift as the browser tries to bring the element into view. Allowing focus parameters to be configured, will enable consumers to set the preventScroll option and prevent this behavior (in supporting browsers).

Stackblitz demoing a scenario where the ability to specify focus parameters would be helpful.

Maybe be related to #17863

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}