Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Discover screen-reader accessibility: #11598

Conversation

cjcenizal
Copy link
Contributor

Partially addresses #11520. Extracts some work from #11548.

  • Apply aria-label to field name icons.
  • Change title to alt for Discover 'Back to top' link.
  • Remove unnecessary title attributes from Discover No Results state.
  • Add aria-label to Discover sidebar's string field value.
  • Adjust aria-label of Discover Field Chooser 'Show field settings' button.

- Apply aria-label to field name icons.
- Change title to alt for Discover 'Back to top' link.
- Remove unnecessary title attributes from Discover No Results state.
- Add aria-label to Discover sidebar's string field value.
- Adjust aria-label of Discover Field Chooser 'Show field settings' button.
ng-class="{ 'kuiButton--basic': !filter.active, 'kuiButton--primary': filter.active, 'hidden-xs': !showFields, 'hidden-sm': !showFields }"
class="kuiButton kuiButton--small pull-right discover-field-filter-toggle"
ng-click="showFilter = !showFilter"
aria-label="Field Settings"
aria-label="Show field settings"
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should use verbs to communicate to the screen reader what clicking this button will do.

ng-click="onAddFilter(field, bucket.value, '-')" data-test-subj="minus-{{::field.name}}-{{::bucket.display}}"></i>
<i aria-hidden="true" class="fa fa-search-plus pull-right discover-field-details-filter"
ng-click="onAddFilter(field, bucket.value, '+')" data-test-subj="plus-{{::field.name}}-{{::bucket.display}}"></i>
<span aria-hidden="true" class="fa fa-search-minus pull-right discover-field-details-filter"
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not an accessibility thing, but we should never use <i> tags.

css-truncate
css-truncate-expandable="true"
class="discover-field-details-value"
aria-label="Value: {{:: bucket.display === '' ? 'Empty string' : bucket.display }}"
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No changes here, just formatting.

</center>
These are the first {{opts.sampleSize}} documents matching
your search, refine your search to see others.
<a ng-click="toTop()">Back to top.</a>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not accessibility related, just removed the <center> tag and changed the CSS to center this instead.

ng-if="failures.length === failuresShown && failures.length > 5"
>
Show Less
</a>
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed unnecessary title attributes here.

@cjcenizal cjcenizal added Team:Platform-Design Team Label for Kibana Design Team. Support the Analyze group of plugins. :Discovery v5.5.0 v6.0.0 labels May 4, 2017
@cjcenizal cjcenizal requested review from lukasolson and Bargs May 4, 2017 17:39
@cjcenizal
Copy link
Contributor Author

jenkins, test this

Copy link
Member

@lukasolson lukasolson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!


const typeIcon = function (fieldType) {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

😍

@Bargs
Copy link
Contributor

Bargs commented May 9, 2017

I'm definitely not an accessibility expert so I can't judge how well this adheres to best practices, but I did use OSX VoiceOver to confirm that all of the updated elements in this PR are accessible via screen reader. LGTM.

@cjcenizal cjcenizal merged commit fe6db3b into elastic:master May 9, 2017
@cjcenizal cjcenizal deleted the 11520/improvement/discover-screen-reader-accessibility branch May 9, 2017 18:20
cjcenizal added a commit to cjcenizal/kibana that referenced this pull request May 9, 2017
- Apply aria-label to field name icons.
- Change title to alt for Discover 'Back to top' link.
- Remove unnecessary title attributes from Discover No Results state.
- Add aria-label to Discover sidebar's string field value.
- Adjust aria-label of Discover Field Chooser 'Show field settings' button.
cjcenizal added a commit that referenced this pull request May 9, 2017
- Apply aria-label to field name icons.
- Change title to alt for Discover 'Back to top' link.
- Remove unnecessary title attributes from Discover No Results state.
- Add aria-label to Discover sidebar's string field value.
- Adjust aria-label of Discover Field Chooser 'Show field settings' button.
snide pushed a commit to snide/kibana that referenced this pull request May 30, 2017
- Apply aria-label to field name icons.
- Change title to alt for Discover 'Back to top' link.
- Remove unnecessary title attributes from Discover No Results state.
- Add aria-label to Discover sidebar's string field value.
- Adjust aria-label of Discover Field Chooser 'Show field settings' button.
snide pushed a commit to snide/kibana that referenced this pull request Jun 2, 2017
- Apply aria-label to field name icons.
- Change title to alt for Discover 'Back to top' link.
- Remove unnecessary title attributes from Discover No Results state.
- Add aria-label to Discover sidebar's string field value.
- Adjust aria-label of Discover Field Chooser 'Show field settings' button.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Project:Accessibility release_note:enhancement Team:Platform-Design Team Label for Kibana Design Team. Support the Analyze group of plugins. v5.5.0 v6.0.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants