DruxtView

DruxtView

The DruxtView component renders Drupal Views using configuration and results provided by the Drupal View and the JSON:API Views module.

The component renders slots for the View's headers, footers, entity results, exposed sorts and filters, and supports contextual filters.

See: Component resolution
Example

<DruxtView display-id="block_1" view-id="promoted_items" />

Example (View with contextual filter)

<DruxtView
  :arguments="[entity.attributes.drupal_internal__nid]"
  display-id="block_1"
  view-id="articles_aside"
/>

Example (DruxtView Wrapper component boilerplate)

<template>
  <DruxtDebug :json="results" />
</template>

<script>
import { DruxtViewsViewMixin } from 'druxt-views'
export default {
  mixins: [DruxtViewsViewMixin]
}
</script>

Example (default slot (template injection))

<DruxtView>
  <template #default="{ results }">
    <!-- Do whatever you want here -->
    <DruxtDebug :json="results" />
  </template>
</DruxtView>

• DruxtView
  • instance
    • .getQuery(settings) ⇒ Query
    • .onFiltersUpdate()
    • .error(err, [context])
    • .getModuleComponents() ⇒ Components
    • .getModulePropsData(wrapperProps) ⇒ object
    • .getScopedSlots() ⇒ object
    • .getWrapperData(component) ⇒ WrapperData
  • static
    • .props
      • .arguments : array
      • .displayId : string
      • .settings : ModuleSettings
      • .type : string
      • .uuid : string
      • .viewId : string
      • .langcode : string
      • .v-model : mixed
      • .wrapper : (boolean | object)
    • .computed
      • .attachments_after : Array.<string>
      • .attachments_before : Array.<string>
      • .count : integer
      • .display : object
      • .filters : Array.<object>
      • .headers : Array.<object>
      • .mode : string
      • .pager : object
      • .results : Array.<object>
      • .showPager : boolean
      • .showSorts : boolean
      • .sorts : Array.<object>
    • .druxt
      • .template
      • .componentOptions(context) ⇒ ComponentOptions
      • .fetchConfig()
      • .fetchData(settings)
      • .propsData(vm) ⇒ PropsData
      • .settings(context, wrapperSettings) ⇒ object
      • .slots(h) ⇒ ScopedSlots
    • .data()
    • .methods
    • .fetch()
    • .lang(vm) ⇒ string

.getQuery(settings) ⇒ Query

Builds the query for the JSON:API request.

Kind: instance method of DruxtView

.onFiltersUpdate()

Filters update event handler.

Kind: instance method of DruxtView

.error(err, [context])

Sets the component to render a DruxtDebug error message.

Kind: instance method of DruxtView

.getModuleComponents() ⇒ Components

Get list of module wrapper components.

Kind: instance method of DruxtView

.getModulePropsData(wrapperProps) ⇒ object

Get module propsData via modules druxt.propsData() callback.

Kind: instance method of DruxtView

Example

{
  $attrs: { entity: {}, fields: {}, langcode: 'en', schema: {} },
  props: { value: {} },
  propsData: { entity: {}, fields: {}, langcode: 'en', schema: {}, value: {} },
}

.getScopedSlots() ⇒ object

Gets a Druxt modules scoped slots, and if there's no default slots, provides a develop mode debug default or passes through to a default template.

Kind: instance method of DruxtView

.getWrapperData(component) ⇒ WrapperData

Get wrapper component data.

Kind: instance method of DruxtView

.props

Vue.js Properties.

Kind: static property of DruxtView

• .props
  • .arguments : array
  • .displayId : string
  • .settings : ModuleSettings
  • .type : string
  • .uuid : string
  • .viewId : string
  • .langcode : string
  • .v-model : mixed
  • .wrapper : (boolean | object)

.arguments : array

Views contextual filters.

Kind: static property of props
Default: []
Example

<DruxtView :arguments="[1, 2, 3]" display-id="block_1" view-id="articles_aside" />

.displayId : string

The View Display ID.

