如何结合 gatsby 片段创建 gatsby schema

Question

我正在尝试为 gatsby graphql 查询定义正确的架构，以便它可以返回 null （以使内容可选）。据我了解，我需要在 gatsby-node.js 文件中预定义架构，以便 gatsby 不必通过数据推断类型。但是我不确定模式定义需要是什么，因为我们使用 gatsby 片段来查询数据。这是查询（的一部分）：

... on ContentfulWorkPage {
  comingSoon {
   id
   title
   image {
     fluid(quality: 92, maxWidth: 1280) {
       ...GatsbyContentfulFluid_withWebp_noBase64
     }
   }
   comingSoonText
  }
}

问题是我不知道如何定义GatsbyContentfulFluid_withWebp_noBase64

我正在尝试什么：

const types = `
    type ContentfulWorkPage implements Node {
      comingSoon: ComingSoon
    }

    type ComingSoon {
      id: String
      title: String
      comingSoonText: String
      image: Image
    }

    type Image {
      fluid: Fluid
    }

   type Fluid {
    quality: Int
    maxWidth: Int
    title: String
   }
  `
  createTypes(types)

尽管我认为我走在正确的轨道上，但我仍然遇到以下错误：

There was an error in your GraphQL query:

Unknown argument "quality" on field "fluid" of type "Image".

GraphQL request:70:21
69 |             image {
70 |               fluid(quality: 92, maxWidth: 1280) {
   |                     ^
71 |                 ...GatsbyContentfulFluid_withWebp_noBase64

File: src/templates/mainPages/work.js:105:21


 ERROR #85901  GRAPHQL

There was an error in your GraphQL query:

Unknown argument "maxWidth" on field "fluid" of type "Image".

GraphQL request:70:34
69 |             image {
70 |               fluid(quality: 92, maxWidth: 1280) {
   |                                  ^
71 |                 ...GatsbyContentfulFluid_withWebp_noBase64

File: src/templates/mainPages/work.js:105:34


 ERROR #85901  GRAPHQL

There was an error in your GraphQL query:

Fragment "GatsbyContentfulFluid_withWebp_noBase64" cannot be spread here as objects of type "Fluid" can never be of type "ContentfulFluid".

GraphQL request:71:17
70 |               fluid(quality: 92, maxWidth: 1280) {
71 |                 ...GatsbyContentfulFluid_withWebp_noBase64
   |                 ^
72 |               }

Answer 1

因此，我在深入研究 gatsby 文档（https://www.gatsbyjs.com/docs/actions/#printTypeDefinitions）后设法解决了这个问题。我发现在gatsby-node.js文件中您可以使用一个printTypeDefinitions函数来打印数据类型，然后您可以使用该函数来预先定义可选属性：

exports.createSchemaCustomization= ({ actions }) => {
  actions.printTypeDefinitions({path: './typeDefs.txt'})
}

这将在您的根文件夹中创建一个typeDefs.txt文件，其中描述了所有推断的类型。因此，如果您正在寻找像我一样更复杂的类型定义，以便它们可以在 contentful 中成为可选，您可以：

• 将一些数据添加到 contentful 中的可选字段（或您正在使用的任何后端/服务器）
• 使用该函数从数据中获取类型定义
• 从 typeDefs 文件中复制您需要的任何部分，然后
• 在 createTypes 函数中使用它createSchemaCustomization

示例（comingSoon定义是从 typeDevs 文件复制的）：

exports.createSchemaCustomization = ({ actions }) => {
  const contentfulSomePage = `
      type ContentfulSomePage implements Node {
        comingSoon: [ContentfulCaseComingSoon] @link(by: "id", from: "comingSoon___NODE")
      }

      type ContentfulCaseComingSoon implements Node @derivedTypes @dontInfer {
        title: String
        comingSoonText: String
        image: ContentfulAsset @link(by: "id", from: "image___NODE")
      }
  `
  actions.createTypes(contentfulWorkPage)
}

额外提示：如果您只需要指定一个属性为可选，但其余属性可以推断。删除@dontInfer注释并仅复制可为空的属性，而不是从文件中复制整个类型。