Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
42 commits
Select commit Hold shift + click to select a range
12a188c
Adding changes from build igniteui-xplat-docs-make-pr-JP+KR_2024.10.23.2
Oct 23, 2024
4925107
feat(*): update topics with new fr related to input formats
ddaribo Oct 29, 2024
57016dc
Merge pull request #5984 from IgniteUI/bpachilova/feat-5982-editorOpt…
kacheshmarova Oct 31, 2024
6250f9d
docs(*): update JA for #5984
randriova Nov 1, 2024
b5748d3
doc(ng-sa): Adding info about default standalone components. (#6001)
valadzhov Nov 25, 2024
5727cb1
Merge branch 'vnext' into localization-2024-11-01
randriova Nov 25, 2024
156b006
docs(*): Updating JA for #6001
randriova Nov 25, 2024
b2c128b
docs(summaries): enhance summaries topics with disabledSummaries exam…
georgianastasov Nov 25, 2024
8f61497
Merge branch 'vnext' into ganastasov/enhance-summaries-topic
georgianastasov Nov 25, 2024
29794e6
Merge pull request #6003 from IgniteUI/ganastasov/enhance-summaries-t…
kacheshmarova Nov 25, 2024
2becec1
Update angular SSR topic
mddragnev Nov 25, 2024
0a1999e
Merge pull request #5987 from IgniteUI/localization-2024-11-01
ChronosSF Nov 25, 2024
7f9e28b
Merge pull request #5977 from IgniteUI/ESShared/XPlaform_jp_igniteui-…
ChronosSF Nov 26, 2024
525cb2e
Add info about icon service
mddragnev Nov 26, 2024
227c413
Adding changes from build igniteui-xplat-docs-make-pr_2024.12.4.2
Dec 4, 2024
4202862
Adding changes from build igniteui-xplat-docs-make-pr-JP+KR_2024.12.4.2
Dec 4, 2024
17c2281
Re-add data pie chart to TOC
agoldenbaum Dec 4, 2024
54c5710
Merge pull request #6014 from IgniteUI/arg-data-pie-chart
HUSSAR-mtrela Dec 4, 2024
8e68aba
Merge branch 'vnext' into ESShared/XPlaform_en_igniteui-xplat-docs-ma…
HUSSAR-mtrela Dec 4, 2024
9435c9c
Merge pull request #6012 from IgniteUI/ESShared/XPlaform_en_igniteui-…
HUSSAR-mtrela Dec 4, 2024
cf7c0a3
Merge branch 'vnext' into ESShared/XPlaform_jp_igniteui-xplat-docs-ma…
HUSSAR-mtrela Dec 4, 2024
5e7fed0
Merge pull request #6013 from IgniteUI/ESShared/XPlaform_jp_igniteui-…
HUSSAR-mtrela Dec 4, 2024
dfc60ec
Adding changes from build igniteui-xplat-docs-make-pr_2024.12.11.1
Dec 11, 2024
fa46eb9
Merge pull request #6015 from IgniteUI/ESShared/XPlaform_en_igniteui-…
HUSSAR-mtrela Dec 16, 2024
5ac3880
Adding changes from build igniteui-xplat-docs-make-pr_2024.12.18.2
Dec 18, 2024
1460ab5
Adding changes from build igniteui-xplat-docs-make-pr-JP+KR_2024.12.18.2
Dec 18, 2024
b5f7def
Merge pull request #6017 from IgniteUI/ESShared/XPlaform_en_igniteui-…
HUSSAR-mtrela Dec 18, 2024
bab84c4
Merge branch 'vnext' into ESShared/XPlaform_jp_igniteui-xplat-docs-ma…
HUSSAR-mtrela Dec 18, 2024
6a536bd
Update TOC for dashboard tile and color editor
agoldenbaum Dec 18, 2024
076eccd
Merge pull request #6019 from IgniteUI/arg-toc-color-editor-and-dashb…
HUSSAR-mtrela Dec 18, 2024
e6309fb
Merge branch 'vnext' into ESShared/XPlaform_jp_igniteui-xplat-docs-ma…
HUSSAR-mtrela Dec 18, 2024
213c86b
Merge pull request #6018 from IgniteUI/ESShared/XPlaform_jp_igniteui-…
HUSSAR-mtrela Dec 18, 2024
f6bfc8d
Color editor preview
agoldenbaum Dec 18, 2024
66755fd
Merge branch 'vnext' into arg-toc-color-editor-and-dashboard
agoldenbaum Dec 18, 2024
42d5218
Merge pull request #6020 from IgniteUI/arg-toc-color-editor-and-dashb…
HUSSAR-mtrela Dec 19, 2024
633c78a
Adding changes from build igniteui-xplat-docs-make-pr_2024.12.19.1
Dec 19, 2024
8f3fa8b
Merge pull request #6021 from IgniteUI/ESShared/XPlaform_en_igniteui-…
HUSSAR-mtrela Dec 19, 2024
a255cb3
Adding changes from build igniteui-xplat-docs-make-pr_2024.12.19.2
Dec 19, 2024
490f84e
Merge pull request #6022 from IgniteUI/ESShared/XPlaform_en_igniteui-…
HUSSAR-mtrela Dec 19, 2024
0888425
Adding changes from build igniteui-xplat-docs-make-pr-JP+KR_2025.1.6.1
Jan 6, 2025
555366c
Merge pull request #6027 from IgniteUI/ESShared/XPlaform_jp_igniteui-…
HUSSAR-mtrela Jan 7, 2025
82d1d22
Merge pull request #6004 from IgniteUI/mdragnev/update-ssr-topic
dkamburov Jan 13, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion en/components/charts/features/chart-navigation.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Like this sample? Get access to our complete Angular toolkit and start building

## Chart Navigation with User Interactions

Zooming is on by default on the chart. In order to disable navigation in the UI, you need to set either the [`isHorizontalZoomEnabled`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatachartcomponent.html#isHorizontalZoomEnabled) and/or the [`isVerticalZoomEnabled`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatachartcomponent.html#isVerticalZoomEnabled) properties of the chart to false, depending on the direction that you wish to disable zooming.
Whether or not zooming is on by default depends on the chart you are using. If you are using [`IgxCategoryChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxcategorychartcomponent.html), it is on by default, but it is not in the [`IgxDataChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatachartcomponent.html). In order to enable or disable navigation in the UI, you need to set either the [`isHorizontalZoomEnabled`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatachartcomponent.html#isHorizontalZoomEnabled) and/or the [`isVerticalZoomEnabled`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatachartcomponent.html#isVerticalZoomEnabled) properties of the chart, depending on the direction that you wish to enable or disable zooming.

It is also possible to zoom or pan simply by clicking the mouse or using touch. The [`defaultInteraction`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxseriesviewercomponent.html#defaultInteraction) property of the data chart determines what happens on mouse click or touch events. This property defaults to `DragZoom` and when set to this with zooming enabled, clicking and dragging will place a preview rectangle over the plot area that will become the zoomed area of the chart. This [`defaultInteraction`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxseriesviewercomponent.html#defaultInteraction) property can also be set to either `DragPan` to allow panning or `None` to prevent these operations.

Expand Down
132 changes: 132 additions & 0 deletions en/components/dashboard-tile.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
---
title: Angular Dashboard Tile Component | Ignite UI for Angular
_description: See how you can easily get started with Angular Dashboard Tile Component.
_keywords: Ignite UI for Angular, UI controls, Angular widgets, web widgets, UI widgets, Angular, Native Angular Components Suite, Native Angular Controls, Native Angular Components Library, Angular Dashboard components, Angular Dashboard Tile controls
mentionedTypes: ["Toolbar", "CategoryChart", "XamDataChart", "XamRadialGauge", "XamLinearGauge", "XamGeographicMap"]
---

# Angular Dashboard Tile Overview

The Angular Dashboard Tile is a automatic data visualization component which determines via analysis of a DataSource collection/array or single data point what would be the most appropriate visualization to display. It then also provides a further suite of tools in its embedded [`IgxToolbarComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_layouts.igxtoolbarcomponent.html) that let you alter the visualization that is presented in a variety of ways.

A wide variety of visualizations may be selected for display depending on the shape of the provided data including, but not limited to: Category Charts, Radial and Polar Charts, Scatter Charts, Geographic Maps, Radial and Linear Gauges, Financial Charts and Stacked Charts.

Interacting with the chart type menu in the toolbar will allow for selecting a different visualization among the list of likely candidates.

## Angular Dashboard Tile Example

<!-- TODO -->

<code-view style="height: 600px" alt="Angular Dashboard Tile Example"
data-demos-base-url="{environment:dvDemosBaseUrl}"
iframe-src="{environment:dvDemosBaseUrl}/charts/dashboard-tile/chart-dashboard"
github-src="charts/dashboard-tile/chart-dashboard">
</code-view>


## Dependencies

<!-- Angular, WebComponents, React -->

Install the following packages in the Ignite UI for Angular toolset:

```cmd
npm install igniteui-angular-charts
npm install igniteui-angular-core
npm install igniteui-angular-dashboards
npm install igniteui-angular-gauges
npm install igniteui-angular-grids
npm install igniteui-angular-inputs
npm install igniteui-angular-layouts
npm install igniteui-angular-maps
```

The following modules are suggested when using the Dashboard Tile component:

```ts
import { IgxDashboardTileModule, IgxDataChartDashboardTileModule, IgxRadialGaugeDashboardTileModule,
IgxLinearGaugeDashboardTileModule, IgxGeographicMapDashboardTileModule,
IgxPieChartDashboardTileModule } from "igniteui-angular-dashboards";

@NgModule({
imports: [
IgxDataChartDashboardTileModule,
IgxRadialGaugeDashboardTileModule,
IgxLinearGaugeDashboardTileModule,
IgxGeographicMapDashboardTileModule,
IgxPieChartDashboardTileModule,
IgxDashboardTileModule
]
})
export class AppModule {}
```

<!-- end:Angular, WebComponents, React -->

## Usage

Depending on what you bind the Dashboard Tile's `DataSource` property to will determine which visualization you see by default, as the control will evaluate the data you bind and then choose a visualization from the Ignite UI for Angular toolset to show. The data visualization controls that are included to be shown in the Dashboard Tile are the following:

* [IgxCategoryChart](charts/chart-overview.md)
* [IgxDataChart](charts/chart-overview.md)
* [IgxDataPieChart](charts/types/data-pie-chart.md)
* [IgxGeographicMap](geo-map.md)
* [IgxLinear Gauge](linear-gauge.md)
* [IgxRadialGauge](radial-gauge.md)

The data visualization that is chosen by default is mainly dependent on the schema and the count of the `DataSource` that you have bound. For example, if you bind a single numeric value, you will get a [`IgxRadialGaugeComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_gauges.igxradialgaugecomponent.html), but if you bind a collection of value-label pairs that are easy to distinguish from each other, you will likely get a `XamDataPieChart`. If you bind an `DataSource` that has more value paths, you will receive a [`IgxDataChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatachartcomponent.html) with multiple column series or line series, depending mainly on the count of the collection bound. You can also bind to a `ShapeDataSource` or data the appears to contain geographic points to receive a [`IgxGeographicMapComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_maps.igxgeographicmapcomponent.html).

You are not locked into a single visualization when you bind the `DataSource`, and you can tell the control that you want to see a particular visualization by setting its `VisualizationType` property. For example, if you specifically wanted to see a line chart, you could define the Dashboard Tile like so:

<!-- TODO SAMPLE -->

<code-view style="height: 600px" alt="Angular Dashboard Tile Gauge Example"
data-demos-base-url="{environment:dvDemosBaseUrl}"
iframe-src="{environment:dvDemosBaseUrl}/charts/dashboard-tile/gauge-dashboard"
github-src="charts/dashboard-tile/gauge-dashboard">
</code-view>


The visualization or properties of the visualization are also configurable using the [`IgxToolbarComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_layouts.igxtoolbarcomponent.html) at the top of the control. This [`IgxToolbarComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_layouts.igxtoolbarcomponent.html) has the default tools for the current visualization with the addition of four Dashboard Tile specific ones, highlighted below:

<img src="../images/dashboard-tile-toolbar.png" />

From left to right:

* The first tool will show a data grid with the `DataSource` provided to the control. This is a toggle tool, so if you click it again after showing the grid, it will revert to the visualization.
* The second tool allows you to configure the settings of the current data visualization.
* The third tool allows you to change the current visualization, allowing you to plot a different series type or show a different type of visualization altogether. This can be set on the control by setting the `VisualizationType` property, mentioned above.
* The last tool allows you to configure which properties on your underlying data item are included for the control. You can configure this by setting the [`includedProperties`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdomainchartcomponent.html#includedProperties) or [`excludedProperties`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdomainchartcomponent.html#excludedProperties) collection on the control.

This demo demonstrates dashboard tile integration with the Angular Pie Chart. The toolbar options at the top right provides access to styling and changing the data visualization.

<code-view style="height: 600px" alt="Angular Dashboard Tile Pie Example"
data-demos-base-url="{environment:dvDemosBaseUrl}"
iframe-src="{environment:dvDemosBaseUrl}/charts/dashboard-tile/pie-dashboard"
github-src="charts/dashboard-tile/pie-dashboard">
</code-view>


This demo demonstrates dashboard tile integration with the Angular Geographic Map. The toolbar options at the top right provides access to styling and changing the data visualization.

<code-view style="height: 600px" alt="Angular Dashboard Tile Map Example"
data-demos-base-url="{environment:dvDemosBaseUrl}"
iframe-src="{environment:dvDemosBaseUrl}/charts/dashboard-tile/map-dashboard"
github-src="charts/dashboard-tile/map-dashboard">
</code-view>


## API References

* [`IgxToolbarComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_layouts.igxtoolbarcomponent.html)
* [`IgxCategoryChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxcategorychartcomponent.html)
* [`IgxDataChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatachartcomponent.html)
* [`IgxDataPieChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatapiechartcomponent.html)
* [`IgxGeographicMapComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_maps.igxgeographicmapcomponent.html)
* [`IgxLinearGaugeComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_gauges.igxlineargaugecomponent.html)
* [`IgxRadialGaugeComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_gauges.igxradialgaugecomponent.html)

## Additional Resources

* [Ignite UI for Angular **Forums**](https://www.infragistics.com/community/forums/f/ignite-ui-for-angular)
* [Ignite UI for Angular **GitHub**](https://github.com/IgniteUI/igniteui-angular)
1 change: 1 addition & 0 deletions en/components/date-picker.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,6 +213,7 @@ The [`IgxDatePickerComponent`]({environment:angularApiUrl}/classes/igxdatepicker
A good thing to note is that the the Angular DatePicker Component in Ignite UI will always add a leading zero on the `date` and `month` portions if they were provided in a format that does not have it, e.g. `d/M/yy` becomes `dd/MM/yy`. This applies only during editing.

[`displayFormat`]({environment:angularApiUrl}/classes/igxdatepickercomponent.html#displayFormat) on the other hand uses Angular's [`DatePipe`](https://angular.io/api/common/DatePipe) and is used to format the picker's input when it is not focused. If no [`displayFormat`]({environment:angularApiUrl}/classes/igxdatepickercomponent.html#displayFormat) is provided, the picker will use the [`inputFormat`]({environment:angularApiUrl}/classes/igxdatepickercomponent.html#inputFormat) as its [`displayFormat`]({environment:angularApiUrl}/classes/igxdatepickercomponent.html#displayFormat).
Alternatively, if the [`inputFormat`]({environment:angularApiUrl}/classes/igxdatepickercomponent.html#inputFormat) property is not set, the input format will be inferred from the [`displayFormat`]({environment:angularApiUrl}/classes/igxdatepickercomponent.html#displayFormat) in case it can be parsed as containing numeric date-time parts only.

More information about these can be found in the [`IgxDateTimeEditor`](date-time-editor.md#examples) examples section.

Expand Down
2 changes: 2 additions & 0 deletions en/components/date-range-picker.md
Original file line number Diff line number Diff line change
Expand Up @@ -245,6 +245,8 @@ The `inputFormat` property accepts a constructed format string using characters
</igx-date-range-picker>
```

If the [`inputFormat`]({environment:angularApiUrl}/classes/igxdaterangepickercomponent.html#inputFormat) property is not set, the input format will be inferred from the [`displayFormat`]({environment:angularApiUrl}/classes/igxdaterangepickercomponent.html#displayFormat) in case it can be parsed as containing numeric date-time parts only.

>[!NOTE]
> The `IgxDateRangePicker` now supports IME input. When composition ends, the control converts the wide-character numbers to ASCII characters.

Expand Down
1 change: 1 addition & 0 deletions en/components/date-time-editor.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,6 +126,7 @@ Date Time Editor Directive has intuitive keyboard navigation that makes it easy
The [`IgxDateTimeEditor`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html) supports different display and input formats.

It uses Angular's [`DatePipe`](https://angular.io/api/common/DatePipe), which allows it to support predefined format options, such as `shortDate` and `longDate`. It can also accept a constructed format string using characters supported by the `DatePipe`, e.g. `EE/MM/yyyy`. Notice that formats like `shortDate`, `longDate`, etc., can be used as [`displayFormat`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html#displayFormat) only. Also, if no [`displayFormat`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html#displayFormat) is provided, the editor will use the [`inputFormat`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html#inputformat) as its [`displayFormat`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html#displayFormat).
Alternatively, if the [`inputFormat`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html#inputFormat) property is not set, the input format will be inferred from the [`displayFormat`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html#displayFormat) in case it can be parsed as containing numeric date-time parts only.

To set a specific input format, pass it as a string to the IgxDateTimeEditor directive. This will set both the expected user input format and the [mask](mask.md) for the editor. Additionally, the [`inputFormat`]({environment:angularApiUrl}/classes/igxdatetimeeditordirective.html#inputFormat) is locale based, so if none is provided, the editor will default to the one used by the browser.

Expand Down
14 changes: 14 additions & 0 deletions en/components/general-changelog-dv.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,20 @@ All notable changes for each version of Ignite UI for Angular are documented on

* [Ignite UI for Angular CHANGELOG.md at Github](https://github.com/IgniteUI/igniteui-angular/blob/master)

## **18.2.0 (December 2024)**

### igniteui-angular-charts (Charts)

DashboardTile (Beta)

* New [Dashboard Tile](dashboard-tile.md) component is a container control that analyzes and visualizes a bound ItemsSource collection or single point and returns an appropriate data visualization based on the schema and count of the data. This control utilizes a built-in [Toolbar](menus/toolbar.md) component to allow you to make changes to the visualization at runtime, allowing you to see many different visualizations of your data with minimal code.

### igniteui-angular-charts (Inputs)

* New ColorEditor (Beta) & Toolbar ToolAction (Beta)

This new [Color Editor](inputs/color-editor.md) can be used as a standalone color picker and is now integrated into the [Toolbar](menus/toolbar.md) component to update visualizations at runtime.

## **18.1.0 (September 2024)**

* [Data Pie Chart](charts/types/data-pie-chart.md) - The [`IgxDataPieChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxdatapiechartcomponent.html) is a new component that renders a pie chart. This component works similarly to the [`IgxCategoryChartComponent`]({environment:dvApiBaseUrl}/products/ignite-ui-angular/api/docs/typescript/latest/classes/igniteui_angular_charts.igxcategorychartcomponent.html), in that it will automatically detect the properties on your underlying data model while allowing selection, highlighting, animation and legend support via the ItemLegend component.
Expand Down
Loading
Loading