RouteJs

The following information is from the RouteJs website:

RouteJs allows you to use your ASP.NET MVC or WebForms routes from JavaScript. It does not depend on jQuery or any other JavaScript framework, so can be used in any scenario. RouteJs works with your existing MVC routes, you do not need to use a different routing syntax or modify any of your existing routes at all.

Bug reports and feature requests are welcome!

Required:

ASP.NET 4.0 or higher
Json.NET
Any version of ASP.NET MVC from 2 onwards, including ASP.NET Core

Install-Package RouteJs.Mvc4

(replace RouteJs.Mvc4 with RouteJs.Mvc3 for ASP.NET MVC 3 or RouteJs.Mvc2 for ASP.NET MVC 2)

Alternatively, you can get the latest development build from the build server.

Once installed, you need to reference the RouteJs handler in your view. This serves the JavaScript and route information:

<script src="@RouteJs.RouteJsHandler.HandlerUrl"></script>

Install-Package RouteJs.AspNet

Once installed, you need to add RouteJs to your Startup.cs file, and also ensure IActionContextAccessor is registered:

using Microsoft.AspNetCore.Mvc.Infrastructure;
using RouteJs;
...
services.AddSingleton<IActionContextAccessor, ActionContextAccessor>();
services.AddRouteJs();

The RouteJs handler also needs to be referenced in your view (generally _Layout.cshtml is a good place for this). This serves the JavaScript and route information:

@inject RouteJs.IRouteJsHelper RouteJs
@RouteJs.Render()

The main function is Router.action. This accepts three parameters:

Name of the controller
Name of the action
Any additional parameters

Examples:

// Using the default route
var url = Router.action('Controller', 'Action'); // eg. /Controller/Action

// Handling optional parameters
var url = Router.action('Foo', 'Bar', { id: 123 }); // eg. /Foo/Bar/123

// Appending querystring parameters
var url = Router.action('Foo', 'Bar', { hello: 'world' }); // eg. /Foo/Bar?hello=world

The routes that are exposed are controlled by the web.config "exposeAllRoutes" setting for ASP.NET MVC 5 and below:

<routeJs exposeAllRoutes="true" />

And via Startup.cs for ASP.NET MVC 6:

services.AddRouteJs(config => {
	config.ExposeAllRoutes = true;
});

If set to "true", all of your ASP.NET MVC routes will be exposed to JavaScript, unless you explicitly hide them via the HideRoutesInJavaScript attribute on a controller. If set to "false", all routes will be hidden unless you explicitly use the ExposeRoutesInJavaScript attribute on the controller. These two attributes currently affect all routes for the controller.

#53 - Upgrade to ASP.NET Core 1.1 RTM
Update AddRouteJs method to make configure argument optional

Updated to ASP.NET Core RC2
#49 - Use / as default base URL when empty
#51 - Ensure base path ends with /

Updated ASP.NET 5 support to RC 1.

Updated ASP.NET 5 support to beta 8.
#43 - Add LowerCaseUrls option to convert generated URLs to lowercase. Thanks to Mohammad Rahhal.
#37 - Handle empty URLs (ie. home page).

Updated ASP.NET 5 support to beta 7
#41 - Correctly handle when routes in areas have "area" default param

Added support for ASP.NET 5 and MVC 6

#38 - Fix handling of constraints with case-insensitive URL parameters.

#34 - Ignore case of controller, action, area, and keys of parameters.

#32 - Only include string (regular expression) constraints, ignore custom constraints as they can't be evaluated client-side.

#31 - Defaults and optional parameters are sometimes serialised as null

#27 - NullReferenceException for routes without DataTokens.
Added package for ASP.NET MVC 5

#22 and #24 - Handle error when loading types from referenced assemblies.

#21 - NullReferenceException thrown on ignored routes.

#18 - Only expose a route's default area if at least one controller in that route is exposed
Small JavaScript cleanup (split huge route method into several smaller methods)

#14 - Cache JavaScript for one year
#17 - Ensure area route isn't used if area is not specified in Router.action call

Added support for ASP.NET MVC 2 and 3
Bug fixes around T4MVC routes
Changed cachebusting hash from querystring parameter to URL path parameter

Fixed issue with routes in areas not working correctly

Initial release

(The MIT licence)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.