You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: powerapps-docs/maker/canvas-apps/accessible-apps.md
+11-16Lines changed: 11 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -25,17 +25,16 @@ An accessible app will allow users with vision, hearing and other impairments to
25
25
Common sense and uncomplicated design helps apps be more accessible to all users. When doing heavy customization of apps take note of the below suggestions. PowerApps themes are by default accessible.
26
26
- Ensure all elements are clearly visible and text is of sufficient size. All content must be easily read and understood by the naked eye.
27
27
- Avoid using the visibility property of items to bring an element into view. If you need to show something conditionally, create the content in a new screen and navigate to it and back.
28
-
- Ensure input elements are labeled on the screen. **[AccessibilityLabel](properties-accessibility.md)** property defines what the screen reader will announce.
28
+
- Ensure input elements are labeled on the screen. **[AccessibilityLabel](controls/properties-accessibility.md)** property defines what the screen reader will announce.
29
29
- If customizing colors, ensure the contrast of text:background is 4.5:1 or greater. Software tools that assist this process are readily available.
30
30
- Ensure layout follows a logical flow when read top-bottom, left to right.
31
31
32
32
33
33
### Keyboard support
34
34
When testing your app's accessibility, ensure the app can be used with the keyboard only, the accessibility modes on iOS and Android, as well as navigated successfully with the screen reader enabled.
35
35
36
-
For keyboard navigation (with or without the screen reader) test for the following:
37
-
- Ensure that a logical order is followed when using the TAB key to navigate to input fields by setting each control's **[TabIndex](properties-accessibility.md)** property.
38
-
- Label, Image, Icon, Shape - if they are interactive elementes (i.e.buttons) set TabIndex to 0; if they are decorative elements or text, set TabIndex to -1.
36
+
For keyboard navigation (with or without the screen reader) ensure that a logical order is followed when using the TAB key to navigate to input fields by setting each control's **[TabIndex](controls/properties-accessibility.md)** property:
37
+
- Label, Image, Icon, Shape contols - if they represent interactive elements (i.e.buttons) set TabIndex to 0; if they are decorative elements or text, set TabIndex to -1.
39
38
- Avoid setting tab index higher than zero.
40
39
41
40
### Screen reader support
@@ -48,25 +47,21 @@ The following software combinations are the supported recommendations for consum
48
47
49
48
To ensure a satisfying experience with the screen reader it is recommended to:
50
49
51
-
- Ensure all input controls have the **[AccessibilityLabel](properties-accessibility.md)** property set.
52
-
- For images set **[AccessibilityLabel](properties-accessibility.md)** to an appropriate description.
53
-
- If a picture is not used as a button or a link (i.e. icon is there just for the decoration) and should not be read by the screen reader, make sure the **[AccessibilityLabel](properties-accessibility.md)** is empty or not set.
54
-
- If a picture or an icon is used as a button, then set **[TabIndex](properties-accessibility.md)** to 0 and **[AccessibilityLabel](properties-accessibility.md)** to the link description.
50
+
- Ensure all input controls have the **[AccessibilityLabel](controls/properties-accessibility.md)** property set.
51
+
- For images set **[AccessibilityLabel](controls/properties-accessibility.md)** to an appropriate description.
52
+
- If a picture is not used as a button or a link (i.e. icon is there just for the decoration) and should not be read by the screen reader, make sure the **[AccessibilityLabel](controls/properties-accessibility.md)** is empty or not set.
53
+
- If a picture or an icon is used as a button, then set **[TabIndex](controls/properties-accessibility.md)** to 0 and **[AccessibilityLabel](controls/properties-accessibility.md)** to the link description.
55
54
56
55
57
56
### Multimedia
58
-
Ensure all videos are captioned and that a transcript of all audio recordings is available to the user.
59
-
-**Video** control suppports closed caption in WebVTT format via the **ClosedCaptionsUrl** property.
57
+
Ensure all videos are captioned and a transcript of all audio recordings is available to the user. **Video** control suppports closed captions in WebVTT format via the **ClosedCaptionsUrl** property.
60
58
61
59
Note that with the screen reader enabled, **Timer** does not announce button text, but how much time has passed. Announcements can't be turned off, even if timer is hidden with low opacity.
62
60
63
61
### Working with signatures
64
-
If you have a signature field that uses the PenInput control you need to enable an alternative method of signature input. The recommended way is to show a TextInput control where a user can type their name. Ensure the signing instructions are placed in the **[AccessibilityLabel](properties-accessibility.md)** property and the control is placed close to the Pen input - to the right of it or immediately below.
62
+
If you have a signature field that uses the PenInput control you need to enable an alternative method of signature input. The recommended way is to show a TextInput control where a user can type their name. Ensure the signing instructions are placed in the **[AccessibilityLabel](controls/properties-accessibility.md)** property and the control is placed close to the Pen input - to the right or immediately below.
63
+
65
64
66
-
### Limitations
67
-
- Cannot assign custom roles to controls.
68
-
- Cannot have dynamic notifications to screen readers
69
-
- No good way to group controls. Data cards or Gallery is a workaround.
0 commit comments