ListItem
extends TICEntity
in package
Entité de base disposant d'éventuelles méthodes utiles.
Tags
Table of Contents
Properties
- $enabled : bool
- $icon : string
- $id : mixed
- $info : ListInfo
- $label : string
- Libellé de l'élément à afficher (celui de la locale par défaut si translatable).
- $ranking : int
- $ref : string
- Référence fixe de l'élément (par défaut: slug du libellé unique dans la liste).
- $value : string
- Valeur/clé à associer au libellé (par défaut: index dans la liste).
Methods
- __construct() : mixed
- __toString() : mixed
- export() : mixed
- generateDefaultData() : mixed
- Génération automatique pour les champs vides 'ref' et 'value'.
- getEnabled() : bool
- Get enabled
- getIcon() : string
- Get icon
- getId() : string
- Get id
- getInfo() : ListInfo
- Get info
- getLabel() : string
- Get label Note: possibilité de spécifier une locale pour interroger la collection de translations Note: il est sans doute préférable d'éviter la création d'objet depuis une demande en lecture
- getLabels() : array<string|int, mixed>
- Retourne la liste des libellés traduits (plutôt qu'une liste des traductions) Note: si aucune traduction une liste sera initialisée avec le libellé par défaut
- getRanking() : int
- Get ranking
- getRef() : string
- Get ref
- getValue() : string
- Get value
- import() : mixed
- makeRefFromLabel() : mixed
- Génération automatique de la référence du noeud (slug unique du label).
- makeValueAutoIndex() : mixed
- Génération automatique de la valeur du noeud (index incrémental dans la liste).
- setEnabled() : ListItem
- Set enabled
- setIcon() : ListItem
- Set icon
- setInfo() : ListItem
- Set info
- setLabel() : ListItem
- Set label
- setLabels() : mixed
- Enregistre une liste de libellés traduits dans la collection des translations.
- setRanking() : ListItem
- Set ranking
- setRef() : ListItem
- Set ref
- setValue() : ListItem
- Set value
- slugify() : mixed
- Compatibility
- getDefaultLabel() : mixed
- Retourne le libellé par défaut d'une liste de traduction.
Properties
$enabled
protected
bool
$enabled
Tags
$icon
protected
string
$icon
Tags
$id
protected
mixed
$id
Tags
$info
protected
ListInfo
$info
Tags
$label
Libellé de l'élément à afficher (celui de la locale par défaut si translatable).
protected
string
$label
Tags
$ranking
protected
int
$ranking
Tags
$ref
Référence fixe de l'élément (par défaut: slug du libellé unique dans la liste).
protected
string
$ref
Tags
$value
Valeur/clé à associer au libellé (par défaut: index dans la liste).
protected
string
$value
Tags
Methods
__construct()
public
__construct([ListInfo $info = null ][, mixed $label = null ][, mixed $value = null ][, mixed $ref = null ]) : mixed
Parameters
- $info : ListInfo = null
- $label : mixed = null
- $value : mixed = null
- $ref : mixed = null
__toString()
public
__toString() : mixed
export()
public
export() : mixed
generateDefaultData()
Génération automatique pour les champs vides 'ref' et 'value'.
public
generateDefaultData() : mixed
Note: l'usage d'events prePersist et preUpdate sur les entités ListItem ne permettrait pas de déterminer l'ordre des éléments traités (génant pour la génération des incréments et les priorités des slugs) d'où l'usage d'un event PreFlush au niveau de la liste ATTENTION: aucun event alors sur une opération d'ajout/édition isolée d'une entité ListItem (en dehors de l'édition via une liste) ?
getEnabled()
Get enabled
public
getEnabled() : bool
Return values
boolgetIcon()
Get icon
public
getIcon() : string
Return values
stringgetId()
Get id
public
getId() : string
Return values
stringgetInfo()
Get info
public
getInfo() : ListInfo
Return values
ListInfogetLabel()
Get label Note: possibilité de spécifier une locale pour interroger la collection de translations Note: il est sans doute préférable d'éviter la création d'objet depuis une demande en lecture
public
getLabel([string $locale = null ]) : string
Parameters
- $locale : string = null
-
La locale demandée pour récupérer les traductions
Return values
stringgetLabels()
Retourne la liste des libellés traduits (plutôt qu'une liste des traductions) Note: si aucune traduction une liste sera initialisée avec le libellé par défaut
public
getLabels() : array<string|int, mixed>
Return values
array<string|int, mixed> —Liste des libellés indexés par leur locale
getRanking()
Get ranking
public
getRanking() : int
Return values
intgetRef()
Get ref
public
getRef() : string
Return values
stringgetValue()
Get value
public
getValue() : string
Return values
stringimport()
public
import(mixed $data) : mixed
Parameters
- $data : mixed
makeRefFromLabel()
Génération automatique de la référence du noeud (slug unique du label).
public
makeRefFromLabel() : mixed
makeValueAutoIndex()
Génération automatique de la valeur du noeud (index incrémental dans la liste).
public
makeValueAutoIndex() : mixed
setEnabled()
Set enabled
public
setEnabled(bool $enabled) : ListItem
Parameters
- $enabled : bool
Return values
ListItemsetIcon()
Set icon
public
setIcon(string $icon) : ListItem
Parameters
- $icon : string
Return values
ListItemsetInfo()
Set info
public
setInfo([ListInfo $info = null ]) : ListItem
Parameters
- $info : ListInfo = null
Return values
ListItemsetLabel()
Set label
public
setLabel(string $label) : ListItem
Parameters
- $label : string
Return values
ListItemsetLabels()
Enregistre une liste de libellés traduits dans la collection des translations.
public
setLabels(array<string|int, mixed> $labels) : mixed
Note: mise à jour au passage du libellé par défaut (stocké dans l'entité hors translations)
Parameters
- $labels : array<string|int, mixed>
-
Liste des libellés indexés par leur locale
setRanking()
Set ranking
public
setRanking(int $ranking) : ListItem
Parameters
- $ranking : int
Return values
ListItemsetRef()
Set ref
public
setRef(string $ref) : ListItem
Parameters
- $ref : string
Return values
ListItemsetValue()
Set value
public
setValue(string $value) : ListItem
Parameters
- $value : string
Return values
ListItemslugify()
Compatibility
public
static slugify(mixed $text) : mixed
Parameters
- $text : mixed
getDefaultLabel()
Retourne le libellé par défaut d'une liste de traduction.
protected
getDefaultLabel(mixed $labels[, mixed $default = '' ]) : mixed
(utile pour ListItemTranslation[] => ListItem->label)
Parameters
- $labels : mixed
- $default : mixed = ''