Обозреватель

Обозреватель — это панель, закрепленная у левого края холста ERD, в которой диаграмма представлена в виде дерева: таблицы, каждая со своими столбцами, индексами и внешними ключами, затем группы таблиц, затем заметки. Щелкните строку, чтобы перейти на холсте к тому, что она обозначает.
Обозреватель сужает холст, а не перекрывает его. Он входит в редактор диаграмм и не является ни представлением Explorer в VS Code, ни проводником файлов Obsidian.

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

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

Открытие и закрытие

Откройте его любым из этих способов:

• Кнопка Explorer на панели инструментов, сразу после кнопки Search, со значком дерева. Ее всплывающая подсказка: Explorer (Ctrl + F) (Windows/Linux) или Explorer (⌘ + F) (Mac).
• Ctrl + F (Windows/Linux) или ⌘ + F (Mac) — сочетание клавиш, которое на вкладке «Сочетания клавиш» в Настройках называется Toggle Explorer.
• Пункт Toggle Explorer в Быстром поиске, доступный на любой вкладке. Он появляется, если ввести find, replace, rename, tree, outline или objects.
• Пункт Toggle Explorer в контекстном меню холста: щелкните правой кнопкой мыши пустое место на холсте ERD за пределами групп таблиц. Он расположен после пунктов New Table, New Memo и New Table Group, перед пунктом Relationship.

Оба пункта Toggle Explorer показывают сочетание клавиш справа.
Кнопка на панели инструментов, сочетание клавиш и пункт в Быстром поиске работают на любой вкладке. На вкладке «Визуализация», «Схема SQL», «Генератор кода» или «Настройки» они сначала переключают на вкладку ERD, так как Обозреватель отображается только на ней.

Кнопка на панели инструментов только открывает и закрывает панель. Она не переводит курсор ввода в поле поиска и оставляет открытыми окно «Свойства таблицы», конструктор темы и окно выбора Display Language.
Сочетание клавиш и оба пункта Toggle Explorer открывают поиск в Обозревателе: курсор ввода переходит в поле поиска, текст в нем выделяется, а любое из пяти окон, перечисленных в разделе Окна рядом с Обозревателем, закрывается. Что поиск сохраняет между открытиями, описано в разделе Открытие и закрытие на странице «Поиск и замена».
Сочетание клавиш ничего не делает, пока редактируется ячейка таблицы, заметка или имя группы таблиц.

Кнопка на панели инструментов выглядит нажатой, пока Обозреватель открыт на вкладке ERD и не скрыт режимом дзен. В это время кнопка, сочетание клавиш и любой из пунктов Toggle Explorer закрывают Обозреватель, а если фокус клавиатуры был в панели, он возвращается в редактор.
Сочетание клавиш никогда не закрывает его, пока открыт Быстрый поиск или одно из пяти окон. Вместо этого оно закрывает палитру или окно и переводит фокус клавиатуры в поле поиска, при этом текст в поле выделяется, а если Обозреватель уже был показан, текущее совпадение сохраняется. Пункт Toggle Explorer в Быстром поиске такого исключения не делает: при выполнении он закрывает палитру, а затем и открытый Обозреватель.

Кнопка x в строке заголовка со всплывающей подсказкой Close тоже закрывает Обозреватель и передает фокус клавиатуры холсту. Клавиша Escape его не закрывает — см. Клавиши в Обозревателе.
При повторном открытии Обозреватель возвращается с той же шириной, с деревом, свернутым и прокрученным так же, как прежде, и с тем же запросом. Если открыть его сочетанием клавиш или пунктом Toggle Explorer, он заново выполняет поиск по этому запросу, и все результаты оказываются развернутыми, — см. Результаты.

Если сочетание клавиш или пункт Toggle Explorer открывает Обозреватель в редакторе, слишком узком для него, появляется уведомление Widen the window to show the Explorer, а фокус клавиатуры остается на месте — см. Рядом с холстом.
Тем не менее Обозреватель открыт, кнопка на панели инструментов нажата, и, как только редактор становится достаточно широким, он появляется с уже выполненным поиском, не забирая фокус клавиатуры. Если открыть его кнопкой на панели инструментов, уведомление не появляется.

