Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Using Interfaces

Using interfaces with modelsbuilder

When using compositions, Models Builder generates an interface for the composed model, which enables us to not have to switch back to using Value() for the composed properties.

A common use-case for this is if you have a separate composition for the "SEO properties" Page Title and Page Description.

You would usually use this composition on both your Home and Textpage document types. Since both Home and Textpage will implement the generated ISeoProperties interface, you will still be able to use the simpler models builder syntax (e.g. Model.PageTitle).

A layout template is bound to a generic IPublishedContent, so the models builder syntax isn't available there. You'd have to resort to the ever-so-slightly clumsier Model.Value("pageTitle") syntax instead. Using partial views to render the SEO-specific properties is one way to solve this.

Render with a partial

If you create a partial and change the first line to use the interface name for the model binding, you can use the nice Models Builder syntax when rendering the properties, like this:

@inherits Umbraco.Cms.Web.Common.Views.UmbracoViewPage<ISeoProperties>
<title>@Model.PageTitle</title>
<meta name="description" content="@Model.PageDescription">

You can then render the partial from your Layout Template with something like this (assuming the partial is named Metatags.cshtml):

<head>
    @Html.Partial("Metatags")
</head>
@RenderBody()

It's important to note though, that this layout template will only work for content types that use the Seo Properties composition.

PreviousUnderstand and ExtendNextTips and Tricks

Last updated

Was this helpful?