using System; using System.Collections.Generic; using System.Linq; using System.Web; using Umbraco.Core.Composing; using Umbraco.Core.Models.PublishedContent; namespace Umbraco.Web { /// /// Provides extension methods for IPublishedElement. /// public static class PublishedElementExtensions { // lots of debates about accessing dependencies (IPublishedValueFallback) from extension methods, ranging // from "don't do it" i.e. if an extension method is relying on dependencies, a proper service should be // created instead, to discussing method injection vs service locator vs other subtleties, see for example // this post http://marisks.net/2016/12/19/dependency-injection-with-extension-methods/ // // point is, we do NOT want a service, we DO want to write model.Value("alias", "fr-FR") and hit // fallback somehow - which pretty much rules out method injection, and basically anything but service // locator - bah, let's face it, it works // // besides, for tests, Current support setting a fallback without even a container // private static IPublishedValueFallback PublishedValueFallback => Current.PublishedValueFallback; #region IsComposedOf /// /// Gets a value indicating whether the content is of a content type composed of the given alias /// /// The content. /// The content type alias. /// A value indicating whether the content is of a content type composed of a content type identified by the alias. public static bool IsComposedOf(this IPublishedElement content, string alias) { return content.ContentType.CompositionAliases.Contains(alias); } #endregion #region HasProperty /// /// Gets a value indicating whether the content has a property identified by its alias. /// /// The content. /// The property alias. /// A value indicating whether the content has the property identified by the alias. /// The content may have a property, and that property may not have a value. public static bool HasProperty(this IPublishedElement content, string alias) { return content.ContentType.GetPropertyType(alias) != null; } #endregion #region HasValue /// /// Gets a value indicating whether the content has a value for a property identified by its alias. /// /// Returns true if GetProperty(alias) is not null and GetProperty(alias).HasValue is true. public static bool HasValue(this IPublishedElement content, string alias, string culture = null, string segment = null) { var prop = content.GetProperty(alias); return prop != null && prop.HasValue(culture, segment); } // fixme - .Value() refactoring - in progress // missing variations... /// /// Returns one of two strings depending on whether the content has a value for a property identified by its alias. /// /// The content. /// The property alias. /// The value to return if the content has a value for the property. /// The value to return if the content has no value for the property. /// Either or depending on whether the content /// has a value for the property identified by the alias. public static IHtmlString IfValue(this IPublishedElement content, string alias, string valueIfTrue, string valueIfFalse = null) { return content.HasValue(alias) ? new HtmlString(valueIfTrue) : new HtmlString(valueIfFalse ?? string.Empty); } #endregion #region Value /// /// Gets the value of a content's property identified by its alias. /// /// The content. /// The property alias. /// The variation language. /// The variation segment. /// The default value. /// The value of the content's property identified by the alias, if it exists, otherwise a default value. /// /// The value comes from IPublishedProperty field Value ie it is suitable for use when rendering content. /// If no property with the specified alias exists, or if the property has no value, returns . /// If eg a numeric property wants to default to 0 when value source is empty, this has to be done in the converter. /// The alias is case-insensitive. /// public static object Value(this IPublishedElement content, string alias, string culture = null, string segment = null, object defaultValue = default) { var property = content.GetProperty(alias); if (property != null && property.HasValue(culture, segment)) return property.GetValue(culture, segment); return PublishedValueFallback.GetValue(content, alias, culture, segment, defaultValue); } #endregion #region Value /// /// Gets the value of a content's property identified by its alias, converted to a specified type. /// /// The target property type. /// The content. /// The property alias. /// The variation language. /// The variation segment. /// The default value. /// The value of the content's property identified by the alias, converted to the specified type. /// /// The value comes from IPublishedProperty field Value ie it is suitable for use when rendering content. /// If no property with the specified alias exists, or if the property has no value, or if it could not be converted, returns default(T). /// If eg a numeric property wants to default to 0 when value source is empty, this has to be done in the converter. /// The alias is case-insensitive. /// public static T Value(this IPublishedElement content, string alias, string culture = null, string segment = null, T defaultValue = default) { var property = content.GetProperty(alias); if (property != null && property.HasValue(culture, segment)) return property.Value(culture, segment); return PublishedValueFallback.GetValue(content, alias, culture, segment, defaultValue); } #endregion #region Value or Umbraco.Field - WORK IN PROGRESS // fixme - .Value() refactoring - in progress // trying to reproduce Umbraco.Field so we can get rid of it // // what we want: // - alt aliases // - recursion // - default value // - before & after (if value) // // convertLineBreaks: should be an extension string.ConvertLineBreaks() // stripParagraphs: should be an extension string.StripParagraphs() // format: should use the standard .ToString(format) // // see UmbracoComponentRenderer.Field - which is ugly ;-( // recurse first, on each alias (that's how it's done in Field) // // there is no strongly typed recurse, etc => needs to be in ModelsBuilder? // that one can only happen in ModelsBuilder as that's where the attributes are defined // the attribute that carries the alias is in ModelsBuilder! //public static TValue Value(this TModel content, Expression> propertySelector, ...) // where TModel : IPublishedElement //{ // PropertyInfo pi = GetPropertyFromExpression(propertySelector); // var attr = pi.GetCustomAttribute(); // var alias = attr.Alias; // return content.Value(alias, ...) //} // recurse should be implemented via fallback // todo - that one should be refactored, missing culture and so many things public static IHtmlString Value(this IPublishedElement content, string aliases, Func format, string alt = "") { if (format == null) format = x => x.ToString(); var property = aliases.Split(',') .Where(x => string.IsNullOrWhiteSpace(x) == false) .Select(x => content.GetProperty(x.Trim())) .FirstOrDefault(x => x != null); return property != null ? new HtmlString(format(property.Value())) : new HtmlString(alt); } #endregion #region ToIndexedArray public static IndexedArrayItem[] ToIndexedArray(this IEnumerable source) where TContent : class, IPublishedElement { var set = source.Select((content, index) => new IndexedArrayItem(content, index)).ToArray(); foreach (var setItem in set) setItem.TotalCount = set.Length; return set; } #endregion #region OfTypes // the .OfType() filter is nice when there's only one type // this is to support filtering with multiple types public static IEnumerable OfTypes(this IEnumerable contents, params string[] types) where T : IPublishedElement { types = types.Select(x => x.ToLowerInvariant()).ToArray(); return contents.Where(x => types.Contains(x.ContentType.Alias.ToLowerInvariant())); } #endregion } }