ContentList

ContentList queries the default content provider and renders the matching items as a grid of cards, with optional pagination and SEO metadata for the list page. Use it for blog indexes and for category, tag, author and search result pages.

Usage

@using Osirion.Blazor.Cms.Web.Components

<ContentList Directory="blog" />

A paginated category page, the way the example site builds one:

@page "/category/{CategorySlug}"
@using Osirion.Blazor.Cms.Web.Components

<ContentList Directory="blog"
             Category="@CategorySlug"
             ShowPagination
             ItemsPerPage="12" />

@code {
    [Parameter] public string? CategorySlug { get; set; }
}

A search page passes the q query-string value through:

@page "/search"
@using Osirion.Blazor.Cms.Web.Components

<ContentList SearchQuery="@Query" ShowPagination ItemsPerPage="12"
             NoContentText="No results found for your search query." />

@code {
    [SupplyParameterFromQuery(Name = "q")]
    public string? Query { get; set; }
}

Parameters

ContentUrlFormatter, ReadMoreText, OnItemSelected, IgnorePathSegment and PathReplacePattern are declared but have no effect in the current markup: each card links to the item's own URL. Style, Theme and unmatched attributes from the base class are not written to the markup either.

Behavior

• Rendering. The list renders on the server under static SSR and needs no script. The loading text appears only in interactive render modes. With the built-in providers, Category or Tag replaces the Directory filter instead of narrowing it.
• Pagination. The current page comes from the page query-string parameter and is clamped to the valid range, so ?page=0 shows the first page and an oversized number shows the last. Page links are ordinary links that keep every other query parameter (for example q); the link to page 1 drops page. The list is fetched once and the page is sliced from it.
• Cards. Each card shows the featured image (lazy loaded) or a placeholder, the title linked to the item, the description (or an excerpt of about 160 characters of the body), author, date, reading time and categories. Category links default to /category/{slug}.
• SEO. With EnableSeoMetadata and at least one item, the head gets a title (from PageTitle, otherwise "Category: ", "Tag: ", the directory name in title case or "Blog", with " - Page N" after the first page), a description, a canonical URL that keeps only page (from page 2 on), rel="prev" and rel="next" links, CollectionPage JSON-LD and a BlogPosting entry per item. Turn it off when the page renders its own SeoMetadataRenderer.
• Accessibility. The previous and next page links are icons without a text label.
• Errors. A provider failure is logged and the empty state is shown.

Styling

The root element has the class osirion-content-list. Pagination uses osirion-content-pagination, osirion-pagination-link (with osirion-active on the current page) and osirion-pagination-ellipsis; the empty state uses osirion-no-content. The cards are rendered by OsirionContentListSection (osirion-featured-posts, osirion-featured-post). Colors, borders and spacing come from theme tokens such as --osirion-border-color, --osirion-action-primary, --osirion-action-primary-text and --osirion-text-secondary, so a framework adapter restyles the list with the rest of the site.

Related

• ContentView: one item with its body
• SeoMetadataRenderer: what the list writes to the head
• CategoriesList: links to category pages
• CMS Web core components