Рядом с холстом

Обозреватель расположен у левого края вкладки ERD, под панелью инструментов, и занимает всю высоту холста.
Холст сужается, освобождая для него место, поэтому никакая часть диаграммы не оказывается под панелью, а панель инструментов холста, мини-карта и экран приветствия располагаются на холсте рядом с ним.
Открытие, закрытие или изменение размера Обозревателя не прокручивает диаграмму и ничего не записывает в историю изменений.

Во вновь открытом редакторе его исходная ширина — 260px. Перетащите его правый край, чтобы задать любую ширину от 200px до 480px, или дважды щелкните край, чтобы вернуть 260px.

Рядом с Обозревателем у холста всегда остается не меньше 320px:

• В редакторе, ширина которого меньше ширины Обозревателя плюс 320px, Обозреватель отображается более узким, чтобы поместиться, — вплоть до 200px.
• В редакторе шириной меньше 520px он уступает место холсту. Он не отображается, но остается открытым, поэтому кнопка на панели инструментов по-прежнему выглядит нажатой, а нажатие на нее закрывает его. Как только редактор становится достаточно широким, он возвращается со своей собственной шириной.

Значение имеет ширина самого редактора, а не окна браузера, хотя в уведомлении из раздела Открытие и закрытие говорится об окне.

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

Когда Обозреватель скрывается

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

Пока открыт просмотр различий, путешествие во времени или предварительный просмотр Автоматического размещения, ничто не открывает и не закрывает Обозреватель:

• Открытый Обозреватель скрывается и снова отображается, как только они закрываются.
• Кнопка на панели инструментов приглушена и ничего не делает.
• В Быстром поиске нет пункта Toggle Explorer.
• Сочетание клавиш передается браузеру или хосту — см. Панель поиска браузера.

Просмотр различий показывает свои изменения в дереве того же вида — см. Просмотр различий.

Включение режима дзен с помощью Alt + Z (Windows/Linux) или ⌥ + Z (Mac) скрывает открытый Обозреватель, не закрывая его, а выключение режима дзен возвращает Обозреватель.
В режиме дзен сочетание клавиш и оба пункта Toggle Explorer по-прежнему открывают поиск в Обозревателе, а режим дзен остается включенным. Тогда Обозреватель занимает всю высоту редактора, так как верхней панели инструментов нет, и остается видимым после выключения режима дзен. Повторное включение режима дзен снова скрывает его.

Всякий раз, когда панель исчезает, пока в ней фокус клавиатуры, — закрывается ли она, скрывается или уступает место холсту, — фокус клавиатуры возвращается в редактор.

Дерево

В строке заголовка написано Explorer и есть две кнопки: Collapse All и кнопка x, закрывающая Обозреватель. Под ней находится поиск — см. Поиск и замена, — а под ним дерево.

На верхнем уровне находятся три папки в таком порядке: Tables, Table Groups и Memos. Под каждой таблицей находятся ее собственные папки Columns, Indexes и Foreign Keys.
Папка, в которой ничего нет, не отображается, поэтому для пустой диаграммы не отображается ни одной строки. Папка Table Groups также не отображается, пока View Option → Table Groups скрывает группы, а папка Memos — пока View Option → Memos скрывает заметки.
В строке папки отображаются значок папки, ее имя, а в самом конце — число строк непосредственно под ней, поэтому число рядом с Tables равно количеству таблиц в диаграмме.

Таблицы упорядочены по имени без учета регистра, а таблицы с одинаковыми именами идут в порядке документа. Так же упорядочены группы таблиц и таблицы внутри каждой группы. Столбцы таблицы идут в порядке самой таблицы, а ее индексы, ее внешние ключи и заметки — в порядке документа.
Дерево обновляется вместе с диаграммой, что бы ее ни изменило: правка на холсте, отмена или повтор, импорт, соавтор или агент для программирования, — поэтому при переименовании таблицы ее строка перемещается.

Строка каждого вида показывает:

