johnhenry/matrix-block-anchor

允许用户复制矩阵块ID的锚点字段

2.0.1 2024-09-08 23:04 UTC

This package is auto-updated.

Last update: 2024-09-08 23:09:21 UTC


README

这是一个Craft CMS字段,允许内容编辑员直接创建指向矩阵块的锚点链接,而无需开发人员协助。它自动检索矩阵块ID,使编辑员能够轻松复制链接并在任何地方使用。

要求

此插件需要Craft CMS 5.0.0或更高版本,以及PHP 8.2或更高版本。

安装

您可以从插件商店或使用Composer安装此插件。

从插件商店

转到您项目控制面板中的插件商店,搜索“Matrix Block Anchor”,然后点击“安装”。

使用Composer

打开您的终端并运行以下命令

# go to the project directory
cd /path/to/my-project

# tell Composer to load the plugin
composer require johnhenry/matrix-block-anchor

# tell Craft to install the plugin
./craft plugin/install matrix-block-anchor

配置矩阵块锚点

锚点ID的默认前缀为blockIdAnchor,可以在矩阵块锚点插件设置中自定义。在大多数情况下,此默认设置工作良好。

使用矩阵块锚点

创建一个新字段,并将矩阵块锚点选为字段类型。将此新字段添加到您想要锚点的每个矩阵块中。

默认锚点前缀为blockIdAnchor,将在控制面板中生成锚点链接,例如#blockIdAnchor-424242

在典型的矩阵页面构建器设置中,只需将ID添加到块父div或部分的ID中。请确保更新前缀以匹配插件设置,并用连字符与block.id变量分隔。

<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8" id="blockIdAnchor-{{ block.id }}">

矩阵页面构建器资源

粘性头部

点击锚点链接(同一页面内的链接)会导致页面滚动。如果滚动向上,链接元素可能会被头部隐藏。

为了防止这种情况,您可以在CSS中定义滚动填充

html,
body {
    scroll-padding-top: 100px; /* set to the height of your header */
}