johnhenry / matrix-block-anchor
允许用户复制矩阵块ID的锚点字段
2.0.1
2024-09-08 23:04 UTC
Requires
- php: >=8.2
- craftcms/cms: ^5.0.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
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 }}">
矩阵页面构建器资源
- https://www.youtube.com/watch?v=rw3kNg4CF1g
- https://craftquest.io/courses/real-world-craft-cms-5/197080
粘性头部
点击锚点链接(同一页面内的链接)会导致页面滚动。如果滚动向上,链接元素可能会被头部隐藏。
为了防止这种情况,您可以在CSS中定义滚动填充
html,
body {
scroll-padding-top: 100px; /* set to the height of your header */
}