@kong/portal-vue-spec-renderer

A Kong UI component for displaying uuid and copying it to clipboard.

• Features
• Requirements
• Usage
  • Install
  • Register
• Props
  • document
  • url
  • hasSidebar
  • essentialsOnly
  • slimMode

Features

• Render .yaml and .json OAS specs
• Customize display of parts of the UI

Requirements

• vue must be initialized in the host application

Usage

Install

Install the component in your host application

1@kong/portal-vue-spec-renderer

Register

You can register portal-vue-spec-renderer globally or locally.

1// Global registration
2import { createApp } from 'vue'
3import VueSpecRenderer from '@kong/portal-vue-spec-renderer'
4import '@kong/portal-vue-spec-renderer/dist/style.css'
5
6const app = createApp(App)
7
8app.use(VueSpecRenderer)
9

1<!-- Local registration -->
2<template>
3  <VueSpecRenderer />
4</template>
5
6<script setup lang="ts">
7import VueSpecRenderer from '@kong/portal-vue-spec-renderer'
8import '@kong/portal-vue-spec-renderer/dist/style.css'
9</script>

Props

document

• type: String|Object
• required: false
• default: null

Specification object or string. Required if url property is not set.

url

• type: String
• required: false
• default: ''

URL of the specification file. Required if document property is not set.

hasSidebar

• type: Boolean
• required: false
• default: true

Whether or not the SwaggerUI navigation sidebar is enabled.

essentialsOnly

• type: Boolean
• required: false
• default: false

If enabled, only display the spec paths section; general information, schemes, models, etc. are hidden.

slimMode

• type: Boolean
• required: false
• default: false

If enabled, will apply styles to conserve space. Hides path descriptions, decreases font-size of headings.