Accessibility services reference

Reference for the MathType accessibility services used to convert between MathML and accessible textual representations.

Summary

The accessibility services convert mathematical expressions between Presentation MathML and accessible text. These services are intended for applications that need to generate textual descriptions of mathematical expressions for assistive technologies or reconstruct MathML from accessible text.

Supported services

Available interfaces

Accessibility services are available through the following interfaces.

HTTP endpoints

The endpoint URL depends on your deployment. The endpoint path corresponds to the service name. For example:

Both GET and POST requests are supported. POST is recommended for large MathML expressions.

Request parameters

The accessibility services accept the following request parameters.

* The required parameter depends on the selected service:

Example request

Convert Presentation MathML into accessible text:

GET /mathml2accessible?mml=<math><mn>1</mn><mo>+</mo><mn>2</mn></math>

Service behaviour

mathml2accessible

Generates an accessible textual representation of a mathematical expression from Presentation MathML. The generated text can be used by screen readers or other assistive technologies.

accessible2mathml

Converts a supported accessible textual representation back into Presentation MathML. The resulting MathML can be rendered or edited using MathType.

Error handling

Conversion may fail if:

• The supplied MathML is malformed.
• The accessible text cannot be interpreted.
• The requested language is not supported.

When httpstatus=true is specified, the service returns an appropriate HTTP 5xx status code instead of embedding the error in a successful (200 OK) response.

Notes

• Accessible text is intended for assistive technologies and may vary depending on the selected language.
• The generated text represents the mathematical meaning of the expression rather than its visual appearance.
• These services complement the accessibility features provided by WIRISplugins.js and rendered formulas.

Java and .NET APIs

The services described in this article are also available through the Java and .NET APIs. For complete method signatures, return types, and implementation details, see:

• Java API reference.
• .NET API reference.

Related articles

• MathType API services.
• Available languages for MathType Web.
• WIRISplugins.js parameters.
• Full MathML mode.