Kind: static property of props
Default: "default"
Example

<DruxtView display-id="page_1" view-id="frontpage" />

.settings : ModuleSettings

Module settings object.

Kind: static property of props
Default: {}

.type : string

JSON:API Resource type.

Kind: static property of props
Default: "view--view"

.uuid : string

The View UUID.

Kind: static property of props
Example

<DruxtView uuid="f6c38097-d534-4bfb-87d9-09526fe44e9c" />

.viewId : string

The View ID.

Kind: static property of props
Example

<DruxtView view-id="frontpage" />

.langcode : string

The resource langcode.

Kind: static property of props
Example

@lang vue
<DruxtView langcode="en" />

.v-model : mixed

The Vue.js v-model binding for the module.

Setting a value provides the module data directly, so the Drupal JSON:API fetch is skipped.

Kind: static property of props
Default:
Example

@lang vue
<template>
  <DruxtView v-model="model" />
</template>

<script>
export default {
  data: () => ({ model: { foo: 'bar' } })
}
</script>

.wrapper : (boolean | object)

The wrapper component configuration.

Used to set the wrapper component, class, style and propsData.

Kind: static property of props
Default: () => undefined
Example

<DruxtView
  :wrapper="{
    component: 'BCard',
    class: 'article-card',
    propsData: { noBody: true }
  }"
/>

.computed

Kind: static property of DruxtView

• .computed
  • .attachments_after : Array.<string>
  • .attachments_before : Array.<string>
  • .count : integer
  • .display : object
  • .filters : Array.<object>
  • .headers : Array.<object>
  • .mode : string
  • .pager : object
  • .results : Array.<object>
  • .showPager : boolean
  • .showSorts : boolean
  • .sorts : Array.<object>

.attachments_after : Array.<string>

IDs of displays to be attached after the view.

Kind: static property of computed

.attachments_before : Array.<string>

IDs of displays to be attached before the view.

Kind: static property of computed

.count : integer

The total item count.

Kind: static property of computed

.display : object

The View Display object.

Kind: static property of computed

.filters : Array.<object>

Exposed filters.

Kind: static property of computed

.headers : Array.<object>

The View Headers data.

Kind: static property of computed

.mode : string

The View mode for the results entities.

Kind: static property of computed

.pager : object

The displays pager settings.

Kind: static property of computed

.results : Array.<object>

The JSON:API Views results.

Kind: static property of computed

.showPager : boolean

Whether a pager should be shown.

Kind: static property of computed

.showSorts : boolean

Whether Exposed sorts are available and should be displayed.

Kind: static property of computed

.sorts : Array.<object>

Exposed sorts.

Kind: static property of computed

.druxt

DruxtModule settings

Kind: static property of DruxtView

• .druxt
  • .template
  • .componentOptions(context) ⇒ ComponentOptions
  • .fetchConfig()
  • .fetchData(settings)
  • .propsData(vm) ⇒ PropsData
  • .settings(context, wrapperSettings) ⇒ object
  • .slots(h) ⇒ ScopedSlots

.template

Druxt development template tool configuration.

Kind: static property of druxt

.componentOptions(context) ⇒ ComponentOptions

Provides the available component naming options for the Druxt Wrapper.

Kind: static method of druxt

.fetchConfig()

Fetch View configuration resource.

Kind: static method of druxt

.fetchData(settings)

Fetch JSON:API Views results.

Kind: static method of druxt

.propsData(vm) ⇒ PropsData

Provides propsData for the DruxtWrapper.

Kind: static method of druxt

.settings(context, wrapperSettings) ⇒ object

Component settings.

Kind: static method of druxt
Returns: object - The merged module settings.

.slots(h) ⇒ ScopedSlots

Provides the scoped slots object for the Module render function.

• header
• filters
• sorts
• attachments_before
• results
• pager
• attachments_after
• default (all of the above)

Kind: static method of druxt
Returns: ScopedSlots - The Scoped slots object.

