云客Drupal源码分析之菜单本地任务MenuLocalTasks

菜单本地任务（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”翻译成了标签）
在该块实现中当任务栏只有一个选项卡时将不显示，任务栏的默认渲染数组如下：