Pok в 09:55, 5 апреля 2026

2026-04-05T09:55:21Z

Pok в 11:57, 31 марта 2026

2026-03-31T11:57:31Z

Pok: Новая страница: «{{docpage}} Модуль предназначен для получения данных из кэшированных JSON-страниц и их использования в шаблонах. С его помощью можно получить поле по пути, найти id по значению или сразу собрать вызов шаблона по найденным данным. Поля берутся из json страниц *
2026-03-29T08:32:35Z

Новая страница: «{{docpage}} Модуль предназначен для получения данных из кэшированных JSON-страниц и их использования в шаблонах. С его помощью можно получить поле по пути, найти id по значению или сразу собрать вызов шаблона по найденным данным. Поля берутся из json страниц * <code...»

Новая страница
{{docpage}}
Модуль предназначен для получения данных из кэшированных JSON-страниц и их использования в шаблонах. С его помощью можно получить поле по пути, найти id по значению или сразу собрать вызов шаблона по найденным данным.

Поля берутся из json страниц
* <code>Участник:IanComradeBot/component/название</code> (пример: [[Участник:IanComradeBot/component/access.json]])
* <code>Участник:IanComradeBot/prototype/название</code> (пример: [[Участник:IanComradeBot/prototype/tag.json]])

Для подпроектов
* <code>Участник:IanComradeBot/component/Проект/название</code> (пример: [[Участник:IanComradeBot/Goob/component/access.json]])
* <code>Участник:IanComradeBot/prototype/Проект/название</code> (пример: [[Участник:IanComradeBot/Goob/prototype/tag.json]])

TOC
== Основные функции ==

=== get ===
Возвращает запись целиком или отдельное поле по её id.

Использование:
* {{tji|Модуль:GetField|get|id|pagePath|keyPath}}

Простые значения возвращаются как текст, а таблицы в JSON-виде.

Например, json сущности <code>MopItem</code> из [[Участник:IanComradeBot/component/meleeWeapon.json]] выглядит так:
<pre>
"MopItem": {
"damage": {
"types": {
"Blunt": 10
}
},
...
},
</pre>
то мы можем получить значение как как:
* {{tji|Модуль:GetField|get|MopItem|component/meleeWeapon.json|damage}} -> "types": {"Blunt": 10}}
* {{tji|Модуль:GetField|get|MopItem|component/meleeWeapon.json|damage.types}} -> {"Blunt": 10}
* {{tji|Модуль:GetField|get|MopItem|component/meleeWeapon.json|damage.types.Blunt}} -> 10

{{Параметры|
{{Параметры/строка|1|Id записи.|Да}}
{{Параметры/строка|2|Путь до JSON-страницы, например <code>component/meleeWeapon.json</code>.|Да}}
{{Параметры/строка|3|Путь до поля внутри записи. Поддерживает вложенность через точку и индексы вида <code>field.1</code>|Да}}
}}

=== getTpl ===
Строит вызов шаблона для одного id передавая в него развёрнутые поля записи.

Использование:
* {{tji|Модуль:GetField|getTpl|id|pagePath|template}}

Шаблон вызывается в виде <code><nowiki>{{Имя шаблона|id=...|...поля записи...}}</nowiki></code>. Вложенные таблицы передаются как плоские параметры, а также в JSON-виде там, где это нужно для сохранения структуры.

Пример:
* {{tji|Модуль:GetField|getTpl|MopItem|entity/MopItem.json|Предмет}}

{{Параметры|
{{Параметры/строка|1|Id записи.|Да}}
{{Параметры/строка|2|Путь до JSON-страницы.|Да}}
{{Параметры/строка|3|Имя шаблона, который будет вызван как <code><nowiki>{{Имя шаблона|id=...|...}}</nowiki></code>.|Да}}
}}

=== searchId / searchIdTpl ===
Обе функции ищут id по значению в указанном поле. Разница в результате:
* <code>searchId</code> возвращает найденные id в виде JSON-массива.
* <code>searchIdTpl</code> по найденным id сразу вызывает шаблон.

Использование:
* {{tji|Модуль:GetField|searchId|searchValue|pagePath|keyPath}}
* {{tji|Модуль:GetField|searchIdTpl|searchValue|pagePath|keyPath|template}}
* {{tji|Модуль:GetField|searchIdTpl|pagePath|keyPath|template|searchType{{=}}path}}

