provide option sorter=[alpha|method]

This commit is contained in:
Chris Hatch
2014-07-27 21:18:18 +08:00
parent 6dc12f733e
commit 5d2bed7025
3 changed files with 15 additions and 9 deletions

View File

@@ -59,6 +59,7 @@ To use swagger-ui you should take a look at the [source of swagger-ui html page]
* *dom_id parameter* is the the id of a dom element inside which SwaggerUi will put the user interface for swagger
* *booleanValues* SwaggerUI renders boolean data types as a dropdown. By default it provides a 'true' and 'false' string as the possible choices. You can use this parameter to change the values in dropdown to be something else, for example 0 and 1 by setting booleanValues to new Array(0, 1)
* *docExpansion* controls how the API listing is displayed. It can be set to 'none' (default), 'list' (shows operations for each resource), or 'full' (fully expanded: shows operations and their details)
* *sorter* apply a sort to the API list. It can be 'alpha' (sort paths alphanumerically) or 'method' (sort operations by HTTP method). Default is the order returned by the server unchanged.
* *onComplete* is a callback function parameter which can be passed to be notified of when SwaggerUI has completed rendering successfully.
* *onFailure* is a callback function parameter which can be passed to be notified of when SwaggerUI encountered a failure was unable to render.
* All other parameters are explained in greater detail below

View File

@@ -1,12 +1,17 @@
class MainView extends Backbone.View
sorters = {
'alpha' : (a,b) -> return a.path.localeCompare(b.path),
'method' : (a,b) -> return a.method.localeCompare(b.method),
}
initialize: (opts={}) ->
if opts.swaggerOptions.sortAlphabetically == true
pathSorter = (a,b) -> return a.path.localeCompare(b.path)
# sort apis
@model.apisArray.sort pathSorter
# sort operations
if opts.swaggerOptions.sorter
sorterName = opts.swaggerOptions.sorter
sorter = sorters[sorterName]
for route in @model.apisArray
route.operationsArray.sort pathSorter
route.operationsArray.sort sorter
if (sorterName == "alpha") # sort top level paths if alpha
@model.apisArray.sort sorter
render: ->
# Render the outer container for resources

View File

@@ -48,7 +48,7 @@
log("Unable to Load SwaggerUI");
},
docExpansion: "none",
sortAlphabetically: true
sorter : "alpha"
});
$('#input_apiKey').change(function() {