[{"value":"必选参数","id":"必选参数","hLevel":2,"level":1},{"value":"可选参数","id":"可选参数","hLevel":2,"level":1},{"value":"例子","id":"例子","hLevel":2,"level":1,"children":[{"value":"基础类型","id":"基础类型","hLevel":3,"level":2},{"value":"复杂类型","id":"复杂类型","hLevel":3,"level":2},{"value":"度量类型","id":"度量类型","hLevel":3,"level":2},{"value":"metaobject_reference","id":"metaobject_reference","hLevel":3,"level":2},{"value":"list.metaobject_reference","id":"listmetaobject_reference","hLevel":3,"level":2},{"value":"list.single_line_text_field","id":"listsingle_line_text_field","hLevel":3,"level":2}]}]

metafield_text

根据 metafield object 生成纯文本字符串。该 filter 适用于任何不需要输出 HTML 标签的场景，例如标题、文本摘要、图片 alt 属性和 meta 描述。

{{ metafield | metafield_text() }}

必选参数

metafield metafield：要转换为纯文本字符串的对象。

可选参数

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 字符串

{{ variable | metafield_text() }}

{{#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() }}

复杂类型

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

{{ variable | metafield_text() }}

{{#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() }}

度量类型

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

{{ variable | metafield_text() }}

{{#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() }}

metaobject_reference

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

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

{{#var mf = product | get_metafields("my_fields") /}}
{{ mf.metaobject | metafield_text(field="color_name") }}

list.metaobject_reference

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

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

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

{{#var mf = product | get_metafields("my_fields") /}}
{{ mf.metaobjects | metafield_text(field="color_name") }}

list.single_line_text_field

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

{{ variable | metafield_text() }}

{{#var mf = product | get_metafields("my_fields") /}}
{{ mf.available_colors | metafield_text() }}

这篇文章对你有帮助吗？

SHOPLINE

条款协议

必选参数​

可选参数​

例子​

基础类型​

复杂类型​

度量类型​

metaobject_reference​

list.metaobject_reference​

list.single_line_text_field​