Skip to content
  • Unlock Pro
  • Log in with GitHub
Solution
Submitted over 2 years ago

Single-page Developer Portfolio using HTML, CSS and JavaScript

accessibility
Israel Del Angel•160
@mexwebdev21
A solution to the Single-page developer portfolio challenge
View live sitePreview (opens in new tab)View codeCode (opens in new tab)

Solution retrospective


I've made some changes to improve accessibility, and to fix the issue with links, as well as, the invalidity of divs inside picture elements. There are more fixes to come. Any feedback would be highly appreciated! Thank you!

Code
Loading...

Please log in to post a comment

Log in with GitHub

Community feedback

  • Grace•32,130
    @grace-snow
    Posted over 2 years ago

    Hi

    You have some high severity accessibility issues on here that need fixing. The report covers some but I'll try to give more info in the feedback

    • social links all need accessible names. The inline svgs inside also need to be aria-hidden. You'll almost always want to do this for inline svgs as they are difficult to consistently label for all different assistive technologies
    • social links usually take people away from your site. So it's not necessary but a common convention to make them open in a new tab. If you add this functionality, make sure you add a title attribute to the links to say "(opens in a new tab)" so it's clear what's going to happen.
    • The logo link also needs an accessible name that says where the link goes. Eg "Adam Keyes - Home"
    • Just as styles should always be done mobile first, the picture element should be mobile first. The mobile image should be the default and the other image sources targeted in reverse order with min-width media query
    • not sure why there is an   in the middle of the h1. Content is usually entered separately by an ediyor and highly unusual to include non breaking spaces like that
    • the underline indicates a link everywhere else in the design, so I'd expect the underlined text in the h1 to also be a link
    • This is a full website so you need to hook up all the internal links properly. There is no reason to be using # except for the project links
    • the experience section should ideally be labelled with a visually hidden h2, then each experience item underneath would need to change to a h3
    • projects should be a h2
    • it's invalid html to have a div with links inside the picture element.
    • the languages should be list items inside an unordered list
    • if you're going to have custom validation on a form, you need to wrap each error message in an additional element that has a unique ID and aria-live attribute. Then each input should be aria-desciribedby that ID. These errors should then not be read out to screenreaders by default, but the tools know to "watch" those regions for changes and would automatically read out the error message when it appears and programmatically link the error message to its input on focus
    • write proper error messages
    • if writing custom validation you should add the no validate attribute on the form
    • use autocomplete attributes on name and email fields
    • same feedback for footer as in the header re links and labelling etc

    Style wise I've only looked on mobile. Looks OK but I think the links should wrap onto a new line when needed and add some more space between each project on mobile. Test down to 320px wide and you should see what I mean - it all just gets a bit cramped

Join our Discord community

Join thousands of Frontend Mentor community members taking the challenges, sharing resources, helping each other, and chatting about all things front-end!

Join our Discord

Stay up to datewith new challenges, featured solutions, selected articles, and our latest news

Frontend Mentor

  • Unlock Pro
  • Contact us
  • FAQs
  • Become a partner

Explore

  • Learning paths
  • Challenges
  • Solutions
  • Articles

Community

  • Discord
  • Guidelines

For companies

  • Hire developers
  • Train developers
© Frontend Mentor 2019 - 2025
  • Terms
  • Cookie Policy
  • Privacy Policy
  • License

Oops! 😬

You need to be logged in before you can do that.

Log in with GitHub

Oops! 😬

You need to be logged in before you can do that.

Log in with GitHub

How does the accessibility report work?

When a solution is submitted, we use axe-core to run an automated audit of your code.

This picks out common accessibility issues like not using semantic HTML and not having proper heading hierarchies, among others.

This automated audit is fairly surface level, so we encourage to you review the project and code in more detail with accessibility best practices in mind.

How does the CSS report work?

When a solution is submitted, we use stylelint to run an automated check on the CSS code.

We've added some of our own linting rules based on recommended best practices. These rules are prefixed with frontend-mentor/ which you'll see at the top of each issue in the report.

The report will audit all CSS, SCSS and Less files in your repository.

How does the HTML validation report work?

When a solution is submitted, we use html-validate to run an automated check on the HTML code.

The report picks out common HTML issues such as not using headings within section elements and incorrect nesting of elements, among others.

Note that the report can pick up “invalid” attributes, which some frameworks automatically add to the HTML. These attributes are crucial for how the frameworks function, although they’re technically not valid HTML. As such, some projects can show up with many HTML validation errors, which are benign and are a necessary part of the framework.

How does the JavaScript validation report work?

When a solution is submitted, we use eslint to run an automated check on the JavaScript code.

The report picks out common JavaScript issues such as not using semicolons and using var instead of let or const, among others.

The report will audit all JS and JSX files in your repository. We currently do not support Typescript or other frontend frameworks.

Frontend Mentor for Teams

Frontend Mentor for Teams helps companies and schools onboard and train developers through project-based learning. Our industry-standard projects give developers hands-on experience tackling real coding problems, helping them master their craft.

If you work in a company or are a student in a coding school, feel free to share Frontend Mentor for Teams with your manager or instructor, as they may use it to help with your coding education.

Learn more

Oops! 😬

You need to be logged in before you can do that.

Log in with GitHub