Skip to content

whuu/Sc.CssPickerField

Repository files navigation

Sc.CssPickerField

Sitecore Single-line Text Field with Css classes autocompletion. Based on Sc.AutoCompleteTextField

Setup

  • Add new field with Css Picker type to your templates, or add base template /sitecore/templates/Foundation/CssPicker/_CssPicker to your existing template.
  • Replace paths to css files in /App_Config/Include/CssPickerField/SmartSitecore.CssPicker.config or use Sitecore patch to add your css files.
  • Alternatively add styles= in field data source with paths to css files, separated with comma:

Css picker field datasource

  • Paths entered in field's data source replace the one defined in configuration file.
  • Css names are cached in Sitecore Cache, where the keys are file names. To clear it go to /sitecore/cache.aspx page.
  • Go to the item based on the template and start writing css class name, Css classses appears in a suggestions list and can be picked:

Css picker field

Usage in Rendering Parameters

Css Picker can be used also on component's rendering parameters to improve content editors experience:

  • Add /sitecore/templates/System/Layout/Rendering Parameters/Standard Rendering Parameters to base templates in _CssPicker template or your custom template with Css Picker field. Select _CssPicker, or your custom template in Parameters Template field of the rendering definition item. Open properties of your component in content or experience editor and start writing css class name:

Css picker field

  • Use rendering parameters in standard Sitecore MVC controller:

    var selectedCss = RenderingContext.Current.Rendering.Parameters["Css Class"];

  • Use rendering parameters in Glass Mapper MVC (where MyParameters is a Model class for corresponding template):

    var selectedCss = GetRenderingParameters<MyParameters>().Css_Class;

    Check out blog entry about the field and it use case.

About

Css Picker field for Sitecore CMS

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published