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

Текущая версия от 14:56, 3 июня 2025

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

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

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

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

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

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

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

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

Создает сворачиваемый блок для одного вопроса и ответа, где заголовок вопроса является кликабельным переключателем. Требует указания уникального 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="qa-header mw-customtoggle-qa{{{ID}}}"><span class="qa-header-title">{{{ЗаголовокВопроса|Заголовок вопроса}}}</span><span class="qa-toggle-icon"></span></div>
-   <div class="mw-collapsible-content" style="padding:10px; background-color: #fff;">
+   <div class="qa-content mw-collapsible mw-collapsed" id="mw-customcollapsible-qa{{{ID}}}">
      {{#if:{{{ПолныйВопрос|}}}|
-       <div class="qa-full-question" style="margin-bottom:8px;">
+       <div class="qa-full-question">
-         <p style="margin-top:0;">'''Вопрос:''' {{{ПолныйВопрос}}}</p>
+         <p>'''Вопрос:''' {{{ПолныйВопрос}}}</p>
        </div>
      }}
      <div class="qa-answer">
-       <p style="margin-top:0;">'''Ответ:''' {{{Ответ|Ответ на вопрос...}}}</p>
+       <p>'''Ответ:''' {{{Ответ|Ответ на вопрос...}}}</p>
      </div>
    </div>
 </div></includeonly><noinclude>
 == Документация шаблона: ВопросОтвет ==
-Этот шаблон создает сворачиваемый блок для одного вопроса и ответа. Короткий заголовок вопроса всегда виден и служит для разворачивания/сворачивания полного вопроса (если есть) и ответа с помощью стандартного механизма MediaWiki.
+Этот шаблон создает сворачиваемый блок для одного вопроса и ответа. Короткий заголовок вопроса всегда виден и служит '''кликабельным переключателем''' для отображения полного вопроса (если есть) и ответа.
+=== Важно: Параметр ID ===
+Каждый блок вопроса-ответа на странице '''должен иметь уникальное значение параметра `ID`'''. Это необходимо для корректной работы механизма сворачивания, чтобы каждый заголовок управлял только своим блоком ответа.
+* ID должен быть порядковым номером секции и вопроса в ней, например: `ID=s1q1`, `ID=s2q10`, `ID=s3q2`.
+* ID не должен содержать пробелов и спецсимволов, используйте латинские буквы и цифры.
 === Использование ===
 <pre>
 {{ВопросОтвет
-|ЗаголовокВопроса= Краткий вопрос 1?
+|ID= s1q1
-|ПолныйВопрос= Это полный текст первого вопроса, который может быть длиннее?
+|ЗаголовокВопроса= Как работает мана?
-|Ответ= Это развернутый ответ на первый вопрос.
+|ПолныйВопрос= Расскажите подробнее о механике восстановления и использования маны.
+|Ответ= Мана восстанавливается со временем или при использовании специальных зелий...
 }}
 {{ВопросОтвет
-|ЗаголовокВопроса= Другой краткий вопрос?
+|ID= s2q1
-|Ответ= Ответ на второй вопрос. Может содержать '''вики-разметку'''.
+|ЗаголовокВопроса= Какие есть школы магии?
+|Ответ= Существуют следующие школы магии: школа огня, школа воды...
 }}
 </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>