Значение поля по умолчанию

Директива @default для присвоения значения null-полям или пустым полям.

​

Описание

Директива @default принимает два аргумента:

1. value: значение по умолчанию любого скалярного типа (string, boolean, integer, float или ID).
2. condition: условие — поле должно быть null или пустым; задаётся через значения перечисления IS_NULL или IS_EMPTY. По умолчанию используется null.

В примере ниже, когда у записи нет избранного изображения, поле featuredImage возвращает null:

{
  post(by: { id: 1 }) {
    featuredImage {
      id
      src
    }
  }
}Copy

{
  "data": {
    "post": {
      "featuredImage": null
    }
  }
}Copy

Используя @default, можно получить изображение по умолчанию:

{
  post(by: { id: 1 }) {
    featuredImage @default(value: 55) {
      id
      src
    }
  }
}Copy

{
  "data": {
    "post": {
      "featuredImage": {
        "id": 55,
        "src": "http://mysite.com/wp-content/uploads/my-default-image.webp"
      }
    }
  }
}Copy