# Hang és Fájl elem

> A Hang elem lejátszóval, valamint a Fájl elem fájlnévvel, letöltésgombbal és PDF-előnézettel: források, beállítások, példa és böngészőviselkedés.

## Hang elem

A **Hang** elem hangfájlt ágyaz be testreszabható lejátszóval.

![A Hang elem beállításai a szerkesztőben](./kepek/elemek-5-audio.webp)

*A Hang elem beállításai a szerkesztőben* (https://minta-bolt.hu/elemek/?bricks=run)

A képen a **Forrás**, a **Fájl** kiválasztása, az **Egyéni cím**, a kapcsolók (**Előadó megjelenítése**, **Cím megjelenítése**, **Automatikus lejátszás**, **Ismétlés**), az **Előtöltés** és a **Sablon** mező látszik.

| Beállítás | Mit csinál | Alapérték |
| --- | --- | --- |
| **Forrás** | A hang forrása: **Fájl** (a Médiatárból), **Külső URL** vagy **Dinamikus adatok**. | Fájl |
| **Fájl** | Hangfájl kiválasztása a Médiatárból. Csak a „Fájl" forrásnál érhető el. | |
| **Külső URL** | Külső hangfájl címe. Csak a „Külső URL" forrásnál érhető el. | |
| **Dinamikus adatok** | Dinamikus adatforrásból választott hang. Csak a „Dinamikus adatok" forrásnál érhető el. | |
| **Egyéni cím** | Felülírja a hang címét. Külső forrásnál nem érhető el. | |
| **Előadó megjelenítése** | Kiírja az előadó nevét a fájl metaadatai alapján. Külső forrásnál és egyéni címnél nem érhető el. | Ki |
| **Cím megjelenítése** | Kiírja a hang címét a metaadatok alapján. Külső forrásnál és egyéni címnél nem érhető el. | Ki |
| **Automatikus lejátszás** | Az oldal betöltésekor elindítja a lejátszást. A legtöbb modern böngésző blokkolja. | Ki |
| **Ismétlés** | Folyamatosan ismétli a lejátszást. | Ki |
| **Címke** | A hangcím HTML-címkéje: `p`, `h1` és `h6` között. | `p` |
| **Előtöltés** | A betöltés módja: `none` (nincs), `metadata` vagy `auto`. | Nincs |
| **Sablon** | A lejátszó színsémája: világos vagy sötét. | Világos |

## Fájl elem

A **Fájl** elem dokumentumot jelenít meg linkelt fájlnévként, letöltésgombként vagy mindkettőként. A PDF-fájlokat a böngésző saját beágyazott előnézetében is megmutathatja. Az elem a Bricks 2.4-es változatától érhető el, az elemek között a **Média** csoportban találod.

![A Fájl elem beállításai a szerkesztőben](./kepek/elemek-5-file.webp)

*A Fájl elem beállításai a szerkesztőben* (https://minta-bolt.hu/elemek/?bricks=run)

A képen a **Forrás** mező és a **Fájl kiválasztása** gomb, alatta a **Fájlnév**, a **Letöltésgomb** és a **PDF-előnézet** csoport látszik.

### A fájl forrásának kiválasztása

A **Forrás** mezővel adod meg, honnan jön a fájl:

- **Fájl**: fájl a WordPress Médiatárból. Ez az alapértelmezett.
- **Külső URL**: egy ezen vagy egy másik webhelyen tárolt fájl közvetlen címe.
- **Dinamikus adatok**: fájl- vagy médiaérték dinamikus adatból. Sablonban így minden bejegyzés a saját dokumentumát adhatja egy egyéni mezőn át.

Ha egy dinamikus mező több médiaelemet ad vissza, a Fájl elem az elsőt használja.

### Fájlnév

A fájlnév alapból hivatkozásként jelenik meg, és megnyitja a fájlt, nem kényszeríti a letöltést. A **Fájlnév** csoport beállításai:

| Beállítás | Mit csinál |
| --- | --- |
| **Fájlnév elrejtése** | Eltávolítja a linkelt fájlnevet. |
| **Egyéni fájlnév** | Felülírja a Médiatárban vagy az URL-ben szereplő nevet. Dinamikus adatot is elfogad. |
| **Megnyitás új lapon** | A fájlnév linkjét új böngészőlapon nyitja meg. A PDF-előnézeten belüli tartalék linkre is vonatkozik. |

Ha nem adsz meg egyéni nevet, a Bricks a Médiatár fájlnevét használja, vagy kiolvassa az URL-ből.

### Letöltésgomb

A letöltésgomb alapból látszik. A **Letöltésgomb** csoportban a gomb feliratát, méretét, stílusát, körvonalát és kör alakját állíthatod, illetve a **Letöltésgomb elrejtése** kapcsolóval eltávolíthatod.

A két vezérlő célja eltér: a fájlnév linkje megnyitja a fájlt, a gomb a böngésző letöltési viselkedését használja. A böngésző vagy a külső fájlkiszolgáló ilyenkor is megnyithatja a fájlt letöltés helyett.

### PDF-előnézet

A Bricks akkor jeleníti meg az előnézetet, ha a forrást PDF-ként ismeri fel:

- A Médiatár fájlját az `application/pdf` MIME-típus alapján azonosítja.
- A külső és a dinamikus URL-eket az URL útvonalában lévő `.pdf` kiterjesztés alapján. Ha a külső URL útvonala nem tartalmaz `.pdf`-et, nem tekinti PDF-nek, akkor sem, ha a kiszolgáló PDF-tartalmat ad vissza.

Az előnézet kitölti az elem szélességét, alapból 600 px magas. A beállítások a **PDF-előnézet** csoportban vannak:

| Beállítás | Mit csinál |
| --- | --- |
| **PDF-előnézet elrejtése** | Eltávolítja a soron belüli előnézetet. A fájlnév és a letöltésgomb marad, hacsak külön el nem rejted őket. |
| **Előnézet címe** | A beágyazott PDF akadálymentességi felirata. Ha üres, a Bricks a fájlnévből készít egyet. |
| **Magasság** | Az előnézet magassága. [Reszponzív szerkesztéssel](https://hub.hellowp.io/hu/plugins/bricks-child/szerkeszto-reszponziv-szerkesztes/) töréspontonként is állíthatod. |
| **Megjelenítés** | Az előnézet minden szélességen soron belül marad, vagy **Asztali nézetben soron belüli, mobilon rejtett**. |
| **Elrejtés a töréspontnál** | Melyik nézetszélességnél tűnjön el az előnézet. Csak az „Asztali nézetben soron belüli, mobilon rejtett" választásnál jelenik meg. Ha nem választasz töréspontot, a Bricks a Mobil fekvő töréspontot használja (tartaléknak 767 px). |
| **PDF betöltése kattintásra** | A PDF betöltését addig halasztja, amíg a látogató az előnézet helyőrzőjére nem kattint. |
| **Előnézeti kép** | A kattintás előtt megjelenő kép. Csak bekapcsolt „PDF betöltése kattintásra" mellett jelenik meg. |

A „PDF betöltése kattintásra" bekapcsolt állapotában a Bricks először az egyéni előnézeti képet használja. Ha nincs, a Médiatár-csatolmányhoz a WordPress által készített előnézetet, ha az is hiányzik, a helyőrzőn PDF-ikon és a fájlnév látszik.

### Példa: PDF egy egyéni mezőből

Tegyük fel, hogy minden ingatlan-bejegyzéshez tartozik egy PDF-prospektus egy fájlmezőben.

1. Add hozzá a Fájl elemet az ingatlan sablonjához.
2. Állítsd a **Forrás**t **Dinamikus adatok**ra.
3. Válaszd ki a prospektus fájlmezőjét.
4. Az **Egyéni fájlnév** mezőbe írj például `{post_title} prospektus` szöveget.
5. Kapcsold be a **PDF betöltése kattintásra** beállítást, ha nem szeretnéd, hogy a böngésző az oldal első betöltésekor kérje le a PDF-et.
6. Adj meg **Előnézeti kép**et, vagy hagyd, hogy a Bricks a csatolmány előnézetét használja, ha van.
7. Hagyd látható a fájlnevet vagy a letöltésgombot, hogy az előnézet nélkül is elérhető legyen a prospektus.

Ha a frontenden megnyitsz két ingatlan-bejegyzést, mindegyik a saját PDF-jét mutatja, az elrendezés ugyanaz marad.

### Böngészőviselkedés és hozzáférés

A Fájl elem a böngésző beépített PDF-támogatását használja. A PDF-eszköztár, a megjelenítés és a nyomtatási vagy letöltési lehetőségek böngészőnként és eszközönként eltérhetnek.

A letöltésgomb vagy a böngészővezérlők elrejtése nem védi a PDF-et: a látogató böngészője megkapja a fájl URL-jét és tartalmát. A korlátozott dokumentumokat kiszolgáló- vagy alkalmazásszinten védd, mielőtt a Fájl elemben használod őket.

A nem PDF-fájlok nem kapnak soron belüli előnézetet, nekik a linkelt fájlnév és a letöltésgomb marad.