Diseño interactivo para páginas web responsive-design-for-web-pages

Diseñe las páginas web para que se adapten a la ventanilla del cliente en la que se muestran. Con un diseño interactivo, las mismas páginas se pueden mostrar de forma eficaz en varios dispositivos en ambas orientaciones. La siguiente imagen muestra algunas maneras en que una página puede responder a los cambios en el tamaño de la ventanilla móvil:

Desarrolle aplicaciones de Adobe Experience Manager (AEM) que generen páginas de HTML5 que se adapten a múltiples tamaños de ventana y orientaciones. Por ejemplo, los siguientes intervalos de anchura de las ventanillas móviles se corresponden con varios tipos de dispositivos y orientaciones

Consulte los siguientes temas para obtener información sobre la implementación del comportamiento de diseño interactivo:

A medida que diseña, use Barra de tareas para obtener una vista previa de las páginas de distintos tamaños de pantalla.

Antes de desarrollar before-you-develop

Antes de desarrollar la aplicación de AEM que admite las páginas web, se deben tomar varias decisiones de diseño. Por ejemplo, debe tener la siguiente información:

Estructura de la aplicación application-structure

La estructura de aplicación AEM típica admite todas las implementaciones de diseño adaptables:

Uso de consultas de medios using-media-queries

Las consultas de medios permiten el uso selectivo de estilos CSS para el procesamiento de páginas. AEM herramientas y funciones de desarrollo le permiten implementar de forma eficaz y eficiente las consultas de medios en sus aplicaciones.

El grupo W3C proporciona la variable Consultas multimedia recomendación que describe esta función de CSS3 y la sintaxis.

Creación del archivo CSS creating-the-css-file

En el archivo CSS, defina las consultas de medios en función de las propiedades de los dispositivos a los que esté dirigiendo. La siguiente estrategia de implementación es efectiva para administrar estilos para cada consulta de medios:

El ejemplo de We.Retail Media utiliza esta estrategia para definir estilos en el diseño del sitio. El archivo CSS utilizado por We.Retail se encuentra en */apps/weretail/clientlibs/clientlib-site/less/grid.less.

La tabla siguiente muestra los archivos de la carpeta secundaria css.

El archivo css.txt en la variable /etc/designs/weretail/clientlibs carpeta enumera los archivos CSS que incluye la carpeta de biblioteca del cliente. El orden de los archivos implementa la prioridad de estilo. Los estilos son más específicos a medida que disminuye el tamaño del dispositivo.

#base=css

style.css
 bootstrap.css

responsive-1200px.css
 responsive-980px-1199px.css
 responsive-768px-979px.css
 responsive-767px-max.css
 responsive-480px.css

Sugerencia: Los nombres de archivo descriptivos permiten identificar fácilmente el tamaño de la ventanilla objetivo.

Uso de consultas de medios con páginas AEM using-media-queries-with-aem-pages

Incluya la carpeta de la biblioteca del cliente en el script JSP del componente de la página para generar el archivo CSS que incluye las consultas de medios y para hacer referencia al archivo.

<ui:includeClientLib categories="apps.weretail.all"/>

El script JSP genera el siguiente código de HTML que hace referencia a las hojas de estilo:

<link rel="stylesheet" href="/etc/designs/weretail/clientlibs-all.css" type="text/css">
<link href="/etc/designs/weretail.css" rel="stylesheet" type="text/css">

Vista previa para dispositivos específicos previewing-for-specific-devices

Consulte vistas previas de las páginas en diferentes tamaños de ventanilla móvil para probar el comportamiento del diseño interactivo. En Vista previa modo, Barra de tareas incluye un Dispositivos menú desplegable que utiliza para seleccionar un dispositivo. Al seleccionar un dispositivo, la página cambia para adaptarse al tamaño de la ventanilla móvil.

Para activar la vista previa del dispositivo en Barra de tareas, debe configurar la página y la variable MobileEmulatorProvider servicio. Otra configuración de página controla la lista de dispositivos que aparecen en la Dispositivos lista.

Adición de la lista de dispositivos adding-the-devices-list

La variable Dispositivos la lista aparece en Barra de tareas cuando su página incluye el script JSP que procesa el Dispositivos lista. Para agregar la variable Dispositivos a Barra de tareas, incluya el /libs/wcm/mobile/components/simulator/simulator.jsp en el head de su página.

Incluya el siguiente código en el JSP que define la variable head sección:

<cq:include script="/libs/wcm/mobile/components/simulator/simulator.jsp"/>

