Skip to content
This repository has been archived by the owner. It is now read-only.
ASP.NET Core Responsive middleware for routing base upon request client device detection to specific view
Branch: dev
Clone or download
Latest commit ce2c6f3 Mar 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode update korebuild Feb 2, 2018
asset
sample/Sandbox
src/Wangkanai.Responsive add preferred Cookie or Resolver #17 Nov 26, 2018
test/Wangkanai.Responsive.Test add preferred Cookie or Resolver #17 Nov 26, 2018
.gitattributes update git ignore Feb 5, 2018
.gitignore Initial commit Aug 1, 2016
LICENSE
NuGet.config project and namespaces renaming Aug 28, 2016
README.md
Responsive.sln
Responsive.sln.licenseheader update license Feb 15, 2018
Responsiveness.vsext
appveyor.yml
build.cmd
build.sh
korebuild-lock.txt
korebuild.json
run.cmd
run.ps1
run.sh

README.md

This repo is now marked at Acheived and merged in Wangkanai.Detection

ASP.NET Core Responsive

Build status NuGet Pre Release

ASP.NET Core Responsive

ASP.NET Core Responsive middleware for routing base upon request client device detection to specific view. Being to target difference client devices with seperation of concern is crucial, due to you can mininize what is sent to the client directly from the service to only what is needed and nothing more. This increase performance and lower bandwidth usage.

Installation

Installation of Responsive library will bring in all dependency packages.

PM> install-package Wangkanai.Responsive -pre

Configure Service

Responsive is configured in the ConfigureServices method:

public void ConfigureServices(IServiceCollection services)
{
    // Add responsive services.
    services.AddResponsive()
        .AddViewSuffix()
        .AddViewSubfolder();

    // Add framework services.
    services.AddMvc();  
}
  • AddResponsive() Adds the Responsive services to the services container.

  • AddViewSuffix() Adds support for device view files to Suffix. In this sample view Responsive is based on the view file suffix.

    Ex *views/[controller]/[action]/index.mobile.cshtml*

  • AddViewSubfolder() Adds support for device view files to Subfolder. In this sample view Responsive is based on the view file subfolder.

    Ex *views/[controller]/[action]/mobile/index.cshtml*

Configure Middleware

The current device on a request is set in the Responsive middleware. The Responsive middleware is enabled in the Configure method of Startup.cs file.

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
    app.UseResponsive();

    app.UseMvc(routes =>
    {
        routes.MapRoute(
            name: "default",
            template: "{controller=Home}/{action=Index}/{id?}");
    });
}
  • UseResponsive() Add the responsive middleware into the http pipeline. Its will capture the request and resolve the device to responsive services container.

Customized able options (beta 3)

This enable the middleware to customized the default response for any type of request device to the configured options.

app.UseResponsive(new ResponsiveOptions
{
    TabletDefault = DeviceType.Mobile
});
  • ResponsiveOptions has 3 default configurable via DesktopDefault, TabletDefault, and MobileDefault.

Directory Structure

  • src - The code of this project lives here
  • test - Unit tests of this project to valid that everything pass specs
  • sample - Contains sample web application of usage

Contributing

All contribution are welcome, please contact the author.

Related projects

See the LICENSE file.

You can’t perform that action at this time.