菜单本地任务(Menu local tasks)这个名字读者可能会感觉有点生涩,其实通常她就是页面主要内容上方的选项卡栏,可以联想下windows操作系统的任务栏,其中就是一些选项卡,但通常叫任务栏,drupal采用该称呼也体现了其重视计算机术语的统一性;不管是管理主题还是前端主题都用到了她,比如默认的seven管理主题“内容”菜单页面上方的“内容、评论、文件”,再比如默认的Bartik前端主题在登录状态下显示一篇文章时,页面主视觉区域标题下方的“查看、编辑、删除”,这些“选项卡tabs”构成的选项卡栏通常用作导航作用,在drupal世界里称为“菜单本地任务”,称为“本地任务”是因为drupal在功能层面需要将其和普通选项卡栏区别开来,采用这个专有名词来特指这种类型的选项卡。
概述:
一个页面的本地任务栏是由“本地任务块”渲染提供的(见下),本地任务栏可以由多组本地任务共同构成,每组本地任务包含多个任务链接,每一个任务链接就是一个选项卡,选项卡又被分为“主选项卡Primary tabs”和“次选项卡Secondary tabs”,系统仅支持两级选项卡,选项卡和任务链接是一对一关系,每个任务链接对应一个任务插件,定义在模块根目录的yml文件中(见下),具备相同任务组id的任务链接属于同一任务组,在继续讲解前需要先明确以下这些词的含义:
选项卡:一个选项卡中仅一个链接,反之一个链接对应一个选项卡,多个选项卡构成一个选项卡栏
任务链接:选项卡中的链接就是任务链接,一个任务链接对应一个插件
任务插件:在模块根目录的yml文件中定义,插件描述了任务链接,她们是一对一关系
任务组:多个任务链接构成一个任务组
本地任务:多个任务组构成完整的本地任务,也称为菜单本地任务栏
本地任务块:
在系统中“菜单本地任务”通常由本地任务块提供,块插件定义如下:
块管理标签admin_label:Tabs
块插件id:local_tasks_block
块插件类:Drupal\Core\Menu\Plugin\Block\LocalTasksBlock
需要显示菜单本地任务栏的页面放置该块即可,块知识详见本系列块主题,该块默认同时显示主、次选项卡,但可以配置只显示其一,可参考默认管理主题seven区块布局下的“主标签Primary tabs”和“次标签Secondary tabs”(官方下载的翻译文件中将选项卡“Tabs”翻译成了标签)
在该块实现中当任务栏只有一个选项卡时将不显示,任务栏的默认渲染数组如下:
$tabs