• Таблица: значок таблицы и ее имя.
• Столбец: значок ключа у столбца первичного или внешнего ключа — того же цвета, каким ячейка ключа в самой таблице выделяет первичный ключ, внешний ключ или оба сразу, — и значок списка у любого другого столбца. Затем имя столбца и приглушенным текстом — его тип данных, а за ним PK, FK или оба, например id BIGINT PK или user_id BIGINT FK.
• Индекс: значок индекса и его имя. Затем приглушенным текстом — UNIQUE у уникального индекса и его столбцы в скобках в порядке индекса, с DESC после столбца с сортировкой по убыванию, например orders_user_idx UNIQUE (user_id DESC, total) или просто (total).
• Внешний ключ: отображается только под дочерней таблицей, т. е. той, в которой находятся столбцы внешнего ключа, и только пока родительская таблица есть в диаграмме. Его значок ключа принимает цвет линии связи: цвет первичного и внешнего ключа у идентифицирующей связи, а в остальных случаях — цвет внешнего ключа. Строка показывает ключевые столбцы дочерней таблицы через запятую, затем приглушенным текстом — → с родительской таблицей и ее столбцами, например user_id → users(id).
• Группа таблиц: точка цвета группы, серая у группы без цвета, и ее имя. Под ней по имени перечислены ее таблицы, и каждая из них ведет к своей таблице. У группы без таблиц разворачивать нечего.
• Заметка: значок стикера и первая строка заметки.

Пустое имя или заметка с пустой первой строкой отображаются как unnamed курсивом.
На узкой панели приглушенный текст обрезается символом … раньше, чем имя. Наведите указатель на имя или приглушенный текст, чтобы увидеть его полностью.

Изначально развернута только папка Tables. Чтобы свернуть или развернуть папку, щелкните ее строку либо нажмите на ней Enter или Space.
Стрелка в начале строки сворачивает или разворачивает эту строку, никуда не переходя. Она есть у каждой строки таблицы, даже у таблицы, под которой ничего нет. Клавиши → и ← тоже сворачивают и разворачивают — см. Клавиши в Обозревателе.
Кнопка Collapse All сворачивает по одному уровню при каждом нажатии: самый глубокий из видимых уровней развернутых строк, поэтому нажатия сворачивают дерево снизу вверх. Нажатие, которое доходит до верхнего уровня, сворачивает все строки, в том числе находящиеся под уже свернутой строкой, и остаются только папки верхнего уровня.
Правки, отмена и повтор, а также изменения соавторов или агента для программирования оставляют строки свернутыми и развернутыми так, как они были.

Переход к строке

Чтобы перейти на холсте ERD к тому, что обозначает строка, щелкните ее либо, когда на ней фокус клавиатуры, нажмите Enter или Space. Строка папки только сворачивается или разворачивается, а клавиши со стрелками только перемещают фокус по дереву.

• Строка таблицы или таблица, указанная под группой, выделяет только эту таблицу и переносит ее на передний план. Фокус переходит на ячейку имени таблицы, если только он уже не находится в этой таблице.
• Строка столбца выделяет только его таблицу и переводит фокус на ячейку имени столбца.
• Строка индекса выделяет его таблицу, как и строка таблицы. Сам индекс отдельно не выделяется; индексы редактируются в окне «Свойства таблицы».
• Строка внешнего ключа выводит в область просмотра обе таблицы связи вместе или только дочернюю таблицу, если они слишком далеко друг от друга, чтобы показать их вместе. Она выделяет только дочернюю таблицу и ее столбцы внешнего ключа, переводит фокус на ячейку первого из них и подсвечивает линию связи — см. Как читать линию связи.
• Строка группы таблиц выводит рамку группы в область просмотра, ориентируясь на строку заголовка, выделяет только эту группу и переносит ее на передний план вместе с ее таблицами.
• Строка заметки выделяет только эту заметку и переносит ее на передний план.

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

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

Клавиши в Обозревателе

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

В дереве:

• Клавиши ↑ и ↓ перемещают фокус на одну строку и останавливаются на первой и последней строке, а не переходят по кругу. Клавиши Home и End переходят к первой и последней строке.
• Клавиша → разворачивает свернутую строку или переходит к первому дочернему элементу развернутой строки. Клавиша ← сворачивает развернутую строку или переходит к родительской строке. Если выбран язык интерфейса с письмом справа налево, эти две клавиши меняются ролями.
• Клавиши Enter и Space действуют как щелчок: выполняют переход по строке либо сворачивают или разворачивают папку — см. Переход к строке.
• Ввод буквы не перемещает фокус к строке.

