# GYIK-szekció ismétlődő mezővel

> Dinamikus GYIK-szekció építése komponensként: Repeater tulajdonság, Twig-ciklus a HTML-sablonban, saját CSS és harmonika-működés JavaScripttel.

Ez az útmutató egy GYIK-szekciót épít komponensként. A kérdéseket és válaszokat egy **Repeater** tulajdonság kezeli, a harmonika-működést saját JavaScript adja. A komponens utána bárhol újrahasználható, és a kérdések a szerkesztő beállítópaneléről módosíthatók.

A kódrészletek példák: a saját webhelyed szerkezetéhez, mezőneveihez és CSS-osztályaihoz igazíthatod őket.

## Új komponens

1. Nyiss meg egy oldalt a CrocoBuilderben, és válaszd a **Tools → Component Builder** menüpontot.
2. A **Your component library** oldalon kattints az **Add new HTML/CSS component** gombra.
3. Ha nem kézzel építed, az **AI Assistant** gombbal utasításból is generáltathatod a komponenst (lásd [Komponensek](https://hub.hellowp.io/hu/plugins/crocobuilder/komponensek/)). Itt a kézi építést követjük.

## Tulajdonságok

A **Component name** mezőbe írd: „GYIK szekció”. Az **Add property** gombbal vedd fel sorban:

| Label | Token | Type | Szerepe |
| --- | --- | --- | --- |
| Szekció címe | `section_title` | **Text** | A szekció főcíme. |
| Szekció bevezetője | `section_intro` | **Text** | Rövid bevezető a cím alatt. |
| GYIK elemek | `faq_items` | **Repeater** | Az ismétlődő kérdés-válasz párok. |

A **Repeater** tulajdonságnál megjelenik egy súgódoboz („How to render this repeater”), amely megmutatja a ciklust (`{% for item in faq_items %}...{% endfor %}`), a mezők elérését (`item.<mező>`) és az üres állapot kezelését (`{% empty %}`). A **Repeater fields** résznél az **Add field** gombbal két szövegmezőt vegyél fel:

| Label | Token |
| --- | --- |
| Kérdés | `kerdes` |
| Válasz | `valasz` |

A tokenek szabadon választhatók, a HTML-sablonban ugyanazokat a neveket használd. Ha a kérdéseknek egyedi azonosító is kell (például hivatkozható horgonyhoz), vegyél fel egy harmadik mezőt is.

## HTML-sablon

A **HTML template** mezőben a ciklus a repeater minden eleméből külön GYIK-elemet állít elő. A `loop.first` feltétellel az első elem nyitva indul.

```twig
<section class="gyik">
  <h2 class="gyik__cim">{{ section_title }}</h2>
  <p class="gyik__bevezeto">{{ section_intro }}</p>
  <div class="gyik__lista" data-gyik>
    {% for item in faq_items %}
    <div class="gyik__elem{% if loop.first %} gyik__elem--nyitva{% endif %}">
      <button class="gyik__kerdes" type="button" aria-expanded="{% if loop.first %}true{% else %}false{% endif %}">{{ item.kerdes }}</button>
      <div class="gyik__valasz">{{ item.valasz }}</div>
    </div>
    {% endfor %}
  </div>
</section>
```

Amikor a szerkesztőben elemet adsz hozzá, törölsz vagy átírsz, a megjelenő kérdések és válaszok ennek megfelelően frissülnek.

## Component CSS

A **Component CSS** mezőbe kerül a szekció kinézete: elrendezés, betűk, színek, térközök, reszponzív működés és animációk. Egy egyszerű példa:

```css
.gyik { max-width: 720px; margin: 0 auto; padding: 40px 20px; }
.gyik__cim { text-align: center; margin: 0 0 8px; }
.gyik__bevezeto { text-align: center; color: #4f6178; margin: 0 0 24px; }
.gyik__lista { display: flex; flex-direction: column; gap: 12px; }
.gyik__elem { border: 1px solid #e7ecf1; border-radius: 12px; overflow: hidden; }
.gyik__kerdes { width: 100%; padding: 16px 20px; border: 0; background: #fff; text-align: left; font-size: 17px; font-weight: 600; cursor: pointer; }
.gyik__valasz { display: none; padding: 0 20px 18px; color: #4f6178; }
.gyik__elem--nyitva .gyik__valasz { display: block; }
```

## Component logic

A **Component logic** mezőbe kerül a harmonika-működés JavaScriptje: a kérdésre kattintva a válasz kinyílik, a többi bezárul, a már nyitott kérdésre kattintva pedig bezárul.

```javascript
document.querySelectorAll('[data-gyik]').forEach(function (lista) {
  var elemek = lista.querySelectorAll('.gyik__elem');
  elemek.forEach(function (elem) {
    elem.querySelector('.gyik__kerdes').addEventListener('click', function () {
      var nyitva = elem.classList.contains('gyik__elem--nyitva');
      elemek.forEach(function (e) {
        e.classList.remove('gyik__elem--nyitva');
        e.querySelector('.gyik__kerdes').setAttribute('aria-expanded', 'false');
      });
      if (!nyitva) {
        elem.classList.add('gyik__elem--nyitva');
        elem.querySelector('.gyik__kerdes').setAttribute('aria-expanded', 'true');
      }
    });
  });
});
```

Ha minden mező kész, kattints a **Create component** gombra (későbbi módosításnál a **Save changes** gombra).

![A GYIK szekció komponens a Component Builderben: tulajdonságok, HTML-sablon, CSS és logika](./kepek/peldak-gyik-komponens.webp)

*A GYIK szekció komponens a Component Builderben: tulajdonságok, HTML-sablon, CSS és logika* (https://minta-bolt.hu/wp-admin/post.php?post=2&action=crocoblocks)

A képen a bal oldali **Properties** panel, középen a **HTML template**, jobbra a **Component CSS** és a **Component logic** látszik.

## A komponens használata a szerkesztőben

1. Nyisd meg azt az oldalt vagy sablont, ahová a GYIK-szekciót szánod (például egy lábléc sablont).
2. Kattints a **+** gombra, és a bal oldali elempanelen keresd meg a **GYIK szekció** komponenst.
3. Töltsd ki a **Szekció címe** és a **Szekció bevezetője** mezőt.
4. A **GYIK elemek** résznél az **Add item** gombbal vegyél fel elemeket, és mindegyiknél töltsd ki a **Kérdés** és a **Válasz** mezőt. Az elemek sorrendjét a nyilakkal módosíthatod, a kuka ikonnal törölheted őket.
5. Kattints a **Save** gombra.

![A GYIK szekció három elemmel a szerkesztőben](./kepek/peldak-gyik-ismetlodo.webp)

*A GYIK szekció három elemmel a szerkesztőben* (https://minta-bolt.hu/wp-admin/post.php?post=2&action=crocoblocks)

A képen a bal oldalon a három repeater-elem (**Item 1**, **Item 2**, **Item 3**) látszik, a vásznon az eredmény.

## Eredmény a nyilvános oldalon

A nyilvános oldalon a kérdések láthatók, a válaszok pedig a kérdésekre kattintva nyílnak és csukódnak.

![A GYIK-szekció a nyilvános oldalon, az első kérdés nyitva](./kepek/peldak-gyik-frontend.webp)

*A GYIK-szekció a nyilvános oldalon, az első kérdés nyitva* (https://minta-bolt.hu/)

![A harmadik kérdés kinyitva](./kepek/peldak-gyik-frontend-nyitva.webp)

*A harmadik kérdés kinyitva* (https://minta-bolt.hu/)

Az első képen a **Mennyi idő alatt érkezik meg a csomag?** kérdés a nyitott alapállapotban van, a másodikon a kattintás után a **Hogyan fizethetek?** válasza látszik.

## Gyakori kérdések

**Készíthetek GYIK-szekciót kódolás nélkül?** Igen: az **AI Assistant** HTML/CSS komponenst generál, vagy kézzel is felépítheted. A stílushoz és a harmonika-működéshez azonban saját CSS és JavaScript kell, ha a generált komponens nem tartalmazza őket.

**Hogyan működik a Repeater tulajdonság?** Több GYIK-elemet vehetsz fel vele, mindegyiknek saját kérdéssel és válasszal. Elem hozzáadásakor, szerkesztésekor vagy törlésekor a szekció azonnal frissül.

**Testreszabható a harmonika kinézete?** Igen. A CSS-sel az elrendezést, a betűket, a színeket, a térközöket, a reszponzív működést és az animációkat is módosíthatod, a JavaScripttel pedig a nyitás és zárás működését.

**Újrahasználható a komponens más oldalakon?** Igen. A mentett komponens bármelyik oldalra vagy sablonba betehető, így a megjelenés egységes marad.

**Használható a szekció a WordPress blokkszerkesztőjében?** A példa komponens a CrocoBuilderhez készült. Ha blokkszerkesztőben is kell, kapcsold be a **Register as Block** beállítást (lásd [Komponensek](https://hub.hellowp.io/hu/plugins/crocobuilder/komponensek/), „Komponens blokként”).
