Image field

ThesfImageField directive enables you to select and display an image from the existing libraries in your website. In addition, you can also use this directive to upload an image to a library.

After you select an image, the default template lists information about its base properties such as type, size and upload date. To change the selected image, using the image selector and you can also edit the image's properties. For more information, see Image selector.

You can use the directive in the frontend, as well as in the backend, for example, on a page, as well as in a widget designer.

The sfImageField is a directive with an isolated scope that is defined in a module with the same name: sfImageField. For more information, see AngularJs Isolated scope.

The following image is an example of an image field:

Image field

Image field attributes

The sfImageField directive exposes the following attributes:

Attribute Description
Accepts a scope variable that holds the selected id of the image.
Accepts a scope variable that holds the selected image item.
Accepts a provider name to use when retrieving the items to display.
Allows you to override the template of the image field.
Specifies the assembly where the template of the image field is located.
Specifies if the image selector will open initially if no image is bound.

Specifies the permissions that allow all users to access this selector. The options are:

  • sf-media-settings="@Telerik.Sitefinity.Frontend.Mvc.Helpers.SettingsHelpers.GetMediaSettings("Image")"
  • sf-media-settings="@Telerik.Sitefinity.Frontend.Mvc.Helpers.SettingsHelpers.GetMediaSettings("Document")"
  • sf-media-settings="@Telerik.Sitefinity.Frontend.Mvc.Helpers.SettingsHelpers.GetMediaSettings("Video")"
sf-master Defines whether the field displays images and their statues, such as DraftLocked, and so on, or only published images. To configure the Image field to display master items, that is, all images, independently of their status, set the sf-master="true". By default, the field displays only live images and the value of the sf-master is set to false.

NOTE: When you set the sf-master="true", the image field lists the items but does not display their status.

Add the image field directive

The following example demonstrates how to add a image field directive in a widget designer's view.

To enable AngularJs to link the sfImageField directive in your custom designer view, you must load the script of the directive and add a dependency to the module:

  1. Sitefinity CMS automatically registers the scripts you need and, if no other designer view with explicitly set priority exists, Sitefinity CMS sets your designer view priority 1. In case you need to have full control over the scripts that are loaded or you want to set custom priority, you can alternatively create your own DesignerView.YourView.json file. If you have a JSON file that matches the convention (even if empty), this automatic scripts registration will not occur. In your DesignerView.YourView.json file, add a scripts array. As a result, the file content should be similar to the following:
  2. Sitefinity CMS automatically finds all AngularJS modules you rely on and references the widget designer to them. In case you rely on custom AngularJS modules or have logic that needs an AngularJS controller, you can create your own designerview-<yourview>.js file. If you have a .js file that matches the convention (even if empty), this automatic modules referencing will not occur. In your designerview-yourview.js file, right before the definition of your custom view controller, place the following code snippet:

    Since there is no selected image when the controller is initialize for the first time, the sf-auto-open-selector attribute in the code above opens an image selector. After you select an image, the image and its ID are stored in their respective scope variables: selectedImage and selectedImageId. The imageProvider variable holds the name of the provider from which image libraries are loaded.

    NOTE: The image selector can load images from different providers.

  3. In your DesignerView.YourView.cshtml file, place the following tag where you want to render the sfImageField directive:

Additional resources

External links

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

Media field