Режимы поиска:
* <code>searchType=value</code> — ищет id, у которых значение поля равно указанному значению. Это режим по умолчанию.
* <code>searchType=key</code> — ищет id, у которых в поле-таблице существует ключ с указанным именем.
* <code>searchType=path</code> — только для <code>searchIdTpl</code>; выводит все id, у которых поле по указанному пути существует и не пустое. В этом режиме первым параметром передаётся <code>pagePath</code>, а не значение для поиска.

<code>searchIdTpl</code> вызывает шаблон в виде <code><nowiki>{{Имя шаблона|id=...|...поля записи...}}</nowiki></code>. Если найдено несколько id, вызовы собираются подряд через пробел.

Примеры:
* {{tji|Модуль:GetField|searchId|Elements|[[Участник:IanComradeBot/prototype/reaction.json|prototype/reaction.json]]|group}} -> {{GetField|функция=searchId|Stir|prototype/reaction.json|requiredMixerCategories}}

{{Параметры|
{{Параметры/строка|1|Значение для поиска.|Да}}
{{Параметры/строка|2|Путь до JSON-страницы.|Да}}
{{Параметры/строка|3|Путь до поля внутри записи. Поддерживает вложенность через точку и индексы вида <code>field.1</code>|Да}}
{{Параметры/строка|4|Имя шаблона, который будет вызван для каждого найденного id.|Только для <code>searchIdTpl</code>}}
{{Параметры/строка|searchType|Режим поиска: <code>value</code>, <code>key</code> или <code>path</code>.|Нет; value}}
}}

=== hasComp ===
Проверяет, есть ли у сущности указанный компонент.

Использование:
* {{tji|Модуль:GetField|hasComp|entityId|componentName}}

Возвращает строку <code>true</code> или <code>false</code>.

Пример:
* {{tji|Модуль:GetField|hasComp|MopItem|Item}}

{{Параметры|
{{Параметры/строка|1|Id сущности.|Да}}
{{Параметры/строка|2|Имя компонента для проверки.|Да}}
}}

=== searchStore / searchStoreTpl ===
Эти функции находят прототипы или компоненты содержащие указанный id, используя [[Участник:IanComradeBot/prototype_store.json]] или [[Участник:IanComradeBot/component_store.json]].

Использование:
* {{tji|Модуль:GetField|searchStore|searchId|prototype|Название}}
* {{tji|Модуль:GetField|searchStore|searchId|component|Название}}
* {{tji|Модуль:GetField|searchStoreTpl|searchId|prototype|Название|Шаблон}}

<code>searchStore</code> возвращает JSON-массив id, найденных в компонентах/прототипах. <code>searchStoreTpl</code> по тем же id сразу вызывает шаблон, используя страницу вида <code>prototype/Название.json</code> или <code>component/Название.json</code>.

Примеры:
* {{tji|Модуль:GetField|searchStore|MopItem|component|itemBorgModule}} -> {{GetField|функция=searchStore|MopItem|component|itemBorgModule}}
* {{tji|Модуль:GetField|searchStore|MopItem|prototype|latheRecipe}} -> {{GetField|функция=searchStore|MopItem|prototype|latheRecipe}}

{{Параметры|
{{Параметры/строка|1|Id, который ищется в хранилище.|Да}}
{{Параметры/строка|2|Тип: <code>prototype</code> или <code>component</code>.|Да}}
{{Параметры/строка|3|Имя хранилищя без <code>.json</code>.|Да}}
{{Параметры/строка|4|Имя шаблона, который будет вызван для каждого найденного id.|Только для <code>searchStoreTpl</code>}}
}}

=== getAll / getAllTpl ===
Эти функции получают все id прототипов или компонентов.

Использование:
* {{tji|Модуль:GetField|getAll|pagePath}}
* {{tji|Модуль:GetField|getAllTpl|pagePath|template}}

<code>getAll</code> по умолчанию возвращает JSON-массив id.
<code>getAllTpl</code> вызывает шаблон для каждого id в виде <code><nowiki>{{Имя шаблона|id=...|...поля записи...}}</nowiki></code>.

Примеры:
* {{tji|Модуль:GetField|getAll|component/staticPrice.json}} -> выводит все id сущностей с этим компонентом в формате JSON
* {{tji|Модуль:GetField|getAllTpl|component/staticPrice.json|component/staticPrice/wrapper}} -> выводит все id сущностей с этим компонентом обёрнутым в шаблон {{шс|component/staticPrice/wrapper}}