Para ver un ejemplo, abra el /apps/weretail/components/page/head.jsp en CRXDE Lite.

Registro de componentes de página para simulación registering-page-components-for-simulation

Para permitir que el simulador de dispositivos admita sus páginas, registre los componentes de su página con el servicio de fábrica MobileEmulatorProvider y defina la variable mobile.resourceTypes propiedad.

Al trabajar con AEM hay varios métodos para administrar los ajustes de configuración de dichos servicios; see Configuración de OSGi para obtener más información.

Por ejemplo, para crear un [sling:OsgiConfig](/docs/experience-manager-64/deploying/configuring/configuring-osgi.md#adding-a-new-configuration-to-the-repository) en la aplicación:

Agregue la siguiente propiedad de nodo:

Especificación de los grupos de dispositivos specifying-the-device-groups

Para especificar los grupos de dispositivos que aparecen en la lista Dispositivos, agregue una cq:deviceGroups a la jcr:content nodo de la página raíz del sitio. El valor de la propiedad es una matriz de rutas a los nodos de grupo de dispositivos.

Los nodos del grupo de dispositivos se encuentran en la variable /etc/mobile/groups carpeta.

Por ejemplo, la página raíz del sitio de Geometrixx Medias es /content/geometrixx-media. La variable /content/geometrixx-media/jcr:content incluye la siguiente propiedad:

Utilice la consola Herramientas para crear y editar grupos de dispositivos.

Uso de imágenes adaptables using-adaptive-images

Puede utilizar consultas de medios para seleccionar un recurso de imagen para mostrar en la página. Sin embargo, todos los recursos que utilizan una consulta de medios para condicionalizar su uso se descargan al cliente. La consulta de medios simplemente determina si se muestra el recurso descargado.

Para recursos de gran tamaño, como imágenes, la descarga de todos los recursos no es un uso eficiente de la canalización de datos del cliente. Para descargar recursos de forma selectiva, utilice javascript para iniciar la solicitud de recursos después de que las consultas de medios realicen la selección.

La siguiente estrategia carga un único recurso que se elige mediante consultas de medios:

Evaluación de consultas de medios mediante JavaScript evaluating-media-queries-using-javascript

Implementación de Interfaz MediaQueryList que define W3C permite evaluar consultas de medios mediante javascript. Puede aplicar lógica a los resultados de la consulta de medios y ejecutar secuencias de comandos que estén dirigidas a la ventana actual:

Selección de recursos específicos de medios selecting-media-specific-resources

El W3C propuesto elemento de imagen utiliza consultas de medios para determinar el origen que se utilizará para los elementos de imagen. El elemento de imagen utiliza atributos de elemento para asociar consultas de medios con rutas de imágenes.

La disponibilidad gratuita biblioteca picturefill.js proporciona una funcionalidad similar a la propuesta picture y utiliza una estrategia similar. Las llamadas a la biblioteca picturefill.js window.matchMedia para evaluar las consultas de medios definidas para un conjunto de div elementos. Cada div element también especifica un origen de imagen. El origen se utiliza cuando la consulta de medios del div elementos devueltos true.

La variable picturefill.js La biblioteca de requiere un código de HTML similar al del siguiente ejemplo:

<div data-picture>
    <div data-src='path to default image'></div>
    <div data-src='path to small image'    data-media="(media query for phone)"></div>
    <div data-src='path to medium image'   data-media="(media query for tablet)"></div>
    <div data-src='path to large image'     data-media="(media query for monitor)"></div>
</div>

Cuando se representa la página, picturefull.js inserta un img como el último elemento secundario del <div data-picture> elemento:

<div data-picture>
    <div data-src='path to default image'></div>
    <div data-src='path to small image'    data-media="(media query for phone)"></div>
    <div data-src='path to medium image'   data-media="(media query for tablet)"></div>
    <div data-src='path to large image'     data-media="(media query for monitor)"></div>
    <img src="path to medium image">
</div>

En una página AEM, el valor de la variable data-src es la ruta a un recurso en el repositorio.

Implementación de imágenes adaptables en AEM implementing-adaptive-images-in-aem

Para implementar imágenes adaptables en la aplicación de AEM, debe agregar las bibliotecas de javascript necesarias e incluir el marcado de HTML requerido en las páginas.

Bibliotecas

Obtenga las siguientes bibliotecas de javascript e inclúyalas en una carpeta de la biblioteca del cliente:

Sugerencia: Puede concatenar automáticamente varias carpetas de la biblioteca de cliente mediante incrustar.

HTML

Cree un componente que genere los elementos div necesarios que el código picturefill.js espera. En una página AEM, el valor del atributo data-src es la ruta a un recurso en el repositorio. Por ejemplo, un componente de página puede codificar de forma rígida las consultas de medios y las rutas asociadas para las representaciones de imágenes en DAM. O bien, cree un componente de imagen personalizado que permita a los autores seleccionar representaciones de imagen o especificar opciones de renderización en tiempo de ejecución.

El siguiente HTML de ejemplo selecciona entre 2 representaciones DAM de la misma imagen.

<div data-picture>
    <div data-src='/content/dam/geometrixx-media/articles/meridien.png'></div>
    <div data-src='/content/dam/geometrixx-media/articles/meridien.png/jcr:content/renditions/cq5dam.thumbnail.319.319.png'    data-media="(min-width: 769px)"></div>
    <div data-src='/content/dam/geometrixx-media/articles/meridien.png/jcr:content/renditions/cq5dam.thumbnail.140.100.png'   data-media="(min-width: 481px)"></div>
</div>

Explicación de la renderización de imágenes en AEM understanding-image-rendering-in-aem

Para personalizar la renderización de imágenes, debe comprender la implementación AEM de renderización de imágenes estáticas predeterminada. AEM proporciona el componente Imagen y un servlet de renderización de imágenes que trabajan juntos para procesar imágenes para una página web. La siguiente secuencia de eventos se produce cuando el componente Imagen se incluye en el sistema de párrafos de la página:

Por ejemplo, el JSP del componente Imagen genera el siguiente elemento HTML:

<img title="My Image" alt="My Image" class="cq-dd-image" src="/content/mywebsite/en/_jcr_content/par/image_0.img.jpg/1358372073597.jpg">

Cuando el explorador carga la página, solicita la imagen utilizando el valor del atributo src como dirección URL. Sling descompone la dirección URL:

La variable image_0 el nodo tiene un jcr:resourceType valor de foundation/components/image, que tiene un sling:resourceSuperType valor de foundation/components/parbase. El componente parbase incluye la secuencia de comandos img.GET.java que coincide con el selector y la extensión de nombre de archivo de la dirección URL de la solicitud. CQ utiliza este script (servlet) para renderizar la imagen.

Para ver el código fuente de la secuencia de comandos, utilice CRXDE Lite para abrir el /libs/foundation/components/parbase/img.GET.java
archivo.

Escalado de imágenes para el tamaño actual de la ventanilla móvil scaling-images-for-the-current-viewport-size

Escale las imágenes durante la ejecución según las características de la ventanilla móvil del cliente para proporcionar imágenes que se ajusten a los principios del diseño interactivo. Utilice el mismo patrón de diseño que la representación de imágenes estáticas, utilizando un servlet y un componente de creación.

El componente debe realizar las siguientes tareas:

El servlet que procesa la solicitud de imagen debe realizar las siguientes tareas:

Soluciones disponibles

AEM instala las siguientes implementaciones que puede utilizar o ampliar.

Explicación del componente de imagen adaptable understanding-the-adaptive-image-component

El componente de imagen adaptable genera llamadas al servlet del componente de imagen adaptable para procesar una imagen cuyo tamaño depende de la pantalla del dispositivo. El componente incluye los siguientes recursos:

Adición de elementos DIV adding-the-div-elements

El script adaptive-image.jsp incluye el siguiente código que genera elementos div y consultas de medios:

<div data-picture data-alt='<%= alt %>'>
    <div data-src='<%= path + ".img.320.low." + extension + suffix %>'       data-media="(min-width: 1px)"></div>                                        <%-- Small mobile --%>
    <div data-src='<%= path + ".img.320.medium." + extension + suffix %>'    data-media="(min-width: 320px)"></div>  <%-- Portrait mobile --%>
    <div data-src='<%= path + ".img.480.medium." + extension + suffix %>'    data-media="(min-width: 321px)"></div>  <%-- Landscape mobile --%>
    <div data-src='<%= path + ".img.476.high." + extension + suffix %>'      data-media="(min-width: 481px)"></div>   <%-- Portrait iPad --%>
    <div data-src='<%= path + ".img.620.high." + extension + suffix %>'      data-media="(min-width: 769px)"></div>  <%-- Landscape iPad --%>
    <div data-src='<%= path + ".img.full.high." + extension + suffix %>'     data-media="(min-width: 1025px)"></div> <%-- Desktop --%>

    <%-- Fallback content for non-JS browsers. Same img src as the initial, unqualified source element. --%>
    <noscript>
        <img src='<%= path + ".img.320.low." + extension + suffix %>' alt='<%= alt %>'>
    </noscript>
</div>

La variable path contiene la ruta del recurso actual (el nodo de componente de imagen adaptable). El código genera una serie de div elementos con la siguiente estructura:

<div data-scr = "*path-to-parent-node*.adaptive-image.adapt.*width*.*quality*.jpg" data-media="*media query*"></div>

El valor de la variable data-scr es una URL que Sling resuelve en el servlet del componente de imagen adaptable que procesa la imagen. El atributo data-media contiene la consulta de medios que se evalúa en relación con las propiedades del cliente.

El siguiente código de HTML es un ejemplo de la variable div elementos que genera el JSP:

<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.320.low.jpg'></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.320.medium.jpg'    data-media="(min-width: 320px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.480.medium.jpg'    data-media="(min-width: 321px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.476.high.jpg'     data-media="(min-width: 481px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.620.high.jpg'     data-media="(min-width: 769px)"></div>
    <div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.full.high.jpg'     data-media="(min-width: 1025px)"></div>

Cambio de los selectores de tamaño de imagen changing-the-image-size-selectors

Si personaliza el componente de imagen adaptable y cambia los selectores de anchura, también debe configurar el servlet del componente de imagen adaptable para que admita los anchos.

Explicación del servlet del componente de imagen adaptable understanding-the-adaptive-image-component-servlet

El servlet del componente de imagen adaptable cambia el tamaño de una imagen de JPEG según una anchura especificada y establece la calidad del JPEG.

Interfaz del servlet del componente de imagen adaptable the-interface-of-the-adaptive-image-component-servlet

El servlet del componente de imagen adaptable está enlazado al servlet Sling predeterminado y admite las extensiones de archivo .jpg, .jpeg, .gif y .png. El selector de servlet es img.

Por lo tanto, Sling resuelve las URL de solicitud HTTP del siguiente formato para este servlet:

*path-to-node*.img.*extension*

Por ejemplo, Sling reenvía solicitudes HTTP con la dirección URL http://localhost:4502/content/geometrixx/adaptiveImage.img.jpg a Servlet de componente de imagen adaptable.

Dos selectores adicionales especifican la anchura de la imagen solicitada y la calidad del JPEG. El siguiente ejemplo solicita una imagen de anchura de 480 píxeles y calidad media:

http://localhost:4502/content/geometrixx/adaptiveImage.adapt.480.MEDIUM.jpg

Propiedades de imagen admitidas

El servlet acepta un número finito de anchos y cualidades de imagen. Los siguientes anchos son compatibles de forma predeterminada (en píxeles):

El valor completo indica que no se ha realizado ninguna escala.

Se admiten los siguientes valores para la calidad del JPEG:

Los valores numéricos son 0,4, 0,82 y 1,0, respectivamente.

Cambio de los anchos predeterminados admitidos

Utilice la consola web (http://localhost:4502/system/console/configMgr) o un nodo sling:OsgiConfig para configurar los anchos compatibles del servlet del componente de imagen adaptable de Adobe CQ.

Para obtener información sobre cómo configurar AEM servicios, consulte Configuración de OSGi.

Detalles de implementación implementation-details

La variable com.day.cq.wcm.foundation.impl.AdaptiveImageComponentServlet amplía la AbstractImageServlet Clase . El código fuente AdaptiveImageComponentServlet se encuentra en la variable /libs/foundation/src/impl/src/com/day/cq/wcm/foundation/impl carpeta.

La clase utiliza anotaciones Felix SCR para configurar el tipo de recurso y la extensión de archivo con los que está asociado el servlet, así como el nombre del primer selector.

@Component(metatype = true, label = "Adobe CQ Adaptive Image Component Servlet",
        description = "Render adaptive images in a variety of qualities")
@Service
@Properties(value = {
    @Property(name = "sling.servlet.resourceTypes", value = "foundation/components/adaptiveimage", propertyPrivate = true),
    @Property(name = "sling.servlet.selectors", value = "img", propertyPrivate = true),
    @Property(name = "sling.servlet.extensions", value ={
            "jpg",
            "jpeg",
            "png",
            "gif"
    }, propertyPrivate = true)
})

El servlet utiliza la anotación SCR de propiedad para establecer la calidad y las dimensiones de la imagen admitidas por defecto.

@Property(value = {
            "320", // iPhone portrait
            "480", // iPhone landscape
            "476", // iPad portrait
            "620" // iPad landscape
    },
            label = "Supported Widths",
            description = "List of widths this component is permitted to generate.")

La variable AbstractImageServlet proporciona la variable doGet método que procesa la solicitud HTTP. Este método determina el recurso asociado a la solicitud, recupera las propiedades de los recursos del repositorio y las devuelve en un ImageContext objeto.

La variable AdaptiveImageComponentServlet la clase anula la función createLayer método. El método obtiene la ruta del recurso de imagen y la anchura de la imagen solicitada desde el ImageContext objeto. A continuación, llama a los métodos de la variable info.geometrixx.commons.impl.AdaptiveImageHelper que realiza el escalado real de la imagen.

La clase AdaptiveImageComponentServlet también anula el método writeLayer. Este método aplica la calidad de JPEG a la imagen.

Servlet de modificación de referencia de imagen (Geometrixx común) image-reference-modification-servlet-geometrixx-common

El servlet de modificación de referencia de imagen de ejemplo genera atributos de tamaño para que el elemento img escale una imagen en la página web.

Llamada al servlet calling-the-servlet

El servlet está enlazado a cq:page y admite la extensión de archivo .jpg . El selector de servlet es image. Por lo tanto, Sling resuelve las URL de solicitud HTTP del siguiente formato para este servlet:

path-to-page-node.image.jpg

Por ejemplo, Sling reenvía solicitudes HTTP con la dirección URL http://localhost:4502/content/geometrixx/en.image.jpg al servlet de modificación de referencia de imagen.

Tres selectores adicionales especifican la anchura, la altura y la calidad de la imagen solicitada (opcionalmente). En el siguiente ejemplo se solicita una imagen de anchura de 770 píxeles, altura de 360 píxeles y calidad media.

http://localhost:4502/content/geometrixx/en.image.770.360.MEDIUM.jpg

Propiedades de imagen admitidas

El servlet acepta un número finito de dimensiones de imagen y valores de calidad.

Los siguientes valores son compatibles de forma predeterminada (widthxheight):

Se admiten los siguientes valores para la calidad de imagen:

Al trabajar con AEM hay varios métodos para administrar los ajustes de configuración de dichos servicios; see Configuración de OSGi para obtener más información.

Especificación del recurso de imagen specifying-the-image-resource

La ruta de la imagen, las dimensiones y los valores de calidad deben almacenarse como propiedades de un nodo en el repositorio:

Al crear una página, utilice Barra de tareas para especificar la imagen y agregar la variable image a las propiedades de la página:

Detalles de implementación implementation-details-1

La clase info.geometrixx.commons.impl.servlets.ImageReferenceModificationServlet amplía la AbstractImageServlet Clase . Si tiene instalado el paquete cq-geometrixx-commons-pkg, el código fuente ImageReferenceModificationServlet se encuentra en la variable /apps/geometrixx-commons/src/core/src/main/java/info/geometrixx/commons/impl/servlets carpeta.

La clase utiliza anotaciones Felix SCR para configurar el tipo de recurso y la extensión de archivo con los que está asociado el servlet, así como el nombre del primer selector.

@Component(metatype = true, label = "Adobe CQ Image Reference Modification Servlet",
        description = "Render the image associated with a page in a variety of dimensions and qualities")
@Service
@Properties(value = {
    @Property(name = "sling.servlet.resourceTypes", value = NameConstants.NT_PAGE, propertyPrivate = true),
    @Property(name = "sling.servlet.selectors", value = "image", propertyPrivate = true),
    @Property(name = "sling.servlet.extensions", value = "jpg", propertyPrivate = true)
})

El servlet utiliza la anotación SCR de propiedad para establecer la calidad y las dimensiones de la imagen admitidas por defecto.

@Property(label = "Image Quality",
            description = "Quality must be a double between 0.0 and 1.0", value = "0.82")
@Property(value = {
                "256x192", // Category page article list images
                "370x150", // "Most popular" desktop & iPad & carousel min-width: 1px
                "480x200", // "Most popular" phone
                "127x127", // article summary phone square images
                "770x360", // article summary, desktop
                "620x290", // article summary, tablet
                "480x225", // article summary, phone (landscape)
                "320x150", // article summary, phone (portrait) and fallback
                "375x175", // 2-column article summary, desktop
                "303x142", // 2-column article summary, tablet
                "1170x400", // carousel, full
                "940x340",  // carousel min-width: 980px
                "770x300",  // carousel min-width: 768px
                "480x190"   // carousel min-width: 480px
            },
            label = "Supported Resolutions",
            description = "List of resolutions this component is permitted to generate.")

La variable AbstractImageServlet proporciona la variable doGet método que procesa la solicitud HTTP. Este método determina el recurso asociado a la llamada, recupera las propiedades de los recursos del repositorio y las guarda en un ImageContext objeto.

La variable ImageReferenceModificationServlet la clase anula la función createLayer e implementa la lógica que determina el recurso de imagen que se va a procesar. El método recupera un nodo secundario del nodo de la página jcr:content nodo llamado image. Un Imagen el objeto se crea a partir de esta image y el getFileReference devuelve la ruta al archivo de imagen desde el fileReference propiedad del nodo de imagen.

Desarrollo de una cuadrícula fluida developing-a-fluid-grid

AEM le permite implementar redes fluidas de forma eficiente y eficaz. En esta página se explica cómo integrar la cuadrícula fluida o una implementación de cuadrícula existente (por ejemplo, Bootstrap) en la aplicación de AEM.

Si no está familiarizado con las cuadrículas de fluidos, consulte la sección Introducción a las cuadrículas fluidas en la parte inferior de esta página. Esta introducción proporciona una visión general de las cuadrículas fluidas y una guía para diseñarlas.

Definición de la cuadrícula mediante un componente Página defining-the-grid-using-a-page-component

Utilice los componentes de página para generar los elementos de HTML que definen los bloques de contenido de la página. ClientLibraryFolder al que hace referencia la página proporciona el CSS que controla el diseño de los bloques de contenido:

Por ejemplo, la aplicación geometrixx-media de ejemplo contiene el componente media-home. Este componente de página inserta dos secuencias de comandos, que generan dos div elementos de la clase row-fluid:

<div class="page-content">
    <div class="row-fluid">
        <div class="span12">
            <cq:include path="grid-12-par" resourceType="foundation/components/parsys" />
        </div>
    </div>
    <div class="row-fluid">
        <div class="span8">
            <cq:include path="grid-8-par" resourceType="foundation/components/parsys" />
        </div>
        <div class="span4">
            <cq:include path="grid-4-par" resourceType="foundation/components/parsys" />
        </div>
    </div>
</div>

Escalado de la cuadrícula del componente Página scaling-the-page-component-grid

El diseño asociado al componente de página de medios de geometrixx (/etc/designs/geometrixx-media) contiene el clientlibs ClientLibraryFolder. Esta ClientLibraryFolder define estilos CSS para row-fluid clases, span* clases y span* clases que son hijos de row-fluid clases . Las consultas de medios permiten redefinir estilos para diferentes tamaños de ventanilla.

El siguiente ejemplo de CSS es un subconjunto de esos estilos. Este subconjunto se centra en span12, span8y span4 clases y consultas de medios para dos tamaños de ventanilla. Observe las siguientes características de la CSS:

/* default styles (no media queries) */
 .span12 { width: 940px }
 .span8 { width: 620px }
 .span4 { width: 300px }
 .row-fluid .span12 { width: 100% }
 .row-fluid .span8 { width: 65.95744680851064% }
 .row-fluid .span4 { width: 31.914893617021278% }

@media (min-width: 768px) and (max-width: 979px) {
 .span12 { width: 724px; }
 .span8 {     width: 476px; }
 .span4 {     width: 228px; }
 .row-fluid .span12 {     width: 100%;}
 .row-fluid .span8 {     width: 65.74585635359117%; }
 .row-fluid .span4 {     width: 31.491712707182323%; }
}

@media (min-width: 1200px) {
 .span12 { width: 1170px }
 .span8 { width: 770px }
 .span4 { width: 370px }
 .row-fluid .span12 { width: 100% }
 .row-fluid .span8 { width: 65.81196581196582% }
 .row-fluid .span4 { width: 31.623931623931625% }
}

Cambio de posición del contenido en la cuadrícula de componentes Página repositioning-content-in-the-page-component-grid

Las páginas de la aplicación de Geometrixx Medias de ejemplo distribuyen filas de bloques de contenido horizontalmente en ventanillas amplias. En ventanillas más pequeñas, los mismos bloques se distribuyen verticalmente. El siguiente ejemplo de CSS muestra los estilos que implementan este comportamiento para el código de HTML que genera el componente de página principal de medios:

/* default styles (no media queries) */
    .row-fluid [class*="span"] {
        width: 100%;
        float: left;
}

@media (max-width: 767px) {
    [class*="span"], .row-fluid [class*="span"] {
        float: none;
        width: 100%;
    }
}

Modularizar los componentes de la página tip-modularize-your-page-components

Modularizar los componentes para hacer un uso eficiente del código. Es probable que el sitio utilice varios tipos diferentes de páginas, como una página de bienvenida, una página de artículos o una página de productos. Cada tipo de página contiene diferentes tipos de contenido y es probable que use diferentes diseños. Sin embargo, cuando ciertos elementos de cada diseño son comunes en varias páginas, puede volver a utilizar el código que implementa esa parte del diseño.

Usar superposiciones de componentes de página

Cree un componente de página principal que proporcione secuencias de comandos para generar las distintas partes de una página, como head y body secciones y header, contenty footer dentro del cuerpo.

Cree otros componentes de página que utilicen el componente de página principal como el cq:resourceSuperType. Estos componentes incluyen secuencias de comandos que anulan las secuencias de comandos de la página principal según sea necesario.

Por ejemplo, la aplicación goemetrixx-media incluye el componente de página (el sling:resourceSuperType es el componente de página base). Varios componentes secundarios (como artículo, categoría y media-home) utilizan este componente de página como el sling:resourceSuperType. Cada componente secundario incluye un archivo content.jsp que anula el archivo content.jsp del componente de página.

Reutilización de scripts

Cree varios scripts JSP que generen combinaciones de filas y columnas que son comunes en varios componentes de página. Por ejemplo, la variable content.jsp la secuencia de comandos del artículo y los componentes media-home hacen referencia a la variable 8x4col.jsp secuencia de comandos.

Organizar estilos CSS según el tamaño de la ventanilla de destino

Incluya estilos CSS y consultas de medios para diferentes tamaños de ventanilla en archivos independientes. Utilice carpetas de la biblioteca del cliente para concatenarlas.

Inserción de componentes en la cuadrícula de la página inserting-components-into-the-page-grid

Cuando los componentes generan un solo bloque de contenido, generalmente la cuadrícula que establece el componente de página controla la ubicación del contenido.

Los autores deben tener en cuenta que el bloque de contenido se puede representar en varios tamaños y posiciones relativas. El texto del contenido no debe utilizar direcciones relativas para hacer referencia a otros bloques de contenido.

Si es necesario, el componente debe proporcionar todas las bibliotecas CSS o javascript necesarias para el código de HTML que genera. Utilice una carpeta de biblioteca de cliente dentro del componente para generar los archivos CSS y JS. Para exponer los archivos, crear una dependencia o incrustar la biblioteca en otra carpeta de biblioteca de cliente debajo de la carpeta /etc.

Subcuadrículas

Si el componente contiene varios bloques de contenido, añada los bloques de contenido dentro de una fila para establecer una subcuadrícula en la página:

Por ejemplo, la variable /apps/geometrixx-media/components/2-col-article-summary genera dos columnas de contenido. El HTML que genera tiene la siguiente estructura:

<div class="row-fluid mutli-col-article-summary">
    <div class="span6">
        <article>
            <div class="article-summary-image">...</div>
            <div class="social-header">...</div>
            <div class="article-summary-description">...</div>
            <div class="social">...</div>
        </article>
    </div>
</div>

La variable .row-fluid .span6 selectores de la CSS de la página se aplica al div elementos de la misma clase y estructura de este HTML. Sin embargo, el componente también incluye la carpeta de biblioteca cliente /apps/geometrixx-media/components/2-col-article-summary/clientlibs:

Por ejemplo, los siguientes estilos se incluyen en el /apps/geometrixx-media/components/2-col-article-summary/clientlibs/css/responsive-480px.css archivo:

@media (max-width: 480px) {
    .mutli-col-article-summary .article-summary-image {
        float: left;
        width: 127px;
    }
    .mutli-col-article-summary .article-summary-description {
        width: auto;
        margin-left: 127px;
    }
    .mutli-col-article-summary .article-summary-description h4 {
        padding-left: 10px;
    }
    .mutli-col-article-summary .article-summary-text {
        margin-left: 127px;
        min-height: 122px;
        top: 0;
    }
}

Introducción a las cuadrículas de fluidos introduction-to-fluid-grids

Las cuadrículas fluidas permiten que los diseños de página se adapten a las dimensiones de la ventanilla del cliente. Las cuadrículas constan de columnas lógicas y filas que colocan los bloques de contenido en la página.

Con la tecnología HTML5, puede implementar la cuadrícula y manipularla para adaptar los diseños de página a diferentes tamaños de ventanilla:

Uso de anchos discretos using-discrete-widths

Para cada rango de anchuras de las ventanillas móviles objetivo, utilice un ancho de página estático y bloques de contenido de ancho constante. Al cambiar manualmente el tamaño de una ventana del explorador, los cambios en el tamaño del contenido se producen con anchos de ventana discretos (también conocidos como puntos de interrupción). Por lo tanto, los diseños de página se respetan más estrictamente, lo que maximiza la experiencia del usuario.

Escalado de la cuadrícula scaling-the-grid

Utilice cuadrículas para escalar bloques de contenido y adaptarse a diferentes tamaños de ventanilla. Los bloques de contenido abarcan un número específico de columnas. A medida que los anchos de columna aumentan o disminuyen para adaptarse a diferentes tamaños de ventanilla, el ancho de los bloques de contenido aumenta o disminuye en consecuencia. El escalado puede admitir ventanillas grandes y medianas lo suficientemente anchas como para adaptarse a la colocación paralela de bloques de contenido.

Cambio de posición del contenido en la cuadrícula repositioning-content-in-the-grid

El tamaño de los bloques de contenido puede estar limitado por una anchura mínima, por encima de la cual el escalado ya no es efectivo. Para ventanillas más pequeñas, la cuadrícula se puede utilizar para distribuir bloques de contenido verticalmente en lugar de horizontalmente.

Diseño de la cuadrícula designing-the-grid

Determine las columnas y filas que necesita para colocar los bloques de contenido en sus páginas. Los diseños de página determinan el número de columnas y filas que abarcan la cuadrícula.

Número de columnas

Incluya suficientes columnas para colocar horizontalmente los bloques de contenido en todos los diseños, para todos los tamaños de las ventanillas móviles. Debe utilizar más columnas de las que se necesitan actualmente para dar cabida a futuros diseños de página.

Contenido de fila

Utilice filas para controlar la posición vertical de los bloques de contenido. Determine los bloques de contenido que comparten la misma fila:

Implementaciones de cuadrícula grid-implementations

Cree clases y estilos CSS para controlar el diseño de los bloques de contenido en una página. Los diseños de página a menudo se basan en el tamaño y la posición relativos de los bloques de contenido dentro de la ventanilla. La ventanilla determina el tamaño real de los bloques de contenido. El CSS debe tener en cuenta los tamaños relativo y absoluto. Puede implementar una cuadrícula fluida mediante tres tipos de clases CSS:

Los anchos de las ventanillas de destino (y sus consultas de medios asociadas) delimitan los anchos discretos que se utilizan para un diseño de página.

Anchura de bloques de contenido widths-of-content-blocks

En general, la variable width el estilo de las clases de bloques de contenido se basa en las siguientes características de la página y la cuadrícula:

El CSS incluye una serie de consultas de medios que utilizan la siguiente estructura:

@media(query_for_targeted_viewport){

  .class_for_container{ width:absolute_page_width }
  .class_for_row { width:100%}

  /* several selectors for content blocks   */
  .class_for_content_block1 { width:absolute_block_width1 }
  .class_for_content_block2 { width:absolute_block_width2 }
  ...

  /* several selectors for content blocks inside rows */
  .class_for_row .class_for_content_block1 { width:relative_block_width1 }
  .class_for_row .class_for_content_block2 { width:relative_block_width2 }
  ...
}

Utilice el siguiente algoritmo como punto de partida para desarrollar las clases de elementos y los estilos CSS de sus páginas.

Colocación de bloques de contenido en filas positioning-content-blocks-in-rows

Utilice el estilo flotante de la variable .row-fluid para controlar si los bloques de contenido de una fila están organizados horizontal o verticalmente.

Añada el estilo al .row-fluid dentro de cada consulta de medios. Establezca el valor según el diseño de página que esté utilizando para esa consulta de medios. Por ejemplo, el diagrama siguiente ilustra una fila que distribuye el contenido horizontalmente para ventanillas móviles anchas y verticalmente para ventanillas móviles.

El siguiente CSS podría implementar este comportamiento:

@media (min-width: 768px) and (max-width: 979px) {
   .row-fluid {
       width:100%;
       float:left
   }
}

@media (max-width:480px){
    .row-fluid {
       width:100%;
       float:none
   }
}

Asignación de clases a bloques de contenido assigning-classes-to-content-blocks

Para el diseño de página de cada tamaño de ventanilla objetivo, determine el número de columnas que ocupa cada bloque de contenido. A continuación, determine qué clase utilizar para los elementos div de esos bloques de contenido.

Cuando haya establecido las clases div, puede implementar la cuadrícula mediante la aplicación AEM.