Example (DruxtViewViewId.vue)

<template>
  <div>
    <slot name="header" />
    <slot name="results" />
    <slot name="pager" />
  </div>
</template>

.data()

Kind: static method of DruxtView
Properties

.methods

Kind: static property of DruxtView

.fetch()

Loads the Druxt module data and applies a wrapper component as required.

Important: If your component has an existing fetch method, you must manually invoke the DruxtModule.fetch() hook.

Kind: static method of DruxtView
Example (Manually invoking DruxtModule.fetch().)

import DruxtModule from 'druxt/components/DruxtModule.vue'
export default {
  name: 'DruxtCustomModule',
  extends: DruxtModule,
  async fetch() {
    await DruxtModule.fetch.call(this)
  },
  druxt: {
    componentOptions: () => ([['Default']]),
    propsData: ({ model }) => ({ value: model }),
  }
}

.lang(vm) ⇒ string

The current language code: the langcode prop if set, otherwise the route's langcode metadata.

Used by Druxt modules to fetch the correct resource translation.

Kind: static method of DruxtView
Returns: string - The current language code.

ComponentOptions : Array.<array>

Provides the available component naming options for the Druxt Wrapper.

Kind: global typedef
Example

[
  'DruxtView[ViewId][DisplayId][Langcode]',
  'DruxtView[ViewId][DisplayId]',
  'DruxtView[ViewId][Langcode]',
  'DruxtView[ViewId]',
  'DruxtView[UUID][DisplayId][Langcode]',
  'DruxtView[UUID][DisplayId]',
  'DruxtView[UUID][Langcode]',
  'DruxtView[UUID]',
  'DruxtView[DisplayId][Langcode]',
  'DruxtView[DisplayId]',
]

Example (featured_articles (default))

[
  'DruxtViewFeaturedArticlesDefaultEn',
  'DruxtViewFeaturedArticlesDefault',
  'DruxtViewFeaturedArticlesEn',
  'DruxtViewFeaturedArticles',
  'DruxtView16f5d68e5bae4d7aa61c6b2bc3b6d3b6DefaultEn',
  'DruxtView16f5d68e5bae4d7aa61c6b2bc3b6d3b6Default',
  'DruxtView16f5d68e5bae4d7aa61c6b2bc3b6d3b6En',
  'DruxtView16f5d68e5bae4d7aa61c6b2bc3b6d3b6',
  'DruxtViewDefaultEn',
  'DruxtViewDefault',
]

ModuleSettings : object

Provides settings for the View module, via the nuxt.config.js druxt.views or the Wrapper component druxt object.

Kind: global typedef

Example (DruxtView Wrapper component)

<script>
export default {
  druxt: {
    query: {
      bypassCache: ({ $store }) => $store.$auth.loggedIn,
      bundleFilter: false,
      fields: [],
      resourceTypes: ['node--article'],
    },
  },
}
</script>

Example (DruxtView component with settings)

<template>
  <DruxtView
    display-id="block_1"
    view-id="promoted_items
    :settings="{
      query: {
        bypassCache: true,
        bundleFilter: false,
        fields: ['title']
        resourceTypes: [],
      }
    }"
  />
</template>

PropsData : object

Provides propsData for the DruxtWrapper.

Kind: global typedef

Example

{
  count: 8,
  display: {},
  mode: 'card',
  pager: {
    options: {},
    type: 'mini',
  },
  results: [],
  view: {},
}

ScopedSlots : object

Provides scoped slots for use in the Wrapper component.

Kind: global typedef

Example

{
  header: () => {},
  filters: () => {},
  sorts: () => {},
  attachments_before: () => {},
  results: () => {},
  pager: () => {},
  attachments_after: () => {},
  default: () => {},
}

Example (DruxtViewViewId.vue)

<template>
  <div>
    <slot name="header" />
    <slot name="results" />
    <slot name="pager" />
  </div>
</template>

Inherited type definitions

Inherited from DruxtModule: ComponentData, Components, WrapperData.