Шаблон:ВопросОтвет: различия между версиями

Версия от 14:48, 3 июня 2025

Документация шаблона: ВопросОтвет

Этот шаблон создает сворачиваемый блок для одного вопроса и ответа. Короткий заголовок вопроса всегда виден и служит кликабельным переключателем для отображения полного вопроса (если есть) и ответа.

Важно: Параметр ID

Каждый блок вопроса-ответа на странице должен иметь уникальное значение параметра `ID`. Это необходимо для корректной работы механизма сворачивания, чтобы каждый заголовок управлял только своим блоком ответа.

ID должен быть порядковым номером секции и вопроса в ней, например: `ID=s1q1`, `ID=s2q10`, `ID=s3q2`.
ID не должен содержать пробелов и спецсимволов, используйте латинские буквы и цифры.

Использование

{{ВопросОтвет
|ID= kakRabotaetMana 
|ЗаголовокВопроса= Как работает мана?
|ПолныйВопрос= Расскажите подробнее о механике восстановления и использования маны.
|Ответ= Мана восстанавливается со временем или при использовании специальных зелий...
}}

{{ВопросОтвет
|ID= shkolyMagii 
|ЗаголовокВопроса= Какие есть школы магии?
|Ответ= Существуют следующие школы магии: школа огня, школа воды...
}}

Создает сворачиваемый блок для одного вопроса и ответа, где заголовок вопроса является кликабельным переключателем. Требует указания уникального ID.

Параметры шаблона[Править данные шаблона]
Шаблон использует блочное форматирование параметров.
Параметр		Описание	Тип	Статус
Уникальный ID	`ID`	Уникальный идентификатор для этого вопроса-ответа на странице (без пробелов и спецсимволов, например, 's1q1', 's2q10'). Необходим для работы сворачивания. Должен быть уникален для каждого вызова шаблона на одной странице. Пример faqGeneral01	Строковый (без форматирования)	обязательный
Заголовок вопроса	`ЗаголовокВопроса`	Краткий видимый заголовок вопроса, который служит кликабельным переключателем. Пример Как это работает?	Строковый (без форматирования)	обязательный
Полный вопрос (необязательно)	`ПолныйВопрос`	Полный текст вопроса, если он отличается от заголовка. Отображается при разворачивании. Пример Не могли бы вы подробнее объяснить, как работает эта функция?	Строковый (без форматирования)	необязательный
Ответ	`Ответ`	Текст ответа на вопрос. Отображается при разворачивании. Пример Эта функция работает путем...	Содержимое (контент)	обязательный

@@ Строка 1: / Строка 1: @@
-<includeonly><div class="qa-item mw-collapsible mw-collapsed" style="border: 1px solid #ddd; margin-bottom: 5px; background-color: #f9f9f9; border-radius: 3px;">
+<includeonly><div class="qa-item">
-   <div class="qa-header" style="font-weight:bold; cursor:pointer; padding: 8px 10px; background-color: #f0f0f0; border-bottom: 1px solid #eee;">{{{ЗаголовокВопроса|Заголовок вопроса}}}</div>
+   <div class="mw-customtoggle-qa{{{ID}}}" style="font-weight:bold; cursor:pointer; padding: 5px; border-bottom: 1px solid #ccc; background-color: #f0f0f0;">{{{ЗаголовокВопроса|Заголовок вопроса}}}</div>
-   <div class="mw-collapsible-content" style="padding:10px; background-color: #fff;">
+   <div class="mw-collapsible mw-collapsed qa-content" id="mw-customcollapsible-qa{{{ID}}}" style="padding:10px; border: 1px solid #ddd; border-top:none; background-color: #fff;">
      {{#if:{{{ПолныйВопрос|}}}|
        <div class="qa-full-question" style="margin-bottom:8px;">
@@ Строка 13: / Строка 13: @@
 </div></includeonly><noinclude>
 == Документация шаблона: ВопросОтвет ==
-Этот шаблон создает сворачиваемый блок для одного вопроса и ответа. Короткий заголовок вопроса всегда виден и служит для разворачивания/сворачивания полного вопроса (если есть) и ответа с помощью стандартного механизма MediaWiki.
+Этот шаблон создает сворачиваемый блок для одного вопроса и ответа. Короткий заголовок вопроса всегда виден и служит '''кликабельным переключателем''' для отображения полного вопроса (если есть) и ответа.
+=== Важно: Параметр ID ===
+Каждый блок вопроса-ответа на странице '''должен иметь уникальное значение параметра `ID`'''. Это необходимо для корректной работы механизма сворачивания, чтобы каждый заголовок управлял только своим блоком ответа.
+* ID должен быть порядковым номером секции и вопроса в ней, например: `ID=s1q1`, `ID=s2q10`, `ID=s3q2`.
+* ID не должен содержать пробелов и спецсимволов, используйте латинские буквы и цифры.
 === Использование ===
 <pre>
 {{ВопросОтвет
-|ЗаголовокВопроса= Краткий вопрос 1?
+|ID= kakRabotaetMana
-|ПолныйВопрос= Это полный текст первого вопроса, который может быть длиннее?
+|ЗаголовокВопроса= Как работает мана?
-|Ответ= Это развернутый ответ на первый вопрос.
+|ПолныйВопрос= Расскажите подробнее о механике восстановления и использования маны.
+|Ответ= Мана восстанавливается со временем или при использовании специальных зелий...
 }}
 {{ВопросОтвет
-|ЗаголовокВопроса= Другой краткий вопрос?
+|ID= shkolyMagii
-|Ответ= Ответ на второй вопрос. Может содержать '''вики-разметку'''.
+|ЗаголовокВопроса= Какие есть школы магии?
+|Ответ= Существуют следующие школы магии: школа огня, школа воды...
 }}
 </pre>
@@ Строка 32: / Строка 39: @@
 {
 	"params": {
+		"ID": {
+			"label": "Уникальный ID",
+			"description": "Уникальный идентификатор для этого вопроса-ответа на странице (без пробелов и спецсимволов, например, 's1q1', 's2q10'). Необходим для работы сворачивания. Должен быть уникален для каждого вызова шаблона на одной странице.",
+			"type": "string",
+			"required": true,
+			"example": "faqGeneral01"
+		},
 		"ЗаголовокВопроса": {
 			"label": "Заголовок вопроса",
-			"description": "Краткий видимый заголовок вопроса, который служит переключателем.",
+			"description": "Краткий видимый заголовок вопроса, который служит кликабельным переключателем.",
 			"type": "string",
 			"required": true,
@@ Строка 53: / Строка 67: @@
 		}
 	},
-	"description": "Создает сворачиваемый блок для одного вопроса и ответа с использованием стандартного механизма сворачивания MediaWiki (ID не требуется).",
+	"description": "Создает сворачиваемый блок для одного вопроса и ответа, где заголовок вопроса является кликабельным переключателем. Требует указания уникального ID.",
 	"format": "block"
 }
 </templatedata>
 </noinclude>