DocumentaciónAEM 6.5Guía del usuario

Personalizar mensajes de error para formularios HTML5 customizing-error-messages-for-html-forms

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

En los formularios de HTML5, de forma predeterminada, los mensajes de error y las advertencias tienen una posición y aspecto fijos (fuente y color), el error se muestra solo para un campo seleccionado y solo se muestra un error.

El artículo proporciona los pasos para personalizar los mensajes de error de formularios de HTML5 para que pueda hacer lo siguiente:

  • cambiar el aspecto y la posición de los mensajes de error. Puede hacer que aparezca un error en la parte superior, inferior y derecha de cualquier campo.
  • mostrar mensajes de error para varios campos en un momento determinado.
  • mostrar el error independientemente de si un campo está seleccionado o no.

Personalizar mensajes de error  customizing-error-messages-nbsp

Antes de personalizar los mensajes de error, descargue y extraiga el paquete adjunto (CustomErrorManager-1.0-SNAPSHOT.zip).

Después de extraer el paquete, abra la carpeta CustomErrorManager-1.0-SNAPSHOT. Contiene carpetas jcr_root y META-INF. Estas carpetas contienen los archivos CSS y .JS necesarios para personalizar el mensaje de error.

Obtener archivo

Personalizar la posición de los mensajes de error  customizing-the-position-of-error-messages-nbsp

Para personalizar la posición del mensaje de error, agregue una <div> para cada campo de error y advertencia, coloque el <div> a la izquierda o a la derecha, y aplique estilos css en la etiqueta <div> etiqueta. Para ver los pasos detallados, consulte el procedimiento que se muestra a continuación:

  1. Navegue hasta la carpeta CustomErrorManager-1.0-SNAPSHOT y abra la carpeta etc\clientlibs\mf-custom-error-manager\CustomErrorManager\javascript.

  2. Abra el archivo customErrorManager.js para editarlo. La función markError del el archivo acepta los siguientes parámetros:

    table 0-row-2 1-row-2 2-row-2 3-row-2
    jqWidget jqWidget es el controlador de un widget.
    msg contiene el mensaje de error.
    type indica si se trata de un error o de una advertencia.

  3. En la implementación predeterminada, los mensajes de error aparecen a la derecha del campo. Para que los mensajes de error aparezcan en la parte superior utilice el siguiente código.

    code language-javascript 
    markError: function (jqWidget, msg, type) {
            var element = jqWidget.element,                                //Gives the div containing widget
                pos = $(element).offset(),                          //Calculates the position of the div in the view port
                                                                msgHeight = xfalib.view.util.TextMetrics.measureExtent(msg).height + 5;  //Calculating the height of the Error Message
                styles = {};
                styles.left = pos.left + "px";         // Assign the desired left position using pos.left. Here it is calculated for exact left of the field
                styles.top = pos.top - msgHeight + "px";  // Assign the desired top position using pos.top. Here it is calculated for top of the field
            if (type != "warning") {
                if(!jqWidget.errorDiv){
                                                                                //Adding the warning div if it is not present already
                    jqWidget.errorDiv=$("<div id='customError'></div>").appendTo('body');
                }
                jqWidget.$css(jqWidget.errorDiv.get(0), styles); // Applying the styles to the warning div
                jqWidget.errorDiv.text(msg).show();                     //Showing the warning message
            } else {
                if(!jqWidget.errorDiv){
                                                                                //Adding the error div if it is not present already
                    jqWidget.errorDiv=$("<div id='customWarning'></div>").appendTo('body');
                }
                jqWidget.$css(jqWidget.errorDiv.get(0), styles); // Applying the styles to the error div
                jqWidget.errorDiv.text(msg).show();                     //Showing the warning message
            }

        },

  4. Guarde y cierre el archivo.

  5. Navegue hasta la carpeta CustomErrorManager-1.0-SNAPSHOT y cree un archivo de carpetas jcr_root y META-INF. Cambie el nombre del archivo a CustomErrorManager-1.0-SNAPSHOT.zip.

  6. Utilice el Administrador de paquetes para cargar e instalar el paquete.

Mostrar mensajes de error para varios campos  display-error-messages-for-multiple-fields-nbsp

Utilice el paquete adjunto para mostrar simultáneamente los mensajes de error de todos los campos. Para mostrar un solo mensaje de error, utilice el perfil predeterminado.

Personalizar la apariencia de los mensajes de error.  customizing-the-appearance-of-error-messages-nbsp

  1. Navegue hasta la carpeta etc\clientlibs\mf-custom-error-manager\CustomErrorManager\css.

  2. Abra el archivo sample.css para editarlo. El archivo css contiene 2 ids- #customError, #customWarning. Puede utilizar estos identificadores para cambiar varias propiedades como el color y el tamaño de la fuente.

    Utilice el siguiente código para cambiar el tamaño de la fuente y el color de los mensajes de error/advertencia.

    code language-css 
    #customError {
color: #0000FF; // it changes the color of Error Message
display:none;
position:absolute;
opacity:0.85;
font-size: 24px;  // it changes the font size of Error Message
z-index:5;
}

#customWarning {
color: #00FF00;  // it changes the color of Warning Message
display:none;
position:absolute;
opacity:0.85;
font-size: 18px;   // it changes the font size of Warning Message
z-index:5;
}

Save the changes.

  3. Guarde y cierre el archivo.

  4. Navegue hasta la carpeta CustomErrorManager-1.0-SNAPSHOT y cree un archivo de carpetas jcr_root y META-INF. Cambie el nombre del archivo a CustomErrorManager-1.0-SNAPSHOT.zip.

  5. Utilice el Administrador de paquetes para cargar e instalar el paquete.

Procese el formulario con el nuevo perfil.  render-the-form-with-the-new-profile-nbsp

De forma predeterminada, los formularios HTML5 utilizan un perfil predeterminado: https://&lt;server&gt;/content/xfaforms/profiles/default.html?contentRoot=&lt;xdp location&gt;&template=&lt;name of the xdp&gt;

Para ver un formulario con los mensajes de error personalizados, procese el formulario con un perfil de error: https://&lt;server&gt;/content/xfaforms/profiles/error.html?contentRoot=&lt;xdp location&gt;&template=&lt;name of the xdp&gt;

NOTE
El paquete adjunto instala el perfil de error.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2