chore: clarity

This commit is contained in:
Liam DeBeasi
2024-04-11 11:49:33 -04:00
parent e09d5c82b3
commit e8d41a7a6f
3 changed files with 12 additions and 8 deletions

View File

@ -1724,7 +1724,7 @@ export namespace Components {
*/ */
"enterAnimation"?: AnimationBuilder; "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; "focusTrap": boolean;
/** /**
@ -2144,7 +2144,7 @@ export namespace Components {
*/ */
"event": any; "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; "focusTrap": boolean;
"getParentPopover": () => Promise<HTMLIonPopoverElement | null>; "getParentPopover": () => Promise<HTMLIonPopoverElement | null>;
@ -6466,7 +6466,7 @@ declare namespace LocalJSX {
*/ */
"enterAnimation"?: AnimationBuilder; "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; "focusTrap"?: boolean;
/** /**
@ -6816,7 +6816,7 @@ declare namespace LocalJSX {
*/ */
"event"?: any; "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; "focusTrap"?: boolean;
"hasController"?: boolean; "hasController"?: boolean;

View File

@ -270,8 +270,10 @@ export class Modal implements ComponentInterface, OverlayInterface {
* *
* Developers may want to consider disabling focus trapping if this * Developers may want to consider disabling focus trapping if this
* overlay presents a non-Ionic overlay from a 3rd party library. * overlay presents a non-Ionic overlay from a 3rd party library.
* This would allow developers to manually move and manage focus * Developers would disable focus trapping on the Ionic overlay
* within the 3rd party library's 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; @Prop() focusTrap = true;

View File

@ -256,8 +256,10 @@ export class Popover implements ComponentInterface, PopoverInterface {
* *
* Developers may want to consider disabling focus trapping if this * Developers may want to consider disabling focus trapping if this
* overlay presents a non-Ionic overlay from a 3rd party library. * overlay presents a non-Ionic overlay from a 3rd party library.
* This would allow developers to manually move and manage focus * Developers would disable focus trapping on the Ionic overlay
* within the 3rd party library's 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; @Prop() focusTrap = true;