GithubHelp home page GithubHelp logo

mannionaco / whocanuse Goto Github PK

View Code? Open in Web Editor NEW

This project forked from coreyginnivan/whocanuse

0.0 1.0 0.0 792 KB

WhoCanUse is a tool that brings attention and understanding to how color contrast can affect different people with visual impairments.

Home Page: https://whocanuse.com/

License: MIT License

JavaScript 86.46% CSS 13.54%

whocanuse's Introduction

WhoCanUse Logo

WhoCanUse.com

Netlify Status All Contributors

What is WhoCanUse?

It's a tool that brings attention and understanding to how color contrast can affect different people with visual impairments.

The Web Content Accessibility Guidelines (WCAG) covers a wide range of recommendations for making Web content more accessible. Just a tiny part of making the web more accessible is accommodating for those with a form of blindness or low vision.

The standard grading system is a great start, but I thought I'd try to humanize the people who are affected by the different grades.

What is WhoCanUse? Where did you get the info from?

The percentages are sourced from both colour-blindness.com and Vision Australia. P.S. You're both the best, thankyou โœŒ๏ธ

Your maths is off, it doesn't add up to 100%...?

Good eyes! (haha) The population data provided are estimates for individual impairments, and don't cover the vast amount of visual impairments in the world. This is to give you not just an understanding of how color contrast affects different people but also who it can affect.

I'm fascinated by how this works, can you tell me more?

Of course! There's a few stages to get to this point. First we figure out the contrast between two HEX values. For this we're using a plugin called Chrome.JS - this does the heavy lifting for us. Once we have the ratio (and using font size and font weight) we can apply a grade to that specific color combo.

For the color blindness options we're using another plugin aptly called Color-blind that converts our HEX codes in to ones that would be seen by people with the different impairments, then we can apply our same process to obtain the color ratios and determine their grade.

For cataracts, glaucoma, low vision, and the situational events I've personally created simulations to help identify their rating.

What does a failing grade mean?

The grading uses a combination of color contrast, text size and text weight. A fail simply means that the color combination offers some visual strain to the person seeing it and should be avoided if possible.

Can I help contribute?

Absolutely! Feel free to fork the repo and submit a PR with any helpful additions or changes.

๐Ÿš€ Getting Started

  1. Clone the repo.

  2. Install everything.

    Navigate to wherever you cloned the whocanuse repo to and install all the things:

    npm install
  3. Start developing.

    Start it up!

    gatsby develop
  4. Open the source code and start editing!

    Your site is now running at http://localhost:8000!

    Note: You'll also see a second link: http://localhost:8000/___graphql. This is a tool you can use to experiment with querying your data. Learn more about using this tool in the Gatsby tutorial.

Contributors โœจ

Thanks goes to these wonderful people (emoji key):

Corey
Corey

๐ŸŽจ ๐Ÿ’ป
Jake Ginnivan
Jake Ginnivan

๐Ÿš‡ ๐Ÿ’ป
Mike
Mike

๐Ÿš‡ ๐Ÿ’ป
Tom Leenders
Tom Leenders

๐Ÿ’ป
Matthew Putland
Matthew Putland

๐Ÿค” โ™ฟ๏ธ
Julie Grundy
Julie Grundy

๐Ÿค” โ™ฟ๏ธ
Jess Budd
Jess Budd

๐Ÿ–‹ โ™ฟ๏ธ

This project follows the all-contributors specification. Contributions of any kind welcome!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.