/// <summary>
/// Wraps blocks within the region in a specific html tag. Each region
/// needs to have a single container node in page edit mode and by default a div
/// element is used if a single container cannot be found in the rendered output.
/// Use this setting to control this tag. If a tag is specified here the output
/// will always be wrapped irrespecitive of whether the page is in edit mode to maintain
/// consistency.
/// </summary>
/// <param name="tagName">Name of the element to wrap the output in e.g. div, p, header</param>
/// <param name="htmlAttributes">Html attributes to apply to the wrapping tag.</param>
/// <returns>ICustomEntityTemplateRegionTagBuilder for method chaining</returns>
public ICustomEntityTemplateRegionTagBuilder<TModel> WrapWithTag(string tagName, object htmlAttributes = null)
{
if (tagName == null) throw new ArgumentNullException(nameof(tagName));
if (string.IsNullOrWhiteSpace(tagName)) throw new ArgumentEmptyException(nameof(tagName));
_wrappingTagName = tagName;
_additonalHtmlAttributes = TemplateRegionTagBuilderHelper.ParseHtmlAttributesFromAnonymousObject(htmlAttributes);
return this;
}
/// <summary>
/// Wraps blocks within the region in a specific html tag. Each region
/// needs to have a single container node in page edit mode and by default a div
/// element is used if a single container cannot be found in the rendered output.
/// Use this setting to control this tag. If a tag is specified here the output
/// will always be wrapped irrespecitive of whether the page is in edit mode to maintain
/// consistency.
/// </summary>
/// <param name="tagName">Name of the element to wrap the output in e.g. div, p, header</param>
/// <param name="htmlAttributes">Html attributes to apply to the wrapping tag.</param>
/// <returns>IPageTemplateRegionTagBuilder for method chaining</returns>
public IPageTemplateRegionTagBuilder WrapWithTag(string tagName, object htmlAttributes = null)
{
if (tagName == null)
{
throw new ArgumentNullException(nameof(tagName));
}
if (string.IsNullOrWhiteSpace(tagName))
{
throw new ArgumentEmptyException(nameof(tagName));
}
_wrappingTagName = tagName;
_additonalHtmlAttributes = TemplateRegionTagBuilderHelper.ParseHtmlAttributesFromAnonymousObject(htmlAttributes);
return(this);
}