Documenting Vue components

Innehåll

API documentation for Vue components can be enabled using the Vue File Reader:

await docs.build([
    {
        include: ["./docs/**/*.md"],
        fileReader: frontMatterFileReader,
    },
    {
        include: ["./src/**/*.vue"],
        fileReader: vueFileReader,
    },
]);

This will read each component and generate API documentation which can later be included in markdown with:

:::api
vue:AwesomeComponent
:::

For details about how to document Vue components see vue-docgen-api documentation.

Example

Props

foo: string Optional

Lorem ipsum dolor sit amet.

Must be one of:

  • "a"
  • "b"
  • "c"

Default: "foobar"

bar: string

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi eu mollis leo. Fusce eget ullamcorper augue. Aenean sodales fringilla purus, ac euismod massa semper sed.

obsolete: number Optional Deprecated

Lorem ipsum dolor sit amet.

Default: 42

Deprecated: Replaced by something else.

Events

change

Lorem ipsum dolor sit amet

Arguments:

  • id: number Lorem ipsum
  • value: unknown Lorem ipsum
update

Lorem ipsum dolor sit amet

Arguments:

  • value: string Lorem ipsum
obsolete Deprecated

Lorem ipsum dolor sit amet

Arguments:

  • value: string Lorem ipsum

Deprecated: Will be gone later.

Slots

default

Lorem ipsum dolor sit amet

foo

Lorem ipsum dolor sit amet

Bindings:

  • foo: number Lorem ipsum dolor sit amet
  • bar: number Lorem ipsum dolor sit amet
  • baz: unknown
obsolete Deprecated

Lorem ipsum dolor sit amet.

Deprecated: Use another slot instead.

Esc för att stänga Pil upp/ner för att navigera Enter för att välja