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

本文详细介绍了Drupal 8中的菜单本地任务(Menu Local Tasks),即页面上方的选项卡栏。本地任务栏由“本地任务块”渲染,通常包括主选项卡和次选项卡,由任务链接和任务插件组成。文章讲解了任务块、任务插件的定义,以及如何通过模块的yml文件静态定义任务链接。此外,还讨论了动态修改任务栏的hook和插件管理器的工作原理。
摘要由CSDN通过智能技术生成

菜单本地任务(Menu local tasks)这个名字读者可能会感觉有点生涩,其实通常她就是页面主要内容上方的选项卡栏,可以联想下windows操作系统的任务栏,其中就是一些选项卡,但通常叫任务栏,drupal采用该称呼也体现了其重视计算机术语的统一性;不管是管理主题还是前端主题都用到了她,比如默认的seven管理主题“内容”菜单页面上方的“内容、评论、文件”,再比如默认的Bartik前端主题在登录状态下显示一篇文章时,页面主视觉区域标题下方的“查看、编辑、删除”,这些“选项卡tabs”构成的选项卡栏通常用作导航作用,在drupal世界里称为“菜单本地任务”,称为“本地任务”是因为drupal在功能层面需要将其和普通选项卡栏区别开来,采用这个专有名词来特指这种类型的选项卡。

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 
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值