Статьи

Что видно с края листа: как показать связи с двадцатью соседними листами

Разложить большую схему по листам — полдела. Как только у листа появляются соседи, встаёт вопрос: что показывать на его краях? Если ничего — связи обрываются. Если всё — край листа превращается в тот самый клубок, от которого уходили. Разбираем, как этот вопрос решён в PlyLoom 0.9.1 и почему рамка устроена именно так.

Лист без краёв

В учебном проекте «Запуск приложения» на листе «Обзор запуска» всего пять узлов: цель, дата релиза, объём первой версии, бюджет и главные риски. Если смотреть на лист отдельно, это пять карточек на пустом поле. Не видно, что «Объём первой версии» опирается на требования, дизайн и локализацию, а «Цель» поддерживают маркетинг, поддержка и исследования.

Лист «Обзор запуска» без рамки: пять карточек на пустом поле, связей с другими листами не видно
Тот же лист с выключенной рамкой: пять узлов, и ни одной связи с остальным проектом.

При этом лист «Обзор запуска» связан с 24 другими листами, и на его краю 50 карточек чужих узлов. Показать их все рядом с листом нельзя: не останется места для самого листа. Не показывать — значит потерять то, ради чего схему раскладывали по листам: видеть одну часть темы, не теряя её связей с остальными.

В версии 0.8 связь с узлом другого листа показывалась пунктирной стрелкой к карточке за границей листа. Для двух-трёх соседей этого хватало. Но с ростом проекта у края листа собирались десятки карточек, и вопрос «что показывать на краю» пришлось решать заново.

Лист «Обзор запуска» с рамкой: открытые группы соседних листов, свёрнутые плашки и «Ещё 8 листов»
Тот же лист в версии 0.9.1. Вокруг — рамка: пять групп открыты, остальные свёрнуты в плашки, восемь самых слабо связанных листов ушли в «Ещё».

Рамка: лист внутри паспарту

Вокруг листа — рамка, прибитая к краям окна, а не к листу. Лист двигается и масштабируется внутри «окошка», рамка стоит на месте. На рамке лежат узлы других листов, связанные с этим, — по группе на каждый соседний лист. От узлов листа к карточкам на рамке идут пунктирные линии, а щелчок по карточке открывает сам узел на его листе.

Схема рамки: лист в центре окна, слева два ряда групп и плашек, справа один ряд, сверху плашки, снизу открытая группа и «Ещё 8 листов»; размеры листа — не меньше 60 % окна
Как устроена рамка. Номера на схеме — по списку ниже.
  1. Открытая группа — узлы одного соседнего листа. Показывает до шести карточек, остальные прокручиваются колесом, счётчик ↑ ↓ говорит, сколько скрыто.
  2. Плашка — свёрнутая группа: название листа и число узлов. Пунктирная обводка — свернула рамка, потому что не хватило места; сплошная — свернули вы.
  3. «Ещё N листов» — на рамке не больше 16 листов: сначала выбранные вручную, потом самые связанные. Остальные ждут здесь.
  4. Стороны. Входящие связи тянут группу влево и вверх, исходящие — вправо и вниз. На стороне не больше двух рядов.
  5. Линии идут от узлов листа к карточкам на рамке; к видимым карточкам — всегда.
  6. Лист занимает не меньше 60 % ширины и высоты окна. В маленьком окне рамка уменьшается целиком — до 90 и 80 %.

Главное правило — лист важнее рамки. Сначала листу отдаются его 60 %, и только остаток делится между группами. Если групп больше, чем помещается, рамка уступает по шагам: сворачивает в плашки столько групп, сколько нужно; потом оставляет на рамке 16 листов, а остальные убирает в «Ещё»; и только если не помещаются даже группы, развёрнутые вручную, показывает соседей списком справа.

Какая группа на какой стороне

Каждая сторона рамки для группы «стоит» по-разному. Цена складывается из того, где на листе стоят связанные с ней узлы, и небольшой поправки на направление связей: то, что втекает в лист, тянется влево и вверх, то, что вытекает, — вправо и вниз. Верх и низ дороже боков: экраны широкие, и высота дефицитнее ширины.

Есть и вторая сила: новая полоса на рамке дороже места в уже открытой. Поэтому рамка не всегда ставит группу на её «идеальную» сторону — иногда выгоднее дописать её в полосу, которая уже есть, и оставить листу больше места. Если результат не нравится, группу можно перетащить за заголовок вдоль стороны или на другую сторону. Пока тянете, рамка показывает, куда группа встанет, а остальные остаются на своих сторонах.

