Image and File browser

The editor allows you to manage the images and files using FileExplorer. The FileExplorer enables you to insert images from online source as well as local computer where you want to insert the image in your content. The Image and file browser is the ability to upload pictures and link file to the editor.

Insert an Image from Online Source

If you want to insert an image from online source like Google, ping, etc., you need to enable images tool on the editor’s toolbar. By default, the images tool is open a simple dialog which allows you to inserting an image from online source.

  • html
  • @{
        List<String> toolsList = new List<string>() { "images" };
        List<String> images = new List<string>() { "image" };
    }
    @{Html.EJ().RTE("rteSample").Width("100%").ContentTemplate(@<p>
        The Rich Text Editor (RTE) control is an easy to render in client side.
        Customer easy to edit the contents and get the HTML content for the displayed content.
        A rich text editor control provides users with a toolbar that helps them to apply rich text formats to the text entered in the text area.
    
    </p>)
    .ShowFooter(true)
    .ToolsList(toolsList)
    .Tools(tool => tool.Images(images)).Render();}

    Insert an Image from Your Computer

    Configure the ImageBrowser and FileBrowser property to insert an image from your computer. You can specify the settings required by the FileExplorer to create, read, upload, and destroy the files and images from the explorer.

  • html
  • @{
        List<String> toolsList = new List<string>() { "images" };
        List<String> images = new List<string>() { "image" };
    }
    @{Html.EJ().RTE("rteSample").Width("100%").ContentTemplate(@<p>
        The Rich Text Editor (RTE) control is an easy to render in client side.
        Customer easy to edit the contents and get the HTML content for the displayed content.
        A rich text editor control provides users with a toolbar that helps them to apply rich text formats to the text entered in the text area.
    </p>)
    .ShowFooter(true)
    .Tools(tool => tool.Images(images))
    .ToolsList(toolsList)
    .ImageBrowser(image => image.FilePath("~/FileExplorerContent/")
        .ExtensionAllow("*.png,*.gif,*.jpg,*.jpeg")
        .AjaxAction(@Url.Content("FileActionMethods")))
    .FileBrowser(file => file.FilePath("~/FileExplorerContent/")
        .ExtensionAllow("*.png,*.txt,*.jpg,*.docx")
        .AjaxAction("FileActionMethods"))
    .Render();}
  • html
  • public ActionResult FileActionMethods(Syncfusion.JavaScript.FileExplorerParams args)
    {
        Syncfusion.JavaScript.FileExplorerOperations operation = new Syncfusion.JavaScript.FileExplorerOperations();
        switch (args.ActionType)
        {
            case "Read":
                return Json(operation.Read(args.Path, args.ExtensionsAllow));
            case "CreateFolder":
                return Json(operation.CreateFolder(args.Path, args.Name));
            case "Paste":
                return Json(operation.Paste(args.LocationFrom, args.LocationTo, args.Names, args.Action, args.CommonFiles));
            case "Remove":
                return Json(operation.Remove(args.Names, args.Path));
            case "Rename":
                return Json(operation.Rename(args.Path, args.Name, args.NewName, args.CommonFiles));
            case "GetDetails":
                return Json(operation.GetDetails(args.Path, args.Names));
            case "Download":
                operation.Download(args.Path, args.Names);
                break;
            case "Upload":
                operation.Upload(args.FileUpload, args.Path);
                break;
        }
        return Json("");
    }

    NOTE

    FileExplorer component has been implemented and integrated with the editor in Volume 1, 2015 release. For more information about FileExplorer component, see here.

    Image Properties

    You can set or modify the properties of an image by using the image dialog. It allows you to add links, apply border and set additional styles to the images. The editor provides an option to specify the alternate text for an image, if the image cannot be displayed.

    Resize an Image

    You can resize an image either manually or by setting width and height in the image dialog.

    Resize Manually

    You can resize an image manually by selecting an image. And drag the handle until the image is resized to the desired size.

    NOTE

    Set the default height and width of the Images which was inserted into the RTE text area in “change” event of RTE - <p>Link</p>

    Set Width and Height

    The editor provides you to set the Width and Height properties to change the size of an image (rather than forcing you to set in style attributes) using ShowDimensions property. By default, the Constrain Proportion checkbox is selected to resize an image to an exact proportion. To apply the exact width and height that you specify into the Height and Width textboxes, uncheck the Constrain Proportions checkbox.

  • html
  • @{
        List<String> toolsList = new List<string>() { "images" };
        List<String> images = new List<string>() { "image" };
    }
    @{Html.EJ().RTE("rteSample").Width("100%").ContentTemplate(@<p>
        The Rich Text Editor
        (RTE) control is an easy to render in client side. Customer easy to edit the contents
        and get the HTML content for the displayed content. A rich text editor control provides
        users with a toolbar that helps them to apply rich text formats to the text entered
        in the text area.
    </p>).ShowFooter(true)
    .ToolsList(toolsList)
    .Tools(tool => tool.Images(images))
    .ShowDimensions(true)
    .Render();}

    Suppression of the Image Browser

    The General and Advanced tabs in the RTE Image browser can be removed by setting its corresponding display CSS property to none.

  • css
  • <style type="text/css" class="cssStyles">
            div.e-rte-imageTab.e-tab.e-js.e-widget {
                display: none;
            }
        </style>

    Can remove the Add NewFolder button by using removeToolbarItem property of Image Browser in the RTE create event.

  • html
  • @{
        List<String> toolsList = new List<string>() { "images" };
        List<String> images = new List<string>() { "image" };
    }
    @{Html.EJ().RTE("rteSample").Width("100%").ContentTemplate(@<p>
        The Rich Text Editor (RTE) control is an easy to render in client side.
        Customer easy to edit the contents and get the HTML content for the displayed content.
        A rich text editor control provides users with a toolbar that helps them to apply rich text formats to the text entered in the text area.
    </p>)
    .ShowFooter(true)
    .Tools(tool => tool.Images(images))
    .ToolsList(toolsList)
    .ImageBrowser(image => image.FilePath("~/FileExplorerContent/")
        .ExtensionAllow("*.png,*.gif,*.jpg,*.jpeg")
        .AjaxAction(@Url.Content("FileActionMethods")))
    .FileBrowser(file => file.FilePath("~/FileExplorerContent/")
        .ExtensionAllow("*.png,*.txt,*.jpg,*.docx")
        .AjaxAction("FileActionMethods"))
    .ClientSideEvents(e => e.Create("onCreate"))
    .Render();}
    
    <script>
    
        function onCreate(args){
            this._explorerObj.removeToolbarItem("NewFolder");
        }
        
    </script>

    In RTE control, there is no direct support for the autoUpload option. But this can be achieved by enabling the autoUpload at create event of RTE.

  • html
  • @{
        List<String> toolsList = new List<string>() { "images" };
        List<String> images = new List<string>() { "image" };
    }
    @{Html.EJ().RTE("rteSample").Width("100%").ContentTemplate(@<p>
        The Rich Text Editor (RTE) control is an easy to render in client side.
        Customer easy to edit the contents and get the HTML content for the displayed content.
        A rich text editor control provides users with a toolbar that helps them to apply rich text formats to the text entered in the text area.
    </p>)
    .ShowFooter(true)
    .Tools(tool => tool.Images(images))
    .ToolsList(toolsList)
    .ImageBrowser(image => image.FilePath("~/FileExplorerContent/")
        .ExtensionAllow("*.png,*.gif,*.jpg,*.jpeg")
        .AjaxAction(@Url.Content("FileActionMethods")))
    .FileBrowser(file => file.FilePath("~/FileExplorerContent/")
        .ExtensionAllow("*.png,*.txt,*.jpg,*.docx")
        .AjaxAction("FileActionMethods"))
    .ClientSideEvents(e => e.Create("onCreate"))
    .Render();}
    
    <script>
        function onCreate(args){
            this._explorerObj._uploadtag.data("ejUploadbox").option("autoUpload", true);
        }
        
    </script>