代码字段资源
除了作为文件提供的静态样式和脚本外,Blockstudio 还支持通过代码字段生成动态资源区块。根据使用场景,这些资源可以限定在区块范围内。
基本用法
最基本的用法是在模板中手动渲染代码字段的内容。
PHP
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
作用域选择器
为避免与其他区块冲突,你可以在代码字段中使用 %selector% 变量,并在渲染模板中配合 useBlockProps 使用。
在代码字段中,%selector% 指向单个区块实例。在 CSS 和 SCSS 文件中,%selector% 则指向区块共享的作用域类。
示例
假设我们想在代码字段中定位上方示例里的 h1 标签。
CSS
%selector% h1 {
color: red;
}
现在,Blockstudio 会执行三项操作:
- 为该区块实例创建唯一 ID
- 将
%selector%替换为该唯一 ID - 将相同的选择器添加到带有
useBlockProps标记的元素上
最终输出大致如下:
HTML
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
自动渲染
总是需要手动渲染 style 标签会很麻烦。为简化这一过程,你可以在代码字段中使用 asset 属性。
JSON
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
这会自动为标记为 css 的代码块创建 style 标签,并将其移至文档的 head 中。对于将语言标记为 javascript 的字段,则会创建 script 标签,并将其放在 body 的底部。
在扩展中
在 扩展中使用代码字段时,无需使用 asset 属性。如果语言是 css 或 javascript,Blockstudio 会自动将代码字段内容渲染为资源。
示例
JSON
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
无需额外配置。以上设置会在侧边栏中为每个 core/* 区块显示一个代码字段,并自动将其内容作为资源渲染到页面中。
SCSS
代码字段支持 SCSS 编译。将语言设为 scss,Blockstudio 会先通过 ScssPhp 编译该值,再将其渲染为 CSS。
JSON
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
SCSS 的变量、嵌套和混入等功能都可以正常使用:
Scss
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
在编辑器中,SCSS 会实时在服务器端编译,因此你输入时就能看到结果。在前端,编译会在区块渲染期间进行。