update doc/*/xml-ui-layouts.md

2025-07-10 00:58:31 +03:00
parent 93c6a66cb7
commit be5f43086d
3 changed files with 39 additions and 1 deletions
@@ -164,6 +164,25 @@

 - `src` - id документа в формате `пак:имя` (`пак/layouts/имя.xml`)

+## Меню выбора - *select*
+
+Раскрывающийся список. Опции описываются под-элементами `option`, атрибут `value` которых содержит значение, внутренний текст - текст отображаемый в UI.
+
+Пример описания списка:
+
+```xml
+<select selected="entity" width="200" 
+        onselect="function(opt) print(opt) end">
+    <option value="block">Блок</option>
+    <option value="item">Предмет</option>
+    <option value="entity">Сущность</option>
+</select>
+```
+
+- `width` - минимальная ширина содержимого. По-умолчанию: 100.
+- `selected` - изначально выбранное значение. По-умолчанию: "".
+- `onselect` - функция, в которую передаётся выбранное пользователем значение
+
 # Элементы инвентаря

 ## Инвентарь - *inventory*