metafield_text フィルター（メタフィールドをテキスト形式で抽出）

{
  "category": "metafield",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "> Note:\n> The `metafield_text` filter doesn't currently support list metafields other than `list.single_line_text_field` and `list.metaobject_reference`.",
  "parameters": [
    {
      "description": "Specifies which field should be used. Only applicable to types `list.metaobject_reference` and `metaobject_reference`.",
      "name": "field",
      "positional": false,
      "required": false,
      "types": [
        "string"
      ]
    }
  ],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "Basic types",
      "description": "The following outlines the output for each metafield type:\n\n| Metafield type | Output |\n| --- | --- |\n| `single_line_text_field` | The metafield text. |\n| `multi_line_text_field` | The metafield text. |\n| `page_reference` | The page title. |\n| `product_reference` | The product title. |\n| `collection_reference` | The collection title. |\n| `variant_reference` | The variant title. |\n| `file_reference` | The file URL. |\n| `number_integer` | The number. |\n| `number_decimal` | The number. |\n| `date` | The date. |\n| `date-time` | The date and time. |\n| `url` | The URL. |\n| `json` | The JSON. |\n| `boolean` | The boolean value. |\n| `color` | The color value. |\n| `weight` | The weight value and unit.<br><br>If the value is a decimal with more than two places, then it'll be formatted to have a precision of two with trailing zeros removed. |\n| `volume` | The volume value and unit.<br><br>If the value is a decimal with more than two places, then it'll be formatted to have a precision of two with trailing zeros removed. |\n| `dimension` | The dimension value and unit.<br><br>If the value is a decimal with more than two places, then it'll be formatted to have a precision of two with trailing zeros removed. |\n| `rating` | The rating value. |\n| `list.single_line_text_field` | The metafield values in sentence format.<br><br>For example, if you had the values `Toronto`, `Ottawa`, and `Vancouver`, then the output would be:<br><br>`Toronto, Ottawa, and Vancouver` |\n| `money` | The money value, formatted using the store's [**HTML with currency** setting](https://help.shopify.com/manual/payments/currency-formatting). |\n| `rich_text_field` | The rich text value as simple text. |\n",
      "syntax": "",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product.metafields.information.dosage | metafield_text }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": false
    },
    {
      "name": "Complex types",
      "description": "\nThe following metafield types produce different output depending on the provided `field` parameter:\n\n- [`list.metaobject_reference`](/docs/api/liquid/filters/metafield_text#metafield_text-list.metaobject_reference)\n- [`metaobject_reference`](/docs/api/liquid/filters/metafield_text#metafield_text-metaobject_reference)\n",
      "syntax": "",
      "path": "/products/health-potion",
      "raw_liquid": "",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": false
    },
    {
      "name": "list.metaobject_reference",
      "description": "Outputs the list of metaobjects in sentence format. The required `field` parameter specifies which field should be rendered for each metaobject. The `field` parameter can reference only metafields of type `single_line_text_field`.\n",
      "syntax": "metafield | metafield_text: field: string",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product.metafields.information.ingredients | metafield_text: field: 'name' }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": false
    },
    {
      "name": "metaobject_reference",
      "description": "Outputs the metafield text for the metaobject field specified by the required `field` parameter. The `field` parameter can reference only metafields of type `single_line_text_field`.\n",
      "syntax": "metafield | metafield_text: field: string",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product.metafields.information.primary_ingredient | metafield_tag: field: 'name' }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": false
    }
  ],
  "summary": "Generates a text version of the data from a [`metafield` object](https://shopify.dev/docs/api/liquid/objects/metafield).",
  "syntax": "metafield | metafield_text",
  "name": "metafield_text"
}