getView
Fetch a view from Drupal.
⚠️
You need to install the JSON:API Views module to use getView
.
const view = await drupal.getView<T = JsonApiResource>( name, options?: { params, withAuth, deserialize, locale, defaultLocale, }): Promise<DrupalView<T>>
name: string
- Required
- The name of the view and the display id. Example: "articles--promoted".
options
- Optional
params: JsonApiParams
: JSON:API params such asfilter
,fields
,include
orsort
.withAuth: boolean | DrupalClientAuth
:- Set the authentication method to use. See the authentication docs.
- Set to
true
to use the authentication method configured on the client.
deserialize: boolean
: Set to false to return the raw JSON:API response.locale: string
: The locale to fetch the view in.defaultLocale: string
: The default locale of the site.
Examples
- Get a view named
articles
and display idpromoted
.
const view = await drupal.getView("articles--promoted")
- Using sparse fieldsets to only fetch the title and body fields.
const view = await drupal.getView("articles--promoted", { params: { fields: { "node--article": "title,body", }, },})
TypeScript
- Using
DrupalNode
for a node entity type.
import { DrupalNode } from "next-drupal"
const view = await drupal.getView<DrupalNode>("articles--promoted")
See the TypeScript docs for more built-in types.