Skip to content

Add a subtitle to assemblies and processes pages#8918

Merged
andreslucena merged 3 commits intodecidim:developfrom
mainio:fix/participatory-space-page-heading-order
Mar 2, 2022
Merged

Add a subtitle to assemblies and processes pages#8918
andreslucena merged 3 commits intodecidim:developfrom
mainio:fix/participatory-space-page-heading-order

Conversation

@ahukkanen
Copy link
Copy Markdown
Contributor

@ahukkanen ahukkanen commented Feb 25, 2022

🎩 What? Why?

After the heading level standardization, the heading order is now broken on the participatory space main page for processes and assemblies. The problem is with the "sections" on that main page, such as "related documents", "related images", etc.

I suggest that we add a subtitle to these pages as shown in the screenshots to fix this problem.

We could also change the heading order of the elements on the participatory space main page but the problem with that is that these same elements, such as "related documents" and "related images" are used also e.g. on the proposal pages where the current <h3> order is correct. Therefore, we would need to create extra logic in these templates to decide which is the correct heading order in which context which would add unnecessary logic in the templates.

I know that this is not a simple "fix" per se, as it adds a new element to these pages, but I'm not sure what would be the correct way to solve this issue otherwise as explained above.

📌 Related Issues

Testing

  • Go to the process or assembly main page
  • Check the accessibility tool

📋 Checklist

  • CONSIDER adding a unit test if your PR resolves an issue.
  • ✔️ DO check open PR's to avoid duplicates.
  • ✔️ DO keep pull requests small so they can be easily reviewed.
  • ✔️ DO build locally before pushing.
  • ✔️ DO make sure tests pass.
  • ✔️ DO make sure any new changes are documented in docs/.
  • ✔️ DO add and modify seeds if necessary.
  • ✔️ DO add CHANGELOG upgrade notes if required.
  • ✔️ DO add to GraphQL API if there are new public fields.
  • ✔️ DO add link to MetaDecidim if it's a new feature.
  • AVOID breaking the continuous integration build.
  • AVOID making significant changes to the overall architecture.

📷 Screenshots

Here is the error that is currently shown on the process page for instance:
Heading order error

I suggest that we add these subtitles to fix the problem with the heading order:

Assembly page H2

Process page H2

@ahukkanen ahukkanen mentioned this pull request Feb 25, 2022
12 tasks
@andreslucena andreslucena changed the title Add a H2 subtitle to the participatory space main page Add a subtitle to assemblies and processes pages Feb 25, 2022
@carolromero
Copy link
Copy Markdown
Member

Hi @ahukkanen, would it be possible to add to this subtitle some attribute like 'hidden' or 'display:none' so that it is recognized by a screen reader but not visible? I understand the semantic need, but it would be better to avoid more visual elements in the interface that also add very little value.

So my question is if there is something that does the opposite of this: https://a11y-101.com/development/aria-hidden

@ahukkanen
Copy link
Copy Markdown
Contributor Author

@carolromero Done.

Generally I don't like the hidden titles as it can be confusing where these headings are displayed if they need to be translated.

These accessibility violations are usually trying to tell you something. 😉

@andreslucena andreslucena merged commit 317e0f6 into decidim:develop Mar 2, 2022
entantoencuanto added a commit that referenced this pull request Mar 2, 2022
* develop: (57 commits)
  Add a subtitle to assemblies and processes pages (#8918)
  Add a subtitle to votings page (#8919)
  Fix profile notifications (#8943)
  Fix email for verification conflict with managed users (#8926)
  Move VAPID keys generators to core (#8923)
  Fix officialized user event missing translations (#8927)
  Fix verification report with multitenants: notify it only to admins of that organization (#8929)
  Fix processes creation form with stats, metrics and announcements (#8925)
  Fix flaky spec in meetings multi-date selectors (#8924)
  Local HTML validator for the CI (#8937)
  Fix translatable presence validator for hyphenated locales (#8795)
  Fix link to docs in initiatives admin (#8921)
  Fix initiatives signatures issues (#8448)
  Fix the meetings export to also include unpublished meetings (#8874)
  Fix heading order in the consultation question page (#8920)
  Fix diff mode selector roles and tabindexes (#8912)
  Fix budget hard dependency and caching flag issues in comments (#8899)
  Fix emoji picker hiding Foundation Abide form errors (#8886)
  Fix logical heading order for the endorsers list (#8892)
  Fix Foundation Abide errors for Rails remote (AJAX) forms (#8889)
  ...
@ahukkanen ahukkanen deleted the fix/participatory-space-page-heading-order branch March 2, 2022 12:34
ahukkanen added a commit to mainio/decidim that referenced this pull request Mar 2, 2022
@ahukkanen
Copy link
Copy Markdown
Contributor Author

Backport at #8950.

@alecslupu alecslupu added this to the 0.27.0 milestone Jul 14, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants