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

[4.0] Turn the table view in media manager into a table #24598

Merged
merged 2 commits into from
Apr 29, 2019

Conversation

wilsonge
Copy link
Contributor

Turns the table view in media manager into a table thus starting work on a11y compatibility

@joomla-cms-bot joomla-cms-bot added NPM Resource Changed This Pull Request can't be tested by Patchtester PR-4.0-dev labels Apr 15, 2019
@ghost ghost added the a11y Accessibility label Apr 16, 2019
@infograf768
Copy link
Member

Looks like I can't select items anymore. Here banner_cradle.jpg
Before

Screen Shot 2019-04-16 at 07 11 01

After

Screen Shot 2019-04-16 at 07 14 59

@infograf768
Copy link
Member

Formerly, we had
Screen Shot 2019-04-16 at 07 26 58

With this patch we have
Screen Shot 2019-04-16 at 07 25 21

@bahl24
Copy link
Contributor

bahl24 commented Apr 16, 2019

Can we integrate #24423 in this PR?

@wilsonge
Copy link
Contributor Author

wilsonge commented Apr 16, 2019

@infograf768 fixed that. I'm deliberately leaving out the mouseleave, mouseover and focused events because they aren't required in the table view - they're related to tabbing through the other view

@ghost ghost changed the title [4.0] [a11y] Turn the table view in media manager into a table [4.0] Turn the table view in media manager into a table Apr 19, 2019
@wilsonge wilsonge force-pushed the feature/media-table-a11y branch 3 times, most recently from 7d2867c to 85a6d4f Compare April 20, 2019 12:44
@wilsonge wilsonge changed the title [4.0] Turn the table view in media manager into a table [4.0] [a11y] Turn the table view in media manager into a table Apr 21, 2019
@wilsonge wilsonge added the J4 Media Manager Enhanced Features label Apr 21, 2019
@ghost ghost changed the title [4.0] [a11y] Turn the table view in media manager into a table [4.0] Turn the table view in media manager into a table Apr 22, 2019
@wilsonge wilsonge force-pushed the feature/media-table-a11y branch 2 times, most recently from 8834d28 to a1127bc Compare April 23, 2019 10:55
@wilsonge
Copy link
Contributor Author

@brianteeman @zwiastunsw can you guys take a look at this and advise on what's next. Clearly all I'm doing here is converting the existing lists to a table which is going to help but not magically solve anything and I need pointers on what's required next here

@zwiastunsw
Copy link
Contributor

zwiastunsw commented Apr 25, 2019

@wilsonge : Is there a project, a concept for this view? Do you expect such a concept?

  1. Add caption to the table
  2. Add summary attribute
  3. Add scope="col" attribute to the th cels
  4. Change the cell tag with the file name from TD to TH and add the scope="row" attribute
  5. The file name should be a link to the file editing page
  6. The table should contain links to download the file, copy the file link, etc.

@wilsonge
Copy link
Contributor Author

@zwiastunsw
I've done 1, 3 and 4
I'm not doing 5 and 6 in this PR because that's not really a11y improvements it's adding features to the table view and that makes this rework much more complicated than it should be

Can you please clarify about the summary attribute. I have no clue what that is?

@wilsonge wilsonge force-pushed the feature/media-table-a11y branch from a1127bc to ea5f571 Compare April 27, 2019 17:45
@joomla-cms-bot joomla-cms-bot added the Language Change This is for Translators label Apr 27, 2019
@zwiastunsw
Copy link
Contributor

"The SUMMARY attribute is placed within the TABLE tag, and is read only by screen readers. It can be used to clarify the organization of a table, or to provide a quick summary of the table’s content. It shouldn’t repeat the information in the CAPTION tag, but can be used to supplement that information."

You do not need to edit the summary text. We will write it later, when the table is ready. Meanwhile, it could be, for example, "In the rows there are - media files and information about them..."

