Home

atlas manual de usuario componente de calendario

1. Su A gt 6 de 13 cd Agencia de Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario Fichero xhtml lt atlas calendario 1d calendarioSinFestivos value t calendarioSampleBean fecha2 festivosHabilidatos false title f bundle calendar fecha label bundle calendar fecha inputClass cajaTexto zindex 10 inputSize 8 gt Los atributos del componente son los siguientes Nombre atributo Obligatorio Descripci n boundaryDatesMode NO Modo de los l mites de las fechas Los posibles valores son inactive scroll select Por defecto es inactive buttonClass NO Clases de estilo del bot n Por defecto este campo esta vac o datePattern NO Patr n de Fecha para establecer el d a seleccionado como una cadena El valor por defecto es dd MM yyyy direction NO Define la direccion del calendario top left top right bottom left bottom right Default auto El valor por defecto es bottom right entidad Codigo de la entidad para la cual se van a mostar sus festivos Por defecto vac o festivoLocalClass Se Estilo de los d as festivos de la Localidad Seleccionada de los d as festivos de la Localidad Seleccionada festivosHabilitados Booleano para especificar si en el calendario van a aparecer resaltados los d as festivos festivosSeleccionables NO Booleano que indica si los festivos son seleccionables por parte del usuario festivoStyleClass
2. 1 1 AMEN ELABORA ac uc 4 1 2 CONOCIMIENTOS PREVIO a o 4 A ME ON eau as 4 3 INSTALACI N Y CONFIGURACI N eeesesesoesesesoesesosoesesosossesosossesosoesesoseesososeesosoesesosossesosossesosossesosoesesoseesososesosossesosos 5 BL INSI VN O CON 5 32 CONFIGURACION 5 Ll 7 A SEN 6 4 1 PASO 1 DEFINICI N DEL ESPACIO DE NOMBRES DE ETIQUETAS DE ATLAS 6 4 2 PASO 2 INSERCI N EN LA P GINA DE LA ETIQUETA DE ATLAS 6 4 3 PASO 3 CREACI N DEL BEAN DE RESPALDO ocooccoocnnconnonnonnnnn nn anar nn r nn r nan nn rmac nnannnss 9 4 4 RECOMENDACIONES Y BUENAS PR CTICAS naaa 11 4 5 MAITE MS A II II EA EA 11 5 PREGUNTAS M S FRECUENTES ENEE 12 6 TIENEACES RELACIONADOS dida 13 Ak kk xk kk 3 de 13 c Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario 4 INTRODUCCI N Este documento contiene el manual de uso del componente visual Calendario del Framework Atlas Se incluye informaci n sobre c mo utilizar dicho componente en una aplicaci n Web as como informaci n acerca de la configuraci n de los par metros fundamentales del componente 1 1 AUDIENCIA OBJETIVO Este documento est orientado a toda aquella persona que est desarrollando una aplicaci n Web basada en el Framework Atlas y necesite utilizar componentes de presentaci n en su aplicaci n Web 1 2 CONOCIMIENTOS PREVIOS Para un completo entendimiento del documento el lector deber tener conocimientos pre
3. Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario ondatemouseover NO C digo javascript ejecutado cuando el cursor entra en el componente ondateselect NO C digo javascript ejecutado cuando se selecciona una fecha onhide NO C digo javascript ejecutado despu s de que se oculte el popup oninputblur NO C digo javascript ejecutado cuando el input de la fecha pierde el foco oninputchange NO C digo javascript ejecutado cuando el intput de la fecha cambia oninputclick O C digo javascript ejecutado cuando se hace click sobre el input de la fecha oninputdblclick O C digo javascript ejecutado cuando se hace doble click sobre el input de la fecha oninputfocus O C digo javascript ejecutado cuando el input de la fecha recibe el foco oninputkeydown NO C digo javascript ejecutado cuando se pulsa una tecla en el input de la fecha oninputkeypress O C digo javascript ejecutado cuando tras pulsar una tecla sobre el input se deja de pulsar oninputkeyup NO C digo javascript ejecutado despu s de pulsar una tecla en el input de la fecha oninputmousedown NO C digo javascript ejecutado cuando se hace click en el input del componente oninputmousemove O C digo javascript ejecutado cuando se mueve el rat n en el input del componente oninputmouseout NO C digo javascript ejecutado cuando el cursor sale del input del componente oninputmouseover O C digo javascript ejecutado cuando el cursor entra en
4. el input del componente oninputmouseup NO C digo javascript ejecutado despu s de pulsar con el rat n sobre el input del componente oninputselect NO C digo javascript ejecutado cuando se selecciona el input del componente onshow NO C digo javascript ejecutado cuando se muestra el popup del componente 4 3 Paso 3 Creaci n del bean de respaldo Por otra parte es necesario crear una clase que consiste en un backing bean donde se recibir el valor que ha sido seleccionado por el usuario A continuaci n se muestra un ejemplo de dicha clase kk KRK cm de 13 pa a Agencia de a o Framework Atlas C Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario CalendarioSampleBean java package atlas samples bean pk The Class CalendarioSampleBean SE public class CalendarioSampleBean private Date fechal private Date fecha2 public Date getFechal return fechal public void setFechal Date fecha this fechal fecha public Date getFecha2 return fecha2 public void setFechal Date fecha this fecha2 fecha Es necesario tambi n configurar dicho bean en el fichero de configuraci n de JSF en web src main webapp WEB INF faces managed beans xml Un ejemplo de configuraci n podr a ser la siguiente faces managed beans xml lt managed bean gt lt description gt Bean de respaldo de calendarios lt description gt lt managed bean na
5. en la hoja de estilos o EI componente tiene un par metro para elegir si los d as festivos pueden ser seleccionados o no For mulai IO Fecha sin festivos Fecha con festivos Localiciad Festivos Sseleccionables H A 13 1 ei 10 111112 13 14 1495 z 18 19 2012 24 2526 27 120 31 Resultado Ver c digo 3 INSTALACI N Y CONFIGURACI N En este apartado se incluye informaci n sobre la instalaci n y la configuraci n del componente Calendario 3 1 INSTALACI N El componente del calendario ya viene instalado en el arquetipo Web incluido con el m dulo de componentes visuales Por este motivo no es necesaria una instalaci n adicional si se parte del arquetipo 3 2 CONFIGURACI N Este componente no requiere configuraci n adicional Ke Li 5 de 13 vc Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario 4 USO Una vez instalado el m dulo de componentes puede procederse a su utilizaci n Para ello deben realizarse los pasos indicados en los siguientes apartados 4 1 Paso 1 Definici n del espacio de nombres de etiquetas de Atlas Es necesario crear un fichero xhtml y establecer la definici n del espacio de nombres para las etiquetas de componentes de Atlas Un ejemplo de cabecera de fichero xhtml es la siguiente Fichero xhtml lt xml version 1 0 encoding UTF 8 gt lt DOCTYPE html PUBLIC W3C DTD XHTML 1 0 Transi
6. ATLAS MANUAL DE USUARIO COMPONENTE DE CALENDARIO Versi n 1 4 rea de Aplicaciones Especiales y Arquitectura de Software d ab ab ell em Agencia de Inform tica y Comunicaciones de la Comunidad de Madrid vc Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario Hoja de Control T tulo Manual de usuario del Componente Calendario Documento de NORMATIVA ATLAS Referencia Responsable rea de Aplicaciones Especiales y Arquitectura de Software A Fecha Versi n 20 11 2013 Registro de Cambios Versi n Causa del Cambio Responsable del Cambio Fecha del Cambio rea de Integraci n y Arquitectura de Versi n inicial del documento SEH 26 05 2010 Aplicaciones Secci n 2 Descripci n rea de Integraci n y Arquitectura de 1 Modificada la captura del Apli 15 02 2011 plicaciones componente Se a aden a la lista de atributos rea de Aplicaciones Especiales y 3 del componente nuevos eventos 26 10 2012 Arquitectura de Software javascript 1 0 1 l rea de Aplicaciones Especiales y 1 2 Se modifica el nombre del rea 28 09 2011 Arquitectura de Software 1 rea de Aplicaciones Especiales y 1 4 Se a ade el atributo disabled I 20 11 2013 Arquitectura de Software Ke Li 2 de 13 Adi Agencia de Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario ndice 1 TMNERODUCCI N ti 4
7. Estilo de los d as festivos de la Comunidad de Madrid Este estilo debe estar en el css de la aplicaci n inputClass a Estilo caja detexto caja de texto mme NO Tama o de la caja de texto donde se establece la fecha jointPoint NO Este atributo sirve para establecer la capa relativamente a la caja de texto donde se establece la fecha Los valores posibles son top left top right bottom left Por defecto bottom right auto locale NO Identificador para la definici n de Locale Por defecto es el valor de definici n de Locale por defecto en el servidor kk RRK cm 7 de 13 cd Agencia de Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario localidad NO Atributo que indica el c digo de la localidad para mostrar sus festivos Por ejemplo 079 para Madrid Capital Por defecto vac o Valores v lidos ajax o client El valor por defecto es ajax monthLabels Personalizaci n de las etiquetas de los meses Por defecto son Enero Febrero Marzo Abril Mayo Junio Julio Agosto Septiembre Octubre Noviembre Diciembre monthLabelsShort Personalizaci n de las etiquetas de los meses cuando aparecen en su formato corto Por defecto son Ene Feb Mar Abr May Jun Jul Ago Sep Oct Nov Dic popup NO Valor truelfalse para seleccionar si este componente se va a mostrar como un pop up Por defecto es true ren
8. dered NO Valor truelfalse para seleccionar si este componente se va a mostrar Por defecto es true disabled Valor truejfalse para indicar si el componente est deshabilitado Por defecto false Nota Si se activa el atributo rendered ser deshabilitado y si el componente est en modo sa ambos atributos ser n deshabilitados rendered y popup showWeeksBar Booleano que determina si aparece la barra vertical de semanas todayControlMode ar Indica la configuraci n del par metro Hoy value EL Expression Language que indica el atributo de backing bean donde se guardar la fecha que sea seleccionada weekDayLabelsShort Personalizaci n de las etiquetas de los d as Dom Lun Mar Mie Jue Vie Sab zindex Atributo similar al estadar HTML Puede indicar posicionamiento relativo del contenido Por defecto es onbeforedateselect C digo javascript ejecutado cuando se selecciona una fecha onchange C digo javascript ejecutado cuando el componente pierde el foco y el valor se ha modificado onclean NO C digo javascript ejecutado cuando se limpiar el valor del componente oncomplete NO C digo javascript ejecutado cuando se completa una petici n oncurrentdateselect NO C digo javascript ejecutado cuando se modifica el mes o a o seleccionado ondatemouseout NO C digo javascript ejecutado cuando la fecha pierde el cursor kk kk Icm 8 de 13 c Agencia de o Framework Atlas Te
9. me gt calendarioSampleBean lt managed bean name gt lt managed bean class gt atlas samples bean CalendarioSampleBean lt managed bean class gt lt managed bean scope gt request lt managed bean scope gt lt managed bean gt AAA Xx gt 10 de 13 VE Agencia de hb Framework Atlas C Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario 4 4 RECOMENDACIONES Y BUENAS PR CTICAS Si se decide cambiar el tono de los colores del componente se recomienda que no sean colores fuertes para que cumpla la accesibilidad WCAG 4 5 EJEMPLO DE USO Se puede ver un ejemplo de dicho componente en la aplicaci n de demostraci n de componentes bajo la siguiente secuencia de navegaci n Inicio gt Formularios gt Calendario L S ZA E 11 de 13 e Agencia de o Framework Atlas Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario 5 PREGUNTAS M S FRECUENTES En este apartado se incluyen una lista de preguntas m s frecuentes sobre el componente Pregunta D nde puedo encontrar informaci n general sobre los componentes Respuesta En la aplicaci n de demostraci n de los componentes del Framework Atlas Pregunta C mo se ha implementado el componente en su capa de presentaci n Respuesta Mediante un componente de Facelets Hace uso adem s de un componente de calendario de RichFaces Pregunta C mo puedo modificar los estilos del componente Res
10. puesta Mediante los atributos de estilo del componente Para m s informaci n consultar la tabla de atributos en la secci n de Uso del componente RRK 12 de 13 kk Ak Ak kkk Agencia de C Inform tica y Comunicaciones de la Comunidad de Madrid Framework Atlas Componente Calendario 6 ENLACES RELACIONADOS Producto URL Ajax4JSF Barbecue Commons BeanUtils Commons Configurations Facelets Hibernate Hibernate Annotations JAXB Jcaptcha JPA JSF JSFUnit Log4J MyFaces Core RichFaces Spring Spring Security Velocity http www jboss org jbossrichfaces http barbecue sourceforge net commons apache org beanutils http commons apache org configuration https facelets dev java net http www hibernate org http www hibernate org hib_docs annotations reference en html_single http java sun com webservices jaxb captcha sourceforge net http ava sun com developer technicalArticles J2EE pa http ava sun com javaee javaserverfaces http www boss org sfunit http logging apache orqg log4j http myfaces apache org http www boss org bossrichfaces http www springframework org httpo www springframework orqg http velocity apache org kk LW GA ET 13 de 13
11. tional EN DEE ww WS EE MR xhtml 1 DTD nem1L1 transitional drd gt lt html xmlns http www w3 org 1999 xhtml xml lang es xmlns ui http java sun com 3sf facelets mins h http Java sun com 8tf ntml mins t http J ava sun com st core xmlns atlas http atlas core componentes 3sf gt 4 2 Paso 2 Inserci n en la p gina de la etiqueta de Atlas Es necesario insertar la etiqueta en la p gina Un ejemplo para un calendario con festivos habilitados es el siguiente Fichero xhtml lt atlas calendario id calendarioFestivos value calendarioSampleBean fechal festivosHabilidatos true festivosseleccionables true localidad 79 festivoStyleClass festivosCcAMm festivolocalClass festivoslLocal title bundle calendar fecha label bundle calendar fecha inputClass cajaTexto zindex 10 inputSize 8 gt En este ejemplo se establece en el formulario un calendario en el que aparecen los festivos habilitados Con lo cu l aparecer n los festivos habilitados de la Comunidad de Madrid Adem s como el atributo localidad es 79 entonces aparecer n tambi n los festivos habilitados para el Municipio de Madrid Capital Y por otra parte los d as festivos podr n ser seleccionados por el usuario debido a que as se espec fica mediante el atributo festivosSeleccionables En el siguiente ejemplo se presenta un calendario en el cu l no aparecer n los festivos de una manera destacada
12. vios sobre las siguientes tecnolog as e Java Server Faces JSF e Facelets e Spring Framework e Hibernate Para saber m s sobre dichas tecnolog as consultar el apartado de este documento Enlaces Relacionados 2 DESCRIPCI N Este componente sirve para introducir un dato de tipo fecha en un formulario Se basa en el componente de calendario del API RichFaces con funcionalidad a adida para la presentaci n de festivos de la Comunidad de Madrid El componente tiene las siguientes caracter sticas e Enlace para seleccionar el d a de hoy o Siel usuario pulsa sobre el enlace Hoy entonces se seleccionar el d a actual como valor del campo de tipo fecha e El usuario podr pulsar sobre uno de los d as que se presentan El d a seleccionado aparecer en la caja de texto correspondiente e D as festivos o El componente tiene una opci n para que se distingan los d as festivos del resto de los d as o Los d as festivos de la Comunidad de Madrid aparecer n distinguidos por un estilo correspondiente a este tipo de d as Este estilo puede ser configurado en la hoja de estilos o Los d as festivos de una poblaci n pasando un identificador como par metro al kk LW GA m 4de 13 TERI Agencia de Framework Atlas kk xk Te Inform tica y Comunicaciones de la Comunidad de Madrid Componente Calendario componente aparecer n distinguidos por un estilo correspondiente Este estilo puede ser configurado

atlas manual de usuario componente de calendario

Contents

Download Pdf Manuals

Related Search

Related Contents