Skip to content

02-the-document-object.md

Latest commit

 

History

History
116 lines (86 loc) · 2.4 KB

02-the-document-object.md

File metadata and controls

116 lines (86 loc) · 2.4 KB

The Document object

Here we will discuss the document object for Prismic when using the Ruby development kit.

Before Reading

This article assumes that you have queried your API and saved the document object in a variable named document.

An example response

Let's start by taking a look at the Document Object returned when querying the API. Here is a simple example of a document that contains a couple of fields.

--- !ruby/object:Prismic::Document
id: WKxlPCUAAIZ10EHU
uid: example-page
type: page
href: https://your-repo-name.prismic.io/api/documents/search?ref=WKxlPyUEEAdz...,
tags:
  - Tag 1
  - Tag 2
slugs:
  - example-page
first_publication_date: 2017-01-13 11:45:21.000000000 +00:00
last_publication_date: 2017-02-21 16:05:19.000000000 +00:00
lang: en-us
alternate_languages:
  fr-fr: !ruby/object:Prismic::AlternateLanguage
    id: WZcAEyoAACcA0LHi
    uid: example-page-french
    type: page
    lang: fr-fr
fragments:
  title: !ruby/object:Prismic::Fragments::StructuredText
    blocks:
      - !ruby/object:Prismic::Fragments::StructuredText::Block::Heading
        text: Example Page
        spans: []
        label:
        level: 1
  date: !ruby/object:Prismic::Fragments::Date
    value: 2017-01-13 00:00:00.000000000 +01:00

Accessing Document Fields

Here is how to access each document field.

ID

document.id;

UID

document.uid;

Type

document.type;

API Url

document.href;

Tags

document.tags;
// returns an array

First Publication Date

document.first_publication_date;

Last Publication Date

document.last_publication_date;

Language

document.lang;

Alternate Language Versions

document.alternate_languages;
// returns an array

You can read more about this in the Multi-language Templating page.

Document Content

To retrieve the content fields from the document you must specify the API ID of the field. Here is an example that retrieves a Date field's content from the document. Here the Date field has the API ID of date.

// Assuming the document is of the type 'page'
document["page.date"].value;

Refer to the specific templating documentation for each field to learn how to add content fields to your pages.