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 ipsumvalue: 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.