Visarc.Umbraco.HeadingEditor 17.1.1
Visarc.Umbraco.HeadingEditor
A heading property editor for Umbraco 17. Lets editors enter a heading and choose its semantic level (e.g. H1–H6), with an optional separate visual (CSS) level so the markup and the styling can differ.
This is the package to install on an Umbraco website — it ships the backoffice UI
and references Visarc.Umbraco.HeadingEditor.Core for the backend model and
value conversion.
Installation
dotnet add package Visarc.Umbraco.HeadingEditor
The property editor is registered automatically. No startup code is required.
Setup
- In the backoffice, go to Settings → Data Types → Create.
- Search for Heading and choose the Heading Editor property editor.
- Configure the options below, then save and add the data type to a document type.
Configuration options
| Option | Description | Default |
|---|---|---|
| Show class selector? | Show a separate visual (CSS) level selector alongside the semantic level | Off |
| Min level | Lowest selectable heading level | 1 |
| Max level | Highest selectable heading level | 6 |
Rendering
The stored value is exposed as a HeadingModel (Heading, Level, CssLevel):
@using Visarc.Umbraco.HeadingEditor.Core.Models
@{
var heading = Model.Value<HeadingModel>("pageHeading");
}
@if (heading is not null)
{
<h@(heading.Level) class="h@(heading.CssLevel)">@heading.Heading</h@(heading.Level)>
}
Compatibility
| Package | Version |
|---|---|
| Umbraco CMS | 17.x ([17.0.0,18.0.0)) |
| .NET | 10.0 |
Packages
| Package | Purpose |
|---|---|
Visarc.Umbraco.HeadingEditor |
Full plugin: backoffice UI + backend (install this) |
Visarc.Umbraco.HeadingEditor.Core |
Backend only: model + value converter (referenced automatically) |
No packages depend on Visarc.Umbraco.HeadingEditor.
.NET 10.0
- Visarc.Umbraco.HeadingEditor.Core (>= 17.1.1)
- Microsoft.AspNetCore.Components.Web (>= 10.0.10)