Анимация: группу «Релиз» перетаскивают с верхней стороны рамки на правую, рамка перестраивается на ходу
Группу «Релиз» тянут за заголовок с верхней стороны на правую. Рамка показывает место заранее и перестраивается на ходу.

Ручной выбор сохраняется в файле проекта. В настоящей карте Правил продажи, о которой рассказывает статья про сравнение редакций, на листе «Изменения» группы «было» перенесены налево, а «стало» — направо. Теперь лист читается слева направо: старая редакция → изменение → новая редакция и требования.

Лист «Изменения» карты Правил продажи: слева на рамке пункты прежней редакции, справа пункты новой редакции и требования
Группы, расставленные вручную, отмечены значком ⟲: он возвращает группе автоматическое место.

Когда соседей больше, чем места

Свёрнутая плашка — не тупик. Щелчок по ней раскрывает группу прямо на рамке, если остальные группы могут сохранить свои стороны. Свернуться при этом могут только автоматические группы, а в «Ещё» уйдут не больше трёх листов — и подсказка над листом их назовёт. Если места нет совсем, группа откроется поверх листа, и кнопка «Развернуть в рамке» закрепит её открытой.

Плашка «Требования» раскрыта на нижней стороне рамки: пять карточек, остальные группы свёрнуты в плашки
Плашку «Требования» раскрыли щелчком: группа встала на нижнюю сторону, а автоматические группы свернулись, чтобы освободить место.

«Ещё N листов» открывает список справа: сверху листы, которые сейчас в «Ещё», ниже — те, что на рамке. Кнопка «на рамку» ставит лист плашкой и закрепляет его; если места нет, его уступит самый слабо связанный лист и вернётся первым, как только место появится. Кнопка «в «Ещё»» убирает лист с рамки. Подсказка над листом говорит, кто уступил место и кто вернулся.

Список соседних листов справа: восемь листов в «Ещё» с кнопками «на рамку», ниже 16 листов на рамке с кнопками «в «Ещё»»
Список справа: 8 листов в «Ещё» и 16 на рамке. Кнопка «Рамкой» возвращает обычный вид.

Линии тоже пришлось дозировать. К каждой видимой карточке линия идёт всегда. К плашкам и прокрученным карточкам — пока таких линий не больше 80, от каждого узла. Дальше — по одной линии к плашке от её главного узла, а все линии — при наведении и у выделенного узла. При совсем большом числе — только у выделенного.

Раскладка, которая не прыгает

Самое важное свойство рамки — без ваших действий она ничего не двигает. Новый соседний лист, изменение размера окна или открытая боковая панель не перекидывают группы на другие стороны, а лист, ушедший в «Ещё», помнит свою сторону. Заново рамку раскладывают только три команды: «вписать», «Оптимизировать расположение» и «Сбросить ручные».

Добиться этого оказалось сложнее, чем разложить группы один раз. Рамка запоминает, что было на прошлом кадре: стороны групп, какие из них были открыты, кто уступил место. Следующая раскладка строится от этой памяти. Но жадный алгоритм может оставить незамеченное место, и тогда следующий же кадр «улучшит» раскладку сам — группы прыгнут без всякой причины. Поэтому результат доводится до неподвижной точки: раскладка повторяется от своей собственной памяти, пока ничего не меняется. Обычно хватает пары проходов, а промежуточные варианты на экран не попадают.

Что сохраняется в файле, а что живёт только на экране, разделено явно. Ручной выбор — место группы и её состояние — пишется в лист, в поле externals, по ключу соседнего листа:

"externals": {
  "s2020_general": { "side": "left",  "along": 0.3 },
  "s2026_general": { "side": "right", "along": 0.18 },
  "s2020_goods":   { "state": "parked" }
}

Здесь side — сторона рамки, along — место вдоль стороны в долях её длины (от 0 до 1, поэтому выбор переживает другой размер окна), state — open, folded или parked («в «Ещё»»). Список справа, прокрутка групп и память раскладки живут только на экране, пока открыто приложение. «Оптимизировать расположение» сбрасывает места, но оставляет состояния: они говорят, что показывать, а не где.

Меню «Боковые» и фильтр «Листы»

