From ffe3489345f954b0e4550bf6e15499ec0607ee8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Kuna?=
<1282324+codecalm@users.noreply.github.com>
Date: Wed, 12 Aug 2026 00:10:20 +0200
Subject: [PATCH] Rename element list classes to singular and use them in
examples (#2853)
---
.agents/skills/generate-changeset/SKILL.md | 1 -
.agents/skills/mr-description/SKILL.md | 1 -
.changeset/badge-tag-list-rename.md | 9 +++++
core/scss/ui/_badges.scss | 4 ++-
core/scss/ui/_tags.scss | 4 ++-
docs/content/ui/components/avatar.mdx | 26 +++++++-------
docs/content/ui/components/badge.mdx | 31 +++++++++++------
docs/content/ui/components/button.mdx | 34 +++++++++----------
docs/content/ui/components/placeholder.mdx | 2 +-
docs/content/ui/components/popover.mdx | 2 +-
docs/content/ui/components/spinner.mdx | 4 +--
docs/content/ui/components/tag.mdx | 10 +++---
docs/content/ui/components/tooltip.mdx | 2 +-
preview/pages/all-elements.astro | 27 ++++++++-------
preview/pages/badges.astro | 22 ++++++------
preview/pages/form-layout.astro | 5 +--
preview/pages/job-listing.astro | 5 +--
preview/pages/logs.astro | 15 ++++----
preview/pages/offcanvas.astro | 17 ++++++----
preview/pages/tags.astro | 34 +++++++++----------
shared/components/cards/Card.astro | 2 +-
shared/ui/AdvancedTable.astro | 6 ++--
.../ui/{BadgesList.astro => BadgeList.astro} | 4 +--
shared/ui/{TagsList.astro => TagList.astro} | 4 +--
24 files changed, 150 insertions(+), 121 deletions(-)
create mode 100644 .changeset/badge-tag-list-rename.md
rename shared/ui/{BadgesList.astro => BadgeList.astro} (55%)
rename shared/ui/{TagsList.astro => TagList.astro} (56%)
diff --git a/.agents/skills/generate-changeset/SKILL.md b/.agents/skills/generate-changeset/SKILL.md
index 0c8fa3c73..29483deef 100644
--- a/.agents/skills/generate-changeset/SKILL.md
+++ b/.agents/skills/generate-changeset/SKILL.md
@@ -4,7 +4,6 @@ description: >-
Creates a Tabler changeset file in `.changeset/` from the current code
changes. Use when the user asks for a changeset, version bump, release note
entry, or changelog entry for @tabler/core, @tabler/preview, or @tabler/docs.
-disable-model-invocation: true
---
# Generate changeset
diff --git a/.agents/skills/mr-description/SKILL.md b/.agents/skills/mr-description/SKILL.md
index 19773df6d..1e932a0a6 100644
--- a/.agents/skills/mr-description/SKILL.md
+++ b/.agents/skills/mr-description/SKILL.md
@@ -5,7 +5,6 @@ description: >-
from the current branch versus origin/dev (Tabler). Use when the
user asks for an MR/PR description, GitLab merge request text, or a branch
summary for reviewers.
-disable-model-invocation: true
---
# MR / PR description from branch
diff --git a/.changeset/badge-tag-list-rename.md b/.changeset/badge-tag-list-rename.md
new file mode 100644
index 000000000..0320d06d4
--- /dev/null
+++ b/.changeset/badge-tag-list-rename.md
@@ -0,0 +1,9 @@
+---
+'@tabler/core': patch
+'@tabler/preview': patch
+'@tabler/docs': patch
+---
+
+Renamed `.badges-list` to `.badge-list` and `.tags-list` to `.tag-list` so every element list follows the same singular naming as `.btn-list` and `.avatar-list`. The old class names still work as deprecated aliases. Documentation examples and preview pages that show several buttons, badges, avatars, or tags in one
+row now use the matching list container, including the job listing page, which was using a `badges`
+class that had no styles at all.
diff --git a/core/scss/ui/_badges.scss b/core/scss/ui/_badges.scss
index 32f61d168..abaee5605 100644
--- a/core/scss/ui/_badges.scss
+++ b/core/scss/ui/_badges.scss
@@ -70,9 +70,11 @@
}
//
-// Badges list
+// Badge list
//
+.badge-list,
.badges-list {
+ // `.badges-list` is deprecated, use `.badge-list` instead
@include elements-list();
}
diff --git a/core/scss/ui/_tags.scss b/core/scss/ui/_tags.scss
index 1f8a7fd91..10bd09306 100644
--- a/core/scss/ui/_tags.scss
+++ b/core/scss/ui/_tags.scss
@@ -66,8 +66,10 @@
}
//
-// Tags list
+// Tag list
//
+.tag-list,
.tags-list {
+ // `.tags-list` is deprecated, use `.tag-list` instead
@include elements-list();
}
diff --git a/docs/content/ui/components/avatar.mdx b/docs/content/ui/components/avatar.mdx
index 990ce57d4..79f429ac8 100644
--- a/docs/content/ui/components/avatar.mdx
+++ b/docs/content/ui/components/avatar.mdx
@@ -14,7 +14,7 @@ import CodeDocs from '@components/CodeDocs.astro';
Use the `avatar` class to add an avatar to your interface design for greater customization.