In Development
Last Updated: 08 Jun 2021 08:45 by ADMIN
William
Created on: 17 Jan 2019 02:00
Category: Grid
Type: Feature Request
17
Better Documentation

I'm currently evaluating the ASP .Net Core Components and whilst I'm liking it so far, I have to say - the documentation leaves a lot to be desired.

At the moment, I am trying to use grid and looking at documentation, I have no idea if I am meant to be looking in Kendo.Mvc.UI.Fluent or Kendo.Mvc.UI - and when I am there and find an item, there just isn't enough detail. In addition, the demos section appears to actually be more helpful and I'm constantly looking there.

What caused me to write this is that I have simply enabled GridFilterMode.Row on an instance and whilst I like it, I want to change the default from "Is Equal To" to "Contains"... I have been experimenting for the past few hours without any luck and I'm going round in circles on documentation:

I can see that Filterable requires GridFilterMode, but the documentation is lacking - https://docs.telerik.com/aspnet-core/api/Kendo.Mvc.UI/GridFilterMode#kendomvcuigridfiltermode

I then try to find the filterable modes documentation, but, half the features/methods just don't seem to have any affect whatsoever.

Personally, I'm having great luck learning about your components from the demo section and adapting the code to suite my needs - but, if there isn't a demo, it appears to be a very hard task to learn what is and isn't possible.

3 comments
Laurie
Posted on: 23 Jan 2020 16:38
I would specifically like to see better documentation on the Tag Helpers. Thanks!
ADMIN
Viktor Tachev
Posted on: 24 Jan 2019 07:03
Hi William,

Thank you for the feedback. We are working on improving the documentation for the .NET Core wrappers and also the API section in it. Indeed there is room for improvement and I apologize for any inconvenience caused by this. We will add more information and content as soon as possible. With that said, the documentation for Kendo jQuery and MVC wrappers is more complete and you can refer to it if something is missing in the .NET Core docs. 

Regarding your question - for specifying a default filter operator for the Grid you can use the filterable.options setting. You can find info for the StringOperatorBuilder below:


The actual configuration in the Grid will look similar to this:

.Filterable(f => f
        .Mode(GridFilterMode.Row)
        .Operators(o => o
            .ForString(s => s
                .Clear()
                .Contains("Contains")
                .StartsWith("Starts with")
                .Equals("Equals"))
        )
    )



Regards,
Viktor Tachev
Progress Telerik
Get quickly onboarded and successful with your Telerik and/or Kendo UI products with the Virtual Classroom free technical training, available to all active customers. Learn More.
William
Posted on: 21 Jan 2019 02:26

I would like to say that I am still struggling to find examples of certain scenarios.

 

After looking for ages, it seems you do have the documentation for other editions of the controls, it is just the ASP.Net Core controls where documentation is lacking.

For example:

 

ASP Ajax - https://docs.telerik.com/devtools/aspnet-ajax/controls/grid/how-to/Filtering/apply-default-filter-on-initial-load has a whole section (15 pages) on filtering and loads of examples.

ASP .Net Core - https://docs.telerik.com/aspnet-core/html-helpers/data-management/grid/features/filtering a single page that doesn't cover much.

I'm still evaluating and really want to use it, but, it's taking forever to demo as nearly everything is trial and error if you don't have a sample I can copy from (or good documentation to read).