---
title: "article"

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

# article


    博客中的一篇文章（博文）。

    



## 属性

    <div>
    

        
<ObjectProperty
    name="author"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章作者的全名。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="comments"
    types={[<Mdx>array of [comment](https://developer.shopline.com/zh-hans-cn/docs/sline/object/comment.md)</Mdx>]}
>
<ObjectSummary>
文章的已发布评论列表。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="comments_count"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
文章的已发布评论数量。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="comments_enabled"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
是否已启用评论。
- `true`：启用
- `false`：未启用


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="content"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的内容。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="created_at"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的创建时间戳。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。

> **提示**
>
> 可以使用 [date](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/date.md) filter 格式化该时间戳。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="excerpt"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的摘要。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="excerpt_or_content"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
若文章摘要存在，则返回文章摘要。若文章摘要不存在，则返回文章内容。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="handle"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的 [handle](https://developer.shopline.com/zh-hans-cn/docs/sline/basics.md#XQhS6)。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的 ID。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="image"
    types={[<Mdx>[image](https://developer.shopline.com/zh-hans-cn/docs/sline/object/image.md)</Mdx>]}
>
<ObjectSummary>
文章的封面图片。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="published_at"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的发布时间戳。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。

> **提示**
>
> 可以使用 [date](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/date.md) filter 格式化该时间戳。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="title"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的标题。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="updated_at"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的更新时间戳。格式：[ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)。

> **提示**
>
> 可以使用 [date](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/date.md) filter 去格式化这个时间戳。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="url"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的相对 URL。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="moderated"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
评论是否需要经过审核。
- `true`：需要
- `false`：不需要


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="tags"
    types={[<Mdx>array of string</Mdx>]}
>
<ObjectSummary>
文章的标签列表。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="template_suffix"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
文章的自定义模板名称。

该名称不包含前缀和文件扩展名。例如模板为 `article.xxx.json`，则返回 `xxx`。

如果文章使用默认模板，则返回 `nil`。


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


