This component is being deprecated. The code base has been moved to api-documentation module. This module will be archived when PR 37 is merged.
An element to render RAML annotations based on AMF data model.
This version only works with AMF model version 2 (AMF parser >= 4.0.0).
For compatibility with previous model version use 3.x.x version of the component.
npm install --save @api-components/api-annotation-documentThe element requires to set the amf property with the full generated AMF model to properly resolve compact JSON model. It also requires to set the shape property to whatever API property being currently documented (endpoint, method, type (including properties of a type which is also a type), security, security settings, and so on).
<html>
<head>
<script type="module">
import '@api-components/api-annotation-document/api-annotation-document.js';
</script>
</head>
<body>
<api-annotation-document></api-annotation-document>
<script>
{
const model = await getAmfModelSomehow();
const shape = computeCurrentShape(model, someId);
const aad = document.querySelector('api-annotation-document');
aad.amf = model;
aad.shape = shape;
}
</script>
</body>
</html>import { LitElement, html } from 'lit-element';
import '@api-components/api-annotation-document/api-annotation-document.js';
class SampleElement extends LitElement {
render() {
return html`
<api-annotation-document
.amf="${this.model}"
.shape="${this.shape}"
></api-annotation-document>
`;
}
}
customElements.define('sample-element', SampleElement);git clone https://github.com/advanced-rest-client/api-annotation-document
cd api-annotation-document
npm installnpm startnpm test