Story #

Create a story. Must be at the top level of the story file.

title #

Title of the story.

<template>
  <Story title="My story">
    Hello world
  </Story>
</template>

id #

Id of the story used in the URL. By default, the id is automatically generated from the file path. Setting an id manually will ensure the URL parameter doesn't change with the order of the variants in the story.

<template>
  <Story id="my-story">
    Hello world
  </Story>
</template>

layout #

Layout of the story. Object with the following properties:

• type: 'single' or 'grid'
• with type: 'single' you can specify:
  • iframe: Whether to isolate the story in an iframe. You might want to disable it if you want to pass complexe parameters that can't be serialized.
• with type: 'grid' you can specify:
  • width: Column size. Can be number (pixels) or string (like '100%').

Learn more

initState #

Function that returns the intial state. Will be used as default value for variants.

<script setup>
function initState () {
  return {
    disabled: false,
    content: "Hello world"
  }
}
</script>

<template>
  <Story title="My Button" :init-state="initState">
    <template #default="{ state }">
      <button :disabled="state.disabled">
        {{ state.content }}
      </button>
    </template>
  </Story>
</template>

Learn more

setupApp #

A function to configure the Vue application. This will be the default for the variants in the story.

It receives a payload object as parameter with the following properties:

• app: The Vue application instance.
• story: The story object.
• variant: The variant object.

<script setup>
function mySetupApp ({ app, story, variant }) {
  app.provide('demo', 'meow')
}
</script>

<template>
  <Story :setup-app="mySetupApp">
    <!-- ... -->
  </Story>
</template>

Learn more

group #

The id of a group to include the story in.

<template>
  <Story group="my-group">
    Hello world
  </Story>
</template>

Learn more

icon #

An Iconify id to customize the story icon in the tree.

<template>
  <Story icon="lucide:cpu">
    Hello world
  </Story>
</template>

iconColor #

The icon color.

<template>
  <Story icon-color="#8B5CF6">
    Hello world
  </Story>
</template>

docsOnly #

This story will only render a documentation page.

<template>
  <Story
    group="top"
    docs-only
    icon="carbon:bookmark"
  />
</template>

<docs lang="md">
# Welcome

This is a demo book using Vue 3.

---

Learn more about Histoire [here](https://histoire.dev/).
</docs>

source #

The copyable source code of the story.

<script setup>
const source = `<h1>Toto</h1>

<input
  v-model.number="count"
  type="number"
>`
</script>

<template>
  <Story :source="source">
    <!-- ... -->
  </Story>
</template>

responsiveDisabled #

Disables the responsive menu, preview resize handles and makes the preview laways fit the available space.

<template>
  <Story responsive-disabled>
    <!-- ... -->
  </Story>
</template>

autoPropsDisabled #

Disables the automatic detection of props of the components in the story.

<template>
  <Story auto-props-disabled>
    <!-- ... -->
  </Story>
</template>

Slot: controls #

Content of the 'Controls' pane used to interact with the story. This will be the default content for variants of the story but you can override it by defining a controls slot in a variant.

Props:

• state: Object with the current state of the variant (if you are using initState).

<template>
  <Story>
    <template #controls="{ state }">
      <!-- Interact with state here -->
    </template>

    <Variant>
      <!-- Controls reused here -->
    </Variant>
  </Story>
</template>

Learn more