w3c / wcag2ict

WCAG2ICT deliverable of Accessibility Guidelines WG
https://wcag2ict.netlify.app/
Other
20 stars 5 forks source link

Add "style property" definition #174

Closed maryjom closed 1 year ago

maryjom commented 1 year ago

Something we missed doing when adding SC 1.4.12 Text Spacing, and we need to bring into this the software platform aspect.

Here's the original WCAG definition:

style property

property whose value determines the presentation (e.g. font, color, size, location, padding, volume, synthesized speech prosody) of content elements as they are rendered (e.g. onscreen, via loudspeaker, via braille display) by user agents

Style properties can have several origins:

  • User agent default styles: The default style property values applied in the absence of any author or user styles. Some web content technologies specify a default rendering, others do not;
  • Author styles: Style property values that are set by the author as part of the content (e.g. in-line styles, author style sheets);
  • User styles: Style property values that are set by the user (e.g. via user agent interface settings, user style sheets)

Proposed addition to the WCAG2ICT definitions section

dfn-style-properties

Guidance When Applying "style property" to Non-Web Documents and Software

This applies directly as written and as described in the WCAG 2.2 glossary, replacing “user agent(s)” with “user agent(s) or platform software”, "web content" with "content", replacing "in-line styles, author style sheets" with "programmatically-set styles" replacing "user agent interface settings, user style sheets" with "user agent or other software settings".

property whose value determines the presentation (e.g. font, color, size, location, padding, volume, synthesized speech prosody) of content elements as they are rendered (e.g. onscreen, via loudspeaker, via braille display) by [user agents or platform software]

Style properties can have several origins:

  • [User agent or platform software] default styles: The default style property values applied in the absence of any author or user styles. Some [content] technologies specify a default rendering, others do not;
  • Author styles: Style property values that are set by the author as part of the content (e.g. programmatically-set styles);
  • User styles: Style property values that are set by the user (e.g. via [user agent or other software] interface settings)
loicmn commented 1 year ago

I think that the last word substitution can be improved. This is a copy of my reply to the survey, with added formatting.

The initial proposal is:

"user agent interface settings, user style sheets" with "user agent or other software settings".

But then we loose the term "platform software" that we have included before to substitute "user agent". My proposal is:

"user agent interface settings, user style sheets" with "user agent, platform software or other software settings".

The result would be (for the last bullet point of the definition):

"User styles: Style property values that are set by the user (e.g. via [user agent, platform software or other software] interface settings)"

maryjom commented 1 year ago

@loicmn I couldn't quite tell from the survey results whether @bruce-usab thought platform software should be included in the scope or not. The only thought I have on that is that this term is only used in 1.4.12 Text Spacing. We didn't scope in platform software in our interpretation, so it might be best if the definition and the SC both interpret using the same scope.

loicmn commented 1 year ago

I understand @maryjom , but you are proposing to replace “user agent(s)” with “user agent(s) or platform software” in every other place in the definition, except for the last bullet point.

This is the reason of my comment.

maryjom commented 1 year ago

I made a draft PR #192 to help us review changes/ see them in context of the document.

maryjom commented 1 year ago

This definition was approved by the TF on 13 July and was reviewed by the AG WG and approved in the 25 July meeting.