Использование контрола HtmlEditor. Часть 2

26 января, 2012

Часть 1. Использование HtmlEditor на страницах/контролах SharePoint
Часть 2. Создание своего контрола на базе HtmlEditor
Часть 3. Варианты использование HtmlEditor
Исходные коды демонстрационного проекта

Свой редактор на базе HtmlEditor

Разработчики Microsoft не стали никоим образом запечатывать класс HtmlEditor, чем мы и воспользуемся. Здесь я просто покажу пример инкапсуляции необходимых операций для обеспечения работоспособности контрола.

Процедура стандартная: создаем класс, наследуем его от HtmlEditor и переопределяем метод OnInit для инкапсуляции необходимых операций:

using System;
using Microsoft.SharePoint.Publishing.WebControls;
using Microsoft.SharePoint.WebControls;
 
namespace ZhukBlogUsingHtmlEditor
{
  public class ZhukHtmlEditor : HtmlEditor
  {
    protected override void OnInit(EventArgs e)
    {
      base.OnInit(e);
      var ribbon = SPRibbon.GetCurrent(Page);
      if (ribbon != null)
      {
        ribbon.CommandUIVisible = true;
        ribbon.TrimById("Ribbon.EditingTools.CPEditTab.Layout");
        ribbon.TrimById("Ribbon.EditingTools.CPEditTab.EditAndCheckout");
      }
 
      Field = new RichHtmlField
      {
        ControlMode = SPControlMode.Edit,
        EnableViewState = true,
        AllowReusableContent = false,
        MinimumEditHeight = "300px",
        HasInitialFocus = true,
        AllowInsert = true
      };
    }
  }
}

Немного улучшений

Не хватает стандартному HtmlEditor возможности валидации, т.е. нельзя прикрутить какой-нибудь RequiredFieldValidator. Я исправил это недоразумение, указав свойства Html в атрибуте ValidationProperty. Для демонстрации сделанного я переопределил свойство Html следующим образом:

public new string Html
{
  get
  {
    return base.Html.Replace("IBM", "Microsoft");;
  }
  set
  {
    base.Html = value;
  }
}

На страницу ZhukEditor.aspx я добавил валидатор, панель и кнопку, которая будет заполнять панель содержимым редактора, а также послужит нам для проверки работы валидатора. Получилось вот так (часть кода страницы):

<%@ Register TagPrefix="ZhukBlog" Namespace="ZhukBlogUsingHtmlEditor" Assembly="$SharePoint.Project.AssemblyFullName$" %>
<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
  <ZhukBlog:ZhukHtmlEditor ID="OverridedEditor" runat="server">
  </ZhukBlog:ZhukHtmlEditor>
  <asp:RequiredFieldValidator ID="OverridedEditorValidator" runat="server" ControlToValidate="OverridedEditor"
    ErrorMessage="Give me the text!"></asp:RequiredFieldValidator>
  <asp:Button ID="PostButton" runat="server" Text="PostMe" OnClick="PostButtonClick" />
  <asp:Panel ID="OverridedEditorResult" runat="server">
  </asp:Panel>
</asp:Content>

Результат

В результате мы получили редактор форматированного текста, использование которого не обременено написанием дополнительного кода, а также с возможность валидации.