Skip to content

AlchemyCMS/alchemy-vue

Repository files navigation

AlchemyCMS mixins for VueJS

Build Status npm version

VueJS mixins for rendering content from AlchemyCMS

Install

yarn add @alchemy_cms/vue

Usage

In a page component

import { AlchemyPage } from "@alchemy_cms/vue"

export default {
  mixins: [AlchemyPage],
}

You now have acces to the page prop and its elements. Also you have access to the componentName() method that you can use to dynamically render element components.

<template>
  <div :class="page.page_layout">
    <component
      :is="componentName(element)"
      v-for="element in page.elements"
      :key="element.id"
      :element="element"
    />
  </div>
</template>

<script>
  import { AlchemyPage } from "@alchemy_cms/vue"
  import MainHeader from "~/alchemy/elements/main_header"
  import TextBlock from "~/alchemy/elements/text_block"

  export default {
    components: {
      main_header: MainHeader,
      text_block: TextBlock,
    },
    mixins: [AlchemyPage],
  }
</script>

Note you need to pass the data into the components page prop either by fetching it from the Alchemy API or by erb interpolation.

In an element component

import { AlchemyElement } from "@alchemy_cms/vue"

export default {
  mixins: [AlchemyElement],
}

With this mixin you have acces to the element prop and its ingredients.

Also you have access to the getIngredient() and getEssence() methods that you can use to pass content from Alchemy objects into your components props.

<template>
  <Container>
    <Image :src="imageUrl" :alt="imageAlt" />
    <Paragraph class="text" v-html="text" />
  </Container>
</template>

<script>
  import { AlchemyElement } from "@alchemy_cms/vue"
  import Container from "~/components/Container"
  import Image from "~/components/Image"
  import Paragraph from "~/components/Paragraph"

  export default {
    components: { Container, Image, Paragraph },
    mixins: [AlchemyElement],
    computed: {
      imageUrl() {
        return this.getIngredient("picture")
      },
      altText() {
        return this.getEssence("picture")?.alt_text
      },
      text() {
        return this.getIngredient("text")
      },
    },
  }
</script>

Note you need to pass the data into the components element prop either by fetching it from the Alchemy API, by passing it from a page component (see example above) or by erb interpolation.

camelCase attributes

This package supports camelCase attributes as well was under_score attributes.