remo · документация
AI EN

Комната и объекты: слои, координаты, выделение

Из чего состоит комната, как объекты располагаются и почему одни перемещаются свободно, а другие живут в ячейке.

Статус: доступно обновлено 2026-11-04

Модель

Комната — это документ с объектами. У объекта есть идентификатор, тип, размер, положение и, для текстовых типов, текст. Тип определяет поведение: стикер перемещается свободно, карточка живёт в ячейке канбана, связь соединяет два объекта.

Тип Перемещается Содержит текст Может быть концом связи
Стикер да да да
Фигура да да да
Текст да да да
Фрейм да нет нет
Канбан да нет нет
Карточка внутри ячейки да (заголовок) да, через ячейку
Связь нет да нет

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

Слои и порядок

Объекты лежат слоями: канбан и фреймы — ниже, стикеры и фигуры — выше, текст — поверх всего. Порядок задан типом, а не тем, что вы перетащили последним. Поэтому подпись не оказывается под стикером случайно.

Координаты и камера

Мир комнаты бесконечен. Камера задаёт, что видно: положение и масштаб. Объект, вышедший за экран, не теряется — он остаётся на своём месте в мире, а камера просто смотрит в другую точку. Из этого следует практическое правило: не двигайте камеру, чтобы «вернуть» объект — используйте масштаб и обзор.

Выделение

Выделение — это временный набор объектов: он не хранится в комнате, и другие участники его не видят. Поэтому:

  • рамка выделения захватывает то, что попало внутрь; если оба конца связи попали в рамку, связь входит в выделение вместе с ними;
  • удаление, перемещение и выравнивание действуют на весь набор;
  • выделение переживает перерисовку и не зависит от того, кто ещё смотрит на комнату.

Связь, у которой один конец вне выделения, не добавляется: линия без второго объекта — не отдельный объект, а разорванное отношение. Копирование и экспорт применяют то же правило.

Фреймы и канбан

Фрейм — контейнер: объект внутри него двигается вместе с ним. Канбан — сетка ячеек: карточка принадлежит колонке и swimlane, и её положение задаётся порядком в ячейке, а не координатами на холсте. Это разные модели, и интерфейс ведёт себя по-разному.

Чего здесь нет

  • Прав на отдельный объект. Комната — единица доступа; замок только координирует правки и не является ACL.
  • Вложенных комментариев. Тред плоский: корень и ответы.
  • Упоминаний и уведомлений в комментариях.
  • Слоёв с независимым скрытием. Порядок есть, видимость слоя — нет.

Что ещё есть у объекта

Возможность Где живёт
Статус, исполнитель, диапазон дат поля карточки; колонка канбана — отдельное место
Теги словарь комнаты, у объекта — tagIds
Ссылка одно поле: внешний URL или другой объект комнаты
Замок флаг и автор; снять может автор или менеджер комнаты
Комментарии серверный тред с якорем на объект или точку
Имя и ID необязательное имя до 120 символов; ID только для чтения и копирования
Реакции живая волна у курсора; нигде не хранится

Куда дальше

/guide/capabilities/canvas — что даёт холст и где его предел.