Для работы внутри 1С требуется версия платформы не ниже 8.3.14.1565
На основе Monaco editor
- Подсветка синтаксиса языка 1С
- Подсветка языка запросов
- Автокомплит для глобальных перечислений и функций
- Автокомплит для метаданных (Справочники, Документы и т.п.)
- Автокомплит для объектов метаданных (СправочникСсылка, ДокументОбъект и т.п.)
- Подсказка параметров конструкторов и методов
- Подсказка для типов
- Вставка готовых блоков кода (сниппеты)
- Вызов конструктора запроса и конструктора форматной строки
- Загрузка пользовательских функций и сниппетов
- Выделение строки, при выполнении которой произошла ошибка
- Сворачивание циклов, условий и текстов запросов
- Всплывающие подсказки для глобальных функций, перечислений и классов
- Подсказки через точку для реквизитов типа справочники/документы
- Подсказки через точку для объектов типа ТаблицаЗначений/Массив/РезультатЗапроса/ДвоичныеДанные и др., в том числе для объектов, полученных через методы других объектов.
- Подсказки для источников и полей в режиме запроса
- Для запуска в браузере достаточно открыть index.html из каталога src, либо воспользоваться ссылкой
- Для запуска в 1С можно использовать обработку console.epf, выкладываемую в релизах или сделать свою.
- Редактор используется на сайте Paste1C.
Функция | Описание |
---|---|
setText |
Устанавливает переданный текст в текущую или определенную позицию |
updateText |
Полностью заменяет весь текст редактора, игнорируя при этом режим Только просмотр |
setContent |
Устанавливает текст редактора. Игнорирует режим Только просмотр и не генерирует событие EVENT_CONTENT_CHANGED |
getText |
Возвращает весь текст из окна редактора |
eraseText |
Удаляет весь текст редактора |
selectedText |
Получает или заменяет выделенный текст |
getSelection |
Возвращает selection, аналог GetTextSelectionBounds |
setSelectionByLength |
Устанавливает выделение, аналог первой сигнатуры SetTextSelectionBounds |
setSelection |
Устанавливает выделение, аналог второй сигнатуры SetTextSelectionBounds |
getLineCount |
Возвращает количество строк |
getLineContent |
Возвращает содержимое строки по её номеру, аналог GetLine |
setLineContent |
Устанавливает содержимое строки по её номеру, аналог ReplaceLine |
getCurrentLineContent |
Возвращает содержимое текущей строки |
getCurrentLine |
Возвращает номер текущей строки |
getCurrentColumn |
Возвращает номер текущей колонки |
getQuery |
Определяет текст запроса в текущей позиции и возвращает его вместе с областью текста |
getFormatString |
Определяет текст форматной строки в текущей позиции |
findText |
Возвращает номер строки, в которой находится заданный текст |
addComment |
Добавляет комментарий к текущему блоку кода |
removeComment |
Удаляет комментарий у текущего блока |
addWordWrap |
Добавляет перенос строки к текущему блоку |
removeWordWrap |
Удаляет перенос строки у текущего блока |
insertLine |
Вставляет текст в строку с указанным номером |
addLine |
Добавляет новую строку с указанным текстом |
getPositionOffset |
Возвращает координаты текущей позиции курсора |
jumpToBracket |
Переход к парной скобке CTRL+[] |
selectToBracket |
Выделяет скобки и текст между ними SHIFT+ALT+B |
formatDocument |
Форматирование выделенного фрагмента кода или всего кода ALT+SHIFT+F |
insertSnippet |
Вставляет переданный сниппет в текущую позицию редактора |
revealDefinition |
Переход к определению переменной, функции или поля запроса F12 |
peekDefinition |
Быстрый просмотр определения переменной, функции или поля запроса CTRL+F12 |
getDifferences |
Возвращает список различий в режиме сравнения |
Функция | Описание |
---|---|
init |
Инициализация редактора с передачей версии платформы |
setLanguageMode |
Переключение режимов редактора (встроенный язык, язык запросов и т.п.)) |
setTheme |
Установка темы редактора bsl-white , bsl-white-query , bsl-dark , bsl-dark-query |
setReadOnly |
Устанавливает/снимает режим Только просмотр |
getReadOnly |
Возвращает значение режима Только просмотр |
switchLang |
Переключает язык подсказок с английского на русский и обратно |
enableQuickSuggestions |
Включает/выключает режим быстрых подсказок |
minimap |
Включает/выключает отображение карты кода |
compare |
Включает/выключает режим сравнения текстов |
getDiffCount |
Возвращает количество изменений в режиме сравнения |
nextDiff |
Переход с следующему изменению в режиме сравнения |
previousDiff |
Переход с предыдущему изменению в режиме сравнения |
getVarsNames |
Возвращает имена всех объявленных в коде переменных |
disableContextMenu |
Отключает показ контекстного меню |
showLineNumbers |
Включает отображение номеров строк в редакторе |
hideLineNumbers |
Отключает отображение номеров строк в редакторе |
hideScrollX |
Скрывает стандартную горизонтальную полосу прокрутки |
hideScrollY |
Скрывает стандартную вертикальную полосу прокрутки |
openSearchWidget |
Открывает окно поиска |
closeSearchWidget |
Закрывает окно поиска |
nextMatch |
Переход к следующему совпадению в поиске |
previousMatch |
Переход к предыдущему совпадению в поиске |
setFontSize |
Установка размера шрифта |
setFontFamily |
Установка семейства шрифтов |
setFontWeight |
Установка насыщенности (толщины) шрифта |
setLineHeight |
Установка высоты строки |
setLetterSpacing |
Установка расстояния между символами |
setDefaultStyle |
Установка стиля редактора по умолчанию |
showStatusBar |
Включает отображение строки состояния в нижней части редактора |
hideStatusBar |
Отключает отображение строки состояния |
renderWhitespace |
Включает/отключает отображение пробелов и табуляций |
hasTextFocus |
Возвращает признак активности фокуса |
setOption |
Установка опциональных настроек редактора |
getOption |
Получение опциональных настроек редактора |
disableKeyBinding |
Отключает любое стандартное сочетание клавиш редактора |
enableKeyBinding |
Включает обратно сочетание |
saveViewState |
Возвращает JSON-строку с текущими настройками (положение курсора и прокрутки, а также свернутые блоки) |
restoreViewState |
Восстанавливает настройки. В качестве аргумента принимает JSON-строку, полученную ранее через saveViewState |
setOriginalText |
Устанавливает или сбрасывает оригинальный текст, на основании которого строится подсветка изменений |
getOriginalText |
Возвращает текст, установленный ранее функцией setOriginalText |
getCurrentLanguageId |
Возвращает идентификатор текущего языка (bsl , bsl_query , dcs_query , xml ) |
isQueryMode |
Возвращает true , если редактор находится в режиме редактирования запроса и false в любом другом режиме |
isDCSMode |
Возвращает true , если редактор находится в режиме СКД и false в любом другом случае |
isSuggestWidgetVisible |
Возвращает видимость стандартного списка подсказок |
isParameterHintsWidgetVisible |
Возвращает видимость списка подсказок для параметров функции/метода |
Функция | Описание |
---|---|
updateMetadata |
Обновляет через JSON структуру метаданных (Справочники/Документы/пр.) |
clearMetadata |
Очищает структуру метаданных |
updateSnippets |
Обновляет пользовательские сниппеты |
parseSnippets |
Загружает шаблоны кода (сниппеты) в формате 1С:Предприятия |
updateSnippetByGUID |
Обновление текущего сниппета |
setDefaultSnippets |
Возвращает стандартные шаблоны кода (сниппеты) |
clearSnippets |
Очищает шаблоны кода (сниппеты) |
updateCustomFunctions |
Обновляет пользовательские функции |
parseCommonModule |
Загружает структуру общего модуля |
parseMetadataModule |
Загружает структуру модуля менеджера или модуля объекта |
setCustomHovers |
Обновляет пользовательские подсказки, показываемые при наведении |
setCustomSignatures |
Обновляет пользовательские подсказки по вызову процедуры/метода |
setCustomCodeLenses |
Загружает подсказки для Code Lens |
addContextMenuItem |
Регистрирует пользовательский пункт контекстного меню и связанное с ним событие |
markError |
Индикация ошибки в указанной строке |
triggerSuggestions |
Принудительный вызов подсказок |
triggerHovers |
Принудительный вызов всплывающей подсказки для текущего слов |
triggerSigHelp |
Принудительный вызов подсказки по вызову процедуры/метода |
showCustomSuggestions |
Показ пользовательских подсказок |
showPreviousCustomSuggestions |
Вывод списка пользовательских подсказок, ранее показанных через showCustomSuggestions |
hideSuggestionsList |
Скрывает текущий список подсказок |
hideHoverList |
Скрывает активную всплывающую подсказку для слова |
hideSignatureList |
Скрывает активную всплывающую подсказку по вызову процедуры/метода |
addBookmark |
Создание закладки в строке с указанным номером |
removeBookmark |
Удаление закладки из строки с указанным номером |
goNextBookmark |
Переход к следующей закладке |
goPreviousBookmark |
Переход к предыдущей закладке |
getBookmarks |
Возвращает массив с номерами строк, в которых установлены закладки |
removeAllBookmarks |
Удаляет все закладки |
setMarkers |
Задает маркеры выделения |
getMarkers |
Возвращает список установленных маркеров |
goNextMarker |
Переход к следующему маркеру |
goPreviousMarker |
Переход к предыдущему маркеру |
setActiveSuggestLabel |
Устанавливает заголовок активного пункта списка подсказок |
setActiveSuggestDetail |
Устанавливает подробное описание активного пункта списка подсказок |
revealLineInCenter |
Переход к строке по её номеру и позиционирование по центру экрана |
goToFuncDefinition |
Переход к определению процедуры/функции по имени |
getLastToken |
Возвращает токен (вид слова) текущей позиции |
fold |
Сворачиват текущий блок |
unfold |
Разворачивает текущий блок |
foldAll |
Сворачиват все блоки |
unfoldAll |
Разворачивает все блоки |
showVariablesDescription |
Вывод окна со значениями переменных (табло) |
updateVariableDescription |
Обновление значения переменной в табло |
scale |
Изменение масштаба (+1 - увеличить, -1 - уменьшить, 0 - сбросить) |
gotoLine |
Перейти к строке... |
setActiveSuggestionAcceptors |
Установка символов, подтверждающих выбор текущего пункта подсказки (в дополнение к Enter) |
setLineNumbersDecorations |
Установка текста слева от номера каждой строки |
Событие | Описание |
---|---|
EVENT_QUERY_CONSTRUCT |
При выборе пункта меню "Конструктор запросов". Возвращает текст и позицию запроса |
EVENT_FORMAT_CONSTRUCT |
При выборе пункта меню "Конструктор форматной строки". Возвращает текст и позицию форматное строки |
EVENT_TYPE_CONSTRUCT |
Генерируется при выборе шаблона кода ВыборТипа |
EVENT_TYPEDESCRIPTION_CONSTRUCT |
Генерируется при выборе шаблона кода КонструкторОписанияТипов |
EVENT_CONTENT_CHANGED |
При любом изменении содержимого редактора (подробнее) |
EVENT_GET_METADATA |
Генерируется при отсутствии метаданных. В параметрах передается имя запрашиваемых метаданных (подробнее) |
EVENT_XXX |
При выборе пользовательского пункта меню. addContextMenuItem('Мой пункт', 'EVENT_MY') |
EVENT_ON_ACTIVATE_SUGGEST_ROW |
При активации пункта в текущем списке подсказок (подробнее) |
EVENT_ON_DETAIL_SUGGEST_ROW |
При активации подробного описания пункта в текущем списке подсказок (подробнее) |
EVENT_ON_SELECT_SUGGEST_ROW |
При выборе пункта из списка подсказок (подробнее) |
EVENT_BEFORE_SHOW_SUGGEST |
Перед появлением списка подсказок (подробнее) |
EVENT_BEFORE_HOVER |
Перед появлением всплывающей подсказки для слова (подробнее) |
EVENT_BEFORE_SIGNATURE |
Перед появлением всплывающей подсказки по вызову процедуры/метода (подробнее) |
EVENT_ON_LINK_CLICK |
При клике по гиперссылке |
EVENT_KEY_BINDING_ХХХ |
При нажатии отключенного сочетания клавиш (подробнее) |
EVENT_GET_DEFINITION |
При переходе к определению (подробнее) |
EVENT_ON_KEY_DOWN |
При нажатии на клавиатуру (подробнее) |
EVENT_ON_INSERT_SNIPPET |
При вставке сниппета (шаблона) (подробнее) |
EVENT_GET_VARIABLE_DATA |
При расшифровке значения переменной в табло (подробнее) |
EVENT_ON_KEY_ESC |
При нажатии ESC (подробнее) |
Перед началом работы с редактором из 1С Предприятия желательно вызвать функцию инициализации и передать в нее текущую версию платформы. Пример:
init('8.3.18.891');
По умолчанию редактор находится в режиме редактирования кода (bsl). Для переключения режимов работы редактора служит функция setLanguageMode
Пример:
// Переключение в режим языка запросов
setLanguageMode('bsl_query');
// Переключение в режим языка СКД
setLanguageMode('dcs_query');
// Переключение в режим XML
setLanguageMode('xml');
// Переключение в режим встроенного языка
setLanguageMode('bsl');
Все горячие клавиши описаны тут
- Infostart Toolkit
- Конвертация данных 3 расширение
- Контекстная подсказка в 1С КД3
- Подсистема "Инструменты разработчика"
- PowerTools
- Бустер Конвертации данных 3 (Infostart Toolkit)
- Редактор кода для КД 2
- 8.3.15.1830
- 8.3.16.1148
- 8.3.17.1386
- 8.3.18.891
- 8.3.20.1549
- На платформах, выпущенных примерно до ноября 2020 года могут не работать горячие клавиши CTRL+SPACE, CTRL+C, CTRL+V и CTRL+Z и т.п.
- В веб-клиенте недоступно любое взаимодействие редактора и 1С. Можно попробовать только набор кода. Иногда для этого в браузере надо предварительно открыть данную ссылку
- В linux пока возможны проблемы с некоторым функционалом. Для сборки под linux необходимо использовать ветку webpack
- Из-за особенностей реализации подсказка через точку для реквизитов ссылочного типа работает только тогда, когда подсказываемый реквизит выбран через Enter
- В некоторых версиях платформы поле HTML некорректно работает с путями, содержащими кириллицу, поэтому обработка console.epf может выдавать ошибку
Метод объекта не обнаружен (init)
. Решением в таком случае будет изменить в коде каталог хранения исходников на другой.
Выражаю благодарность команде 1c-syntax и их проекту для VSCode за подробное описание внутренних конструкций языка в JSON, а также за коллекцию сниппетов.