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

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*

doc/ru/scripting/ui.md

@@ -202,7 +202,7 @@ document["worlds-panel"]:clear()
 |----------|--------|--------|--------|----------------------------|
 | src      | string | да     | да     | id встраиваемого документа |
 
-## Меню опций (select)
+## Меню выбора (select)
 
 Является производным от кнопки с доступом к свойствам, таким как отображаемый текст.
 

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*