Оглядач

Оглядач — це панель, закріплена біля лівого краю полотна 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 згортає один рівень за кожне натискання: найглибший рівень показаних розгорнутих рядків, тож натискання згортають дерево знизу вгору. Натискання, що доходить до верхнього рівня, згортає всі рядки, зокрема ті, що під уже згорнутим рядком, і залишає лише папки верхнього рівня.
Редагування, відміна й повторення, а також зміни від співавторів чи агента для програмування не змінюють згортання.

Перехід до рядка

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

• Рядок таблиці або таблиці, переліченої під групою, виділяє лише цю таблицю й виводить її на передній план. Клітинка у фокусі переходить на назву таблиці, хіба що вона вже перебуває в цій таблиці.
• Рядок стовпця виділяє лише його таблицю й переводить клітинку у фокусі на назву стовпця.
• Рядок індексу виділяє його таблицю, як і рядок таблиці. Сам індекс не виокремлюється; індекси редагуються у вікні властивостей таблиці.
• Рядок зовнішнього ключа показує в області перегляду обидві таблиці зв’язку разом або дочірню таблицю, коли вони надто далеко одна від одної, щоб показати їх разом. Він виділяє лише дочірню таблицю з її стовпцями зовнішнього ключа, переводить клітинку у фокусі на перший із них і підсвічує лінію зв’язку — див. як читати лінію зв’язку.
• Рядок групи таблиць показує в області перегляду рамку групи, орієнтуючись на її смугу заголовка, виділяє лише групу й виводить її на передній план разом з її таблицями.
• Рядок нотатки виділяє лише нотатку й виводить її на передній план.

Область перегляду зсувається за правилом, спільним для всіх переходів: масштаб ніколи не змінюється, а полотно прокручується, лише коли те, до чого ви переходите, ще не видно як слід, — див. куди веде перехід.
Перехід до рядка спершу закриває вікно властивостей таблиці, якщо воно відкрите, і ніколи не починає й не завершує малювання зв’язку.
Поки в полі пошуку є текст, рядок, у власній назві якого є збіг, або рядок, що показує уривок коментаря чи нотатки, натомість переходить до цього збігу — див. перехід до збігу.

Після клацання фокус клавіатури залишається в дереві, тож Delete, Backspace та інші клавіші редагування не діють на нове виділення, доки ви не натиснете Escape або не клацнете полотно, — див. клавіші в оглядачі.

Клавіші в оглядачі

Дерево — це одна зупинка для 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.
Його пошук лише знаходить — див. режим лише для читання на сторінці пошуку й заміни.