SharePoint 2013 Ribbon API. Версии 14.3 и 15.4

13 октября, 2013

Очередной релиз QASPRibbon для работы с SharePoint Ribbon. Обновление касается как 14 версии для SharePoint 2010, так и 15 для SharePoint 2013.

Также впервые стала доступна урезанная версия для управления лентой в sandbox-решениях, позволяющая использовать QASPRibbon API в решениях для SharePoint Online.

Что нового

В версиях 14.3 и 15.3 изменился порядок формирования контролов и при переходе со старых версий API, придется переписать код (несущественно).

Новый элемент - секция

Для SharePoint Ribbon этот элемент не новый, в предыдущих версия QASPRibbon его поддержка не была реализована. Контролы помещались непосредственно в группу, а при формировании XML-определения для всех контролов в группе создавалась одна единственная секция.

Было примерно так:

RibbonGroup group = new RibbonGroup("RibbonGroupId", "Ribbon Title")
{
    Alignment = RibbonGroupAlignment.Top,
    Template = RibbonGroupTemplate.ThreeRows,
    DisplayMode = RibbonDisplayMode.Image16AndCaption,
    Controls = new RibbonControl[] {
        //TODO: Define controls
    }
};

Теперь группа должна содержать коллекцию секций, а уже секции - контролы. Начиная с версии 14.3 и 15.3 код выше придется переписать:

RibbonGroup group = new RibbonGroup("RibbonGroupId", "Ribbon Title")
{
    Sections = new RibbonSection[]
    {
        new RibbonSection("SectionId")
        {
            Alignment = RibbonSectionAlignment.Top,
            Type = RibbonSectionType.ThreeRows,
            DisplayMode = RibbonDisplayMode.Image16AndCaption,
            Controls = new RibbonControl[] {
                //TODO: Define buttons
            }
        }
    }
};

Использование секций при построении кастомных вкладок рибона позволяет делать следующее:

Использовать разную разметку элементов в пределах одной группы;
Использовать разделитель между элементами группы.

SharePoint Online (Sandbox)

К двум имеющимся версиям Ribbon API (для 2010 и 2013 SharePoint) я добавил еще одну - урезанную для использования её в sandbox-решениях. Ничто теперь не мешает использовать Ribbon API при создании решений для Office 365 (SharePoint Online).

Использования Ribbon API в решениях для SharePoint Online довольно сильно ограничено. Дело в том, что для регистрации контролов на ленте необходимо "добраться" до контрола SPRibbon, что невозможно сделать в sandbox-решениях. Поэтому использовать QASPRibbon можно только в ресиверах фич для модификации существующих элементов управления (удаление/замена вкладки, группы контролов и контрола).

Ссылки

QASPRibbon API для SharePoint Online
QASPRibbon API 15.4 для SharePoint 2013
QASPRibbon API 14.3 для SharePoint 2010