feat(article-link): reimplement card hover using ::before method

The previous method was not intuitive since there was nothing in the <a> tag,
and required group-xxx classes for every element.

The new pseudo element method fixes those problems, see:

https://kittygiraudel.com/2022/04/02/accessible-cards/
This commit is contained in:
ZhenShuo Leo
2025-09-06 14:50:24 +08:00
parent 8911ac843a
commit b1b7aa1f42
6 changed files with 89 additions and 101 deletions

View File

@@ -2543,13 +2543,6 @@ body.zen-mode-enable {
}
}
}
.group-hover\:underline-offset-2 {
&:is(:where(.group):hover *) {
@media (hover: hover) {
text-underline-offset: 2px;
}
}
}
.group-hover\:opacity-100 {
&:is(:where(.group):hover *) {
@media (hover: hover) {
@@ -2640,6 +2633,18 @@ body.zen-mode-enable {
border-top-color: transparent;
}
}
.before\:absolute {
&::before {
content: var(--tw-content);
position: absolute;
}
}
.before\:inset-0 {
&::before {
content: var(--tw-content);
inset: calc(var(--spacing) * 0);
}
}
.after\:clear-both {
&::after {
content: var(--tw-content);
@@ -3850,9 +3855,6 @@ pre {
text-decoration-thickness: 3px;
text-underline-offset: 4px;
}
.group-hover-card:hover:has(.group-hover-cancel:hover) .group-hover-card-title {
text-decoration: none !important;
}
@layer base {
[type='text'],input:where(:not([type])),[type='email'],[type='url'],[type='password'],[type='number'],[type='date'],[type='datetime-local'],[type='month'],[type='search'],[type='tel'],[type='time'],[type='week'],[multiple],textarea,select {
appearance: none;

View File

@@ -278,8 +278,3 @@ pre {
text-decoration-thickness: 3px;
text-underline-offset: 4px;
}
/* Cancel group hover if .group-hover-card contains .group-hover-cancel*/
.group-hover-card:hover:has(.group-hover-cancel:hover) .group-hover-card-title {
text-decoration: none !important;
}

View File

@@ -7,7 +7,7 @@
{{ $constrainItemsWidth := site.Params.list.constrainItemsWidth | default false }}
{{ $disableImageOptimization := site.Params.disableImageOptimization | default false }}
{{ $articleClasses := "group-hover-card group flex flex-wrap md:flex-nowrap article relative" }}
{{ $articleClasses := "flex flex-wrap md:flex-nowrap article relative" }}
{{ if site.Params.list.showCards }}
{{ $articleClasses = delimit (slice $articleClasses "border border-neutral-200 dark:border-neutral-700 border-2 rounded-md overflow-hidden") " " }}
{{ else }}
@@ -63,33 +63,30 @@
<div class="{{ $articleClasses }}">
<a
{{ partial "article-link/_external-link.html" $target | safeHTMLAttr }}
class="absolute inset-0"
aria-label="{{ $.Title }}"></a>
{{ with $featuredURL }}
<div class="{{ $articleImageClasses }}" style="background-image:url({{ . }});"></div>
{{ end }}
<div class="{{ $articleInnerClasses }}">
<div class="items-center text-start text-xl font-semibold">
{{ with $target.Params.externalUrl }}
<div>
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2">
{{ $target.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
<a
{{ partial "article-link/_external-link.html" . | safeHTMLAttr }}
class="not-prose before:absolute before:inset-0 decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 hover:underline hover:underline-offset-2">
{{ with $target.Params.externalUrl }}
<div>
<div>
{{ $target.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
</div>
</div>
</div>
{{ else }}
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2"
href="{{ $target.RelPermalink }}">
{{ $target.Title | emojify }}
</div>
{{ end }}
{{ else }}
<div>
{{ $target.Title | emojify }}
</div>
{{ end }}
</a>
{{ if and $target.Draft site.Params.article.showDraftLabel }}
<div class="ms-2">
{{ partial "badge.html" (i18n "article.draft" | emojify) }}
@@ -99,7 +96,7 @@
{{ partial "extend-article-link.html" $target }}
{{ end }}
</div>
<div class="group-hover-cancel text-sm text-neutral-500 dark:text-neutral-400">
<div class="text-sm text-neutral-500 dark:text-neutral-400">
{{ partial "article-meta/basic.html" $target }}
</div>
{{ $showSummary := false }}

View File

@@ -32,11 +32,7 @@
<div
class="group-hover-card group relative min-h-full min-w-full overflow-hidden rounded border border-2 border-neutral-200 shadow-2xl dark:border-neutral-700">
<a
{{ partial "article-link/_external-link.html" . | safeHTMLAttr }}
class="absolute inset-0"
aria-label="{{ $.Title }}"></a>
class="relative min-h-full min-w-full overflow-hidden rounded border border-2 border-neutral-200 shadow-2xl dark:border-neutral-700">
{{ with $featuredURL }}
<div class="thumbnail_card_related nozoom w-full" style="background-image:url({{ . }});"></div>
{{ end }}
@@ -46,22 +42,24 @@
</span>
{{ end }}
<div class="px-6 py-4">
{{ with .Params.externalUrl }}
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2">
{{ $.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
</div>
{{ else }}
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2">
{{ .Title | emojify }}
</div>
{{ end }}
<div class="group-hover-cancel text-sm text-neutral-500 dark:text-neutral-400">
<a
{{ partial "article-link/_external-link.html" . | safeHTMLAttr }}
class="not-prose before:absolute before:inset-0 decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 hover:underline hover:underline-offset-2">
{{ with .Params.externalUrl }}
<div>
{{ $.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
</div>
{{ else }}
<div>
{{ .Title | emojify }}
</div>
{{ end }}
</a>
<div class="text-sm text-neutral-500 dark:text-neutral-400">
{{ partial "article-meta/basic.html" . }}
</div>
{{ if .Params.showSummary | default (.Site.Params.list.showSummary | default false) }}

View File

@@ -36,11 +36,7 @@
<div
class="group-hover-card group relative min-h-full min-w-full overflow-hidden rounded border border-2 border-neutral-200 shadow-2xl dark:border-neutral-700">
<a
{{ partial "article-link/_external-link.html" . | safeHTMLAttr }}
class="absolute inset-0"
aria-label="{{ $.Title }}"></a>
class="relative min-h-full min-w-full overflow-hidden rounded border border-2 border-neutral-200 shadow-2xl dark:border-neutral-700">
{{ with $featuredURL }}
<div class="thumbnail_card nozoom w-full" style="background-image:url({{ . }});"></div>
{{ end }}
@@ -50,22 +46,24 @@
</span>
{{ end }}
<div class="px-6 py-4">
{{ with .Params.externalUrl }}
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2">
{{ $.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
</div>
{{ else }}
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2">
{{ .Title | emojify }}
</div>
{{ end }}
<div class="group-hover-cancel text-sm text-neutral-500 dark:text-neutral-400">
<a
{{ partial "article-link/_external-link.html" . | safeHTMLAttr }}
class="not-prose before:absolute before:inset-0 decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 hover:underline hover:underline-offset-2">
{{ with .Params.externalUrl }}
<div>
{{ $.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
</div>
{{ else }}
<div>
{{ .Title | emojify }}
</div>
{{ end }}
</a>
<div class="text-sm text-neutral-500 dark:text-neutral-400">
{{ partial "article-meta/basic.html" . }}
</div>
{{ if .Params.showSummary | default (.Site.Params.list.showSummary | default false) }}

View File

@@ -5,7 +5,7 @@
*/}}
{{ $constrainItemsWidth := .Page.Site.Params.list.constrainItemsWidth | default false }}
{{ $articleClasses := "group-hover-card group flex flex-wrap md:flex-nowrap article relative" }}
{{ $articleClasses := "flex flex-wrap md:flex-nowrap article relative" }}
{{ if .Site.Params.list.showCards }}
{{ $articleClasses = delimit (slice $articleClasses "border border-neutral-200 dark:border-neutral-700 border-2 rounded-md overflow-hidden") " " }}
{{ else }}
@@ -63,30 +63,28 @@
<div class="{{ $articleClasses }}">
<a
{{ partial "article-link/_external-link.html" . | safeHTMLAttr }}
class="absolute inset-0"
aria-label="{{ $.Title }}"></a>
{{ with $featuredURL }}
<div class="{{ $articleImageClasses }}" style="background-image:url({{ . }});"></div>
{{ end }}
<div class="{{ $articleInnerClasses }}">
<div class="items-center text-start text-xl font-semibold">
{{ with .Params.externalUrl }}
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2">
{{ $.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
</div>
{{ else }}
<div
class="group-hover-card-title decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 group-hover:underline group-hover:underline-offset-2">
{{ .Title | emojify }}
</div>
{{ end }}
<a
{{ partial "article-link/_external-link.html" . | safeHTMLAttr }}
class="not-prose before:absolute before:inset-0 decoration-primary-500 dark:text-neutral text-xl font-bold text-neutral-800 hover:underline hover:underline-offset-2">
{{ with .Params.externalUrl }}
<div>
{{ $.Title | emojify }}
<span class="cursor-default align-top text-xs text-neutral-400 dark:text-neutral-500">
<span class="rtl:hidden">&#8599;</span>
<span class="ltr:hidden">&#8598;</span>
</span>
</div>
{{ else }}
<div>
{{ .Title | emojify }}
</div>
{{ end }}
</a>
{{ if and .Draft .Site.Params.article.showDraftLabel }}
<div class="ms-2">{{ partial "badge.html" (i18n "article.draft" | emojify) }}</div>
{{ end }}
@@ -94,7 +92,7 @@
{{ partial "extend-article-link.html" . }}
{{ end }}
</div>
<div class="group-hover-cancel text-sm text-neutral-500 dark:text-neutral-400">
<div class="text-sm text-neutral-500 dark:text-neutral-400">
{{ partial "article-meta/basic.html" . }}
</div>
{{ if .Params.showSummary | default (.Site.Params.list.showSummary | default false) }}