https://github.com/aldavigdis/superheading-block
Add accessible headings for the WordPress Block Editor with superheadings and subheadings.
https://github.com/aldavigdis/superheading-block
wordpress wordpress-plugin
Last synced: about 1 month ago
JSON representation
Add accessible headings for the WordPress Block Editor with superheadings and subheadings.
- Host: GitHub
- URL: https://github.com/aldavigdis/superheading-block
- Owner: aldavigdis
- Created: 2025-07-31T21:29:05.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-31T23:28:57.000Z (11 months ago)
- Last Synced: 2025-08-01T00:06:25.788Z (11 months ago)
- Topics: wordpress, wordpress-plugin
- Language: JavaScript
- Homepage:
- Size: 340 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Alda's Superheading Block
Add accessible headings for the WordPress Block Editor with superheadings and subheadings.
If you want to get things right, headings can get tricky when you have both subheadings and an overheading above the main heading.
Current web standards recommend the use of the `` element but this block demonstrates the use of plain-and-simple heading elements, maintains the heading hierarchy and ensures accessibility, while also facilitating typographical hierarchy.
In a [2025 blog post](https://aldavigdis.dev/2025/07/25/taming-html-headings-subheadings-and-overlines/), I argued that the `` element was redundant and that the same could be achieved in a semantic and accessible manner using a single heading element with `` elements nested inside without breaking the heading hierarchy. This demonstrates that way of doing things.
## Downloads
Zip-builds are provided under [Releases](https://github.com/aldavigdis/superheading-block/releases).
## Building and Developing
### Installing dependencies
1. Using PHP Composer, run `composer install`
2. Then install the NPM dependencies using `npm install`
### Developing
1. Using `docker-compose up -d`, you can build a Dockpress development environment that serves a test site at [localhost:80](http://localhost/).
2. Using NPM, run `npm start` to automatically build the plugin
### Packaging
1. Using PHP Compose, run `composer zip:release` to build your zip file after installing the dependencies
## License
This plugin is provided to you as free software under the GPLv3 license. Some runtime dependencies may be provided under the MIT and Apache licenses, which are compatible with the GPLv3.
Alda's Superheading Block
Copyright (C) 2025 Alda Vigdís Skarphéðinsdóttir
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see .