diff --git a/core/src/components.d.ts b/core/src/components.d.ts index 1ac723a0bb..f0998e3a90 100644 --- a/core/src/components.d.ts +++ b/core/src/components.d.ts @@ -1724,7 +1724,7 @@ export namespace Components { */ "enterAnimation"?: AnimationBuilder; /** - * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. This would allow developers to manually move and manage focus within the 3rd party library's overlay. + * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. Developers would disable focus trapping on the Ionic overlay when presenting the 3rd party overlay and then re-enable focus trapping when dismissing the 3rd party overlay and moving focus back to the Ionic overlay. */ "focusTrap": boolean; /** @@ -2144,7 +2144,7 @@ export namespace Components { */ "event": any; /** - * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. This would allow developers to manually move and manage focus within the 3rd party library's overlay. + * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. Developers would disable focus trapping on the Ionic overlay when presenting the 3rd party overlay and then re-enable focus trapping when dismissing the 3rd party overlay and moving focus back to the Ionic overlay. */ "focusTrap": boolean; "getParentPopover": () => Promise; @@ -6466,7 +6466,7 @@ declare namespace LocalJSX { */ "enterAnimation"?: AnimationBuilder; /** - * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. This would allow developers to manually move and manage focus within the 3rd party library's overlay. + * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. Developers would disable focus trapping on the Ionic overlay when presenting the 3rd party overlay and then re-enable focus trapping when dismissing the 3rd party overlay and moving focus back to the Ionic overlay. */ "focusTrap"?: boolean; /** @@ -6816,7 +6816,7 @@ declare namespace LocalJSX { */ "event"?: any; /** - * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. This would allow developers to manually move and manage focus within the 3rd party library's overlay. + * If `true`, focus will not be allowed to move outside of this overlay. If 'false', focus will be allowed to move outside of the overlay. In most scenarios this property should remain set to `true`. Setting this property to `false` can cause severe accessibility issues as users relying on assistive technologies may be able to move focus into a confusing state. We recommend only setting this to `false` when absolutely necessary. Developers may want to consider disabling focus trapping if this overlay presents a non-Ionic overlay from a 3rd party library. Developers would disable focus trapping on the Ionic overlay when presenting the 3rd party overlay and then re-enable focus trapping when dismissing the 3rd party overlay and moving focus back to the Ionic overlay. */ "focusTrap"?: boolean; "hasController"?: boolean; diff --git a/core/src/components/modal/modal.tsx b/core/src/components/modal/modal.tsx index 29ab00c493..3b72e4ee5d 100644 --- a/core/src/components/modal/modal.tsx +++ b/core/src/components/modal/modal.tsx @@ -270,8 +270,10 @@ export class Modal implements ComponentInterface, OverlayInterface { * * Developers may want to consider disabling focus trapping if this * overlay presents a non-Ionic overlay from a 3rd party library. - * This would allow developers to manually move and manage focus - * within the 3rd party library's overlay. + * Developers would disable focus trapping on the Ionic overlay + * when presenting the 3rd party overlay and then re-enable + * focus trapping when dismissing the 3rd party overlay and moving + * focus back to the Ionic overlay. */ @Prop() focusTrap = true; diff --git a/core/src/components/popover/popover.tsx b/core/src/components/popover/popover.tsx index 22fb6cb1ab..02713b7d3c 100644 --- a/core/src/components/popover/popover.tsx +++ b/core/src/components/popover/popover.tsx @@ -256,8 +256,10 @@ export class Popover implements ComponentInterface, PopoverInterface { * * Developers may want to consider disabling focus trapping if this * overlay presents a non-Ionic overlay from a 3rd party library. - * This would allow developers to manually move and manage focus - * within the 3rd party library's overlay. + * Developers would disable focus trapping on the Ionic overlay + * when presenting the 3rd party overlay and then re-enable + * focus trapping when dismissing the 3rd party overlay and moving + * focus back to the Ionic overlay. */ @Prop() focusTrap = true;