-
Notifications
You must be signed in to change notification settings - Fork 51
[terra-clinical-item-view] Accessibility guide #916
Conversation
ac0d436
to
40e3758
Compare
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Show resolved
Hide resolved
Displays in the Item View are rendered as list items inside a primary unordered list. | ||
The structure is different for the different types of layouts - one column, two columns, and two columns by row. Their structure is as follows: | ||
|
||
**For a one column layout with 8 displays** |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I wonder if we can display these 3 lists as side by side for better comparison.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That looks good!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sweet, added here: 5e73fd5
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
11891a9
to
e5cfead
Compare
...ra-clinical-item-view/src/terra-dev-site/doc/clinical-item-view/AccessibilityGuide.4.doc.mdx
Outdated
Show resolved
Hide resolved
- For example - presenting related information across from each other in the two column view can make it more difficult for users to understand that the information is related. | ||
Reading by column from top to bottom is the more common way information is consumed visually, so when presenting this information by row between the two columns it might be confusing for assistive technology users and users in general. | ||
- When passing in Clinical Item Displays, keep in mind that only 8 can be used within a view at a time. Any additional displays passed in will be ignored. | ||
- Displays are also split between two columns with every other display being moved to the right hand column. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should this be more like "When displays are split into two columns, every other display is in the right hand column"? Also, again seems like something useful to know in the props
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Slightly reworded this and added the info to the layout prop since I think that's more relevant than putting it under the display prop. facd8ef
facd8ef
to
9d923a5
Compare
Summary
What was changed:
Added an accessibility guide for Clinical Item View
Why it was changed:
So users have a reference for accessibility guidelines and changes we've made to the component.
Testing
This change was tested using:
Reviews
In addition to engineering reviews, this PR needs:
Additional Details
This PR resolves:
UXPLATFORM-8569
Thank you for contributing to Terra.
@cerner/terra