使用swagger-config.yaml进行Swagger UI配置

Question

根据swagger文档，

null

我已经遵循了昂首阔步的安装步骤和它的工作正确。但是swagger自定义配置的步骤不起作用。我保存了如下文件，

 swagger-ui
   |--swagger-config.yaml
   |--index.html

url: "https://petstore.swagger.io/v2/swagger.json"
dom_id: "#swagger-ui"
validatorUrl: "https://online.swagger.io/validator"
oauth2RedirectUrl: "http://localhost:3200/oauth2-redirect.html"

// Begin Swagger UI call region
      const ui = SwaggerUIBundle({
        //url: "https://petstore.swagger.io/v2/swagger.json",
        //dom_id: '#swagger-ui',
        deepLinking: true,
        presets: [
          SwaggerUIBundle.presets.apis,
          SwaggerUIStandalonePreset
        ],
        plugins: [
          SwaggerUIBundle.plugins.DownloadUrl
        ],
        layout: "StandaloneLayout"
      })

你知道我是不是漏掉了什么吗？

Answer 1

我也有这个问题。从文档中看，如果使用swagger-config.xml，我们似乎不需要在index.html中配置任何东西，实际上，从我的角度来看，它不起作用，我还没有找到原因。但是如果改用configUrl，它就可以工作了。

// Begin Swagger UI call region
const ui = SwaggerUIBundle({
  //url: "https://petstore.swagger.io/v2/swagger.json",
  //dom_id: '#swagger-ui',
  configUrl: "../swagger-config.yaml",
  deepLinking: true,
  presets: [
    SwaggerUIBundle.presets.apis,
    SwaggerUIStandalonePreset
  ],
  plugins: [
    SwaggerUIBundle.plugins.DownloadUrl
  ],
  layout: "StandaloneLayout"
})

并且可以将其配置为支持数组。

---
urls:
 - url: "https://petstore.swagger.io/v2/swagger.json"
   name: "url1"
   
 - url: "https://petstore.swagger.io/v2/swagger.json"
   name: "url2"