@wilsonge
Copy link
Contributor Author

I don't think we should be using that. According to https://www.w3.org/TR/WCAG20-TECHS/H73.html

Note: In HTML5 the summary attribute is obsolete. Assistive technologies may or may not continue to support the attribute. Authors should consider alternatives and only use with caution.

@zwiastunsw
Copy link
Contributor

This is a technique that can still be used. If it can improve accessibility, it is worth using it.

For me the most important problem is the functionality of this table. If it is to contain only information, its usability is rather low. It is also difficult to assess the accessibility when you do not know exactly what is to be accessible. That is why I asked earlier about the concept of this Media Manager view.

@brianteeman
Copy link
Contributor

The summary tag should not be used.

@zwiastunsw
Copy link
Contributor

zwiastunsw commented Apr 28, 2019

I do not insist, because the summary attribute has been withdrawn in HTML5.
Instead of the summary attribute, other solutions can be used. What kind of solutions?
Alternatives are described in the following section 4.9.1.1 HTML5:

  • in prose, surrounding the table (plus aria-describedby attribute in he table tag),
  • next to the table, in the same figure,
  • other techniques, or combinations of the above techniques, as appropriate.

It is best to arrange the table in such a way that the description is not needed. Unfortunately, so far we do not know what this table will contain. (Note that this table will probably be structured differently from the other tables in Backend).

@brianteeman
Copy link
Contributor

Those are for when you are presenting a table of static data such as a timetable

@zwiastunsw
Copy link
Contributor

This applies to the tables presenting the data (no static data etc.). It is more about complex and extended tables than about simple tables.
This is an academic discussion. I still do not know what is in this table. About file data? This file data is already in the next window. The most important data? I mean, which one?
I still don't know what this table is for. For a quick overview of many data? For quick access to operations on individual or multiple files?
This content is to be accessible, not packaging. If there is no answer to the question of what the content should be, then the discussion about accessibility is pointless. The formal requirements for table accessibility are simple (correct regular structure, caption, header cells, scope attribute and/or headers attribute),

@brianteeman
Copy link
Contributor

I don't understand why you don't know what this table is for

@zwiastunsw
Copy link
Contributor

zwiastunsw commented Apr 28, 2019

  1. The file name should be a link to the file editing page
  2. The table should contain links to download the file, copy the file link, etc.

I still don't know if these functions will be in the table or not. If they will be, where will they be? First you have to answer these questions.
In my opinion, the table is supposed to provide access to files first and foremost, and not only to information about files. Now this is the file information table.

PS It's possible that I'm not describing it clearly. But I can't do it any other way.

@wilsonge
Copy link
Contributor Author

wilsonge commented Apr 28, 2019

Right now they aren't. So for the purposes of this PR let's assume they won't be for now. If we go back and add them in then we'll need to adapt the a11y functionality at the time too

Basically for now it's a file information table

@wilsonge wilsonge merged commit 355d953 into joomla:4.0-dev Apr 29, 2019
@wilsonge
Copy link
Contributor Author

OK I think we've got a good start here - it's just whether we need to add more - which can be done in a future PR as required

@wilsonge wilsonge deleted the feature/media-table-a11y branch April 29, 2019 23:50
@infograf768
Copy link
Member

Some folder icons do not display:
Screen Shot 2019-05-01 at 08 07 57

@infograf768
Copy link
Member

The variable is wrong:
using
$sidebar-tree-folder-icon: "\f07b";
$icon-type-folder: "\f07b"; in variable.scss
gives

Screen Shot 2019-05-01 at 09 06 50

@wilsonge
Copy link
Contributor Author

wilsonge commented May 1, 2019

Fixed

@zero-24 zero-24 added this to the Joomla 4.0 milestone May 5, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
a11y Accessibility J4 Media Manager Enhanced Features Language Change This is for Translators NPM Resource Changed This Pull Request can't be tested by Patchtester
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants