Swagger UI 2.1.0+ 更新: The sorter
参数已分为两个参数,如中所述Fix 1040 https://github.com/swagger-api/swagger-ui/issues/1040, Fix 1280 https://github.com/swagger-api/swagger-ui/pull/1280:
apis分类器
对 API/标签列表应用排序。它可以是“阿尔法”
(按名称排序)或函数(请参阅 Array.prototype.sort() 了解如何
排序功能有效)。默认是服务器返回的顺序
不变。
操作分拣机
对每个API的操作列表进行排序。它可以是“alpha”(按路径字母数字排序)、“method”(按路径排序)
HTTP 方法)或函数(请参阅 Array.prototype.sort() 了解如何
排序功能有效)。默认是服务器返回的顺序
不变。
所以你会想要更新sorter
to apisSorter
按字母顺序对 API 列表进行排序,和/或operationsSorter
对每个API的操作列表进行排序。宠物店demo已经更新为apisSorter,如下图:
Example https://github.com/swagger-api/swagger-ui/blob/master/src/main/html/index.html: (工作演示 http://petstore.swagger.io/,按字母顺序排列)
window.swaggerUi = new SwaggerUi({
...
apisSorter : "alpha"
});
对于 2.1.0 之前的 Swagger UI 版本:
The sorter
参数仍然与旧版本的 Swagger UI 相关:
您可以使用sorter实例化 SwaggerUi 时的参数。这发生在 Swagger-Ui index.html 的 javascript 中。来自文档 https://github.com/wordnik/swagger-ui#swaggerui:
排序器对 API 列表进行排序。有可能 'alpha'(对路径进行排序
字母数字)或 'method'(按 HTTP 方法对操作进行排序)。
默认是服务器返回的顺序不变。
Example https://github.com/swagger-api/swagger-ui/blob/97ed093e6ec3a7a778ac6a41d76775c88b1fc951/src/main/html/index.html:
window.swaggerUi = new SwaggerUi({
...
sorter : "alpha"
});