Validations disponibles

Contentful stocke les entrées des utilisateurs sous forme de données structurées et. Les validations que vous pouvez appliquer à un champ dépendent du type de champ. Le tableau ci-dessous répertorie les validations disponibles et indique les types de champs avec lesquels vous pouvez les utiliser.

Taille

Valide que la taille d’une entrée de texte, d’objet ou de symbole se situe dans une plage spécifiée. Vous pouvez définir une plage en spécifiant les valeurs « min » et « max » (les valeurs sont incluses dans la plage). Vous pouvez également spécifier uniquement la valeur « min » ou « max » pour définir une contrainte sur la valeur minimale/maximale autorisée.

Valeurs prédéfinies

Valide que la valeur d’un champ appartient à un ensemble prédéfini. Pour définir un ensemble, ajoutez les valeurs souhaitées une par une. Notez qu’actuellement, il existe une limite de 50 valeurs prédéfinies que vous pouvez définir. Par défaut, les valeurs prédéfinies seront affichées dans l’éditeur d’entrées sous forme de liste déroulante.

Expression régulière (Regex)

Valide que la valeur d’un champ correspond à un modèle spécifique défini par une expression régulière. Vous pouvez modifier davantage la correspondance des modèles en incluant des indicateurs facultatifs, tels que la recherche insensible à la casse (« i ») ou sur plusieurs lignes (« m »). Pour plus d’informations, consultez la page Expression régulière (Regex).

Pour la commodité des utilisateurs, le module de validations Contentful fournit un certain nombre de règles regex prédéfinies couvrant les scénarios courants.

E-mail

Un e-mail se compose d’un nom d’utilisateur, suivi de « @ » suivi d’un nom de domaine. Les caractères autorisés dans un nom d’utilisateur sont des caractères alphanumériques (a-z, 0-9), « _ », « . », « - ». Il en va de même pour les noms de domaine.

URL

Une URL valide nécessite un préfixe de protocole (ftp, http, https) et un domaine de premier niveau.

Date (États-Unis)

Dates au format « MM/DD/YYYY » où chaque caractère représente un chiffre. Les mois et les jours à un chiffre peuvent ou non être précédés d’un zéro. L’année peut comporter deux ou quatre chiffres. Veuillez noter que seules les dates postérieures à 1900 sont autorisées.

Date (européenne)

Dates au format « DD/MM/YYYY ». Les mêmes restrictions que pour les dates américaines s’appliquent.

Numéro de téléphone (États-Unis)

Format « X-XXX-XXX-XXXX » ou « X-(XXX)-XXX-XXXX » où chaque X est un chiffre. Les points (’.’) et un seul espace sont également acceptés comme séparateurs à la place de ’-’. Les séparateurs peuvent être omis.

Code postal américain

Accepte les codes postaux saisis sous forme de cinq chiffres (« XXXXX ») ou de cinq plus quatre chiffres « XXXXX-XXXX ».

Heure (12 heures)

Accepte les valeurs de temps au format HH:MM:SS AM/PM. Les heures autorisées sont de 01 à 12, les colonnes sont obligatoires, tandis que l’utilisation des secondes est facultative. L’entrée doit contenir la notation AM/PM en minuscules ou en majuscules.

Heure (24 heures)

Accepte les valeurs de temps au format HH:MM:SS. Les heures autorisées sont de 01 à 24, les colonnes sont obligatoires, tandis que l’utilisation des secondes est facultative. L’entrée ne peut pas contenir de notation AM/PM.

Plage

Valide que la valeur d’un champ numérique se situe dans une plage spécifiée. Vous pouvez utiliser des nombres entiers ou décimaux pour définir la plage et les nombres négatifs sont également acceptés. Vous pouvez également définir uniquement la valeur maximale ou minimale.

Plage de dates

Valide que la valeur d’un champ de date se situe dans une plage spécifiée. En plus de la date, la plage nécessite des valeurs de temps, définissez-les à 00:00 lorsque la valeur de temps est facultative.

Veuillez noter que pour stocker des valeurs de temps sans date, nous vous recommandons d’utiliser une règle Regex pertinente avec un type de champ Symbole ou Texte.

Nombre d’éléments

Valide que le nombre de symboles/ entrées / ressources média se situe dans une plage spécifiée. Seuls les entiers sont autorisés comme valeurs d’entrée.

Dimension du fichier

Valide que la taille d’une ressource média se situe dans une plage spécifiée. Veuillez noter que les valeurs saisies sont stockées en octets, mais affichées en octets / Ko / Mo.

Dimensions de l’image

Valide que les dimensions d’une image se situent dans une plage spécifiée. Les valeurs saisies sont interprétées comme des pixels et incluent la plage. Vous pouvez également spécifier uniquement une hauteur ou une largeur souhaitée.

Veuillez noter que la validation ne sera appliquée qu’aux ressources média identifiées comme des images.

Type

Valide que l’entrée jointe / la ressource média téléchargée est du type spécifié. Les types d’entrées sont basés sur les types de contenu disponibles dans un espace. Les types de ressources média sont basés sur des groupes MIME et comprennent :

• Pièce jointe

• Zone de texte

• Image

• Audio

• Vidéo

• Texte enrichi

• Présentation

• Feuille de calcul

• Document PDF

• Archives

• Code

• Markup

Veuillez consulter la page Wikipédia pour la liste des types de fichiers correspondant à des types MIME spécifiques.