voxelcoreprojects/voxelcore
1
0
Fork 0
mirror of https://github.com/MihailRis/voxelcore.git synced 2026-10-08 04:21:50 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Merge 5cfe5d3aac into 00425c4175

Browse source
This commit is contained in:
boolean-false 2026-10-03 08:34:09 +03:00 • committed by GitHub
commit 9a2a227d98
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 423 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

85
doc/ru/scripting/ui.md
View file

@ -84,21 +84,24 @@ document["worlds-panel"]:clear()
Свойства:
| Название | Тип | Чтение | Запись | Описание |
| ----------- | ------ | ------ | ------ | ---------------------------------------------------------------------- |
| text | string | да | да | введенный текст или заполнитель |
| placeholder | string | да | да | заполнитель (используется если ничего не было введено) |
| hint | string | да | да | текст, отображаемый, когда ничего не введено |
| caret | int | да | да | позиция каретки. `textbox.caret = -1` установит позицию в конец текста |
| editable | bool | да | да | изменяемость текста |
| edited | bool | да | да\* | был ли изменён текст с последней установки/сброса свойства |
| multiline | bool | да | да | поддержка многострочности |
| lineNumbers | bool | да | да | отображение номеров строк |
| textWrap | bool | да | да | автоматический перенос текста (только при multiline: "true") |
| valid | bool | да | нет | является ли введенный текст корректным |
| textColor | vec4 | да | да | цвет текста |
| syntax | string | да | да | подсветка синтаксиса ("lua" - Lua) |
| markup | string | да | да | язык разметки текста ("md" - Markdown) |
| Название | Тип | Чтение | Запись | Описание |
| ----------------- | ------ | ------ | ------ | ---------------------------------------------------------------------- |
| text | string | да | да | введенный текст или заполнитель |
| placeholder | string | да | да | заполнитель (используется если ничего не было введено) |
| hint | string | да | да | текст, отображаемый, когда ничего не введено |
| caret | int | да | да | позиция каретки. `textbox.caret = -1` установит позицию в конец текста |
| editable | bool | да | да | изменяемость текста |
| edited | bool | да | да\* | был ли изменён текст с последней установки/сброса свойства |
| multiline | bool | да | да | поддержка многострочности |
| lineNumbers | bool | да | да | отображение номеров строк |
| textWrap | bool | да | да | автоматический перенос текста (только при multiline: "true") |
| valid | bool | да | нет | является ли введенный текст корректным |
| textColor | vec4 | да | да | цвет текста |
| syntax | string | да | да | подсветка синтаксиса ("lua" - Lua) |
| markup | string | да | да | язык разметки текста ("md" - Markdown) |
| selection | ivec2 | да | да | закреплённый конец выделения и каретка; см. ниже |
| externalRendering | bool | да | да | внешняя отрисовка текста (по умолчанию false) |
| textLayout | table | да | нет | снимок видимой раскладки текста; см. ниже |
\* - только false
@ -110,6 +113,58 @@ document["worlds-panel"]:clear()
| lineAt(pos: int) -> int | определяет номер строки по позиции в тексте |
| linePos(line: int) -> int | определяет позицию начала строки в тексте |
### Выделение и внешняя отрисовка
- `selection` (чтение/запись): `{anchor, caret}` - направленное выделение.
Индексы с нуля в единицах нативного `caret`, не байтах UTF-8. Допускаются
только конечные целые числа; значения ограничиваются длиной текста.
Установка прокручивает поле к каретке, в том числе сразу после замены текста,
не меняет текст и не сбрасывает undo.
- `externalRendering` (boolean, чтение/запись, по умолчанию `false`): скрывает
текст, каретку, выделение и подсветку текущей строки. Ввод, hit testing,
раскладка, прокрутка, фон, номера строк и скроллбар остаются нативными.
`false` возвращает нативную отрисовку без пересоздания поля. Совмещение с
`markup` запрещено в обоих направлениях и вызывает ошибку.
- `textLayout` (таблица, только чтение): снимок видимой раскладки.
`ready=false`, если шрифт недоступен либо используется markup. Иначе:
- `text` - значение `textbox.text`, включая `placeholder` при пустом вводе;
`font` - имя шрифта;
- `lineHeight` - шаг строки, `textHeight` - высота label для отрисовки строки;
- `caretRect={x,y,cellWidth,rowHeight}` - геометрия каретки, без учёта фокуса,
editable и мигания; на конце строки ширина ячейки равна ширине пробела;
- `selectionRects` - прямоугольники `{x, y, width, height}` для видимых
выделенных строк, включая ячейки переводов строк;
- `lines` - видимые строки `{start,text,pos={x,y},advances={...}}`: нативный
индекс начала, текст без завершающего перевода строки, позиция и ширины
отдельных символов. Для пустого ввода строки могут содержать hint,
при этом hint не подменяет поле `text` в снимке.
Координаты локальны textbox, учитывают выравнивание и прокрутку, могут выходить
за его границы. Внешняя отрисовка должна обрезаться областью поля. Снимок -
независимая Lua-таблица; её изменение не меняет textbox. После ввода, изменения
размеров и прокрутки нужно читать новый снимок. Цвета syntax не экспортируются:
внешний рендерер задаёт их самостоятельно. Индексация и ввод текста
следуют существующему поведению textbox.
```lua
local field = document.input
field.text = "abcdef"
field.selection = {5, 2}
local anchor, caret = unpack(field.selection)
field.externalRendering = true
local layout = field.textLayout
if layout.ready then
for _, line in ipairs(layout.lines) do
print(line.start, line.text, line.pos[1], line.pos[2])
end
end
```
В примере каретка находится на позиции 2, закреплённый конец выделения - на
позиции 5. Отрицательный индекс выделения ограничивается нулём; в отличие
от `caret`, он не задаёт позицию относительно конца текста.
## Ползунок (trackbar)
Свойства: