FormSpec: Добавить обёртки к оставшимся элементам #8

Closed
opened 2026-01-11 19:14:41 +00:00 by varttist · 0 comments
Owner

Для удобства создания пользовательских интерфейсов (formspec) создан класс Formspec (mods/CORE/Formspec), который предоставляет обёртки над элементами формспека в виде функций.

Необходимо дописать оставшиеся методы в классе Formspec (они помечены TODО).

Большинство элементов оборачиваются очень просто и типичный метод выглядит примерно так:

---Описание элемента (можно скопировать из API luanti)
---@param x  number
---@param y  number
---@param w  number
---@param h  number
---@param someArg  string
---@param optionalArg  string?
function Formspec:element(x, y, w, h, someArg, optionalArg)
	local element = ('element[%s,%s;%s,%s;%s;%s]'):format( -- Вставка параметров в строку, которая описывает элемент
		x, y, w, h, someArg, optionalArh or '') -- Перечисление параметров. Те, что необязательны должны идти в паре с `or ''`

	self:addElement(element) -- Добавление элемента в формспек
end

Более сложные случаи встречаются когда элемент формспека может быть описан несколькими вариациями параметров, например, как здесь:
изображение.png

Такие случаи индивидуальны и если возникают вопросы, лучше позвать @Varttist.

Задачу необязательно выполнять полностью за один раз. Можно докидывать описания методов кусками.

Ссылка на описание элементов формспека: https://api.luanti.org/formspec/#elements

Для удобства создания пользовательских интерфейсов (formspec) создан класс `Formspec` (`mods/CORE/Formspec`), который предоставляет обёртки над элементами формспека в виде функций. Необходимо дописать оставшиеся методы в классе `Formspec` ([они помечены TODО](https://git.apancore.ru/Apancore.Studio/simple-makes-complex/src/commit/426fea36915d6b0cc4c4190a0a82385e50f95f57/mods/CORE/Formspec/src/Formspec.lua#L342)). Большинство элементов оборачиваются очень просто и типичный метод выглядит примерно так: ```lua ---Описание элемента (можно скопировать из API luanti) ---@param x number ---@param y number ---@param w number ---@param h number ---@param someArg string ---@param optionalArg string? function Formspec:element(x, y, w, h, someArg, optionalArg) local element = ('element[%s,%s;%s,%s;%s;%s]'):format( -- Вставка параметров в строку, которая описывает элемент x, y, w, h, someArg, optionalArh or '') -- Перечисление параметров. Те, что необязательны должны идти в паре с `or ''` self:addElement(element) -- Добавление элемента в формспек end ``` Более сложные случаи встречаются когда элемент формспека может быть описан несколькими вариациями параметров, например, как здесь: ![изображение.png](/attachments/0eb13c30-22d2-481a-86be-28eb55c96e0f) Такие случаи индивидуальны и если возникают вопросы, лучше позвать @Varttist. **Задачу необязательно выполнять полностью за один раз.** Можно докидывать описания методов кусками. Ссылка на описание элементов формспека: https://api.luanti.org/formspec/#elements
varttist added the
task
awaiting desc
label 2026-01-11 19:14:41 +00:00
varttist added
task
need developer
1
and removed
task
awaiting desc
labels 2026-01-13 18:45:10 +00:00
varttist added this to the Tasks Kanban project 2026-01-14 14:30:43 +00:00
varttist moved this to To Do in Tasks Kanban on 2026-01-14 14:35:34 +00:00
varttist added
task
assigned
2
and removed
task
need developer
1
labels 2026-01-17 17:22:22 +00:00
varttist moved this to In Progress in Tasks Kanban on 2026-01-17 17:22:30 +00:00
varttist self-assigned this 2026-01-18 12:33:05 +00:00
varttist added the
priority
hight
1
label 2026-01-18 17:32:07 +00:00
varttist added
task
completed
3
and removed
priority
hight
1
task
assigned
2
labels 2026-01-22 11:17:56 +00:00
varttist moved this to Done in Tasks Kanban on 2026-01-22 11:18:02 +00:00
Sign in to join this conversation.
No Label
task
completed
3
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Apancore.Studio/simple-makes-complex#8