---
title: "JSON-конфиги PDF.js: формат и порядок применения - WebTolk"
description: "Корень — плоский объект с именами параметров PDFViewerApplicationOptions (AppOptions) версии 6.4.299. Записывайте параметры непосредственно в корневой…"
url: "https://web-tolk.ru/dev/joomla-plugins/wt-pdf-js/documentation/json-format"
date: "2026-10-09T20:15:14+00:00"
language: "ru-RU"
---

## Breadcrumbs

[Главная](https://web-tolk.ru/) > [Расширения Joomla](https://web-tolk.ru/dev) > [Плагины Joomla](/dev/joomla-plugins) > [WT PDF.js](/dev/joomla-plugins/wt-pdf-js) > [Документация](/dev/joomla-plugins/wt-pdf-js/documentation) > JSON-конфиги PDF.js: формат и порядок применения

# JSON-конфиги PDF.js: формат и порядок применения

WT PDF.js - Документация

**Категория:** [Плагины Joomla](https://web-tolk.ru/dev/joomla-plugins)

[Проект](https://web-tolk.ru/dev/joomla-plugins/wt-pdf-js)[Версии](https://web-tolk.ru/dev/joomla-plugins/wt-pdf-js/versions)[Документация](https://web-tolk.ru/dev/joomla-plugins/wt-pdf-js/documentation)[GitHub](https://github.com/mozilla/pdf.js)

Корень — плоский объект с именами параметров PDFViewerApplicationOptions (AppOptions) версии 6.4.299.

## Проверка параметров и их приоритет

Корень — плоский объект с именами параметров `PDFViewerApplicationOptions` (AppOptions) версии 6.4.299. Записывайте параметры непосредственно в корневой объект, без обёрток options/viewer/pdfjs. Комментарии и завершающие запятые в JSON недопустимы; для файла используйте кодировку UTF-8 без BOM.

- Принимаются известные строки, числа и boolean с правильным типом: `"2"` не равно `2`, `"false"` не равно `false`.
- Исключение для объекта: `localeProperties: {"lang":"ru"}`. Применяется только lang.
- Неизвестные имена и неверные типы пропускаются с предупреждением. viewerCssTheme проверяется на 0, 1, 2; для остальных числовых enum используйте справочник: все диапазоны загрузчик не проверяет.
- Параметры с null по умолчанию, runtime-объекты, функции и workerPort не настраиваются JSON. API-параметр rangeChunkSize отсутствует в AppOptions viewer и профилем не принимается.
- Не редактируйте app_options.js, viewer.mjs и pdf.mjs: профиль применяется до запуска viewer.

Сначала используются значения PDF.js, затем допустимые значения JSON. Для активного профиля принудительно включается `disablePreferences=true`: браузерные Preferences не заменяют профиль. Даже пустой `{}` включает это правило. `disablePreferences=false` в JSON игнорируется; для обычных Preferences используйте `config=none`. Если непустой профиль содержит только отклонённые параметры и не содержит disablePreferences, стандартное поведение Preferences сохраняется.

Preferences и история состояния конкретного PDF — разные механизмы. `viewOnLoad=0` допускает восстановление страницы, масштаба и режимов документа. Для открытия с начальными значениями профиля задайте `viewOnLoad=1`. Явный fragment `#page=3&zoom=150` по-прежнему задаёт страницу/масштаб и может перекрывать профиль. JSON задаёт стартовое поведение; кнопки и действия пользователя он не блокирует.

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/dev",
                "name": "Расширения Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/dev/joomla-plugins",
                "name": "Плагины Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/dev/joomla-plugins/wt-pdf-js",
                "name": "WT PDF.js"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "@id": "/dev/joomla-plugins/wt-pdf-js/documentation",
                "name": "Документация"
            }
        },
        {
            "@type": "ListItem",
            "position": 6,
            "item": {
                "name": "JSON-конфиги PDF.js: формат и порядок применения"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/dev/joomla-plugins/wt-pdf-js/documentation/json-format",
            "name": "JSON-конфиги PDF.js: формат и порядок применения - WebTolk",
            "description": "Корень — плоский объект с именами параметров PDFViewerApplicationOptions (AppOptions) версии 6.4.299. Записывайте параметры непосредственно в корневой…",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "JSON-конфиги PDF.js: формат и порядок применения",
            "url": "https://web-tolk.ru/dev/joomla-plugins/wt-pdf-js/documentation/json-format",
            "description": "Корень — плоский объект с именами параметров PDFViewerApplicationOptions (AppOptions) версии 6.4.299.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/joomla-plugins/wt-pdf-js/documentation/json-format"
            }
        }
    ]
}
```