{{Параметры|
{{Параметры/строка|1|Путь до JSON-страницы.|Да}}
{{Параметры/строка|2|Имя шаблона для <code>getAllTpl</code>.|Только для <code>getAllTpl</code>}}
{{Параметры/строка|replace|Строка замены для <code>getAll</code>. Если задана, результат выводится построчно вместо JSON-массива.|Нет}}
}}

=== jsonList ===
Преобразует JSON в список, перечисление или простой текст. Подходит для быстрого вывода данных без отдельного шаблона.

Использование:
* {{tji|Модуль:GetField|jsonList|<nowiki>["a","b","c"]</nowiki>}}
* {{tji|Модуль:GetField|jsonList|<nowiki>{"MopItem":"Швабра"}</nowiki>}}
* {{tji|Модуль:GetField|jsonList|<nowiki>{"MopItem":"Швабра"}</nowiki>|type{{=}}enum}}

Основные параметры:
* <code>type</code> — формат вывода: <code>list</code>, <code>enum</code> или <code>none</code>.
* <code>prefix</code> — префикс строки для режима списка. По умолчанию <code>* </code>.
* <code>sep</code> — разделитель между ключом и значением. По умолчанию <code>: </code>.
* <code>replace</code> — дополнительная обработка регулярным выражением уже собранной строки.
* <code>key_replace</code>, <code>value_replace</code> — обработка ключей и значений регулярным выражением по отдельности.

Примеры:
* {{tji|Модуль:GetField|jsonList|<nowiki>["a","b","c"]</nowiki>}}
* {{tji|Модуль:GetField|jsonList|<nowiki>{"MopItem":"Швабра"}</nowiki>|type{{=}}list}}
* {{tji|Модуль:GetField|jsonList|<nowiki>{"MopItem":"Швабра"}</nowiki>|type{{=}}none|key_replace{{=}}{{tag|nowiki|style=regular|content=<nowiki>[[\1]]</nowiki>}}}}

{{Параметры|
{{Параметры/строка|1|JSON-строка. Можно также передать именованным параметром <code>json</code>.|Да}}
{{Параметры/строка|type|Формат вывода: <code>list</code>, <code>enum</code> или <code>none</code>.|Нет; list}}
{{Параметры/строка|prefix|Префикс строки для режима <code>list</code>.|Нет; <code>* </code>}}
{{Параметры/строка|sep|Разделитель между ключом и значением.|Нет; <code>: </code>}}
{{Параметры/строка|key_replace|Строка замены для ключей.|Нет; <code>\1</code>}}
{{Параметры/строка|value_replace|Строка замены для значений.|Нет; <code>\1</code>}}
}}

=== json ===
Преобразует JSON-объект или JSON-массив объектов в набор вызовов шаблона и сразу обрабатывает их.

Использование:
* {{tji|Модуль:GetField|json|<nowiki>{"MopItem":{"name":"Швабра"}}</nowiki>|Предмет}}

Если значение по id является объектом, его поля разворачиваются в параметры шаблона. Если значение простое, оно передаётся как <code>value=...</code>.

Пример вызова, который будет собран функцией:
* <code><nowiki>{{Предмет|id=MopItem|name=Швабра}}</nowiki></code>

{{Параметры|
{{Параметры/строка|1|JSON-строка.|Да}}
{{Параметры/строка|2|Имя шаблона.|Да}}
}}

== См. также ==
* {{шс|loc}}
* {{шс|Предмет}}
* {{шс|Сущность}}

== Примечания ==
* Если запись, поле или JSON-страница не найдены, функции обычно возвращают пустую строку.
* Функция <code>get</code> возвращает таблицы в JSON-виде.
* В <code>searchId</code> и <code>searchIdTpl</code> значения сравниваются как строки.
* Параметр <code>keyPath</code> поддерживает доступ к вложенным полям и индексам.
* <code>getTpl</code> и <code>searchIdTpl</code> удобны, когда нужно не получить сырые данные, а сразу отрендерить карточку или другой шаблон.
* Функции с <code>searchStore</code> работают только с генераторными страницами и хранилищами, где структура данных уже подготовлена под поиск по id.
* <code>json</code> и <code>jsonList</code> ожидают корректный JSON; если строка не разбирается, результат будет пустым.

Модуль:GetField/doc - История изменений

Pok в 09:55, 5 апреля 2026

Pok в 11:57, 31 марта 2026