1 Star 3 Fork 1

run27017 / swagger-doc-preview

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

swagger-doc-preview

实时预览 Swagger 文档 ,您只需要输入一个 Swagger JSON 的文档地址即可渲染。项目主页:

https://github.com/run27017/swagger-doc-preview

主要特点:

  • 历史记录
  • 原生 SwaggerUI 配置对象
  • 定时刷新

使用指南

既可作为库使用,亦可独立部署。

作为库使用

前提: 需要自己管理 Vue、ElementUI 和 SwaggerUI 库。

首先在自己的项目内安装依赖包:

$ yarn add vue element-ui swagger-ui swagger-doc-preview

然后在项目内初始化 element-ui

import Vue from 'vue'
import ElementUI from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css'

Vue.use(ElementUI)

最后在页面内引入组件

<template>
  <SwaggerDocPreview />
</template>

<script>
import SwaggerDocPreview from 'swagger-doc-preview'

export default {
  components: {
    SwaggerDocPreview
  }
}
</script>

独立部署

安装依赖

$ yarn

构建静态文件目录

$ yarn run build

会生成一个 dist 目录。

组件列表

SwaggerDocPreview 是一个集历史列表、配置于一体的完整组件,其中的零部件可以单独引入。例如可单独引入 CustomizeConfig组件:

<template>
  <CustomizeConfig ref="customizeConfig" @change="onConfigChange" />
</template>

<script>
import { CustomizeConfig } from 'swagger-doc-preview'

export default {
  components: {
    CustomizeConfig
  },
  methods: {
    onConfigChange (config) {
      console.log('New config saved', config)
    }
  }
}
</script>

CustomizeConfig

通过一个按钮打开一个 JSON 格式的配置项编辑框,支持 Swagger UI 原生配置项,参考文档 Swagger UI Configuration. 在原生配置项之外增加一个 showErrors 键,设置为 true 可在 Swagger 文档有错误时显示错误信息。

<template>
  <CustomizeConfig ref="customizeConfig" @change="onConfigChange" />
</template>

SwaggerUIBundle

一个封装过的 SwaggerUI 构造函数,在原生构造函数的基础上增加了 showErrors 选项。

SwaggerEditorBundle

一个封装过的 SwaggerUI 构造函数,在原生组件的基础上删除了自动保存到 localStorage 的能力。

License

MIT

空文件

简介

实时预览 Swagger 文档 展开 收起
JavaScript 等 3 种语言
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/run27017/swagger-doc-preview.git
git@gitee.com:run27017/swagger-doc-preview.git
run27017
swagger-doc-preview
swagger-doc-preview
master

搜索帮助