Предпросмотр файла

По умолчанию предпросмотр документов в карточках отключен. Чтобы включить предпросмотр, необходимо настроить компоненты Р7-Офис Сервер документов/OnlyOffice.

Элемент управления Предпросмотр файла предназначен для отображения содержимого файла, выбранного в элементе Список файлов, Файловая панель, Файловая панель согласования.

Если максимальный размер файла для предпросмотра ограничен настройками системы, вместо предпросмотра больших будет выводиться сообщение об ошибке Предпросмотр недоступен согласно настройкам системы. Для ознакомления с файлом скачайте его и откройте в соответствующей программе.
Пример элемента управления "Предпросмотр файла" в разметке карточки
Рисунок 1. Пример элемента управления "Предпросмотр файла" в разметке карточки
Данный элемент управления позволяет:

  • Отображать содержимое файла непосредственно в разметке просмотра и редактирования карточки.

  • Отображать содержимое файла при загрузке карточки без необходимости выбора файла.

  • Переключаться между отображаемыми файлами.

  • Работать с несколькими элементами Список файлов: если в разметке несколько данных элементов, ЭУ Предпросмотр файла будет показывать содержимое активного элемента Список файлов.

Важные особенности использования элемента "Предпросмотр файла"

  • В разметку можно добавить только один элемент Предпросмотр файла.

  • Элемент управления Предпросмотр файла должен быть добавлен в отдельный элемент Блок, в котором не должно быть других элементов кроме элемента Предпросмотр файла.

  • Родительский блок элемента Предпросмотр файла должен размещаться в блоке, содержащем только два дочерних элемента (см. рисунок ниже): блок с элементом Предпросмотр файла и блок с остальными элементами разметки.

    Пример структуры разметки
    Рисунок 2. Пример структуры разметки, соответствующей требованиям
Типы файлов, для которых поддерживается предварительный просмотр:

  • .pdf (в т.ч PDF/A-1a).

  • Офисные: .docx, .odt, .doc, .rtf, .dot, .dotx, .xlt, .xls, .xltx, .xlsx, .ods;

  • Изображения: .jpg, .jpeg, .gif, .png, .bmp, .tiff, .tif;

  • Прочие: .htm, .adoc, .js, .xslt, .xsl, .xml, .asmx, .ascx, .aspx, .cpp, .h, .css, .idl, .ini, .java, .rc, .rc2, .shtm, .shtml, .txt, .log, .cs, .sql, .csv.

Данный элемент управления может быть добавлен в разметки создания, просмотра и редактирования карточек Документ, а также просмотра и редактирования карточек Задание и Группа заданий.
Работа элемента управления в разметке создания карточек Задание и Группа заданий НЕ поддерживается.

Свойства

Общие

Название ЭУ

Название типа элемента управления.

Название

Уникальное название элемента управления.

Тег

Простое текстовое свойство, позволяющее добавить для ЭУ скрипт (например, JSON).

Поведение

Видимость

Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.

Адаптивный

Высота (в пикселях)

Устанавливает высоту элемента Препросмотр файла в пикселях.

Дополнительные css классы

Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.

Комментарии

Включает или выключает возможность комментирования файла.

Переходить по TAB

Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.

Раскрывать файл

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

Если элемент Список файлов содержит несколько файлов, при включенном свойстве Раскрывать файл будет отображаться первый файл по списку.

Стандартный css класс

Название CSS класса, в котором определён стандартный стиль элемента управления.

Ширина по умолчанию (в процентах)

Ширина элемента в процентах относительно родительского элемента.

События

Перед открытием/сокрытием блока комментариев

Вызывается перед открытием и закрытием блока комментариев.

Перед открытием/сокрытием окна

Вызывается перед закрытием окна предпросмотра.

Перед скачиванием файла

Вызывается при нажатии кнопки загрузки файла на компьютер.

Перед сменой файла

Вызывается перед сменой отображаемого файла.

После открытия/сокрытия блока комментариев

Вызывается после открытия и закрытия блока комментариев.

После открытия/сокрытия окна

Вызывается после закрытия окна предпросмотра.

После скачивания файла

Вызывается после нажатия кнопки загрузки файла на компьютер.

После смены файла

Вызывается после смены отображаемого файла.

При наведении курсора

Вызывается при входе курсора мыши в область элемента управления.

При отведении курсора

Вызывается, когда курсор мыши покидает область элемента управления.

При щелчке

Вызывается при щелчке мыши по любой области элемента управления.