latte: info about Latte\Runtime\Html

Author: dg

latte/bg/extending-latte.texy

@@ -68,6 +68,16 @@ $latte->addFilter('shortify', fn(string $s, int $len = 10) => mb_substr($s, 0, $
 
 Разбира се, функцията, представляваща филтъра, може да приема произволен брой параметри, като се поддържат и променливи параметри.
 
+Ако филтърът връща низ в HTML, можете да го маркирате така, че Latte да не го ескапира автоматично (и следователно двойно). По този начин се избягва необходимостта от задаване на `|noescape` в шаблона.
+Най-лесният начин е да обвиете низа в обект `Latte\Runtime\Html`, а другият начин е [Контекстни филтри |#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+В този случай филтърът трябва да осигури правилно извеждане на данните.
+
 
 Филтри, които използват класа .[#toc-filters-using-the-class]
 -------------------------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// променете типа на съдържанието на HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/cs/extending-latte.texy

@@ -68,6 +68,16 @@ Jak vidíte, funkce obdrží levou stranu filtru před pipe `|` jako první argu
 
 Funkce představující filtr může samozřejmě přijímat libovolný počet parametrů, podporovány jsou i variadic parametry.
 
+Pokud filtr vrací řetězec v HTML, můžete jej označit tak, aby jej Latte automaticky (a tedy dvojitě) neescapovalo. Vyhnete se tak potřebě uvádět v šabloně `|noescape`.
+Nejjednodušší cestou je řetězec zabalit do objektu `Latte\Runtime\Html`, druhou cestu představují [Kontextové filtry|#Kontextové filtry].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount Kč</i>"));
+```
+
+.[note]
+Filtr musí v takovém případě zajistit správné escapování dat.
+
 
 Filtry pomocí třídy
 -------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// změníme content-type na HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount Kč</i>";
 });
 ```
 

latte/de/extending-latte.texy

@@ -68,6 +68,16 @@ Wie Sie sehen können, erhält die Funktion die linke Seite des Filters vor der
 
 Natürlich kann die Funktion, die den Filter darstellt, eine beliebige Anzahl von Parametern annehmen, und auch variable Parameter werden unterstützt.
 
+Wenn der Filter eine Zeichenkette in HTML zurückgibt, können Sie diese so markieren, dass Latte sie nicht automatisch (und damit doppelt) umbricht. Dadurch wird vermieden, dass Sie `|noescape` in der Vorlage angeben müssen.
+Am einfachsten ist es, die Zeichenkette in ein `Latte\Runtime\Html` Objekt zu verpacken, die andere Möglichkeit sind [kontextuelle Filter |#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+In diesem Fall muss der Filter das korrekte Escaping der Daten sicherstellen.
+
 
 Filter, die die Klasse .[#toc-filters-using-the-class]
 ------------------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// Inhaltstyp in HTML ändern
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/el/extending-latte.texy

@@ -68,6 +68,16 @@ $latte->addFilter('shortify', fn(string $s, int $len = 10) => mb_substr($s, 0, $
 
 Φυσικά, η συνάρτηση που αναπαριστά το φίλτρο μπορεί να δεχτεί οποιονδήποτε αριθμό παραμέτρων, ενώ υποστηρίζονται και μεταβλητές παράμετροι.
 
+Αν το φίλτρο επιστρέφει ένα αλφαριθμητικό σε HTML, μπορείτε να το επισημάνετε έτσι ώστε το Latte να μην το αποφεύγει αυτόματα (και επομένως διπλά). Με αυτόν τον τρόπο αποφεύγεται η ανάγκη προσδιορισμού του `|noescape` στο πρότυπο.
+Ο ευκολότερος τρόπος είναι να τυλίξετε τη συμβολοσειρά σε ένα αντικείμενο `Latte\Runtime\Html`, ο άλλος τρόπος είναι τα [φίλτρα πλαισίου |#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+Στην περίπτωση αυτή, το φίλτρο πρέπει να διασφαλίζει τη σωστή διαφυγή των δεδομένων.
+
 
 Φίλτρα που χρησιμοποιούν την κλάση .[#toc-filters-using-the-class]
 ------------------------------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// αλλάζουμε τον τύπο περιεχομένου σε HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/en/extending-latte.texy

@@ -68,6 +68,16 @@ As you can see, the function receives the left side of the filter before the pip
 
 Of course, the function representing the filter can accept any number of parameters, and variadic parameters are also supported.
 
+If the filter returns a string in HTML, you can mark it so that Latte does not automatically (and therefore double) escaping it. This avoids the need to specify `|noescape` in the template.
+The easiest way is to wrap the string in a `Latte\Runtime\Html` object, the other way is [Contextual Filters|#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+In this case, the filter must ensure correct escaping of the data.
+
 
 Filters Using the Class
 -----------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// change content-type to HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/es/extending-latte.texy

@@ -68,6 +68,16 @@ Como puede ver, la función recibe la parte izquierda del filtro antes de la tub
 
 Por supuesto, la función que representa el filtro puede aceptar cualquier número de parámetros, y también se admiten parámetros variádicos.
 
+Si el filtro devuelve una cadena en HTML, puede marcarla para que Latte no la escape automáticamente (y por tanto por partida doble). Esto evita la necesidad de especificar `|noescape` en la plantilla.
+La forma más fácil es envolver la cadena en un objeto `Latte\Runtime\Html`, la otra forma es [Filtros contextuales |#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+En este caso, el filtro debe garantizar el correcto escape de los datos.
+
 
 Filtros que utilizan la clase .[#toc-filters-using-the-class]
 -------------------------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// change content-type to HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/fr/extending-latte.texy

@@ -68,6 +68,16 @@ Comme vous pouvez le voir, la fonction reçoit le côté gauche du filtre avant
 
 Bien sûr, la fonction représentant le filtre peut accepter n'importe quel nombre de paramètres, et les paramètres variadiques sont également supportés.
 
+Si le filtre renvoie une chaîne en HTML, vous pouvez la marquer pour que Latte ne l'échappe pas automatiquement (et donc doublement). Cela évite d'avoir à spécifier `|noescape` dans le modèle.
+La méthode la plus simple consiste à envelopper la chaîne dans un objet `Latte\Runtime\Html`, l'autre méthode étant celle des [filtres contextuels |#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+Dans ce cas, le filtre doit assurer l'échappement correct des données.
+
 
 Filtres utilisant la classe .[#toc-filters-using-the-class]
 -----------------------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// changez le type de contenu en HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/hu/extending-latte.texy

@@ -68,6 +68,16 @@ Mint látható, a függvény a következő argumentumként a szűrő bal oldalá
 
 Természetesen a szűrőt reprezentáló függvény tetszőleges számú paramétert fogadhat el, és a változó paraméterek is támogatottak.
 
+Ha a szűrő egy karakterláncot ad vissza HTML-ben, akkor megjelölheted, hogy a Latte ne automatikusan (és ezért duplán) szedje ki. Így elkerülhető a `|noescape` megadása a sablonban.
+A legegyszerűbb, ha a sztringet egy `Latte\Runtime\Html` objektumba csomagoljuk, a másik lehetőség a [Contextual Filters |#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+Ebben az esetben a szűrőnek biztosítania kell az adatok helyes kikerülését.
+
 
 Az osztályt használó szűrők .[#toc-filters-using-the-class]
 -----------------------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// a tartalomtípust HTML-re módosítja
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/it/extending-latte.texy

@@ -68,6 +68,16 @@ Come si può vedere, la funzione riceve il lato sinistro del filtro prima della
 
 Naturalmente, la funzione che rappresenta il filtro può accettare un numero qualsiasi di parametri e sono supportati anche i parametri variabili.
 
+Se il filtro restituisce una stringa in HTML, è possibile contrassegnarla in modo che Latte non esegua automaticamente (e quindi doppiamente) l'escape. Questo evita la necessità di specificare `|noescape` nel template.
+Il modo più semplice è avvolgere la stringa in un oggetto `Latte\Runtime\Html`, l'altro modo è [Filtri contestuali |#Contextual Filters].
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+In questo caso, il filtro deve garantire il corretto escape dei dati.
+
 
 Filtri che utilizzano la classe .[#toc-filters-using-the-class]
 ---------------------------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// cambia il tipo di contenuto in HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```
 

latte/ja/extending-latte.texy

@@ -68,6 +68,16 @@ $latte->addFilter('shortify', fn(string $s, int $len = 10) => mb_substr($s, 0, $
 
 もちろん、フィルタを表す関数は任意の数のパラメータを受け取ることができ、可変長のパラメータもサポートされています。
 
+フィルターがHTMLの文字列を返す場合、ラテが自動的に（つまり二重に）エスケープしないようにマークすることができます。これにより、テンプレートで`|noescape` を指定する必要がなくなります。
+最も簡単な方法は、`Latte\Runtime\Html` オブジェクトで文字列をラップすることです。もう一つの方法は、[コンテキストフィルタ |#Contextual Filters]です。
+
+```php
+$latte->addFilter('money', fn(float $amount) => new Latte\Runtime\Html("<i>$amount EUR</i>"));
+```
+
+.[note]
+この場合、フィルターはデータの正しいエスケープを保証しなければならない。
+
 
 クラスを使ったフィルタ .[#toc-filters-using-the-class]
 -------------------------------------------
@@ -150,7 +160,7 @@ $latte->addFilter('money', function (FilterInfo $info, float $amount): string {
 
 	// change content-type to HTML
 	$info->contentType = ContentType::Html;
-	return "<i>$num Kč</i>";
+	return "<i>$amount EUR</i>";
 });
 ```