diff --git a/README.md b/README.md index 6998d566..a8c1fec8 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/src/main/coffeescript/view/MainView.coffee b/src/main/coffeescript/view/MainView.coffee index e7ea1fd2..4f41a7d1 100644 --- a/src/main/coffeescript/view/MainView.coffee +++ b/src/main/coffeescript/view/MainView.coffee @@ -1,13 +1,18 @@ class MainView extends Backbone.View - initialize: (opts={}) -> - if opts.swaggerOptions.sortAlphabetically == true - pathSorter = (a,b) -> return a.path.localeCompare(b.path) - # sort apis - @model.apisArray.sort pathSorter - # sort operations - for route in @model.apisArray - route.operationsArray.sort pathSorter + sorters = { + 'alpha' : (a,b) -> return a.path.localeCompare(b.path), + 'method' : (a,b) -> return a.method.localeCompare(b.method), + } + initialize: (opts={}) -> + if opts.swaggerOptions.sorter + sorterName = opts.swaggerOptions.sorter + sorter = sorters[sorterName] + for route in @model.apisArray + route.operationsArray.sort sorter + if (sorterName == "alpha") # sort top level paths if alpha + @model.apisArray.sort sorter + render: -> # Render the outer container for resources $(@el).html(Handlebars.templates.main(@model)) diff --git a/src/main/html/index.html b/src/main/html/index.html index 0de90936..caf4ef0e 100644 --- a/src/main/html/index.html +++ b/src/main/html/index.html @@ -48,7 +48,7 @@ log("Unable to Load SwaggerUI"); }, docExpansion: "none", - sortAlphabetically: true + sorter : "alpha" }); $('#input_apiKey').change(function() {