Шаблон:GetField/doc: различия между версиями

* {{tji|GetField|get|id|pagePath}}

* {{tji|GetField|get|id|pagePath|keyPath}}

Если <code>keyPath</code> не указан, функция вернёт всю запись. Простые значения возвращаются как текст, а таблицы — в JSON-виде.

Примеры:

* {{tji|GetField|get|MopItem|entity/MopItem.json}}

* {{tji|GetField|get|MopItem|entity/MopItem.json|name}}

* {{tji|GetField|get|SomeId|prototype/someGenerator.json|components.1}}

{{Параметры/строка|2|Путь до JSON-страницы, например <code>entity/MopItem.json</code>.|Да}}

{{Параметры/строка|3|Путь до поля внутри записи. Поддерживает вложенность через точку и индексы вида <code>field.1</code> или <code>field[1]</code>.|Нет; вся запись}}

Строит вызов шаблона для одного id и сразу обрабатывает его через препроцессор. Помимо <code>id</code>, в шаблон передаются развёрнутые поля записи.

* {{tji|GetField|getTpl|id|pagePath|template}}

* {{tji|GetField|getTpl|MopItem|entity/MopItem.json|Предмет}}

=== getId / getTplId ===

* <code>getId</code> возвращает найденные id в виде JSON-массива.

* <code>getTplId</code> по найденным id сразу вызывает шаблон.

* {{tji|GetField|getId|searchValue|pagePath|keyPath|searchType{{=}}value}}

* {{tji|GetField|getTplId|searchValue|pagePath|keyPath|template|searchType{{=}}value}}

* {{tji|GetField|getTplId|pagePath|keyPath|template|searchType{{=}}path}}

* <code>searchType=path</code> — только для <code>getTplId</code>; выводит все id, у которых поле по указанному пути существует и не пустое. В этом режиме первым параметром передаётся <code>pagePath</code>, а не значение для поиска.

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

* {{tji|GetField|getId|MopItem|prototype/itemGenerator.json|parent}}

* {{tji|GetField|getId|Anchorable|entity/someEntity.json|components|searchType{{=}}key}}

* {{tji|GetField|getTplId|MopItem|prototype/itemGenerator.json|parent|Предмет}}

* {{tji|GetField|getTplId|prototype/itemGenerator.json|sprite|Предмет|searchType{{=}}path}}

{{Параметры/строка|1|Для <code>getId</code> и обычного режима <code>getTplId</code> — значение для поиска. Для <code><nowiki>searchType=path</nowiki></code> у <code>getTplId</code> — путь до JSON-страницы.|Да}}

{{Параметры/строка|2|Для <code>getId</code> и обычного режима <code>getTplId</code> — путь до JSON-страницы. Для <code><nowiki>searchType=path</nowiki></code> у <code>getTplId</code> — путь до поля.|Да}}

{{Параметры/строка|3|Для <code>getId</code> — путь до поля. Для <code>getTplId</code> — путь до поля, либо имя шаблона в режиме <code><nowiki>searchType=path</nowiki></code>.|Да}}

{{Параметры/строка|4|Для <code>getTplId</code> — имя шаблона, который будет вызван для каждого найденного id.|Только для <code>getTplId</code>}}

* {{tji|GetField|hasComp|entityId|componentName}}

* {{tji|GetField|hasComp|MopItem|Item}}

=== getGenerator / getTplGenerator ===

Эти функции работают с генераторами, описанными в общих хранилищах <code>prototype_store.json</code> и <code>component_store.json</code>.

* {{tji|GetField|getGenerator|searchId|prototype|generatorId}}

* {{tji|GetField|getGenerator|searchId|component|generatorId}}

* {{tji|GetField|getTplGenerator|searchId|prototype|generatorId|template}}

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

* {{tji|GetField|getGenerator|MopItem|prototype|itemGenerator}}

* {{tji|GetField|getTplGenerator|MopItem|prototype|itemGenerator|Предмет}}

{{Параметры/строка|1|Id, который ищется в хранилище генераторов.|Да}}

{{Параметры/строка|2|Тип генератора: <code>prototype</code> или <code>component</code>.|Да}}

{{Параметры/строка|3|Имя генератора без <code>.json</code>.|Да}}

{{Параметры/строка|4|Имя шаблона для <code>getTplGenerator</code>.|Только для <code>getTplGenerator</code>}}

=== GeneratorId / GeneratorTplId ===

Эти функции получают все id из генераторной JSON-страницы, где данные лежат в таблице <code>id</code>.

* {{tji|GetField|GeneratorId|pagePath}}

* {{tji|GetField|GeneratorId|pagePath|replace{{=}}{{tag|nowiki|style=regular|content=<nowiki>* \1</nowiki>}}}}

* {{tji|GetField|GeneratorTplId|pagePath|template}}

 

<code>GeneratorTplId</code> вызывает шаблон для каждого id из генератора в виде <code><nowiki>{{Имя шаблона|id=...|...поля записи...}}</nowiki></code>.

* {{tji|GetField|GeneratorId|prototype/itemGenerator.json}}

* {{tji|GetField|GeneratorId|prototype/itemGenerator.json|replace{{=}}{{tag|nowiki|style=regular|content=<nowiki>* \1</nowiki>}}}}

* {{tji|GetField|GeneratorTplId|prototype/itemGenerator.json|Предмет}}

{{Параметры/строка|1|Путь до генераторной JSON-страницы.|Да}}

{{Параметры/строка|2|Имя шаблона для <code>GeneratorTplId</code>.|Только для <code>GeneratorTplId</code>}}

{{Параметры/строка|replace|Строка замены для <code>GeneratorId</code>. Если задана, результат выводится построчно вместо JSON-массива.|Нет}}

* {{tji|GetField|jsonList|<nowiki>["a","b","c"]</nowiki>}}

* {{tji|GetField|jsonList|<nowiki>{"MopItem":"Швабра"}</nowiki>}}

* {{tji|GetField|jsonList|<nowiki>{"MopItem":"Швабра"}</nowiki>|type{{=}}enum}}

* <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>}}}}

* {{tji|GetField|json|<nowiki>{"MopItem":{"name":"Швабра"}}</nowiki>|Предмет}}

* В <code>getId</code> и <code>getTplId</code> значения сравниваются как строки.

* <code>getTpl</code> и <code>getTplId</code> удобны, когда нужно не получить сырые данные, а сразу отрендерить карточку или другой шаблон.

* Функции с <code>Generator</code> работают только с генераторными страницами и хранилищами, где структура данных уже подготовлена под поиск по id.