Модель
Комната — это документ с объектами. У объекта есть идентификатор, тип, размер, положение и, для текстовых типов, текст. Тип определяет поведение: стикер перемещается свободно, карточка живёт в ячейке канбана, связь соединяет два объекта.
| Тип | Перемещается | Содержит текст | Может быть концом связи |
|---|---|---|---|
| Стикер | да | да | да |
| Фигура | да | да | да |
| Текст | да | да | да |
| Фрейм | да | нет | нет |
| Канбан | да | нет | нет |
| Карточка | внутри ячейки | да (заголовок) | да, через ячейку |
| Связь | нет | да | нет |
Стикер, текст, фигура и фрейм меняют размер угловыми маркерами. У стикера и фигуры текст подстраивается под прямоугольник, у фрейма содержимое сохраняет размер, а принадлежность пересчитывается по центру. Подробнее — фреймы и канбан и холст.
Слои и порядок
Объекты лежат слоями: канбан и фреймы — ниже, стикеры и фигуры — выше, текст — поверх всего. Порядок задан типом, а не тем, что вы перетащили последним. Поэтому подпись не оказывается под стикером случайно.
Координаты и камера
Мир комнаты бесконечен. Камера задаёт, что видно: положение и масштаб. Объект, вышедший за экран, не теряется — он остаётся на своём месте в мире, а камера просто смотрит в другую точку. Из этого следует практическое правило: не двигайте камеру, чтобы «вернуть» объект — используйте масштаб и обзор.
Выделение
Выделение — это временный набор объектов: он не хранится в комнате, и другие участники его не видят. Поэтому:
- рамка выделения захватывает то, что попало внутрь; если оба конца связи попали в рамку, связь входит в выделение вместе с ними;
- удаление, перемещение и выравнивание действуют на весь набор;
- выделение переживает перерисовку и не зависит от того, кто ещё смотрит на комнату.
Связь, у которой один конец вне выделения, не добавляется: линия без второго объекта — не отдельный объект, а разорванное отношение. Копирование и экспорт применяют то же правило.
Фреймы и канбан
Фрейм — контейнер: объект внутри него двигается вместе с ним. Канбан — сетка ячеек: карточка принадлежит колонке и swimlane, и её положение задаётся порядком в ячейке, а не координатами на холсте. Это разные модели, и интерфейс ведёт себя по-разному.
Чего здесь нет
- Прав на отдельный объект. Комната — единица доступа; замок только координирует правки и не является ACL.
- Вложенных комментариев. Тред плоский: корень и ответы.
- Упоминаний и уведомлений в комментариях.
- Слоёв с независимым скрытием. Порядок есть, видимость слоя — нет.
Что ещё есть у объекта
| Возможность | Где живёт |
|---|---|
| Статус, исполнитель, диапазон дат | поля карточки; колонка канбана — отдельное место |
| Теги | словарь комнаты, у объекта — tagIds |
| Ссылка | одно поле: внешний URL или другой объект комнаты |
| Замок | флаг и автор; снять может автор или менеджер комнаты |
| Комментарии | серверный тред с якорем на объект или точку |
| Имя и ID | необязательное имя до 120 символов; ID только для чтения и копирования |
| Реакции | живая волна у курсора; нигде не хранится |
Куда дальше
/guide/capabilities/canvas — что даёт холст и где его предел.