Componente Navegación de idioma language-navigation-component

El componente Navegación de idioma proporciona un idioma o navegación por país para un sitio, de modo que los visitantes pueden navegar a la misma página en una configuración regional diferente.

Uso usage

Los sitios web a menudo se ofrecen en varios idiomas para diferentes regiones. El componente Navegación de idioma permite que un visitante vea la misma página en diferentes idiomas o configuraciones regionales. De esta forma, si el usuario es un lector de la versión en alemán suizo del sitio web, puede fácilmente cambiar a la versión en inglés de EE. UU. de la misma página. El componente Navegación de idioma controla la comprensión de la estructura de idioma del sitio y encuentra la página correspondiente automáticamente.

El cuadro de diálogo de edición permite definir la raíz de navegación del sitio global, así como la profundidad en la estructura que debe ir la navegación. Con el cuadro de diálogo de diseño, el autor de la plantilla puede establecer los valores predeterminados para las mismas opciones.

Versión y compatibilidad version-and-compatibility

La versión actual del componente Navegación de idioma es la versión 2, que se introdujo con la versión 2.18.0 de los componentes principales en febrero de 2022 y se describe en este documento.

La siguiente tabla detalla todas las versiones compatibles del componente, las versiones de AEM con las que son compatibles las versiones del componente y los vínculos a la documentación de versiones anteriores.

Para obtener más información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.

Salida del componente de ejemplo sample-component-output

Para experimentar el componente Navegación de idioma, así como ver ejemplos de sus opciones de configuración, así como la salida HTML y JSON, visite la Biblioteca de componentes.

Detalles técnicos technical-details

La documentación técnica más reciente sobre el componente Navegación de idioma se encuentra en GitHub.

Puede encontrar más información sobre el desarrollo de componentes principales en la documentación para desarrolladores de componentes principales.

Cuadro de diálogo de diseño design-dialog

El cuadro de diálogo de diseño permite definir la raíz de navegación del sitio global, así como la profundidad en la estructura que debe ir la navegación.

Normalmente, estas configuraciones solo deben realizarse en el nivel de plantilla de página. Sin embargo, se pueden cambiar a nivel de página mediante el cuadro de diálogo de edición.

Pestaña Propiedades properties-tab

Ejemplo example

Digamos que el contenido tiene este aspecto:

/content
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   \-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

Para el sitio WKND, es probable que desee colocar el componente Navegación de idioma en una plantilla de página como parte del encabezado. Una vez que forme parte de la plantilla, puede establecer la Raíz de navegación del componente en /content/wknd, ya que allí es donde comienza el contenido localizado para ese sitio. También deberá configurar la Profundidad de la estructura de idioma para que sea 2, ya que la estructura es de dos niveles (país e idioma).

Con el valor Raíz de navegación, el componente Idioma sabe que después de /content/wknd comienza la navegación y puede generar opciones de navegación reconociendo los dos niveles siguientes del árbol de contenido como la estructura de navegación de idioma del sitio (tal como se define en el valor Profundidad de la estructura de idioma).

Independientemente de la página que esté viendo un usuario, el componente Navegación de idioma puede encontrar la página correspondiente en otro idioma, conociendo la ubicación de la página actual y trabajando hacia atrás hasta la raíz, y luego reenviando a la página correspondiente.

Pestaña Estilos styles-tab

El componente Navegación de idioma es compatible con el sistema de estilos de AEM.

Cuadro de diálogo de edición edit-dialog

Pestaña Propiedades properties-tab-edit

Normalmente, el componente Navegación de idioma solo necesita agregarse y configurarse en las plantillas de página de un sitio. Sin embargo, si es necesario añadir el componente Navegación de idioma a una página de contenido individual, el cuadro de diálogo de edición permite a un autor de contenido configurar los mismos valores que se describen en el cuadro de diálogo de diseño

Además, puede establecer un ID. Esta opción permite controlar el identificador único del componente en el HTML y en la capa de datos.

Pestaña Accesibilidad accessibility-tab

Pestaña Estilos styles-tab-edit

El componente Navegación de idioma es compatible con el sistema de estilos de AEM.

Utilice la lista desplegable para seleccionar los estilos que desea aplicar al componente. Las selecciones realizadas en el cuadro de diálogo de edición tienen el mismo efecto que las seleccionadas en la barra de herramientas de componentes.

Los estilos deben configurarse para este componente en el cuadro de diálogo de diseño para que el menú desplegable esté disponible.

Capa de datos del cliente de Adobe data-layer

El componente Navegación de idioma es compatible con la capa de datos del cliente de Adobe.