nette/application 3.2.9 [WIP]

Author: dg

application/cs/templates.texy

@@ -120,6 +120,18 @@ Proměnné do šablony předáváme zápisem do `$this->template`. V šabloně j
 $this->template->article = $this->articles->getById($id);
 ```
 
+Pokud chcete, aby se hodnota určité property automaticky předala do šablony jako proměnná, označte ji atributem `#[TemplateVariable]`: .{data-version:3.2.9}
+
+```php
+use Nette\Application\Attributes\TemplateVariable;
+
+class ArticlePresenter extends Nette\Application\UI\Presenter
+{
+	#[TemplateVariable]
+	public string $siteName = 'Můj blog'; // nesmí být private
+}
+```
+
 
 Výchozí proměnné
 ----------------
@@ -244,6 +256,32 @@ protected function beforeRender(): void
 }
 ```
 
+**Pomocí atributů** .{data-version:3.2.9}
+
+Elegantní způsob je definovat filtry a funkce jako metody přímo v presenteru nebo komponentě a označit je atributy:
+
+```php
+use Latte\Attributes\TemplateFilter;
+use Latte\Attributes\TemplateFunction;
+
+class ArticlePresenter extends Nette\Application\UI\Presenter
+{
+	#[TemplateFilter]
+	public function money(float $val): string
+	{
+		return round($val) . ' Kč';
+	}
+
+	#[TemplateFunction]
+	public function isWeekend(DateTimeInterface $date): bool
+	{
+		return $date->format('N') >= 6
+	}
+}
+```
+
+Latte automaticky rozpozná a zaregistruje metody označené těmito atributy. Název filtru nebo funkce v šabloně odpovídá názvu metody. Tyto metody nesmí být privátní.
+
 **Globálně pomocí Extension**
 
 Předchozí způsoby jsou vhodné pro filtry a funkce, které potřebujete jen v konkrétním presenteru nebo komponentě, nikoliv v celé aplikaci. Pro celou aplikaci je nejvhodnější vytvořit si [extension |latte:extending-latte#Latte Extension]. Jde o třídu, která centralizuje všechna rozšíření Latte pro celý projekt. Kusý příklad:

application/en/templates.texy

@@ -120,6 +120,18 @@ Variables are passed to templates by writing them to `$this->template`. They the
 $this->template->article = $this->articles->getById($id);
 ```
 
+To automatically pass a property value to the template as a variable, mark it with the `#[TemplateVariable]` attribute: .{data-version:3.2.9}
+
+```php
+use Nette\Application\Attributes\TemplateVariable;
+
+class ArticlePresenter extends Nette\Application\UI\Presenter
+{
+	#[TemplateVariable]
+	public string $siteName = 'My blog'; // must not be private
+}
+```
+
 
 Default Variables
 -----------------
@@ -244,6 +256,32 @@ protected function beforeRender(): void
 }
 ```
 
+**Using Attributes** .{data-version:3.2.9}
+
+A more elegant approach is defining filters and functions as methods directly in the presenter or component, marked with attributes:
+
+```php
+use Latte\Attributes\TemplateFilter;
+use Latte\Attributes\TemplateFunction;
+
+class ArticlePresenter extends Nette\Application\UI\Presenter
+{
+	#[TemplateFilter]
+	public function money(float $val): string
+	{
+		return '$' . number_format($val, 2);
+	}
+
+	#[TemplateFunction]
+	public function isWeekend(DateTimeInterface $date): bool
+	{
+		return $date->format('N') >= 6
+	}
+}
+```
+
+Latte automatically discovers and registers methods marked with these attributes. The filter or function name in templates matches the method name. These methods must not be private.
+
 **Globally Using Extensions**
 
 The previous approaches suit filters and functions needed only in specific presenters or components, not application-wide. For the entire application, creating an [extension |latte:extending-latte#Latte Extension] works best. This class centralizes all Latte extensions for your project. A brief example: