estimtest-core
v1.1.1
Published
Manually experiment most websites under a variety of conditions. Easily correct accessibility issues by simulating common disorders.
Downloads
372
Maintainers
kylesmith0905Readme
Estimtest Core
Estimtest is an experimentation tool that simulates accessibility concerns. Accessibility is crucial, but unexpectedly, difficult to test.
Usage
Feel free to checkout the examples, or open an issue for support.
- Apply the component as a sibling or child of a container. For example, as a child of
<body></body>. - The
estimtest-coreelement should cover up the entire screen in absolute position.
Load the component by importing it
<script type="module">
import { defineCustomElements } from 'https://cdn.jsdelivr.net/npm/estimtest-core/loader/index.es2017.js';
defineCustomElements();
</script>Add the component
<estimtest-core
active='true'
move-selector='body'
experiments='[{"name": "Hello World", "description": "hello", "fontSize": 32}]'
></estimtest-core>Configuration
Use HTML attributes to modify props.
active boolean - Whether to activate the Estimtest prompt. Having this as false still imports the library but does not use it. Look at the examples for sloppy implementations of fully removing Estimtest in production.
experiments {
name: string,
description: string,
fontSize?: number,
colorBlind?: ColorBlind,
keyboardOnly?: boolean
}[] - The experiments to be performed on the app. This is set by default to perform multiple standard tests of common accessibility problems. This field accepts an array of objects each with the properties:
nameA quick ~15 letters title summarizing the test.descriptionA description explaining the test and why it's important. Supports Markdown (Commonmark-compliant).fontSizeThe font size to set the page. Many users have difficulty reading text at the default font size, users fix this by increasing the default font size.colorBlindA change of colors on the page reflecting what colorblind users may see.keyboardOnlyMany users may use keyboard navigation for a variety of reasons such as: Motor impairment, saving time, and more.
moveSelector string - An element selector containing the parent of where the element should be at. You could use this property in the event that your code does not permit you to place the element there.