latte 3.1.2

Author: dg

latte/cs/filters.texy

@@ -10,6 +10,8 @@ V šablonách můžeme používat funkce, které pomáhají upravit nebo přefor
 | `breakLines` | [Před konce řádku přidá HTML odřádkování |#breakLines]
 | `bytes`      | [formátuje velikost v bajtech |#bytes]
 | `clamp`      | [ohraničí hodnotu do daného rozsahu |#clamp]
+| `column`     | [extrahuje jeden sloupec z pole |#column]
+| `commas`     | [spojí pole čárkami |#commas]
 | `dataStream` | [konverze pro Data URI protokol |#dataStream]
 | `date`       | [formátuje datum a čas |#date]
 | `explode`    | [rozdělí řetězec na pole podle oddělovače |#explode]
@@ -259,6 +261,50 @@ Ohraničí hodnotu do daného inkluzivního rozsahu min a max.
 Existuje také jako [funkce |functions#clamp].
 
 
+column(string|int|null $columnKey, string|int|null $indexKey=null) .[filter]{data-version:3.1.2}
+------------------------------------------------------------------------------------------------
+Vybere hodnoty konkrétního klíče z každého prvku pole. Když máte pole záznamů (např. uživatelů, produktů), tento filtr vybere jen jedno pole z každého záznamu.
+
+```latte
+{var $users = [
+	[id: 30, name: 'John', age: 30],
+	[id: 32, name: 'Jane', age: 25],
+	[id: 33, age: 35],
+]}
+
+{$users|column: 'name'}
+{* vrátí ['John', 'Jane'] *}
+
+{$users|column: 'name', 'id'}
+{* vrátí [30 => 'John', 32 => 'Jane'] *}
+```
+
+Pokud předáte `null` jako klíč sloupce, vrátí celé pole (užitečné, když chcete pouze přeindexovat podle `$indexKey`).
+
+
+commas(?string $lastGlue=null) .[filter]{data-version:3.1.2}
+------------------------------------------------------------
+Spojí prvky pole čárkou a mezerou (`', '`). Jedná se o pohodlnou zkratku pro běžný případ výpisu položek v čitelné podobě.
+
+```latte
+{var $items = ['jablka', 'pomeranče', 'banány']}
+{$items|commas}
+{* vypíše 'jablka, pomeranče, banány' *}
+```
+
+Volitelně můžete zadat vlastní oddělovač pro poslední dvojici položek:
+
+```latte
+{$items|commas: ' a '}
+{* vypíše 'jablka, pomeranče a banány' *}
+
+{=['PHP', 'JavaScript', 'Python']|commas: ', nebo '}
+{* vypíše 'PHP, JavaScript, nebo Python' *}
+```
+
+Viz také [#implode].
+
+
 dataStream(string $mimetype=detect) .[filter]
 ---------------------------------------------
 Konvertuje obsah do data URI scheme. Pomocí něj lze do HTML nebo CSS vkládat obrázky bez nutnosti linkovat externí soubory.
@@ -407,6 +453,8 @@ Můžete také použít alias `join`:
 {=[1, 2, 3]|join}         {* vypíše '123' *}
 ```
 
+Viz také [#commas], [#explode].
+
 
 indent(int $level=1, string $char="\t") .[filter]
 -------------------------------------------------

latte/en/filters.texy

@@ -10,6 +10,8 @@ In templates, we can use functions that help modify or reformat data into its fi
 | `breakLines` | [Inserts HTML line breaks before all newlines |#breakLines]
 | `bytes`      | [formats size in bytes |#bytes]
 | `clamp`      | [clamps a value to the given range |#clamp]
+| `column`     | [extracts a single column from an array |#column]
+| `commas`     | [joins an array with commas |#commas]
 | `dataStream` | [Data URI protocol conversion |#dataStream]
 | `date`       | [formats the date and time |#date]
 | `explode`    | [splits a string into an array by a delimiter |#explode]
@@ -259,6 +261,50 @@ Clamps a value to the given inclusive range of min and max.
 Also exists as a [function |functions#clamp].
 
 
+column(string|int|null $columnKey, string|int|null $indexKey=null) .[filter]{data-version:3.1.2}
+------------------------------------------------------------------------------------------------
+Extracts values from a specific key from each element of an array. When you have an array of objects, this filter picks out just one property value.
+
+```latte
+{var $users = [
+	[id: 30, name: 'John', age: 30],
+	[id: 32, name: 'Jane', age: 25],
+	[id: 33, age: 35],
+]}
+
+{$users|column: 'name'}
+{* returns ['John', 'Jane'] *}
+
+{$users|column: 'name', 'id'}
+{* returns [30 => 'John', 32 => 'Jane'] *}
+```
+
+If you pass `null` as the column key, it returns the entire array (useful when you only want to re-index by the `$indexKey`).
+
+
+commas(?string $lastGlue=null) .[filter]{data-version:3.1.2}
+------------------------------------------------------------
+Joins array elements with a comma and space (`', '`). This is a convenient shortcut for the common use case of listing items in a human-readable format.
+
+```latte
+{var $items = ['apples', 'oranges', 'bananas']}
+{$items|commas}
+{* outputs 'apples, oranges, bananas' *}
+```
+
+You can optionally provide a custom separator for the last pair of items:
+
+```latte
+{$items|commas: ' and '}
+{* outputs 'apples, oranges and bananas' *}
+
+{=['PHP', 'JavaScript', 'Python']|commas: ', or '}
+{* outputs 'PHP, JavaScript, or Python' *}
+```
+
+See also [#implode].
+
+
 dataStream(string $mimetype='detect') .[filter]
 -----------------------------------------------
 Converts content to the data URI scheme. This allows embedding images into HTML or CSS without needing to link external files.
@@ -407,6 +453,8 @@ You can also use the alias `join`:
 {=[1, 2, 3]|join}         {* outputs '123' *}
 ```
 
+See also [#commas], [#explode].
+
 
 indent(int $level=1, string $char="\t") .[filter]
 -------------------------------------------------