Skip to content

Commit

Permalink
docs(common):improvements based on client feedback (#1355)
Browse files Browse the repository at this point in the history
* docs(common):improvements based on client feedback

* Update troubleshooting/js-errors.md
  • Loading branch information
ntacheva committed Mar 14, 2023
1 parent 80fca89 commit 63830ee
Show file tree
Hide file tree
Showing 7 changed files with 13 additions and 10 deletions.
2 changes: 2 additions & 0 deletions components/dateinput/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,8 @@ The following section lists some Date Input parameters and links to other pages
| `Enabled` | `bool` | Defines if the Date Input is enabled and accepts new values. |
| `Format` | `string`| The date format that the user input must match. Read more in the [Supported Formats]({%slug components/dateinput/supported-formats%}) article. |
| `Id` | `string` | The `id` attribute of the `input`. |
| `Max` | `DateTime` <br /> (`new DateTime(2099, 12, 31)`)| The latest allowed date that the user can type. |
| `Min` | `DateTime` <br /> (`DateTime(1900, 1, 1)`)| The earliest allowed date that the user can type. |
| `Placeholder` | `string` | The [`placeholder` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder) of the `input`. The placeholder will appear only if the component is bound to nullable `DateTime?` object, the `Value` is `null` and the component is not focused. Once the user focuses it to start typing, the `FormatPlaceholder` (default or [custom one](#format-placeholder)) will override the `Placeholder` to indicate the expected date format. |
| `TabIndex` | `int` | The `tabindex` attribute of the `input`. Use it to control the tabbing order of the inputs on the page. |
| `ValidateOn` | `ValidationEvent` enum <br/> (`Input`) | The event that will trigger validation (if validation is enabled). Read more at [Validation Modes for Simple Inputs]({%slug common-features/input-validation%}#validation-modes-for-simple-inputs) |
Expand Down
4 changes: 2 additions & 2 deletions components/datepicker/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,8 +85,8 @@ The Blazor Date Picker provides various parameters that allow you to configure t
| `Enabled` | `bool` | Specifies whether typing in the input and clicking the button is allowed. |
| `Format` | `string` | The format of the DatePicker's DateInput. [Read more about supported data formats in Telerik DateInput for Blazor UI]({%slug components/dateinput/supported-formats%}) article. |
| `Id` | `string` | The `id` attribute on the `<input />` element. Use it to attach a `<label for="">` to the input. |
| `Max` | `DateTime` | The latest date that the user can select. |
| `Min` | `DateTime` | The earliest date that the user can select. |
| `Max` | `DateTime` <br /> (`DateTime(2099, 12, 31, 23, 59, 59)`)| The latest date that the user can select. |
| `Min` | `DateTime` <br /> (`DateTime(1900, 1, 1, 0, 0, 0)`)| The earliest date that the user can select. |
| `Placeholder` | `string` | Maps to the `placeholder` attribute of the HTML element. The `Placeholder` will appear if the component is bound to a **nullable** DateTime object - `DateTime?`. It will not be rendered if the component is bound to the default value of a non-nullable DateTime object. The Placeholder value will be displayed when the input is not focused. Once the user focuses it to start typing, the Format Placeholder (default or [customized one](#format-placeholder)) will override the Placeholder to indicate the format the date should be entered in. |
| `TabIndex` | `int?` | Maps to the `tabindex` attribute of the HTML element. You can use it to customize the order in which the inputs in your form focus with the `Tab` key. |
| `Title` | `string` | The title text rendered in the header of the popup(action sheet). Applicable only when [`AdaptiveMode` is set to `Auto`]({%slug adaptive-rendering%}). |
Expand Down
4 changes: 2 additions & 2 deletions components/daterangepicker/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,8 +83,8 @@ The Blazor Date Range Picker provides various parameters that allow you to confi
| `Enabled` | `bool` | Whether typing in the inputs is allowed. |
| `EndId` and `StartId` | `string` | The `id` attribute on the `<input />` element, so you can attach a `<label for="">` to the input. |
| `Format` | `string` | The format of the DateInputs of the DateRangePicker. [Read more about supported data formats in Telerik DateInput for Blazor UI]({%slug components/dateinput/supported-formats%}) article. |
| `Max` | `DateTime` | The latest date that the user can select. |
| `Min` | `DateTime` | The earliest date that the user can select. |
| `Max` | `DateTime` <br /> (`DateTime(2099, 12, 31)`) | The latest date that the user can select. |
| `Min` | `DateTime` <br /> (`DateTime(1900, 1, 1)`)| The earliest date that the user can select. |
| `Orientation` | `CalendarOrientation`enum <br /> (`Horizontal`) | The orientation of the calendar popup. The available options are `Horizontal` and `Vertical`. |
| `Placeholder` |`string` | The `placeholder` attribute of the two `<input />` elements. The `Placeholder` will appear if the component is bound to **nullable** DateTime objects - `DateTime?`, but will not be rendered if the component is bound to the default value of a non-nullable DateTime objects. The Placeholder value will be displayed when the input is not focused. Once the user focuses it to start typing, the Format Placeholder (default or [customized one](#format-placeholder)) will override the Placeholder to indicate the format the date should be entered in. |
| `StartValue` and `EndValue` | `T` | The current values of the inputs for start and end of the range. Can be used for two-way binding. |
Expand Down
4 changes: 2 additions & 2 deletions components/datetimepicker/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,8 +82,8 @@ The Blazor Date Time Picker provides various parameters that allow you to config
| `Enabled` | `bool` | Defines if the `DateTimePicker` is enabled |
| `Format` | `string` | The date format that the user input must match. Read more in the [Supported Formats]({%slug components/dateinput/supported-formats%}) article. |
| `Id` | `string` | The `id` HTML attribute of the `input` |
| `Max` | `DateTime` | The latest date and time that the user can select |
| `Min` | `DateTime` | The earliest date and time that the user can select |
| `Max` | `DateTime` <br /> (`DateTime(2099, 12, 31, 23, 59, 59)`) | The latest date and time that the user can select |
| `Min` | `DateTime` <br /> (`DateTime(1900, 1, 1, 0, 0, 0)`) | The earliest date and time that the user can select |
| `Placeholder` | `string` | The `placeholder` attribute of the HTML element. The placeholder will appear if the component is bound to nullable DateTime object - `DateTime?`, but will not be rendered if the component is bound to the default value of a non-nullable DateTime object. The Placeholder value will be displayed when the input is not focused. Once the user focuses it to start typing, the Format Placeholder (default or [customized one](#format-placeholder)) will override the Placeholder to indicate the format the date should be entered in. |
| `TabIndex` | `int?` | The `tabindex` attribute of the HTML element. You can use it to customize the order in which the inputs in your form focus with the `Tab` key. |
| `ValidateOn` | `ValidationEvent` enum <br/> (`Input`) |`ValidateOn` - configures the event that will trigger validation (if validation is enabled). Read more at [Validation Modes for Simple Inputs]({%slug common-features/input-validation%}#validation-modes-for-simple-inputs) |
Expand Down
4 changes: 2 additions & 2 deletions components/timepicker/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,8 +85,8 @@ The Blazor Time Picker component provides various parameters that allow you to c
| `Enabled` | `bool` | Specifies whether typing in the input and opening the dropdown are allowed. |
| `Format` | `string` | Specifies the format of the DateInput of the TimePicker. Read more in the [Supported Formats]({%slug components/dateinput/supported-formats%}) article. Note that format specifiers for non-time portions will only be editable in the input and will not have a representation in the time picker dropdown. |
| `Id` | `string` | Renders as the `id` attribute on the `<input />` element, so you can attach a `<label for="">` to the input. |
| `Max` | `DateTime` | The latest time that the user can select. |
| `Min` | `DateTime` | The earliest time that the user can select. |
| `Max` | `DateTime` <br /> (`DateTime(2099, 12, 31, 23, 59, 59)`) | The latest time that the user can select. |
| `Min` | `DateTime` <br /> (`DateTime(1900, 1, 1, 0, 0, 0)`) | The earliest time that the user can select. |
| `Placeholder` | `string` | Maps to the `placeholder` attribute of the HTML element. The placeholder will appear if the component is bound to **nullable** DateTime object - `DateTime?`, but will not be rendered if the component is bound to the default value of a non-nullable DateTime object. The Placeholder value will be displayed when the input is not focused. Once the user focuses it to start typing, the Format Placeholder (default or [customized one](#format-placeholder)) will override the Placeholder to indicate the format the date should be entered in. |
| `TabIndex` | `int?` | Maps to the `tabindex` attribute of the HTML element. You can use it to customize the order in which the inputs in your form focus with the `Tab` key. |
| `ValidateOn` | `ValidationEvent` enum <br/> (`Input`) | Configures the event that will trigger validation (if validation is enabled). Read more at [Validation Modes for Simple Inputs]({%slug common-features/input-validation%}#validation-modes-for-simple-inputs). |
Expand Down
2 changes: 1 addition & 1 deletion troubleshooting/js-errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ Generally, `defer` improves the performance of your app by not making the script

### Blazor Autostart

Instead of removing the `defer` attribute above, you can [disable the automatic client-side initialization of Blazor](https://learn.microsoft.com/en-us/aspnet/core/blazor/fundamentals/startup?view=aspnetcore-7.0#initialize-blazor-when-the-document-is-ready).
If removing the `defer` attribute above does not help, you can [disablе the automatic client-side initialization of Blazor](https://learn.microsoft.com/en-us/aspnet/core/blazor/fundamentals/startup?view=aspnetcore-7.0#initialize-blazor-when-the-document-is-ready).

### TypeScript

Expand Down
3 changes: 2 additions & 1 deletion upgrade/breaking-changes/4-0-0.md
Original file line number Diff line number Diff line change
Expand Up @@ -322,7 +322,8 @@ This section describes changes per component.
- [FilterRow]({%slug grid-filter-row%}) uses `CompositeFilterDescriptor` instead of `FilterDescriptor`.
- Removed default filter descriptors in the state when the Grid `FilterMode` is set to `FilterMenu`.
- Removed the `Primary` parameter from `<GridCommandButton>`. Use the `ThemeColor` parameter instead.
- Removed `NumberFormat` and `Width` from `ExcelExportableColumn` for [CSV export]({%slug grid-export-events%}#for-csv-export).
- Removed `ExcelExportableColumn` in favor of `GridExcelExportColumn` for [Excel export]({%slug grid-export-events%}#for-excel-export) and `GridCsvExportColumn` for [CSV export]({%slug grid-export-events%}#for-csv-export).
- The successor of `ExcelExportableColumn` for CSV export(`GridCsvExportColumn`) does not have `NumberFormat` and `Width`.
- Renamed `<GridToolBar>` to `<GridToolBarTemplate>`.


Expand Down

0 comments on commit 63830ee

Please sign in to comment.