Pour les démos de UP, j'ai souvent besoin d'une suite de blocs.
Pour éviter une longue énumération qui perturbe la lecture des exemples, j'ai créé cette action.
Son nom montre bien son objet, lorem pour le côté factice et serie pour montrer la succession de données.
{up lorem-serie=liste_or_num_alpha_alphanum | maxi=x}- lorem_serie: liste séparateur virgule ou mot-cle : NUM, ALPHA, ALPHANUM
- maxi = 1: nombre d'éléments retournés
- format: fonction PHP : strtolower, strtoupper, ucfirst
Bloc principal
- main-tag (block): balise du bloc principal. Aucun par défaut
- main-id: ID sous la forme up-idArticle-posShortcode
- main-style: classe(s) ou style inline pour bloc
les éléments retournés
- item-tag = div: balise des items. 0 pour valeurs brutes séparées par item-sep
- item-style: classe(s) ou style inline pour l'item
- item-id: préfixe du compteur pour identifier l'item
- item-sep = ;: si item-tag=0, le séparateur entre les items
Divers
- css-head (base-css): style ajouté dans le HEAD de la page
Un exemple simple
Le résultat
Le shortcode
{up lorem-serie=alphanum
| maxi=5}L'argument principal est une suite de termes :
mot1, mot2, ...
ou une directive :
- num : 1, 2, ...
- alphanum : un, deux, ... (30 maxi)
- alpha : a, b, ... (26 maxi)
L'option maxi est le nombre de termes retournés
Mise en forme
Le résultat
Le shortcode
{up lorem-serie=pomme,banane,orange
| maxi=5
| format=ucfirst
| item-style=b;color:var(--bleuClair)
| item-id=up-item-
| css-head=#up-item-2[t-red]
}Les termes à retourner sont passés comme argument principal.
Bien que maxi demande 5 termes, il ne pourra être supérieur aux fournis
format est le nom de la fonction php appliquée aux termes retournés
- item-style ajoutera la classe à chacun des items
- item-id est le préfixe des identifiants des items retournés pour leur appliquer des propriétés CSS
- item-tag, div par défaut, est la balise entourant chacun des items
css-head contient la règle CSS à utiliser pour un des termes
Comme l'utilisation de cette action est de fournir des blocs qui seront traiter par l'action parente, les items ne sont pas inclus dans un bloc parent.
Si besoin, il est possible d'indiquer un main-tag et donc les attributs main-style et main-id
Cela est possible depuis la version 5.2 de UP grâce aux class2style
Sans aucune mise en forme
Certaines actions peuvent attendre une suite de données brutes dans un format style CSV.
Le résultat
A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, ZLe shortcode
{up lorem-serie=alpha
| maxi=26
| format=strtoupper
| item-tag=0
| item-sep=", "
}Nous voulons récupérer les 26 lettres de l'alphabet en majuscules
- item-tag=0 annule l'inclusionn des items dans une balise
- item-sep contient le séparateur à utiliser, point-virgule par défaut. Notez l'utilisation des guillemets pour insérer un espace.
grid (1) upactionslist (1) flexauto (2) lorem-serie (3) flexbox (1) div (1) jcontent-info (1)