Brickfield Education Labs

Table of Contents

Introduction

The Fix empty headings wizard provides you with “header tag” errors for the course, or courses and removes the empty headers tag to help fix them quickly.

 

Both sighted and screen reader users depend on headings to organise and navigate the content on the page. Headings should not be empty and should represent an accurate outline of their relevant content.

 

N.B.: In the top right of the Fix empty headings wizard is a “Help docs” button that will bring your directly to this documentation page.

Impact of having empty headings

Headings with no text can hinder users of screenreaders.

Where to find the Fix empty headings wizard

The Fix empty headings wizard can be accessed via:

  • From Site administration: Site administration > Brickfield Enable > Accessibility management > Go to wizards > Fix > Empty headings
  • From a course: Course actions menu > More > Brickfield Accessibility+ Toolkit > Fix > Empty headings
  • From the course block: Accessibility+ Review block > View Accessibility+ Report (Chart icon) > Fix > Empty headings
  • From the Check list report: The “Fix” link that’s available for the “A header needs to contain text to be perceivable” check.

How to use the Fix empty headings wizard

The Fix empty headings wizard displays a page which includes a table where each row is one of the headings found that has no text.

 

The Fix empty headings wizard provides the ability to:

  • Submit header tag updates in bulk.
  • Make an exception by hiding an individual error.
The fix empty headings wizard displaying the page heading, number of reviewed courses, help docs button, number of errors, and the empty heading errors table. The empty headings errors table has 4 columns: details, existing, update to, and hide.

The heading area of the wizard will show how many errors are found, and whether the errors listed are for one course or many courses.

  • If the results are for one course, the course name is displayed.
  • If the results are for more than one course, the number of courses is displayed.

 

The table displays a row for each error that contains four parts:

  • Details
    • Course Name.
    • Course Section.
    • Activity name.
    • The link to Edit the content.
  • Existing context
    • Existing content.
    • The button to view the error in its full context.
  • Update to – The heading will be removed.
  • Hide – The checkbox to hide the error when submitted.

Where to find the Fix empty headings wizard

When updates to the errors are submitted for bulk fixing, it will only process the errors on the current page. All fixed errors are temporarily logged and can be reverted if needed in the Bulk fix log. 

 

To submit updates to the errors for bulk fixing:

  1. Ensure you are viewing the Fix empty header tags wizard.
  2. If you want to hide this error, select the “Hide” checkbox.
  3. Select the “Submit Bulk fixing” button to submit all the updates at once.

 

All hidden errors are located in the Hidden errors page.

Capability requirements

Access to the Brickfield Accessibility+ Toolkit is controlled by capabilities and users must have the correct capabilities in the correct context.

  • ‘tool/bfplus:viewsystemtools’ capability – To view site level reports and wizards.
  • ‘tool/bfplus:viewcoursetools’ capability – To view individual course reports and wizards.
  • ‘accessibilityplustool/fixemptyheaders:view’ capability – To view this Fix empty headings wizard, users must have this and one of the capabilities mentioned above.

 

For more information, go to: Capabilities.