# a11ize

![Demo of a11ize](rydemo.png)

A React-based accessibility toolkit to make any website accessible.
a11ize is fast, extensible, and most importantly, lightweight (21.55 kb gzipped without core-js).

Check out a live demo at [https://risingyouth.ca](https://risingyouth.ca).

a11ize is based on the Fluid [preferences framework](https://fluidproject.org/projects.html).

## Features

- Text Sizing
- Font Style
  - Bundles Open Dyslexic by default
- Line Spacing
- Word Spacing
- Custom high-contrast colour filters
- Enhanced Inputs
- Table of Contents
  - Dynamically generated from semantic HTML
- i18n Support (PRs welcomed!)

## Usage notes

- Ensure that text sizes are defined in `rem`s

### Installation

```
npm install @takingitglobal/a11ize
```

### React usage

Wrap the content you want to be modified by a11ize in the `AccessibilityButton`
tag.

```jsx
  import A11yWrapper from "@takingitglobal/a11ize"
  ...
  <A11yWrapper {...options}>
    Site content here.
  </A11yWrapper>
```

### Non-React usage

Add the id of `accessible-content` to an element so that it wraps the content you want a11ize to affect (generally the entire page).

```html
<div id="accessible-content">Site content here.</div>
<script>
  A11ySettings = {
    ...options,
  };
</script>
<script src="https://cdn.jsdelivr.net/npm/@takingitglobal/a11ize@1/dist/with-react/index.js"></script>
```

For wider browser compability, use the version with CoreJS bundled in.

```html
<div id="accessible-content">Site content here.</div>
<script>
  A11ySettings = {
    ...options,
  };
</script>
<script src="https://cdn.jsdelivr.net/npm/@takingitglobal/a11ize@1/dist/with-react-cjs/index.js"></script>
```

Cache times on jsdelivr are relatively long, so if you want the latest release replace the `@1` with the version you'd like to use.

### Options

All options are optional and default to the values below.

```js
{
  primaryColor: '#921d5b',
  secondaryColor: '#01364c',
  buttonColor: '#fff', // text colour of the a11y button
  activePanels: [ // enable/disable panels as needed
    'textsize',
    'fontfamily',
    'linespacing',
    'letterspacing',
    'wordspacing',
    'contrast',
    'clickables',
    'toc',
  ],
  lang: 'en', // fallback to 'en' if set ISO code is not found
  // for non-React usage
  wrapperId: 'accessible-content' // override the a11ize target element
}
```

## Contributing

### Translations & i18n

If you're able to translate the text in a11ize to another language, please make a PR with the new YAML file of translations.
Example YAML files are in `src/i18n/en.yml`. The translated text should match to the appropriate key, with the language code as the filename.

## Credits

a11ize is largely inspired by [OCAD University's Infusion framework](https://github.com/fluid-project/infusion), which is a part of the Fluid Project.
We aimed to create a lighter, and more widely usable a11y toolkit that could work for any website with minimal modifications.

### Font Usage

a11ize bundles the Open Dyslexic font face by default. Please make sure to
abide by their licensing rules if you choose to use Open Dyslexic in your own
projects.