Skip to content

Add Table Kind Collection View Documentation#8043

Open
madsrasmussen wants to merge 24 commits into
umbraco:mainfrom
madsrasmussen:v17/feature/table-kind-collection-view
Open

Add Table Kind Collection View Documentation#8043
madsrasmussen wants to merge 24 commits into
umbraco:mainfrom
madsrasmussen:v17/feature/table-kind-collection-view

Conversation

@madsrasmussen
Copy link
Copy Markdown
Member

@madsrasmussen madsrasmussen commented May 6, 2026

📋 Description

Adds documentation for the new Table Kind Collection View

✅ Contributor Checklist

I've followed the Umbraco Documentation Style Guide and can confirm that:

  • Code blocks are correctly formatted.
  • Sentences are short and clear (preferably under 25 words).
  • Passive voice and first-person language (“we”, “I”) are avoided.
  • Relevant pages are linked.
  • All links work and point to the correct resources.
  • Screenshots or diagrams are included if useful.
  • Any code examples or instructions have been tested.
  • Typos, broken links, and broken images are fixed.

Product & Version (if relevant)

CMS 17.5

Deadline (if relevant)

With the release candidate of 17.4, scheduled for Thursday 11th June.

@madsrasmussen madsrasmussen changed the title Add Table Collection View Kind Documentation Add Table Kind Collection View Documentation May 6, 2026
Copy link
Copy Markdown
Contributor

@AndyButland AndyButland left a comment

Choose a reason for hiding this comment

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

Looks good @madsrasmussen - just a few suggestions to consider. The main one being around how this should or could cross-link or otherwise display a bit more information about collections in general, so it's clearer how the column mapping works.

Copy link
Copy Markdown
Contributor

@AndyButland AndyButland left a comment

Choose a reason for hiding this comment

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

This looks really good to me now @madsrasmussen - much clearer to understand how the parts fit together.

@sofietoft
Copy link
Copy Markdown
Contributor

sofietoft commented Jun 8, 2026

Do these changes apply to version 18 as well?

Also, are the new articles in this PR generated by (or with the assistance of) AI?
For transparency, we're tagging all articles written by or with the assistance of AI.

This defines how a list of entities is rendered in your collection.
Implement the Collection View as a Lit element that extends `UmbCollectionViewElementBase`. The base class provides the collection items via `_items`, handles selection state, and exposes helper methods such as `_isSelectableItem` and `_isSelectedItem`. Override `render()` to define how the collection is displayed.

Split the view into two elements: a view element that handles the layout and delegates item rendering to a dedicated item element.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I had a difficult time figuring out what the two elements were, so I suggest rewriting this into a short list:

Suggested change
Split the view into two elements: a view element that handles the layout and delegates item rendering to a dedicated item element.
Split the view into two elements:
* A **view element** that handles the overall layout.
* An **item element** that handles rendering individual items delegated to it by the view element.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

This article is missing a description.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants