CategoriesList

CategoriesList renders a list of links, one per content category, with the number of items in each. It loads the categories itself from the default content provider, so use it in a sidebar, on a home page or on a category page.

Usage

@using Osirion.Blazor.Cms.Web.Components

<CategoriesList Title="Categories" />

A category page that lists the items of one category and marks it in the list:

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

<ContentList Category="@Category" />

<aside>
    <CategoriesList Title="Categories"
                    ActiveCategory="@Category"
                    SortByCount="false" />
</aside>

@code {
    [Parameter]
    public string Category { get; set; } = string.Empty;
}

The default links go to /category/{slug}, which matches this route. ContentList turns the hyphens of the slug back into spaces and keeps items whose category contains that text, ignoring case, so this works for category names made of letters, digits and spaces. For other names, pass CategoryUrlFormatter and read the value your own way.

Parameters

Other attributes on the tag are captured but not rendered, so use Class rather than id or data- attributes.

Behavior

• Categories come from the categories front matter of every item the default provider holds, across all locales and including unpublished items. Names that differ only in case count as one category; the count is the number of items that carry it.
• The list is loaded again on every parameter change. Caching belongs to the content provider, not the component.
• Under static SSR the response is sent with the finished list. LoadingText can show briefly in interactive render modes.
• If the provider throws, the error is logged through ILogger and the empty-state text is shown. Exception details never reach the page.
• Links carry rel="nofollow". Category names are written as text, so they are HTML-encoded.
• The current category is marked with a class only, not with aria-current.

Styling

Colors come from --osirion-text-primary, --osirion-text-secondary, --osirion-action-primary, --osirion-background-tertiary, --osirion-background-hover and --osirion-background-active.

Related

• TagCloud, the same idea for tags
• Content List, for the category page itself
• CMS navigation components