WebPart на страницах
WebPart (вебчасть) — интерактивный блок на странице: таблица списка, лента документов, баннер, навигация по подразделам и др. WebPart настраивается через панель свойств и отображается в режиме просмотра как часть страницы.
Разработка собственных WebPart — в разделе WebParts для разработчиков. Здесь описана работа редактора контента с уже установленными виджетами.
Встроенные WebPart
В каждой установке Portal доступны стандартные WebPart:
| Название | Категория | Назначение |
|---|---|---|
| Список | Списки | Таблица элементов выбранного списка |
| Документы | Документы | Файлы из библиотеки документов |
| Баннер | Базовые | Крупный блок: заголовок, подзаголовок, кнопка, фон |
| Объявление | Базовые | Цветной информационный блок (инфо, успех, предупреждение, важно) |
| Быстрые ссылки | Навигация | Набор ссылок с иконками |
| Дочерние узлы | Навигация | Ссылки на подразделы узла |
Дополнительные WebPart поставляются организацией в виде пакетов .portalpart — их устанавливает администратор портала (Админка → WebPart). В каталоге при добавлении на страницу отображаются только включённые определения.
Добавление WebPart на страницу
- Откройте страницу и нажмите Редактировать.
- В нужной колонке (секция Содержимое) нажмите + WebPart.
- В окне Добавить WebPart:
- используйте поиск по названию;
- выберите виджет в списке (группы по категориям: Списки, Документы, Базовые, Навигация и др.).
- Блок появится в колонке с предпросмотром содержимого.
- Нажмите Сохранить на странице, чтобы опубликовать изменения.
Настройка WebPart
- В режиме редактирования нажмите Настроить (шестерёнка) на блоке WebPart.
- Откроется окно Настройки: {название WebPart}.
- Заполните поля и нажмите Применить.
- Предпросмотр блока обновится.
Параметры зависят от типа WebPart (см. таблицы ниже).
Управление блоками
На панели каждого WebPart в редакторе:
- Дублировать — вторая копия с теми же настройками (удобно для двух списков на одной странице);
- Настроить — панель свойств;
- Вверх / Вниз — порядок в колонке;
- Удалить — убрать WebPart со страницы.
Блоки можно перетаскивать между колонками, если разметка страницы многоколоночная.
Настройки встроенных WebPart
Список (portal.list-view)
| Параметр | Описание |
|---|---|
| Список | Какой список узла показывать (обязательно) |
| Представление | Колонки и сортировка (зависит от выбранного списка) |
| Записей на странице | Число строк (1–100, по умолчанию 10) |
| Показывать заголовок | Заголовок списка над таблицей |
Документы (portal.document-list)
| Параметр | Описание |
|---|---|
| Библиотека | Библиотека документов узла (обязательно) |
| Файлов на странице | Число файлов (1–100, по умолчанию 20) |
| Показывать заголовок | Заголовок над списком файлов |
Баннер (portal.hero)
| Параметр | Описание |
|---|---|
| Заголовок | Основной текст (обязательно) |
| Подзаголовок | Дополнительная строка |
| Текст кнопки | Подпись на кнопке |
| URL кнопки | Куда ведёт кнопка |
| URL фонового изображения | Картинка на фоне |
| Выравнивание | Слева / по центру / справа |
Объявление (portal.announcement)
| Параметр | Описание |
|---|---|
| Текст объявления | Содержимое (обязательно) |
| Стиль | Информация / Успех / Предупреждение / Важно |
| Иконка Font Awesome | Класс иконки (по умолчанию fa-circle-info) |
Быстрые ссылки (portal.quick-links)
| Параметр | Описание |
|---|---|
| Ссылки | Редактор списка: заголовок, URL, иконка для каждой ссылки |
Дочерние узлы (portal.child-nodes)
| Параметр | Описание |
|---|---|
| Узел | Корень дерева (пусто = текущий узел страницы) |
| Показывать заголовок | Заголовок над списком подразделов |
Типы полей панели свойств
В настройках WebPart (в том числе из пакетов организации) могут встречаться поля:
| Тип | В интерфейсе |
|---|---|
| Текст | Однострочное поле |
| Многострочный текст | Текстовая область |
| Число | Числовое поле |
| Флажок | Да / нет |
| Выбор | Выпадающий список вариантов |
| Список | Выбор списка текущего узла |
| Библиотека | Выбор библиотеки документов |
| Узел | Выбор узла портала (иногда — любого узла с путём «Родитель / Узел») |
| Представление | Представление выбранного списка |
| Редактор ссылок | Таблица ссылок с заголовком, URL и иконкой |
| Цвет | Выбор цвета |
Некоторые поля зависят от других (например, «Представление» активно после выбора «Список»).
Текст и WebPart на одной странице
Страница собирается из колонок; в каждой колонке — цепочка блоков:
- Текст — статический контент, оформленный вручную;
- WebPart — динамические данные (списки, файлы, навигация).
Типичная композиция: баннер (WebPart) → вводный текст → таблица списка (WebPart) → пояснение в текстовом блоке.
Права и WebPart
WebPart показывает только те данные, к которым у пользователя есть доступ. Если список или библиотека закрыты, виджет может показать подсказку или пустое состояние. Настройка прав — в разделе о правах.
Установка новых WebPart (для администратора)
- Админка → WebPart.
- Загрузите файл пакета
.portalpart. - Убедитесь, что определение включено в каталоге.
- После этого редакторы страниц увидят новый WebPart в окне Добавить WebPart.
См. также
- Страницы — создание, разметка, блоки, сохранение
- Страницы, списки и библиотеки — списки и документы, которые подключают WebPart
- WebParts (разработка) — сборка собственных виджетов