Обзор экспериментальных мини-приложений Office для веб-страниц
Предупреждение
Экспериментальные мини-приложения Office для веб-страниц предоставляются только в целях исследования и сбора отзывов. Не используйте их в рабочей среде. Поведение мини-приложений Office для веб-страниц может существенно измениться в будущих выпусках. Ознакомьтесь с условиями лицензии на экспериментальные мини-приложения Office для веб-страниц.
Клиентские элементы управления, такие как экспериментальные мини-приложения Office для веб-страниц, могут значительно ускорить разработку надстроек, а также повысить их качество. Но для этого они должны отвечать определенным критериям.
Мини-приложения должны:
Работать на любой веб-странице, даже если страница не размещена в SharePoint.
Работать в среде выполнения элементов управления Office. Это позволяет нам предоставлять общий набор обязательных элементов и согласованный синтаксис для использования мини-приложений.
Передавать данные в SharePoint, используя междоменную библиотеку. Мини-приложения не зависят от определенной платформы или технологии на стороне сервера, поэтому их можно использовать независимо от выбранной серверной технологии.
Сосуществовать с другими элементами на странице. Добавление мини-приложения на страницу не должно изменять другие элементы на ней.
хорошо работают с существующими платформами. Мы хотим быть уверены, что вы по-прежнему сможете использовать привычные средства и технологии.
Надстройка, использующая экспериментальные мини-приложения Office для веб-страниц
Мини-приложения можно использовать, установив пакет NuGet Экспериментальные мини-приложения Office для веб-страниц из Visual Studio. Дополнительные сведения см. в статье Пользовательский интерфейс диспетчера пакетов NuGet и на странице в коллекции NuGet.
Ваши отзывы и комментарии помогли нам решить, какие мини-приложения необходимы. Как видно из предыдущего рисунка, уже доступны мини-приложения (1) "Выбор людей" и (2) "Представление списка на рабочем столе". Оставьте отзыв на сайте UserVoice платформы разработчиков Office.
Чтобы увидеть мини-приложения в действии, воспользуйтесь этим примером кода.
Мини-приложение "Выбор людей"
Используя в надстройках экспериментальное мини-приложение "Выбор людей", можно помочь пользователям находить и выбирать людей и группы в клиенте. Когда пользователь вводит текст в текстовое поле, мини-приложение загружает контакты, чьи имена или адреса электронной почты соответствуют тексту.
Обработка запроса мини-приложением People Picker
Вы можете объявить мини-приложение в разметке HTML или программным путем, используя JavaScript. В любом случае в качестве заполнителя используется элемент div. Вы можете также установить для виджета "Выбор людей" свойства и обработчики событий. В следующей таблице показаны доступные в виджете "Выбор людей" свойства и события.
| Свойство или событие | Тип | Описание |
|---|---|---|
| objectType | Объект JSON (список строк) | Тип элементов, которые будет разрешать виджет. Параметры: группа пользователей По умолчанию используется только пользователь. |
| allowMultipleSelections | Логический | True/False. Если задано значение "False", мини-приложение позволяет выбирать только один элемент за раз. Значение по умолчанию — False. |
| rootGroupName | Строка | Если указан этот параметр, мини-приложение ограничивает выбор элементами из этой группы. В противном случае мини-приложение запрашивает объекты из всей области клиентов. |
| selectedItems | Массив JSON | Список выбранных элементов. Каждый элемент возвращает объект, представляющий пользователя или группу. |
| onAdded | Функция | Событие, которое вызывается при добавлении нового объекта к выбранным. Функция обработчика получила добавленный объект. |
| onRemoved | Функция | Событие, которое вызывается при удалении нового объекта из выбранных. Функция обработчика получила удаленный объект. |
| onChange | Функция | Это событие вызывается добавлением или удалением объектов. Функции обработчика событий не передаются никакие параметры. |
| validationErrors | Массив | Массив возможных ошибок проверки: пустое значение, unresolvedItem, tooManyItems. |
| autoShowValidationMessage | Логический | True: показывать сообщение о проверке. False: не показывать сообщение о проверке. |
| hasErrors | Логический | True: имеется одна или несколько ошибок проверки. False: ошибки проверки отсутствуют. |
| errors | Массив | Массив возможных ошибок проверки: пустое значение, unresolvedItem, tooManyItems. |
| displayErrors | Логический | True: показывать сообщения об ошибках. False: не показывать сообщения об ошибках. |
Классы CSS для виджета "Выбор людей" определены в таблице стилей Office.Controls.css. Вы можете переопределить классы и настроить стиль виджета для своей надстройки.
Дополнительные сведения см. в разделах Использование мини-приложения "Выбор экспериментального Люди" в надстройках SharePoint и Использование экспериментального мини-приложения "Выбор Люди" в примере кода надстройки.
Мини-приложение "Представление списка на рабочем столе"
Пользователи получают все преимущества виджета "Представление списка" и могут представлять данные в списке, как в обычном виджете "Представление списка". Но вы можете использовать его в даже в тех надстройках, которые не размещены в SharePoint.
Мини-приложение "Представление списка на рабочем столе", отображающее данные в виде списка
Вы можете указать существующее представление в списке. Мини-приложение обрабатывает поля в том порядке, в котором они отображаются в представлении.
Примечание.
На данный момент мини-приложение "Представление списка на рабочем столе" только отображает данные. Возможности редактирования отсутствуют.
Вы можете вставить для виджета заполнитель, используя элемент div. Вы можете использовать виджет программно или декларативно.
Вы также можете указать свойства или обработчики событий для виджета "Представление списка на рабочем столе". В следующей таблице показаны доступные свойства и события в виджете "Представление списка на рабочем столе".
| Свойство/Событие | Тип | Описание |
|---|---|---|
| listUrl | URL-адрес | URL-адрес представления списка, из которого необходимо получать элементы. Это может быть относительный URL-адрес (в таком случае он считается расположенным на самом сайте надстройки) или абсолютный URL-адрес. |
| viewName | Строка | Имя представления, которое необходимо показать. Это программное имя представления (не отображаемое имя). |
| onItemSelected | Функция | Событие, которое вызывается при выборе элемента списка. |
| onItemAdded | Функция | Событие, которое вызывается при добавлении нового элемента в список. |
| onItemRemoved | Функция | Событие, которое вызывается при удалении элемента из списка. |
| selectedItems | Массив | Список выбранных элементов в формате JSON. |
Для мини-приложения требуется таблица стилей веб-сайта SharePoint. Вы можете ссылаться на таблицу стилей SharePoint напрямую или использовать мини-приложение chrome. Дополнительные сведения о таблице стилей см. в статьях Использование таблицы стилей веб-сайта SharePoint в надстройках SharePoint и Использование клиентского элемента управления хрома в надстройках SharePoint.
Чтобы увидеть мини-приложение "Представление списка" в действии, воспользуйтесь этим примером кода. См. статью Использование экспериментального мини-приложения "Представление списка" в надстройках SharePoint.
Мини-приложения могут ускорить процесс разработки, а также сократить затраты на ваши надстройки и время их выхода на рынок. Вы можете использовать экспериментальные мини-приложения Office для веб-страниц в некоммерческих надстройках. Оставляйте свои отзывы и комментарии на сайте UserVoice для разработчиков Office.