Skip to content
breadcrumb

DruxtBreadcrumb

View source on GitHub

Modules

DruxtBreadcrumb

The DruxtBreadcrumb component renders a list of breadcrumbs based on the active route.

Typedefs

ComponentOptions : Array.<array>

Provides the available naming options for the Wrapper component.

PropsData : object

Provides propsData for use in the Wrapper component.

ScopedSlots : object

Provides scoped slots for use in the Wrapper component.

Components : Array.<object>
ComponentData : object
WrapperData : object

DruxtBreadcrumb

The DruxtBreadcrumb component renders a list of breadcrumbs based on the active route.

Example

<DruxtBreadcrumb />

Example

<DruxtBreadcrumb path="/node/1" />

Example (DruxtBreadcrumb Wrapper component boilerplate)

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

<script>
import { DruxtBreadcrumbMixin } from 'druxt-breadcrumb'
export default {
  mixins: [DruxtBreadcrumbMixin]
}

Example (DruxtBreadcrumb with template injection)

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

.fetchCrumbs()

Fetch Crumbs

Kind: instance method of DruxtBreadcrumb


.props

Kind: static property of DruxtBreadcrumb


.home : boolean

Show home crumb?

Kind: static property of props
Default: true
Example

<DruxtBreadcrumb :home="false" />

.path : string

The Decoupled router path.

If not set, the Vue router value will be used instead.

Kind: static property of props
Example

<DruxtBreadcrumb path="/node/1" />

.langcode : string

The resource langcode.

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

<DruxtBreadcrumb langcode="en" />

.v-model : mixed

The module component model value.

Used to bypass the Drupal JSON:API fetch, setting the module data directly.

Kind: static property of props
Default: null
Example

<DruxtBreadcrumb v-model="{ foo: bar }" />

.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

<DruxtBreadcrumb
  :wrapper="{
    component: 'MyWrapper',
    class: 'wrapper',
    propsData: { foo: 'bar' }
  }"
/>

.crumbs : Array.<object>

The Breadcrumbs.

Kind: static property of props


.computed

Kind: static property of DruxtBreadcrumb


.crumbs

Kind: static property of computed
Properties

NameTypeDescription
crumbsArray.<objects>The Breadcrumbs.

.watch

Kind: static property of DruxtBreadcrumb


.$route()

Updates crumbs on Route change.

Kind: static method of watch


.druxt

DruxtModule settings

Kind: static property of DruxtBreadcrumb


.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

ParamTypeDescription
contextobjectThe module component ViewModel.

.fetchConfig()

Fetches the breadcrumbs.

Kind: static method of druxt


.propsData(context) ⇒ PropsData

Provides propsData for the DruxtWrapper.

Kind: static method of druxt

ParamTypeDescription
contextobjectThe module component ViewModel.

.slots() ⇒ ScopedSlots

Provides the scoped slots object for the Module render function.

The default slot renders crumbs as a list of NuxtLink's.

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


.error()

Sets the component to render a DruxtDebug error message.

Kind: instance method of DruxtBreadcrumb


.getModuleComponents() ⇒ Components

Get list of module wrapper components.

Kind: instance method of DruxtBreadcrumb


.getModulePropsData() ⇒ object

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

Kind: instance method of DruxtBreadcrumb
Example

{
  bar: 'foo',
  foo: 'bar',
}

.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 DruxtBreadcrumb


.getWrapperData(component) ⇒ WrapperData

Get wrapper component data.

Kind: instance method of DruxtBreadcrumb

ParamTypeDescription
componentstringThe Wrapper component name.

.methods

Kind: static property of DruxtBreadcrumb


.data()

Kind: static method of DruxtBreadcrumb
Properties

NameTypeDescription
componentComponentDataThe wrapper component and propsData to be rendered.
modelobjectThe model object.

.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 DruxtBreadcrumb
Example (Manually invoking DruxtModule.fetch().)

import DruxtModule from 'druxt/dist/components/DruxtModule.vue'
export default {
  name: 'DruxtTestModule',
  extends: DruxtModule,
  async fetch() {
    await DruxtModule.fetch.call(this)
  }
  druxt: {
    componentOptions: () => ([['wrapper']]),
    propsData: (ctx) => ({
      bar: ctx.bar,
      foo: ctx.foo,
    }),
  }
}

.lang() ⇒ 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 DruxtBreadcrumb
Returns: string - The current language code.


ComponentOptions : Array.<array>

Provides the available naming options for the Wrapper component.

Kind: global typedef
Example

[
  'DruxtBreadcrumb[Default][Langcode]',
  'DruxtBreadcrumb[Default]',
]

Example

[
  'DruxtBreadcrumbDefaultEn',
  'DruxtBreadcrumbDefault',
]

PropsData : object

Provides propsData for use in the Wrapper component.

Kind: global typedef

ParamTypeDescription
crumbsArray.<objects>The Breadcrumbs.
valueArray.<objects>The Breadcrumbs value.

Example

{
  crumbs: [{
    text: 'Home',
    to: '/',
  }],
  value: [{
    text: 'Home',
    to: '/',
  }],
}

ScopedSlots : object

Provides scoped slots for use in the Wrapper component.

Kind: global typedef

ParamTypeDescription
defaultfunctionCrumbs as a list of NuxtLink's.

Example (DruxtBreadcrumbDefault.vue)

<template>
  <div>
    <slot />
  </div>
</template>

Components : Array.<object>

Kind: global typedef
Properties

NameTypeDescription
globalbooleanComponent global registration state.
namestringThe component name.
partsArray.<string>The component naming parts.

Example

[{
  global: true,
  pascal: 'DruxtTestModuleWrapper',
  parts: ['Wrapper'],
}]

ComponentData : object

Kind: global typedef
Properties

NameTypeDefaultDescription
$attrsobjectpropsData not registered by the Wrapper component.
isstring"DruxtWrapper"The Wrapper component name.
optionsArray.<string>The Wrapper component options.
propsobjectpropsData registered by the Wrapper component.
propsDataobjectThe component propsData object.
settingsobjectDruxt settings object provided by the Wrapper component.

Example

{
  $attrs: { bar: 'foo' },
  is: 'DruxtTestModuleWrapper',
  options: [
    'DruxtTestModuleWrapper',
  ],
  props: { foo: 'bar' },
  propsData: {
    bar: 'foo',
    foo: 'bar',
  },
  settings: { fooBar: true },
}

WrapperData : object

Kind: global typedef
Properties

NameTypeDescription
druxtobjectDruxt settings object for use by Druxt module.
propsobjectRegistered props oject.

Example

{
  druxt: { fooBar: true },
  props: {
    foo: {
      type: String,
      default: '',
    }
  }
}