Skip to content
This repository was archived by the owner on Oct 9, 2020. It is now read-only.

Hint Display

yaromir edited this page Mar 23, 2013 · 17 revisions

Выбор варианта отображения хинтов

Вариант 1. Разворачивание строки

Забраковано заказчиком.

Assigned to: SamWot

Issue #6

По аналогии со свертыванием кода в различных IDE. Участок, к которому есть хинт, становится unfoldable. При разворачивании под участком текста отображается его хинт.

Резюме

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

+:

  • Простой способ.

-:

  • Сложно сделать редактирование хинтов.

Вариант 2. Панель справа

Assigned to: SamWot

Issue #14

При наведении на строку, имеющую хинт, отображение хинта в панели справа, как это сделано, например, в Word.

Резюме

Вариант по аналогии с миникартой не подходит - она реализована в базовом ядре Sublime.

Но можно сделать по примеру панелей в плагине Web Inspector:

https://github.com/Snowball239/SublimeHints/wiki/Useful-Links


Вариант 3. Отображение в окне снизу

Assigned to: Snowball239

Issue #11

Отображать в окне снизу кусок текста и относящийся к нему хинт.

Резюме

Сделано отображение всех хинтов в панели внизу.

+:

  • Удобный способ

-:

?


Вариант 4. Генерация html и отображение в браузере

Assigned to: east825

Issue #1

Issue #16

По какой-нибудь горячей клавише генерируется html и css, который отображается в браузере.

Резюме

Возможно сделать.

+:

  • Возможно генерировать красивые настраиваемые виды.

-:

  • Сложно (невозможно) сделать редактирование хинтов.

Вариант 5. Всплывающее окно при наведении на участок текста

Забраковано заказчиком.

Assigned to: SkotnikovD

Что хочется сделать:

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

Что возможно сделать:

1) Можно задействовать функцию sublime.message_dialog(string), которая выводит информационное окно с текстом. Вывод окна привязать к Hot Key.

+:

  • Вывод подсказки в отдельном окне

-:

  • Окно выводится всегда посередине экрана
  • Пока окно не закрыто, основное окно Саблайма блокировано.

2)Использовать show_quick_panel(str_arr, on_do, sublime.MONOSPACE_FONT). Этот метод не многим отличается от предыдущего.

+:

  • В отличие от предыдущего метода, окно закрывается при щелчке мыши в любой области экрана

-:

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

Резюме: API Sublime не предоставляет достаточных возможностей для реализации удобного отображения подсказок во всплывающих окнах.