关于前端:Headless-CMS-Sanity-数据建模定义文档内容的结构

定义内容的构造。

应用代码定义内容模型是设计使然。它使版本控制变得更容易，并使开发人员可能管制数据结构的布局形式。咱们让在界面中增加、更改和删除字段变得毫不费力。

观看 Schema 工作原理的视频，或滚动浏览它的工作原理。

当 Sanity 启动时，默认在我的项目 schemas 文件夹中查找 schema.js。让咱们来构建一个简略的 Schema 开始：

// 首先，必须引入 schema-creator
import createSchema from "part:@sanity/base/schema-creator";

// 而后引入插件可能裸露的 Schema 类型 expose them
import schemaTypes from "all:part:@sanity/base/schema-type";

// 接着创立 Schema
export default createSchema({
  // 名称
  name: "mySchema",

  // 连贯文档类型，目前只须要一个
  types: schemaTypes.concat([
    {
      // 类型显示名称
      title: "Person",

      //API 标识符
      name: "person",

      // 文档类型为 `document `
      type: "document",

      // 字段申明
      fields: [
        // 该文档类型仅有一个字段
        {
          // 显示名称
          title: "Name",

          // API 标识符
          name: "name",

          // 字段类型
          type: "string",
        },
      ],
    },
  ]),
});

这个 Schema 配置创立了一个 person 的文档类型，它蕴含一个 name 字段。

稍后通过 API 获取这样的文档时，咱们会失去这样的文档：

{
  "_id": "45681087-46e7-42e7-80a4-65b776e19f91",
  "_type": "person",
  "name": "Ken Kesey"
}

当初来设计一个形容一本书的简略文档。类型数组中，咱们增加这样一个对象：

{
  title: 'Book',
  name: 'book',
  type: 'document',
  fields: [
    {
      title: 'Title',
      name: 'title',
      type: 'string'
    },

    {
      title: 'Cover',
      name: 'cover',
      type: 'image'
    },

    {
      title: 'Author',
      name: 'author',
      // `reference` 类型来指向另一个文档
      type: 'reference',
      // 这个援用只容许指向 `person` 类型的文档
      // 尽管能够列举更多类型，但尽量放弃精简:
      to: [{type: 'person'}]
    }
  ]
}

这个 Schema 创立了一个叫做 book 的文档类型，它蕴含三个字段：

题目
封面图片
作者（该字段援用了另一个文档，在 to 字段里形容援用的文档类型。列出了一条规定为，类型能够是 person）

表单看起来是这个样子：

当通过 API 获取这个文档时，咱们会失去：

{
  _id: "d1760c53-428c-4324-9297-ac8313276c45",
  _type: "book",
  title: "One Flew Over the Cuckoos Nest",
  cover: {
    _type: "image",
    asset: {
      _ref: "image-Su3NWQ712Yg0ACas3JN9VpcS-322x450-jpg",
      _type: "reference"
    }
  },
  author: {
    _ref: "45681087-46e7-42e7-80a4-65b776e19f91",
    _type: "reference"
  }
}

如您所见，作者字段没有提及 Ken Kesey，但字段 _ref 中蕴含了 Ken Kesey 文档的 id。当获取援用的文档时，能够轻松的通过批示 API 去领会为指标文档的理论内容。您能够在 Query 教程中浏览更多相干信息。

让咱们谈谈数组：有些书有不止一位作者。咱们应该通过将作者字段设置为援用数组来改良 Book 文档类型：

{
  title: 'Authors',
  name: 'authors',
  type: 'array',
  of: [{
    type: 'reference',
    to: [{type: 'person'}]
  }]
}

从 API 返回的文档将如下所示：

{
  _id: "drafts.e7f370d0-f86f-4a09-96ea-12f1d9b236c4",
  _type: "book",
  title: "The Illuminatus! Trilogy",
  cover: {
    _type: "image",
    asset: {
      _ref: "image-Ov3HwbkOYkNrM2yabmBr2M8T-318x473-jpg",
      _type: "reference"
    }
  },
  authors: [
    {
      _ref: "9a8eb52c-bf37-4d6e-9321-8c4674673198",
      _type: "reference"
    },
    {
      _ref: "ee58f2ff-33ed-4273-8031-b74b5664ff5e",
      _type: "reference"
    }
  ]
}

最初的留神点是组织你的文件（们）。在这个示例中，咱们将两种类型文档的定义都沉积到了同一个 JS 文件中。不举荐这么做；这会很快让代码失控。举荐的做法是在每个独自的文件中形容每种文档类型：

// 文件：schemas/schema.js
import createSchema from 'part:@sanity/base/schema-creator'
import schemaTypes from 'all:part:@sanity/base/schema-type'
import person from './person'

export default createSchema({
  name: 'mySchema',
  types: schemaTypes.concat([person])
})



// 文件：schemas/person.js
export default {
  title: "Person",
  name: "person",
  type: "document",
  fields: [
    {
      title: "Name",
      name: "name",
      type: "string",
    }
  ]
}

这涵盖了十分根底的内容，但还有更多内容！当初，让咱们深入探讨应用 Sanity 对内容进行建模时的最佳实际。

关于前端:Headless-CMS-Sanity-数据建模定义文档内容的结构

你的第一个 Schema

一个文档援用另一个文档

数组的一种应用

组织架构