---
title: "image"

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

# image


    图片，例如商品或分类的图片。

    关于 SHOPLINE 支持的图片格式，可前往 [帮助中心](https://help.shopline.com/hc/zh-cn/articles/4406422263577-%E5%9B%BE%E7%89%87%E5%B0%BA%E5%AF%B8%E5%BB%BA%E8%AE%AE) 查找相关信息。



    <div>
    
## 属性

        
<ObjectProperty
    name="alt"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
图片的替代文本，当图片无法加载时显示。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="aspect_ratio"
    types={[<Mdx>float</Mdx>]}
>
<ObjectSummary>
图片的长宽比，以小数表示。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="attached_to_variant"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
该图片是否与某个款式相关联。

- `true`：该图片与某个款式相关联。
- `false`：该图片不与任何款式关联。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="height"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
图片的高度，单位是像素。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
图片的唯一标识符 ID。

如果你引用了 `generic_file` 或 `media` 对象的预览图片的 `id` 属性，则返回 `nil`。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="media_type"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
媒体资源类型。有效值固定为 `image`，代表图片。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="position"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
图片在 `product.images` 或 `product.media` 数组中的位置序号。


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

该属性仅适用于通过以下来源访问的图片：

- [product.featured_media](https://developer.shopline.com/zh-hans-cn/docs/sline/object/product.md)
- [product.media](https://developer.shopline.com/zh-hans-cn/docs/sline/object/product.md)

如果引用了其他访问来源的该属性，则返回 `nil`。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="product_id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
图片关联的商品的 ID。

该属性仅适用于与商品关联的图片。如果引用了未关联任何商品的图片的该属性，则返回 `nil`。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="src"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
图片的相对 URL。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="width"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
图片的宽度，单位是像素。


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


