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

Adjust ratio for opacity #222

Merged
merged 23 commits into from
Feb 11, 2025
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions src/lib/components/ratio/ColorIssues.svelte
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,24 @@
adjust the color to be in gamut.
</p>
</dd>
<dt>Background Color Alpha Values</dt>
<dd>
<p>
WCAG 2 contrast does not consider alpha values. Because we don't know
what is behind your background color, we can't estimate the contrast. If
the background color is not opaque, the contrast ratio is computed
without background or foreground opacity.
</p>
</dd>
<dt>Foreground Color Alpha Values</dt>
<dd>
<p>
WCAG 2 contrast does not consider alpha values, but we can approximate a
ratio by premultiplying a semi-transparent foreground color in the sRGB
space. In practice, the displayed foreground color may vary depending on
the display and browser.
</p>
</dd>
</dl>
</details>

Expand Down
67 changes: 57 additions & 10 deletions src/lib/components/ratio/index.svelte
Original file line number Diff line number Diff line change
@@ -1,15 +1,30 @@
<script lang="ts">
import { contrast } from 'colorjs.io/fn';
import { contrast, mix } from 'colorjs.io/fn';

import ColorIssues from '$lib/components/ratio/ColorIssues.svelte';
import Result from '$lib/components/ratio/Result.svelte';
import ExternalLink from '$lib/components/util/ExternalLink.svelte';
import Icon from '$lib/components/util/Icon.svelte';
import { RATIOS } from '$lib/constants';
import { bg, fg } from '$lib/stores';

let ratio = $derived(contrast($bg, $fg, 'WCAG21'));
let fgPremultiplied = $derived.by(() => {
if ($fg.alpha === 1 || $bg.alpha !== 1) return $fg;
return mix($bg, $fg, $fg.alpha, {
space: 'srgb',
premultiplied: false,
});
});
let ratio = $derived(contrast($bg, fgPremultiplied, 'WCAG21'));
let displayRatio = $derived(Math.round((ratio + Number.EPSILON) * 100) / 100);
let pass = $derived(ratio >= RATIOS.AA.Normal);
let alphaWarning = $derived.by(() => {
if ($bg.alpha !== 1)
return 'Alpha is not considered when the background is not opaque.';
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we link these two notes directly to the fuller description (expanding if necessary)?

If not that, we could consider adding the fuller explanation in a tooltip/dialog here instead of in the expandable "issues" section.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think linking will be much easier once we're done with #223. I'm fine with moving it to a tooltip/dialog, but note we'd need to develop that pattern. I'll defer to @SondraE on what we should do.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, would it make more sense for me to focus on cleaning up #223 in the meantime @jamesnw? That PR just needs style cleanup, right?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Correct- that would be great!

if ($fg.alpha !== 1)
return 'This ratio is our best estimate with transparency.';
return null;
});
</script>

<aside data-layout="results">
Expand All @@ -20,6 +35,13 @@
<span class="sr-only">The contrast ratio is</span>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know it's not new here, but I don't think this is useful screen reader context. The heading directly before this says 'current ratio' already.

Copy link
Contributor

@dvdherron dvdherron Feb 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. Removed in 1044fb1. On the topic, I wonder if (in another story) we should edit the click-to-copy buttons to say what exactly they are copying?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I don't know the best solution on those - but no harm oping an issue to explore it.

<span class="result-ratio-number">{displayRatio}:1</span>
</h3>
{#if alphaWarning}
<div class="result-warning-info">
<p data-color-info="warning" class="result-warning">
<Icon name="warning" />{alphaWarning}
</p>
</div>
{/if}

<p class="result-intro">
In WCAG 2, contrast is a measure of the difference in perceived brightness
Expand Down Expand Up @@ -73,7 +95,9 @@
@use 'config';

[data-layout='results'] {
background-color: var(--bgcolor);
background: linear-gradient(90deg, var(--bgcolor), var(--bgcolor)),
url('data:image/svg+xml;utf8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60"><rect fill="%23e8e8e8" width="30" height="30"/><rect x="30" y="30" width="30" height="30" fill="%23e8e8e8"/></svg>');
background-size: 30px 30px;
color: var(--fgcolor);
display: grid;
gap: var(--result-layout-gap, var(--shim));
Expand All @@ -96,26 +120,34 @@
}

.contrast-info {
column-gap: var(--shim);
display: grid;
grid-area: contrastinfo;
// fixed row height to prevent layout shift when warning appears
grid-template:
'heading' min-content
'number' min-content / 100%;
'heading heading' min-content
'number warning' var(--ratio-warning-height) / auto 1fr;
margin-block-end: var(--contrast-info-block-end, var(--gutter));

@include config.between('sm-column-break', 'lg-page-break') {
--contrast-info-block-end: 0;
gap: var(--shim) var(--gutter);
// fixed width column to prevent layout shift as the ratio number changes
// fixed row height to prevent layout shift when warning appears
grid-template:
'heading number' min-content
'intro intro' 1fr / auto var(--ratio-width);
'intro warning' var(--ratio-warning-height) / auto minmax(
var(--ratio-width),
1fr
);
}

@include config.above('lg-page-break') {
gap: var(--shim);
grid-template:
'heading' auto
'intro' auto
'number' auto / 100%;
'heading heading' auto
'intro intro' auto
'number warning' var(--ratio-warning-height) / var(--ratio-width) auto;
}
}

Expand All @@ -138,15 +170,30 @@
}

.result-ratio {
align-items: start;
align-items: var(--result-ratio-align, center);
display: inline-flex;
grid-area: number;
line-height: 0.7; // weird number alignment

@include config.between('sm-column-break', 'lg-page-break') {
--result-ratio-align: start;
justify-content: flex-end;
}
}
.result-warning-info {
align-items: center;
display: flex;
grid-area: warning;
}
.result-warning {
--warning-bg: var(--bg);
--warning-padding-block: var(--shim);
--warning-padding-inline: var(--shim);
--warning-size: border: var(--border-width) solid var(--border);
border-radius: var(--border-radius);
display: flex;
gap: var(--half-shim);
}

.result-ratio-number {
background-color: var(--status-result-bg, var(--bgcolor));
Expand Down
1 change: 1 addition & 0 deletions src/sass/config/scale/_ui.scss
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ $icon-size-default: 1.125em;
$icon-small: 0.65em;
$icon-medium: 1.5em;
$ratio-width: 10rem;
$ratio-warning-height: 6rem;
$range-thumb-size: 1.35rem;
$range-input: 0.85rem;
$triangle-width: var(--shim);
Expand Down
1 change: 1 addition & 0 deletions src/sass/initial/_type.scss
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@ strong {
font-size: var(--color-info-size, var(--warning-size));
margin-bottom: var(--warning-margin-bottom);
padding-block: var(--warning-padding-block);
padding-inline: var(--warning-padding-inline);
text-align: var(--warning-align, left);

main > & {
Expand Down
Loading