Stores custom error messages and the input field label. More...

#include <Cutelyst/Plugins/Utils/ValidatorRule>

Public Member Functions
	ValidatorMessages ()
	Constructs a default ValidatorMessages object with all custom messages disabled.
	ValidatorMessages (const char customLabel, const char customValidationError=nullptr, const char customParsingError=nullptr, const char customValidationDataError=nullptr)
	Constructs a new ValidatorMessages object with the given parameters.

Public Attributes
const char *	label
const char *	parsingError
const char *	validationDataError
const char *	validationError

Detailed Description

This struct is used by ValidatorRule derived classes to store custom error messages that are also translatable. To make the messages translatable, use QT_TRANSLATE_NOOP() so that the message can be dynamically translated by the current Context . If you want to omit a custom message, simply use a nullptr for it. For custom messages that are not set, the ValidatorRule class will return a generic message that will also be translated if Cutelyst has a translation file for the current language in the context.

The translation context used in the QT_TRANSLATE_NOOP() definition has to be the same that has been set on the Validator contstructor. If you dont want to use translation for the messages and the label, simply don't use QT_TRANSLATE_NOOP() when adding the string but simply use a C string literal and also leave the translation context on the Validator constructor empty.

Usage example

void MyController::do_form(Context *c)
{
    static Validator v1({
                        new ValidatorAccepted(QStringLiteral("usage_terms"),
                                              // empty label and translatable validation error
message ValidatorMessages(nullptr, QT_TRANSLATE_NOOP("MyController", "Please accept our terms of
usage to finish your registration.")),
 
                        new ValidatorEmail(QStringLiteral("email"), false, ValidatorEmail::Valid,
                                           // only the label will be translated and inserted into
generic error messages of the validator rule ValidatorMessages(QT_TRANSLATE_NOOP("MyController",
"Your Email Address"))
 
                        new ValidatorDate(QStringLiteral("birthday"),
                                          // here we also use a translatable version of the date
format QT_TRANSLATE_NOOP("MyControler", "yyyy-MM-dd"),
                                          // this one will use a translated label for generic
parsing and validation data
                                          // error messages and a custom translatable error
message for failed validations ValidatorMessages(QT_TRANSLATE_NOOP("MyController", "You day of
birth"), QT_TRANSLATE_NOOP("MyController", "Please enter a valid date of birth"))
 
                        // this uses a default constructed ValidatorMessages struct where
                        // no custom messages have been set, so all error messages will come
                        // from the generic validator messages without a label
                        new ValidatorRequired(QStringLiteral("password"));
 
                         // this is the context that will be used to obtain translations,
                         // it has to be the same one you use in your validator messages
                         // QT_TRANSLATE_NOOP()
                       }, QLatin1String("MyController"));
 
 
    // this validator does not specify a translation context and will therefore not translate
error messages,
    // even if they were added with QT_TRANSLATE_NOOP()
    static Validator v2({
                        new ValidatorRequired(QStringLiteral("required_field"),
                                              ValidatorMessages("Required Field", "This field is
required, please enter data."))
                       });
}

Definition at line 135 of file validatorrule.h.

Constructor & Destructor Documentation

◆ ValidatorMessages() [1/2]

Cutelyst::ValidatorMessages::ValidatorMessages ( )

inline

Definition at line 139 of file validatorrule.h.

References ValidatorMessages().

Referenced by ValidatorMessages(), and ValidatorMessages().

◆ ValidatorMessages() [2/2]

Cutelyst::ValidatorMessages::ValidatorMessages	(	const char *	customLabel,
		const char *	customValidationError = nullptr,
		const char *	customParsingError = nullptr,
		const char *	customValidationDataError = nullptr )

inline

Parameters

customLabel	User visible label for the input field. Should be the same as used on the frontend visible to the user. Will be used by generic error messages if set.
customValidationError	Custom error message if the validation fails.
customParsingError	Custom error message if the input value could not be parsed.
customValidationDataError	Custom error message if validation data is missing or invalid.

Definition at line 150 of file validatorrule.h.

References ValidatorMessages().

Member Data Documentation

◆ label

const char* Cutelyst::ValidatorMessages::label

Field label used for generating generic error messages.

Definition at line 160 of file validatorrule.h.

◆ parsingError

const char* Cutelyst::ValidatorMessages::parsingError

Custom parsing error message.

Definition at line 162 of file validatorrule.h.

◆ validationDataError

const char* Cutelyst::ValidatorMessages::validationDataError

Custom validation data error message.

Definition at line 163 of file validatorrule.h.

◆ validationError

const char* Cutelyst::ValidatorMessages::validationError

Custom validation error messages.

Definition at line 161 of file validatorrule.h.

Public Member Functions

Public Attributes