Show Menu
主题×

Language Navigation Component

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

使用情况

网站通常针对不同区域以多种语言提供。 语言导航组件允许访客查看不同语言/区域设置的同一页面。 因此,如果您是瑞士德语版网站的读者,您可以轻松切换到同一页面的美国英语版。 语言导航组件可处理对站点语言结构的了解并自动查找相应的页面。
编辑 对话框允许定义全局站点导航根目录 ,以及导航应深入到结构中的程度。 使用设 计对话框 ,模板作者可以为相同的选项设置默认值。

版本和兼容性

语言导航组件的当前版本为v1,v1是2018年1月随核心组件版本2.0.0一起引入的,本文档对此进行了说明。
下表详细列出了组件的所有受支持版本、与组件版本兼容的AEM版本,以及指向先前版本的文档的链接。
组件版本
AEM 6.3
AEM 6.4
AEM 6.5
AEM作为云服务
v1
兼容
兼容
兼容
兼容
有关核心组件版本和版本的详细信息,请参阅文档核 心组件版本

示例组件输出

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

技术详细信息

有关语言导航组件的最新技 术文档可在GitHub上找到
有关开发核心组件的更多详细信息,请参阅核 心组件开发人员文档

设计对话框

编辑对话框允许定义全局站点导航根目录以及导航应深入到结构中的程度。
通常,这些配置只需在页面模板级别完成。 但是,可以通过编辑对话框在页面级别更改 它们

属性选项卡

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

示例

假设您的内容类似于:
/content +-- we-retail +-- language-masters +-- us +-- en \-- es \-- ch +-- de +-- fr \-- it +-- wknd-events \-- wknd-shop
对于站点We.Retail,您可能希望将语言导航组件作为标题的一部分放置在页面模板上。 模板一经加入,您便可将组件的
导航根
(Navigation Root
/content/we-retail
)设置为,因为该站点的本地化内容就从此开始。 您还希望将“语言结
构深度
”设置为
2
,因为您的结构是两个级别(国家/地区,然后是语言)。
使用“导
航根
”值,语言组件知道在导航开始后,它可以生成语言导航选项,方法是将内容树中的后两个级别识别为站点的语言导航结构(由“语言结构深度”值定义
/content/we-retail
)。
无论用户查看的是哪个页面,语言导航组件都可以通过了解当前页面的位置并返回到根目录,然后转发到相应的页面来找到使用其他语言的相应页面。

样式选项卡

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

Edit Dialog

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