DruxtBreadcrumb
View source on GitHubModules
- 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>
- 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
| Name | Type | Description |
|---|---|---|
| crumbs | Array.<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
| Param | Type | Description |
|---|---|---|
| context | object | The 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
| Param | Type | Description |
|---|---|---|
| context | object | The 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
| Param | Type | Description |
|---|---|---|
| component | string | The Wrapper component name. |
.methods
Kind: static property of DruxtBreadcrumb
.data()
Kind: static method of DruxtBreadcrumb
Properties
| Name | Type | Description |
|---|---|---|
| component | ComponentData | The wrapper component and propsData to be rendered. |
| model | object | The 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
| Param | Type | Description |
|---|---|---|
| crumbs | Array.<objects> | The Breadcrumbs. |
| value | Array.<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
| Param | Type | Description |
|---|---|---|
| default | function | Crumbs as a list of NuxtLink's. |
Example (DruxtBreadcrumbDefault.vue)
<template>
<div>
<slot />
</div>
</template>
Components : Array.<object>
Kind: global typedef
Properties
| Name | Type | Description |
|---|---|---|
| global | boolean | Component global registration state. |
| name | string | The component name. |
| parts | Array.<string> | The component naming parts. |
Example
[{
global: true,
pascal: 'DruxtTestModuleWrapper',
parts: ['Wrapper'],
}]
ComponentData : object
Kind: global typedef
Properties
| Name | Type | Default | Description |
|---|---|---|---|
| $attrs | object | propsData not registered by the Wrapper component. | |
| is | string | "DruxtWrapper" | The Wrapper component name. |
| options | Array.<string> | The Wrapper component options. | |
| props | object | propsData registered by the Wrapper component. | |
| propsData | object | The component propsData object. | |
| settings | object | Druxt 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
| Name | Type | Description |
|---|---|---|
| druxt | object | Druxt settings object for use by Druxt module. |
| props | object | Registered props oject. |
Example
{
druxt: { fooBar: true },
props: {
foo: {
type: String,
default: '',
}
}
}