---
title: "metafield_text"

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

# metafield_text


    根据 [metafield](https://developer.shopline.com/zh-hans-cn/docs/sline/object/metafield.md) object 生成纯文本字符串。该 filter 适用于任何不需要输出 HTML 标签的场景，例如标题、文本摘要、图片 alt 属性和 meta 描述。

    



    
`{{ metafield | metafield_text() }}` 
    



    
## 必选参数

        
             `metafield` [`metafield`](https://developer.shopline.com/zh-hans-cn/docs/sline/object/metafield.md)：要转换为纯文本字符串的对象。
        
    



    
## 可选参数

        
             `field` `string`：字段名称。当 `metafield` 类型为 `metaobject_reference` 或 `list.metaobject_reference` 时必填，用于指定从 `metaobject` 中输出的字段（仅支持 `single_line_text_field` 字段类型）。
        
    



    
## 例子

        
            

            由于不同类型的 `metafield` 转换为纯文本的规则有所不同，以下按类型列举具体的使用示例：


            

            
        
            ### 基础类型

            | 类型 | 输出文本 |
| --- | --- |
| `boolean` | `true` 或 `false` |
| `single_line_text_field` | 原始单行文本 |
| `multi_line_text_field` | 原始多行文本 |
| `rich_text_field` | 富文本内容移除 HTML 标签后的文本 |
| `color` | 颜色值 |
| `rating` | 评分值 |
| `number_integer` | 整数值 |
| `number_decimal` | 小数值 |
| `money` | 格式化后的金额 |
| `date` | 格式化后的日期 |
| `date_time` | 格式化后的日期和时间 |
| `url` | URL |
| `link` | 链接地址 |
| `json` | JSON 字符串 |


            
```sline
{{ variable | metafield_text() }}
```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#var mf = product | get_metafields("my_fields") /}}

<!-- boolean -->
{{ mf.is_new_arrival | metafield_text() }}

<!-- single_line_text_field -->
{{ mf.short_description | metafield_text() }}

<!-- multi_line_text_field -->
{{ mf.material_note | metafield_text() }}

<!-- rich_text_field -->
{{ mf.detail_description | metafield_text() }}

<!-- color -->
{{ mf.color_code | metafield_text() }}

<!-- rating -->
{{ mf.customer_rating | metafield_text() }}

<!-- number_integer -->
{{ mf.inventory_limit | metafield_text() }}

<!-- number_decimal -->
{{ mf.fabric_weight | metafield_text() }}

<!-- money -->
{{ mf.member_price | metafield_text() }}

<!-- date -->
{{ mf.release_date | metafield_text() }}

<!-- date_time -->
{{ mf.release_time | metafield_text() }}

<!-- url -->
{{ mf.size_guide_url | metafield_text() }}

<!-- link -->
{{ mf.brand_link | metafield_text() }}

<!-- json -->
{{ mf.spec_json | metafield_text() }}
```
</SlineExample>
            
        
            ### 复杂类型

            | 类型 | 输出文本 |
| --- | --- |
| `collection_reference` | 引用分类的标题 |
| `page_reference` | 引用页面的标题 |
| `product_reference` | 引用商品的标题 |
| `variant_reference` | 引用款式的标题 |
| `file_reference` | 文件 URL |


            
```sline
{{ variable | metafield_text() }}
```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#var mf = product | get_metafields("my_fields") /}}

<!-- collection_reference -->
{{ mf.related_collection | metafield_text() }}

<!-- page_reference -->
{{ mf.size_guide_page | metafield_text() }}

<!-- product_reference -->
{{ mf.related_product | metafield_text() }}

<!-- variant_reference -->
{{ mf.recommended_variant | metafield_text() }}

<!-- file_reference image -->
{{ mf.product_image | metafield_text() }}

<!-- file_reference video -->
{{ mf.product_video | metafield_text() }}

<!-- file_reference generic_file -->
{{ mf.manual_file | metafield_text() }}
```
</SlineExample>
            
        
            ### 度量类型

            | 类型 | 输出文本 |
| --- | --- |
| `weight` | 值和单位 |
| `volume` | 值和单位 |
| `dimension` | 值和单位 |


            
```sline
{{ variable | metafield_text() }}

```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#var mf = product | get_metafields("my_fields") /}}

<!-- weight -->
{{ mf.package_weight | metafield_text() }}

<!-- volume -->
{{ mf.package_volume | metafield_text() }}

<!-- dimension -->
{{ mf.package_width | metafield_text() }}
```
</SlineExample>
            
        
            ### metaobject_reference

            `field` 指定的字段，其类型必须为 `single_line_text_field`。


            
```sline
{{ variable | metafield_text(field="field_name") }}

```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#var mf = product | get_metafields("my_fields") /}}

{{ mf.metaobject | metafield_text(field="color_name") }}
```
</SlineExample>
            
        
            ### list.metaobject_reference

            `field` 指定的字段，其类型必须为 `single_line_text_field`。

列表项会自动拼接为单条文本。



            
```sline
{{ variable | metafield_text(field="field_name") }}

```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#var mf = product | get_metafields("my_fields") /}}

{{ mf.metaobjects | metafield_text(field="color_name") }}
```
</SlineExample>
            
        
            ### list.single_line_text_field

            列表项会自动拼接为单条文本。



            
```sline
{{ variable | metafield_text() }}

```
            

            
<SlineExample path={'/products/earring-ab001'} objects={ 
    ["product"] 
}>
```sline
{{#var mf = product | get_metafields("my_fields") /}}

{{ mf.available_colors | metafield_text() }}

```
</SlineExample>