URL linkek létrehozása
**********************

<div class=perex>

Linkek létrehozása a Nette-ben egyszerű, mint az ujjal mutogatás. Csak rá kell mutatni, és a keretrendszer elvégzi az összes munkát Ön helyett. Megmutatjuk:

- hogyan hozzunk létre linkeket sablonokban és máshol
- hogyan különböztessük meg az aktuális oldalra mutató linket
- mit tegyünk az érvénytelen linkekkel

</div>


Az [kétirányú routingnak |routing] köszönhetően soha nem kell majd keményen beírnia az alkalmazás URL-címeit a sablonokba vagy a kódba, amelyek később megváltozhatnak, vagy bonyolultan összeállítani őket. A linkben elegendő megadni a presentert és az akciót, átadni az esetleges paramétereket, és a keretrendszer maga generálja az URL-t. Valójában nagyon hasonlít egy függvényhívásra. Ez tetszeni fog Önnek.


A presenter sablonjában
=======================

Leggyakrabban sablonokban hozunk létre linkeket, és nagyszerű segítő az `n:href` attribútum:

```latte
<a n:href="Product:show">részletek</a>
```

Figyelje meg, hogy a HTML `href` attribútum helyett az [n:attribútumot |latte:syntax#n:attribútumok] `n:href` használtuk. Ennek értéke nem URL, ahogy az `href` attribútum esetében lenne, hanem a presenter és az akció neve.

Egy linkre kattintás, leegyszerűsítve, olyan, mintha a `ProductPresenter::renderShow()` metódust hívnánk meg. És ha annak szignatúrájában paraméterek vannak, argumentumokkal hívhatjuk meg:

```latte
<a n:href="Product:show $product->id, $product->slug">termék részletei</a>
```

Lehetőség van elnevezett paraméterek átadására is. A következő link a `lang` paramétert adja át `cs` értékkel:

```latte
<a n:href="Product:show $product->id, lang: cs">termék részletei</a>
```

Ha a `ProductPresenter::renderShow()` metódusnak nincs `$lang` a szignatúrájában, a paraméter értékét a `$lang = $this->getParameter('lang')` segítségével vagy a [property-ből |presenters#Kérés paraméterei] tudhatja meg.

Ha a paraméterek tömbben vannak tárolva, kibonthatók a `...` operátorral (Latte 2.x-ben az `(expand)` operátorral):

```latte
{var $args = [$product->id, lang => cs]}
<a n:href="Product:show ...$args">termék részletei</a>
```

A linkekben automatikusan átadódnak az ún. [perzisztens paraméterek |presenters#Perzisztens paraméterek] is.

Az `n:href` attribútum nagyon praktikus a HTML `<a>` tag-ekhez. Ha máshol szeretnénk kiírni a linket, például szövegben, használjuk a `{link}`-et:

```latte
A cím: {link Home:default}
```


A kódban
========

Link létrehozásához a presenterben a `link()` metódus szolgál:

```php
$url = $this->link('Product:show', $product->id);
```

A paramétereket tömb segítségével is át lehet adni, ahol elnevezett paramétereket is meg lehet adni:

```php
$url = $this->link('Product:show', [$product->id, 'lang' => 'cs']);
```

Linkeket presenter nélkül is lehet létrehozni, erre való a [#LinkGenerator] és annak `link()` metódusa.


Linkek presenterhez
===================

Ha a link célja egy presenter és egy akció, akkor a szintaxisa a következő:

```
[//] [[[[:]module:]presenter:]action | this] [#fragment]
```

A formátumot minden Latte tag és minden presenter metódus támogatja, amely linkekkel dolgozik, tehát `n:href`, `{link}`, `{plink}`, `link()`, `lazyLink()`, `isLinkCurrent()`, `redirect()`, `redirectPermanent()`, `forward()`, `canonicalize()` és a [#LinkGenerator] is. Tehát még ha a példákban `n:href` szerepel is, bármelyik függvény lehetne ott.

Az alapforma tehát `Presenter:action`:

```latte
<a n:href="Home:default">kezdőlap</a>
```

Ha az aktuális presenter akciójára hivatkozunk, kihagyhatjuk a nevét:

```latte
<a n:href="default">kezdőlap</a>
```

Ha a cél a `default` akció, kihagyhatjuk, de a kettőspontnak maradnia kell:

```latte
<a n:href="Home:">kezdőlap</a>
```

A linkek más [modulokba |directory-structure#Presenterek és sablonok] is mutathatnak. Itt a linkeket megkülönböztetjük relatívakra egy beágyazott almodulba, vagy abszolútakra. Az elv analóg a lemezen lévő elérési utakkal, csak perjelek helyett kettőspontok vannak. Tegyük fel, hogy az aktuális presenter a `Front` modul része, akkor így írjuk:

```latte
<a n:href="Shop:Product:show">link a Front:Shop:Product:show-ra</a>
<a n:href=":Admin:Product:show">link az Admin:Product:show-ra</a>
```

Speciális eset a [saját magára mutató |#Link az aktuális oldalra] link, amikor célként a `this`-t adjuk meg.

```latte
<a n:href="this">frissítés</a>
```

Hivatkozhatunk az oldal egy bizonyos részére az ún. fragment segítségével a kettőskereszt `#` jel után:

```latte
<a n:href="Home:#main">link a Home:default-ra és a #main fragmentre</a>
```


Abszolút utak
=============

A `link()` vagy `n:href` segítségével generált linkek mindig abszolút utak (azaz `/` jellel kezdődnek), de nem abszolút URL-ek protokollal és domainnel, mint `https://domain`.

Abszolút URL generálásához adjon hozzá két perjelet az elejére (pl. `n:href="//Home:"`). Vagy átkapcsolhatja a presentert, hogy csak abszolút linkeket generáljon a `$this->absoluteUrls = true` beállításával.


Link az aktuális oldalra
========================

A `this` cél linket hoz létre az aktuális oldalra:

```latte
<a n:href="this">frissítés</a>
```

Ugyanakkor átadódnak az összes paraméter, amelyek a `action<Action>()` vagy `render<View>()` metódus szignatúrájában szerepelnek, ha az `action<Action>()` nincs definiálva. Tehát ha a `Product:show` oldalon vagyunk és `id: 123`, a `this`-re mutató link ezt a paramétert is átadja.

Természetesen a paramétereket közvetlenül is meg lehet adni:

```latte
<a n:href="this refresh: 1">frissítés</a>
```

Az `isLinkCurrent()` függvény ellenőrzi, hogy a link célja megegyezik-e az aktuális oldallal. Ezt például a sablonban lehet használni a linkek megkülönböztetésére stb.

A paraméterek ugyanazok, mint a `link()` metódusnál, de ezen felül lehetőség van egy konkrét akció helyett a `*` helyettesítő karakter megadására, amely az adott presenter bármely akcióját jelenti.

```latte
{if !isLinkCurrent('Admin:login')}
	<a n:href="Admin:login">Jelentkezzen be</a>
{/if}

<li n:class="isLinkCurrent('Product:*') ? active">
	<a n:href="Product:">...</a>
</li>
```

Az `n:href`-fel kombinálva egy elemen belül használható a rövidített forma:

```latte
<a n:class="isLinkCurrent() ? active" n:href="Home:">...</a>
```

A `*` helyettesítő karakter csak az akció helyett használható, a presenter helyett nem.

Annak megállapítására, hogy egy adott modulban vagy annak almoduljában vagyunk-e, használjuk az `isModuleCurrent(moduleName)` metódust.

```latte
<li n:class="isModuleCurrent('Forum:Users') ? active">
	<a n:href="Product:">...</a>
</li>
```


Linkek signálhoz
================

A link célja nemcsak presenter és akció lehet, hanem [signál |components#Signal] is (ezek a `handle<Signal>()` metódust hívják). Ekkor a szintaxis a következő:

```
[//] [sub-component:]signal! [#fragment]
```

A signált tehát a felkiáltójel különbözteti meg:

```latte
<a n:href="click!">signál</a>
```

Lehet linket létrehozni egy alkomponens (vagy al-alkomponens) signáljára is:

```latte
<a n:href="componentName:click!">signál</a>
```


Linkek a komponensben
=====================

Mivel a [komponensek|components] önálló, újrafelhasználható egységek, amelyeknek nem kellene semmilyen kapcsolatban állniuk a környező presenterekkel, a linkek itt egy kicsit másképp működnek. A Latte `n:href` attribútuma és a `{link}` tag, valamint a komponens metódusai, mint a `link()` és mások, a link célját **mindig signál névként** kezelik. Ezért még a felkiáltójelet sem kell megadni:

```latte
<a n:href="click">signál, nem akció</a>
```

Ha a komponens sablonjában presenterekre szeretnénk hivatkozni, használjuk a `{plink}` taget:

```latte
<a href={plink Home:default}>kezdőlap</a>
```

vagy a kódban

```php
$this->getPresenter()->link('Home:default')
```


Aliasok .{data-version:v3.2.2}
==============================

Néha hasznos lehet egy könnyen megjegyezhető aliast rendelni egy Presenter:akció párhoz. Például a `Front:Home:default` kezdőlapot egyszerűen `home`-nak nevezni, vagy az `Admin:Dashboard:default`-ot `admin`-nak.

Az aliasokat a [konfigurációban|configuration] definiáljuk az `application › aliases` kulcs alatt:

```neon
application:
    aliases:
        home: Front:Home:default
        admin: Admin:Dashboard:default
        sign: Front:Sign:in
```

A linkekben ezután a kukac jellel írjuk őket, például:

```latte
<a n:href="@admin">adminisztráció</a>
```

Támogatottak minden olyan metódusban is, amely linkekkel dolgozik, mint a `redirect()` és hasonlók.


Érvénytelen linkek
==================

Előfordulhat, hogy érvénytelen linket hozunk létre - vagy azért, mert nem létező presenterhez vezet, vagy azért, mert több paramétert ad át, mint amennyit a célmetódus a szignatúrájában elfogad, vagy ha a célakcióhoz nem lehet URL-t generálni. Az érvénytelen linkek kezelését a `Presenter::$invalidLinkMode` statikus változó határozza meg. Ez a következő értékek kombinációját veheti fel (konstansok):

- `Presenter::InvalidLinkSilent` - csendes mód, URL-ként a # karaktert adja vissza
- `Presenter::InvalidLinkWarning` - E_USER_WARNING figyelmeztetést dob, amely éles módban logolásra kerül, de nem szakítja meg a szkript futását
- `Presenter::InvalidLinkTextual` - vizuális figyelmeztetés, a hibát közvetlenül a linkbe írja
- `Presenter::InvalidLinkException` - InvalidLinkException kivételt dob

Az alapértelmezett beállítás `InvalidLinkWarning` éles módban és `InvalidLinkWarning | InvalidLinkTextual` fejlesztői módban. Az `InvalidLinkWarning` éles környezetben nem szakítja meg a szkript futását, de a figyelmeztetés logolásra kerül. Fejlesztői környezetben a [Tracy |tracy:] elfogja és bluescreen-t jelenít meg. Az `InvalidLinkTextual` úgy működik, hogy URL-ként egy hibaüzenetet ad vissza, amely `#error:` karakterekkel kezdődik. Hogy az ilyen linkek első pillantásra észrevehetők legyenek, adjunk hozzá a CSS-hez:

```css
a[href^="#error:"] {
	background: red;
	color: white;
}
```

Ha nem szeretnénk, hogy fejlesztői környezetben figyelmeztetések keletkezzenek, beállíthatjuk a csendes módot közvetlenül a [konfigurációban|configuration].

```neon
application:
	silentLinks: true
```


LinkGenerator
=============

Hogyan hozzunk létre linkeket hasonló kényelemmel, mint a `link()` metódus, de presenter jelenléte nélkül? Erre való a [api:Nette\Application\LinkGenerator].

A LinkGenerator egy szolgáltatás, amelyet a konstruktoron keresztül kérhetünk, majd a `link()` metódusával hozhatunk létre linkeket.

A presenterekkel szemben itt van egy különbség. A LinkGenerator minden linket rögtön abszolút URL-ként hoz létre. Továbbá nincs "aktuális presenter", így nem lehet célként csak az akció nevét megadni (`link('default')`) vagy relatív utakat megadni a modulokhoz.

Az érvénytelen linkek mindig `Nette\Application\UI\InvalidLinkException`-t dobnak.