Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
71 commits
Select commit Hold shift + click to select a range
fcbb58d
adding docs builder config and content fixes
nikolay-nenkov Oct 24, 2024
1f05f20
chore(common): fix malformed code block tags
ntacheva Oct 29, 2024
e63d709
chore(common): fix broken links
ntacheva Oct 31, 2024
3ff25fc
chore(common): fix broken code blocks
xristianstefanov Oct 31, 2024
f4b3924
chore(common): fix broken links
ntacheva Oct 31, 2024
8109026
chore(common): fix links:
ntacheva Oct 31, 2024
5700ec7
chore(common): fix links
ntacheva Oct 31, 2024
8681084
chore(common): fix links
ntacheva Nov 1, 2024
12018b2
chore(common): fix links
ntacheva Nov 1, 2024
07a3620
chore(common): fix links
ntacheva Nov 1, 2024
0e59e8a
chore(common): fix links
ntacheva Nov 1, 2024
c3c790c
docs: changed primary-color to purple
nikolay-nenkov Nov 1, 2024
6e052a4
chore(common): fix links
ntacheva Nov 4, 2024
45c5c50
chore(common): fix links
ntacheva Nov 4, 2024
06cf907
chore(common): fix links
ntacheva Nov 4, 2024
493b294
chore(common): fix broken relative link
ntacheva Nov 4, 2024
e54d997
chore(common): fix no code block language errors
ntacheva Nov 4, 2024
d697a92
chore(common): fix no code block language errors
ntacheva Nov 4, 2024
d695b0a
chore(common): fix no language errors
ntacheva Nov 5, 2024
a13f7f9
chore(common): fix broken blocks of code
xristianstefanov Nov 5, 2024
582e9cf
chore(common): cannot find gramar fixes
xristianstefanov Nov 5, 2024
f705620
chore(common): fix broken code blocks
xristianstefanov Nov 6, 2024
a206b90
chore(common): add latest fixes from the excel file
xristianstefanov Nov 6, 2024
13ab773
chore(common): fix tables in breaking changes articles and remaining …
ntacheva Nov 6, 2024
e4c10b6
chore(common): fix latest warnings
ntacheva Nov 7, 2024
ceb6357
chore(common): fix unresolved urls
ntacheva Nov 7, 2024
0f52d21
chore(common): fix link
ntacheva Nov 7, 2024
7a096a1
adding docs builder interpolation settings
nikolay-nenkov Nov 7, 2024
88fcce1
chore(common): fix remaining links
ntacheva Nov 12, 2024
86d3739
chore(common) fix broken nested ol's
ntacheva Nov 13, 2024
2a90cb0
Add blazor-repl prop in config
VelinovAngel Nov 18, 2024
5e73fdd
adding metadata-config for docfx
nikolay-nenkov Nov 25, 2024
1a6617c
Fix some md files with wrong skip-repl
VelinovAngel Nov 26, 2024
a9c8020
fixing broken api ref link
nikolay-nenkov Nov 27, 2024
792efcb
Removed system.object inherited members and datasource expressions br…
nikolay-nenkov Nov 28, 2024
855b2d5
fixed codeblock with unescaped interpolation
nikolay-nenkov Nov 28, 2024
0ea65ab
Fix: Fix some wrong MD files
VelinovAngel Nov 29, 2024
95627bf
close code block
a-d-atanasov Nov 29, 2024
bbdfda9
Fix: Fix some wrong MD files
VelinovAngel Nov 29, 2024
2ed77c3
fixing api ref links
nikolay-nenkov Nov 29, 2024
482a0cc
fixing trial link
nikolay-nenkov Nov 29, 2024
90bdc14
added theme version to liquid vars
nikolay-nenkov Nov 29, 2024
a3bf449
fix metadata
a-d-atanasov Dec 2, 2024
c37d443
fixing nav items ordering
nikolay-nenkov Dec 2, 2024
6c5c0b0
fixed links
a-d-atanasov Dec 2, 2024
d028307
fixing a11y links
nikolay-nenkov Dec 2, 2024
3f8a40f
added pdf cover
nikolay-nenkov Dec 3, 2024
4e430c4
applied latest nav changes
nikolay-nenkov Dec 3, 2024
a9d2c9f
fixing broken markdown content
nikolay-nenkov Dec 3, 2024
933dd7f
fixing broken code block
nikolay-nenkov Dec 3, 2024
eb3e1f5
Add intro-page table
VelinovAngel Dec 3, 2024
33c49a6
changing primary color
nikolay-nenkov Dec 3, 2024
269acc0
fix tabbed code blocks + headings
a-d-atanasov Dec 4, 2024
be0439e
Fix: Some code blocks were Repl
VelinovAngel Dec 6, 2024
f670e4c
Fix: Some wrong codeblocks
VelinovAngel Dec 6, 2024
da528ed
Fix: Some wrong codeblocks
VelinovAngel Dec 6, 2024
013d497
Fix: Some wrong codeblocks
VelinovAngel Dec 6, 2024
5175519
Fix: Some wrong codeblocks
VelinovAngel Dec 6, 2024
48bf13c
Fix: worng codeblock language
VelinovAngel Dec 6, 2024
16be778
Fix some REPL to codeblocks
VelinovAngel Dec 9, 2024
89a9b33
Fix come codeblocks to REPL
VelinovAngel Dec 9, 2024
ce6f717
Fix: wrong tabbed code block
VelinovAngel Dec 9, 2024
755a270
Fix ninja-avatar icon
VelinovAngel Dec 9, 2024
7d53d7a
chore(common): skip repl in snippets
ntacheva Dec 10, 2024
e17551d
chore(Gantt): fix snippets and skip repl
ntacheva Dec 10, 2024
f3ffe32
chore(Grid,Gauge): fix snippets and skip repl
ntacheva Dec 10, 2024
0ac3110
chore(common): fix snippets
ntacheva Dec 10, 2024
dc8628c
chore(treelist): fix snippets
ntacheva Dec 10, 2024
e2c29f1
chore(docs): fixing broken links
nikolay-nenkov Dec 11, 2024
dd418bc
Replace CSHTML with RAZOR
dimodi Dec 13, 2024
b1dbe55
Fix code snippets
dimodi Dec 13, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
5 changes: 3 additions & 2 deletions _assetsApi/filterConfig.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,13 @@ apiRules:
- exclude:
uidRegex: ^Telerik\.DataSource\.IDescriptor$
- exclude:
uidRegex: ^Telerik\.DataSource\.Expressions\.*$
uidRegex: ^Telerik\.DataSource\.Expressions\..*$
- exclude:
uidRegex: ^Telerik\.DataSource\.\w*Node
- exclude:
uidRegex: ^Telerik\.DataSource\.\w*Expression\w*$
- exclude:
uidRegex: ^Telerik\.DataSource\.\w+Aggregate\w*$
- exclude:
uidRegex: ^Telerik.Blazor.Components.ToolBarw*$
type: Method
uidRegex: ^System\.Object\..*$
13 changes: 13 additions & 0 deletions _assetsApi/metadata-config.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
{
"metadata": [{
"src": [
{
"files": [
"src/**.dll"
]
}
],
"dest": "metadata",
"filter": "filterConfig.yml"
}]
}
2 changes: 1 addition & 1 deletion _contentTemplates/chart/link-to-basics.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ This article assumes you are familiar with the [chart basics]({%slug components/

Bar and Column charts can take the color of the series item from the `ColorField` of the data source. You can pass a valid CSS color (for example, `#abcdef`, `#f00`, or `blue`).

````CSHTML
````RAZOR
Colors per series item

<TelerikChart>
Expand Down
2 changes: 1 addition & 1 deletion _contentTemplates/common/format-placeholders.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ By default the value for all parameters would be `null`, the full format specifi

>caption Provide a custom string to the day, month, and year segments

````CSHTML
````RAZOR
@* Provide custom rendering of the day, month, and year segments *@

<TelerikDatePicker @bind-Value="@DateValue">
Expand Down
2 changes: 1 addition & 1 deletion _contentTemplates/common/get-model-from-dropdowns.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#get-model-from-dropdowns
>tip If you are looking for more fields from the view-model that describes the dropdown items, not just the `Value`, see the [Get model from dropdown]({%slug dropdowns-get-model%}) KB article and the [OnChange](events#onchange) event.
>tip If you are looking for more fields from the view-model that describes the dropdown items, not just the `Value`, see the [Get model from dropdown]({%slug dropdowns-get-model%}) KB article and the [OnChange](../events#onchange) event.
>
> You may also want to review/join the discussion and Vote for this request: <a href="https://www.telerik.com/forums/binding-dropdownlist-value-to-complex-model" target="_blank">Binding DropDownList Value to complex model</a>
#end
54 changes: 27 additions & 27 deletions _contentTemplates/common/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ In this tutorial, you will use the [Telerik NuGet feed]({%slug installation/nuge

1. Add the `https://nuget.telerik.com/v3/index.json` URL as a **Source**. Click **OK**.

![Add the Telerik NuGet Feed in Visual Studio](images/telerik-nuget-feed.png)
![Add the Telerik NuGet Feed in Visual Studio](images/telerik-nuget-feed.png)

1. Whenever Visual Studio displays a dialog to enter credentials for `nuget.telerik.com`, use your Telerik account email and password.

Expand All @@ -46,36 +46,36 @@ In this tutorial, you will use the [Telerik NuGet feed]({%slug installation/nuge

#add-component-sample

**RAZOR**

<TelerikButton>Say Hello</TelerikButton>

1. Optionally, hook up a click handler that will show a message. The resulting view will look like this:

**RAZOR**

@page "/"

<TelerikButton ThemeColor="@ThemeConstants.Button.ThemeColor.Primary"
OnClick="@SayHelloHandler">Say Hello</TelerikButton>

<p>@HelloString</p>
````RAZOR.skip-repl
<TelerikButton>Say Hello</TelerikButton>
````

@code {
private MarkupString HelloString { get; set; }

private void SayHelloHandler()
{
string msg = $"Hello from <strong>Telerik UI for Blazor</strong> at {DateTime.Now.ToString("HH:mm:ss")}!" +
"<br /> Now you can use C# to write front-end!";
1. Optionally, hook up a click handler that will show a message. The resulting view will look like this:

HelloString = new MarkupString(msg);
}
}
````RAZOR.skip-repl
@page "/"

<TelerikButton ThemeColor="@ThemeConstants.Button.ThemeColor.Primary"
OnClick="@SayHelloHandler">Say Hello</TelerikButton>

<p>@HelloString</p>

@code {
private MarkupString HelloString { get; set; }

private void SayHelloHandler()
{
string msg = $"Hello from <strong>Telerik UI for Blazor</strong> at {DateTime.Now.ToString("HH:mm:ss")}!" +
"<br /> Now you can use C# to write front-end!";

HelloString = new MarkupString(msg);
}
}
````

1. Run the app in the browser. You should see something like this:

![Telerik Blazor app in the browser](images/blazor-app-in-browser.png)
![Telerik Blazor app in the browser](images/blazor-app-in-browser.png)

Well done! Now you have your first Telerik UI for Blazor component running in your Blazor app.

Expand Down Expand Up @@ -138,7 +138,7 @@ Add a `<TelerikRootComponent>` to the app layout file (by default, `MainLayout.r

<div class="skip-repl"></div>

````CSHTML
````RAZOR
@inherits LayoutComponentBase

<TelerikRootComponent>
Expand Down
6 changes: 3 additions & 3 deletions _contentTemplates/common/inputs.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,13 @@ Consider setting `DebounceDelay="0"` to the component inside the editor template

The component allows you to add custom elements as prefixes and suffixes. [Read more about how to render custom adornments before and after the input element...]({%slug common-features/input-adornments%})
#end

#floating-label-and-preffix
When using the [`PrefixTemplate`]({%slug common-features/input-adornments%}#adding-prefix-in-ui-for-blazor-components) for a component wrapped in a [FloatingLabel]({%slug floatinglabel-overview%}), the label will overlap the prefix.
When using the [`PrefixTemplate`]({%slug common-features/input-adornments%}#adding-a-prefix-adornment) for a component wrapped in a [FloatingLabel]({%slug floatinglabel-overview%}), the label will overlap the prefix.

To ensure both the FloatingLabel and the prefix content are properly displayed, move the label with CSS:

````CSHTML
````RAZOR
<style>
.custom-label-class .k-floating-label {
margin-left: 30px;
Expand Down
8 changes: 4 additions & 4 deletions _contentTemplates/common/js-interop-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
#end

#js-interop-file-snippet
````
````HTML
<head>
. . .
<script src="_content/Telerik.UI.for.Blazor/js/telerik-blazor.js"></script>
Expand All @@ -33,7 +33,7 @@
#end

#theme-static-asset-snippet
````
````HTML
<head>
. . .
<link rel="stylesheet" href="_content/Telerik.UI.for.Blazor/css/kendo-theme-default/all.css" />
Expand All @@ -47,7 +47,7 @@

#register-telerik-service-server
<div class="skip-repl"></div>
````
````C#
// ...

var builder = WebApplication.CreateBuilder(args);
Expand All @@ -64,7 +64,7 @@ var app = builder.Build();

#register-telerik-service-client
<div class="skip-repl"></div>
````.NET_6_and_.NET_7
````C#
using ClientBlazorProject;
using Microsoft.AspNetCore.Components.Web;
using Microsoft.AspNetCore.Components.WebAssembly.Hosting;
Expand Down
5 changes: 3 additions & 2 deletions _contentTemplates/grid/common-link.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@


#conditional-style-row-and-cell-render
````CSHTML
````RAZOR
@* Conditional styling/formatting for a cell and row *@

<style>
Expand Down Expand Up @@ -171,7 +171,8 @@ A multi-header column does not show up in the list of columns in the column choo

The state of a multi-header column is handled in the same way as a standard column. The columns in the state are listed in a flat list in the order of definition. For example, for the following setup:

````CSHTML
<div class="skip-repl"></div>
````RAZOR
<TelerikGrid>
<GridColumns>
<GridColumn Title="column 1">
Expand Down
112 changes: 56 additions & 56 deletions _contentTemplates/grid/export.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,70 +9,70 @@

* With Server-side Blazor, the file may become larger than the default SignalR connection limit, and this can disconnect the client and result in an error. Generally, this requires quite a lot of data to happen, but you may need to increase the size limit of the connection in the `ConfigureServices` method of your `Startup.cs` file, for example:

**C#**
services.AddServerSideBlazor().AddHubOptions(o =>
{
o.MaximumReceiveMessageSize = 1024 * 1024; // 1MB
});
````C#.skip-repl
services.AddServerSideBlazor().AddHubOptions(o =>
{
o.MaximumReceiveMessageSize = 1024 * 1024; // 1MB
});
````

* With Client-side Blazor (WebAssembly), all the code runs in the browser and, at the time of writing, is considerably slower than server-side Blazor, and it only has one actual thread. This means that while the file is being generated, the UI will be unresponsive, so you may want to show a loading sign to the user through the `OnClick` handler of the command button, something like:

**Component**

@* Exporting a lot of rows can be slow in a WebAssembly app more so than in a server-side app, and it blocks the UI *@
````RAZOR.skip-repl Component
@* Exporting a lot of rows can be slow in a WebAssembly app more so than in a server-side app, and it blocks the UI *@

<TelerikGrid Data="@GridData" AutoGenerateColumns="true" Pageable="true">
<GridToolBarTemplate>
<GridCommandButton OnClick="@ShowLoadingSign" Command="ExcelExport" Icon="@SvgIcon.FileExcel">Export to Excel</GridCommandButton>
<GridCommandButton OnClick="@ShowLoadingSign" Command="CsvExport" Icon="@SvgIcon.FileCsv">Export to CSV</GridCommandButton>
</GridToolBarTemplate>
<GridExport>
<GridExcelExport AllPages="true" FileName="telerik-grid-export" />
<GridCsvExport AllPages="true" FileName="telerik-grid-export" />
</GridExport>
</TelerikGrid>
<TelerikGrid Data="@GridData" AutoGenerateColumns="true" Pageable="true">
<GridToolBarTemplate>
<GridCommandButton OnClick="@ShowLoadingSign" Command="ExcelExport" Icon="@SvgIcon.FileExcel">Export to Excel</GridCommandButton>
<GridCommandButton OnClick="@ShowLoadingSign" Command="CsvExport" Icon="@SvgIcon.FileCsv">Export to CSV</GridCommandButton>
</GridToolBarTemplate>
<GridExport>
<GridExcelExport AllPages="true" FileName="telerik-grid-export" />
<GridCsvExport AllPages="true" FileName="telerik-grid-export" />
</GridExport>
</TelerikGrid>

<TelerikWindow Visible="@isExporting" Modal="true">
<WindowTitle>Please wait...</WindowTitle>
<WindowContent>We are exporting your data, your file will download shortly.</WindowContent>
</TelerikWindow>
<TelerikWindow Visible="@isExporting" Modal="true">
<WindowTitle>Please wait...</WindowTitle>
<WindowContent>We are exporting your data, your file will download shortly.</WindowContent>
</TelerikWindow>

@code {
bool isExporting { get; set; }
@code {
bool isExporting { get; set; }

async Task ShowLoadingSign()
{
isExporting = true;
StateHasChanged();
// This won't work for server-side Blazor, the UI will render immediately after the delay and the loading sign will only flicker
await Task.Delay(50);
isExporting = false;
}
async Task ShowLoadingSign()
{
isExporting = true;
StateHasChanged();
// This won't work for server-side Blazor, the UI will render immediately after the delay and the loading sign will only flicker
await Task.Delay(50);
isExporting = false;
}

List<SampleData> GridData { get; set; }
List<SampleData> GridData { get; set; }

protected override void OnInitialized()
{
GridData = Enumerable.Range(1, 1000).Select(x => new SampleData
{
ProductId = x,
ProductName = $"Product {x}",
UnitsInStock = x * 2,
Price = 3.14159m * x,
Discontinued = x % 4 == 0,
FirstReleaseDate = DateTime.Now.AddDays(-x)
}).ToList();
}
protected override void OnInitialized()
{
GridData = Enumerable.Range(1, 1000).Select(x => new SampleData
{
ProductId = x,
ProductName = $"Product {x}",
UnitsInStock = x * 2,
Price = 3.14159m * x,
Discontinued = x % 4 == 0,
FirstReleaseDate = DateTime.Now.AddDays(-x)
}).ToList();
}

public class SampleData
{
public int ProductId { get; set; }
public string ProductName { get; set; }
public int UnitsInStock { get; set; }
public decimal Price { get; set; }
public bool Discontinued { get; set; }
public DateTime FirstReleaseDate { get; set; }
}
}
public class SampleData
{
public int ProductId { get; set; }
public string ProductName { get; set; }
public int UnitsInStock { get; set; }
public decimal Price { get; set; }
public bool Discontinued { get; set; }
public DateTime FirstReleaseDate { get; set; }
}
}
````
#end
4 changes: 2 additions & 2 deletions _contentTemplates/rootcomponent/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,14 @@

<div class="skip-repl"></div>

````TelerikLayout.razor
````RAZOR TelerikLayout.razor
@inherits LayoutComponentBase

<TelerikRootComponent>
@Body
</TelerikRootComponent>
````
````MainLayout.razor
````RAZOR MainLayout.razor
@inherits LayoutComponentBase
@layout TelerikLayout

Expand Down
Loading
Loading