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