---
title: "block"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/block'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/block.md'
---

# block


    区块的内容和设置。

    区块是构成模板的可复用内容模块。`block` object 仅在 `blocks` 目录下的 HTML 文件中可用。



    <div>
    
## 属性

        
<ObjectProperty
    name="id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
区块的 ID，由 SHOPLINE 动态生成。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="settings"
    types={[<Mdx>[settings](https://developer.shopline.com/zh-hans-cn/docs/sline/object/settings.md)</Mdx>]}
>
<ObjectSummary>
区块的设置。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="shopline_attributes"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
区块的数据属性，用于支持区块与主题编辑器的交互。

主题编辑器的 JavaScript API 利用此属性来识别区块并监听事件。在主题编辑器之外的环境中，`block.shopline_attributes` 返回 `nil`。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="type"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
区块的类型。

该属性值由区块文件的路径和文件名共同决定。对于全局区块，例如文件路径为 `blocks/block.html`，则 `type` 值为 `block`。对于私有区块，例如文件路径为 `sections/blog-demo/blocks/block.html`，则 `type` 值为 `$block`。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="index0"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
当前区块的索引（从 0 开始）。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="index"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
当前区块的索引（从 1 开始）。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="blocks_size"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
区块包含的子区块数量。


</ObjectSummary>
</ObjectProperty>
        
    
    </div>


