Componente de navegación de idioma

El componente de 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

Los sitios web se proporcionan a menudo en varios idiomas para diferentes regiones. El componente de navegación por idiomas permite que un visitante vea la misma página en diferentes idiomas o configuraciones regionales. Así que si eres un lector de la versión en alemán suizo del sitio web, puedes 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.

• Para ver un ejemplo del funcionamiento de la función de localización del componente de navegación de idioma, consulte la sección a1/>.
• Para ver un ejemplo de cómo funcionan juntas las funciones de localización de los demás componentes principales, consulte la página Funciones de localización de la página Componentes principales.

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

La versión actual del componente de navegación de idioma es v1, que se introdujo con la versión 2.0.0 de los componentes principales en enero de 2018 y se describe en este documento.

La siguiente tabla detalla todas las versiones compatibles del componente, las versiones 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 versiones de los componentes principales, consulte el documento Versiones de los componentes principales.

Salida de componente de ejemplo

Para experimentar el componente de 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

La documentación técnica más reciente sobre el componente de 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.

Diálogo de diseño

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.

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.

Ficha Propiedades

• Raíz de navegación
  • Aquí es donde debería comenzar la navegación por el idioma del sitio.
  • La estructura de idioma del sitio comienza en el siguiente nivel debajo de esta raíz.
• Profundidad de la estructura de idiomas
  • Así es como muchos niveles del árbol de contenido debajo de Raíz de navegación representan la estructura de idioma del sitio. Ejemplos:
    • 1 normalmente significa que solo tiene la opción de idioma.
    • 2 normalmente significa que tiene una elección de idioma y país.
    • 3 normalmente significa que tiene una opción de idioma, país y región.

Ejemplo

Digamos que el contenido tiene este aspecto:

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

Para el WKND del sitio, 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 desea configurar la Profundidad de la estructura de idioma para que sea 2, ya que la estructura es de dos niveles (país y idioma).

Con el valor Raíz de navegación , el componente de 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 por 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

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

Editar cuadro de diálogo

Normalmente, el componente de 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 de 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.

• Si se deja en blanco, automáticamente se genera un ID único que se puede encontrar inspeccionando la página resultante.
• Si se especifica un ID, es responsabilidad del autor asegurarse de que sea único.
• Cambiar el ID puede afectar al seguimiento de CSS, JS y capa de datos.

Capa de datos del cliente de Adobe

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