Кнопка «Боковые N ▾» в заголовке листа управляет рамкой целиком: левая часть включает и выключает карточки соседних листов, стрелка открывает меню. В меню — галочки листов на рамке, «Свернуть все», «Сбросить ручные» и «Списком справа». Снятый лист уходит с рамок всех листов и освобождает место. Те же галочки есть в «Фильтре», в разделе «Листы»: отметка «и в обзоре листов» прячет снятые листы и там, а сохранённый вид помнит этот выбор.

Меню «Боковые»: «Показывать боковые переходы», галочки 24 листов на рамке, кнопки «Свернуть все», «Сбросить ручные» и «Списком справа»
Меню «Боковые»: какие листы на рамке, свернуть всё, сбросить ручной выбор, показать списком.

Связи — прямо к рамке

Раз соседние узлы лежат на рамке, к ним можно тянуть связи. При наведении на карточке появляются четыре точки по краям. Потяните за любую к другому узлу — на том же листе, в соседнем окне разворота или к карточке на рамке — и связь создана. Отпустите на пустом месте — появится новый связанный узел. Точка только «ручка»: линия сама выбирает сторону и перестраивается, когда узлы двигаются.

Анимация: связь тянут от точки на краю карточки «Метрика» к карточке «API-01» в группе на рамке
Связь от узла листа к карточке на рамке: тянуть за точку, отпустить на цели. Подходящая цель подсвечивается.

Связь теперь выделяется щелчком по линии. Рядом открывается панель: тип связи, подпись, «Со стрелкой» и «Удалить связь». Del удаляет выделенную связь или узел; узел, стоящий на нескольких листах, удаляется только после вопроса. «Отменить» возвращает всё.

Выделенная связь и её панель: тип «см.», подпись «раскрывается в», отметка «Со стрелкой», кнопка «Удалить связь»
Щелчок по линии выделяет связь: тип, подпись и стрелка меняются в панели рядом, Del удаляет.

Что ещё нового в 0.9–0.9.1

  • Отменить и повторить — кнопки и Ctrl+Z, Ctrl+Shift+Z, Ctrl+Y (на Mac — ⌘), до 100 шагов.
  • «+» на карточке разворачивает её для чтения, соседи на экране отодвигаются; карандаш ✎ открывает редактор поверх карты.
  • Обзор листов: «Только для выделенного» показывает связи одного узла или листа, листы сворачиваются до заголовка.
  • Разворот: новые композиции — два и три листа друг под другом; на телефоне окна идут друг под другом и листаются вниз.
  • Палитра узлов по группам — основные, свои типы, блок-схема, BPMN, Canvas — с поиском; тип перетаскивается прямо на лист.
  • Руководство внутри приложения: 34 статьи от общего к частному, с поиском и ссылками «См. также». Тот же текст — на сайте.
Руководство внутри приложения: поиск по слову «плашка» нашёл статью «Рамка и группы»
«Справка → Руководство»: поиск по слову «плашка» сразу ведёт к статье о рамке.

Что пока не решено

  • «Ещё» — это снова список. Рамка честно показывает до 16 листов, но если у листа сорок соседей, большая часть из них живёт в списке. Возможно, такому листу стоит разделиться.
  • Пороги — 60 % окна, 16 листов, 6 карточек, 80 линий — подобраны на учебных картах и прототипе. На других картах они могут оказаться не лучшими.
  • На телефоне рамка и разворот работают, но экран маленький: заметная его часть уходит под панели инструментов.

Если у вас есть карта, на которой рамка ведёт себя странно, — поделитесь ею: из таких случаев и получаются следующие правила.

Эта статья с обсуждением — на Хабре: «Как показать 24 соседних листа? Паспарту спешит на помощь».

Скриншоты сняты с версии 0.9.1. «Запуск приложения» и «Разработка: экспорт отчёта» — учебные карты, карта Правил продажи — настоящая, изменения на ней заполнены для иллюстрации.

Читайте также

PlyLoom 0.14: больше места для работы

Карте отдано почти всё окно: верх сворачивается, карточки как в draw.io, паспарту в трёх состояниях, картинки в узлах и рассказ по шагам.

На арене PlyLoom: Qwen против DeepSeek

Две модели, один вопрос, две карты: что карта показывает сразу — дубли, открытые вопросы — и почему PlyLoom 0.14 спрашивает, откуда брать факты.