Раскрывающиеся блоки (Toggle)

Раскрывающиеся блоки (toggles) позволяют скрыть контент за заголовком. Читатель разворачивает блок одним кликом. Отлично подходят для FAQ, дополнительных деталей и необязательного для всех контента.

Создание

• Slash-меню: /toggle → Enter
• Markdown: введите > (стрелка + пробел) в начале строки

Структура

Toggle-блок состоит из двух частей:

1. Заголовок — всегда виден, кликабелен
2. Содержимое — скрыто по умолчанию, разворачивается при клике

В содержимое можно вложить любые блоки: абзацы, код, списки, изображения, таблицы и даже другие toggle-блоки.

Вложенные toggles

▶ Установка
  ▶ macOS
    1. Скачайте .dmg файл
    2. Перетащите в Applications
  ▶ Windows
    1. Запустите инсталлятор
    2. Следуйте инструкциям

Вложенность любая, но рекомендуем не более 3 уровней — иначе структура становится сложной для чтения.

Состояние по умолчанию

По умолчанию все toggle-блоки закрыты при открытии статьи. Это делает длинные статьи с FAQ компактными. Читатель видит список вопросов и раскрывает нужный.

Примеры использования

FAQ-раздел

▶ Как сбросить пароль?
  Перейдите в Settings → Security → Change Password...

▶ Сколько участников можно пригласить?
  На тарифе Team — до 25 участников. Enterprise — без ограничений.

▶ Как экспортировать данные?
  Используйте Settings → Export → Download JSON...

Дополнительные детали

В технических статьях toggle удобен для сворачивания деталей реализации, которые нужны не всем читателям:

▶ Технические детали (для разработчиков)
  PowerSync использует CRDTs для разрешения конфликтов...

Toggle-блоки индексируются поиском. Скрытый контент внутри toggle находится при поиске по базе знаний.