Better Documentation

Progress® Telerik® UI for ASP.NET Core Feedback Portal

Create an account Log In

Back to Feed

Request a Feature Report a Bug

In Development

Last Updated: 13 Apr 2023 07:30 by ADMIN

William

Created on: 17 Jan 2019 02:00

Category: Grid

Type: Feature Request

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.

5 comments

ADMIN

Aleksandar

Posted on: 13 Apr 2023 07:30

Hello All,

TagHelpers API is already available under the API Reference section of the documentation:

Regards,
Aleksandar
Progress Telerik

Love the Telerik and Kendo UI products and believe more people should try them? Invite a fellow developer to become a Progress customer and each of you can get a $50 Amazon gift voucher.

Travis

Posted on: 06 Apr 2023 20:04

Highly agree with the request for better documentation for TagHelpers. With the HTML helpers intellisense at least is able to some degree give us available options when there isn't specific documentation. However with the TagHelpers there is not very good intellisense and it is hard to tell what options are available or what format it should be in.

Especially since not everything that is exposed in the HTML Helper is exposed for the TagHelpers.

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:

https://docs.telerik.com/aspnet-core/api/Kendo.Mvc.UI.Fluent/StringOperatorsBuilder#methods-Clear

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).