# variant

> Shoplazza Theme 中的 variant Liquid 对象：表示商品的一个 variant，含价格、库存、选项取值等全部属性。

商品的 variant。

| Properties | Type | Description |
| --- | --- | --- |
| `available` | [boolean](/zh-CN/docs/theme/references/liquid/basics/liquid-types#boolean) | 若该 variant 有货，则返回 `true`；否则返回 `false`。 |
| `available_quantity` | [number](/zh-CN/docs/theme/references/liquid/basics/liquid-types#number) | variant 的可用数量。 |
| `barcode` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的条形码。 |
| `compare_at_price` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的**对比价格**，以店铺货币的主单位表示（例如 `33` 经 money 过滤器显示为 `$33.00`），并非最小单位。<br>该值以客户当地（展示）货币输出。 |
| `id` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的 ID。 |
| `image` | [image](/zh-CN/docs/theme/references/liquid/objects/image) | variant 关联的图片。 |
| `inventory_quantity` | [number](/zh-CN/docs/theme/references/liquid/basics/liquid-types#number) | variant 的库存数量。 |
| `note` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的备注。 |
| `off_ratio` | [number](/zh-CN/docs/theme/references/liquid/basics/liquid-types#number) | variant 的折扣比率。 |
| `option1` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 在第一个商品选项的值。<br>若没有第一个商品选项，则返回 `nil`。 |
| `option2` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 在第二个商品选项的值。<br>若没有第二个商品选项，则返回 `nil`。 |
| `option3` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 在第三个商品选项的值。<br>若没有第三个商品选项，则返回 `nil`。 |
| `options` | an array of [variant_option](/zh-CN/docs/theme/references/liquid/objects/variant_option) | variant 在每个商品选项的值。 |
| `price` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的价格，以店铺货币的主单位表示（例如 `33` 经 money 过滤器显示为 `$33.00`），并非最小单位。<br>该值以客户当地（展示）货币输出。 |
| `product_id` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 父商品的 id。 |
| `retail_price` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的零售价格，以店铺货币的主单位表示（例如 `33` 经 money 过滤器显示为 `$33.00`），并非最小单位。<br>该值以客户当地（展示）货币输出。 |
| `sales` | [number](/zh-CN/docs/theme/references/liquid/basics/liquid-types#number) | variant 的销售量。 |
| `sku` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的 SKU。 |
| `title` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | 每个 variant 选项的串联，以 `-` 分隔。 |
| `url` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的 URL。<br>Variant URL 使用以下结构：<br>`/products/[product-handle]?variant=[variant-id]` |
| `weight` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 的重量。 |
| `weight_unit` | [string](/zh-CN/docs/theme/references/liquid/basics/liquid-types#string) | variant 重量的单位。 |
| `wholesale_price` | an array | variant 的批发价格。 |

**对象**

```json
{
  "id": "9953d128-28fe-46d8-b6cb-357994b96b6d",
  "product_id": "6842d11a-efff-4e0f-beaf-c822ccfad6b8",
  "title": "DarkRed-35",
  "weight_unit": "kg",
  "inventory_quantity": 83,
  "sku": "WFF19FF0321D32-1",
  "barcode": "",
  "position": 1,
  "option1": "DarkRed",
  "option2": "35",
  "option3": "",
  "note": "1122",
  "image": null,
  "wholesale_price": [
    {
      "price": 328,
      "min_quantity": 1
    }
  ],
  "weight": "0",
  "compare_at_price": "358",
  "price": "328",
  "retail_price": "358",
  "available": true,
  "url": "/products/lace-up-leather-manston-runner?variant=9953d128-28fe-46d8-b6cb-357994b96b6d",
  "available_quantity": 999999999,
  "options": [
    {
      "name": "Color",
      "value": "DarkRed"
    },
    {
      "name": "Size",
      "value": "35"
    }
  ],
  "off_ratio": 8,
  "flashsale_info": [],
  "sales": 4
}
```