PHPOffice / PHPPresentation / 32171395548

93%

push

github

Expose an alternative text on every shape (#898)

* feat: expose an alternative text on every shape

Only drawings (and, through them, charts and tables) carried a description, and
it was written by the PowerPoint2007 writer alone. Text boxes, auto shapes,
groups and lines had no way to tell assistive technologies what they are, so a
presentation built from them cannot satisfy WCAG 1.1.1 — and nothing at all was
exported to ODPresentation.

Move `description` up from `Shape\AbstractGraphic` to `AbstractShape`, write it
as the `descr` attribute of `p:cNvPr` for every shape kind in PowerPoint2007 and
as the `svg:desc` child element in ODPresentation, and read it back in both
readers. `svg:desc` is placed where each ODF shape element expects it: first in
`draw:line` and `draw:g`, last in `draw:frame`.

* docs: changelog entry for the shape description

* test: the readers give the description back

Both readers learned to read the description in this branch, but nothing
held them to it. A save and load of every shape kind they load asserts
the alternative text survives the round trip, including the fall back to
the shape name for documents written before `svg:desc` was written.

* style: the import order php-cs-fixer asks for

25 of 25 new or added lines in 5 files covered. (100.0%)

10074 of 10940 relevant lines covered (92.08%)

43.85 hits per line