From be5f43086d2df921d11b630b26c666e13dea9fec Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Thu, 10 Jul 2025 00:58:31 +0300
Subject: [PATCH] update doc/*/xml-ui-layouts.md

---
 doc/en/xml-ui-layouts.md | 19 +++++++++++++++++++
 doc/ru/scripting/ui.md   |  2 +-
 doc/ru/xml-ui-layouts.md | 19 +++++++++++++++++++
 3 files changed, 39 insertions(+), 1 deletion(-)

diff --git a/doc/en/xml-ui-layouts.md b/doc/en/xml-ui-layouts.md
index b25028f2..1127d79f 100644
--- a/doc/en/xml-ui-layouts.md
+++ b/doc/en/xml-ui-layouts.md
@@ -163,6 +163,25 @@ Container for embedding an external document. Content is scaling to the iframe s
 
 - `src` - document id in the format `pack:name` (`pack/layouts/name.xml`)
 
+## *select*
+
+Drop-down list. Options are described by `option` sub-elements, the `value` attribute of which contains the value, the inner text is the text displayed in the UI.
+
+Example of list description:
+
+```xml
+<select selected="entity" width="200"
+        onselect="function(opt) print(opt) end">
+    <option value="block">Block</option>
+    <option value="item">Item</option>
+    <option value="entity">Entity</option>
+</select>
+```
+
+- `width` - minimum content width. Default: 100.
+- `selected` - initially selected value. Default: "".
+- `onselect` - function to which the user-selected value is passed
+
 # Inventory elements
 
 ## *inventory*
diff --git a/doc/ru/scripting/ui.md b/doc/ru/scripting/ui.md
index bd150993..d61d2af3 100644
--- a/doc/ru/scripting/ui.md
+++ b/doc/ru/scripting/ui.md
@@ -202,7 +202,7 @@ document["worlds-panel"]:clear()
 |----------|--------|--------|--------|----------------------------|
 | src      | string | да     | да     | id встраиваемого документа |
 
-## Меню опций (select)
+## Меню выбора (select)
 
 Является производным от кнопки с доступом к свойствам, таким как отображаемый текст.
 
diff --git a/doc/ru/xml-ui-layouts.md b/doc/ru/xml-ui-layouts.md
index 179f1bc0..a2f068ca 100644
--- a/doc/ru/xml-ui-layouts.md
+++ b/doc/ru/xml-ui-layouts.md
@@ -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*