Клавиша Escape, нажатая в любом месте Обозревателя — в дереве, в поле поиска или замены либо на одной из его кнопок, — возвращает фокус клавиатуры холсту. Обозреватель остается открытым, а выделение не меняется.
Нажатие Escape, которое завершает набор в методе ввода, только завершает набор. Клавиша Escape никогда не закрывает Обозреватель — ни при нажатии в нем, ни при нажатии на холсте.

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

• Ctrl + F (Windows/Linux) или ⌘ + F (Mac) работает так же, как на холсте: закрывает Обозреватель или, если рядом с ним открыто окно «Свойства таблицы», закрывает это окно и переводит курсор ввода в поле поиска — см. Открытие и закрытие.
• Ctrl + K (Windows/Linux) или ⌘ + K (Mac) открывает и закрывает Быстрый поиск.
• Undo и Redo отменяют и повторяют изменения диаграммы, а не текста в поле.
• Zoom In, Zoom Out и Zoom Reset изменяют масштаб холста.

Все остальные сочетания клавиш редактора не выходят за пределы Обозревателя, как и клавиши со стрелками, Tab, Enter, Space, Home, End и любая клавиша, нажатая во время набора в методе ввода.
Ни одна из этих клавиш не доходит до холста: клавиши Delete и Backspace никогда не удаляют выделенное, Alt + N (Windows/Linux) или ⌥ + N (Mac) не добавляет таблицу, а сочетание T, затем G ничего не группирует. В поле они работают как обычные клавиши ввода текста: Ctrl + A (Windows/Linux) или ⌘ + A (Mac) выделяет текст поля, Delete и Backspace стирают текст, а Space вводит пробел. Клавиша Tab перемещает фокус между кнопками, полями и деревом Обозревателя.
Клавиши самих полей поиска и замены описаны в разделе Клавиши в полях поиска.
Клавиши, которые редактор не привязывает, например собственные клавиши хоста для сохранения или вызова палитры команд, как обычно доходят до хоста.

Окна рядом с Обозревателем

Окно «Свойства таблицы», конструктор темы, окно выбора Display Language, окно Export image и окно «Сопоставить столбцы» при открытии оставляют Обозреватель открытым.

• Окно «Свойства таблицы» открывается посередине холста рядом с Обозревателем и затемняет только холст. Обозревателем по-прежнему можно пользоваться: выбор строки закрывает окно «Свойства таблицы», а затем выполняет переход к строке.
• Окна Export image и «Сопоставить столбцы» затемняют весь редактор, включая панель инструментов и Обозреватель. Обозреватель остается открытым под затемненной областью, и щелчок по нему закрывает окно, как и щелчок в любом месте затемненной области; окно «Сопоставить столбцы» в этом случае закрывается, ничего не сопоставив.
• Если выбран язык интерфейса с письмом слева направо, конструктор темы и окно выбора Display Language открываются сразу за Обозревателем, а не поверх него, и сдвигаются вслед за ним, если он открывается или закрывается, пока они показаны. При языке с письмом справа налево они остаются на своем месте справа. Нажатие в Обозревателе закрывает их, как и любое нажатие за их пределами, кроме нажатия на панели инструментов.

Открытие поиска сочетанием клавиш или пунктом Toggle Explorer закрывает все пять окон, причем окно «Сопоставить столбцы» — без сопоставления.
Быстрый поиск тоже оставляет Обозреватель открытым, и тогда клавиша Escape закрывает только палитру.

Режим только для чтения

В редакторе с атрибутом readonly Обозреватель работает так же, как в любом другом: кнопка на панели инструментов с той же всплывающей подсказкой, сочетание клавиш, оба пункта Toggle Explorer, дерево, сворачивание, кнопка Collapse All и переход к строке, который, как обычно, выделяет то, к чему ведет. Его заголовок и в этом случае — Explorer.
Поиск в нем только находит совпадения — см. раздел Режим только для чтения на странице «Поиск и замена».