GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Docs
  • Accessibility

This view

  • Original page
  • New address

GeezerVison is showing makecode.com — Accessibility

Skip to main content
About MakeCode Blog Online Learning Contact Us Tools
Technical Docs
JS Editor Features Programming Language Async Functions Partial Flashing Source Embedding Updating Blockly Version Accessibility Profiling Debugging Hardware
Creating Targets
pxtarget.json Defining Blocks Auto-generation of .d.ts Static File Drops Simulator Theming Editor Embedding resources
Creating Extensions
Getting started pxt.json Extension versioning Extension localization Extension approval Editor extensions GitHub Extension Authoring
Writing Docs
Macros Anchors Tutorials User Tutorials Skillmaps Routing Licensing Testing
Translations
Translation languages Localization files Parts to translate Translating markdown Translator roles In context translation
Blocks Embedding
Command Line Interface
install build bump deploy console gdb staticpkg update pyconv hidserial hiddmesg login
Labs UF2 File Format Accessibility Telemetry

Accessibility

Accessibility features are included as a core part of Microsoft MakeCode. Any MakeCode target can extend accessibility to itself by following the recommendations provided in this guide.

Being responsible

We can ensure that MakeCode achieves it's accessibility goals only if every contributor is responsible to ensure the accessibility of their own features or changes. The guidance given here will help you know what is important and what to keep in mind while designing and developing for MakeCode.

Accessible Rich Internet Applications (WAI-ARIA) 1.1

WAI-ARIA is the specification that describes the standard support for accessibility in web apps. It defines a set of best practices and available markup extensions (mostly as attributes for HTML5 elements) which are used to make web pages accessible with keyboards and screen readers.

The WAI-ARIA specification provides a standards and guidance for keyboard navigation that combines the use of HTML and JavaScript. Most of the ARIA markup extensions for HTML5 elements define how a screen reader must react when the user is focused on the element.

For example, often a DIV element is clickable and visually looks like a button or menu. The ARIA markup extension provides additional information to the user such as the role of the DIV (is it a button, a menu item, a header?), the description, and how to interact with it.

What to consider when editing MakeCode

  • Many of the SUI (available in sui.tsx) elements are already accessible, such as the buttons, code cards, modals. But for some other elements, like hyperlinks, which do not have a SUI implementation, you will have to make them accessible yourself.
  • You might want to include new libraries in PXT, or one of the targets, to quickly add a new feature (like charts, a grid, etc.). You are now required to include accessibility as design consideration when including or developing libraries. If a library you wish to use is not accessible, find an alternative one or consider adding the required accessibility features to it.
  • As a general rule, you can expect an additional 5% to 15% of development time for adding the necessary accessibility features to a library you create or modify for your use.

The following topics discuss accessible development for MakeCode:

  • Keyboard related issues
  • Assistive technologies
  • High contrast

Testing the accessibility features

When you do your changes on the accessibility, be sure to do the right tests. How to test the accessibility features and what to test

Edit this page on GitHub
Edit template of this page on GitHub

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.