语言导航组件

语言导航组件为站点提供语言/国家/地区导航,以便访客可以在不同区域设置中导航到同一页面。

使用

网站通常以多种语言为不同区域提供。 语言导航组件允许访客视图不同语言/区域设置的同一页面。 因此,如果您是瑞士德语版网站的读者,您可以轻松切换到同一页的美国英语版。 语言导航组件可处理理解站点语言结构的过程并自动查找相应的页面。

  • 有关语言导航组件的本地化功能如何工作的示例,请参见下面的部分。
  • 有关其他核心组件的本地化功能如何协同工作的示例,请参阅“核心组件”页面的本地化功能页面

编辑对话框允许定义全局站点导航根目录以及导航应深入到结构中的程度。 使用设计对话框,模板作者可以设置相同选项的默认值。

版本和兼容性

语言导航组件的当前版本为v1,该版本在2018年1月随核心组件的2.0.0版一起推出,并在本文档中进行了说明。

下表详细列出了组件的所有受支持版本、与组件版本兼容的AEM版本以及指向先前版本文档的链接。

组件版本 AEM 6.4 AEM 6.5 AEM as a Cloud Service
v1 兼容 兼容 兼容

有关核心组件版本和版本的详细信息,请参阅文档核心组件版本

示例组件输出

要体验语言导航组件以及其配置选项以及HTML和JSON输出的示例,请访问组件库

技术详细信息

有关语言导航组件的最新技术文档可在GitHub上找到。

有关开发核心组件的更多详细信息,请参阅核心组件开发人员文档

设计对话框

编辑对话框允许定义全局站点导航根目录以及导航应深入到结构中的程度。

通常,这些配置只需在页面模板级别完成。 但是,可以通过编辑对话框在页面级别更改它们。

属性选项卡

语言导航组件的设计对话框

  • 导航根目录
    • 这是站点的语言导航应开始的位置。
    • 站点的语言结构从此根目录下的下一级开始。
  • 语言结构深度
    • 这是​导航根​下的内容树中表示站点语言结构的级别数。 示例:
      • 1 通常意味着您只有语言选择权。
      • 2 通常意味着你有语言和国家的选择。
      • 3 通常意味着您可以选择语言、国家和地区。

示例

假设您的内容类似于:

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

对于站点WKND,您可能希望将语言导航组件作为标题的一部分放置在页面模板上。 模板的一部分后,您可以将组件的​导航根​设置为/content/wknd,因为这是该站点的本地化内容开始的位置。 您还希望将​语言结构深度​设置为2,因为您的结构是两个级别(国家/地区然后是语言)。

使用​导航根​值,语言组件知道在/content/wknd开始导航之后,它可以通过将内容树中的后两个级别识别为站点的语言导航结构(由​语言结构深度​值定义)来生成语言导航选项。

无论用户正在查看哪个页面,语言导航组件都能够通过了解当前页面的位置并返回到根目录,然后转发到相应的页面,以其他语言查找相应页面。

样式选项卡

语言导航组件支持AEM 样式系统

编辑对话框

通常,只需在站点的页面模板中添加和配置语言导航组件。 但是,如果需要将语言导航组件添加到单个内容页面,则编辑对话框允许内容作者配置与设计对话框中所述的相同值。

此外,还可以设置​ID。 此选项允许控制HTML和数据层中组件的唯一标识符。

  • 如果留空,则会自动为您生成唯一ID,并可通过检查生成的页面找到该ID。
  • 如果指定了ID,则作者有责任确保它是唯一的。
  • 更改ID可能会影响CSS、JS和数据层跟踪。

语言导航组件的编辑对话框

在此页面上