render タグ（スニペット・アプリブロックの読み込み）

{
  "category": "theme",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "Inside snippets and app blocks, you can't directly access variables that are [created](/docs/api/liquid/tags/variable-tags) outside\nof the snippet or app block. However, you can [specify variables as parameters](/docs/api/liquid/tags/render#render-passing-variables-to-a-snippet)\nto pass outside variables to snippets.\n\nWhile you can't directly access created variables, you can access global objects, as well as any objects that are\ndirectly accessible outside the snippet or app block. For example, a snippet or app block inside the [product template](/themes/architecture/templates/product)\ncan access the [`product` object](/docs/api/liquid/objects/product), and a snippet or app block inside a [section](/themes/architecture/sections)\ncan access the [`section` object](/docs/api/liquid/objects/section).\n\nOutside a snippet or app block, you can't access variables created inside the snippet or app block.\n\n> Note:\n> When you render a snippet using the `render` tag, you can't use the [`include` tag](/docs/api/liquid/tags/include)\n> inside the snippet.",
  "parameters": [],
  "summary": "Renders a [snippet](/themes/architecture/snippets) or [app block](/themes/architecture/sections/section-schema#render-app-blocks).",
  "name": "render",
  "syntax": "{% render 'filename' %}",
  "syntax_keywords": [
    {
      "keyword": "filename",
      "description": "The name of the snippet to render, without the `.liquid` extension."
    }
  ],
  "examples": [
    {
      "name": "for",
      "description": "You can render a snippet for every item in an array using the `for` parameter. You can also supply an optional `as` parameter to be able to reference the current item in the iteration inside the snippet.\nAdditionally, you can access a [`forloop` object](/docs/api/liquid/objects/forloop) for the loop inside the snippet.\n",
      "syntax": "{% render 'filename' for array as item %}",
      "path": "/",
      "raw_liquid": "",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "Passing variables to a snippet",
      "description": "Variables that have been [created](/docs/api/liquid/tags/variable-tags) outside of a snippet can be passed to a snippet as parameters on the `render` tag.\n\n> Note:\n> Any changes that are made to a passed variable apply only within the snippet.\n",
      "syntax": "{% render 'filename', variable: value %}",
      "path": "/",
      "raw_liquid": "",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "with",
      "description": "You can pass a single object to a snippet using the `with` parameter. You can also supply an optional `as` parameter to specify a custom name to reference the object inside the snippet. If you don't use the `as` parameter to specify a custom name, then you can reference the object using the snippet filename.\n",
      "syntax": "{% render 'filename' with object as name %}",
      "path": "/",
      "raw_liquid": "",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    }
  ]
}