Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add "style property" definition #174

Closed
maryjom opened this issue Jun 26, 2023 · 5 comments
Closed

Add "style property" definition #174

maryjom opened this issue Jun 26, 2023 · 5 comments

Comments

@maryjom
Copy link
Contributor

maryjom commented Jun 26, 2023

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)
@maryjom maryjom added this to the Add WCAG 2.1 SC milestone Jun 26, 2023
@maryjom maryjom self-assigned this Jun 26, 2023
@loicmn
Copy link

loicmn commented Jul 5, 2023

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
Copy link
Contributor Author

maryjom commented Jul 6, 2023

@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
Copy link

loicmn commented Jul 7, 2023

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
Copy link
Contributor Author

maryjom commented Jul 10, 2023

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

@maryjom
Copy link
Contributor Author

maryjom commented Aug 22, 2023

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

@maryjom maryjom closed this as completed Aug 22, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Development

No branches or pull requests

2 participants