JSPM – swagger-ui-kong-theme@1.1.6

Package Exports

swagger-ui-kong-theme

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (swagger-ui-kong-theme) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

This repo is a plugin for Swagger-UI that loads a custom 2/3 column theme, and adds code snippets with react-apiembed

This repo is still under development and changes are coming

Known Issues

Swagger-UI does mot support react 16. If you have react 16 ANYWHERE loaded/bundled on the same page as swagger you will not be able to fill in required perameters on try it https://github.com/swagger-api/swagger-ui/issues/4745

Workaround: Use yarm not npm make sure you have

  "resolutions": {
    "react": "15.6.2",
    "react-dom": "15.6.2"
  }

in your package json

How to load

yarn add swagger-ui-kong-theme

From where you are loading your Swagger-Ui

import { SwaggerUIKongTheme } from 'swagger-ui-kong-theme'

As part of the options include SwaggerUIKongTheme in the plugins array and 'KongLayout' as your Layout

for example:

const swaggerUIOptions = {
    spec: swaggerSpec, // Define data to be used
    dom_id: '#ui-wrapper', // Determine what element to load swagger ui
    docExpansion: 'list',
    deepLinking: true, // Enables dynamic deep linking for tags and operations this is needed for sidebar
    filter: true,
    presets: [
      SwaggerUIBundle.presets.apis,
      SwaggerUIStandalonePreset
    ],
    plugins: [
      SwaggerUIKongTheme,
      SwaggerUIBundle.plugins.DownloadUrl
    ],
    layout: 'KongLayout',
    theme:
      {
        "swaggerAbsoluteTop": "0px", // the top most container is set absolute at this distance from top. (default 0)
        "hasSidebar": true, // enables sidebar (default off)
        "languages" : [ // sets langagues for sidebar (default bash, javascript, python, ruby)
          {
            "prismLanguage":"bash",
            "target":"shell",
            "client":"curl"
          },{
            "prismLanguage":"ruby",
            "target":"ruby"
        }]
      }
    }
  }

  const ui = SwaggerUIBundle(swaggerUIOptions)

How to develop

run to install required packages yarn

run to build npm run build

How to use Demo

follow dev steps above then: cd demo yarn yarn start

Contributing

For problems directly related to this plugin, add an issue on GitHub.

For other issues, see Swagger UI https://github.com/swagger-api/swagger-ui