Jump to table of contents

Inclusive and Accessible Theming

When making design changes, it is important to be mindful of the diversity of your readership and inclusive of users’ needs and circumstances. In addition to visual impairments, users may be affected by hearing, cognitive, and motor limitations when browsing a website; others may have a different social or cultural background that may alter their understanding of content. These circumstances may be permanent, as with colour vision deficiencies (CVD), or temporary, as with browsing on a smaller screen with a slow internet connection.

In this guide we will focus on visual impairments specifically, but it is always valuable to maintain clear and concise editorial standards so that your articles reach and remain accessible to as many researchers or readers interested in your field as possible.

Accessibility of Themes #

As of OJS/OMP/OPS 3.3, the Default Theme has been externally audited for accessibility and adheres to best practices like colour contrast, keyboard navigation, and form/link focus. PKP Accessibility Statement contains further details. Note that changes made to the theme may impact accessibility.

Colour #

You can use WebAim’s Contrast Checker, Contrast Ratio Checker, or the Colour Contrast Analyser to check the contrast ratio between your website’s background and text colours and make sure it is accessible based on the WCAG 2.0 Guidelines.

Most OJS 3 themes allow you to customize the main or header colour of your website. With WebAim’s Contrast Checker, for example, you can check whether you should use black or white text, as well as header logo, with your main colour of choice in order to ensure readability for users with visual limitations. In the following example, the user is testing out a pink as well as a purple selected to match their homepage cover image.

The WebAim contrast checker showing pass and fail statuses for different text and background color combinations.

The test recommends that the user only display black text on pink or white text on purple. Therefore, the user has two accessible options using these colours:

An unacceptable color combination of white on light pink used in OJS, accompanied by a red X. An unacceptable color combination of black on dark violet used in OJS, accompanied by a red X. An acceptable color combination of black on light pink used in OJS, accompanied by a green checkmark. An acceptable color combination of white on dark violet used in OJS, accompanied by a green checkmark.

Additionally, with tools such as the Spectrum Chrome extension you can emulate various types of colour vision deficiencies (CVD) on any website. Tools like the Accessible Color Palette Builder can help you decide on the best colour combinations for your website.

Text colour should not be the only way of conveying important information, since it may not be available to a person with CVD and will be unavailable to screen reader users. Consider other visual emphasis (bold, italic) OR an explicit mention (in plain text) that the following information is important.

Alternative text for images #

You should provide ‘alt’ (alternative) text for images unless they are decorative or the text is present elsewhere on the page. Having such text is especially helpful for people with visual impairments who rely on a screen reader to have the content of the website read to them.

Alt text can be added in designated fields or in the HTML.

<img src="learning-ojs3.1-jm-settings-workflow-sublib1.png" alt="submission library textbox">

Make sure to use descriptive language (e.g., describing a photograph in detail: “a woman in a lab coat holding a petri dish in a bright laboratory”). Avoid using “image of…” at the start of your description.

Descriptive URLs #

When writing URL text, make sure it can be understood without additional context. For example, use “see Author Guidelines” rather than “click here.”

Page structure #

When writing web content, ensure that:

  • Proper heading levels (e.g., <h1>, <h6>) are used to separate content in longer text. Heading levels should not be skipped in the ordering (e.g. <h1> - <h2> - <h3>) so that a screen reader can navigate correctly through the page - for example, the following is invalid because a <h3> follows directly after a <h1>, without a <h2> between them:
<h1>Title</h1>
<h3>1 XXXX</h3>
<h2>2. XXXX</h2>
  • Headings of the same level should have the same tag, and heading levels can be repeated; for example:
<h1>Title</h1>
<h2>1. XXXX</h2>
<h2>2. XXXX</h2>
<h3>2.1 XXXX</h3>
<h3>2.2 XXXX</h3>
<h2>3. XXXX</h2>
  • There should only ever be one <h1> on a page. Usually, the theme provides the <h1> and you do not need to create this.
  • Enumerative lists are presented as lists (e.g., ordered or unordered, definition lists)
  • Tables have appropriate table headers (the <th> element).

Document accessibility #

Non-HTML content, such as documents you upload, should be accessible as well. When creating journal documentation, such as author guidelines, style guides, etc., consider presenting them as static HTML pages rather than uploading PDFs to the website. If using PDFs, ensure that they are appropriately tagged to be screen-reader friendly. PKP’s guide Creating Accessible Content: A Guide for Journal Editors and Authors contains further details and resources.

Checking your website for accessibility #

When modifying the theme of your journal website, ensure that it remains accessible by checking your journal on different browsers and on various devices.

Additional online tools such as Wave browser extension (free) or axe DevTools (free) can facilitate website auditing. Tabbing through your pages and using a screen reader such as ChromeVox (free), NVDA (free) or JAWS can help ensure that a person with a visual impairment can navigate your website.