Skip to content

Commit eb21ac1

Browse files
committed
fixed links
1 parent 57889d9 commit eb21ac1

File tree

1 file changed

+11
-16
lines changed

1 file changed

+11
-16
lines changed

powerapps-docs/maker/canvas-apps/accessible-apps.md

Lines changed: 11 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -25,17 +25,16 @@ An accessible app will allow users with vision, hearing and other impairments to
2525
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.
2626
- Ensure all elements are clearly visible and text is of sufficient size. All content must be easily read and understood by the naked eye.
2727
- 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.
2929
- If customizing colors, ensure the contrast of text:background is 4.5:1 or greater. Software tools that assist this process are readily available.
3030
- Ensure layout follows a logical flow when read top-bottom, left to right.
3131

3232

3333
### Keyboard support
3434
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.
3535

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.
3938
- Avoid setting tab index higher than zero.
4039

4140
### Screen reader support
@@ -48,25 +47,21 @@ The following software combinations are the supported recommendations for consum
4847

4948
To ensure a satisfying experience with the screen reader it is recommended to:
5049

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.
5554

5655

5756
### 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.
6058

6159
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.
6260

6361
### 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+
6564

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.
7065

7166
Related:
72-
**[Accessibility properties](properties-accessibility.md)**
67+
**[Accessibility properties](controls/properties-accessibility.md)**

0 commit comments

Comments
 (0)