diff --git a/.github/skills/xplat-docs-api-links/SKILL.md b/.github/skills/xplat-docs-api-links/SKILL.md index 3f8bb7f03b..346fcb8dd3 100644 --- a/.github/skills/xplat-docs-api-links/SKILL.md +++ b/.github/skills/xplat-docs-api-links/SKILL.md @@ -74,8 +74,13 @@ Each JSON file is a TypeDoc reflection tree. Top-level `children` contains all e | `member` | no | Property or method name for the anchor. | | `prefixed` | no | Default `true` — adds `Igr`/`Igx`/`Igc`/`Igb` automatically. Set `false` when `type` contains `{ComponentName}` or the name is already fully-qualified. **Always `false` for excel types.** | | `suffix` | no | Default `true` — appends `Component` suffix for Angular DV packages. Set `false` for utility classes (FilteringOperand, SortingStrategy, SummaryOperand, all excel types). | +| `exclude` | no | Comma-separated platform list (`"Angular"`, `"Blazor"`, etc.). On listed platforms the symbol renders as inline code (backticks) instead of a link. Use when the type/member genuinely **does not exist** on those platforms. **Preferred over wrapping a single `` in a ``** for the sole purpose of platform-omission. | +| `excludeSuffixFor` | no | Comma-separated platform list. On listed platforms the package `classSuffix` (e.g. `Component`) is **not** appended, overriding the per-package default. Use when the same type is a plain class on some platforms (e.g. `IgxChartSelection`) but a `Component`-suffixed class on others. **Generates a real link — combine with `exclude` if the type is also absent on other platforms.** | +| `excludePrefixFor` | no | Comma-separated platform list. On listed platforms the platform prefix (`Igr`/`Igx`/`Igc`/`Igb`) is **not** prepended. Use when a type has no prefix on certain platforms. **Generates a real link — combine with `exclude` if needed.** | | `label` | no | Override display text. | +> **Critical rule:** NEVER replace an existing `` with backtick text. If a URL is broken on certain platforms, add `exclude="Platform"` to the tag. Only backtick text is acceptable when the type has no TypeDoc page on *any* platform AND has never been an ApiLink in the content history. When in doubt, keep the ApiLink — the broken link will be caught by `check-api-links.mjs` and fixed via `apply-excludes.mjs`. + ### Platform prefix mapping | Platform | Prefix | Example (type="Column") | @@ -253,6 +258,29 @@ Angular's `grids` package appends `Component` to all **UI component** class name ``` +### Use `excludeSuffixFor=` when only some platforms use the suffix + +When the suffix causes a 404 on **specific platforms only** (not globally), use `excludeSuffixFor` to remove it just for those platforms while keeping the link alive: + +```mdx + + +``` + +The `check-mdx-links.mjs` script automatically suggests this fix when it detects a broken link that resolves correctly after stripping the suffix — look for `→ FIX: excludeSuffixFor="..."` in the output. + +Similarly, `excludePrefixFor` removes the platform prefix (`Igr`/`Igx`/`Igc`/`Igb`) for the listed platforms only: + +```mdx + +``` + +> **Decision guide**: +> - Symbol **doesn't exist** on a platform → `exclude="Platform"` +> - Symbol exists but URL has wrong suffix on those platforms → `excludeSuffixFor="Platform"` +> - Symbol exists but URL has wrong prefix on those platforms → `excludePrefixFor="Platform"` +> - `suffix={false}` / `prefixed={false}` → removes suffix/prefix globally (all platforms) + ### Classes that NEED `suffix={false}` - All `*FilteringOperand` classes: `BooleanFilteringOperand`, `NumberFilteringOperand`, `StringFilteringOperand`, `DateFilteringOperand`, `DateTimeFilteringOperand`, `TimeFilteringOperand` diff --git a/.github/skills/xplat-docs-api-map-sync/SKILL.md b/.github/skills/xplat-docs-api-map-sync/SKILL.md new file mode 100644 index 0000000000..f1855f2d2b --- /dev/null +++ b/.github/skills/xplat-docs-api-map-sync/SKILL.md @@ -0,0 +1,223 @@ +--- +name: xplat-docs-api-map-sync +description: "Reference guide for synchronizing the xplat docs ApiLink references with the upstream igniteui-xplat-docs apiMap data. Covers running scripts/resolve-api-links.mjs to inject ApiLink tags from `IgxFoo.bar`-style backtick references in MDX, syncing docConfig.json with the sibling igniteui-xplat-docs repo, generating per-platform broken-link reports via scripts/check-api-links.mjs, and applying exclude= props to broken ApiLink tags via scripts/apply-excludes.mjs. Use when bumping API package versions, after merging vNext content, or when ApiLink coverage drifts from upstream." +user-invocable: true +--- + +# AI Agent Guide — Syncing xplat-docs ApiLink Coverage + +## Context + +This Astro xplat docs project mirrors the legacy gulp-based `igniteui-xplat-docs` pipeline. The legacy pipeline used **apiMap JSON** files (one per platform) and **docConfig.json** to: + +1. Convert backtick-prefixed type/member references (`` `IgxGrid.sort` ``) into resolved API URLs. +2. Resolve the right per-platform package version, prefix, suffix, and base URL. + +Here those responsibilities are split across: + +| Responsibility | Implementation | +|---|---| +| `apiMap` lookup of valid types / members | Per-platform JSON files in sibling `igniteui-xplat-docs/apiMap/{Angular,React,Blazor,WebComponents}/*.apiMap.json` | +| `docConfig` (package versions, prefixes, base URLs) | `docs/xplat/docConfig.json` | +| Backtick → `` conversion | `docs/xplat/scripts/resolve-api-links.mjs` (or workspace-level equivalent) | +| Verifying generated URLs against staging | `scripts/check-api-links.mjs` | +| Auto-applying `exclude=` for broken URLs | `scripts/apply-excludes.mjs` | +| Migrating `` to `exclude=` | `scripts/migrate-platformblock-to-exclude.mjs` | + +--- + +## Sibling Repository Layout + +The `igniteui-xplat-docs` repo is at . + +``` +igniteui-xplat-docs/ + apiMap/ + Angular/*.apiMap.json + React/*.apiMap.json + Blazor/*.apiMap.json + WebComponents/*.apiMap.json + docConfig.json + gulpfile.js ← legacy reference; do not run +``` + +The `astro-components` repo is also a sibling (checked out next to `docs-template`) and is symlinked into `node_modules/igniteui-astro-components` via the workspace config in `docs-template/package.json`. The `` Astro component lives there at `src/components/mdx/ApiLink/ApiLink.astro`. + +--- + +## Workflow 0 — Applying Fixes from an Existing mdx-link-report + +When `mdx-link-report-{angular,react,wc,blazor}.md` files already exist at the repo root (generated by a previous `check-mdx-links` run), apply all suggested fixes in one step: + +```bash +# Preview what will change (no writes) +node scripts/apply-mdx-report-fixes.mjs --dry-run + +# Apply all fixes across all four platform reports +node scripts/apply-mdx-report-fixes.mjs +``` + +The script reads every `mdx-link-report-*.md` it finds, parses each broken-URL entry's **FIX** line, and merges the appropriate prop (`excludeSuffixFor`, `excludePrefixFor`, or `exclude`) onto the matching `` tag in the xplat source file. Angular report paths are automatically remapped to their canonical `docs/xplat/src/content/` source (except `grids/` and `changelog/` which Angular owns directly). + +After applying, re-run the check to confirm the broken count drops to 0: + +```bash +npm run check-mdx-links:report:angular +npm run check-mdx-links:report:react +npm run check-mdx-links:report:wc +npm run check-mdx-links:report:blazor +``` + +--- + +## Workflow 1 — After Bumping a Platform Version + +When a platform's API package version changes (e.g. Angular 21.1 → 21.2) some symbols may be renamed, removed, or relocated. Walk through: + +```bash +# 1. Sync docConfig.json with upstream (manual diff) +# Compare docs/xplat/docConfig.json with sibling igniteui-xplat-docs/docConfig.json. +# Apply any version, base-URL, or package-key changes; preserve local-only fields +# (e.g. codeSandboxButtonInject). + +# 2. Generate per-platform broken-link reports against staging +node scripts/check-api-links.mjs --platform=angular +node scripts/check-api-links.mjs --platform=react +node scripts/check-api-links.mjs --platform=wc +node scripts/check-api-links.mjs --platform=blazor +# → produces api-link-report-{angular,react,wc,blazor}.md at repo root. + +# 3. Auto-apply exclude= to ApiLink tags whose URLs are broken +node scripts/apply-excludes.mjs --dry-run # preview +node scripts/apply-excludes.mjs # apply + +# 4. Re-run reports — broken count should now be near 0 +node scripts/check-api-links.mjs --platform=angular +# (and the other three) +``` + +## Workflow 2 — After Importing New Content from vNext + +**Critical rule: never demote an existing `` to backtick text.** If a URL is broken on some platforms, add `exclude="Platform"` — never remove the link. Backtick text is only acceptable when the type has no TypeDoc page on *any* platform and was never an ApiLink in the upstream content. + +**Correct pipeline order** — must run in this sequence: + +```bash +# 1. Strip Igr/Igx/Igc/Igb prefixes from backtick-wrapped prose refs. +# (Xplat content is platform-agnostic. `IgrToolbar` → `Toolbar`) +# Script skips code fences, JSX tags, and PlatformBlock-wrapped content +# (e.g. `IgrFoo` is intentional). +node scripts/fix-igr-backtick-prefix.mjs + +# 2. Convert bare backtick refs (`Toolbar`, `DataChart`, etc.) into +# using the sibling igniteui-xplat-docs/apiMap JSON files. +# Reads mentionedTypes: frontmatter to scope the lookup per file. +cd docs/xplat && node scripts/resolve-api-links.mjs + +# 3. Fix attributes: strip CLR arity suffixes, add prefixed={false} +# for enums, reclassify class → interface for known mis-classified types. +# Does NOT demote ApiLinks to backtick text. +node scripts/fix-api-link-attrs.mjs + +# 4. Migrate any wrappers +# that exist purely for platform-omission into exclude= props. +cd /c/Repos/docs/docs-template && node scripts/migrate-platformblock-to-exclude.mjs + +# 5. Run Workflow 1 (steps 2-4) to verify and auto-fix broken URLs. +``` + +**Angular content syncs automatically** — after fixing xplat, run: +```bash +cd docs/xplat && node scripts/generate.mjs --platform=Angular --lang=en +cd /c/Repos/docs/docs-template && node docs/angular/scripts/sync-generated.mjs --lang=en +# repeat for --lang=jp, --lang=kr if needed +``` + +--- + +## Script Reference + +### `scripts/check-api-links.mjs` + +Walks `docs/xplat/src/content/**/*.mdx`, extracts every `` tag, computes the staging URL per platform, and HEAD-checks each URL. + +- Honors enclosing `` (stack-based intersection) so a tag wrapped for one platform is checked only on that platform. +- Honors `exclude="..."` on the tag itself — listed platforms are dropped from the check set. +- Output: + - Console summary (OK / Not found / HTTP / Total broken). + - `api-link-report-.md` with details on every broken URL and the MDX files it appears in. + +CLI: +``` +node scripts/check-api-links.mjs --platform=angular|react|wc|blazor +``` + +### `scripts/apply-excludes.mjs` + +Reads all four `api-link-report-*.md` files, builds a per-file map of broken URLs → platforms, then walks each file's `` tags and merges `exclude="..."` for any matching tag. Idempotent. + +Matching algorithm: +- Strip platform prefix (`Igr/Igx/Igc/Igb`) from URL type names. +- Generate two key variants per URL — with and without `Component/Module/Directive/Element` suffix — to match Angular tags written either with or without the suffix. +- Lowercase member fragments so Blazor's PascalCased `#Condition` matches a tag's `member="condition"`. +- On tag side, key is `(stripPrefix(type) | lowercased member | kind || 'class')`. + +CLI: +``` +node scripts/apply-excludes.mjs --dry-run +node scripts/apply-excludes.mjs +``` + +### `scripts/migrate-platformblock-to-exclude.mjs` + +Finds the anti-pattern: + +```mdx + + + +``` + +When `for=` lists exactly N-1 of the 4 platforms, rewrites to: + +```mdx + +``` + +Skips tags that already have an `exclude=` attribute. + +### `scripts/resolve-api-links.mjs` (or workspace equivalent) + +Walks MDX content and converts backtick-only API references like `` `IgxGrid.sort` `` into `` tags by looking up the type and member in the sibling `igniteui-xplat-docs/apiMap/*.json` files. + +--- + +## docConfig.json Sync Checklist + +When syncing `docs/xplat/docConfig.json` with the upstream `igniteui-xplat-docs/docConfig.json`: + +- Pull in any new platform version numbers (`apiPackages[platform][packageId].version`). +- Pull in any new packageId entries (e.g. new component packages added upstream). +- Preserve **local-only** fields the Astro project uses but the legacy pipeline does not — e.g. `codeSandboxButtonInject`. +- Leave `prefix`, `classSuffix`, and `apiUrl` alone unless explicitly changed upstream — only Angular has a non-empty `classSuffix` ("Component") for chart/gauge/map/excel/spreadsheet packages. + +--- + +## Common Pitfalls + +| Pitfall | Symptom | Fix | +|---|---|---| +| Forgot to re-run `check-api-links` after `apply-excludes` | Same broken count reported | Re-run check after apply; report is regenerated. | +| Member casing mismatch (Blazor PascalCase vs MDX lowercase) | Blazor 0 tags updated even though report shows breaks | `apply-excludes.mjs` already handles this via lowercase key. If you customize, preserve the lowercase logic. | +| Angular `Component` suffix only on certain packages | Some Angular URLs still broken after apply | Verify `apply-excludes.mjs` `baseVariants()` adds both with-suffix and without-suffix variants. | +| `replace_string_in_file` silently failing on `apply-excludes.mjs` | Edits report success but file unchanged | Use a Node-based file patcher: `readFileSync` + `.replace()` + `writeFileSync`. Always grep to verify. | +| Running resolve-api-links BEFORE fix-igr-backtick-prefix | Backtick refs with `Igr` prefix can't be resolved; new backtick `Toolbar` refs created after fix-igr go unconverted | Always run fix-igr **first**, then resolve-api-links, then fix-api-link-attrs. | +| Adding types to a NONEXISTENT_TYPES demotion list in fix-api-link-attrs | ApiLinks removed from content; replaced with `IgrFoo` backtick text | **Never demote ApiLinks.** `fix-api-link-attrs.mjs` has NO demotion logic. Handle broken URLs with `exclude=` via `apply-excludes.mjs`. | +| fix-igr-backtick-prefix stripping Igr prefix inside PlatformBlock | ``IgrFoo`` → `Foo` (wrong) | The script already skips lines containing `` whose only purpose is to **omit** an `` for a subset of platforms. Use the `exclude="..."` prop on `` instead. + +The `exclude` prop accepts a comma-separated list of platform names (same casing as `for`). On the listed platforms, the link renders as **inline code (backticks)** instead of a hyperlink — preserving the symbol name in prose without producing a broken URL. + +### Anti-pattern (DO NOT DO THIS) + +```mdx + + + + +``` + +### Correct pattern + +```mdx + +``` + +This renders a normal link on Angular/React/WebComponents and renders `MyType.someMember` in backticks on Blazor. No PlatformBlock needed. + +### When to use which + +| Situation | Use | +|---|---| +| The same `` references something missing on N platforms (broken URL) | `exclude="P1,P2"` on the ApiLink | +| Different platforms need genuinely **different** ApiLinks (different `type`, `kind`, `member`, etc.) | One `` per variant (each containing its own ``) | +| Surrounding **prose or code** also differs per platform | `` (regular usage) | + +### Migration script + +`scripts/migrate-platformblock-to-exclude.mjs` automatically rewrites the anti-pattern (a `` containing only a single `` whose `for=` covers exactly N-1 of the 4 platforms) into ``. + +### Report-driven exclusion + +`scripts/apply-excludes.mjs` reads `api-link-report-{angular,react,wc,blazor}.md` (produced by `scripts/check-api-links.mjs`) and adds `exclude="..."` to every ApiLink whose generated URL is broken on a given platform. Run after every API package version bump: + +```bash +# 1. Generate per-platform reports +node scripts/check-api-links.mjs --platform=angular +node scripts/check-api-links.mjs --platform=react +node scripts/check-api-links.mjs --platform=wc +node scripts/check-api-links.mjs --platform=blazor + +# 2. Auto-apply exclude= to broken-link tags (idempotent) +node scripts/apply-excludes.mjs --dry-run # preview +node scripts/apply-excludes.mjs # apply + +# 3. Re-run reports to verify near-zero broken count +``` + +The script: +- Strips `Igx/Igr/Igc/Igb` prefix from URL type names. +- Strips `Component/Module/Directive/Element` suffix (Angular adds these to certain class names). +- Lowercases member fragments (Blazor PascalCases members in URLs). +- Merges with any existing `exclude=` attribute (preserves manually-added platforms). + +--- + ## Related Skills - [`xplat-docs-api-links`](../xplat-docs-api-links/SKILL.md) — ApiLink usage guide diff --git a/api-link-report-angular.md b/api-link-report-angular.md index a22fba1e16..4b09c3ecef 100644 --- a/api-link-report-angular.md +++ b/api-link-report-angular.md @@ -1,12 +1,12 @@ # API Link Check Report -_Generated: 2026-05-19 18:51:16 UTC_ +_Generated: 2026-05-22 09:54:39 UTC_ ## Summary | | | |---|---| -| ✅ OK | 1483 | +| ✅ OK | 2084 | | ❌ Not found (type/member missing) | 0 | | ❌ HTTP error | 0 | | ❌ **Total broken** | **0** | diff --git a/api-link-report-blazor.md b/api-link-report-blazor.md index ae317e20ce..56f8b7d460 100644 --- a/api-link-report-blazor.md +++ b/api-link-report-blazor.md @@ -1,12 +1,12 @@ # API Link Check Report -_Generated: 2026-05-19 17:55:20 UTC_ +_Generated: 2026-05-22 09:58:46 UTC_ ## Summary | | | |---|---| -| ✅ OK | 1054 | +| ✅ OK | 1785 | | ❌ Not found (type/member missing) | 0 | | ❌ HTTP error | 0 | | ❌ **Total broken** | **0** | diff --git a/api-link-report-react.md b/api-link-report-react.md index f2a9b21a77..f5bb39467a 100644 --- a/api-link-report-react.md +++ b/api-link-report-react.md @@ -1,12 +1,12 @@ # API Link Check Report -_Generated: 2026-05-19 17:53:29 UTC_ +_Generated: 2026-05-22 09:55:43 UTC_ ## Summary | | | |---|---| -| ✅ OK | 1106 | +| ✅ OK | 1812 | | ❌ Not found (type/member missing) | 0 | | ❌ HTTP error | 0 | | ❌ **Total broken** | **0** | diff --git a/api-link-report-wc.md b/api-link-report-wc.md index 0abf1c8fac..f2381eb7fb 100644 --- a/api-link-report-wc.md +++ b/api-link-report-wc.md @@ -1,12 +1,12 @@ # API Link Check Report -_Generated: 2026-05-19 17:54:07 UTC_ +_Generated: 2026-05-22 09:56:43 UTC_ ## Summary | | | |---|---| -| ✅ OK | 1128 | +| ✅ OK | 1752 | | ❌ Not found (type/member missing) | 0 | | ❌ HTTP error | 0 | | ❌ **Total broken** | **0** | diff --git a/docs/angular/src/content/en/components/action-strip.mdx b/docs/angular/src/content/en/components/action-strip.mdx index 8dcaa3dc8b..796a120f96 100644 --- a/docs/angular/src/content/en/components/action-strip.mdx +++ b/docs/angular/src/content/en/components/action-strip.mdx @@ -80,7 +80,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` @@ -156,7 +156,7 @@ This can be utilized via grid action components and we are providing two default These components inherit and when creating a custom grid action component, it should also inherit `IgxGridActionsBaseDirective`. - + When `IgxActionStripComponent` is a child component of the grid, hovering a row will automatically show the UI. diff --git a/docs/angular/src/content/en/components/ai/ai-assisted-development-overview.mdx b/docs/angular/src/content/en/components/ai/ai-assisted-development-overview.mdx index 0aebf5c910..8df750ab8a 100644 --- a/docs/angular/src/content/en/components/ai/ai-assisted-development-overview.mdx +++ b/docs/angular/src/content/en/components/ai/ai-assisted-development-overview.mdx @@ -34,7 +34,7 @@ Run this command from the root of your existing Angular, React, Blazor, or Web C npx igniteui-cli ai-config ``` - + Without a version pin, `npx` may pull an older CLI version that does not recognize the `ai-config` subcommand and will instead launch an interactive project-creation prompt, scaffolding a new project inside your existing one. Make sure that you have installed CLI version 16.x. @@ -49,7 +49,7 @@ After the command finishes, start the MCP servers in your AI client. The servers If Ignite UI is **not** installed in the project: - + Ignite UI MCP servers configured for your selected clients No AI skill files found. Make sure packages are installed (`npm install`) and your Ignite UI packages are up-to-date. @@ -58,7 +58,7 @@ The MCP servers are ready to use. Skills will be added automatically the next ti If Ignite UI **is** installed in the project: - + Ignite UI MCP servers configured for your selected clients Agent Skills copied to your selected agents' skills directories @@ -185,14 +185,14 @@ If you have the Ignite UI CLI installed globally, use the shorter form: ig ai-config ``` - + The `npx igniteui-cli` and `ig` forms do not register the `@angular/cli` MCP server. Use the Angular Schematics command above if you want all three servers configured in a single step. - + The command requires Ignite UI packages to be installed in your project (`npm install`). If no skill files are found, make sure your packages are up-to-date. diff --git a/docs/angular/src/content/en/components/ai/cli-mcp.mdx b/docs/angular/src/content/en/components/ai/cli-mcp.mdx index ffbaf143bf..23b777b860 100644 --- a/docs/angular/src/content/en/components/ai/cli-mcp.mdx +++ b/docs/angular/src/content/en/components/ai/cli-mcp.mdx @@ -60,7 +60,7 @@ The canonical launch command is: npx -y igniteui-cli mcp ``` - + The `-y` flag tells `npx` to auto-confirm the package download prompt so the server can start without manual intervention. @@ -157,7 +157,7 @@ If you created the project with Ignite UI CLI first, review the generated `.vsco Once saved, open the GitHub Copilot chat panel, switch to **Agent** mode, and the Ignite UI CLI MCP tools will be available. - + MCP support in VS Code requires GitHub Copilot and VS Code 1.99 or later. @@ -185,7 +185,7 @@ Cursor supports project-scoped MCP configuration. Create or edit `.cursor/mcp.js The servers will be picked up automatically when you open a new Cursor chat session. - + You can also configure MCP servers globally via **Settings → MCP** in Cursor. @@ -273,7 +273,7 @@ JetBrains AI Assistant supports MCP servers through the IDE settings: 5. Click **OK** and restart the AI Assistant. - + MCP support requires the AI Assistant plugin to be installed and enabled in your JetBrains IDE. @@ -349,7 +349,7 @@ At a high level, the CLI MCP tools help with: - updating project structure and configuration - answering documentation and API questions - + Framework detection uses component prefixes: `for Angular`, `for React`, `for Web Components`, `for Blazor`. The assistant picks up the right framework automatically from your open files or prompt context. diff --git a/docs/angular/src/content/en/components/ai/skills.mdx b/docs/angular/src/content/en/components/ai/skills.mdx index 60a9ae3398..3a95886d6c 100644 --- a/docs/angular/src/content/en/components/ai/skills.mdx +++ b/docs/angular/src/content/en/components/ai/skills.mdx @@ -11,7 +11,7 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' Ignite UI for Angular ships with **[Agent Skills](https://agentskills.io/)** - structured knowledge files that teach AI coding assistants (GitHub Copilot, Cursor, Windsurf, Claude, Gemini CLI, JetBrains Junie, etc.) how to work with Ignite UI for Angular. These skill files provide context-aware guidance on components, grids, data operations, and theming, enabling your AI assistant to generate accurate, idiomatic code that follows best practices. - + The AI tooling landscape is evolving rapidly. Skill discovery locations and distribution options may change as tools and IDEs are updated. Always consult the official documentation for your specific tool or agent for the latest information. @@ -26,7 +26,7 @@ The skill files live in the [`skills/`](https://github.com/IgniteUI/igniteui-ang | Theming & Styling | [`skills/igniteui-angular-theming/SKILL.md`](https://github.com/IgniteUI/igniteui-angular/blob/master/skills/igniteui-angular-theming/SKILL.md) | Palettes, typography, elevations, component themes, MCP server | | Generate From Image Design | [`skills/igniteui-angular-generate-from-image-design/SKILL.md`](https://github.com/IgniteUI/igniteui-angular/blob/master/skills/igniteui-angular-generate-from-image-design/SKILL.md) | Build Angular apps from screenshots, mockups, and wireframes using Ignite UI components | - + Starting with Ignite UI for Angular **21.1.0**, these skills are automatically discovered when placed in your agent's skills path (e.g., `.claude/skills`, `.agents/skills`, `.cursor/rules/`). This release ships with an optional migration to add these skills to your project automatically. @@ -144,7 +144,7 @@ ng generate @igniteui/angular-schematics:ai-config --assistants cursor --agents This also registers the `@angular/cli` MCP server alongside the Ignite UI servers. - + If you installed Ignite UI for Angular manually and want to copy skills without running `ai-config`, the skill files are also available under `node_modules`. To copy them into your project (e.g. into `.agents/skills/`), run: diff --git a/docs/angular/src/content/en/components/avatar.mdx b/docs/angular/src/content/en/components/avatar.mdx index de1b2ae090..efbfc82e0d 100644 --- a/docs/angular/src/content/en/components/avatar.mdx +++ b/docs/angular/src/content/en/components/avatar.mdx @@ -143,7 +143,7 @@ Analogically, the avatar can display an icon via the ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/banner.mdx b/docs/angular/src/content/en/components/banner.mdx index 9afe9b9ea9..88f2367c82 100644 --- a/docs/angular/src/content/en/components/banner.mdx +++ b/docs/angular/src/content/en/components/banner.mdx @@ -73,7 +73,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/bullet-graph.mdx b/docs/angular/src/content/en/components/bullet-graph.mdx index 0907f7b66b..2332333174 100644 --- a/docs/angular/src/content/en/components/bullet-graph.mdx +++ b/docs/angular/src/content/en/components/bullet-graph.mdx @@ -155,7 +155,7 @@ Performance value is the primary measure displayed by the component and it is vi ## Highlight Value -The bullet graph's performance value can be further modified to show progress represented as a highlighted value. This will make the `Value` appear with a lower opacity. A good example is if `Value` is 50 and `HighlightValue` is set to 25. This would represent a performance of 50% regardless of what the value of `TargetValue` is set to. To enable this first set `HighlightValueDisplayMode` to Overlay and then apply a `HighlightValue` to something lower than `Value`. +The bullet graph's performance value can be further modified to show progress represented as a highlighted value. This will make the appear with a lower opacity. A good example is if is 50 and is set to 25. This would represent a performance of 50% regardless of what the value of is set to. To enable this first set to Overlay and then apply a to something lower than . @@ -336,7 +336,7 @@ The backing element represents background and border of the bullet graph compone ## Scale -The scale is visual element that highlights the full range of values in the gauge. You can customize appearance and shape of the scale. The scale can also be inverted (using `IsScaleInverted` property) and all labels will be rendered from right-to-left instead of left-to-right. +The scale is visual element that highlights the full range of values in the gauge. You can customize appearance and shape of the scale. The scale can also be inverted (using property) and all labels will be rendered from right-to-left instead of left-to-right. diff --git a/docs/angular/src/content/en/components/button-group.mdx b/docs/angular/src/content/en/components/button-group.mdx index 9bf5f10f31..75b2c78f77 100644 --- a/docs/angular/src/content/en/components/button-group.mdx +++ b/docs/angular/src/content/en/components/button-group.mdx @@ -85,7 +85,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/button.mdx b/docs/angular/src/content/en/components/button.mdx index a205f92de7..353ac105d2 100644 --- a/docs/angular/src/content/en/components/button.mdx +++ b/docs/angular/src/content/en/components/button.mdx @@ -115,7 +115,7 @@ As of version `17.1.0` the IgniteUI for Angular exposes a new `igxIconButton` di ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/card.mdx b/docs/angular/src/content/en/components/card.mdx index f9e9f5bb7a..5ac7ff5f96 100644 --- a/docs/angular/src/content/en/components/card.mdx +++ b/docs/angular/src/content/en/components/card.mdx @@ -108,7 +108,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/charts/chart-api.mdx b/docs/angular/src/content/en/components/charts/chart-api.mdx index a3af6586d1..0880c9e439 100644 --- a/docs/angular/src/content/en/components/charts/chart-api.mdx +++ b/docs/angular/src/content/en/components/charts/chart-api.mdx @@ -6,85 +6,87 @@ _license: commercial namespace: Infragistics.Controls.Charts --- +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Charts API -The Ignite UI for Angular charts provide simple and easy to use APIs to plot your data in `CategoryChart`, `FinancialChart`, `DataChart`, `DataPieChart`, `DoughnutChart`, `PieChart`, and `Sparkline` UI elements. +The Ignite UI for Angular charts provide simple and easy to use APIs to plot your data in , , , , , , and UI elements. ## Angular Category Chart API -The Angular `CategoryChart` has the following API members: +The Angular has the following API members: | Chart Properties | Axis Properties | Series Properties | |------------------|-----------------|-------------------| -| - `CategoryChart.ChartType`
- `ExcludedProperties`
- `IncludedProperties`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `CrosshairsDisplayMode`
- `TransitionInMode`
- `HighlightingBehavior`
- `HighlightingMode`
- `TrendLineType`
| - `XAxisInterval`
- `XAxisLabelLocation`
- `XAxisGap`
- `XAxisOverlap`
- `XAxisTitle`
- `YAxisInterval`
- `YAxisLabelLocation`
- `YAxisTitle`
- `YAxisMinimumValue`
- `YAxisMaximumValue` | - `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `MarkerTypes`
- `ToolTipType`




| +| - `CategoryChart.ChartType`
-
-
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-




| ## Angular Financial Chart API -The Angular `FinancialChart` has the following API members: +The Angular has the following API members: | Chart Properties | Axis Properties | Series Properties | |------------------|-----------------|-------------------| -| - `FinancialChart.ChartType`
- `ExcludedProperties`
- `IncludedProperties`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `ToolTipType`
- `CrosshairsDisplayMode`
- `HighlightingBehavior`
- `HighlightingMode`
- `TrendLineType` | - `XAxisInterval`
- `XAxisLabelLocation`
- `XAxisTitle`
- `YAxisInterval`
- `YAxisLabelLocation`
- `YAxisTitle`
- `YAxisMinimumValue`
- `YAxisMaximumValue`
- `YAxisMode`
- `XAxisMode` | - `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `MarkerTypes`
- `IndicatorTypes`
- `VolumeType`
- `ZoomSliderType`


| +| - `FinancialChart.ChartType`
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-


| ## Angular Data Chart API -The Angular `DataChart` has the following API members: +The Angular has the following API members: | Chart Properties | Axis Classes | |------------------|--------------| -| - `SeriesViewer.Title`
- `SeriesViewer.Subtitle`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `DataChart.Axes`
- `SeriesViewer.Series`
| - `Axis` is base class for all axis types
- `CategoryXAxis` used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- `CategoryYAxis` used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md)
- `CategoryAngleAxis` used with [Radial Series](types/radial-chart.md)
- `NumericXAxis` used with [Scatter Series](types/scatter-chart.md) and [Bar Series](types/bar-chart.md)
- `NumericYAxis` used with [Scatter Series](types/scatter-chart.md), [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- `NumericAngleAxis` used with [Polar Series](types/polar-chart.md)
- `NumericRadiusAxis` used with [Polar Series](types/polar-chart.md) and [Radial Series](types/radial-chart.md)
- `TimeXAxis` used with [Category Series](types/column-chart.md) and [Financial Series](types/stock-chart.md)

| +| - `SeriesViewer.Title`
- `SeriesViewer.Subtitle`
-
-
-
-
-
-
- `DataChart.Axes`
- `SeriesViewer.Series`
| - is base class for all axis types
- used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md)
- used with [Radial Series](types/radial-chart.md)
- used with [Scatter Series](types/scatter-chart.md) and [Bar Series](types/bar-chart.md)
- used with [Scatter Series](types/scatter-chart.md), [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- used with [Polar Series](types/polar-chart.md)
- used with [Polar Series](types/polar-chart.md) and [Radial Series](types/radial-chart.md)
- used with [Category Series](types/column-chart.md) and [Financial Series](types/stock-chart.md)

| -The Angular `DataChart` can use the following type of series that inherit from `Series`: +The Angular can use the following type of series that inherit from : | Category Series | Stacked Series | |------------------|----------------| -| - `AreaSeries`
- `BarSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries`
| - `StackedAreaSeries`
- `StackedBarSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100BarSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`


| +| -
-
-
-
-
-
-
-
-
-
-
- `RangeBarSeries`
-
| -
-
-
-
-
-
-
-
-
-


| | Scatter Series | Financial Series | |----------------|------------------| -| - `BubbleSeries`
- `HighDensityScatterSeries`
- `ScatterSeries`
- `ScatterLineSeries`
- `ScatterSplineSeries`
- `ScatterAreaSeries`
- `ScatterContourSeries`
- `ScatterPolylineSeries`
- `ScatterPolygonSeries`

| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`
- `WeightedCloseIndicator`
- and [many more](types/stock-chart.md) | +| -
-
-
-
-
-
-
-
-

| -
-
-
-
-
-
-
-
-
- and [many more](types/stock-chart.md) | | Radial Series | Polar Series | |---------------|--------------| -| - `RadialLineSeries`
- `RadialAreaSeries`
- `RadialPieSeries`
- `RadialColumnSeries`

| - `PolarScatterSeries`
- `PolarLineSeries`
- `PolarAreaSeries`
- `PolarSplineSeries`
- `PolarSplineAreaSeries`
| +| -
-
-
-

| -
-
-
-
-
| ## Angular Data Legend API -The Angular `DataLegend` has the following API members: - -- `IncludedColumns` -- `ExcludedColumns` -- `IncludedSeries` -- `ExcludedSeries` -- `ValueFormatAbbreviation` -- `ValueFormatMode` -- `ValueFormatCulture` -- `ValueFormatMinFractions` -- `ValueFormatMaxFractions` -- `ValueTextColor` -- `TitleTextColor` -- `LabelTextColor` -- `UnitsTextColor` -- `SummaryType` -- `HeaderTextColor` -- `BadgeShape` +The Angular has the following API members: + +- +- +- +- +- +- +- +- +- +- +- +- +- +- +- +- ## Angular Donut Chart API -The Angular `DoughnutChart` has the following API members: +The Angular has the following API members: -- `AllowSliceExplosion` -- `AllowSliceSelection` -- `InnerExtent` +- +- +- ## Angular Data Pie Chart API -The Angular `DataPieChart` has the following API members: +The Angular has the following API members: - `DataPieChart.ChartType` - `DataPieChart.HighlightingBehavior` @@ -95,7 +97,7 @@ The Angular `DataPieChart` has the following API members: ## Angular Pie Chart API -The Angular `PieChart` has the following API members: +The Angular has the following API members: - `PieChart.LegendItemBadgeTemplate` - `PieChart.LegendItemTemplate` @@ -106,15 +108,15 @@ The Angular `PieChart` has the following API members: ## Angular Sparkline Chart API -The Angular `Sparkline` has the following API members: +The Angular has the following API members: -- `DisplayNormalRangeInFront` +- - `Sparkline.DisplayType` -- `LowMarkerBrush` -- `LowMarkerSize` -- `LowMarkerVisibility` -- `NormalRangeFill` -- `UnknownValuePlotting` +- +- +- +- +- ## Additional Resources diff --git a/docs/angular/src/content/en/components/charts/features/chart-axis-gridlines.mdx b/docs/angular/src/content/en/components/charts/features/chart-axis-gridlines.mdx index 90ed3fc81a..2b239d52c2 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-axis-gridlines.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-axis-gridlines.mdx @@ -10,12 +10,14 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Axis Gridlines All Ignite UI for Angular charts include built-in capability to modify appearance of axis lines as well as frequency of major/minor gridlines and tickmarks that are rendered on the X-Axis and Y-Axis. -the following examples can be applied to `CategoryChart` as well as `FinancialChart` controls. +the following examples can be applied to as well as controls. Axis major gridlines are long lines that extend horizontally along the Y-Axis or vertically along the X-Axis from locations of axis labels, and they render through the plot area of the chart. Axis minor gridlines are lines that render between axis major gridlines. @@ -37,20 +39,20 @@ This example shows how configure the axis gridline to display major and minor gr Setting the axis interval property specifies how often major gridlines and axis labels are rendered on an axis. Similarly, the axis minor interval property specifies how frequent minor gridlines are rendered on an axis. -In order to display minor gridlines that correspond to minor interval, you need to set `XAxisMinorStroke` and `XAxisMinorStrokeThickness` properties on the axis. This is because minor gridlines do not have a default color or thickness and they will not be displayed without first assigning them. +In order to display minor gridlines that correspond to minor interval, you need to set  and  properties on the axis. This is because minor gridlines do not have a default color or thickness and they will not be displayed without first assigning them. You can customize how the gridlines are displayed in your Angular chart by setting the following properties: | Axis Visuals | Type | Property Names | Description | | -----------------------|---------|--------------------------------------------------------------|---------------- | -| Major Stroke Color | string | `XAxisMajorStroke`
`YAxisMajorStroke` | These properties set the color of axis major gridlines. | -| Minor Stroke Color | string | `XAxisMinorStroke`
`YAxisMinorStroke` | These properties set the color of axis minor gridlines. | -| Major Stroke Thickness | number | `XAxisMajorStrokeThickness`
`YAxisMajorStrokeThickness` | These properties set the thickness in pixels of the axis major gridlines. | -| Minor Stroke Thickness | number | `XAxisMinorStrokeThickness`
`YAxisMinorStrokeThickness` | These properties set the thickness in pixels of the axis minor gridlines. | -| Major Interval | number | `XAxisInterval`
`YAxisInterval` | These properties set interval between axis major gridlines and labels. | -| Minor Interval | number | `XAxisMinorInterval`
`YAxisMinorInterval` | These properties set interval between axis minor gridlines, if used. | -| Axis Line Stroke Color | string | `XAxisStroke`
`YAxisStroke` | These properties set the color of an axis line. | -| Axis Stroke Thickness | number | `XAxisStrokeThickness`
`YAxisStrokeThickness` | These properties set the thickness in pixels of an axis line. | +| Major Stroke Color | string |
| These properties set the color of axis major gridlines. | +| Minor Stroke Color | string |
| These properties set the color of axis minor gridlines. | +| Major Stroke Thickness | number |
| These properties set the thickness in pixels of the axis major gridlines. | +| Minor Stroke Thickness | number |
| These properties set the thickness in pixels of the axis minor gridlines. | +| Major Interval | number |
| These properties set interval between axis major gridlines and labels. | +| Minor Interval | number |
| These properties set interval between axis minor gridlines, if used. | +| Axis Line Stroke Color | string |
| These properties set the color of an axis line. | +| Axis Stroke Thickness | number |
| These properties set the thickness in pixels of an axis line. | Regarding the Major and Minor Interval in the table above, it is important to note that the major interval for axis labels will also be set by this value, displaying one label at the point on the axis associated with the interval. The minor interval gridlines are always rendered between the major gridlines, and as such, the minor interval properties should always be set to something much smaller (usually 2-5 times smaller) than the value of the major Interval properties. @@ -65,9 +67,9 @@ The following example demonstrates how to customize the gridlines by setting the -The axes of the `DataChart` also have the ability to place a dash array on the major and minor gridlines by utilizing the `MajorStrokeDashArray` and `MinorStrokeDashArray` properties, respectively. The actual axis line can be dashed as well by setting the `StrokeDashArray` property of the corresponding axis. These properties take an array of numbers that will describe the length of the dashes for the corresponding grid lines. +The axes of the also have the ability to place a dash array on the major and minor gridlines by utilizing the and properties, respectively. The actual axis line can be dashed as well by setting the property of the corresponding axis. These properties take an array of numbers that will describe the length of the dashes for the corresponding grid lines. -The following example demonstrates a `DataChart` with the above dash array properties set: +The following example demonstrates a with the above dash array properties set: @@ -76,9 +78,9 @@ The following example demonstrates a `DataChart` with the above dash array prope ## Angular Axis Tickmarks Example -Axis tick marks are enabled by setting the `XAxisTickLength` and `YAxisTickLength` properties to a value greater than 0. These properties specifies the length of the line segments forming the tick marks. +Axis tick marks are enabled by setting the  and  properties to a value greater than 0. These properties specifies the length of the line segments forming the tick marks. -Tick marks are always extend from the axis line and point to the direction of the labels. Labels are offset by the value of the length of tickmarks to avoid overlapping. For example, with the `YAxisTickLength` property is set to 5, axis labels will be shifted left by that amount. +Tick marks are always extend from the axis line and point to the direction of the labels. Labels are offset by the value of the length of tickmarks to avoid overlapping. For example, with the  property is set to 5, axis labels will be shifted left by that amount. The following example demonstrates how to customize the tickmarks by setting the properties above: @@ -95,9 +97,9 @@ You can customize how the axis tickmarks are displayed in our Angular chats by s | Axis Visuals | Type | Property Names | Description | | -----------------------|---------|------------------------------------------------------------|------------------------- | -| Tick Stroke Color | string | `XAxisTickStroke`
`YAxisTickStroke` | These properties set the color of the tickmarks. | -| Tick Stroke Thickness | number | `XAxisTickStrokeThickness`
`YAxisTickStrokeThickness` | These properties set the thickness of the axis tick marks. | -| Tick Stroke Length | number | `XAxisTickLength`
`YAxisTickLength` | These properties set the length of the axis tick marks. | +| Tick Stroke Color | string |
| These properties set the color of the tickmarks. | +| Tick Stroke Thickness | number |
| These properties set the thickness of the axis tick marks. | +| Tick Stroke Length | number |
| These properties set the length of the axis tick marks. | ## Additional Resources @@ -111,25 +113,25 @@ You can find more information about related chart features in these topics: The following is a list of API members mentioned in the above sections: -| `DataChart` | `CategoryChart` or `FinancialChart` | +| | or | | -------------------------------------------------- | ----------------------------------- | -| `Axes` -> `NumericXAxis` -> `Interval` | `XAxisInterval` (Major Interval) | -| `Axes` -> `NumericYAxis` -> `Interval` | `YAxisInterval` (Major Interval) | -| `Axes` -> `NumericXAxis` -> `MinorInterval` | `XAxisMinorInterval` | -| `Axes` -> `NumericYAxis` -> `MinorInterval` | `YAxisMinorInterval` | -| `Axes` -> `NumericXAxis` -> `MajorStroke` | `XAxisMajorStroke` | -| `Axes` -> `NumericYAxis` -> `MajorStroke` | `YAxisMajorStroke` | -| `Axes` -> `NumericXAxis` -> `MajorStrokeThickness` | `XAxisMajorStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `MajorStrokeThickness` | `YAxisMajorStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `MinorStrokeThickness` | `XAxisMinorStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `MinorStrokeThickness` | `YAxisMinorStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `StrokeThickness` | `XAxisStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `StrokeThickness` | `YAxisStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `Stroke` | `XAxisStroke` (Axis Line Color) | -| `Axes` -> `NumericYAxis` -> `Stroke` | `YAxisStroke` (Axis Line Color) | -| `Axes` -> `NumericXAxis` -> `TickLength` | `XAxisTickLength` | -| `Axes` -> `NumericYAxis` -> `TickLength` | `YAxisTickLength` | -| `Axes` -> `NumericXAxis` -> `TickStroke` | `XAxisTickStroke` | -| `Axes` -> `NumericYAxis` -> `TickStroke` | `YAxisTickStroke` | -| `Axes` -> `NumericXAxis` -> `Strip` | `XAxisStrip` (Space between Major Gridlines) | -| `Axes` -> `NumericYAxis` -> `Strip` | `YAxisStrip` (Space between Major Gridlines) | +| -> -> | (Major Interval) | +| -> -> | (Major Interval) | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | (Axis Line Color) | +| -> -> | (Axis Line Color) | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | (Space between Major Gridlines) | +| -> -> | (Space between Major Gridlines) | diff --git a/docs/angular/src/content/en/components/charts/features/chart-axis-layouts.mdx b/docs/angular/src/content/en/components/charts/features/chart-axis-layouts.mdx index 9356484f6f..c0f90fa9af 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-axis-layouts.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-axis-layouts.mdx @@ -9,19 +9,21 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Axis Layouts All Ignite UI for Angular charts include options to configure many axis layout options such as location as well as having the ability to share axis between series or have multiple axes in the same chart. These features are demonstrated in the examples given below. -the following examples can be applied to `CategoryChart` as well as `FinancialChart` controls. +the following examples can be applied to as well as controls. ## Axis Locations Example -For all axes, you can specify axis location in relationship to chart plot area. The `XAxisLabelLocation` property of the Angular charts, allows you to position x-axis line and its labels on above or below plot area. Similarly, you can use the `YAxisLabelLocation` property to position y-axis on left side or right side of plot area. +For all axes, you can specify axis location in relationship to chart plot area. The property of the Angular charts, allows you to position x-axis line and its labels on above or below plot area. Similarly, you can use the property to position y-axis on left side or right side of plot area. -The following example depicts the amount of renewable electricity produced since 2009, represented by a [Line Chart](../types/line-chart.md). There is a drop-down that lets you configure the `YAxisLabelLocation` so that you can visualize what the axes look like when the labels are placed on the left or right side on the inside or outside of the chart's plot area. +The following example depicts the amount of renewable electricity produced since 2009, represented by a [Line Chart](../types/line-chart.md). There is a drop-down that lets you configure the so that you can visualize what the axes look like when the labels are placed on the left or right side on the inside or outside of the chart's plot area. @@ -36,11 +38,11 @@ e.g. https://www.infragistics.com/help/wpf/datachart-axis-orientation ## Axis Advanced Scenarios -For more advanced axis layout scenarios, you can use Angular Data Chart to share axis, add multiple y-axis and/or x-axis in the same plot area, or even cross axes at specific values. The following examples show how to use these features of the `DataChart`. +For more advanced axis layout scenarios, you can use Angular Data Chart to share axis, add multiple y-axis and/or x-axis in the same plot area, or even cross axes at specific values. The following examples show how to use these features of the . ### Axis Sharing Example -You can share and add multiple axes in the same plot area of the Angular `DataChart`. It a common scenario to use share `TimeXAxis` and add multiple `NumericYAxis` to plot many data sources that have wide range of values (e.g. stock prices and stock trade volumes). +You can share and add multiple axes in the same plot area of the Angular . It a common scenario to use share and add multiple to plot many data sources that have wide range of values (e.g. stock prices and stock trade volumes). The following example depicts a stock price and trade volume chart with a [Stock Chart](../types/stock-chart.md) and a [Column Chart](../types/column-chart.md) plotted. In this case, the Y-Axis on the left is used by the [Column Chart](../types/column-chart.md) and the Y-Axis on the right is used by the [Stock Chart](../types/stock-chart.md), while the X-Axis is shared between the two. @@ -53,7 +55,7 @@ The following example depicts a stock price and trade volume chart with a [Stock ### Axis Crossing Example -In addition to placing axes outside plot area, the Angular `DataChart` also provides options to position axes inside of plot area and make them cross at specific values. For example, you can create trigonometric chart by setting `CrossingAxis` and `CrossingValue` properties on both x-axis and y-axis to render axis lines and axis labels such that they are crossing at (0, 0) origin point. +In addition to placing axes outside plot area, the Angular also provides options to position axes inside of plot area and make them cross at specific values. For example, you can create trigonometric chart by setting and properties on both x-axis and y-axis to render axis lines and axis labels such that they are crossing at (0, 0) origin point. The following example shows a Sin and Cos wave represented by a [Scatter Spline Chart](../types/scatter-chart.md) with the X and Y axes crossing each other at the (0, 0) origin point. @@ -82,25 +84,25 @@ The following is a list of API members mentioned in the above sections: d in the above sections: -| `DataChart` | `CategoryChart` | +| | | | ------------------------------------------------------ | ------------------------------- | -| `Axes` -> `NumericYAxis` -> `CrossingAxis` | None | -| `Axes` -> `NumericYAxis` -> `CrossingValue` | None | -| `Axes` -> `NumericXAxis` -> `IsInverted` | `XAxisInverted` | -| `Axes` -> `NumericYAxis` -> `IsInverted` | `YAxisInverted` | -| `Axes` -> `NumericYAxis` -> `LabelLocation` | `YAxisLabelLocation` | -| `Axes` -> `NumericXAxis` -> `LabelLocation` | `XAxisLabelLocation` | -| `Axes` -> `NumericYAxis` -> `LabelHorizontalAlignment` | `YAxisLabelHorizontalAlignment` | -| `Axes` -> `NumericXAxis` -> `LabelVerticalAlignment` | `XAxisLabelVerticalAlignment` | -| `Axes` -> `NumericYAxis` -> `LabelVisibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `LabelVisibility` | `XAxisLabelVisibility` | +| -> -> | None | +| -> -> | None | +| -> -> | | +| -> -> | | +| -> -> `LabelLocation` | | +| -> -> `LabelLocation` | | +| -> -> `LabelHorizontalAlignment` | | +| -> -> `LabelVerticalAlignment` | | +| -> -> `LabelVisibility` | | +| -> -> `LabelVisibility` | | {/* TODO correct links in Transformer */} {/* -| `Axes` -> `NumericYAxis` -> `labelSettings.location` | `YAxisLabelLocation` | -| `Axes` -> `NumericXAxis` -> `labelSettings.location` | `XAxisLabelLocation` | -| `Axes` -> `NumericYAxis` -> `labelSettings.horizontalAlignment` | `YAxisLabelHorizontalAlignment` | -| `Axes` -> `NumericXAxis` -> `labelSettings.verticalAlignment` | `XAxisLabelVerticalAlignment` | -| `Axes` -> `NumericYAxis` -> `labelSettings.visibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `labelSettings.visibility` | `XAxisLabelVisibility` | */} +| -> -> `labelSettings.location` | | +| -> -> `labelSettings.location` | | +| -> -> `labelSettings.horizontalAlignment` | | +| -> -> `labelSettings.verticalAlignment` | | +| -> -> `labelSettings.visibility` | | +| -> -> `labelSettings.visibility` | | */} diff --git a/docs/angular/src/content/en/components/charts/features/chart-axis-options.mdx b/docs/angular/src/content/en/components/charts/features/chart-axis-options.mdx index d8830f4a0e..36e62eab3b 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-axis-options.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-axis-options.mdx @@ -72,9 +72,9 @@ By default, charts will calculate the minimum and maximum values for the numeric In the and controls, you can choose if your data is plotted on logarithmic scale along the y-axis when the property is set to true or on linear scale when this property is set to false (default value). With the property, you can change base of logarithmic scale from default value of 10 to other integer value. -The and control allows you to choose how your data is represented along the y-axis using property that provides `Numeric` and `PercentChange` modes. The `Numeric` mode will plot data with the exact values while the `PercentChange` mode will display the data as percentage change relative to the first data point provided. The default value is `Numeric` mode. +The and control allows you to choose how your data is represented along the y-axis using property that provides and modes. The mode will plot data with the exact values while the mode will display the data as percentage change relative to the first data point provided. The default value is mode. -In addition to property, the control has property that provides `Time` and `Ordinal` modes for the x-axis. The `Time` mode will render space along the x-axis for gaps in data (e.g. no stock trading on weekends or holidays). The `Ordinal` mode will collapse date areas where data does not exist. The default value is `Ordinal` mode. +In addition to property, the control has property that provides and modes for the x-axis. The mode will render space along the x-axis for gaps in data (e.g. no stock trading on weekends or holidays). The mode will collapse date areas where data does not exist. The default value is mode. @@ -124,20 +124,20 @@ You can find more information about related chart features in these topics: The following is a list of API members mentioned in the above sections: -| `DataChart` | `FinancialChart` | `CategoryChart` | +| | | | | ------------------------------------------------------ | ---------------------- | ---------------------- | -| `Axes` -> `NumericYAxis` -> `MaximumValue` | `YAxisMaximumValue` | `YAxisMaximumValue` | -| `Axes` -> `NumericYAxis` -> `MinimumValue` | `YAxisMinimumValue` | `YAxisMinimumValue` | -| `Axes` -> `NumericYAxis` -> `IsLogarithmic` | `YAxisIsLogarithmic` | `YAxisIsLogarithmic` | -| `Axes` -> `NumericYAxis` -> `LogarithmBase` | `YAxisLogarithmBase` | `YAxisLogarithmBase` | -| `Axes` -> `CategoryXAxis` -> `Gap` | None | `XAxisGap` | -| `Axes` -> `CategoryXAxis` -> `Overlap` | None | `XAxisOverlap` | -| `Axes` -> `TimeXAxis` | `XAxisMode` | None | -| `Axes` -> `PercentChangeYAxis` | `YAxisMode` | None | -| `Axes` -> `NumericYAxis` -> `labelSettings.angle` | `YAxisLabelAngle` | `YAxisLabelAngle` | -| `Axes` -> `NumericXAxis` -> `labelSettings.angle` | `XAxisLabelAngle` | `XAxisLabelAngle` | -| `Axes` -> `NumericYAxis` -> `labelSettings.textColor` | `YAxisLabelForeground` | `YAxisLabelForeground` | -| `Axes` -> `NumericXAxis` -> `labelSettings.textColor` | `XAxisLabelForeground` | `XAxisLabelForeground` | -| `Axes` -> `NumericYAxis` -> `labelSettings.visibility` | `YAxisLabelVisibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `labelSettings.visibility` | `XAxisLabelVisibility` | `XAxisLabelVisibility` | +| -> -> | | | +| -> -> | | | +| -> -> | | | +| -> -> | | | +| -> -> | None | | +| -> -> | None | | +| -> | | None | +| -> | | None | +| -> -> `labelSettings.angle` | | | +| -> -> `labelSettings.angle` | | | +| -> -> `labelSettings.textColor` | `YAxisLabelForeground` | `YAxisLabelForeground` | +| -> -> `labelSettings.textColor` | `XAxisLabelForeground` | `XAxisLabelForeground` | +| -> -> `labelSettings.visibility` | | | +| -> -> `labelSettings.visibility` | | | diff --git a/docs/angular/src/content/en/components/charts/features/chart-axis-types.mdx b/docs/angular/src/content/en/components/charts/features/chart-axis-types.mdx index fd53503b34..f95427e76c 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-axis-types.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-axis-types.mdx @@ -9,150 +9,154 @@ namespace: Infragistics.Controls.Charts import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Axis Types -The Ignite UI for Angular Category Chart uses only one `CategoryXAxis` and one `NumericYAxis` type. Similarly, Ignite UI for Angular Financial Chart uses only one `TimeXAxis` and one `NumericYAxis` types. However, the Ignite UI for Angular Data Chart provides support for multiple axis types that you can position on any side of the chart by setting [axis location](chart-axis-layouts.md#axis-locations-example) or even inside of the chart by using [axis crossing](chart-axis-layouts.md#axis-crossing-example) properties. This topic goes over each one, which axes and series are compatible with each other, and some specific properties to the unique axes. +The Ignite UI for Angular Category Chart uses only one and one type. Similarly, Ignite UI for Angular Financial Chart uses only one and one types. However, the Ignite UI for Angular Data Chart provides support for multiple axis types that you can position on any side of the chart by setting [axis location](chart-axis-layouts.md#axis-locations-example) or even inside of the chart by using [axis crossing](chart-axis-layouts.md#axis-crossing-example) properties. This topic goes over each one, which axes and series are compatible with each other, and some specific properties to the unique axes. ## Cartesian Axes -The `DataChart` with Cartesian Axes, allows you to plot data in horizontal (X-axis) and vertical (X-axis) direction with 3 types of X-Axis -(`CategoryXAxis`, `NumericXAxis`, and `TimeXAxis`) and 2 types of Y-Axis (`CategoryYAxis` and `NumericYAxis`). +The with Cartesian Axes, allows you to plot data in horizontal (X-axis) and vertical (X-axis) direction with 3 types of X-Axis +(, , and ) and 2 types of Y-Axis ( and ). ### Category X-Axis -The `CategoryXAxis` treats its data as a sequence of categorical data items. It can display almost any type of data including strings and numbers. If you are plotting numbers on this axis, it is important to keep in mind that this axis is a discrete axis and not continuous. This means that each categorical data item will be placed equidistant from the one before it. The items will also be plotted in the order that they appear in the axis' data source. +The treats its data as a sequence of categorical data items. It can display almost any type of data including strings and numbers. If you are plotting numbers on this axis, it is important to keep in mind that this axis is a discrete axis and not continuous. This means that each categorical data item will be placed equidistant from the one before it. The items will also be plotted in the order that they appear in the axis' data source. -The `CategoryXAxis` requires you to provide a `DataSource` and a `Label` in order to plot data with it. It is generally used with the `NumericYAxis` to plot the following type of series: +The requires you to provide a `DataSource` and a in order to plot data with it. It is generally used with the to plot the following type of series: | Category Series | Stacked Series | Financial Series | |------------------|----------------|--------------------| -| - `AreaSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries` | - `StackedAreaSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`



| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`



| +| -
-
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-



| -
-
-
-
-
-
-
-



| - The following example demonstrates usage of the `CategoryXAxis` type: + The following example demonstrates usage of the type: ### Category Y-Axis -The `CategoryYAxis` works very similarly to the `CategoryXAxis` described above, but it is placed vertically rather than horizontally. Also, this axis requires you to provide a `DataSource` and a `Label` in order to plot data with it. The `CategoryYAxis` is generally used with the `NumericXAxis` to plot the following type of series: +The works very similarly to the described above, but it is placed vertically rather than horizontally. Also, this axis requires you to provide a `DataSource` and a in order to plot data with it. The is generally used with the to plot the following type of series: -- `BarSeries` -- `StackedBarSeries` -- `Stacked100BarSeries` +- +- `RangeBarSeries` +- +- - The following example demonstrates usage of the `CategoryYAxis` type: + The following example demonstrates usage of the type: ### Numeric X-Axis -The `NumericXAxis` treats its data as continuously varying numerical data items. Labels on this axis are placed horizontally along the X-Axis. The location of the `NumericXAxis` labels depends on the `XMemberPath` property of the various [Scatter Series](../types/scatter-chart.md) that it supports if combined with a `NumericYAxis`. Alternatively, if combined with the `CategoryXAxis`, these labels will be placed corresponding to the `ValueMemberPath` of the `BarSeries`, `StackedBarSeries`, and `Stacked100BarSeries`. +The treats its data as continuously varying numerical data items. Labels on this axis are placed horizontally along the X-Axis. The location of the labels depends on the property of the various [Scatter Series](../types/scatter-chart.md) that it supports if combined with a . Alternatively, if combined with the , these labels will be placed corresponding to the of the , `RangeBarSeries`, , and . -The `NumericXAxis` is compatible with the following type of series: +The is compatible with the following type of series: -- `BarSeries` -- `BubbleSeries` -- `HighDensityScatterSeries` -- `ScatterSeries` -- `ScatterLineSeries` -- `ScatterSplineSeries` -- `ScatterAreaSeries` -- `ScatterContourSeries` -- `ScatterPolylineSeries` -- `ScatterPolygonSeries` -- `StackedBarSeries` -- `Stacked100BarSeries` +- +- `RangeBarSeries` +- +- +- +- +- +- +- +- +- +- +- - The following example demonstrates usage of the `NumericXAxis`: + The following example demonstrates usage of the : ### Numeric Y-Axis -The `NumericYAxis` treats its data as continuously varying numerical data items. Labels on this axis are placed vertically along the Y-Axis. The location of the `NumericYAxis` labels depends on the `YMemberPath` property of the various [ScatterSeries](../types/scatter-chart.md) that is supports if combined with a `NumericXAxis`. Alternatively, if combined with the `CategoryYAxis`, these labels will be placed corresponding to the `ValueMemberPath` of the category or stacked series mentioned in the table above. If you are using one of the financial series, they will be placed corresponding to the Open/High/Low/Close paths and the series type that you are using. +The treats its data as continuously varying numerical data items. Labels on this axis are placed vertically along the Y-Axis. The location of the labels depends on the property of the various [ScatterSeries](../types/scatter-chart.md) that is supports if combined with a . Alternatively, if combined with the , these labels will be placed corresponding to the of the category or stacked series mentioned in the table above. If you are using one of the financial series, they will be placed corresponding to the Open/High/Low/Close paths and the series type that you are using. -The `NumericYAxis` is compatible with the following type of series: +The is compatible with the following type of series: | Category Series | Stacked Series | Financial Series | Scatter Series | |------------------|----------------|------------------|----------------| -| - `AreaSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries`
| - `StackedAreaSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`
| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`
| - `BubbleSeries`
- `HighDensityScatterSeries`
- `ScatterSeries`
- `ScatterLineSeries`
- `ScatterSplineSeries`
- `ScatterAreaSeries`
- `ScatterContourSeries`
- `ScatterPolylineSeries`
- `ScatterPolygonSeries`
| +| -
-
-
-
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
-
| - The following example demonstrates usage of the `NumericYAxis`: + The following example demonstrates usage of the : ### Time X Axis -The `TimeXAxis` treats its data as a sequence of data items, sorted by date. Labels on this axis type are dates and can be formatted and arranged according to date intervals. The date range of this axis is determined by the date values in a data column that is mapped using its `DateTimeMemberPath`. This, along with a `DataSource` is required to plot data with this axis type. +The treats its data as a sequence of data items, sorted by date. Labels on this axis type are dates and can be formatted and arranged according to date intervals. The date range of this axis is determined by the date values in a data column that is mapped using its . This, along with a `DataSource` is required to plot data with this axis type. -The `TimeXAxis` is the X-Axis type in the `FinancialChart` component. +The is the X-Axis type in the component. #### Breaks in Time X Axis -The `TimeXAxis` has the option to exclude intervals of data by using `Breaks`. As a result, the labels and plotted data will not appear at the excluded interval. For example, working/non-working days, holidays, and/or weekends. An instance of `TimeAxisBreak` can be added to the `Breaks` collection of the axis and configured by using a unique `Start`, `End` and `Interval`. +The has the option to exclude intervals of data by using . As a result, the labels and plotted data will not appear at the excluded interval. For example, working/non-working days, holidays, and/or weekends. An instance of can be added to the collection of the axis and configured by using a unique , and . #### Formatting in Time X Axis -The `TimeXAxis` has the `LabelFormats` property, which represents a collection of `TimeAxisLabelFormat` objects. Each `TimeAxisLabelFormat` added to the collection is responsible for assigning a unique `Format` and `Range`. This can be especially useful for drilling down data from years to milliseconds and adjusting the labels depending on the range of time shown by the chart. +The has the property, which represents a collection of objects. Each added to the collection is responsible for assigning a unique and . This can be especially useful for drilling down data from years to milliseconds and adjusting the labels depending on the range of time shown by the chart. -The `Format` property of the `TimeAxisLabelFormat` specifies what format to use for a particular visible range. The `Range` property of the `TimeAxisLabelFormat` specifies the visible range at which the axis label formats will switch to a different format. For example, if you have two `TimeAxisLabelFormat` elements with a range set to 10 days and another set to 5 hours, then as soon as the visible range of the axis becomes less than 10 days, it will switch to 5-hour format. +The property of the specifies what format to use for a particular visible range. The property of the specifies the visible range at which the axis label formats will switch to a different format. For example, if you have two elements with a range set to 10 days and another set to 5 hours, then as soon as the visible range of the axis becomes less than 10 days, it will switch to 5-hour format. #### Intervals in Time X Axis -The `TimeXAxis` replaces the conventional `Interval` property of the category and numeric axes with an `Intervals` collection of type `TimeAxisInterval`. Each `TimeAxisInterval` added to the collection is responsible for assigning a unique `Interval`, `Range` and `IntervalType`. This can be especially useful for drilling down data from years to milliseconds to provide unique spacing between labels depending on the range of time shown by the chart. A description of these properties is below: +The replaces the conventional property of the category and numeric axes with an collection of type . Each added to the collection is responsible for assigning a unique , and . This can be especially useful for drilling down data from years to milliseconds to provide unique spacing between labels depending on the range of time shown by the chart. A description of these properties is below: -- `Interval`: This specifies the interval to use. This is tied to the `IntervalType` property. For example, if the `IntervalType` is set to `Days`, then the numeric value specified in `Interval` will be in days. -- `Range`: This specifies the visible range at which the axis interval will switch to a different interval. For example, if you have two TimeAxisInterval with a range set to 10 days and another set to 5 hours, as soon as the visible range in the axis becomes less than 10 days it will switch to the interval whose range is 5 hours. -- `IntervalType`: This specifies the unit of time for the `Interval` property. +- : This specifies the interval to use. This is tied to the property. For example, if the is set to `Days`, then the numeric value specified in will be in days. +- : This specifies the visible range at which the axis interval will switch to a different interval. For example, if you have two TimeAxisInterval with a range set to 10 days and another set to 5 hours, as soon as the visible range in the axis becomes less than 10 days it will switch to the interval whose range is 5 hours. +- : This specifies the unit of time for the property. ## Polar Axes -The `DataChart` with Polar Axes, allows you to plot data outwards (radius axis) from center of the chart and around (angle axis) of center of the chart. +The with Polar Axes, allows you to plot data outwards (radius axis) from center of the chart and around (angle axis) of center of the chart. ### Category Angle Axis -The `CategoryAngleAxis` treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. +The treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. -The `CategoryAngleAxis` is generally used with the `NumericRadiusAxis` to plot [Radial Series](../types/radial-chart.md). +The is generally used with the to plot [Radial Series](../types/radial-chart.md). -The following example demonstrates usage of the `CategoryAngleAxis` type: +The following example demonstrates usage of the type: ### Proportional Category Angle Axis -The `ProportionalCategoryAngleAxis` treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. +The treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. -The `ProportionalCategoryAngleAxis` is generally used with the `NumericRadiusAxis` to plot a pie chart eg. [Radial Series](../types/radial-chart.md). +The is generally used with the to plot a pie chart eg. [Radial Series](../types/radial-chart.md). -The following example demonstrates usage of the `ProportionalCategoryAngleAxis` type: +The following example demonstrates usage of the type: ### Numeric Angle Axis -The `NumericAngleAxis` treats its data as continuously varying numerical data items. The labels on this axis area placed along a radius line starting from the center of the circular plot. The location of the labels on the `NumericAngleAxis` varies according to the value in the data column mapped using the `RadiusMemberPath` property of the [Polar Series](../types/polar-chart.md) object or the `ValueMemberPath` property of the [Radial Series](../types/radial-chart.md) object. +The treats its data as continuously varying numerical data items. The labels on this axis area placed along a radius line starting from the center of the circular plot. The location of the labels on the varies according to the value in the data column mapped using the property of the [Polar Series](../types/polar-chart.md) object or the property of the [Radial Series](../types/radial-chart.md) object. -The The `NumericAngleAxis` can be used with either the `CategoryAngleAxis` to plot [Radial Series](../types/radial-chart.md) or with the `NumericRadiusAxis` to plot [Polar Series](../types/polar-chart.md) respectively. +The The can be used with either the to plot [Radial Series](../types/radial-chart.md) or with the to plot [Polar Series](../types/polar-chart.md) respectively. -The following example demonstrates usage of the `NumericAngleAxis` type: +The following example demonstrates usage of the type: ### Numeric Radius Axis -The `NumericRadiusAxis` treats the data as continuously varying numerical data items. The labels on this axis are placed around the circular plot. The location of the labels varies according to the value in a data column mapped using the `AngleMemberPath` property of the corresponding polar series. +The treats the data as continuously varying numerical data items. The labels on this axis are placed around the circular plot. The location of the labels varies according to the value in a data column mapped using the `AngleMemberPath` property of the corresponding polar series. -The `NumericRadiusAxis` can be used with the `NumericRadiusAxis` to plot [Polar Series](../types/polar-chart.md). +The can be used with the to plot [Polar Series](../types/polar-chart.md). -The following example demonstrates usage of the `NumericRadiusAxis` type: +The following example demonstrates usage of the type: diff --git a/docs/angular/src/content/en/components/charts/features/chart-data-annotations.mdx b/docs/angular/src/content/en/components/charts/features/chart-data-annotations.mdx index 972158fd58..500430f681 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-data-annotations.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-data-annotations.mdx @@ -11,6 +11,8 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Chart Data Annotations In the Angular chart, the data annotation layers allow you to annotate data plotted in Data Chart with sloped lines, vertical/horizontal lines (aka axis slices), vertical/horizontal strips (targeting specific axis), rectangles, and even parallelograms (aka bands). With data-binding supported, you can create as many annotations as you want to customize your charts. Also, you can combine different annotation layers and you can overlay text inside of plot area to annotated important events, patterns, and regions in your data. @@ -28,7 +30,7 @@ Like this sample? Get access to our complete Angular toolkit and start building ## Angular Data Annotation Slice Layer Example -In Angular, the `DataAnnotationSliceLayer` renders multiple vertical or horizontal lines that slice the chart at multiple values of an axis in the `DataChart` component. This data annotation layer is often used to annotate important events (e.g. company quarter reports) on x-axis or important values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal slices or setting TargetAxis property to x-axis will render data annotation layer as vertical slices. Similarly to all series, the DataAnnotationSliceLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the `AnnotationValueMemberPath` property. +In Angular, the renders multiple vertical or horizontal lines that slice the chart at multiple values of an axis in the component. This data annotation layer is often used to annotate important events (e.g. company quarter reports) on x-axis or important values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal slices or setting TargetAxis property to x-axis will render data annotation layer as vertical slices. Similarly to all series, the DataAnnotationSliceLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the property. For example, you can use DataAnnotationSliceLayer to annotate stock prices with important events such as stock split and outcome of earning reports. @@ -39,9 +41,9 @@ For example, you can use DataAnnotationSliceLayer to annotate stock prices with ## Angular Data Annotation Strip Layer Example -In Angular, the `DataAnnotationStripLayer` renders multiple vertical or horizontal strips between 2 values on an axis in the `DataChart` component. This data annotation layer can be used to annotate duration of events (e.g. stock market crash) on x-axis or important range of values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal strips or setting TargetAxis property to x-axis will render data annotation layer as vertical strips. Similarly to all series, the `DataAnnotationStripLayer` also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the AnnotationValueMemberPath property. +In Angular, the renders multiple vertical or horizontal strips between 2 values on an axis in the component. This data annotation layer can be used to annotate duration of events (e.g. stock market crash) on x-axis or important range of values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal strips or setting TargetAxis property to x-axis will render data annotation layer as vertical strips. Similarly to all series, the also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the AnnotationValueMemberPath property. -For example, you can use `DataAnnotationStripLayer` to annotate chart with stock market crashes and changes in federal interest rates. +For example, you can use to annotate chart with stock market crashes and changes in federal interest rates. @@ -50,7 +52,7 @@ For example, you can use `DataAnnotationStripLayer` to annotate chart with stock ## Angular Data Annotation Line Layer Example -In Angular, `DataAnnotationLineLayer` renders multiple lines between 2 points in plot area of the `DataChart` component. This data annotation layer can be used to annotate stock chart with growth and decline in stock prices. Similarly to all series, the DataAnnotationLineLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using using `StartValueXMemberPath` and `StartValueYMemberPath` properties and the ending points should be mapped using `EndValueXMemberPath` and `EndValueYMemberPath` properties. +In Angular, renders multiple lines between 2 points in plot area of the component. This data annotation layer can be used to annotate stock chart with growth and decline in stock prices. Similarly to all series, the DataAnnotationLineLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using using and properties and the ending points should be mapped using and properties. For example, you can use DataAnnotationLineLayer to annotate growth and decline patterns in stock prices and 52-week high and low of stock prices on y-axis. @@ -61,7 +63,7 @@ For example, you can use DataAnnotationLineLayer to annotate growth and decline ## Angular Data Annotation Rect Layer Example -In Angular, the `DataAnnotationRectLayer` renders multiple rectangles defined by starting and ending points in plot area of the `DataChart` component. This data annotation layer can be used to annotate region of plot area such as bearish patterns in stock prices. Similarly to all series, the DataAnnotationRectLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the rectangles. The starting points should be mapped using using `StartValueXMemberPath` and `StartValueYMemberPath` properties and the ending points should be mapped using `EndValueXMemberPath` and `EndValueYMemberPath` properties. +In Angular, the renders multiple rectangles defined by starting and ending points in plot area of the component. This data annotation layer can be used to annotate region of plot area such as bearish patterns in stock prices. Similarly to all series, the DataAnnotationRectLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the rectangles. The starting points should be mapped using using and properties and the ending points should be mapped using and properties. For example, you can use DataAnnotationRectLayer to annotate bearish patterns and gaps in stock prices on y-axis. @@ -72,7 +74,7 @@ For example, you can use DataAnnotationRectLayer to annotate bearish patterns an ## Angular Data Annotation Band Layer Example -In Angular, the `DataAnnotationBandLayer` renders multiple skewed rectangles (free-form parallelogram) between 2 points in plot area of the `DataChart` component. This data annotation layer can be used to annotate range of growth and decline in stock prices. Similarly to all series, the DataAnnotationBandLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using `StartValueXMemberPath` and `StartValueYMemberPath` properties and the ending points should be mapped using `EndValueXMemberPath` and `EndValueYMemberPath` properties. In addition, you can specify thickness/size of the skewed rectangle by binding numeric data column to the AnnotationBreadthMemberPath property. +In Angular, the renders multiple skewed rectangles (free-form parallelogram) between 2 points in plot area of the component. This data annotation layer can be used to annotate range of growth and decline in stock prices. Similarly to all series, the DataAnnotationBandLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using and properties and the ending points should be mapped using and properties. In addition, you can specify thickness/size of the skewed rectangle by binding numeric data column to the AnnotationBreadthMemberPath property. For example, you can use DataAnnotationBandLayer to annotate range of growth in stock prices. @@ -85,14 +87,14 @@ For example, you can use DataAnnotationBandLayer to annotate range of growth in The following is a list of API members mentioned in the above sections: -- `TargetAxis`: This property specifies which axis should have an enabled DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property specifies which axis should have an enabled DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. - `DataSource`: This property binds data to the annotation layer to provide the precise shape. -- `StartValueXMemberPath`: This property is a mapping to the name of the data column with x-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `StartValueYMemberPath`: This property is a mapping to the name of data column with y-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `EndValueXMemberPath`: This property is a mapping to the data column with x-positions for the end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `EndValueYMemberPath`: This property is a mapping to the data column with y-positions for end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `StartLabelXMemberPath`: This property is a mapping to the data column representing the overlay label for the starting position of the xAxis along the axis. -- `StartLabelXDisplayMode` | `StartLabelYDisplayMode` | `EndLabelXDisplayMode` | `EndLabelYDisplayMode` | `CenterLabelXDisplayMode`: These properties specify what should annotation labels display on starting, ending, or center of the annotation shape, e.g. mapped data value, mapped data label, axis value, or hide a given annotation label. -- `StartLabelYMemberPath`: This property is a mapping to the data column representing the axis label for the starting position of `DataAnnotationBandLayer`, `DataAnnotationLineLayer`, `DataAnnotationRectLayer` on the y-axis. -- `EndLabelYMemberPath`: This property is a mapping to the data column representing the axis label for the ending position of `DataAnnotationBandLayer`, `DataAnnotationLineLayer`, `DataAnnotationRectLayer` on the y-axis. +- : This property is a mapping to the name of the data column with x-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the name of data column with y-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the data column with x-positions for the end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the data column with y-positions for end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the data column representing the overlay label for the starting position of the xAxis along the axis. +- | | | | : These properties specify what should annotation labels display on starting, ending, or center of the annotation shape, e.g. mapped data value, mapped data label, axis value, or hide a given annotation label. +- : This property is a mapping to the data column representing the axis label for the starting position of , , on the y-axis. +- : This property is a mapping to the data column representing the axis label for the ending position of , , on the y-axis. diff --git a/docs/angular/src/content/en/components/charts/features/chart-data-legend.mdx b/docs/angular/src/content/en/components/charts/features/chart-data-legend.mdx index 53285acb0e..ba7adf0c1e 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-data-legend.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-data-legend.mdx @@ -15,37 +15,37 @@ import layoutMode from '@xplat-images/general/layout_mode.png'; # Angular Data Legend -In Ignite UI for Angular, the `DataLegend` is highly-customizable version of the `Legend`, that shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. This legend updates when moving the mouse inside of the plot area of the `CategoryChart`, `FinancialChart`, and `DataChart`. Also, it has a persistent state that remembers the last hovered point when the user's mouse pointer exits the plot area. It displays this content using a set of three type of rows (header, series, summary) and four types of columns (title, label, value, unit). +In Ignite UI for Angular, the is highly-customizable version of the , that shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. This legend updates when moving the mouse inside of the plot area of the , , and . Also, it has a persistent state that remembers the last hovered point when the user's mouse pointer exits the plot area. It displays this content using a set of three type of rows (header, series, summary) and four types of columns (title, label, value, unit). ## Angular Data Legend Rows -The rows of the `DataLegend` include the header row, series row(s), and the summary row. The header row displays the axis label of the point that is hovered, and can be changed using the `HeaderText` property. +The rows of the include the header row, series row(s), and the summary row. The header row displays the axis label of the point that is hovered, and can be changed using the property. ### Header Row -The header row displays the current label of x-axis when hovering mouse over category series and financial series. You can use `HeaderFormatDate` and `HeaderFormatTime` properties to format date and time in the `DataLegend` if the x-axis shows dates. For other types of series, the `DataLegend` does not render the header row. +The header row displays the current label of x-axis when hovering mouse over category series and financial series. You can use and properties to format date and time in the if the x-axis shows dates. For other types of series, the does not render the header row. ### Series Row -The series row represents each series plotted in the chart. These rows will display the legend badge, series title, actual/abbreviated value of the the series, and abbreviation symbol or unit of measurement, if specified. You can filter series rows by setting `IncludedSeries` or `ExcludedSeries` properties to a collection of series' indexes (1, 2, 3) or series' titles (Tesla, Microsoft). +The series row represents each series plotted in the chart. These rows will display the legend badge, series title, actual/abbreviated value of the the series, and abbreviation symbol or unit of measurement, if specified. You can filter series rows by setting or properties to a collection of series' indexes (1, 2, 3) or series' titles (Tesla, Microsoft). ### Summary Row -Finally, there is a summary row that displays the total of all series values. The default summary title can be changed using the `SummaryTitleText` property of the legend. Also, you can use the `SummaryType` property to customize whether you display the `Total`, `Min`, `Max`, or `Average` of series values in the summary row. +Finally, there is a summary row that displays the total of all series values. The default summary title can be changed using the property of the legend. Also, you can use the property to customize whether you display the , , , or of series values in the summary row. ## Angular Data Legend Columns -The columns of the `DataLegend` include the series title, label, value of data column, and optional unit associated with the value. Some series in the chart can have multiple columns for label, value, and units. For example, financial price series has **High**, **Low**, **Open**, and **Close** data columns which can be filtered in the `DataLegend` using the `IncludedColumns` or `ExcludedColumns` properties. +The columns of the include the series title, label, value of data column, and optional unit associated with the value. Some series in the chart can have multiple columns for label, value, and units. For example, financial price series has **High**, **Low**, **Open**, and **Close** data columns which can be filtered in the using the or properties. -Setting values on the `IncludedColumns` and `ExcludedColumns` properties, depends on type of series and how many data columns they support. For example, you can set `IncludedColumns` property to a collection of **Open** and **Close** strings and the legend will show only open and close values for stock prices when the chart is plotting financial series. The following table lists all column names that can be use to filter columns in data legend. +Setting values on the and properties, depends on type of series and how many data columns they support. For example, you can set property to a collection of **Open** and **Close** strings and the legend will show only open and close values for stock prices when the chart is plotting financial series. The following table lists all column names that can be use to filter columns in data legend. | Type of Series | Column Names | | -----------------|-------------- | @@ -61,20 +61,20 @@ Where the **TypicalPrice** and percentage **Change** of OHLC prices are automati ### Title Column -The title column displays legend badges and series titles, which come from the `Title` property of the different `Series` plotted in the chart. +The title column displays legend badges and series titles, which come from the property of the different plotted in the chart. ### Label Column -The label column displays short name on the left side of value column, e.g. "O" for **Open** stock price. You can toggle visibility of this column using the `LabelDisplayMode` property. +The label column displays short name on the left side of value column, e.g. "O" for **Open** stock price. You can toggle visibility of this column using the property. ### Value Column -The value column displays values of series as abbreviated text which can be formatted using the `ValueFormatAbbreviation` property to apply the same abbreviation for all numbers by setting this property to `Shared`. Alternatively, a user can select other abbreviations such as `Independent`, `Kilo`, `Million`, etc. Precision of abbreviated values is controlled using the `ValueFormatMinFractions` and `ValueFormatMaxFractions` for minimum and maximum digits, respectively. +The value column displays values of series as abbreviated text which can be formatted using the property to apply the same abbreviation for all numbers by setting this property to . Alternatively, a user can select other abbreviations such as , , , etc. Precision of abbreviated values is controlled using the and for minimum and maximum digits, respectively. ### Unit Column -The unit column displays an abbreviation symbol on the right side of value column. The unit symbol depends on the `ValueFormatAbbreviation` property, e.g. "M" for the `Million` abbreviation. +The unit column displays an abbreviation symbol on the right side of value column. The unit symbol depends on the property, e.g. "M" for the abbreviation. ### Customizing Columns @@ -88,11 +88,11 @@ You can customize text displayed in the **Label** and **Unit** columns using pr | Range Series | HighMemberAsLegendLabel="H:"
HighMemberAsLegendUnit="K"
LowMemberAsLegendLabel="L:"
LowMemberAsLegendUnit="K" | | Financial Series | OpenMemberAsLegendLabel="O:"
OpenMemberAsLegendUnit="K"
HighMemberAsLegendLabel="H:"
HighMemberAsLegendUnit="K"
LowMemberAsLegendLabel="L:"
LowMemberAsLegendUnit="K"
CloseMemberAsLegendLabel="C:"
CloseMemberAsLegendUnit="K"
| -Also, you can use the `UnitText` property on the `DataLegend` to change text displayed in all Unit columns. +Also, you can use the `UnitText` property on the to change text displayed in all Unit columns. ## Layout Mode -Legend items can be positioned in a vertical or table structure via the `LayoutMode` property. The default value is `Table`, which retains the same look and feel as seen in previous releases. +Legend items can be positioned in a vertical or table structure via the property. The default value is `Table`, which retains the same look and feel as seen in previous releases. eg. @@ -100,7 +100,7 @@ eg. ## Angular Data Legend Styling -The `DataLegend` provides properties for styling each type of column. Each of these properties begins with **Title**, **Label**, **Value**, or **Units**. You can style the text's color, font, and margin. For example, if you wanted to set the text color of all columns, you would set the `TitleTextColor`, `LabelTextColor`, `ValueTextColor`, and `UnitsTextColor` properties. The following example demonstrates a utilization of the styling properties mentioned above: +The provides properties for styling each type of column. Each of these properties begins with **Title**, **Label**, **Value**, or **Units**. You can style the text's color, font, and margin. For example, if you wanted to set the text color of all columns, you would set the , , , and properties. The following example demonstrates a utilization of the styling properties mentioned above: @@ -109,7 +109,7 @@ The `DataLegend` provides properties for styling each type of column. Each of th ## Angular Data Legend Value Formatting -The `DataLegend` provides automatic abbreviation of large numbers using its `ValueFormatAbbreviation` property. This adds a multiplier in the units column such as kilo, million, billion, etc. You can customize the number of fractional digits that are displayed by setting the `ValueFormatMinFractions` and `ValueFormatMaxFractions`. This will allow you to determine the minimum and maximum number of digits that appear after the decimal point, respectively. +The provides automatic abbreviation of large numbers using its property. This adds a multiplier in the units column such as kilo, million, billion, etc. You can customize the number of fractional digits that are displayed by setting the and . This will allow you to determine the minimum and maximum number of digits that appear after the decimal point, respectively. The following example demonstrates how to use those properties: @@ -119,7 +119,7 @@ The following example demonstrates how to use those properties: ## Angular Data Legend Value Mode -You have the ability to change the default decimal display of values within the `DataLegend` to a currency by changing the `ValueFormatMode` property. Also, you can change the culture of the displayed currency symbol by setting the `ValueFormatCulture` property a culture tag. For example, the following example data legend with the `ValueFormatCulture` set to "en-GB" to display British Pounds (£) symbol: +You have the ability to change the default decimal display of values within the to a currency by changing the property. Also, you can change the culture of the displayed currency symbol by setting the property a culture tag. For example, the following example data legend with the set to "en-GB" to display British Pounds (£) symbol: @@ -127,8 +127,8 @@ You have the ability to change the default decimal display of values within the ## Angular Data Legend Grouping -`DataLegendGroup` can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: -By default, DataLegend will hide names of groups, but you can display group names by setting the `GroupRowVisible` property to true. + can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: +By default, DataLegend will hide names of groups, but you can display group names by setting the property to true. @@ -140,21 +140,21 @@ Several properties are exposed including grouping portions of the legend. - `GroupRowMargin` - `GroupTextMargin` -- `GroupTextColor` +- - `GroupTextFontSize` - `GroupTextFontFamily` - `GroupTextFontStyle` - `GroupTextFontStretch` - `GroupTextFontWeight` - `HeaderTextMargin` -- `HeaderTextColor` +- - `HeaderTextFontSize` - `HeaderTextFontFamily` - `HeaderTextFontStyle` - `HeaderTextFontStretch` - `HeaderTextFontWeight` -The `DataLegend` has several events that fire when rendering their corresponding row, even during mouse interactions where the values are updating. These events are listed below with a description of what they are designed to be used for: +The has several events that fire when rendering their corresponding row, even during mouse interactions where the values are updating. These events are listed below with a description of what they are designed to be used for: - `StyleGroupRow`: This event fires for each group to style text displayed in group rows. - `StyleHeaderRow`: This event fires when rendering the header row. @@ -163,9 +163,9 @@ The `DataLegend` has several events that fire when rendering their corresponding - `StyleSummaryRow`: This event fires once when rendering the summary row. - `StyleSummaryColumn`: This event fires once when rendering the summary column. -Some of the events exposes a `DataLegendStylingRowEventArgs` parameter as its arguments, which lets you customize each item's text, text color, and the overall visibility of the row. The event arguments also expose event-specific properties. For example, since the `StyleSeriesRow` event fires for each series, the event arguments will return the series index and series title for the row that represents the series. +Some of the events exposes a parameter as its arguments, which lets you customize each item's text, text color, and the overall visibility of the row. The event arguments also expose event-specific properties. For example, since the `StyleSeriesRow` event fires for each series, the event arguments will return the series index and series title for the row that represents the series. -`StyleSummaryColumn` and `SeriesStyleColumn` events expose a `DataLegendStylingColumnEventArgs` parameter as its arguments, for customizing each field in the series. The event arguments also expose event-specific properties such as column index and value member related properties about the columns. +`StyleSummaryColumn` and `SeriesStyleColumn` events expose a parameter as its arguments, for customizing each field in the series. The event arguments also expose event-specific properties such as column index and value member related properties about the columns. diff --git a/docs/angular/src/content/en/components/charts/features/chart-data-selection.mdx b/docs/angular/src/content/en/components/charts/features/chart-data-selection.mdx index f8c370692e..60f331ceb4 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-data-selection.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-data-selection.mdx @@ -10,13 +10,15 @@ namespace: Infragistics.Controls.Charts import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Chart Selection The Ignite UI for Angular selection feature in Angular Data Chart allows users to interactively select, highlight, outline and vice-versa deselect single or multiple series within a chart. This provides many different possibilities with how users interact with the data presented in more meaningful ways. ## Configuring Selection -The default behavior `SelectionMode` turned off and requires opting into one of the following options. There are several selection modes available in the `DataChart`: +The default behavior turned off and requires opting into one of the following options. There are several selection modes available in the : - **Auto** - **None** @@ -32,10 +34,10 @@ The default behavior `SelectionMode` turned off and requires opting into one of - **ThickOutline** `Brighten` will fade the selected item while `FadeOthers` will cause the opposite effect occur. -`GrayscaleOthers` will behave similarly to `FadeOthers` but instead show a gray color to the rest of the series. Note this will override any `SelectionBrush` setting. +`GrayscaleOthers` will behave similarly to `FadeOthers` but instead show a gray color to the rest of the series. Note this will override any setting. `SelectionColorOutline` and `SelectionColorThickOutline` will draw a border around the series. -In conjunction, a `SelectionBehavior` is available to provide greater control on which items get selected. The default behavior for Auto is `PerSeriesAndDataItemMultiSelect`. +In conjunction, a is available to provide greater control on which items get selected. The default behavior for Auto is `PerSeriesAndDataItemMultiSelect`. - **Auto** - **PerDataItemMultiSelect** @@ -56,7 +58,7 @@ The following example shows the combination of both `SelectionColorFill` and `Au ## Configuring Multiple Selection -Other selection modes offer various methods of selection. For example using `SelectionBehavior` with `PerDataItemMultiSelect` will affect all series in entire category when multiple series are present while allowing selection across categories. Compared to `PerDataItemSingleSelect`, only a single category of items can be selected at a time. This is useful if multiple series are bound to different datasources and provides greater control of selection between categories. +Other selection modes offer various methods of selection. For example using with `PerDataItemMultiSelect` will affect all series in entire category when multiple series are present while allowing selection across categories. Compared to `PerDataItemSingleSelect`, only a single category of items can be selected at a time. This is useful if multiple series are bound to different datasources and provides greater control of selection between categories. `PerSeriesAndDataItemGlobalSingleSelect` allows single series selection across all categories at a time. @@ -64,19 +66,19 @@ Other selection modes offer various methods of selection. For example using `Sel ## Configuring Outline Selection -When `FocusBrush` is applied, selected series will appear with a border when the `SelectionMode` property is set to one of the focus options. +When is applied, selected series will appear with a border when the property is set to one of the focus options. ## Radial Series Selection -This example demonstrates another series type via the `DataChart` where each radial series can be selected with different colors. +This example demonstrates another series type via the where each radial series can be selected with different colors. ## Programmatic Selection -Chart Selection can also be configured in code where selected items in the chart can be seen on startup or runtime. This can be achieved by adding items to the `SelectedSeriesCollection` of the `CategoryChart`. The `Matcher` property of the `ChartSelection` object allows for selecting a series based on a "matcher", ideal when you do not have access to the actual series from the chart. If you know the properties that your datasource contains, you can use the `ValueMemberPath` that the series would be. +Chart Selection can also be configured in code where selected items in the chart can be seen on startup or runtime. This can be achieved by adding items to the `SelectedSeriesCollection` of the . The property of the object allows for selecting a series based on a "matcher", ideal when you do not have access to the actual series from the chart. If you know the properties that your datasource contains, you can use the `ValueMemberPath` that the series would be. -The matcher is ideal for using in charts, such as the `CategoryChart` when you do not have access to the actual series, like the `DataChart`. In this case you if you know the properties that your datasource contained you can surmise the ValueMemberPaths that the series would have. For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to highlight the series bound to Solar values, you can add a ChartSelection object to the `SelectedSeriesItems` collection using a matcher with the following properties set +The matcher is ideal for using in charts, such as the when you do not have access to the actual series, like the . In this case you if you know the properties that your datasource contained you can surmise the ValueMemberPaths that the series would have. For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to highlight the series bound to Solar values, you can add a ChartSelection object to the collection using a matcher with the following properties set For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to select the series bound to Solar values, you can add a ChartSelection object to the SelectedSeriesItems collection using a matcher with the following properties set. @@ -87,6 +89,6 @@ For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar The following is a list of API members mentioned in the above sections: -| `CategoryChart` Properties | `DataChart` Properties | +| Properties | Properties | | ----------------------------------------------|---------------------------| | | | diff --git a/docs/angular/src/content/en/components/charts/features/chart-data-tooltip.mdx b/docs/angular/src/content/en/components/charts/features/chart-data-tooltip.mdx index 11cb111f34..7694cfd55e 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-data-tooltip.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-data-tooltip.mdx @@ -46,7 +46,7 @@ The following example demonstrates the data tooltip with a summary applied: The columns of the include the title, label, value, and units columns. Each series in the chart can have multiple columns for label, value, and units depending on the or collections of the chart. -The title column displays legend badges and series titles, which come from the `Title` property of the different `Series` plotted in the chart. +The title column displays legend badges and series titles, which come from the property of the different plotted in the chart. The label column displays the name or abbreviation of the different property paths in the or collections of the tooltip. @@ -83,8 +83,8 @@ The following example demonstrates a data tooltip with the added columns of Open ## Angular Data Tooltip Grouping for Data Chart -`DataLegendGroup` can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: -By default, DataLegend will hide names of groups, but you can display group names by setting the `GroupRowVisible` property to true. `GroupingMode` should be set to "Grouped" and `LabelDisplayMode` should be set to "Visible" on the Data Tooltip Layer. + can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: +By default, DataLegend will hide names of groups, but you can display group names by setting the property to true. should be set to "Grouped" and should be set to "Visible" on the Data Tooltip Layer. @@ -119,7 +119,7 @@ You can change the default decimal display of values within the **DataToolTip** ## Layout Mode -Legend items can be positioned in a vertical or table structure via the `LayoutMode` property. The default value is `Table`, which retains the same look and feel as seen in previous releases. +Legend items can be positioned in a vertical or table structure via the property. The default value is `Table`, which retains the same look and feel as seen in previous releases. eg. @@ -138,14 +138,14 @@ The following example demonstrates usage of the styling properties mentioned abo Several properties are exposed including grouping portions of the tooltip. - `GroupTextMargin` -- `GroupTextColor` +- - `GroupTextFontSize` - `GroupTextFontFamily` - `GroupTextFontStyle` - `GroupTextFontStretch` - `GroupTextFontWeight` - `HeaderTextMargin` -- `HeaderTextColor` +- - `HeaderTextFontSize` - `HeaderTextFontFamily` - `HeaderTextFontStyle` diff --git a/docs/angular/src/content/en/components/charts/features/chart-highlight-filter.mdx b/docs/angular/src/content/en/components/charts/features/chart-highlight-filter.mdx index 45508b55c5..fd065636f6 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-highlight-filter.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-highlight-filter.mdx @@ -9,6 +9,8 @@ namespace: Infragistics.Controls.Charts import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Chart Highlight Filter The Ignite UI for Angular Chart components support a data highlighting overlay that can enhance the visualization of the series plotted in those charts by allowing you to view a subset of the data plotted. When enabled, this will highlight a subset of data while showing the total set with a reduced opacity in the case of column and area series types, and a dashed line in the case of line series types. This can help you to visualize things like target values versus actual values with your data set. This feature is demonstrated in the following example: @@ -16,45 +18,45 @@ The Ignite UI for Angular Chart components support a data highlighting overlay t -Note that data highlighting feature is supported by the `DataChart` and `CategoryChart`, but it is configured in different ways in those controls due to the nature of how those controls work. One thing remains constant with this feature though, in that you need to set the `HighlightedValuesDisplayMode` property to `Overlay` if you want to see the highlight. The following will explain the different configurations for the highlight filter feature. +Note that data highlighting feature is supported by the and , but it is configured in different ways in those controls due to the nature of how those controls work. One thing remains constant with this feature though, in that you need to set the property to `Overlay` if you want to see the highlight. The following will explain the different configurations for the highlight filter feature. ## Using Highlight Filter with DataChart -In the `DataChart`, much of the highlight filter API happens on the series themselves, mainly by setting the `HighlightedItemsSource` property to a collection representing a subset of the data you want to highlight. The count of the items in the `HighlightedItemsSource` needs to match the count of the data bound to the `ItemsSource` of the series that you are looking to highlight, and in the case of category series, it will use the `ValueMemberPath` that you have defined as the highlight path by default. The sample at the top of this page uses the `HighlightedItemsSource` in the `DataChart` to show the overlay. +In the , much of the highlight filter API happens on the series themselves, mainly by setting the property to a collection representing a subset of the data you want to highlight. The count of the items in the needs to match the count of the data bound to the of the series that you are looking to highlight, and in the case of category series, it will use the `ValueMemberPath` that you have defined as the highlight path by default. The sample at the top of this page uses the in the to show the overlay. -In the case that the schema does not match between the `HighlightedItemsSource` and the `ItemsSource` of the series, you can configure this using the `HighlightedValueMemberPath` property on the series. Additionally, if you would like to use the `ItemsSource` of the series itself as the highlight source and have a path on your data item that represents the subset, you can do this. This is done by simply setting the `HighlightedValueMemberPath` property to that path and not providing a `HighlightedItemsSource`. +In the case that the schema does not match between the and the of the series, you can configure this using the `HighlightedValueMemberPath` property on the series. Additionally, if you would like to use the of the series itself as the highlight source and have a path on your data item that represents the subset, you can do this. This is done by simply setting the `HighlightedValueMemberPath` property to that path and not providing a . -The reduced opacity of the column and area series types is configurable by setting the `HighlightedValuesFadeOpacity` property on the series. You can also set the `HighlightedValuesDisplayMode` property to `Hidden` if you do not wish to see the overlay at all. +The reduced opacity of the column and area series types is configurable by setting the property on the series. You can also set the property to `Hidden` if you do not wish to see the overlay at all. -The part of the series shown by the highlight filter will be represented in the legend and tooltip layers of the chart separately. You can configure the title that this is given in the tooltip and legend by setting the `HighlightedTitleSuffix`. This will append the value that you provide to the end of the `Title` of the series. +The part of the series shown by the highlight filter will be represented in the legend and tooltip layers of the chart separately. You can configure the title that this is given in the tooltip and legend by setting the . This will append the value that you provide to the end of the of the series. -If the `DataLegend` or `DataToolTipLayer` is used then the highlighted series will appear grouped. This can be managed by setting the `HighlightedValuesDataLegendGroup` property on the series to categorize them appropriately. +If the or is used then the highlighted series will appear grouped. This can be managed by setting the property on the series to categorize them appropriately. -The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the `DataChart` control using the `HighlightedValuesDataLegendGroup`: +The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the control using the : -The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the `DataChart` control using the `HighlightedValuesDataLegendGroup`: +The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the control using the : -The following example demonstrates the usage of the data highlighting overlay feature within the `DataChart` control using the `HighlightedValueMemberPath`: +The following example demonstrates the usage of the data highlighting overlay feature within the control using the `HighlightedValueMemberPath`: ## Using Highlight Filter in CategoryChart -The `CategoryChart` highlight filter happens on the chart by setting the `InitialHighlightFilter` property. Since the `CategoryChart` takes all of the properties on your underlying data item into account by default, you will need to define the `InitialGroups` on the chart as well so that the data can be grouped and aggregated in a way that you can have a subset of the data to filter on. You can set the `InitialGroups` to a value path in your underlying data item to group by a path that has duplicate values. +The highlight filter happens on the chart by setting the property. Since the takes all of the properties on your underlying data item into account by default, you will need to define the on the chart as well so that the data can be grouped and aggregated in a way that you can have a subset of the data to filter on. You can set the to a value path in your underlying data item to group by a path that has duplicate values. {/* Unsure of this part. Need to review */} -{/* ????? The `InitialHighlightFilter` is done using OData filter query syntax. The syntax for this is an abbreviation of the filter operator. For example, if you wanted to have an InitialHighlightFilter of "Month not equals January" it would be represented as "Month ne 'January'"*/} +{/* ????? The is done using OData filter query syntax. The syntax for this is an abbreviation of the filter operator. For example, if you wanted to have an InitialHighlightFilter of "Month not equals January" it would be represented as "Month ne 'January'"*/} -Similar to the `DataChart`, the `HighlightedValuesDisplayMode` property is also exposed on the `CategoryChart`. In the case that you do not want to see the overlay, you can set this property to `Hidden`. +Similar to the , the property is also exposed on the . In the case that you do not want to see the overlay, you can set this property to `Hidden`. -The following example demonstrates the usage of the data highlighting overlay feature within the `CategoryChart` control: +The following example demonstrates the usage of the data highlighting overlay feature within the control: @@ -76,7 +78,7 @@ You can find more information about related chart features in these topics: The following is a list of API members mentioned in the above sections: -| `CategoryChart` Properties | `DataChart` Properties | +| Properties | Properties | | ----------------------------------------------|---------------------------| | `CategoryChart.HighlightedItemsSource` | `Series.HighlightedItemsSource` | | `CategoryChart.HighlightedTitleSuffix` | `Series.HighlightedTitleSuffix` | diff --git a/docs/angular/src/content/en/components/charts/features/chart-markers.mdx b/docs/angular/src/content/en/components/charts/features/chart-markers.mdx index ceed02b757..22f2bced86 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-markers.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-markers.mdx @@ -17,7 +17,7 @@ In Ignite UI for Angular, markers are visual elements that display the values of ## Angular Chart Marker Example -In the following example, the [Line Chart](../types/line-chart.md) is comparing the generation of renewable electricity for the countries Europe, China, and USA over the years of 2009 to 2019 with markers enabled by setting the property to `Circle` enum value. +In the following example, the [Line Chart](../types/line-chart.md) is comparing the generation of renewable electricity for the countries Europe, China, and USA over the years of 2009 to 2019 with markers enabled by setting the property to enum value. The colors of the markers are also managed by setting the and properties in the sample below. The markers and is configurable in this sample by using the drop-downs as well. diff --git a/docs/angular/src/content/en/components/charts/features/chart-overlays.mdx b/docs/angular/src/content/en/components/charts/features/chart-overlays.mdx index fdec0580f2..50aceb6538 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-overlays.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-overlays.mdx @@ -27,13 +27,13 @@ The following example depicts a [Column Chart](../types/column-chart.md) with a ## Angular Value Overlay Properties -Unlike other series types that use a `ItemsSource` for data binding, the value overlay uses a property to bind a single numeric value. In addition, the value overlay requires you to define a single to use. If you use an X-axis, the value overlay will be a vertical line, and if you use a Y-axis, it will be a horizontal line. +Unlike other series types that use a for data binding, the value overlay uses a property to bind a single numeric value. In addition, the value overlay requires you to define a single to use. If you use an X-axis, the value overlay will be a vertical line, and if you use a Y-axis, it will be a horizontal line. When using a numeric X or Y axis, the property should reflect the actual numeric value on the axis where you want the value overlay to be drawn. When using a category X or Y axis, the should reflect the index of the category at which you want the value overlay to appear. When using the value overlay with a numeric angle axis, it will appear as a line from the center of the chart and when using a numeric radius axis, it will appear as a circle. - appearance properties are inherited from `Series` and so and for example are available and work the same way they do with other types of series. + appearance properties are inherited from and so and for example are available and work the same way they do with other types of series. It is also possible to show an axis annotation on a to show the value of the overlay on the owning axis. In order to show this, you can set the property to true. @@ -43,15 +43,15 @@ The Angular charting components also expose the ability to use value lines to ca Applying the in the and components is done by setting the property on the chart. This property takes a collection of the enumeration. You can mix and match multiple value layers in the same chart by adding multiple enumerations to the collection of the chart. -In the , this is done by adding a to the `Series` collection of the chart and then setting the property to one of the enumerations. Each of these enumerations and what they mean is listed below: +In the , this is done by adding a to the collection of the chart and then setting the property to one of the enumerations. Each of these enumerations and what they mean is listed below: -- `Auto`: The default value mode of the enumeration. -- `Average`: Applies potentially multiple value lines to call out the average value of each series plotted in the chart. -- `GlobalAverage`: Applies a single value line to call out the average of all of the series values in the chart. -- `GlobalMaximum`: Applies a single value line to call out the absolute maximum value of all of the series values in the chart. -- `GlobalMinimum`: Applies a single value line to call out the absolute minimum value of all of the series values in the chart. -- `Maximum`: Applies potentially multiple value lines to call out the maximum value of each series plotted in the chart. -- `Minimum`: Applies potentially multiple value lines to call out the minimum value of each series plotted in the chart. +- : The default value mode of the enumeration. +- : Applies potentially multiple value lines to call out the average value of each series plotted in the chart. +- : Applies a single value line to call out the average of all of the series values in the chart. +- : Applies a single value line to call out the absolute maximum value of all of the series values in the chart. +- : Applies a single value line to call out the absolute minimum value of all of the series values in the chart. +- : Applies potentially multiple value lines to call out the maximum value of each series plotted in the chart. +- : Applies potentially multiple value lines to call out the minimum value of each series plotted in the chart. If you want to prevent any particular series from being taken into account when using the element, you can set the property on the layer. This will force the layer to target the series that you define. You can have as many elements within a single as you want. @@ -70,7 +70,7 @@ You can also plot built-in financial overlays and indicators in Angular [Stock C The Angular , , and all Data Annotation Layers can render custom overlay text inside plot area of the DataChart component. You can use this overlay text to annotate important events (e.g. company quarter reports) on x-axis or important values on y-axis in relationship to the layers. -For example, you can use `DataAnnotationSliceLayer`, , and to show overlay text. +For example, you can use , , and to show overlay text. @@ -78,7 +78,7 @@ For example, you can use `DataAnnotationSliceLayer`, , and . +the , , and .
diff --git a/docs/angular/src/content/en/components/charts/features/chart-performance.mdx b/docs/angular/src/content/en/components/charts/features/chart-performance.mdx index 056c7aeaa2..96e8328738 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-performance.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-performance.mdx @@ -21,7 +21,7 @@ The following examples demonstrates two high performance scenarios of Angular ch ## Angular Chart with High-Frequency -In High-Frequency scenario, the Angular Charts can render data items that are updating in real time or at specified milliseconds intervals. You will experience no lag, no screen-flicker, and no visual delays, even as you interact with the chart on a touch-device. The following sample demonstrates the `CategoryChart` in High-Frequency scenario. +In High-Frequency scenario, the Angular Charts can render data items that are updating in real time or at specified milliseconds intervals. You will experience no lag, no screen-flicker, and no visual delays, even as you interact with the chart on a touch-device. The following sample demonstrates the in High-Frequency scenario. @@ -32,7 +32,7 @@ In High-Frequency scenario, the Angular Charts can render data items that are up ## Angular Chart with High-Volume -In High-Volume scenario, the Angular Charts can render 1 million of data points while the chart keeps providing smooth performance when end-users tries zooming in/out or navigating chart content. The following sample demonstrates the `CategoryChart` in High-Volume scenario. +In High-Volume scenario, the Angular Charts can render 1 million of data points while the chart keeps providing smooth performance when end-users tries zooming in/out or navigating chart content. The following sample demonstrates the in High-Volume scenario. @@ -45,7 +45,7 @@ This section lists guidelines and chart features that add to the overhead and pr ### Data Size -If you need to plot data sources with large number of data points (e.g. 10,000+), we recommend using Angular `DataChart` with one of the following type of series which where designed for specially for that purpose. +If you need to plot data sources with large number of data points (e.g. 10,000+), we recommend using Angular with one of the following type of series which where designed for specially for that purpose. - [Scatter HD Chart](../types/scatter-chart.md#angular-scatter-high-density-chart) instead of [Category Point Chart](../types/point-chart.md) or [Scatter Marker Chart](../types/scatter-chart.md#angular-scatter-marker-chart) - [Scatter Polyline Chart](../types/shape-chart.md#angular-scatter-polyline-chart) instead of [Category Line Chart](../types/line-chart.md#angular-line-chart-example) or [Scatter Line Chart](../types/scatter-chart.md#angular-scatter-line-chart) @@ -53,7 +53,7 @@ If you need to plot data sources with large number of data points (e.g. 10,000+) ### Data Structure -Although Angular charts support rendering of multiple data sources by binding array of arrays of data points to `ItemsSource` property. It is much faster for charts if multiple data sources are flatten into single data source where each data item contains multiple data columns rather just one data column. For example: +Although Angular charts support rendering of multiple data sources by binding array of arrays of data points to property. It is much faster for charts if multiple data sources are flatten into single data source where each data item contains multiple data columns rather just one data column. For example: @@ -90,7 +90,7 @@ export class MultiDataSources { ### Data Filtering -Angular `CategoryChart` and the `FinancialChart` controls have built-in data adapter that analyzes your data and generates chart series for you. However, it works faster if you use `IncludedProperties` and `ExcludedProperties` to filter only those data columns that you actually want to render. For example, +Angular and the controls have built-in data adapter that analyzes your data and generates chart series for you. However, it works faster if you use and to filter only those data columns that you actually want to render. For example, @@ -107,7 +107,7 @@ this.Chart.excludedProperties = [ "CHN", "FRN", "GER" ]; ### Chart Types -Simpler chart types such as [Line Chart](../types/line-chart.md) have faster performance than using [Spline Chart](../types/spline-chart.md) because of the complex interpolation of spline lines between data points. Therefore, you should use `CategoryChart.ChartType` property of Angular `CategoryChart` or the `FinancialChart` control to select type of chart that renders faster. Alternatively, you can change a type of series to a faster series in Angular `DataChart` control. +Simpler chart types such as [Line Chart](../types/line-chart.md) have faster performance than using [Spline Chart](../types/spline-chart.md) because of the complex interpolation of spline lines between data points. Therefore, you should use `CategoryChart.ChartType` property of Angular or the control to select type of chart that renders faster. Alternatively, you can change a type of series to a faster series in Angular control. The following table lists chart types in order from the fastest performance to slower performance in each group of charts: @@ -166,7 +166,7 @@ this.LineSeries.markerType = MarkerType.None; ### Chart Resolution -Setting the `Resolution` property to a higher value will improve performance, but it will lower the graphical fidelity of lines of plotted series. As such, it can be increased up until the fidelity is unacceptable. +Setting the property to a higher value will improve performance, but it will lower the graphical fidelity of lines of plotted series. As such, it can be increased up until the fidelity is unacceptable. This code snippet shows how to decrease resolution in the Angular charts. @@ -196,10 +196,10 @@ Enabling [Chart Trendlines](chart-trendlines.md) will slightly decrease performa Usage of x-axis with DateTime support is not recommended if spaces between data points, based on the amount of time span between them, are not important. Instead, ordinal/category axis should be used because it is more efficient in the way it coalesces data. Also, ordinal/category axis doesn’t perform any sorting on the data like the time-based x-axis does. -The `CategoryChart` already uses ordinal/category axis so there is no need to change its properties. +The already uses ordinal/category axis so there is no need to change its properties. -This code snippet shows how to ordinal/category x-axis in the `FinancialChart` and `DataChart` controls. +This code snippet shows how to ordinal/category x-axis in the and controls. @@ -221,7 +221,7 @@ This code snippet shows how to ordinal/category x-axis in the `FinancialChart` a ### Axis Intervals -By default, Angular charts will automatically calculate `YAxisInterval` based on range of your data. Therefore, you should avoid setting axis interval especially to a small value to prevent rendering of too many of axis gridlines and axis labels. Also, you might want to consider increasing `YAxisInterval` property to a larger value than the automatically calculated axis interval if you do not need many axis gridlines or axis labels. +By default, Angular charts will automatically calculate based on range of your data. Therefore, you should avoid setting axis interval especially to a small value to prevent rendering of too many of axis gridlines and axis labels. Also, you might want to consider increasing property to a larger value than the automatically calculated axis interval if you do not need many axis gridlines or axis labels. We do not recommend setting axis minor interval as it will decrease chart performance. @@ -252,7 +252,7 @@ This code snippet shows how to set axis major interval in the Angular charts. ### Axis Scale -Setting the `YAxisIsLogarithmic` property to false is recommended for higher performance, as fewer operations are needed than calculating axis range and values of axis labels in logarithmic scale. +Setting the property to false is recommended for higher performance, as fewer operations are needed than calculating axis range and values of axis labels in logarithmic scale. ### Axis Labels Visibility @@ -285,7 +285,7 @@ This code snippet shows how to hide axis labels in the Angular charts. ### Axis Labels Abbreviation -Although, the Angular charts support abbreviation of large numbers (e.g. 10,000+) displayed in axis labels when `YAxisAbbreviateLargeNumbers` is set to true. We recommend, instead pre-processing large values in your data items by dividing them a common factor and then setting `YAxisTitle` to a string that represents factor used used to abbreviate your data values. +Although, the Angular charts support abbreviation of large numbers (e.g. 10,000+) displayed in axis labels when is set to true. We recommend, instead pre-processing large values in your data items by dividing them a common factor and then setting to a string that represents factor used used to abbreviate your data values. This code snippet shows how to set axis title in the Angular charts. @@ -340,78 +340,78 @@ The following code snippet shows how to set a fixed extent for labels on y-axis Enabling additional axis visuals (e.g. axis titles) or changing their default values might decrease performance in the Angular charts. -For example, changing these properties on the `CategoryChart` or `FinancialChart` control: +For example, changing these properties on the or control: | Axis Visual | X-Axis Properties | Y-Axis Properties | | ---------------------|-------------------|------------------- | -| All Axis Visual | `XAxisInterval`
`XAxisMinorInterval` | `YAxisInterval`
`YAxisMinorInterval` | -| Axis Tickmarks | `XAxisTickStroke`
`XAxisTickStrokeThickness`
`XAxisTickLength`
| `YAxisTickStroke`
`YAxisTickStrokeThickness`
`YAxisTickLength`
| -| Axis Major Gridlines | `XAxisMajorStroke`
`XAxisMajorStrokeThickness`
| `YAxisMajorStroke`
`YAxisMajorStrokeThickness`
| -| Axis Minor Gridlines | `XAxisMinorStroke`
`XAxisMinorStrokeThickness`
| `YAxisMinorStroke`
`YAxisMinorStrokeThickness`
| -| Axis Main Line | `XAxisStroke`
`XAxisStrokeThickness`
| `YAxisStroke`
`YAxisStrokeThickness`
| -| Axis Titles | `XAxisTitle`
`XAxisTitleAngle`
| `YAxisTitle`
`YAxisTitleAngle`
| -| Axis Strips | `XAxisStrip`
| `YAxisStrip`
| +| All Axis Visual |
|
| +| Axis Tickmarks |


|


| +| Axis Major Gridlines |

|

| +| Axis Minor Gridlines |

|

| +| Axis Main Line |

|

| +| Axis Titles |

|

| +| Axis Strips |
|
| -Or changing properties of an `Axis` in the `DataChart` control: +Or changing properties of an in the control: | Axis Visual | Axis Properties | | ---------------------|------------------- | | All Axis Visuals | `Interval`, `MinorInterval` | -| Axis Tickmarks | `TickStroke` , `TickStrokeThickness`, `TickLength` | -| Axis Major Gridlines | `MajorStroke`, `MajorStrokeThickness` | -| Axis Minor Gridlines | `MinorStroke`, `MinorStrokeThickness` | -| Axis Main Line | `Stroke`, `StrokeThickness` | -| Axis Titles | `Title`, `TitleAngle` | -| Axis Strips | `Strip` | +| Axis Tickmarks | , , | +| Axis Major Gridlines | , | +| Axis Minor Gridlines | , | +| Axis Main Line | , | +| Axis Titles | , `TitleAngle` | +| Axis Strips | | ## Performance in Financial Chart -In addition to above performance guidelines, the Angular `FinancialChart` control has the following unique features that affect performance. +In addition to above performance guidelines, the Angular control has the following unique features that affect performance. ### Y-Axis Mode -Setting the `YAxisMode` option to `Numeric` is recommended for higher performance, as fewer operations are needed than using `PercentChange` mode. +Setting the option to `Numeric` is recommended for higher performance, as fewer operations are needed than using mode. ### Chart Panes -Setting a lot of panes using `IndicatorTypes` and `OverlayTypes` options, might decrease performance and it is recommended to use a few financial indicators and one financial overlay. +Setting a lot of panes using and options, might decrease performance and it is recommended to use a few financial indicators and one financial overlay. ### Zoom Slider -Setting the `ZoomSliderType` option to `None` will improve chart performance and enable more vertical space for other indicators and the volume pane. +Setting the option to will improve chart performance and enable more vertical space for other indicators and the volume pane. ### Volume Type -Setting the `VolumeType` property can have the following impact on chart performance: +Setting the property can have the following impact on chart performance: -- `None` - is the least expensive since it does not display the volume pane. -- `Line` - is more expensive volume type to render and it is recommended when rendering a lot of data points or when plotting a lot of data sources. -- `Area` - is more expensive to render than the `Line` volume type. -- `Column` - is more expensive to render than the `Area` volume type and it is recommended when rendering volume data of 1-3 stocks. +- - is the least expensive since it does not display the volume pane. +- - is more expensive volume type to render and it is recommended when rendering a lot of data points or when plotting a lot of data sources. +- - is more expensive to render than the volume type. +- - is more expensive to render than the volume type and it is recommended when rendering volume data of 1-3 stocks. ## Performance in Data Chart -In addition to the general performance guidelines, the Angular `DataChart` control has the following unique features that affect performance. +In addition to the general performance guidelines, the Angular control has the following unique features that affect performance. ### Axes Collection -Adding too many axis to the `Axes` collection of the `DataChart` control will decrease chart performance and we recommend [Sharing Axes](chart-axis-layouts.md#axis-sharing-example) between series. +Adding too many axis to the collection of the control will decrease chart performance and we recommend [Sharing Axes](chart-axis-layouts.md#axis-sharing-example) between series. ### Series Collection -Also, adding a lot of series to the `Series` collection of the Angular `DataChart` control will add overhead to rendering because each series has its own rendering canvas. This is especially important if you have more than 10 series in the Data Chart. We recommend combining multiple data sources into flatten data source (see [Data Structure](#data-structure) section) and then using conditional styling feature of the following series: +Also, adding a lot of series to the collection of the Angular control will add overhead to rendering because each series has its own rendering canvas. This is especially important if you have more than 10 series in the Data Chart. We recommend combining multiple data sources into flatten data source (see [Data Structure](#data-structure) section) and then using conditional styling feature of the following series: | Slower Performance Scenario | Faster Scenario with Conditional Styling | | ----------------------------|---------------------------------------- | -| 10+ of `LineSeries` | Single `ScatterLineSeries` | -| 20+ of `LineSeries` | Single `ScatterPolylineSeries` | -| 10+ of `ScatterLineSeries` | Single `ScatterPolylineSeries` | -| 10+ of `PointSeries` | Single `ScatterSeries` | -| 20+ of `PointSeries` | Single `HighDensityScatterSeries` | -| 20+ of `ScatterSeries` | Single `HighDensityScatterSeries` | -| 10+ of `AreaSeries` | Single `ScatterPolygonSeries` | -| 10+ of `ColumnSeries` | Single `ScatterPolygonSeries` | +| 10+ of | Single | +| 20+ of | Single | +| 10+ of | Single | +| 10+ of | Single | +| 20+ of | Single | +| 20+ of | Single | +| 10+ of | Single | +| 10+ of | Single | ## Additional Resources diff --git a/docs/angular/src/content/en/components/charts/features/chart-titles.mdx b/docs/angular/src/content/en/components/charts/features/chart-titles.mdx index 63b5f945be..981501e897 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-titles.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-titles.mdx @@ -28,20 +28,20 @@ When adding a title or subtitle to the chart control, the content of the chart a | Property Name | Property Type | Description | | ----------------------|------------------|------------| | `ChartTitle` | string | Title's text content. | -| `TitleTextColor` | string | Title's text. color | -| `TitleAlignment` | HorizontalAlignment | Title's horizontal alignment. | -| `TitleTextStyle` | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | -| `TitleTopMargin` | number | Title's top margin. | -| `TitleLeftMargin` | number | Title's left margin. | -| `TitleRightMargin` | number | Title's right margin. | -| `TitleBottomMargin` | number | Title's bottom margin. | -| `Subtitle` | string | Title's text content. | -| `SubtitleTextColor` | string | Title's text. color | -| `SubtitleAlignment` | HorizontalAlignment | Title's horizontal alignment. | -| `SubtitleTextStyle` | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | -| `SubtitleTopMargin` | number | Title's top margin. | -| `SubtitleLeftMargin` | number | Title's left margin. | -| `SubtitleRightMargin` | number | Title's right margin. | -| `SubtitleBottomMargin`| number | Title's bottom margin. | +| | string | Title's text. color | +| | HorizontalAlignment | Title's horizontal alignment. | +| | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | +| | number | Title's top margin. | +| | number | Title's left margin. | +| | number | Title's right margin. | +| | number | Title's bottom margin. | +| | string | Title's text content. | +| | string | Title's text. color | +| | HorizontalAlignment | Title's horizontal alignment. | +| | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | +| | number | Title's top margin. | +| | number | Title's left margin. | +| | number | Title's right margin. | +| | number | Title's bottom margin. | diff --git a/docs/angular/src/content/en/components/charts/features/chart-tooltips.mdx b/docs/angular/src/content/en/components/charts/features/chart-tooltips.mdx index 4e465cd57e..9d1c395cbd 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-tooltips.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-tooltips.mdx @@ -29,10 +29,10 @@ The Tooltip | Display a tooltip for a single item when the pointer is positioned over it. | +| Tooltip | Display the data tooltips for all series in the chart. | +| Tooltip | Display a tooltip for each data item in the category that the pointer is positioned over. | +| Tooltip | Display a grouped tooltip for all data points in the category that the pointer is positioned over. |
diff --git a/docs/angular/src/content/en/components/charts/features/chart-trendlines.mdx b/docs/angular/src/content/en/components/charts/features/chart-trendlines.mdx index aaf9ee8304..3026745b3a 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-trendlines.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-trendlines.mdx @@ -30,7 +30,7 @@ The following sample depicts a sh ## Angular Chart Trendlines Dash Array Example -The following sample depicts a showing a `FinancialPriceSeries` with a **QuarticFit** dashed trendline applied via the property: +The following sample depicts a showing a with a **QuarticFit** dashed trendline applied via the property: @@ -40,7 +40,7 @@ The following sample depicts a showing ## Angular Chart Trendline Layer -The is a series type that is designed to display a single trendline type for a target series. The difference between this and the existing trendline features on the existing series types is that since the is a series type, you can add more than one of them to the `Series` collection of the chart to have multiple trendlines attached to the same series. You can also have the trendline appear in the legend, which was not possible previously. +The is a series type that is designed to display a single trendline type for a target series. The difference between this and the existing trendline features on the existing series types is that since the is a series type, you can add more than one of them to the collection of the chart to have multiple trendlines attached to the same series. You can also have the trendline appear in the legend, which was not possible previously. ## Trendline Layer Usage @@ -52,7 +52,7 @@ If you would like to show the in By default, the renders with the same color as its in a dashed line. This can be configured by using the various styling properties on the . -To change the color of the trendline that is drawn, you can set its property. Alternatively, you can also set the property to `true`, which will pull from the chart's `Brushes` palette based on the index in which the is placed in the chart's `Series` collection. +To change the color of the trendline that is drawn, you can set its property. Alternatively, you can also set the property to `true`, which will pull from the chart's palette based on the index in which the is placed in the chart's collection. You can also modify the way that the appears by using its and properties. The takes a value between -1.0 and 1.0 to determine how much of a "shift" to apply to the options that end in "Shift". diff --git a/docs/angular/src/content/en/components/charts/features/chart-user-annotations.mdx b/docs/angular/src/content/en/components/charts/features/chart-user-annotations.mdx index fca702f12a..ce81b915c6 100644 --- a/docs/angular/src/content/en/components/charts/features/chart-user-annotations.mdx +++ b/docs/angular/src/content/en/components/charts/features/chart-user-annotations.mdx @@ -19,7 +19,7 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; In Ignite UI for Angular, you can annotate the with slice, strip, and point annotations at runtime using the user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. The following topic explains, with examples, how you can utilize the `Toolbar` to add user annotations to the plot area of the chart, as well as how to do add these user annotations programmatically. +This is directly integrated with the available tools of the . The following topic explains, with examples, how you can utilize the to add user annotations to the plot area of the chart, as well as how to do add these user annotations programmatically. @@ -30,7 +30,7 @@ This feature is designed to support X and Y axes and does not currently support ## Using the User Annotations with the Toolbar -The `Toolbar` exposes an Annotations menu item with two tools with the labels of "Annotate Chart" and "Delete Note." In order for this menu item to appear, you first need to set the property on the corresponding chart to `true`. +The exposes an Annotations menu item with two tools with the labels of "Annotate Chart" and "Delete Note." In order for this menu item to appear, you first need to set the property on the corresponding chart to `true`. The "Annotate Chart" option that appears after opening allows you to annotate the plot area of the . This can be done by adding slice, strip, or point annotations. You can add a slice annotation by clicking on a label on the X or Y axis. You can add a strip annotation by clicking and dragging in the plot area. Also, you can add a point annotation by clicking on a point in a series plotted in the chart. @@ -40,34 +40,34 @@ You can delete the annotations that you have previously added by selecting the " Angular user-annotation-delete -When adding one of these user annotations via the `Toolbar`, the will raise an event named `UserAnnotationInformationRequested` where you can provide more information for the user annotations. This event's arguments have a property named `AnnotationInfo` that will return a object that allows the configuration of multiple different aspects of the annotation to be added. +When adding one of these user annotations via the , the will raise an event named `UserAnnotationInformationRequested` where you can provide more information for the user annotations. This event's arguments have a property named `AnnotationInfo` that will return a object that allows the configuration of multiple different aspects of the annotation to be added. The table below details the different configurable properties on : | Property | Type | Description | |------------|---------|-------------| -|`AnnotationData`|`string`|This property allows additional information for the user annotation. This property is designed to be utilized with the `UserAnnotationToolTipContentUpdating` event to show additional information in the annotation's tooltip.| -|`AnnotationId`|`string`|This read-only property returns the unique string ID of the user annotation.| -|`BadgeColor`|`string`|This property gets or sets the color to use for the badge in the user annotation.| -|`BadgeImageUri`|`string`|This property gets or sets a path to an image to use for the badge in the user annotation.| -|`DialogSuggestedXLocation`|`double`|This property gets a recommended X location to show a dialog based on the location that the user annotation was added.| -|`DialogSuggestedYLocation`|`double`|This property gets a recommended Y location to show a dialog based on the location that the user annotation was added.| -|`Label`|`string`|This property gets or sets the label to be shown in the user annotation.| -|`MainColor`|`string`|This property gets or sets the color to be used to fill the background of the user annotation.| +||`string`|This property allows additional information for the user annotation. This property is designed to be utilized with the `UserAnnotationToolTipContentUpdating` event to show additional information in the annotation's tooltip.| +||`string`|This read-only property returns the unique string ID of the user annotation.| +||`string`|This property gets or sets the color to use for the badge in the user annotation.| +||`string`|This property gets or sets a path to an image to use for the badge in the user annotation.| +||`double`|This property gets a recommended X location to show a dialog based on the location that the user annotation was added.| +||`double`|This property gets a recommended Y location to show a dialog based on the location that the user annotation was added.| +||`string`|This property gets or sets the label to be shown in the user annotation.| +||`string`|This property gets or sets the color to be used to fill the background of the user annotation.| -After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the `FinishAnnotationFlow` method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling `CancelAnnotationFlow` and passing the `AnnotationId` of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. +After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling and passing the of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. ## Using the User Annotations Programmatically -When using the programmatically, you can invoke two different methods on the to put the chart into a mode where you can add or remove a user annotation. These methods are named `StartCreatingAnnotation` and `StartDeletingAnnotation`, respectively. +When using the programmatically, you can invoke two different methods on the to put the chart into a mode where you can add or remove a user annotation. These methods are named and , respectively. -After invoking `StartCreatingAnnotation`, you can add a slice annotation by clicking on a label on the X or Y axis, add a strip annotation by clicking and dragging in the plot area and releasing the mouse button, or add a point annotation by clicking on a data point on a series plotted in the chart. +After invoking , you can add a slice annotation by clicking on a label on the X or Y axis, add a strip annotation by clicking and dragging in the plot area and releasing the mouse button, or add a point annotation by clicking on a data point on a series plotted in the chart. Adding one of these user annotations will raise an event named `UserAnnotationInformationRequested`, where you can provide more information for the user annotation. This event's arguments have a property named `AnnotationInfo` that will return a object that allows the configuration of multiple different aspects of the annotation to be added. -After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the `FinishAnnotationFlow` method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling `CancelAnnotationFlow` and passing the `AnnotationId` of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. +After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling and passing the of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. -Once the user annotation has been added to the chart, it will appear in the `Series` collection as a . The has an `Annotations` collection that can store , and elements depending on the type of annotations added to the plot area. +Once the user annotation has been added to the chart, it will appear in the collection as a . The has an collection that can store , and elements depending on the type of annotations added to the plot area. ## User Annotation ToolTip diff --git a/docs/angular/src/content/en/components/charts/types/area-chart.mdx b/docs/angular/src/content/en/components/charts/types/area-chart.mdx index ae18f82bcb..e32c7efbf3 100644 --- a/docs/angular/src/content/en/components/charts/types/area-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/area-chart.mdx @@ -58,7 +58,7 @@ There are several common use cases for choosing an Area Chart: ## Angular Area Chart with Single Series -Angular Area Chart is often used to show the change of value over time such as the amount of renewable electricity produced. You can create this type of chart in control by binding your data and setting property to `Area` value, as shown in the example below. +Angular Area Chart is often used to show the change of value over time such as the amount of renewable electricity produced. You can create this type of chart in control by binding your data and setting property to value, as shown in the example below. @@ -93,7 +93,7 @@ The following sections explain more advanced types of Angular Area Charts that c ## Angular Step Area Chart -The Angular Step Area Chart belongs to a group of category charts and it is rendered using a collection of points connected by continuous vertical and horizontal lines with the area below lines filled in. Values are represented on the y-axis and categories are displayed on the x-axis. The step area chart emphasizes the amount of change over a period of time or compares multiple items. You can create this type of chart in control by binding your data and setting property to `StepArea` value, as shown in the example below. +The Angular Step Area Chart belongs to a group of category charts and it is rendered using a collection of points connected by continuous vertical and horizontal lines with the area below lines filled in. Values are represented on the y-axis and categories are displayed on the x-axis. The step area chart emphasizes the amount of change over a period of time or compares multiple items. You can create this type of chart in control by binding your data and setting property to value, as shown in the example below. @@ -212,16 +212,16 @@ The following table lists API members mentioned in above sections: | Chart Type | Control Name | API Members | | -------------------------|-----------------|-----------------------| -| Area | `CategoryChart` | `CategoryChart.ChartType` = `Area` | -| Step Area | `CategoryChart` | `CategoryChart.ChartType` = `StepArea` | -| Range Area | `DataChart` | `RangeAreaSeries` | -| Radial Area | `DataChart` | `RadialAreaSeries` | -| Polar Area | `DataChart` | `PolarAreaSeries` | -| Polar Spline Area | `DataChart` | `PolarSplineAreaSeries` | -| Stacked Area | `DataChart` | `StackedAreaSeries` | -| Stacked Spline Area | `DataChart` | `StackedSplineAreaSeries` | -| Stacked 100% Area | `DataChart` | `Stacked100AreaSeries` | -| Stacked 100% Spline Area | `DataChart` | `Stacked100SplineAreaSeries` | +| Area | | `CategoryChart.ChartType` = | +| Step Area | | `CategoryChart.ChartType` = | +| Range Area | | | +| Radial Area | | | +| Polar Area | | | +| Polar Spline Area | | | +| Stacked Area | | | +| Stacked Spline Area | | | +| Stacked 100% Area | | | +| Stacked 100% Spline Area | | | ## API References diff --git a/docs/angular/src/content/en/components/charts/types/column-chart.mdx b/docs/angular/src/content/en/components/charts/types/column-chart.mdx index 28833a143a..91dbe37c22 100644 --- a/docs/angular/src/content/en/components/charts/types/column-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/column-chart.mdx @@ -178,12 +178,12 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | --------------------|--------------------|------------------------| -| Column | `CategoryChart` | `CategoryChart.ChartType` = **Column** | -| Radial Column | `DataChart` | `RadialColumnSeries` | -| Range Column | `DataChart` | `RangeColumnSeries` | -| Stacked Column | `DataChart` | `StackedColumnSeries` | -| Stacked 100% Column | `DataChart` | `Stacked100ColumnSeries` | -| Waterfall | `DataChart` | `WaterfallSeries` | +| Column | | `CategoryChart.ChartType` = **Column** | +| Radial Column | | | +| Range Column | | | +| Stacked Column | | | +| Stacked 100% Column | | | +| Waterfall | | |

diff --git a/docs/angular/src/content/en/components/charts/types/composite-chart.mdx b/docs/angular/src/content/en/components/charts/types/composite-chart.mdx index f4d8e56631..4bbc17fa6a 100644 --- a/docs/angular/src/content/en/components/charts/types/composite-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/composite-chart.mdx @@ -15,7 +15,7 @@ The Ignite UI for Angular Composite Chart, also called a Combo Chart, is visuali ## Angular Composite / Combo Example -The following example demonstrates how to create Composite Chart using `ColumnSeries` and `LineSeries` in the control. +The following example demonstrates how to create Composite Chart using and in the control. diff --git a/docs/angular/src/content/en/components/charts/types/data-pie-chart.mdx b/docs/angular/src/content/en/components/charts/types/data-pie-chart.mdx index 89de21ac7d..d0bdab3920 100644 --- a/docs/angular/src/content/en/components/charts/types/data-pie-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/data-pie-chart.mdx @@ -79,7 +79,7 @@ The Others category in the has thre The property works in tandem with the property of the . For the , you can define whether you want the to be evaluated as a number or a percentage. For example, if you decide on number and set the to 5, any slices that have a value less than 5 will become part of the Others category. Using the same value of 5 with a percent type, any values that are less than 5 percent of the total values of the will become part of the Others category. -To get the underlying data items that are contained within the Others slice in the chart, you can utilize the `GetOthersContext` method on the chart. This return type of this method is an `OthersCategoryContext` which exposes an `Items` property. The `Items` property returns an array that will contain the items in the Others slice. Additionally, when clicking the Others slice, the `Item` property of the event arguments for the `SeriesClick` event will be will also return this `OthersCategoryContext`. +To get the underlying data items that are contained within the Others slice in the chart, you can utilize the method on the chart. This return type of this method is an which exposes an property. The property returns an array that will contain the items in the Others slice. Additionally, when clicking the Others slice, the `Item` property of the event arguments for the `SeriesClick` event will be will also return this . By default, the Others slice will be represented by a label of "Others." You can change this by modifying the property of the chart. @@ -112,21 +112,21 @@ The following sample demonstrates usage of the Others slice in the supports slice selection by mouse click on the slices plotted in the chart. This can be configured by utilizing the and properties of the chart, described below: -The main two options of the are `PerDataItemSingleSelect` and `PerDataItemMultiSelect`, which will enable single and multiple selection, respectively. +The main two options of the are and , which will enable single and multiple selection, respectively. The property exposes an enumeration that determines how the pie chart slices respond to being selected. The following are the options of that enumeration and what they do: -- `Brighten`: The selected slices will be highlighted. -- `FadeOthers`: The selected slices will remain their same color and others will fade. -- `FocusColorFill`: The selected slices will change their background to the FocusBrush of the chart. -- `FocusColorOutline`: The selected slices will have an outline with the color defined by the FocusBrush of the chart. -- `FocusColorThickOutline`: The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. -- `GrayscaleOthers`: The unselected slices will have a gray color filter applied to them. -- `None`: There is no effect on the selected slices. -- `SelectionColorFill`: The selected slices will change their background to the SelectionBrush of the chart. -- `SelectionColorOutline`: The selected slices will have an outline with the color defined by the SelectionBrush of the chart. -- `SelectionColorThickOutline`: The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. -- `ThickOutline`: The selected slices will apply an outline with the thickness dependent on the Thickness property of the chart. +- : The selected slices will be highlighted. +- : The selected slices will remain their same color and others will fade. +- : The selected slices will change their background to the FocusBrush of the chart. +- : The selected slices will have an outline with the color defined by the FocusBrush of the chart. +- : The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. +- : The unselected slices will have a gray color filter applied to them. +- : There is no effect on the selected slices. +- : The selected slices will change their background to the SelectionBrush of the chart. +- : The selected slices will have an outline with the color defined by the SelectionBrush of the chart. +- : The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. +- : The selected slices will apply an outline with the thickness dependent on the Thickness property of the chart. When a slice is selected, its underlying data item will be added to the SelectedSeriesItems collection of the chart. As such, the DataPieChart exposes the SelectedSeriesItemsChanged event to detect when a slice has been selected and this collection is changed. @@ -143,18 +143,18 @@ The supports mouse over highlightin First, the enumerated property determines how a slice will be highlighted. The following are the options of that property and what they do: -- `DirectlyOver`: The slices are only highlighted when the mouse is directly over them. -- `NearestItems`: The nearest slice to the mouse position will be highlighted. -- `NearestItemsAndSeries`: The nearest slice and series to the mouse position will be highlighted. -- `NearestItemsRetainMainShapes`: The nearest items to the mouse position will be highlighted and the main shapes of the series will not be de-emphasized. +- : The slices are only highlighted when the mouse is directly over them. +- : The nearest slice to the mouse position will be highlighted. +- : The nearest slice and series to the mouse position will be highlighted. +- : The nearest items to the mouse position will be highlighted and the main shapes of the series will not be de-emphasized. The enumerated property determines how the data pie chart slices respond to being highlighted. The following are the options of that property and what they do: -- `Brighten`: The series will have its color brightened when the mouse position is over or near it. +- : The series will have its color brightened when the mouse position is over or near it. - `BrightenSpecific`: The specific slice will have its color brightened when the mouse position is over or near it. -- `FadeOthers`: The series will retain its color when the mouse position is over or near it, while the others will appear faded. +- : The series will retain its color when the mouse position is over or near it, while the others will appear faded. - `FadeOthersSpecific`: The specific slice will retain its color when the mouse position is over or near it, while the others will appear faded. -- `None`: The series and slices will not be highlighted. +- : The series and slices will not be highlighted. The following example demonstrates the mouse highlighting behaviors of the component: diff --git a/docs/angular/src/content/en/components/charts/types/line-chart.mdx b/docs/angular/src/content/en/components/charts/types/line-chart.mdx index 32d878accf..655f445d2c 100644 --- a/docs/angular/src/content/en/components/charts/types/line-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/line-chart.mdx @@ -15,7 +15,7 @@ The Ignite UI for Angular Line Chart or Line Graph is a type of category charts ## Angular Line Chart Example -You can create the Angular Line Chart in the control by binding your data to property and setting property to `Line` enum, as shown in the example below. +You can create the Angular Line Chart in the control by binding your data to property and setting property to enum, as shown in the example below. @@ -73,7 +73,7 @@ There are several common use cases for choosing a Line Chart: The Angular Line Chart is often used to show the change of value over time such as the amount of renewable electricity produced since 2009 over a ten-year period, as we have shown in the example below. -You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -86,7 +86,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -101,7 +101,7 @@ The Angular Line chart is capable of handling high volumes of data, ranging into In this example, we are streaming live data into the Angular Line Chart at an interval of your choosing. You can set the data points from 5,000 to 1 million and update the chart to optimize the scale based on the device you are rendering the chart on. -You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -114,7 +114,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -200,11 +200,11 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | ------------------|--------------------|----------------------- | -| Line | `CategoryChart` | `CategoryChart.ChartType` = `Line` | -| Polar Line | `DataChart` | `PolarLineSeries` | -| Radial Line | `DataChart` | `RadialLineSeries` | -| Stacked Line | `DataChart` | `StackedLineSeries` | -| Stacked 100% Line | `DataChart` | `Stacked100LineSeries` | +| Line | | `CategoryChart.ChartType` = | +| Polar Line | | | +| Radial Line | | | +| Stacked Line | | | +| Stacked 100% Line | | |

diff --git a/docs/angular/src/content/en/components/charts/types/pie-chart.mdx b/docs/angular/src/content/en/components/charts/types/pie-chart.mdx index a04ba1c331..9c85b5d0d3 100644 --- a/docs/angular/src/content/en/components/charts/types/pie-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/pie-chart.mdx @@ -107,7 +107,7 @@ The pie chart supports explosion of individual pie slices as well as a `SliceCli
## Angular Pie Chart Selection -The pie chart supports slice selection by mouse click as the default behavior. You can determine the selected slices by using the `SelectedItems` property. The selected slices are then highlighted. +The pie chart supports slice selection by mouse click as the default behavior. You can determine the selected slices by using the property. The selected slices are then highlighted. There is a property called which is how you set what mode you want the pie chart to use. The default value is `Single`. In order to disable selection, set the property to `Manual`. @@ -125,7 +125,7 @@ The pie chart has 4 events associated with selection: The events that end in "Changing" are cancelable events which means you can stop the selection of a slice by setting the event argument property `Cancel` to true. When set to true the associated property will not update and the slice will not become selected. This is useful for scenarios where you want to keep users from being able to select certain slices based on the data inside it. -For scenarios where you click on the Others slice, the pie chart will return an object called `PieSliceOthersContext`. This object contains a list of the data items contained within the Others slice. +For scenarios where you click on the Others slice, the pie chart will return an object called . This object contains a list of the data items contained within the Others slice. diff --git a/docs/angular/src/content/en/components/charts/types/radial-chart.mdx b/docs/angular/src/content/en/components/charts/types/radial-chart.mdx index 64a177e3b5..0287e26e41 100644 --- a/docs/angular/src/content/en/components/charts/types/radial-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/radial-chart.mdx @@ -68,7 +68,7 @@ Once our radial chart is created, we may want to make some further styling custo ## Angular Radial Chart Settings -In addition, the labels can be configured to appear near or wide from the chart. This can be configured with the `LabelMode` property for the . +In addition, the labels can be configured to appear near or wide from the chart. This can be configured with the property for the .
diff --git a/docs/angular/src/content/en/components/charts/types/scatter-chart.mdx b/docs/angular/src/content/en/components/charts/types/scatter-chart.mdx index 29eff70020..cb5d2a8ce4 100644 --- a/docs/angular/src/content/en/components/charts/types/scatter-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/scatter-chart.mdx @@ -95,12 +95,12 @@ The following table lists API members mentioned in the above sections: |Chart Type | Control Name | API Members | |----------------------------|----------------|------------------------ | - |Scatter Marker | `DataChart` | `ScatterSeries` | - |Scatter Line | `DataChart` | `ScatterLineSeries` | - |Scatter Spline | `DataChart` | `ScatterSplineSeries` | - |High Density Scatter | `DataChart` | `HighDensityScatterSeries` | - |Scatter Area | `DataChart` | `ScatterAreaSeries` | - |Scatter Contour | `DataChart` | `ScatterContourSeries` | + |Scatter Marker | | | + |Scatter Line | | | + |Scatter Spline | | | + |High Density Scatter | | | + |Scatter Area | | | + |Scatter Contour | | | ## API References diff --git a/docs/angular/src/content/en/components/charts/types/sparkline-chart.mdx b/docs/angular/src/content/en/components/charts/types/sparkline-chart.mdx index 8061b6546f..894600f8bc 100644 --- a/docs/angular/src/content/en/components/charts/types/sparkline-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/sparkline-chart.mdx @@ -16,7 +16,7 @@ The Ignite UI for Angular Sparkline is a lightweight charting control. It is int ## Angular Sparkline Example -The following example shows all the different types of available. The type is defined by setting the property. If the property is not specified, then by default, the `Line` type is displayed. +The following example shows all the different types of available. The type is defined by setting the property. If the property is not specified, then by default, the type is displayed. @@ -61,10 +61,10 @@ The Angular Sparkline has the ability to mark the data points with elliptical ic The Angular Sparkline supports the following types of sparklines by setting the property accordingly: -- `Line`: Displays the line chart type of Sparkline with numeric data, connecting the data points with line segments. At least two data points must be supplied to visualize the data in Sparkline. -- `Area`: Displays the Area chart type of Sparkline with numeric data. This is like line type with additional steps of closing the area after each line is drawn. At least two data points must be supplied to visualize the data in Sparkline. -- `Column`: Displays the Column chart type of Sparkline with numeric data. Some may refer to it as vertical bars. This type can render a single data point, but it would require specifying the minimum value range property (minimum) in Sparkline so the supplied single data point can be visible, otherwise the value will be treated as the minimum value and will not be visible. -- `WinLoss`: This type is similar in its visual appearance to Column chart type, in which the value of each column is equal to either the positive maximum (for positive values) or the negative minimum (for negative value) of the data set. The idea is to indicate a win or loss scenario. For the Win/Loss chart to display properly, the data set must have both positive and negative values. If the WinLoss sparkline is bound to the same data as the other types such as the Line type, which can be bound to a collection of numeric values, then the Angular Sparkline will select two values from the collection - the highest and the lowest - and will render the sparkline based upon those values. +- : Displays the line chart type of Sparkline with numeric data, connecting the data points with line segments. At least two data points must be supplied to visualize the data in Sparkline. +- : Displays the Area chart type of Sparkline with numeric data. This is like line type with additional steps of closing the area after each line is drawn. At least two data points must be supplied to visualize the data in Sparkline. +- : Displays the Column chart type of Sparkline with numeric data. Some may refer to it as vertical bars. This type can render a single data point, but it would require specifying the minimum value range property (minimum) in Sparkline so the supplied single data point can be visible, otherwise the value will be treated as the minimum value and will not be visible. +- : This type is similar in its visual appearance to Column chart type, in which the value of each column is equal to either the positive maximum (for positive values) or the negative minimum (for negative value) of the data set. The idea is to indicate a win or loss scenario. For the Win/Loss chart to display properly, the data set must have both positive and negative values. If the WinLoss sparkline is bound to the same data as the other types such as the Line type, which can be bound to a collection of numeric values, then the Angular Sparkline will select two values from the collection - the highest and the lowest - and will render the sparkline based upon those values. @@ -75,7 +75,7 @@ The Angular Sparkline supports the following types of sparklines by setting the ## Markers -The Angular Sparkline allows you to show markers as circular-colored icons on your series to indicate the individual data points based on X/Y coordinates. Markers can be set on sparklines of display types of `Line`, `Area`, and `Column`. The `WinLoss` type of sparkline does not currently accept markers. By default, markers are not displayed, but they can be enabled by setting the corresponding marker visibility property. +The Angular Sparkline allows you to show markers as circular-colored icons on your series to indicate the individual data points based on X/Y coordinates. Markers can be set on sparklines of display types of , , and . The type of sparkline does not currently accept markers. By default, markers are not displayed, but they can be enabled by setting the corresponding marker visibility property. Markers in the sparkline can be placed in any combination of the following locations: @@ -98,7 +98,7 @@ All of the markers mentioned above can be customized using the related marker ty The normal range feature of the Angular Sparkline is a horizontal stripe representing some pre-defined meaningful range when the data is being visualized. The normal range can be set as a shaded area outlined with the desired color. -The normal range can be wider than the maximum data point or beyond, and it can also be as thin as the sparkline's `Line` display type, to serve as a threshold indicator, for instance. The width of the normal range is determined by the following three properties, which serve as the minimum settings required for displaying the normal range: +The normal range can be wider than the maximum data point or beyond, and it can also be as thin as the sparkline's display type, to serve as a threshold indicator, for instance. The width of the normal range is determined by the following three properties, which serve as the minimum settings required for displaying the normal range: - `NormalRangeVisibility`: Whether the normal range is visible. - `NormalRangeMaximum`: The bottom border of the range. @@ -116,9 +116,9 @@ You can also configure whether to show the normal range in front of or behind th ## Trendlines -The Angular Sparkline has support for a range of trendlines that display as another layer on top of the actual sparkline layer. To display a sparkline, you can use the `TrendLineType` property. +The Angular Sparkline has support for a range of trendlines that display as another layer on top of the actual sparkline layer. To display a sparkline, you can use the property. -The trendlines are calculated according to the algorithm specified by the `TrendLineType` property using the values of the data the the chart is bound to. +The trendlines are calculated according to the algorithm specified by the property using the values of the data the the chart is bound to. Trendlines can only be displayed one at a time and by default, the trendline is not displayed. diff --git a/docs/angular/src/content/en/components/charts/types/spline-chart.mdx b/docs/angular/src/content/en/components/charts/types/spline-chart.mdx index cda6451b25..8c80c2e098 100644 --- a/docs/angular/src/content/en/components/charts/types/spline-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/spline-chart.mdx @@ -14,7 +14,7 @@ The Ignite UI for Angular Spline Chart belongs to a group of Category Charts tha ## Angular Spline Chart Example -The following example shows how to create Angular Spline Chart in the control by binding your data and setting the property to `Spline` enum. +The following example shows how to create Angular Spline Chart in the control by binding your data and setting the property to enum. @@ -27,7 +27,7 @@ The following example shows how to create Angular Spline Chart in the control by binding your data and setting the property to `Spline`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -40,7 +40,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Spline`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -53,7 +53,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Spline`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -108,9 +108,9 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | --------------------|--------------------|-------------------------- | -| Spline | `CategoryChart` | `CategoryChart.ChartType` = `Spline` | -| Stacked Spline | `DataChart` | `StackedSplineSeries` | -| Stacked 100% Spline | `DataChart` | `Stacked100SplineSeries` | +| Spline | | `CategoryChart.ChartType` = | +| Stacked Spline | | | +| Stacked 100% Spline | | |

diff --git a/docs/angular/src/content/en/components/charts/types/stacked-chart.mdx b/docs/angular/src/content/en/components/charts/types/stacked-chart.mdx index a4a90d8e40..0e7422bd4b 100644 --- a/docs/angular/src/content/en/components/charts/types/stacked-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/stacked-chart.mdx @@ -30,7 +30,7 @@ The following sections demonstrate individual types of Ignite UI for Angular Sta Stacked Area Charts are rendered using a collection of points connected by line segments, with the area below the line filled in and stacked on top of each other. Stacked Area Charts follow all the same requirements as [Area Chart](area-chart.md), with the only difference being that visually, the shaded areas are stacked on top of each other. -You can create this type of chart in the `DataChart` control by binding your data to a `StackedAreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -43,7 +43,7 @@ You can create this type of chart in the `DataChart` control by binding your dat ## Angular Stacked 100 Area Chart Sometimes the series represent part of a whole being changed over time e.g. a country's energy consumption related to the sources from which it is produced. In such cases representing all stacked elements equally may be a better idea. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100AreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -59,7 +59,7 @@ A Stacked Bar Chart, or Stacked Bar Graph, is a type of category chart that is u The Stacked Bar Chart differs from the [Bar Chart](bar-chart.md) in that the data points representing your data are stacked next to each other horizontally to visually group your data. Each stack can contain both positive and negative values. All positive values are grouped on the positive side of the X-Axis, and all negative values are grouped on the negative side of the X-Axis. -In this example of an Stacked Bar Chart, we have a Numeric X Axis (bottom labels of the chart) and a Category Y Axis (left labels of the chart). You can create this type of chart in the `DataChart` control by binding your data to a `StackedBarSeries`, as shown in the example below. +In this example of an Stacked Bar Chart, we have a Numeric X Axis (bottom labels of the chart) and a Category Y Axis (left labels of the chart). You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -73,7 +73,7 @@ In this example of an Stacked Bar Chart, we have a Numeric X Axis (bottom labels The Angular Stacked 100% Bar Chart is identical to the Angular stacked bar chart in all aspects except in their treatment of the values on X-Axis (bottom labels of the chart). Instead of presenting a direct representation of the data, the stacked 100% bar chart presents the data in terms of percent of the sum of all values in a data point. -In this example of a Stacked 100% Bar Chart, the Energy Product values are shown as a 100% value of all of the data in the fragments of the horizontal bars. You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100BarSeries`, as shown in the example below. +In this example of a Stacked 100% Bar Chart, the Energy Product values are shown as a 100% value of all of the data in the fragments of the horizontal bars. You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -87,7 +87,7 @@ In this example of a Stacked 100% Bar Chart, the Energy Product values are shown The Stacked Column Chart is identical to the [Column Chart](column-chart.md) in all aspects, except the series are represented on top of one another rather than to the side. The Stacked Column Chart is used to show comparing results between series. Each stacked fragment in the collection represents one visual element in each stack. Each stack can contain both positive and negative values. All positive values are grouped on the positive side of the Y-Axis, and all negative values are grouped on the negative side of the Y-Axis. The Stacked Column Chart uses the same concepts of data plotting as the Stacked Bar Chart but data points are stacked along vertical line (Y-Axis) rather than along horizontal line (X-Axis). -You can create this type of chart in the `DataChart` control by binding your data to a `StackedColumnSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -101,7 +101,7 @@ You can create this type of chart in the `DataChart` control by binding your dat The Stacked 100% Column Chart is identical to the Stacked Column Chart in all aspects except in their treatment of the values on Y-Axis. Instead of presenting a direct representation of the data, the Stacked 100% Column Chart presents the data in terms of percent of the sum of all values in a data point. -The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100ColumnSeries`, as shown in the example below. +The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -113,7 +113,7 @@ The example below shows a study made for online shopping traffic by departments ## Angular Stacked Line Chart -The Stacked Line Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the `DataChart` control by binding your data to a `StackedLineSeries`, as shown in the example below: +The Stacked Line Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the control by binding your data to a , as shown in the example below: @@ -127,7 +127,7 @@ The Stacked Line Chart is often used to show the change of value over time such The Stacked 100% Line Chart is identical to the Stacked Line Chart in all aspects except in their treatment of the values on y-axis. Instead of presenting a direct representation of the data, the Stacked 100% Line Chart presents the data in terms of percent of the sum of all values in a data point. The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100LineSeries`, as shown in the example below: +You can create this type of chart in the control by binding your data to a , as shown in the example below: @@ -141,7 +141,7 @@ You can create this type of chart in the `DataChart` control by binding your dat Stacked Spline Area Charts are rendered using a collection of points connected by curved spline segments, with the area below the curved spline fill in and stacked on top of each other. Stacked Spline Area Charts follow all of the same requirements as [Area Chart](area-chart.md), with the only difference being that the visually shaded areas are stacked on top of each other. -You can create this type of chart in the `DataChart` control by binding your data to a `StackedSplineAreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -155,7 +155,7 @@ You can create this type of chart in the `DataChart` control by binding your dat The Stacked 100% Spline Area Chart is identical to the Stacked Spline Area Chart in all aspects except for the treatment of the values on the y-axis. Instead of presenting a direct representation of the data, the Stacked 100% Spline Area Chart presents the data in terms of a percent of the sum of all values in a particular data point. Sometimes the chart represents part of a whole being changed over time. For example, a country's energy consumption related to the sources from which it is produced. In such cases, representing all stacked elements equally may be a better idea. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100SplineAreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -167,7 +167,7 @@ You can create this type of chart in the `DataChart` control by binding your dat ## Angular Stacked Spline Chart -The Stacked Spline Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the `DataChart` control by binding your data to a `StackedSplineSeries`, as shown in the example below. +The Stacked Spline Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -181,7 +181,7 @@ The Stacked Spline Chart is often used to show the change of value over time suc The Stacked 100% Spline Chart is identical to the Stacked Spline Chart in all aspects except in their treatment of the values on y-axis. Instead of presenting a direct representation of the data, the Stacked 100% Spline Chart presents the data in terms of percent of the sum of all values in a data point. The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100SplineSeries`. +You can create this type of chart in the control by binding your data to a . @@ -207,15 +207,15 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | -------------------------|----------------|-------------------------------- | -| Stacked Area | `DataChart` | `StackedAreaSeries` | -| Stacked Bar | `DataChart` | `StackedBarSeries` | -| Stacked Column | `DataChart` | `StackedColumnSeries` | -| Stacked Line | `DataChart` | `StackedLineSeries` | -| Stacked Spline | `DataChart` | `StackedSplineSeries` | -| Stacked Spline Area | `DataChart` | `StackedSplineAreaSeries` | -| Stacked 100% Area | `DataChart` | `Stacked100AreaSeries` | -| Stacked 100% Bar | `DataChart` | `Stacked100BarSeries` | -| Stacked 100% Column | `DataChart` | `Stacked100ColumnSeries` | -| Stacked 100% Line | `DataChart` | `Stacked100LineSeries` | -| Stacked 100% Spline | `DataChart` | `Stacked100SplineSeries` | -| Stacked 100% Spline Area | `DataChart` | `Stacked100SplineAreaSeries` | +| Stacked Area | | | +| Stacked Bar | | | +| Stacked Column | | | +| Stacked Line | | | +| Stacked Spline | | | +| Stacked Spline Area | | | +| Stacked 100% Area | | | +| Stacked 100% Bar | | | +| Stacked 100% Column | | | +| Stacked 100% Line | | | +| Stacked 100% Spline | | | +| Stacked 100% Spline Area | | | diff --git a/docs/angular/src/content/en/components/charts/types/step-chart.mdx b/docs/angular/src/content/en/components/charts/types/step-chart.mdx index 7008d9df21..cb06134f0a 100644 --- a/docs/angular/src/content/en/components/charts/types/step-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/step-chart.mdx @@ -15,7 +15,7 @@ The Ignite UI for Angular Step Chart belongs to a group of category charts that ## Angular Step Area Chart -You can create Angular Step Area Chart in the control by setting property to `StepArea` enum, as shown in the example below. +You can create Angular Step Area Chart in the control by setting property to enum, as shown in the example below. @@ -28,7 +28,7 @@ You can create Angular Step Area Chart in the control by binding your data and setting property to `StepLine` value, as shown in the example below. +You can create Step Line Chart in the control by binding your data and setting property to value, as shown in the example below. @@ -39,7 +39,7 @@ You can create Step Line Chart in the control as demonstrated below. +If you need Step Charts with more features such as composite other series, you can configure the , , , lines' , and lines' properties on the control as demonstrated below. diff --git a/docs/angular/src/content/en/components/charts/types/stock-chart.mdx b/docs/angular/src/content/en/components/charts/types/stock-chart.mdx index ca52b73b8c..28cf935d8d 100644 --- a/docs/angular/src/content/en/components/charts/types/stock-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/stock-chart.mdx @@ -15,7 +15,7 @@ The Ignite UI for Angular Stock Chart, sometimes referred to as Angular Financia ## Angular Stock Chart Example -You can create Stock Chart using the control by binding your data and optionally setting property to `Line` value, as shown in the example below. +You can create Stock Chart using the control by binding your data and optionally setting property to value, as shown in the example below. @@ -96,7 +96,7 @@ If you need a Stock Chart with more features such as composite other series, you ## Angular Chart Annotations -The Crosshair Annotation Layer provides crossing lines that meet at the actual value of every targeted series. Crosshair types include: Horizontal, Vertical, and Both. The Crosshairs can also be configured to snap to data points by setting the `CrosshairsSnapToData` property to true, otherwise the crosshairs will be interpolated between data points. Annotations can also be enabled to display the crosshair's value along the axis. +The Crosshair Annotation Layer provides crossing lines that meet at the actual value of every targeted series. Crosshair types include: Horizontal, Vertical, and Both. The Crosshairs can also be configured to snap to data points by setting the property to true, otherwise the crosshairs will be interpolated between data points. Annotations can also be enabled to display the crosshair's value along the axis. The Final Value Layer provides a quick view along the axis of the ending value displayed in a series. @@ -124,20 +124,20 @@ The following panes are available: Financial Indicators are often used by traders to measure changes and to show trends in stock prices. These indicators are usually displayed below the price pane because they do not share the same Y-Axis scale. By default the indicator panes are not displayed. The toolbar allows the end user to select which indicator to display at run time. -In order to display an indicator pane initially, the `IndicatorTypes` property must be set to a least one type of indicator, as demonstrated in the following code: +In order to display an indicator pane initially, the property must be set to a least one type of indicator, as demonstrated in the following code: ### Volume Pane The volume pane represents the number of shares traded during a given period. Low volume would indicate little interest, while high volume would indicate high interest with a lot of trades. This can be displayed using column, line or area chart types. The toolbar allows the end user to display the volume pane by selecting a chart type to render the data at runtime. In order the display the pane, a volume type must be set, as demonstrated in the following code: ### Price Pane -This pane displays stock prices and shows the stock's high, low, open and close prices over time. In addition it can display trend lines and overlays. Your end user can choose different chart types from the toolbar. By default, the chart type is set to `Auto`. You can override the default setting, as demonstrated in the following code: +This pane displays stock prices and shows the stock's high, low, open and close prices over time. In addition it can display trend lines and overlays. Your end user can choose different chart types from the toolbar. By default, the chart type is set to . You can override the default setting, as demonstrated in the following code: Note that is recommended to use line chart type if plotting multiple data sources or if plotting data source with a lot of data points. ### Zoom Pane -This pane controls the zoom of all the displayed panes. This pane is displayed by default. It can be turned off by setting the `ZoomSliderType` to `none` as demonstrated in the following code: +This pane controls the zoom of all the displayed panes. This pane is displayed by default. It can be turned off by setting the to `none` as demonstrated in the following code: -Note that you should set the `ZoomSliderType` option to the same value as the `ChartType` option is set to. This way, the zoom slider will show correct preview of the price pane. The following code demonstrates how to do this: +Note that you should set the option to the same value as the option is set to. This way, the zoom slider will show correct preview of the price pane. The following code demonstrates how to do this: In this example, the stock chart is plotting revenue for United States. diff --git a/docs/angular/src/content/en/components/charts/types/treemap-chart.mdx b/docs/angular/src/content/en/components/charts/types/treemap-chart.mdx index ebadc66ceb..2ce557e3b5 100644 --- a/docs/angular/src/content/en/components/charts/types/treemap-chart.mdx +++ b/docs/angular/src/content/en/components/charts/types/treemap-chart.mdx @@ -57,13 +57,13 @@ There are several common use cases for choosing a Treemap. When you: - The data source must be an array or a list of data items - The data source must contain at least one data item otherwise the map will not render any nodes. -- All data items must contain at least one data column (e.g. string) which should be mapped to the `LabelMemberPath` property. -- All data items must contain at least one numeric data column which should be mapped using the `ValueMemberPath` property. -- To categorize data into organized tiles you can optionally use `ParentIdMemberPath` and `IdMemberPath`. +- All data items must contain at least one data column (e.g. string) which should be mapped to the  property. +- All data items must contain at least one numeric data column which should be mapped using the  property. +- To categorize data into organized tiles you can optionally use  and . ## Angular Treemap Configuration -In the following example, the treemap demonstrates the ability of changing it's algorithmic structure by modifying the `LayoutType` and `LayoutOrientation` properties. +In the following example, the treemap demonstrates the ability of changing it's algorithmic structure by modifying the and properties. @@ -87,9 +87,9 @@ The Treemap allows you to choose the algorithm that is best for your requirement ### Layout Orientation -`LayoutOrientation` property enables the user to set the direction in which the nodes of the hierarchy will be expanded. + property enables the user to set the direction in which the nodes of the hierarchy will be expanded. -Note that the `LayoutOrientation` property works with the layout types SliceAndDice and Strip. +Note that the property works with the layout types SliceAndDice and Strip. - `Horizontal` – the child nodes are going to be stacked horizontally(SliceAndDice). - `Vertical` – the child nodes are going to be stacked vertically (SliceAndDice). @@ -103,17 +103,17 @@ In the following example, the treemap demonstrates the ability of changing the l ### Angular Treemap Highlighting -In the following example, the treemap demonstrates the ability of node highlighting. There are two options for this feature. Each node can individually brighten, by decreasing its opacity, or cause all other nodes to trigger the same effect. To enable this feature, set `HighlightingMode`to Brighten or FadeOthers. +In the following example, the treemap demonstrates the ability of node highlighting. There are two options for this feature. Each node can individually brighten, by decreasing its opacity, or cause all other nodes to trigger the same effect. To enable this feature, set to Brighten or FadeOthers. ## Angular Treemap Percent based highlighting -- `HighlightedItemsSource`: Specifies the datasource to read highlighted values from. If null, then highlighted values are read from the ItemsSource property. -- `HighlightedValueMemberPath`: Specifies the name of the property in the datasource where the highlighted values are read. -- `HighlightedValueOpacity`: Controls the opacity of the normal value behind the highlighted value. -- `HighlightedValuesDisplayMode`: Enables or disables highlighted values. +- : Specifies the datasource to read highlighted values from. If null, then highlighted values are read from the ItemsSource property. +- : Specifies the name of the property in the datasource where the highlighted values are read. +- : Controls the opacity of the normal value behind the highlighted value. +- : Enables or disables highlighted values. - Auto: The treemap decides what mode to use. - Overlay: The treemap displays highlighted values over top the normal value with a slight opacity applied to the normal value. - Hidden: The treemap does not show highlighted values. diff --git a/docs/angular/src/content/en/components/chip.mdx b/docs/angular/src/content/en/components/chip.mdx index d27be47ecc..79b7cf8a23 100644 --- a/docs/angular/src/content/en/components/chip.mdx +++ b/docs/angular/src/content/en/components/chip.mdx @@ -112,7 +112,7 @@ Selection can be enabled by setting the ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/circular-progress.mdx b/docs/angular/src/content/en/components/circular-progress.mdx index d7a94f976e..e77b6dfa89 100644 --- a/docs/angular/src/content/en/components/circular-progress.mdx +++ b/docs/angular/src/content/en/components/circular-progress.mdx @@ -88,7 +88,7 @@ After that, we should have the demo sample in your browser. The **igx-circular-bar** emits event that outputs an object like this `{currentValue: 65, previousValue: 64}` on each step. - + The default progress increments by **1% of the value** per update cycle, this happens if the value is not defined. To change the update rate, the value should be defined.``` @@ -136,7 +136,7 @@ You can dynamically change the value of the progress by using external controls ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/combo-templates.mdx b/docs/angular/src/content/en/components/combo-templates.mdx index bded3f6f2d..7377b1d393 100644 --- a/docs/angular/src/content/en/components/combo-templates.mdx +++ b/docs/angular/src/content/en/components/combo-templates.mdx @@ -140,7 +140,7 @@ Use selector `[igxComboToggleIcon]`: ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/dashboard-tile.mdx b/docs/angular/src/content/en/components/dashboard-tile.mdx index 81c720e89d..60669f2bd3 100644 --- a/docs/angular/src/content/en/components/dashboard-tile.mdx +++ b/docs/angular/src/content/en/components/dashboard-tile.mdx @@ -15,7 +15,7 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; # Angular Dashboard Tile -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 that let you alter the visualization that is presented in a variety of ways. +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 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. @@ -96,7 +96,7 @@ You are not locked into a single visualization when you bind the `DataSource`, a -The visualization or properties of the visualization are also configurable using the at the top of the control. This has the default tools for the current visualization with the addition of four Dashboard Tile specific ones, highlighted below: +The visualization or properties of the visualization are also configurable using the at the top of the control. This has the default tools for the current visualization with the addition of four Dashboard Tile specific ones, highlighted below: Dashboard Tile Toolbar @@ -105,7 +105,7 @@ 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` or `ExcludedProperties` collection on the control. +- 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 or 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. @@ -121,7 +121,7 @@ This demo demonstrates dashboard tile integration with the Angular Geographic Ma -
+



diff --git a/docs/angular/src/content/en/components/date-picker.mdx b/docs/angular/src/content/en/components/date-picker.mdx index be1c06189f..4aefcdc2a3 100644 --- a/docs/angular/src/content/en/components/date-picker.mdx +++ b/docs/angular/src/content/en/components/date-picker.mdx @@ -160,7 +160,7 @@ The allows the projection of child components that ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/date-range-picker.mdx b/docs/angular/src/content/en/components/date-range-picker.mdx index 2734e36405..7b412c6032 100644 --- a/docs/angular/src/content/en/components/date-range-picker.mdx +++ b/docs/angular/src/content/en/components/date-range-picker.mdx @@ -133,7 +133,7 @@ The Angular Date Range Picker component also allows configuring two separate inp ``` - + In the two-input configuration, place the `input` directly inside `igx-date-range-start` and `igx-date-range-end`. To open the calendar from an icon, use `igx-picker-toggle` with `igxPrefix` applied directly to it: @@ -273,13 +273,13 @@ In the default configuration, with a single read-only input, a default calendar ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` When a Date Range Picker has two separate inputs for start and end dates, it doesn't expose these icons by default. The and should be manually added as children of the or like so: - + In the two-input configuration: - use `igx-picker-toggle igxPrefix` for the calendar action diff --git a/docs/angular/src/content/en/components/dialog.mdx b/docs/angular/src/content/en/components/dialog.mdx index fe83d88505..5cbc76980d 100644 --- a/docs/angular/src/content/en/components/dialog.mdx +++ b/docs/angular/src/content/en/components/dialog.mdx @@ -79,7 +79,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/drop-down.mdx b/docs/angular/src/content/en/components/drop-down.mdx index 3d1f39018c..42dd8e424f 100644 --- a/docs/angular/src/content/en/components/drop-down.mdx +++ b/docs/angular/src/content/en/components/drop-down.mdx @@ -176,7 +176,7 @@ To provide a more useful visual information, use the + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/excel-library-using-cells.mdx b/docs/angular/src/content/en/components/excel-library-using-cells.mdx index b6a4380e2a..4b4ebbf94d 100644 --- a/docs/angular/src/content/en/components/excel-library-using-cells.mdx +++ b/docs/angular/src/content/en/components/excel-library-using-cells.mdx @@ -45,7 +45,7 @@ import { FormattedString } from "igniteui-angular-excel"; ## Referencing Cells and Regions -You can access a object or a object by calling the object’s `GetCell` or `GetRegion` methods, respectively. Both methods accept a string parameter that references a cell. Getting a reference to a cell is useful when applying formats or working with formulas and cell contents. +You can access a object or a object by calling the object’s or methods, respectively. Both methods accept a string parameter that references a cell. Getting a reference to a cell is useful when applying formats or working with formulas and cell contents. The following example code demonstrates how to reference cells and regions: @@ -65,7 +65,7 @@ var region = worksheet.getRegion("G1:G10"); In Microsoft Excel, individual cells, as well as cell regions can have names assigned to them. The name of a cell or region can be used to reference that cell or region instead of their address. -The Infragistics Angular Excel Library supports the referencing of cells and regions by name through the `GetCell` and `GetRegion` methods of the object. You refer to the cell or region using the `NamedReference` instance that refers to that cell or region. +The Infragistics Angular Excel Library supports the referencing of cells and regions by name through the and methods of the object. You refer to the cell or region using the instance that refers to that cell or region. You can use the following code snippet as an example for naming a cell or region: @@ -109,7 +109,7 @@ worksheet.rows(0).cells(0).comment = cellComment; ## Adding a Formula to a Cell -The Infragistics Angular Excel Library allows you to add Microsoft Excel formulas to a cell or group of cells in a worksheet. You can do this using the object’s `ApplyFormula` method or by instantiating a object and applying it to a cell. Regardless of the manner in which you apply a formula to a cell, you can access the object using the object’s property. If you need the value, use the cell’s `Value` property. +The Infragistics Angular Excel Library allows you to add Microsoft Excel formulas to a cell or group of cells in a worksheet. You can do this using the object’s method or by instantiating a object and applying it to a cell. Regardless of the manner in which you apply a formula to a cell, you can access the object using the object’s property. If you need the value, use the cell’s property. The following code shows you how to add a formula to a cell. @@ -126,7 +126,7 @@ The following code shows you how to add a formula to a cell. ## Copying a Cell’s Format -Cells can have different formatting, including background color, format string, and font style. If you need a cell to have the same format as a previously formatted cell, instead of individually setting each option exposed by the object’s property, you can call the object’s `SetFormatting` method and pass it a object to copy. This will copy every format setting from the first cell to the second cell. You can also do this for a row, merged cell region, or column. +Cells can have different formatting, including background color, format string, and font style. If you need a cell to have the same format as a previously formatted cell, instead of individually setting each option exposed by the object’s property, you can call the object’s method and pass it a object to copy. This will copy every format setting from the first cell to the second cell. You can also do this for a row, merged cell region, or column. The following code shows you how to copy the format of the 2nd column to the 4th column: @@ -146,7 +146,7 @@ worksheet.columns(3).cellFormat.setFormatting(worksheet.columns(1).cellFormat); ## Formatting a Cell -The Infragistics Angular Excel Library allows you to customize the look and behavior of a cell. You can customize a cell by setting properties exposed by the property of the , , , or `WorksheetMergedCellsRegion` objects. +The Infragistics Angular Excel Library allows you to customize the look and behavior of a cell. You can customize a cell by setting properties exposed by the property of the , , , or objects. You can customize every aspect of a cell’s appearance. You can set a cell’s font, background, and borders, as well as text alignment and rotation. You can even apply a different format on a character-by-character basis for a cell’s text. @@ -171,9 +171,9 @@ You can create all possible fill types using static properties and methods on th - `NoColor` - A property that represents a fill with no color, which allows a background image of the worksheet, if any, to show through. -- `CreateSolidFill` - Returns a instance which has a pattern style of `Solid` and a background color set to the `Color` or specified in the method. +- `CreateSolidFill` - Returns a instance which has a pattern style of `Solid` and a background color set to the or specified in the method. -- `CreatePatternFill` - Returns a instance which has the specified pattern style and the `Color` or values, specified for the background and pattern colors. +- `CreatePatternFill` - Returns a instance which has the specified pattern style and the or values, specified for the background and pattern colors. - `CreateLinearGradientFill` - Returns a instance with the specified angle and gradient stops. @@ -241,7 +241,7 @@ Each workbook has 12 associated theme colors. They are the following: Colors are defined by the class, which is a sealed immutable class. The class has a static `Automatic` property, which returns the automatic color, and there are various constructors which allow you to create a instance with a color or a theme value and an optional tint. -The `GetResolvedColor` method on allows you to determine what color will actually be seen by the user when they open the file in Excel. +The method on allows you to determine what color will actually be seen by the user when they open the file in Excel. If the represents a theme color, you must pass in a Workbook instance to the method so it can get the theme color’s RGB value from the workbook. @@ -253,35 +253,35 @@ When the older formats are opened in Microsoft Excel 2003 and earlier versions, You can set a host of different formats on a by using the object returned by the property of that cell. This object enables you to style many different aspects of the cell such as borders, font, fill, alignments, and whether or not the cell should shrink to fit or be locked. -You can also access the built-in styles to Microsoft Excel 2007 using the `Styles` collection of the object. The full list of styles in Excel can be found in the Cell Styles gallery of the Home tab of Microsoft Excel 2007. +You can also access the built-in styles to Microsoft Excel 2007 using the collection of the object. The full list of styles in Excel can be found in the Cell Styles gallery of the Home tab of Microsoft Excel 2007. -There is a special type of style on the workbook’s `Styles` collection known as the "normal" style, which can be accessed using that collection’s `NormalStyle` property, or by indexing into the collection with the name "Normal". +There is a special type of style on the workbook’s collection known as the "normal" style, which can be accessed using that collection’s property, or by indexing into the collection with the name "Normal". -The `NormalStyle` contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing the properties on the `NormalStyle` will change all of the default cell format properties on the workbook. This is useful, for example, if you want to change the default font for your workbook. +The contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing the properties on the will change all of the default cell format properties on the workbook. This is useful, for example, if you want to change the default font for your workbook. -You can clear the `Styles` collection or reset it to its predefined state by using the `Clear` and `Reset` methods, respectively. Both of these will remove all user-defined styles, but `Clear` will clear the `Styles` collection entirely. +You can clear the collection or reset it to its predefined state by using the and methods, respectively. Both of these will remove all user-defined styles, but will clear the collection entirely. -With this feature, a `Style` property has been added to the object. This is a reference to a instance, representing the parent style of the format. For formats of a style, this property will always be null, because styles cannot have a parent style. For row, column, and cell formats, the `Style` property always returns the `NormalStyle` by default. +With this feature, a property has been added to the object. This is a reference to a instance, representing the parent style of the format. For formats of a style, this property will always be null, because styles cannot have a parent style. For row, column, and cell formats, the property always returns the by default. -If the `Style` property is set to null, it will revert back to the `NormalStyle`. If it is set to another style in the styles collection, that style will now hold the defaults for all unset properties on the cell format. +If the property is set to null, it will revert back to the . If it is set to another style in the styles collection, that style will now hold the defaults for all unset properties on the cell format. -When the `Style` property is set on a cell format, the format options included on the `Style` are removed from the cell format. All other properties are left intact. For example, if a cell style including border formatting was created and that style was set as the cell’s `Style`, the border format option on the cell format would be removed and the cell format only includes fill formatting. +When the property is set on a cell format, the format options included on the are removed from the cell format. All other properties are left intact. For example, if a cell style including border formatting was created and that style was set as the cell’s , the border format option on the cell format would be removed and the cell format only includes fill formatting. When a format option flag is removed from a format, all associated properties are reset to their unset values, so the cell format’s border properties are implicitly reset to default/unset values. -You can determine what would really be seen in cells by using the `GetResolvedCellFormat` method on classes which represent a row, column, cell, and merged cell. +You can determine what would really be seen in cells by using the method on classes which represent a row, column, cell, and merged cell. -This method returns a instance which refers back to the associated on which it is based. So subsequent changes to the property will be reflected in the instance returned from a `GetResolvedCellFormat` call. +This method returns a instance which refers back to the associated on which it is based. So subsequent changes to the property will be reflected in the instance returned from a call. ## Merging Cells Aside from setting the value or format of cells, you can also merge cells to make two or more cells appear as one. If you merge cells, they must be in a rectangular region. -When you merge cells, each cell in the region will have the same value and cell format. The merged cells will also be associated with the same `WorksheetMergedCellsRegion` object, accessible from their `AssociatedMergedCellsRegion` property. The resultant `WorksheetMergedCellsRegion` object will also have the same value and cell format as the cells. +When you merge cells, each cell in the region will have the same value and cell format. The merged cells will also be associated with the same object, accessible from their property. The resultant object will also have the same value and cell format as the cells. Setting the value (or cell format) of the region or any cell in the region will change the value of all cells and the region. If you un-merge cells, all of the previously merged cells will retain the shared cell format they had before they were unmerged. However, only the top-left cell of the region will retain the shared value. -In order to create a merged cell region, you must add a range of cells to the object’s `MergedCellsRegions` collection. This collection exposes an `Add` method that takes four integer parameters. The four parameters determine the index of the starting row and column (top-left most cell) and the index of the ending row and column (bottom-right most cell). +In order to create a merged cell region, you must add a range of cells to the object’s collection. This collection exposes an `Add` method that takes four integer parameters. The four parameters determine the index of the starting row and column (top-left most cell) and the index of the ending row and column (bottom-right most cell). ```ts var workbook = new Workbook(); @@ -345,11 +345,11 @@ If a text is used in the cell, the cell displayed text will always be full value The only time when this is not the case is when padding characters are used in format string. Then the value will be displayed as all hash marks when there is not enough room for the text. -You can set the worksheet's `DisplayOptions`' `ShowFormulasInCells` property to have formulas be displayed in cells instead of their results, and format strings and cell widths are ignored. Text values display as if their format string were @ , non-integral numeric values display as if their format string were 0.0 and integral numeric values display as if their format string were 0 . +You can set the worksheet's ' property to have formulas be displayed in cells instead of their results, and format strings and cell widths are ignored. Text values display as if their format string were @ , non-integral numeric values display as if their format string were 0.0 and integral numeric values display as if their format string were 0 . Additionally, if the value cannot fit, it will not display as all hashes. Display text will still return its full text as the cell text, even though it may not be fully seen. -The following code snippet demonstrates the usage of the `GetText` method to get the text as it would be displayed in Excel: +The following code snippet demonstrates the usage of the method to get the text as it would be displayed in Excel: ```ts var workbook = new Workbook(); diff --git a/docs/angular/src/content/en/components/excel-library-using-tables.mdx b/docs/angular/src/content/en/components/excel-library-using-tables.mdx index a4090c61c3..e078aa9511 100644 --- a/docs/angular/src/content/en/components/excel-library-using-tables.mdx +++ b/docs/angular/src/content/en/components/excel-library-using-tables.mdx @@ -24,7 +24,7 @@ The Infragistics Angular Excel Engine's ## Adding a Table to a Worksheet -Worksheet tables in the Infragistics Angular Excel Engine are represented by the object and are added in the worksheet's `Tables` collection. In order to add a table, you need to invoke the `Add` method on this collection. In this method, you can specify the region in which you would like to add a table, whether or not the table should contain headers, and optionally, specify the table's style as a `WorksheetTableStyle` object. +Worksheet tables in the Infragistics Angular Excel Engine are represented by the object and are added in the worksheet's collection. In order to add a table, you need to invoke the `Add` method on this collection. In this method, you can specify the region in which you would like to add a table, whether or not the table should contain headers, and optionally, specify the table's style as a object. The following code demonstrates how you can add a table with headers to a spanning a region of A1 to G10, where A1 to G1 will be the column headers: @@ -37,7 +37,7 @@ worksheet.tables().add("A1:G10", true); -Once you have added a table, you can modify it by adding or deleting rows and columns by calling the `InsertColumns`, `InsertDataRows`, `DeleteColumns`, or `DeleteDataRows` methods on the . You can also set a new table range by using the `Resize` method of the table. +Once you have added a table, you can modify it by adding or deleting rows and columns by calling the , , , or methods on the . You can also set a new table range by using the method of the table. The following code snippet shows the usage of these methods: @@ -67,19 +67,19 @@ table.resize("A1:G15"); ## Filtering Tables Filtering is done by applying a filter on a column in the . When the filter is applied on a column, all filters in the table will be reevaluated to determine which rows meet the criteria of all filters applied. -If the data in the table is subsequently changed or you change the `Hidden` property of the rows, the filter conditions will not automatically reevaluate. The filter conditions in a table are only reapplied when table column filters are added, removed, modified, or when the `ReapplyFilters` method is called on the table. +If the data in the table is subsequently changed or you change the `Hidden` property of the rows, the filter conditions will not automatically reevaluate. The filter conditions in a table are only reapplied when table column filters are added, removed, modified, or when the method is called on the table. The following are the filter types available to the columns of your : -- `AverageFilter` - Cells can be filtered based on whether they are above or below the average value of all cells in the column. -- `CustomFilter` - Cells can be filtered based on one or more custom conditions. -- `DatePeriodFilter` - Only cells with dates in a specific month or quarter of any year will be displayed. -- `FillFilter` - Only cells with a specific fill will be displayed. -- `FixedValuesFilter` - Cells which only match specific display values or which fall within a specific group of dates/times will be displayed. -- `FontColorFilter` - Only cells with a specific font color will be displayed. -- `RelativeDateRangeFilter` - Cells with date values can be filtered based on whether they occur within a relative time range of the date when the filter was applied, such as the next day or previous quarter. -- `TopOrBottomFilter` - This filter allows for filtering the top or bottom N values. It also allows filtering the top or bottom N% values. -- `YearToDateFilter` - Cells with date values can be filtered if they occur between the start of the year and the date on which the filter was applied. +- - Cells can be filtered based on whether they are above or below the average value of all cells in the column. +- - Cells can be filtered based on one or more custom conditions. +- - Only cells with dates in a specific month or quarter of any year will be displayed. +- - Only cells with a specific fill will be displayed. +- - Cells which only match specific display values or which fall within a specific group of dates/times will be displayed. +- - Only cells with a specific font color will be displayed. +- - Cells with date values can be filtered based on whether they occur within a relative time range of the date when the filter was applied, such as the next day or previous quarter. +- - This filter allows for filtering the top or bottom N values. It also allows filtering the top or bottom N% values. +- - Cells with date values can be filtered if they occur between the start of the year and the date on which the filter was applied. The following code snippet demonstrates how to apply an "above average" filter to a 's first column: @@ -96,20 +96,20 @@ table.columns(0).applyAverageFilter(AverageFilterType.AboveAverage); ## Sorting Tables Sorting is done by setting a sorting condition on a table column. When a sorting condition is set on a column, all sorting conditions in the table will be reevaluated to determine the order of the cells in the table. When cells need to be moved to meet their sort criteria, the entire row of cells in the table is moved as a unit. -If the data in the table is subsequently changed, the sort conditions do not automatically reevaluate. The sort conditions in a table are only reapplied when sort conditions are added, removed, modified, or when the `ReapplySortConditions` method is called on the table. When sorting conditions are reevaluated, only the visible cells are sorted. All cells in hidden rows are kept in place. +If the data in the table is subsequently changed, the sort conditions do not automatically reevaluate. The sort conditions in a table are only reapplied when sort conditions are added, removed, modified, or when the method is called on the table. When sorting conditions are reevaluated, only the visible cells are sorted. All cells in hidden rows are kept in place. -In addition to accessing sort conditions from the table columns, they are also exposed off the 's SortSettings property's `SortConditions` collection. This is an ordered collection of columns/sort condition pairs. The order of this collection is the precedence of the sorting. +In addition to accessing sort conditions from the table columns, they are also exposed off the 's SortSettings property's collection. This is an ordered collection of columns/sort condition pairs. The order of this collection is the precedence of the sorting. The following sort condition types are available to set on columns: -- `OrderedSortCondition` - Sort cells in an ascending or descending order based on their value. -- `CustomListSortCondition` - Sort cells in a defined order based on their text or display value. For example, this might be useful for sorting days as they appear on a calendar, rather than alphabetically. -- `FillSortCondition` - Sort cells based on whether their fill is a specific pattern or gradient. -- `FontColorSortCondition` - Sort cells based on whether their font is a specific color. +- - Sort cells in an ascending or descending order based on their value. +- - Sort cells in a defined order based on their text or display value. For example, this might be useful for sorting days as they appear on a calendar, rather than alphabetically. +- - Sort cells based on whether their fill is a specific pattern or gradient. +- - Sort cells based on whether their font is a specific color. -There is also a `CaseSensitive` property on the SortSettings of the to determine whether strings should be sorted case sensitively or not. +There is also a property on the SortSettings of the to determine whether strings should be sorted case sensitively or not. -The following code snippet demonstrates how to apply an `OrderedSortCondition` to a : +The following code snippet demonstrates how to apply an to a : ```ts var workbook = new Workbook(WorkbookFormat.Excel2007); diff --git a/docs/angular/src/content/en/components/excel-library-using-workbooks.mdx b/docs/angular/src/content/en/components/excel-library-using-workbooks.mdx index 8b8b10d39d..a7bc09b831 100644 --- a/docs/angular/src/content/en/components/excel-library-using-workbooks.mdx +++ b/docs/angular/src/content/en/components/excel-library-using-workbooks.mdx @@ -24,7 +24,7 @@ The Infragistics Angular Excel Engine enables you to save data to and load data ## Change Default Font -First create a new instance of . Next, add the new font to the `Styles` collection of the . This style contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing properties of the style will change the default cell format properties in the workbook. +First create a new instance of . Next, add the new font to the collection of the . This style contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing properties of the style will change the default cell format properties in the workbook. ```ts var workbook = new Workbook(); @@ -40,23 +40,23 @@ font.height = 16 * 20; Microsoft Excel® document properties provide information to help organize and keep track of your documents. You can use the Infragistics Angular Excel Library to set these properties using the object’s property. The available properties are: -- `Author` +- -- `Title` +- -- `Subject` +- -- `Keywords` +- -- `Category` +- -- `Status` +- -- `Comments` +- -- `Company` +- -- `Manager` +- The following code demonstrates how to create a workbook and set its `title` and `status` document properties. diff --git a/docs/angular/src/content/en/components/excel-library-using-worksheets.mdx b/docs/angular/src/content/en/components/excel-library-using-worksheets.mdx index f7e8a39e52..2c750a25c0 100644 --- a/docs/angular/src/content/en/components/excel-library-using-worksheets.mdx +++ b/docs/angular/src/content/en/components/excel-library-using-worksheets.mdx @@ -87,7 +87,7 @@ worksheet.displayOptions.showRowAndColumnHeaders = false; ## Configuring Editing of the Worksheet -By default, the objects that you save will be editable. You can disable editing of a worksheet by protecting it using the object's `Protect` method. This method has a lot of nullable `bool` arguments that determine which pieces are protected, and one of these options is to allow editing of objects, which if set to **false** will prevent editing of the worksheet. +By default, the objects that you save will be editable. You can disable editing of a worksheet by protecting it using the object's method. This method has a lot of nullable `bool` arguments that determine which pieces are protected, and one of these options is to allow editing of objects, which if set to **false** will prevent editing of the worksheet. The following code demonstrates how to disable editing in your worksheet: @@ -100,9 +100,9 @@ worksheet.protect(); -You can also use the object's `Protect` method to protect a worksheet against structural changes. +You can also use the object's method to protect a worksheet against structural changes. -When protection is set, you can set the object's `Locked` property on individual cells, rows, merged cell regions, or columns to override the worksheet object's protection on those objects. For example, if you need all cells of a worksheet to be read-only except for the cells of one column, you can protect the worksheet and then set the object's `Locked` property to **false** on a specific object. This will allow your users to edit cells within the column while disabling editing of the other cells in the worksheet. +When protection is set, you can set the object's property on individual cells, rows, merged cell regions, or columns to override the worksheet object's protection on those objects. For example, if you need all cells of a worksheet to be read-only except for the cells of one column, you can protect the worksheet and then set the object's property to **false** on a specific object. This will allow your users to edit cells within the column while disabling editing of the other cells in the worksheet. The following code demonstrates how you can do this: @@ -117,24 +117,24 @@ worksheet.columns(0).cellFormat.locked = false; ## Filtering Worksheet Regions -Filtering is done by setting a filter condition on a worksheet's which can be retrieved from the object's property. Filter conditions are only reapplied when they're added, removed, modified, or when the `ReapplyFilters` method is called on the worksheet. They are not constantly evaluated as data within the region changes. +Filtering is done by setting a filter condition on a worksheet's which can be retrieved from the object's property. Filter conditions are only reapplied when they're added, removed, modified, or when the method is called on the worksheet. They are not constantly evaluated as data within the region changes. -You can specify the region to apply the filter by using the `SetRegion` method on the object. +You can specify the region to apply the filter by using the method on the object. Below is a list of methods and their descriptions that you can use to add a filter to a worksheet: | Method | Description | | --------------|-------------| -|`ApplyAverageFilter`|Represents a filter which can filter data based on whether the data is below or above the average of the entire data range.| -|`ApplyDatePeriodFilter`|Represents a filter which can filter dates in a Month, or quarter of any year.| -|`ApplyFillFilter`|Represents a filter which will filter cells based on their background fills. This filter specifies a single CellFill. Cells of with this fill will be visible in the data range. All other cells will be hidden.| +||Represents a filter which can filter data based on whether the data is below or above the average of the entire data range.| +||Represents a filter which can filter dates in a Month, or quarter of any year.| +||Represents a filter which will filter cells based on their background fills. This filter specifies a single CellFill. Cells of with this fill will be visible in the data range. All other cells will be hidden.| |`ApplyFixedValuesFilter`|Represents a filter which can filter cells based on specific, fixed values, which are allowed to display.| -|`ApplyFontColorFilter`|Represents a filter which will filter cells based on their font colors. This filter specifies a single color. Cells with this color font will be visible in the data range. All other cells will be hidden.| -|`ApplyIconFilter`|Represents a filter which can filter cells based on their conditional formatting icon.| -|`ApplyRelativeDateRangeFilter`|Represents a filter which can filter date cells based on dates relative to the when the filter was applied.| -|`ApplyTopOrBottomFilter`|Represents a filter which can filter in cells in the upper or lower portion of the sorted values.| -|`ApplyYearToDateFilter`|Represents a filter which can filter in date cells if the dates occur between the start of the current year and the time when the filter is evaluated.| -|`ApplyCustomFilter`|Represents a filter which can filter data based on one or two custom conditions. These two filter conditions can be combined with a logical "and" or a logical "or" operation.| +||Represents a filter which will filter cells based on their font colors. This filter specifies a single color. Cells with this color font will be visible in the data range. All other cells will be hidden.| +||Represents a filter which can filter cells based on their conditional formatting icon.| +||Represents a filter which can filter date cells based on dates relative to the when the filter was applied.| +||Represents a filter which can filter in cells in the upper or lower portion of the sorted values.| +||Represents a filter which can filter in date cells if the dates occur between the start of the current year and the time when the filter is evaluated.| +||Represents a filter which can filter data based on one or two custom conditions. These two filter conditions can be combined with a logical "and" or a logical "or" operation.| You can use the following code snippet as an example to add a filter to a worksheet region: @@ -151,7 +151,7 @@ worksheet.filterSettings.applyAverageFilter(0, AverageFilterType.AboveAverage); ## Freezing and Splitting Panes You can freeze rows at the top of your worksheet or columns at the left using the freezing panes features. Frozen rows and columns remain visible at all times while the user is scrolling. The frozen rows and columns are separated from the rest of the worksheet by a single, solid line, which cannot be removed. -In order to enable pane freezing, you need to set the property of the object's to **true**. You can then specify the rows or columns to freeze by using the `FrozenRows` and `FrozenColumns` properties of the display options `FrozenPaneSettings`, respectively. +In order to enable pane freezing, you need to set the property of the object's to **true**. You can then specify the rows or columns to freeze by using the `FrozenRows` and `FrozenColumns` properties of the display options , respectively. You can also specify the first row in the bottom pane or first column in the right pane using the `FirstRowInBottomPane` and `FirstColumnInRightPane` properties, respectively. @@ -192,7 +192,7 @@ Sorting is done by setting a sorting condition on a worksheet level object on ei This is done by specifying a region and sort type to the object's that can be retrieved using the property of the sheet. -The sort conditions in a sheet are only reapplied when sort conditions are added, removed, modified, or when the `ReapplySortConditions` method is called on the worksheet. Columns or rows will be sorted within the region. "Rows" is the default sort type. +The sort conditions in a sheet are only reapplied when sort conditions are added, removed, modified, or when the method is called on the worksheet. Columns or rows will be sorted within the region. "Rows" is the default sort type. The following code snippet demonstrates how to apply a sort to a region of cells in a worksheet: @@ -206,7 +206,7 @@ worksheet.sortSettings.sortConditions().addItem(new RelativeIndex(0), new Ordere ## Worksheet Protection -You can protect a worksheet by calling the `Protect` method on the object. This method exposes many nullable `bool` parameters that allow you to restrict or allow the following user operations: +You can protect a worksheet by calling the method on the object. This method exposes many nullable `bool` parameters that allow you to restrict or allow the following user operations: - Editing of cells. - Editing of objects such as shapes, comments, charts, or other controls. @@ -219,7 +219,7 @@ You can protect a worksheet by calling the `Protect` method on the object. +You can remove worksheet protection by calling the method on the object. The following code snippet shows how to enable protection of all of the above-listed user operations: @@ -234,11 +234,11 @@ worksheet.protect(); ## Worksheet Conditional Formatting -You can configure the conditional formatting of a object by using the many "Add" methods exposed on the `ConditionalFormats` collection of that worksheet. The first parameter of these "Add" methods is the `string` region of the worksheet that you would like to apply the conditional format to. +You can configure the conditional formatting of a object by using the many "Add" methods exposed on the collection of that worksheet. The first parameter of these "Add" methods is the `string` region of the worksheet that you would like to apply the conditional format to. -Many of the conditional formats that you can add to your worksheet have a property that determines the way that the elements should look when the condition in that conditional format holds true. For example, you can use the properties attached to this property such as `Fill` and `Font` to determine the background and font settings of your cells under a particular conditional format, respectively. +Many of the conditional formats that you can add to your worksheet have a property that determines the way that the elements should look when the condition in that conditional format holds true. For example, you can use the properties attached to this property such as and to determine the background and font settings of your cells under a particular conditional format, respectively. -There are a few conditional formats that do not have a property, as their visualization on the worksheet cell behaves differently. These conditional formats are the , , and `IconSetConditionalFormat`. +There are a few conditional formats that do not have a property, as their visualization on the worksheet cell behaves differently. These conditional formats are the , , and . When loading a pre-existing from Excel, the formats will be preserved when that is loaded. The same is true for when you save the out to an Excel file. diff --git a/docs/angular/src/content/en/components/general-changelog-dv.mdx b/docs/angular/src/content/en/components/general-changelog-dv.mdx index 9e15069d08..e31584c1a9 100644 --- a/docs/angular/src/content/en/components/general-changelog-dv.mdx +++ b/docs/angular/src/content/en/components/general-changelog-dv.mdx @@ -15,6 +15,8 @@ import chartdefaults3 from '@xplat-images/chartDefaults3.png'; import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Ignite UI for Angular Changelog All notable changes for each version of Ignite UI for Angular are documented on this page. @@ -76,9 +78,9 @@ Added OthersCategoryBrush and OthersCategoryOutline to DataPieChart and Proporti #### User Annotations -In Ignite UI for Angular, you can now annotate the `DataChart` with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. +In Ignite UI for Angular, you can now annotate the with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. +This is directly integrated with the available tools of the . Angular user-annotation-create @@ -86,8 +88,8 @@ This is directly integrated with the available tools of the `Toolbar`. Ability for axis annotations to automatically detect collisions and truncate to fit better. To enable this feature you must set the following properties: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### igniteui-angular-maps (Geographic Map) @@ -129,37 +131,37 @@ The following events have been added to the `IgxDataChart` to allow you to detec #### Companion Axis -Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the `CompanionAxisEnabled` property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. +Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. #### RadialPieSeries Inset Outlines -There is a new property called `UseInsetOutlines` to control how outlines on the `RadialPieSeries` are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. +There is a new property called to control how outlines on the are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### Enhancements #### IgxBulletGraph -- Added new `LabelsVisible` property +- Added new property #### Charts - New properties added to the DataToolTipLayer, ItemToolTipLayer, and CategoryToolTipLayer to aid in styling: `ToolTipBackground`, `ToolTipBorderBrush`, and `ToolTipBorderThickness` -- New properties added to the DataLegend to aid in styling: `ContentBackground`, `ContentBorderBrush`, and `ContentBorderThickness`. The `ContentBorderBrush` and `ContentBorderThickness` default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. +- New properties added to the DataLegend to aid in styling: , , and . The and default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. -- Added a new property to `ChartMouseEventArgs` called `WorldPosition` that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. +- Added a new property to called that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. -- Added `HighlightingFadeOpacity` to `SeriesViewer` and `DomainChart`. This allows you to configure the opacity applied to highlighted series. +- Added to and . This allows you to configure the opacity applied to highlighted series. - Expose `CalloutLabelUpdating` event for domain charts. #### IgxLinearGauge -- Added new `LabelsVisible` property +- Added new property ### Bug Fixes @@ -209,11 +211,11 @@ For more details please visit: - Data Annotation Slice Layer - Data Annotation Strip Layer -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. -- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. +- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. - [Trendline Layer](charts/features/chart-trendlines.md) series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple [TrendlineLayer](charts/features/chart-overlays.md) series types in the chart. @@ -250,9 +252,9 @@ For more details please visit: #### Toolbar -- Added new `GroupHeaderTextStyle` property to `Toolbar` and `ToolPanel`. If set, it will apply to all `ToolActionGroupHeader` actions. -- Added new property on `ToolAction` called `TitleHorizontalAlignment` which controls the horizontal alignment of the title text. -- Added new property on `ToolActionSubPanel` called `ItemSpacing` which controls the spacing between items inside the panel. +- Added new `GroupHeaderTextStyle` property to and . If set, it will apply to all actions. +- Added new property on called which controls the horizontal alignment of the title text. +- Added new property on called which controls the spacing between items inside the panel. ### Bug Fixes @@ -290,11 +292,11 @@ The following table lists the bug fixes made for the Ignite UI for Angular tools ## **18.1.0 (September 2024)** -- [Data Pie Chart](charts/types/data-pie-chart.md) - The `DataPieChart` is a new component that renders a pie chart. This component works similarly to the `CategoryChart`, 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. +- [Data Pie Chart](charts/types/data-pie-chart.md) - The is a new component that renders a pie chart. This component works similarly to the , 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. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -313,67 +315,67 @@ The following table lists the bug fixes made for the Ignite UI for Angular tools ### igniteui-angular-charts (Charts) -- [Data Legend Grouping](charts/features/chart-data-legend.md#angular-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#angular-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property `GroupRowVisible` toggles grouping with each series opting in can assign group text via the `DataLegendGroup` property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. +- [Data Legend Grouping](charts/features/chart-data-legend.md#angular-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#angular-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property toggles grouping with each series opting in can assign group text via the property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Treemap Highlighting](charts/types/treemap-chart.md#angular-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#angular-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#angular-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#angular-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via `FillBrushes`. -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### igniteui-angular-gauges (Gauges) -- `RadialGauge` - - New label for the highlight needle. `HighlightLabelText` and `HighlightLabelSnapsToNeedlePivot` and many other styling related properties for the HighlightLabel were added. +- + - New label for the highlight needle. and and many other styling related properties for the HighlightLabel were added. ## **17.3.0 (March 2024)** ### igniteui-angular-charts -- New Data Filtering via the `InitialFilter` property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. +- New Data Filtering via the property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### igniteui-angular-gauges -- `RadialGauge` - - New title/subtitle properties. `TitleText`, `SubtitleText` will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and `TitleExtent`. Finally, the new `TitleDisplaysValue` will allow the value to correspond with the needle's position. - - New `OpticalScalingEnabled` and `OpticalScalingSize` properties for the `RadialGauge`. This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `LinearGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `BulletGraph` - - The Performance bar will now reflect a difference between the value and new `HighlightValue` when the `HighlightValueDisplayMode` is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. +- + - New title/subtitle properties. , will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and . Finally, the new will allow the value to correspond with the needle's position. + - New and properties for the . This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - The Performance bar will now reflect a difference between the value and new when the is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. ## **17.2.0 (January 2024)** ### igniteui-angular-charts (Charts) -- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The `CategoryChart` and `DataChart` now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. +- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The and now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. ## **17.0.0 (November 2023)** ### igniteui-angular - Toolbar - - Save tool action has been added to save the chart to an image via the clipboard. -- Vertical orientation has been added via the toolbar's `Orientation` property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. +- Vertical orientation has been added via the toolbar's property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's `renderImageFromText` method, further enhancing custom tool creation. ## **16.1.0 (June 2023)** ### New Components -- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our `DataChart` or `CategoryChart` components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. +- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our or components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. ### igniteui-angular-charts (Charts) -- [ValueLayer](charts/features/chart-overlays.md#angular-value-layer) - A new series type named the `ValueLayer` is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the `CategoryChart` and `FinancialChart` by adding to the new `ValueLines` collection. +- [ValueLayer](charts/features/chart-overlays.md#angular-value-layer) - A new series type named the is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the and by adding to the new collection. -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#angular-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#angular-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#angular-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#angular-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#angular-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#angular-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **16.0.0 (May 2023)** - Angular 16 support. @@ -388,7 +390,7 @@ Added significant improvements to default behaviors, and refined the Category Ch - Responsive layouts for horizontal label rotation based on browser / screen size. - Enhanced rendering for rounded labels on all platforms. - Added marker properties to StackedFragmentSeries. -- Added `ShouldPanOnMaximumZoom` property. +- Added property. - New Category Axis Properties: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -409,25 +411,25 @@ Added significant improvements to default behaviors, and refined the Category Ch - GroupSortDescriptions -The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties` because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using | because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ## **13.2.0 (June 2022)** ### igniteui-angular-charts (Charts) -- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the `Legend`, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. +- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the , but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable [DataToolTip](charts/features/chart-data-tooltip.md) which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types. -- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the `IsTransitionInEnabled` property to true. From there, you can set the `TransitionInDuration` property to determine how long your animation should take to complete and the `TransitionInMode` to determine the type of animation that takes place. -- Added `AssigningCategoryStyle` event, is now available to all series in `DataChart`. This event is handled when you want to conditionally configure aspects of the series items such as `Fill` background-color and highlighting. -- New `AllowedPositions` enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. +- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the property to true. From there, you can set the property to determine how long your animation should take to complete and the to determine the type of animation that takes place. +- Added `AssigningCategoryStyle` event, is now available to all series in . This event is handled when you want to conditionally configure aspects of the series items such as background-color and highlighting. +- New enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default. - - `CalloutCornerRadius` for CalloutLayer - - `AxisAnnotationBackgroundCornerRadius` for FinalValueLayer - - `XAxisAnnotationBackgroundCornerRadius` and `YAxisAnnotationBackgroundCornerRadius` for CrosshairLayer -- New `HorizontalViewScrollbarMode` and `VerticalViewScrollbarMode` enumeration to enable scrollbars in various ways. When paired with `IsVerticalZoomEnabled` or `IsHorizontalZoomEnabled`, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. -- New `FavorLabellingScaleEnd`, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. `NumericXAxis`, `NumericYAxis`, `PercentChangeAxis`). -- New `IsSplineShapePartOfRange` determines whether to include the spline shape in the axis range requested of the axis. -- New `XAxisMaximumGap`, determines the maximum allowed value for the plotted series when using `XAxisGap`. The gap determines the amount of space between columns or bars of plotted series. -- New `XAxisMinimumGapSize`, determines the minimum allowed pixel-based value for the plotted series when using `XAxisGap` to ensure there is always some spacing between each category. + - for CalloutLayer + - for FinalValueLayer + - and for CrosshairLayer +- New and enumeration to enable scrollbars in various ways. When paired with or , you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. +- New , determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. , , `PercentChangeAxis`). +- New determines whether to include the spline shape in the axis range requested of the axis. +- New , determines the maximum allowed value for the plotted series when using . The gap determines the amount of space between columns or bars of plotted series. +- New , determines the minimum allowed pixel-based value for the plotted series when using to ensure there is always some spacing between each category.
@@ -441,29 +443,29 @@ Please ensure package "lit-html": "^2.0.0" or newer is added to your project for This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -475,30 +477,30 @@ This release introduces a few improvements and simplifications to visual design ## **11.2.0 (April 2021)** ### igniteui-angular-charts (Charts) -This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. `DataChart`, `CategoryChart`, and `FinancialChart`. +This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. , , and . - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners - Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000 - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -521,8 +523,8 @@ for example: #### Chart Legend -- Added horizontal `Orientation` property to ItemLegend that can be used with Bubble, Donut, and Pie Chart -- Added `LegendHighlightingMode` property - Enables series highlighting when hovering over legend items +- Added horizontal property to ItemLegend that can be used with Bubble, Donut, and Pie Chart +- Added property - Enables series highlighting when hovering over legend items ### igniteui-angular-maps (GeoMap) diff --git a/docs/angular/src/content/en/components/general/cli/getting-started-with-angular-schematics.mdx b/docs/angular/src/content/en/components/general/cli/getting-started-with-angular-schematics.mdx index d28f4884ca..43e88ff780 100644 --- a/docs/angular/src/content/en/components/general/cli/getting-started-with-angular-schematics.mdx +++ b/docs/angular/src/content/en/components/general/cli/getting-started-with-angular-schematics.mdx @@ -301,7 +301,7 @@ The schematic writes (or merges into) the config file for your chosen coding ass Skill files are Angular-specific guides copied into each agent's skills directory. They are sourced from your installed Ignite UI package and kept in sync each time you run the schematic - existing files are only updated if their content has changed. - + If you run `ai-config` before installing packages (e.g. with `--skip-install`), the schematic falls back to built-in templates. Re-run the command after installing to pick up the skill files from your installed version. @@ -313,7 +313,7 @@ If you have the Ignite UI CLI installed globally, the equivalent command is: ig ai-config ``` - + The `ig ai-config` command configures only the two Ignite UI entries, `igniteui-cli` and `igniteui-theming`, and does not register `angular-cli`. Use `ng generate @igniteui/angular-schematics:ai-config` to get all three servers configured in a single step. diff --git a/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-angular-schematics.mdx b/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-angular-schematics.mdx index d50467c870..7781e2ad9d 100644 --- a/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-angular-schematics.mdx +++ b/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-angular-schematics.mdx @@ -149,7 +149,7 @@ The default selections are **Generic** and **Claude**. Selecting **None** skips When run via the Angular schematic, an additional `angular-cli` MCP server entry is included automatically alongside the Ignite UI servers. - + To skip AI configuration prompts entirely during non-interactive project creation, pass `--assistants none --agents none` to `ng new`. To re-run AI configuration later, use `ng generate @igniteui/angular-schematics:ai-config` from the project root. diff --git a/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-cli.mdx b/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-cli.mdx index 777abf2b4e..29b3da7f85 100644 --- a/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-cli.mdx +++ b/docs/angular/src/content/en/components/general/cli/step-by-step-guide-using-cli.mdx @@ -133,6 +133,6 @@ Next, you will be prompted to select which AI agents to configure skill files an The default selections are **Generic** and **Claude**. Selecting **None** skips agent configuration entirely. - + To skip AI configuration prompts entirely during non-interactive project creation, pass `--assistants none --agents none` to `ig new`. To re-run AI configuration later, use `ig ai-config` from the project root. diff --git a/docs/angular/src/content/en/components/general/localization.mdx b/docs/angular/src/content/en/components/general/localization.mdx index a756d04581..116e50b186 100644 --- a/docs/angular/src/content/en/components/general/localization.mdx +++ b/docs/angular/src/content/en/components/general/localization.mdx @@ -11,7 +11,7 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' ## Localization (i18n) - + As of 21.1.0 this is the recommended way of applying localization to the Ignite UI for Angular components. @@ -23,7 +23,7 @@ Currently, Ignite UI for Angular ships with resource strings for the following l - + Hindi (HI) included in the sample is only for illustrational purposes and to emphasize on the possibility to pass a custom localization object. In this sample, it contains only several localized strings for the summary. More details at [Custom localized resource strings](#custom-localized-resource-strings) section below. @@ -51,7 +51,7 @@ In general you should register your resources under the languages, regions and s With this approach we have the ability to set localization through the `lang` global attribute of the `HTML` tag. This attribute is being watched and if it is changed, all rendered components will update their resource strings to the currently set language. All rules regarding the tag used apply as described above. - + This works only on root level and will not work for inner elements on the page. @@ -243,7 +243,7 @@ public resourcesDE = GridResourceStringsDE; If you would like to localize your app, but we do not provide resource strings for the language you use and would like to provide your own translation, you can always provide custom resource string. You can do that globally or per component(using the `resourceStrings` property). - + Feel free to contribute to the [`igniteui-i18n-resources`](https://github.com/IgniteUI/igniteui-i18n/tree/master/projects/igniteui-i18n-resources) package with more languages. The `igniteui-angular-i18n` are based on them. @@ -293,7 +293,7 @@ registerI18n(customResources, 'en'); ``` - + The last examples set only specific resource strings. This means that the rest will default to English, if they are not available for the components in use to get. @@ -322,7 +322,7 @@ The last examples set only specific resource strings. This means that the rest w ## Legacy Localization (i18n) - + This is an old way of handling localization that was recommended until 21.0.x. We suggest using the new available way above if you are using newer versions. This will still work until further notice. @@ -334,7 +334,7 @@ With only a few lines of code, users can easily change the localization strings - + Hindi (HI) included in the sample is only for illustrational purposes and to emphasize on the possibility to pass a custom localization object. In this sample, it contains only several localized strings for the summary. More details at [Utilize own localized resources](#utilize-own-localized-resources) section below. @@ -410,7 +410,7 @@ export class AppComponent implements OnInit { } ``` - + Feel free to contribute to the [`igniteui-angular-i18n`](https://github.com/IgniteUI/igniteui-angular/tree/master/projects/igniteui-angular-i18n) package with more languages! diff --git a/docs/angular/src/content/en/components/geo-map-binding-data-model.mdx b/docs/angular/src/content/en/components/geo-map-binding-data-model.mdx index 18be1b6724..ed3cf2101c 100644 --- a/docs/angular/src/content/en/components/geo-map-binding-data-model.mdx +++ b/docs/angular/src/content/en/components/geo-map-binding-data-model.mdx @@ -27,13 +27,13 @@ The following table summarized data structures required for each type of geograp | Geographic Series | Properties | Description | |--------------|---------------| ---------------| -| | `LongitudeMemberPath`, `LatitudeMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates | -| | `LongitudeMemberPath`, `LatitudeMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates | -| | `LongitudeMemberPath`, `LatitudeMemberPath`, `RadiusMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for size/radius of symbols | -| | `LongitudeMemberPath`, `LatitudeMemberPath`, `ColorMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | -| | `LongitudeMemberPath`, `LatitudeMemberPath`, `ValueMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | -||`ShapeMemberPath`|Specifies the name of data column of items that contains the geographic points of shapes. This property must be mapped to an array of arrays of objects with x and y properties. | -||`ShapeMemberPath`|Specifies the name of data column of items that contains the geographic coordinates of lines. This property must be mapped to an array of arrays of objects with x and y properties. | +| | , | Specifies names of 2 numeric longitude and latitude coordinates | +| | , | Specifies names of 2 numeric longitude and latitude coordinates | +| | , , | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for size/radius of symbols | +| | , , | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | +| | , , | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | +|||Specifies the name of data column of items that contains the geographic points of shapes. This property must be mapped to an array of arrays of objects with x and y properties. | +|||Specifies the name of data column of items that contains the geographic coordinates of lines. This property must be mapped to an array of arrays of objects with x and y properties. | ## Code Snippet The following code shows how to bind the to a custom data model that contains geographic locations of some cities of the world stored using longitude and latitude coordinates. Also, we use the to plot shortest geographic path between these locations using the [WorldUtility](geo-map-resources-world-util.md) diff --git a/docs/angular/src/content/en/components/geo-map-display-imagery-types.mdx b/docs/angular/src/content/en/components/geo-map-display-imagery-types.mdx index 1b3a70a1ab..2aafd2019d 100644 --- a/docs/angular/src/content/en/components/geo-map-display-imagery-types.mdx +++ b/docs/angular/src/content/en/components/geo-map-display-imagery-types.mdx @@ -33,7 +33,7 @@ The following table summarizes imagery classes provided by the map component. ||Represents the base control for all imagery classes that display all types of supported geographic imagery tiles. This class can be extended for the purpose of implementing support for geographic imagery tiles from other geographic imagery sources such as Map Quest mapping service.| ||Represents the multi-scale imagery control for displaying geographic imagery tiles from the Open Street Maps service.| -{/* |`BingMapsMapImagery`|Represents the multi-scale imagery control for displaying geographic imagery tiles from the Bing Maps service.| */} +{/* ||Represents the multi-scale imagery control for displaying geographic imagery tiles from the Bing Maps service.| */} By default, the property is set to object and the map component displays geographic imagery tiles from the Open Street Maps service. In order to display different types of geographic imagery tiles, the map component must be re-configured. @@ -52,6 +52,6 @@ This code example explicitly sets +


diff --git a/docs/angular/src/content/en/components/geo-map-type-scatter-bubble-series.mdx b/docs/angular/src/content/en/components/geo-map-type-scatter-bubble-series.mdx index 2a7fd096cc..925c5f5557 100644 --- a/docs/angular/src/content/en/components/geo-map-type-scatter-bubble-series.mdx +++ b/docs/angular/src/content/en/components/geo-map-type-scatter-bubble-series.mdx @@ -25,19 +25,19 @@ In Angular map component, you can use the series and how to specify data binding options of the series. Automatic marker selection is configured along with marker collision avoidance logic, and marker outline and fill colors are specified too. ## Configuration Summary -Similar to other types of scatter series in the map control, the series has the `ItemsSource` property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the `LongitudeMemberPath` and `LatitudeMemberPath` properties to map these data columns. The `RadiusScale` and `RadiusMemberPath` will settings configures the radius for the bubbles. +Similar to other types of scatter series in the map control, the series has the property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the and properties to map these data columns. The and will settings configures the radius for the bubbles. The following table summarizes the GeographicHighDensityScatterSeries series properties used for data binding. | Property|Type|Description | | ---|---|--- | -| `ItemsSource`|any|Gets or sets the items source | -| `LongitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | -| `LatitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | -| `RadiusMemberPath`|string|Sets the path to use to get the radius values for the series. | -| `RadiusScale`|`SizeScale`|Gets or sets the radius scale property for the current bubble series. | -| `MinimumValue`|any|Configure the minimum value for calculating value sub ranges. | -| `MaximumValue`|any|Configure the maximum value for calculating value sub ranges. | +| |any|Gets or sets the items source | +| |string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | +| |string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | +| |string|Sets the path to use to get the radius values for the series. | +| ||Gets or sets the radius scale property for the current bubble series. | +| |any|Configure the minimum value for calculating value sub ranges. | +| |any|Configure the maximum value for calculating value sub ranges. | ## Code Snippet @@ -179,4 +179,4 @@ export class MapTypeScatterBubbleSeriesComponent implements AfterViewInit { ## API References
-`RadiusScale`
+
diff --git a/docs/angular/src/content/en/components/geo-map-type-scatter-contour-series.mdx b/docs/angular/src/content/en/components/geo-map-type-scatter-contour-series.mdx index 6d1b4b1fdf..8163bf42a6 100644 --- a/docs/angular/src/content/en/components/geo-map-type-scatter-contour-series.mdx +++ b/docs/angular/src/content/en/components/geo-map-type-scatter-contour-series.mdx @@ -25,33 +25,33 @@ In Angular map component, you can use the works a lot like the except that it represents data as contour lines, colored using a fill scale and the geographic scatter area series, represents data as a surface interpolated using a color scale. ## Data Requirements -Similar to other types of geographic series in the map component, the has the `ItemsSource` property which can be bound to an array of objects. In addition, each item in the items source must have three data columns, two that store geographic location (longitude and latitude coordinates) and one data column that stores a value associated with the geographic location. These data column, are identified by `LongitudeMemberPath`, `LatitudeMemberPath`, and `ValueMemberPath` properties of the geographic series. -The `GeographicContourLineSeries` automatically performs built-in data triangulation on items in the ItemsSource if no triangulation is set to the `TrianglesSource` property. However, computing triangulation can be a very time-consuming process, so the runtime performance will be better when specifying a `TriangulationSource` for this property, especially when a large number of data items are present. +Similar to other types of geographic series in the map component, the has the property which can be bound to an array of objects. In addition, each item in the items source must have three data columns, two that store geographic location (longitude and latitude coordinates) and one data column that stores a value associated with the geographic location. These data column, are identified by , , and properties of the geographic series. +The automatically performs built-in data triangulation on items in the ItemsSource if no triangulation is set to the property. However, computing triangulation can be a very time-consuming process, so the runtime performance will be better when specifying a `TriangulationSource` for this property, especially when a large number of data items are present. ## Data Binding -The following table summarizes properties of `GeographicContourLineSeries` used for data binding. +The following table summarizes properties of used for data binding. | Property Name | Property Type | Description | |--------------|---------------| ---------------| -|`ItemsSource`|any|The source of data items to perform triangulation on if the `TrianglesSource` property provides no triangulation data.| -|`LongitudeMemberPath`|string|The name of the property containing the Longitude for all items bound to the `ItemsSource`.| -|`LatitudeMemberPath`|string|The name of the property containing the Latitude for all items bound to to the `ItemsSource`.| -|`ValueMemberPath`|string|The name of the property containing a value at Latitude and Longitude coordinates of each data item. This numeric value will be be converted to a color when the `FillScale` property is set.| -|`TrianglesSource`|any|Gets or sets the source of triangulation data. Setting Triangles of the TriangulationSource object to this property improves both runtime performance and geographic series rendering.| -|`TriangleVertexMemberPath1`|string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| -|`TriangleVertexMemberPath2`|string| The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| -|`TriangleVertexMemberPath3`|string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| +||any|The source of data items to perform triangulation on if the property provides no triangulation data.| +||string|The name of the property containing the Longitude for all items bound to the .| +||string|The name of the property containing the Latitude for all items bound to to the .| +||string|The name of the property containing a value at Latitude and Longitude coordinates of each data item. This numeric value will be be converted to a color when the property is set.| +||any|Gets or sets the source of triangulation data. Setting Triangles of the TriangulationSource object to this property improves both runtime performance and geographic series rendering.| +||string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| +||string| The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| +||string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| ## Contour Fill Scale -Use the `FillScale` property of the to resolve fill brushes of the contour lines of the geographic series. +Use the property of the to resolve fill brushes of the contour lines of the geographic series. The provided `ValueBrushScale class should satisfy most of your coloring needs, but the application for custom coloring logic can inherit the ValueBrushScale class. The following table list properties of the CustomPaletteColorScale affecting the surface coloring of the GeographicContourLineSeries. | Property Name | Property Type | Description | |--------------|---------------| ---------------| -|`Brushes`|BrushCollection|Gets or sets the collection of brushes for filling contours of the `GeographicContourLineSeries`| -|`MaximumValue`|double|The highest value to assign a brush in a fill scale.| -|`MinimumValue`|double|The lowest value to assign a brush in a fill scale.| +||BrushCollection|Gets or sets the collection of brushes for filling contours of the | +||double|The highest value to assign a brush in a fill scale.| +||double|The lowest value to assign a brush in a fill scale.| ## Code Snippet @@ -180,7 +180,7 @@ export class MapTypeScatterContourSeriesComponent implements AfterViewInit { ## API References -`FillScale`
+



diff --git a/docs/angular/src/content/en/components/geo-map-type-scatter-density-series.mdx b/docs/angular/src/content/en/components/geo-map-type-scatter-density-series.mdx index e25a7044a4..763bef0874 100644 --- a/docs/angular/src/content/en/components/geo-map-type-scatter-density-series.mdx +++ b/docs/angular/src/content/en/components/geo-map-type-scatter-density-series.mdx @@ -27,30 +27,30 @@ The demo above shows the series has the `ItemsSource` property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the `LongitudeMemberPath` and `LatitudeMemberPath` properties to map these data columns. +Similar to other types of scatter series in the map control, the series has the property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the and properties to map these data columns. ### Data Binding The following table summarizes the GeographicHighDensityScatterSeries series properties used for data binding. | Property|Type|Description | | ---|---|--- | -| `ItemsSource`|any|Gets or sets the items source | -| `LongitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | -| `LatitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | +| |any|Gets or sets the items source | +| |string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | +| |string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | ## Heat Color Scale The Heat Color Scale, an optional feature, determines the color pattern within the series. The following table summarizes the properties used for determining the color scale. | Property |Type|Description | | ---|---|--- | -| `HeatMinimum`|Double|Defines the double value representing the minimum end of the color scale | -| `HeatMaximum`|Double|Defines the double value representing the maximum end of the color scale | -| `HeatMinimumColor`|Color|Defines the point density color used at the bottom end of the color scale | -| `HeatMaximumColor`|Color|Defines the point density color used at the top end of the color scale | +| |Double|Defines the double value representing the minimum end of the color scale | +| |Double|Defines the double value representing the maximum end of the color scale | +| |Color|Defines the point density color used at the bottom end of the color scale | +| |Color|Defines the point density color used at the top end of the color scale | ## Code Example -The following code demonstrates how set the `HeatMinimumColor` and `HeatMaximumColor` properties of the +The following code demonstrates how set the and properties of the diff --git a/docs/angular/src/content/en/components/grid/grid.mdx b/docs/angular/src/content/en/components/grid/grid.mdx index eafe4f9b25..8bbfe4278b 100644 --- a/docs/angular/src/content/en/components/grid/grid.mdx +++ b/docs/angular/src/content/en/components/grid/grid.mdx @@ -231,7 +231,7 @@ Whenever a header template is used along with grouping/moving functionality the ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/icon-button.mdx b/docs/angular/src/content/en/components/icon-button.mdx index b8987dc80c..f7760f9334 100644 --- a/docs/angular/src/content/en/components/icon-button.mdx +++ b/docs/angular/src/content/en/components/icon-button.mdx @@ -52,7 +52,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/icon-service.mdx b/docs/angular/src/content/en/components/icon-service.mdx index bbf8e5162d..79b2fdbdce 100644 --- a/docs/angular/src/content/en/components/icon-service.mdx +++ b/docs/angular/src/content/en/components/icon-service.mdx @@ -66,7 +66,7 @@ Having registered the two font families above, we can now consume their icons in ``` - + To render icons from the default `material` family with `igx-icon`, add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/inputs/color-editor.mdx b/docs/angular/src/content/en/components/inputs/color-editor.mdx index 694935776f..c5b1a0c220 100644 --- a/docs/angular/src/content/en/components/inputs/color-editor.mdx +++ b/docs/angular/src/content/en/components/inputs/color-editor.mdx @@ -31,7 +31,7 @@ npm install igniteui-angular-core npm install igniteui-angular-inputs ``` -Before using the , you need to register the following modules as follows: +Before using the `ColorEditor`, you need to register the following modules as follows: @@ -47,7 +47,7 @@ Before using the , you need to regist ## Usage -The simplest way to start using the is as follows: +The simplest way to start using the `ColorEditor` is as follows: @@ -107,7 +107,7 @@ public onValueChanged = (e: any) => { ## API References -
+`ColorEditor`
## Additional Resources diff --git a/docs/angular/src/content/en/components/linear-gauge.mdx b/docs/angular/src/content/en/components/linear-gauge.mdx index 03d8d50a3d..43df820ef3 100644 --- a/docs/angular/src/content/en/components/linear-gauge.mdx +++ b/docs/angular/src/content/en/components/linear-gauge.mdx @@ -152,7 +152,7 @@ This is the primary measure displayed by the linear gauge component and is visua ## Highlight Needle -The linear gauge can be modified to show a second needle. This will make the main needle's `Value` appear with a lower opacity. To enable this first set `HighlightValueDisplayMode` to Overlay and then apply a `HighlightValue`. +The linear gauge can be modified to show a second needle. This will make the main needle's appear with a lower opacity. To enable this first set to Overlay and then apply a . @@ -335,7 +335,7 @@ The backing element represents background and border of the linear gauge compone ## Scale -The scale is a visual element that highlights the full range of values in the linear gauge. You can customize the appearance and the shape of the scale. It can also be inverted (using `IsScaleInverted` property) and all labels will be rendered from right-to-left instead of left-to-right. +The scale is a visual element that highlights the full range of values in the linear gauge. You can customize the appearance and the shape of the scale. It can also be inverted (using property) and all labels will be rendered from right-to-left instead of left-to-right. diff --git a/docs/angular/src/content/en/components/linear-progress.mdx b/docs/angular/src/content/en/components/linear-progress.mdx index dd94eac12f..01f9bacbcd 100644 --- a/docs/angular/src/content/en/components/linear-progress.mdx +++ b/docs/angular/src/content/en/components/linear-progress.mdx @@ -187,7 +187,7 @@ Let's take a look at how this turned out: If the input value is not defined, the progress update is **1% of the value**. In case you want the progress to be faster, the value should be greater than (** * 1%**), respectfully for slower progress the should be less than the default progress update.
- + If the value is defined greater than the input, there is only one update, which gets **the value that is passed for progress update**. @@ -215,7 +215,7 @@ You can dynamically change the value of the progress bar by using external contr ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/maps/map-api.mdx b/docs/angular/src/content/en/components/maps/map-api.mdx index ac82ea229f..f85febb1f1 100644 --- a/docs/angular/src/content/en/components/maps/map-api.mdx +++ b/docs/angular/src/content/en/components/maps/map-api.mdx @@ -6,89 +6,91 @@ license: commercial mentionedTypes: ["GeographicMap", "Series", "SeriesViewer", "GeographicSymbolSeries", "GeographicProportionalSymbolSeries", "GeographicShapeSeries", "GeographicHighDensityScatterSeries", "GeographicScatterAreaSeries", "GeographicContourLineSeries", "GeographicShapeSeriesBase"] namespace: Infragistics.Controls.Maps --- +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular Geographic Map API -The Angular `GeographicMap` has the following API members: +The Angular has the following API members: -- `Zoomable` -- `ZoomToGeographic` -- `WorldRect` -- `WindowRect` -- `WindowScale` -- `GetGeographicFromZoom` -- `GetGeographicPoint` -- `GetPixelPoint` +- +- +- +- +- +- +- +- ## Angular Geographic Series Types -The Angular `GeographicMap` has 7 types of series and they have the `ItemsSource` property for data binding. +The Angular has 7 types of series and they have the property for data binding. -- `GeographicHighDensityScatterSeries` -- `GeographicSymbolSeries` -- `GeographicProportionalSymbolSeries` -- `GeographicPolylineSeries` -- `GeographicShapeSeries` -- `GeographicScatterAreaSeries` -- `GeographicContourLineSeries` +- +- +- +- +- +- +- In addition, each type of series has specific properties for mapping data items and styling their appearance: ## Angular Geographic Symbol Series API -The Angular `GeographicSymbolSeries` (Geographic Marker Series) has the following API members: +The Angular (Geographic Marker Series) has the following API members: -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `MarkerType` -- `MarkerBrush` -- `MarkerOutline` +- +- +- +- +- ## Angular Geographic Bubble Series API -The Angular `GeographicProportionalSymbolSeries` (Geographic Bubble Series) has the following API members: +The Angular (Geographic Bubble Series) has the following API members: -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `RadiusMemberPath` -- `RadiusScale` -- `FillScale` -- `FillMemberPath` +- +- +- +- +- +- ## Angular Geographic Shape Series API -The Angular `GeographicShapeSeries` and `GeographicPolylineSeries` have the same API members: +The Angular and have the same API members: -- `ShapeMemberPath` -- `Thickness` -- `Brush` -- `Outline` +- +- +- +- ## Angular Geographic Area Series API -The Angular `GeographicScatterAreaSeries` has the following API members: +The Angular has the following API members: -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `ColorMemberPath` -- `ColorScale` +- +- +- +- ## Angular Geographic Contour Series API -The Angular `GeographicContourLineSeries` has the following API members: +The Angular has the following API members: -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `ValueMemberPath` -- `FillScale` +- +- +- +- ## Angular Geographic HD Series API -The Angular `GeographicHighDensityScatterSeries` has the following API members: +The Angular has the following API members: -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `HeatMaximumColor` -- `HeatMinimumColor` \ No newline at end of file +- +- +- +- \ No newline at end of file diff --git a/docs/angular/src/content/en/components/mask.mdx b/docs/angular/src/content/en/components/mask.mdx index 6d21187236..5fd8fc6d6a 100644 --- a/docs/angular/src/content/en/components/mask.mdx +++ b/docs/angular/src/content/en/components/mask.mdx @@ -78,7 +78,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/menus/toolbar.mdx b/docs/angular/src/content/en/components/menus/toolbar.mdx index 9175bfc5bd..eccb663c94 100644 --- a/docs/angular/src/content/en/components/menus/toolbar.mdx +++ b/docs/angular/src/content/en/components/menus/toolbar.mdx @@ -30,7 +30,7 @@ npm install igniteui-angular-charts npm install igniteui-angular-core ``` -The following modules are required when using the with the component and it's features. +The following modules are required when using the with the component and it's features. @@ -58,21 +58,6 @@ export class AppModule {} -```ts -import { IgxToolbarModule } from 'igniteui-react-layouts'; -import { IgrDataChartToolbarModule, IgrDataChartCoreModule, IgrDataChartCategoryModule, IgrDataChartAnnotationModule, IgrDataChartInteractivityModule, IgrDataChartCategoryTrendLineModule } from 'igniteui-react-charts'; - -IgxToolbarModule.register(); -IgrDataChartToolbarModule.register(); -IgrDataChartCoreModule.register(); -IgrDataChartCategoryModule.register(); -IgrDataChartAnnotationModule.register(); -IgrDataChartInteractivityModule.register(); -IgrDataChartCategoryTrendLineModule.register(); -``` - - - @@ -85,29 +70,29 @@ IgrDataChartCategoryTrendLineModule.register(); ### Tool Actions -The following is a list of the different items that you can add to the Toolbar. +The following is a list of the different items that you can add to the Toolbar. -- -- -- -- -- -- -- -- +- +- +- +- +- +- +- +- -Each of these tools exposes an event that is triggered by mouse click. Note, the is a wrapper for other tools that can also be wrapped inside a . +Each of these tools exposes an `OnCommand` event that is triggered by mouse click. Note, the is a wrapper for other tools that can also be wrapped inside a . -New and existing tools can be repositioned and marked hidden using the , and properties on the object. ToolActions also expose a property. +New and existing tools can be repositioned and marked hidden using the , and properties on the object. ToolActions also expose a property. -The following example demonstrates a couple of features. First you can group tools together in the `ToolActionSubPanel` including hiding built in tools such as the **ZoomReset** and **AnalyzeMenu** menu tool actions. In this example a new instance of the **ZoomReset** tool action within the **ZoomMenu** by using the the `AfterId` property and assigning that to **ZoomOut** to be precise with it's placement. It is also highlighted via the property on the tool. +The following example demonstrates a couple of features. First you can group tools together in the including hiding built in tools such as the **ZoomReset** and **AnalyzeMenu** menu tool actions. In this example a new instance of the **ZoomReset** tool action within the **ZoomMenu** by using the the property and assigning that to **ZoomOut** to be precise with it's placement. It is also highlighted via the property on the tool. ### Angular Data Chart Integration -The Angular Toolbar contains a property. This is used to link a component, such as the as shown in the code below: +The Angular Toolbar contains a property. This is used to link a component, such as the as shown in the code below: @@ -136,47 +121,47 @@ The Angular Toolbar contains a items and menus become available when the is linked with the Toolbar. Here is a list of the built-in Angular `DataChart` Tool Actions and their associated `OverlayId`: +Several pre-existing items and menus become available when the is linked with the Toolbar. Here is a list of the built-in Angular Tool Actions and their associated : Zooming Actions -- `ZoomMenu`: A `ToolActionIconMenu` that exposes three `ToolActionLabel` items to invoke the `ZoomIn` and `ZoomOut` methods on the chart for increasing/decreasing the chart's zoom level including `ZoomReset`, a `ToolActionLabel` that invokes the `ResetZoom` method on the chart to reset the zoom level to it's default position. +- `ZoomMenu`: A that exposes three items to invoke the and methods on the chart for increasing/decreasing the chart's zoom level including `ZoomReset`, a that invokes the method on the chart to reset the zoom level to it's default position. Trend Actions -- `AnalyzeMenu`: A `ToolActionIconMenu` that contains several options for configuring different options of the chart. +- `AnalyzeMenu`: A that contains several options for configuring different options of the chart. - `AnalyzeHeader`: A sub section header. - `LinesMenu`: A sub menu containing various tools for showing different dashed horizontal lines on the chart. - `LinesHeader`: A sub menu section header for the following three tools: - - `MaxValue`: A `ToolActionCheckbox` that displays a dashed horizontal line along the yAxis at the maximum value of the series. - - `MinValue`: A `ToolActionCheckbox` that displays a dashed horizontal line along the yAxis at the minimum value of the series. - - `Average`: A `ToolActionCheckbox` that displays a dashed horizontal line along the yAxis at the average value of the series. - - `TrendsMenu`: A sub menu containing tools for applying various trendlines to the `DataChart` plot area. + - `MaxValue`: A that displays a dashed horizontal line along the yAxis at the maximum value of the series. + - `MinValue`: A that displays a dashed horizontal line along the yAxis at the minimum value of the series. + - : A that displays a dashed horizontal line along the yAxis at the average value of the series. + - `TrendsMenu`: A sub menu containing tools for applying various trendlines to the plot area. - `TrendsHeader`: A sub menu section header for the following three tools: - - **Exponential**: A `ToolActionRadio` that sets the `TrendLineType` on each series in the chart to **ExponentialFit**. - - **Linear**: A `ToolActionRadio` that sets the `TrendLineType` on each series in the chart to **LinearFit**. - - **Logarithmic**: A `ToolActionRadio` that sets the `TrendLineType` on each series in the the chart to **LogarithmicFit**. + - **Exponential**: A that sets the on each series in the chart to **ExponentialFit**. + - **Linear**: A that sets the on each series in the chart to **LinearFit**. + - **Logarithmic**: A that sets the on each series in the the chart to **LogarithmicFit**. - `HelpersHeader`: A sub section header. - - `SeriesAvg`: A `ToolActionCheckbox` that adds or removes a `ValueLayer` to the chart's series collection using the `ValueLayerValueMode` of type `Average`. - - `ValueLabelsMenu`: A sub menu containing various tools for showing different annotations on the `DataChart`'s plot area. + - `SeriesAvg`: A that adds or removes a to the chart's series collection using the of type . + - `ValueLabelsMenu`: A sub menu containing various tools for showing different annotations on the 's plot area. - `ValueLabelsHeader`: A sub menu section header for the following tools: - - `ShowValueLabels`: A `ToolActionCheckbox` that toggles data point values by using a `CalloutLayer`. - - `ShowLastValueLabel`: A `ToolActionCheckbox` that toggles final value axis annotations by using a `FinalValueLayer`. -- `ShowCrosshairs`: A `ToolActionCheckbox` that toggles mouse-over crosshair annotations via the chart's `CrosshairsDisplayMode` property. -- `ShowGridlines`: A `ToolActionCheckbox` that toggles extra gridlines by applying a `MajorStroke` to the X-Axis. + - `ShowValueLabels`: A that toggles data point values by using a . + - `ShowLastValueLabel`: A that toggles final value axis annotations by using a . +- `ShowCrosshairs`: A that toggles mouse-over crosshair annotations via the chart's property. +- `ShowGridlines`: A that toggles extra gridlines by applying a `MajorStroke` to the X-Axis. Save to Image Action -- `CopyAsImage`: A `ToolActionLabel` that exposes an option to copy the chart to the clipboard. +- `CopyAsImage`: A that exposes an option to copy the chart to the clipboard. - `CopyHeader`: A sub section header. ### SVG Icons -When adding tools manually, icons can be assigned using the method. There are three parameters to pass in this method. The first is the icon collection name defined on the tool eg. `IconCollectionName`. The second is the name of the icon defined on the tool eg. `IconName`, followed by adding the SVG string. +When adding tools manually, icons can be assigned using the `RenderIconFromText` method. There are three parameters to pass in this method. The first is the icon collection name defined on the tool eg. . The second is the name of the icon defined on the tool eg. , followed by adding the SVG string. ### Data URL Icons -Similarly to adding svg, you can also add an Icon image from a URL via the . The method's third parameter would be used to enter a string URL. +Similarly to adding svg, you can also add an Icon image from a URL via the . The method's third parameter would be used to enter a string URL. The following snippet shows both methods of adding an Icon. @@ -235,7 +220,7 @@ public toolbarCustomIconOnViewInit(): void { ### Vertical Orientation -By default the Angular Toolbar is shown horizontally, but it also has the ability to shown vertically by setting the property. +By default the Angular Toolbar is shown horizontally, but it also has the ability to shown vertically by setting the property. @@ -289,7 +274,7 @@ The following example demonstrates styling the Angular Data Chart series brush w {/* ## Styling/Theming -The icon component can be styled by using it's `BaseTheme` property directly to the `Toolbar`. +The icon component can be styled by using it's property directly to the . @@ -312,7 +297,7 @@ The icon component can be styled by using it's `BaseTheme` property directly to ## API References -
+

## Additional Resources diff --git a/docs/angular/src/content/en/components/navbar.mdx b/docs/angular/src/content/en/components/navbar.mdx index 96c77a667d..677019567d 100644 --- a/docs/angular/src/content/en/components/navbar.mdx +++ b/docs/angular/src/content/en/components/navbar.mdx @@ -128,7 +128,7 @@ Next, we need to update our template with an icon button for each of the options ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/radial-gauge.mdx b/docs/angular/src/content/en/components/radial-gauge.mdx index f28bf1365a..36032d833e 100644 --- a/docs/angular/src/content/en/components/radial-gauge.mdx +++ b/docs/angular/src/content/en/components/radial-gauge.mdx @@ -121,7 +121,7 @@ The radial gauge component comes with a backing shape drawn behind the scale tha The backing element represents background and border of the radial gauge component. It is always the first element rendered and all the rest of elements such as needle, labels, and tick marks are overlay on top of it. -The backing can be circular or fitted. A circular shape creates a 360 degree circle gauge while a fitted shape creates a filled arc segment encompassing the `ScaleStartAngle` and `ScaleEndAngle` properties. This can be set by setting the `BackingShape` property. +The backing can be circular or fitted. A circular shape creates a 360 degree circle gauge while a fitted shape creates a filled arc segment encompassing the and properties. This can be set by setting the property. @@ -157,7 +157,7 @@ The backing can be circular or fitted. A circular shape creates a 360 degree cir ## Scale -The scale is visual element that highlights full range of values in the gauge which can be created by supplying `MinimumValue` and `MaximumValue` values. Together with backing, it defines overall shape of gauge. The `ScaleStartAngle` and `ScaleEndAngle` properties define bounds of arc of the scale. While, the `ScaleSweepDirection` property specifies whether the scale sweeps in clockwise or counter-clockwise direction. You can customize appearance of the scale by setting `ScaleBrush`, `ScaleStartExtent`, and `ScaleEndExtent` properties. +The scale is visual element that highlights full range of values in the gauge which can be created by supplying and values. Together with backing, it defines overall shape of gauge. The and properties define bounds of arc of the scale. While, the property specifies whether the scale sweeps in clockwise or counter-clockwise direction. You can customize appearance of the scale by setting , , and properties. @@ -192,9 +192,9 @@ The scale is visual element that highlights full range of values in the gauge wh ## Labels and Titles -The radial gauge labels are visual elements displaying numeric values at a specified interval between values of the `MinimumValue` and `MaximumValue` properties. You can position labels by setting the `LabelExtent` property to a fraction, where 0 represents center of gauge and 1 represents outer extent of the gauge backing. Also, you can customize labels setting various styling properties such as `FontBrush` and `Font`. +The radial gauge labels are visual elements displaying numeric values at a specified interval between values of the and properties. You can position labels by setting the property to a fraction, where 0 represents center of gauge and 1 represents outer extent of the gauge backing. Also, you can customize labels setting various styling properties such as and . -Each of these labels for the needle have various styling attributes you can apply to change the font, angle, brush and distance from the center of the gauge such as `TitleExtent`, `TitleAngle`, `SubtitleFontSize`, `HighlightLabelBrush`. +Each of these labels for the needle have various styling attributes you can apply to change the font, angle, brush and distance from the center of the gauge such as , , `SubtitleFontSize`, . @@ -224,9 +224,9 @@ Each of these labels for the needle have various styling attributes you can appl ## Title & Subtitle -`TitleText` and `SubtitleText` properties are available and can both be used to display custom text for the needle. Alternatively, `TitleDisplaysValue` and `SubtitleDisplaysValue`, when set to true, will let display the needle's value and override `TitleText` and `SubtitleText`. So you can occupy custom text for the title but show the value via the subtitle and vice versa. + and properties are available and can both be used to display custom text for the needle. Alternatively, and , when set to true, will let display the needle's value and override and . So you can occupy custom text for the title but show the value via the subtitle and vice versa. -If the highlight needle is shown, as explained below, then custom text can be shown via `HighlightLabelText`, otherwise `HighlightLabelDisplaysValue` can be enabled and display it's value. +If the highlight needle is shown, as explained below, then custom text can be shown via , otherwise can be enabled and display it's value. @@ -247,14 +247,14 @@ If the highlight needle is shown, as explained below, then custom text can be sh ## Optical Scaling -The radial gauge's labels and titles can change it's scaling. To enable this, first set `OpticalScalingEnabled` to true. Then you can set `OpticalScalingSize` which manages the size at which labels have 100% optical scaling. Labels will have larger fonts when gauge's size is larger. For example, labels will have a 200% larger font size when this property is set to 500 and the gauge px size is doubled to eg. 1000. +The radial gauge's labels and titles can change it's scaling. To enable this, first set to true. Then you can set which manages the size at which labels have 100% optical scaling. Labels will have larger fonts when gauge's size is larger. For example, labels will have a 200% larger font size when this property is set to 500 and the gauge px size is doubled to eg. 1000. ## Tick Marks -Tick marks are thin lines radiating from the center of the radial gauge. There are two types of tick marks: major and minor. Major tick marks are displayed at the `Interval` between the `MinimumValue` and `MaximumValue` properties. Use the `MinorTickCount` property to specify the number of minor tick marks displayed between each major tick mark. You can control the length of tick marks by setting a fraction (between 0 and 1) to `TickStartExtent`, `TickEndExtent`, `MinorTickStartExtent`, and `MinorTickEndExtent` properties. +Tick marks are thin lines radiating from the center of the radial gauge. There are two types of tick marks: major and minor. Major tick marks are displayed at the between the and properties. Use the property to specify the number of minor tick marks displayed between each major tick mark. You can control the length of tick marks by setting a fraction (between 0 and 1) to , , , and properties. @@ -290,7 +290,7 @@ Tick marks are thin lines radiating from the center of the radial gauge. There a ## Ranges -A range highlights a set of continuous values bound by a specified `MinimumValue` and `MaximumValue` properties. You can add multiple ranges to the radial gauge by specifying their starting and ending values. Each range has a few customization properties such as `Brush` and `Outline`. Alternatively, you can set `RangeBrushes` and `RangeOutlines` properties to a list of colors for the ranges. +A range highlights a set of continuous values bound by a specified and properties. You can add multiple ranges to the radial gauge by specifying their starting and ending values. Each range has a few customization properties such as and . Alternatively, you can set and properties to a list of colors for the ranges. @@ -330,9 +330,9 @@ A range highlights a set of continuous values bound by a specified `MinimumValue Radial gauge needles are visual elements used to signify a gauge set value. Needles are available in one of the several predefined shapes. The needle can have a pivot shape, which is placed in the center of the gauge. The pivot shape also takes one of the predefined shapes. Pivot shapes that include an overlay or an underlay can have a separate pivot brush applied to the shape. -The supported needle shapes and caps are set using the `NeedleShape` and `NeedlePivotShape` properties. +The supported needle shapes and caps are set using the and properties. -You can enable an interactive mode of the gauge (using `IsNeedleDraggingEnabled` property) and the end-user will be able to change value by dragging the needle between values of `MinimumValue` and `MaximumValue` properties. +You can enable an interactive mode of the gauge (using property) and the end-user will be able to change value by dragging the needle between values of and properties. @@ -370,7 +370,7 @@ You can enable an interactive mode of the gauge (using `IsNeedleDraggingEnabled` ## Highlight Needle -The radial gauge can be modified to show a second needle. This will make the main needle's `Value` appear with a lower opacity. To enable this first set `HighlightValueDisplayMode` to Overlay and then apply a `HighlightValue`. +The radial gauge can be modified to show a second needle. This will make the main needle's appear with a lower opacity. To enable this first set to Overlay and then apply a . diff --git a/docs/angular/src/content/en/components/select.mdx b/docs/angular/src/content/en/components/select.mdx index acd462de58..4f008e3414 100644 --- a/docs/angular/src/content/en/components/select.mdx +++ b/docs/angular/src/content/en/components/select.mdx @@ -91,7 +91,7 @@ Add the `igx-select` along with a list of items to choose from. We use + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/snackbar.mdx b/docs/angular/src/content/en/components/snackbar.mdx index 0bb32716c1..3aee474c21 100644 --- a/docs/angular/src/content/en/components/snackbar.mdx +++ b/docs/angular/src/content/en/components/snackbar.mdx @@ -224,7 +224,7 @@ Let’s create a list with contacts that can be deleted. When an item is deleted ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/spreadsheet-activation.mdx b/docs/angular/src/content/en/components/spreadsheet-activation.mdx index e38d651f68..61ec86b12c 100644 --- a/docs/angular/src/content/en/components/spreadsheet-activation.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-activation.mdx @@ -25,15 +25,15 @@ The Angular Spreadsheet component exposes properties that allow you to determine ## Activation Overview -The activation of the Angular control is split up between the cells, panes, and worksheets of the current of the spreadsheet. The three "active" properties are described below: +The activation of the Angular control is split up between the cells, panes, and worksheets of the current of the spreadsheet. The three "active" properties are described below: -- : Returns or sets the active cell in the spreadsheet. To set it, you must create a new instance of and pass in information about that cell, such as the column and row or the string address of the cell. -- : Returns the active pane in the currently active worksheet of the spreadsheet control. -- : Returns or sets the active worksheet in the of the spreadsheet control. This can be set by setting it to an existing worksheet in the attached to the spreadsheet. +- : Returns or sets the active cell in the spreadsheet. To set it, you must create a new instance of and pass in information about that cell, such as the column and row or the string address of the cell. +- : Returns the active pane in the currently active worksheet of the spreadsheet control. +- : Returns or sets the active worksheet in the of the spreadsheet control. This can be set by setting it to an existing worksheet in the attached to the spreadsheet. ## Code Snippet -The following code snippet shows setting activation of the cell and worksheet in the control: +The following code snippet shows setting activation of the cell and worksheet in the control: ```ts this.spreadsheet.activeWorksheet = this.spreadsheet.workbook.worksheets(1); @@ -44,6 +44,6 @@ this.spreadsheet.activeCell = new SpreadsheetCell("C5"); ## API References -
-
+
+

diff --git a/docs/angular/src/content/en/components/spreadsheet-chart-adapter.mdx b/docs/angular/src/content/en/components/spreadsheet-chart-adapter.mdx index 18098c24a4..1464b4b735 100644 --- a/docs/angular/src/content/en/components/spreadsheet-chart-adapter.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-chart-adapter.mdx @@ -11,7 +11,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Spreadsheet Chart Adapter -The Angular Spreadsheet component allows displaying charts in your . +The Angular Spreadsheet component allows displaying charts in your . ## Angular Spreadsheet Chart Adapter Example @@ -22,9 +22,9 @@ The Angular Spreadsheet component allows displaying charts in your you can display the charts in the spreadsheet. The spreadsheet chart adapters creates and initializes chart elements for the spreadsheet based on a Infragistics.Documents.Excel.WorksheetChart instance. +Using you can display the charts in the spreadsheet. The spreadsheet chart adapters creates and initializes chart elements for the spreadsheet based on a Infragistics.Documents.Excel.WorksheetChart instance. -In order to add a WorksheetChart to a worksheet, you must use the `AddChart` method of the worksheet’s Shapes collection. You can find more detail of adding charts in Excel below. +In order to add a WorksheetChart to a worksheet, you must use the method of the worksheet’s Shapes collection. You can find more detail of adding charts in Excel below. Here are the steps by step description : @@ -84,10 +84,10 @@ There are over 35 chart types supported by the Spreadsheet ChartAdapters includi -In the following code snippet, an external [ExcelUtility](excel-utility.md) class is used to save and load a `Workbook`. +In the following code snippet, an external [ExcelUtility](excel-utility.md) class is used to save and load a . -When setting up your Angular spreadsheet control to add charts, you will need to import the `SpreadsheetChartAdapter` class like so: +When setting up your Angular spreadsheet control to add charts, you will need to import the class like so: @@ -109,7 +109,7 @@ import { WorksheetCell } from 'igniteui-angular-excel'; ## Code Snippet -The following code snippet demonstrates how to add charts to the currently viewed worksheet in the control: +The following code snippet demonstrates how to add charts to the currently viewed worksheet in the control: ```typescript this.spreadsheet.chartAdapter = new SpreadsheetChartAdapter(); @@ -166,6 +166,6 @@ ExcelUtility.loadFromUrl(process.env.PUBLIC_URL + "/ExcelFiles/ChartData.xlsx"). ## API References -
-
+
+

diff --git a/docs/angular/src/content/en/components/spreadsheet-clipboard.mdx b/docs/angular/src/content/en/components/spreadsheet-clipboard.mdx index 9d85866270..ef73e010c9 100644 --- a/docs/angular/src/content/en/components/spreadsheet-clipboard.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-clipboard.mdx @@ -24,7 +24,7 @@ This topic explains how to perform clipboard operations on the Ignite UI for Ang ## Dependencies -Before making use of the clipboard you will want to import the enumeration: +Before making use of the clipboard you will want to import the `SpreadsheetAction` enumeration: @@ -44,7 +44,7 @@ import { SpreadsheetAction } from 'igniteui-angular-spreadsheet'; ## Usage -The following code snippet shows how you can execute commands related to the clipboard in the Angular control: +The following code snippet shows how you can execute commands related to the clipboard in the Angular control: ```ts public cut(): void { @@ -63,5 +63,5 @@ public paste(): void { ## API References -
-
+`SpreadsheetAction`
+
diff --git a/docs/angular/src/content/en/components/spreadsheet-commands.mdx b/docs/angular/src/content/en/components/spreadsheet-commands.mdx index 40f94546b2..ebb1bdb32f 100644 --- a/docs/angular/src/content/en/components/spreadsheet-commands.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-commands.mdx @@ -10,7 +10,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Working with Commands -The Angular Spreadsheet component allows you to perform commands for activating different features of the spreadsheet. This topic explains how to perform different operations with the control using commands. Many of the commands will perform their action based on the active cells, rows, or worksheets. For example two such commands are ZoomIn and ZoomOut. See the enum for a full list. +The Angular Spreadsheet component allows you to perform commands for activating different features of the spreadsheet. This topic explains how to perform different operations with the control using commands. Many of the commands will perform their action based on the active cells, rows, or worksheets. For example two such commands are ZoomIn and ZoomOut. See the `SpreadsheetAction` enum for a full list. ## Angular Working with Commands Example @@ -24,7 +24,7 @@ The Angular Spreadsheet component allows you to perform commands for activating ## Dependencies -Before making use of the commands you will want to import the +Before making use of the commands you will want to import the `SpreadsheetAction` @@ -72,4 +72,4 @@ public zoomOut(): void { ## API References -
+`SpreadsheetAction`
diff --git a/docs/angular/src/content/en/components/spreadsheet-conditional-formatting.mdx b/docs/angular/src/content/en/components/spreadsheet-conditional-formatting.mdx index 9f7194811b..d8e1be1540 100644 --- a/docs/angular/src/content/en/components/spreadsheet-conditional-formatting.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-conditional-formatting.mdx @@ -1,4 +1,4 @@ ---- +--- title: "Angular Spreadsheet | Conditional Formatting | Infragistics" description: Use Infragistics' Angular spreadsheet control to conditionally format the cells of a worksheet. Check out Ignite UI for Angular spreadsheet demos! keywords: Spreadsheet, conditional formatting, Ignite UI for Angular, Infragistics, Worksheet @@ -10,7 +10,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Spreadsheet Conditional Formatting -The Angular component allows you to conditionally format the cells of a worksheet. This allows you to highlight different pieces of your data based on a condition. +The Angular component allows you to conditionally format the cells of a worksheet. This allows you to highlight different pieces of your data based on a condition. ## Angular Spreadsheet Conditional Formatting Example @@ -24,37 +24,37 @@ The Angular component allows yo ## Conditional Formatting Overview -You can configure the conditional formatting of a particular worksheet by using the many `Add` methods exposed on the `ConditionalFormats` collection of that worksheet. The first parameter of these `Add` methods is the string region of the worksheet that you would like to apply the conditional format to. +You can configure the conditional formatting of a particular worksheet by using the many `Add` methods exposed on the collection of that worksheet. The first parameter of these `Add` methods is the string region of the worksheet that you would like to apply the conditional format to. -Many of the conditional formats that you can add to your worksheet have a `CellFormat` property that determines the way that the cells should look when the condition in that conditional format holds true. For example, you can use the properties attached to this `CellFormat` property such as `Fill` and `Font` to determine the background and font settings of your cells, respectively. +Many of the conditional formats that you can add to your worksheet have a property that determines the way that the cells should look when the condition in that conditional format holds true. For example, you can use the properties attached to this property such as and to determine the background and font settings of your cells, respectively. -When a conditional format is created and a `CellFormat` applied, there is a subset of properties that are currently supported by the worksheet cell. The properties that are currently honored off of the `CellFormat` are `Fill`, `Border` properties, `FormatString`, and some `Font` properties such as strikethrough, underline, italic, bold, and color. Many of these can be seen from the code snippet below. +When a conditional format is created and a applied, there is a subset of properties that are currently supported by the worksheet cell. The properties that are currently honored off of the are , `Border` properties, , and some properties such as strikethrough, underline, italic, bold, and color. Many of these can be seen from the code snippet below. -There are a few conditional formats that do not have a `CellFormat` property, as their visualization on the cells behaves differently. These conditional formats are the `DataBarConditionalFormat`, `ColorScaleConditionalFormat`, and `IconSetConditionalFormat`. +There are a few conditional formats that do not have a property, as their visualization on the cells behaves differently. These conditional formats are the , , and . When loading a pre-existing workbook from Excel, the formats will be preserved when that workbook is loaded. The same is true for when you save the workbook out to an Excel file. -The following lists the supported conditional formats in the Angular control: - -- `AverageConditionalFormat`: Added using the `AddAverageCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is above or below the average or standard deviation for the associated range. -- `BlanksConditionalFormat`: Added using the `AddBlanksCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is not set. -- `ColorScaleConditionalFormat`: Added using the `AddColorScaleCondition` method, this conditional format exposes properties which control the coloring of a worksheet cell based on the cell’s value as relative to minimum, midpoint, and maximum threshold values. -- `DataBarConditionalFormat`: Added using the `AddDataBarCondition` method, this conditional format exposes properties which display data bars in a worksheet cell based on the cell’s value as relative to the associated range of values. -- `DateTimeConditionalFormat`: Added using the `AddDateTimeCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s date value falls within a given range of time. -- `DuplicateConditionalFormat`: Added using the `AddDuplicateCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is unique or duplicated across the associated range. -- `ErrorsConditionalFormat`: Added using the `AddErrorsCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is valid. -- `FormulaConditionalFormat`: Added using the `AddFormulaCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value meets the criteria defined by a formula. -- `IconSetConditionalFormat`: Added using the `AddIconSetCondition` method, this conditional format exposes properties which display icons in a worksheet cell based on the cell’s value as relative to threshold values. -- `NoBlanksConditionalFormat`: Added using the `AddNoBlanksCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is set. -- `NoErrorsConditionalFormat`: Added using the `AddNoErrorsCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is valid. -- `OperatorConditionalFormat`: Added using the `AddOperatorCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value meets the criteria defined by a logical operator. -- `RankConditionalFormat`: Added using the `AddRankCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is within the top of bottom rank of values across the associated range. -- `TextOperatorConditionalFormat`: Added using the `AddTextCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s text value meets the criteria defined by a string and a `FormatConditionTextOperator` value as placed in the `AddTextCondition` method’s parameters. -- `UniqueConditionalFormat`: Added using the `AddUniqueCondition` method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is unique across the associated range. +The following lists the supported conditional formats in the Angular control: + +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is above or below the average or standard deviation for the associated range. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is not set. +- : Added using the method, this conditional format exposes properties which control the coloring of a worksheet cell based on the cell’s value as relative to minimum, midpoint, and maximum threshold values. +- : Added using the method, this conditional format exposes properties which display data bars in a worksheet cell based on the cell’s value as relative to the associated range of values. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s date value falls within a given range of time. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is unique or duplicated across the associated range. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is valid. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value meets the criteria defined by a formula. +- : Added using the method, this conditional format exposes properties which display icons in a worksheet cell based on the cell’s value as relative to threshold values. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is set. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value is valid. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether the cell’s value meets the criteria defined by a logical operator. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is within the top of bottom rank of values across the associated range. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s text value meets the criteria defined by a string and a value as placed in the method’s parameters. +- : Added using the method, this conditional format exposes properties which control the visual attributes of a worksheet cell based on whether a cell’s value is unique across the associated range. ## Dependencies -In order to add conditional formatting to the `Spreadsheet` control, you will need to import the following dependencies: +In order to add conditional formatting to the control, you will need to import the following dependencies: ```ts diff --git a/docs/angular/src/content/en/components/spreadsheet-configuring.mdx b/docs/angular/src/content/en/components/spreadsheet-configuring.mdx index d7a77a69d2..ea7848c211 100644 --- a/docs/angular/src/content/en/components/spreadsheet-configuring.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-configuring.mdx @@ -24,11 +24,11 @@ The Angular Spreadsheet component allows the user to configure many different as ## Configuring Cell Editing -When a user edits a cell value and confirms the new input, the `Spreadsheet` control has the ability to navigate to cells adjacent to the currently active cell on press of the ENTER key, depending on the configuration of the spreadsheet. +When a user edits a cell value and confirms the new input, the control has the ability to navigate to cells adjacent to the currently active cell on press of the ENTER key, depending on the configuration of the spreadsheet. -In order to enable this ENTER key navigation, you can set the `IsEnterKeyNavigationEnabled` property to **true**. If set to false, the active cell will stay the same when pressing the ENTER key. +In order to enable this ENTER key navigation, you can set the property to **true**. If set to false, the active cell will stay the same when pressing the ENTER key. -You can also configure the direction of the adjacent cell navigated to on press of the ENTER key by setting the `EnterKeyNavigationDirection` property to `Down`, `Up`, `Left` or `Right`. +You can also configure the direction of the adjacent cell navigated to on press of the ENTER key by setting the property to `Down`, `Up`, `Left` or `Right`. The following code snippets demonstrate the above: @@ -57,7 +57,7 @@ this.spreadsheet.enterKeyNavigationDirection = SpreadsheetEnterKeyNavigationDire ## Configuring Formula Bar -The Angular `Spreadsheet` allows you to configure the visibility of the formula bar by setting the `IsFormulaBarVisible` property of the control. +The Angular allows you to configure the visibility of the formula bar by setting the property of the control. The following code snippets demonstrate the above: @@ -79,7 +79,7 @@ this.spreadsheet.isFormulaBarVisible = true; ## Configuring Gridlines -The `Spreadsheet` allows you to configure the visibility of its gridlines by setting the `AreGridlinesVisible` property of the control. +The allows you to configure the visibility of its gridlines by setting the property of the control. The following code snippets demonstrate the above: @@ -101,7 +101,7 @@ this.spreadsheet.areGridlinesVisible = true; ## Configuring Headers -The `Spreadsheet` allows you to configure the visibility of its headers by setting the `AreHeadersVisible` property of the control. +The allows you to configure the visibility of its headers by setting the property of the control. The following code snippets demonstrate the above: @@ -123,13 +123,13 @@ this.spreadsheet.areHeadersVisible = false; ## Configuring Navigation -The `Spreadsheet` control allows you to configure navigation between a worksheet's cells by configuring whether or not the control is in "end mode." End mode is the functionality where, on press of an arrow key, the active cell will be moved from the current cell to the end of the row or column where data exists in the adjacent cells, depending on the direction of the arrow key pressed. This functionality is good for navigating to the end of large blocks of data very quickly. +The control allows you to configure navigation between a worksheet's cells by configuring whether or not the control is in "end mode." End mode is the functionality where, on press of an arrow key, the active cell will be moved from the current cell to the end of the row or column where data exists in the adjacent cells, depending on the direction of the arrow key pressed. This functionality is good for navigating to the end of large blocks of data very quickly. -For example, if you are in end mode, and you click in a large 100x100 block of data, and press the arrow key, this will navigate to the right end of the row that you are in to the furthest right column with data. After this operation, the `Spreadsheet` will pop out of end mode. +For example, if you are in end mode, and you click in a large 100x100 block of data, and press the arrow key, this will navigate to the right end of the row that you are in to the furthest right column with data. After this operation, the will pop out of end mode. -End mode goes into effect at runtime when the user presses the END key, but it can be configured programmatically by setting the `IsInEndMode` property of the spreadsheet control. +End mode goes into effect at runtime when the user presses the END key, but it can be configured programmatically by setting the property of the spreadsheet control. -The following code snippets demonstrate the above, in that the `Spreadsheet` will begin in end mode: +The following code snippets demonstrate the above, in that the will begin in end mode: @@ -149,9 +149,9 @@ this.spreadsheet.isInEndMode = true; ## Configuring Protection -The `Spreadsheet` will respect the protection of a workbook on a worksheet-by-worksheet basis. Configuration for a worksheet's protection can be configured by calling the `Protect()` method on the worksheet to protect it, and the `Unprotect()` method to unprotect it. +The will respect the protection of a workbook on a worksheet-by-worksheet basis. Configuration for a worksheet's protection can be configured by calling the `Protect()` method on the worksheet to protect it, and the `Unprotect()` method to unprotect it. -You can activate or deactivate protection on the `Spreadsheet` control's currently active worksheet by using the code below: +You can activate or deactivate protection on the control's currently active worksheet by using the code below: ```ts this.spreadsheet.activeWorksheet.protect(); @@ -160,13 +160,13 @@ this.spreadsheet.activeWorksheet.unprotect(); ## Configuring Selection -The `Spreadsheet` control allows you to configure the type of selection allowed in the control then modifier keys (SHIFT or CTRL) are pressed by the user. This is done by setting the `SelectionMode` property of the spreadsheet to one of the following values: +The control allows you to configure the type of selection allowed in the control then modifier keys (SHIFT or CTRL) are pressed by the user. This is done by setting the property of the spreadsheet to one of the following values: -- `AddToSelection`: New cell ranges are added to the `SpreadsheetSelection` object's `CellRanges` collection without needing to hold down the CTRL key when dragging via the mouse and a range is added with the first arrow key navigation after entering the mode. One can enter the mode by pressing SHIFT + F8. -- `ExtendSelection`: The selection range in the `SpreadsheetSelection` object's `CellRanges` collection representing the active cell is updated as one uses the mouse to select a cell or navigating via the keyboard. +- `AddToSelection`: New cell ranges are added to the object's collection without needing to hold down the CTRL key when dragging via the mouse and a range is added with the first arrow key navigation after entering the mode. One can enter the mode by pressing SHIFT + F8. +- `ExtendSelection`: The selection range in the object's collection representing the active cell is updated as one uses the mouse to select a cell or navigating via the keyboard. - `Normal`: The selection is replaced when dragging the mouse to select a cell or range of cells. Similarly when navigating via the keyboard a new selection is created. One may add a new range by holding the CTRL key and using the mouse and one may alter the selection range containing the active cell by holding the SHIFT key down while clicking with the mouse or navigating with the keyboard such as with the arrow keys. -The `SpreadsheetSelection` object mentioned in the descriptions above can be obtained by using the `ActiveSelection` property of the `Spreadsheet` control. +The object mentioned in the descriptions above can be obtained by using the property of the control. The following code snippets demonstrate configuration of the selection mode: @@ -190,9 +190,9 @@ The following code snippets demonstrate configuration of the selection mode: this.spreadsheet.selectionMode = SpreadsheetCellSelectionMode.ExtendSelection; ``` -The selection of the `Spreadsheet` control can also be set or obtained programmatically. For single selection, you can set the `ActiveCell` property Multiple selection is done through the `SpreadsheetSelection` object that is returned by the `Spreadsheet` control's `ActiveSelection` property. +The selection of the control can also be set or obtained programmatically. For single selection, you can set the property Multiple selection is done through the object that is returned by the control's property. -The `SpreadsheetSelection` object has an `AddCellRange()` method that allows you to programmatically add a range of cells to the selection of the spreadsheet in the form of a new `SpreadsheetCellRange` object. +The object has an `AddCellRange()` method that allows you to programmatically add a range of cells to the selection of the spreadsheet in the form of a new object. The following code snippet demonstrates adding a cell range to the spreadsheet's selection: @@ -202,7 +202,7 @@ this.spreadsheet.activeSelection.addCellRange(new SpreadsheetCellRange(2, 2, 5, ## Configuring Tab Bar Area -The `Spreadsheet` control respects the configuration of the visibility and width of the tab bar area from the `WindowOptions` of the currently active `Workbook` via the `TabBarWidth` and `TabBarVisibility` properties, respectively. +The control respects the configuration of the visibility and width of the tab bar area from the of the currently active via the `TabBarWidth` and `TabBarVisibility` properties, respectively. The tab bar area is the area that visualizes the worksheet names as tabs in the control. @@ -216,9 +216,9 @@ this.spreadsheet.workbook.windowOptions.tabBarWidth = 200; ## Configuring Zoom Level -The Angular Spreadsheet component supports zooming in and out by configuring its `ZoomLevel` property. The zoom level can be a maximum of 400% and a minimum of 10%. +The Angular Spreadsheet component supports zooming in and out by configuring its property. The zoom level can be a maximum of 400% and a minimum of 10%. -Setting this property to a number represents the percentage as a whole number, so setting the `ZoomLevel` to 100 is equivalent to setting it to 100%. +Setting this property to a number represents the percentage as a whole number, so setting the to 100 is equivalent to setting it to 100%. The following code snippets show how to configure the spreadsheet's zoom level: @@ -241,7 +241,7 @@ this.spreadsheet.zoomLevel = 200; ## API References -
-
-
+
+
+

diff --git a/docs/angular/src/content/en/components/spreadsheet-hyperlinks.mdx b/docs/angular/src/content/en/components/spreadsheet-hyperlinks.mdx index eca27a3499..4785820430 100644 --- a/docs/angular/src/content/en/components/spreadsheet-hyperlinks.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-hyperlinks.mdx @@ -24,11 +24,11 @@ The Angular Spreadsheet component allows display of pre-existing hyperlinks in y ## Hyperlinks Overview -Hyperlinks are added to the `Spreadsheet` control by accessing the `Hyperlinks` collection on the worksheet that you want to place the hyperlink on. This collection has an `Add` method that takes a `WorksheetHyperlink` object, where you can define the cell address, the hyperlink URL to be navigated to, the display text, and a tooltip to optionally be displayed on hover. +Hyperlinks are added to the control by accessing the `Hyperlinks` collection on the worksheet that you want to place the hyperlink on. This collection has an `Add` method that takes a object, where you can define the cell address, the hyperlink URL to be navigated to, the display text, and a tooltip to optionally be displayed on hover. ## Dependencies -When setting up your Angular spreadsheet control to use hyperlinks, you will need to import the `WorksheetHyperlink` class like so: +When setting up your Angular spreadsheet control to use hyperlinks, you will need to import the class like so: ```ts diff --git a/docs/angular/src/content/en/components/spreadsheet-overview.mdx b/docs/angular/src/content/en/components/spreadsheet-overview.mdx index 2652e48903..e8b12b6e59 100644 --- a/docs/angular/src/content/en/components/spreadsheet-overview.mdx +++ b/docs/angular/src/content/en/components/spreadsheet-overview.mdx @@ -11,7 +11,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Spreadsheet Overview -The Angular Spreadsheet (Excel viewer) component is lightweight, feature-rich and supplied with all the necessary options for operating, visualizing, and editing all types of spreadsheet data – scientific, business, financial, and more. All the information can be presented in a tabular format that feels intuitive and easy to navigate across cells, panes, and worksheets. The `Spreadsheet` is complemented by flexible Excel-like interface, detailed charts, and features such as activation, cell editing, conditional formatting, styling, selection, clipboard. +The Angular Spreadsheet (Excel viewer) component is lightweight, feature-rich and supplied with all the necessary options for operating, visualizing, and editing all types of spreadsheet data – scientific, business, financial, and more. All the information can be presented in a tabular format that feels intuitive and easy to navigate across cells, panes, and worksheets. The is complemented by flexible Excel-like interface, detailed charts, and features such as activation, cell editing, conditional formatting, styling, selection, clipboard. ## Angular Spreadsheet Example @@ -67,7 +67,7 @@ npm install --save igniteui-angular-spreadsheet ## Component Modules -The `Spreadsheet` requires the following modules: +The requires the following modules: @@ -114,7 +114,7 @@ Now that the Angular spreadsheet module is imported, next is the basic configura -In the following code snippet, an external [ExcelUtility](excel-utility.md) class is used to save and load a `Workbook`. +In the following code snippet, an external [ExcelUtility](excel-utility.md) class is used to save and load a . The following demonstrates how to load a workbook into the Angular spreadsheet @@ -147,5 +147,5 @@ ngOnInit() { ## API References -
+

diff --git a/docs/angular/src/content/en/components/stepper.mdx b/docs/angular/src/content/en/components/stepper.mdx index abb8cdb7f1..9eb839811b 100644 --- a/docs/angular/src/content/en/components/stepper.mdx +++ b/docs/angular/src/content/en/components/stepper.mdx @@ -119,7 +119,7 @@ Steps can be declared using one of the following approaches. ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/texthighlight.mdx b/docs/angular/src/content/en/components/texthighlight.mdx index b65faa8a38..b9219ba779 100644 --- a/docs/angular/src/content/en/components/texthighlight.mdx +++ b/docs/angular/src/content/en/components/texthighlight.mdx @@ -149,7 +149,7 @@ Let's create a search box that we can use to highlight different parts of the te ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/time-picker.mdx b/docs/angular/src/content/en/components/time-picker.mdx index dd2f463c77..f2c90f2e02 100644 --- a/docs/angular/src/content/en/components/time-picker.mdx +++ b/docs/angular/src/content/en/components/time-picker.mdx @@ -159,7 +159,7 @@ In the following example we have added a custom label and hint and changed the d ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` @@ -357,7 +357,7 @@ public onValidationFailed() { The dropdown displays values within the min/max range (09:15:30 AM~06:15:30 PM) based on the items delta. A toast is added to show a message when an invalid time has been typed in. - + The displayed values for each time portion in the dropdown/dialog are calculated based on the items delta always starting from zero. If the and does not match the items delta, the displayed values will start/end from the next/last possible value that matches the threshold. diff --git a/docs/angular/src/content/en/components/tooltip.mdx b/docs/angular/src/content/en/components/tooltip.mdx index eb450b3c2e..2b0bdab8be 100644 --- a/docs/angular/src/content/en/components/tooltip.mdx +++ b/docs/angular/src/content/en/components/tooltip.mdx @@ -235,7 +235,7 @@ Let's start by creating our map. We need a simple div that has for a background ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/transaction-how-to-use.mdx b/docs/angular/src/content/en/components/transaction-how-to-use.mdx index e744474d1e..354c5551f2 100644 --- a/docs/angular/src/content/en/components/transaction-how-to-use.mdx +++ b/docs/angular/src/content/en/components/transaction-how-to-use.mdx @@ -86,7 +86,7 @@ In our html template, we define an compo ``` - + This example uses `igx-icon` with the default Material Icons family. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/tree.mdx b/docs/angular/src/content/en/components/tree.mdx index 191abc25e9..0ab2b187a0 100644 --- a/docs/angular/src/content/en/components/tree.mdx +++ b/docs/angular/src/content/en/components/tree.mdx @@ -91,7 +91,7 @@ export class HomeComponent {} ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/treegrid/load-on-demand.mdx b/docs/angular/src/content/en/components/treegrid/load-on-demand.mdx index 706be652a2..1a0b92f411 100644 --- a/docs/angular/src/content/en/components/treegrid/load-on-demand.mdx +++ b/docs/angular/src/content/en/components/treegrid/load-on-demand.mdx @@ -70,7 +70,7 @@ If you want to provide your own custom loading indicator, you may create an ng-t ``` - + This component uses Material Icons. Add the following link to your `index.html`: `` diff --git a/docs/angular/src/content/en/components/treegrid/tree-grid.mdx b/docs/angular/src/content/en/components/treegrid/tree-grid.mdx index c08effc974..0a7a91507b 100644 --- a/docs/angular/src/content/en/components/treegrid/tree-grid.mdx +++ b/docs/angular/src/content/en/components/treegrid/tree-grid.mdx @@ -301,7 +301,7 @@ To get started with styling the Tree Grid, we need to import the `index` file, w Following the simplest approach, we create a new theme that extends the and accepts the parameters, required to customize the tree grid as desired. - + There is no specific `sass` tree grid function. @@ -320,8 +320,8 @@ $custom-theme: grid-theme( ); ``` - -Instead of hardcoding the color values like we just did, we can achieve greater flexibility in terms of colors by using the and functions. Please refer to [`Palettes`](/themes/sass/palettes) topic for detailed guidance on how to use them. + +Instead of hardcoding the color values like we just did, we can achieve greater flexibility in terms of colors by using the [`palette`]({environment:sassApiUrl}/palettes#function-palette) and [`color`]({environment:sassApiUrl}/palettes#function-color) functions. Please refer to [`Palettes`](/themes/sass/palettes) topic for detailed guidance on how to use them. The last step is to **include** the component theme in our application. diff --git a/docs/angular/src/content/en/components/zoomslider-overview.mdx b/docs/angular/src/content/en/components/zoomslider-overview.mdx index a413207e1f..9a98402f11 100644 --- a/docs/angular/src/content/en/components/zoomslider-overview.mdx +++ b/docs/angular/src/content/en/components/zoomslider-overview.mdx @@ -15,7 +15,7 @@ The Angular ZoomSlider control provides zooming functionality to range-enabled c ## Angular Zoom Slider Example -The following sample demonstrates how to use `ZoomSlider` to navigate content in `DataChart`. +The following sample demonstrates how to use to navigate content in . @@ -53,7 +53,7 @@ npm install --save igniteui-angular-charts ## Component Modules -The `ZoomSlider` requires the following modules: +The requires the following modules: diff --git a/docs/angular/src/content/en/grids_templates/column-types.mdx b/docs/angular/src/content/en/grids_templates/column-types.mdx index 554735cee6..27372bd36f 100644 --- a/docs/angular/src/content/en/grids_templates/column-types.mdx +++ b/docs/angular/src/content/en/grids_templates/column-types.mdx @@ -79,7 +79,7 @@ The appearance of the date portions will be set (e.g. day, month, year) based on - **format** - The default value for formatting the date is 'mediumDate'. Other available options are 'short', 'long', 'shortDate', 'fullDate', 'longTime', 'fullTime' and etc. This is a full list of all available [pre-defined Angular format options](https://angular.io/api/common/DatePipe#pre-defined-format-options) (legacy). - **timezone** - The user's local system timezone is the default value. The timezone offset or standard GMT/UTC or continental US timezone abbreviation can also be passed. Different timezone examples which will display the corresponding time of the location anywhere in the world: - + Since 20.2.x, if you have the Angular localization disabled, the list of available format options can be found in our new [localization topic](../general/localization#formatting). diff --git a/docs/angular/src/content/en/grids_templates/export-excel.mdx b/docs/angular/src/content/en/grids_templates/export-excel.mdx index c73b00deec..8a5424ec45 100644 --- a/docs/angular/src/content/en/grids_templates/export-excel.mdx +++ b/docs/angular/src/content/en/grids_templates/export-excel.mdx @@ -173,7 +173,7 @@ Once wired up, pressing the respective buttons downloads files named `ExportedDa Expand/collapse indicators in Excel are shown based on the hierarchy of the last dimension of the Pivot Grid. - + The exported {ComponentTitle} will not be formatted as a table, since Excel tables do not support multiple row headers. diff --git a/docs/angular/src/content/en/grids_templates/keyboard-navigation.mdx b/docs/angular/src/content/en/grids_templates/keyboard-navigation.mdx index 846a87d503..7c804a70df 100644 --- a/docs/angular/src/content/en/grids_templates/keyboard-navigation.mdx +++ b/docs/angular/src/content/en/grids_templates/keyboard-navigation.mdx @@ -318,7 +318,7 @@ Use the demo below to try out the custom scenarios that we just implemented: (obj) => { obj.target.nativeElement.focus(); }); ``` - + Please refer to the sample code for full implementation details. @@ -347,7 +347,7 @@ Use the demo below to try out the custom scenarios that we just implemented: (obj) => { obj.target.nativeElement.focus(); }); ``` - + Please refer to the sample code for full implementation details. diff --git a/docs/angular/src/content/en/grids_templates/multi-column-headers.mdx b/docs/angular/src/content/en/grids_templates/multi-column-headers.mdx index e896f8e2d2..d4927552fb 100644 --- a/docs/angular/src/content/en/grids_templates/multi-column-headers.mdx +++ b/docs/angular/src/content/en/grids_templates/multi-column-headers.mdx @@ -159,7 +159,7 @@ For achieving `n-th` level of nested headers, the declaration above should be fo Every supports [`moving`](column-moving), [`pinning`](column-pinning) and [`hiding`](column-hiding). - + When there is a set of columns and column groups, pinning works only for top level column parents. More specifically pinning per nested `column groups` or `columns` is not allowed.
Please note that when using Pinning with Multi-Column Headers, the entire Group gets pinned.
Moving between `columns` and `column groups` is allowed only when they are at the same level in the hierarchy and both are in the same `group`.
diff --git a/docs/angular/src/content/en/grids_templates/row-editing.mdx b/docs/angular/src/content/en/grids_templates/row-editing.mdx index a335f718d5..75ff282076 100644 --- a/docs/angular/src/content/en/grids_templates/row-editing.mdx +++ b/docs/angular/src/content/en/grids_templates/row-editing.mdx @@ -151,7 +151,7 @@ Then define a {ComponentTitle} with bound data source and + It's not needed to enable editing for individual columns. Using the property in the {ComponentTitle}, will mean that all rows, with defined `field` property, excluding primary one, will be editable. If you want to disable editing for specific column, then you set the column's input to `false`. diff --git a/docs/angular/src/content/en/grids_templates/row-selection.mdx b/docs/angular/src/content/en/grids_templates/row-selection.mdx index dd34b9fa67..92203a112c 100644 --- a/docs/angular/src/content/en/grids_templates/row-selection.mdx +++ b/docs/angular/src/content/en/grids_templates/row-selection.mdx @@ -322,7 +322,7 @@ public handleRowSelectionChange(args) { ### Select all rows Another useful API method that provides is `selectAll(onlyFilteredData)`. By default this method will select all data rows, but if filtering is applied, it will select only the rows that match the filter criteria. But if you call the method with _false_ parameter, `selectAll(false)` will always select all data in the grid, even if filtering is applied. - + Keep in mind that `selectAll()` will not select the rows that are deleted. diff --git a/docs/angular/src/content/en/grids_templates/sorting.mdx b/docs/angular/src/content/en/grids_templates/sorting.mdx index 8a81124d50..7b372e2ac6 100644 --- a/docs/angular/src/content/en/grids_templates/sorting.mdx +++ b/docs/angular/src/content/en/grids_templates/sorting.mdx @@ -168,7 +168,7 @@ this.{ComponentObjectRef}.clearSort(); The of the **{ComponentTitle}** is of different type compared to the of the **column**, since they work in different scopes and expose different parameters. - + The sorting operation **DOES NOT** change the underlying data source of the {ComponentTitle}. diff --git a/docs/angular/src/content/en/grids_templates/toolbar.mdx b/docs/angular/src/content/en/grids_templates/toolbar.mdx index 047a751318..cf382cbbf2 100644 --- a/docs/angular/src/content/en/grids_templates/toolbar.mdx +++ b/docs/angular/src/content/en/grids_templates/toolbar.mdx @@ -108,7 +108,7 @@ The predefined `actions` and `title` UI components are added inside the ` - + As seen in the code snippet above, the predefined `actions` UI components are wrapped in the . This way, the toolbar title is aligned to the left of the toolbar and the actions are aligned to the right of the toolbar. diff --git a/docs/angular/src/content/en/grids_templates/validation.mdx b/docs/angular/src/content/en/grids_templates/validation.mdx index 5d1522d5fa..dbde2ab69b 100644 --- a/docs/angular/src/content/en/grids_templates/validation.mdx +++ b/docs/angular/src/content/en/grids_templates/validation.mdx @@ -137,7 +137,7 @@ Validation will be triggered in the following scenarios: - When updating cells/rows via the API - , etc.. - When using batch editing and the / API of the transaction service. - + Validation will not trigger for records that have not been edited via user input or via the editing API. Visual indicators on the cell will only shown if the related input is considered touched - either via user interaction or via the `markAsTouched` API of the validation service. diff --git a/docs/angular/src/content/jp/components/action-strip.mdx b/docs/angular/src/content/jp/components/action-strip.mdx index edc4a777ab..ec176da5c8 100644 --- a/docs/angular/src/content/jp/components/action-strip.mdx +++ b/docs/angular/src/content/jp/components/action-strip.mdx @@ -80,7 +80,7 @@ import { IgxIconComponent } from 'igniteui-angular/icon'; export class HomeComponent {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/ai/ai-assisted-development-overview.mdx b/docs/angular/src/content/jp/components/ai/ai-assisted-development-overview.mdx index 153d746d8d..0436d97480 100644 --- a/docs/angular/src/content/jp/components/ai/ai-assisted-development-overview.mdx +++ b/docs/angular/src/content/jp/components/ai/ai-assisted-development-overview.mdx @@ -1,136 +1,95 @@ --- -title: Ignite UI を使用した AI 支援開発 - Ignite UI for Angular -description: Ignite UI は、エージェント スキル、Ignite UI CLI MCP サーバー、Theming MCP サーバーを提供し、Angular、React、Web Components 向けに AI コーディング アシスタントを正確なコンポーネント API、インポート パス、デザイン トークンで補完します。 -keywords: Angular, Ignite UI for Angular, Infragistics, MCP, Model Context Protocol, Ignite UI CLI MCP, Ignite UI Theming MCP, エージェント スキル, AI, エージェント, Copilot, Cursor -_language: ja +title: "Ignite UI を使った AI 支援開発 - Ignite UI for Angular" +description: "Ignite UI は、Angular、React、Web Components 全体で正しいコンポーネント API、インポート パス、デザイン トークンを AI コーディング アシスタントに提供するために、エージェント スキル、Ignite UI CLI MCP サーバー、Theming MCP サーバーを提供します。" +keywords: "Angular, Ignite UI for Angular, Infragistics, MCP, Model Context Protocol, Ignite UI CLI MCP, Ignite UI Theming MCP, エージェント スキル, AI, エージェント, Copilot, Cursor" license: MIT -canonicalLink: "/components/ai-assisted-development-overview" +_canonicalLink: "{environment:dvUrl}/components/ai-assisted-development-overview" mentionedTypes: [] last_updated: "2026-04-21" --- -import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro'; +# Ignite UI を使った AI 支援開発 -# Ignite UI を使用した AI 支援開発 +Ignite UI for Angular、React、Web Components は、3 つのパーツで構成される AI ツールチェーン (エージェント スキル、Ignite UI CLI MCP サーバー、Ignite UI Theming MCP サーバー) を提供します。これにより、AI コーディング アシスタントに正しいコンポーネント API、インポート パス、デザイン トークンを提供します。エージェント スキルは、AI エージェントが特定のプロジェクトで Ignite UI を使用する方法を定義する、開発者が管理する命令パッケージです。CLI MCP サーバーは、Model Context Protocol を介してアクティブな AI エージェント セッションに Ignite UI CLI スキャフォールディング、コンポーネント管理、ドキュメント ツールを公開します。Theming MCP サーバーは、Ignite UI テーマ エンジンをクエリ可能なエージェント コンテキストとして公開します。3 つのコンポーネントはすべて、GitHub Copilot、Cursor、Claude Desktop、Claude Code、JetBrains AI Assistant と連携します。 -Ignite UI for Angular、React、Web Components は、エージェント スキル、Ignite UI CLI MCP サーバー、Ignite UI Theming MCP サーバーの 3 部構成の AI ツールチェーンを提供します。これにより、AI コーディング アシスタントが正確なコンポーネント API、インポート パス、デザイン トークンを使用できます。エージェント スキルは、開発者が所有するインストラクション パッケージで、特定のプロジェクトで AI エージェントが Ignite UI を使用する方法を定義します。CLI MCP サーバーは、Model Context Protocol を通じてアクティブな AI エージェント セッションに Ignite UI CLI スキャフォールディング、コンポーネント管理、ドキュメント ツールを公開します。Theming MCP サーバーは、Ignite UI Theming Engine をクエリ可能なエージェント コンテキストとして公開します。3 つのコンポーネントはすべて、GitHub Copilot、Cursor、Claude Desktop、Claude Code、JetBrains AI Assistant と連携します。 - -AI ツールチェーンは、現在、CLI MCP とエージェント スキル レイヤーでの Blazor をサポートしていません。Blazor のカバレッジは Theming MCP のみで提供されます。CLI MCP サーバーは STDIO トランスポートを必要とします。HTTP ベースの MCP クライアントはサポートされていません。エージェント スキルと CLI MCP サーバーは、プロジェクト ファイルを自律的に変更しません。開発者のプロンプトに応じてアクティブな AI エージェントにツールとインストラクションを公開します。 +AI ツールチェーンは、現在、CLI MCP およびエージェント スキル レイヤーで Blazor をサポートしていません。Blazor の対応は Theming MCP のみで提供されます。CLI MCP サーバーには STDIO トランスポートが必要であり、HTTP ベースの MCP クライアントはサポートされていません。エージェント スキルと CLI MCP サーバーは、プロジェクト ファイルを自律的に変更することはなく、アクティブな AI エージェントにツールと命令を公開し、開発者のプロンプトに応じてエージェントが動作します。 ## AI ツールチェーンの概要 -Ignite UI の AI ツールチェーンは、独立して使用可能な 3 つのレイヤーで構成されています。各レイヤーは単独で有効化でき、連携して動作するように設計されています。 +Ignite UI の AI ツールチェーンは、独立して使用可能な 3 つのレイヤーで構成されています。各レイヤーは単独で有効にすることができ、連携して動作するように設計されています。 -| レイヤー | 提供内容 | オーナー | フレームワーク | -| --------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------- | -| エージェント スキル | 開発者所有のインストラクション パッケージ: インポート パス、コンポーネント パターン、デシジョン フロー、プロジェクト規約 | 開発者 | Angular、React、Web Components、Blazor | -| CLI MCP サーバー (`igniteui-cli`) | MCP 経由のプロジェクト スキャフォールディング、コンポーネント管理、ドキュメントと API クエリ | Infragistics | Angular、React、Web Components | -| Theming MCP サーバー (`igniteui-theming`) | デザイン トークン、パレット定義、CSS カスタム プロパティ生成、WCAG AA コントラスト検証 | Infragistics | Angular、React、Web Components、Blazor | +| レイヤー | 提供するもの | 所有者 | フレームワーク | +| --- | --- | --- | --- | +| エージェント スキル | 開発者が管理する命令パッケージ: インポート パス、コンポーネント パターン、デシジョン フロー、プロジェクト規約 | 開発者 | Angular、React、Web Components、Blazor | +| CLI MCP サーバー (`igniteui-cli`) | MCP を介したプロジェクト スキャフォールディング、コンポーネント管理、ドキュメントと API クエリ | Infragistics | Angular、React、Web Components | +| Theming MCP サーバー (`igniteui-theming`) | デザイン トークン、パレット定義、CSS 変数生成、MCP を介したテーマ クエリ | Infragistics | Angular、React、Web Components、Blazor | -CLI MCP サーバーと Theming MCP サーバーはいずれも `npx` 経由で起動し、STDIO トランスポートを通じて任意の MCP 互換クライアントに接続します。エージェント スキルは、AI クライアントがディスクから読み取るプロジェクトに配置されたローカル ファイルです。 +CLI MCP サーバーと Theming MCP サーバーはどちらも `npx` を通じて起動され、STDIO トランスポートを介して任意の MCP 互換クライアントに接続します。エージェント スキルは、AI クライアントがディスクから読み取る、プロジェクトに配置されたローカル ファイルです。 ## エージェント スキル -エージェント スキルは、特定のフレームワークで Ignite UI を使用する方法を AI コーディング アシスタントに正確に伝える、構造化された開発者所有のパッケージです。スキル パッケージには、コンポーネント パターン、インポート パス、デシジョン フローを含む `SKILL.md` インストラクション ファイル、公式の Ignite UI ドキュメントへの参照、スキーマ ファイルやダイアグラムなどのアセットを含めることができます。スキルが AI クライアントでアクティブな場合、エージェントは一般的なトレーニング データではなくスキルに従います。一般的なトレーニング データは古い API シグネチャやインポート パスを参照している可能性があります。 +エージェント スキルは、特定のフレームワークにおける Ignite UI の使用方法を、AI コーディング アシスタントに正確に伝えるための、開発者が管理する構造化されたパッケージです。スキル パッケージには、コンポーネント パターン、インポート パス、デシジョン フローを含む `SKILL.md` 命令ファイル、Ignite UI 公式ドキュメントへの参照、スキーマ ファイルや図などのアセットを含めることができます。スキルが AI クライアントでアクティブになると、エージェントは、古い API シグネチャやインポート パスを引用する恐れのある一般的な学習データに依存する代わりに、スキルに従います。 -Ignite UI は Angular、React、Web Components、Blazor 向けの専用スキル パッケージを同梱しています。スキル パッケージは開発者が所有します: `SKILL.md` を編集してチームの規約に合わせ、プロジェクト固有のパターンを追加し、内部デザイン システムを参照し、コードベースと共にパッケージをバージョン管理してください。 +Ignite UI は、Angular、React、Web Components、Blazor 向けの専用スキル パッケージを提供しています。スキル パッケージは開発者が管理するものであり、チームの規約に合わせて `SKILL.md` を編集したり、プロジェクト固有のパターンの追加や内部デザイン システムを参照するなどして、コードベースとともにパッケージをバージョン管理できます。 完全なセットアップ手順と IDE の設定については、[エージェント スキル](skills.md)を参照してください。 ## CLI MCP サーバー -Ignite UI CLI MCP サーバー (`igniteui-cli`) は、Infragistics が管理する MCP サーバーで、アクティブな AI エージェント セッションに Ignite UI CLI スキャフォールディングとドキュメント ツールを公開します。接続すると、AI アシスタントはチャット セッション内の自然言語プロンプトを通じて、Angular、React、Web Components プロジェクトの作成、Ignite UI コンポーネントの追加と変更、ドキュメントと API の質問に回答できます。 +Ignite UI CLI MCP サーバー (`igniteui-cli`) は、Infragistics が管理する MCP サーバーで、Ignite UI CLI スキャフォールディングとドキュメント ツールをアクティブな AI エージェント セッションに公開します。接続すると、AI アシスタントはチャット セッションの自然言語プロンプトを通じて、Angular、React、または Web Components プロジェクトの作成、Ignite UI コンポーネントの追加と変更、ドキュメントと API の質問への回答を行うことができます。 -CLI MCP サーバーはグローバル インストールなしに `npx` 経由で起動します: +CLI MCP サーバーはグローバル インストールなしで `npx` 経由で起動します。 ```bash npx -y igniteui-cli mcp ``` -このサーバーは、VS Code with GitHub Copilot、GitHub Copilot クラウド エージェント、Cursor、Claude Desktop、Claude Code、JetBrains AI Assistant、および STDIO トランスポートをサポートする他の MCP 互換クライアントに接続します。設定形式はクライアントによって異なります。以下の CLI MCP セットアップ ガイドを参照してください。 +サーバーは、GitHub Copilot を使用した VS Code、Cursor、Claude Desktop、Claude Code、JetBrains AI Assistant、および STDIO トランスポートをサポートするその他の MCP 互換クライアントに接続します。クライアントによって構成形式が異なります。以下の CLI MCP セットアップ ガイドを参照してください。 -CLI MCP サーバーは Blazor をサポートしていません。コードを自律的に生成しません。開発者のプロンプトに応じて AI エージェントにツールを公開します。 +CLI MCP サーバーは Blazor をサポートしていません。また、CLI MCP サーバーはコードを自律的に生成することはなく、AI エージェントにツールを公開するのみです。開発者のプロンプトに応じてエージェントがツールを呼び出します。 ## Theming MCP サーバー -Ignite UI Theming MCP サーバー (`igniteui-theming`) は、Ignite UI Theming Engine をクエリ可能なエージェント コンテキストとして公開する別の MCP サーバーです。デザイン トークン アクセス、パレット定義、CSS カスタム プロパティ生成、WCAG AA コントラスト検証をカバーします。CLI MCP サーバーとはアーキテクチャ的に分離されており、プロジェクト スキャフォールディング ツールを公開せずに AI エージェントにテーマ ツールへのアクセスを提供するために独立して接続できます。 +Ignite UI Theming MCP サーバー (`igniteui-theming`) は、Ignite UI テーマ エンジンをクエリ可能なエージェント コンテキストとして公開する別の MCP サーバーです。デザイン トークン アクセス、パレット定義、CSS カスタム プロパティ生成、WCAG AA コントラスト検証をカバーします。CLI MCP サーバーとはアーキテクチャ的に分離されており、プロジェクト スキャフォールディング ツールを公開せずに AI エージェントにテーマ ツールへのアクセスを提供するために、独立して接続できます。 -Theming MCP サーバーは `npx` 経由で起動します: +Theming MCP サーバーは `npx` 経由で起動します。 ```bash npx -y igniteui-theming igniteui-theming-mcp ``` -Theming MCP サーバーは Angular、React、Web Components、Blazor をサポートしています。Ignite UI のリリースごとに更新されるため、エージェントは常に現在のトークン サーフェスに対して動作します。 +Theming MCP サーバーは Angular、React、Web Components、Blazor をサポートしています。Ignite UI のリリースごとに更新されるため、エージェントは常に最新のトークン サーフェスに対して動作します。 -設定の詳細については、[Theming MCP](theming-mcp.md) を参照してください。 +構成の詳細については、[Theming MCP](theming-mcp.md)を参照してください。 ## サポートされている AI クライアント -CLI MCP サーバーと Theming MCP サーバーは、STDIO トランスポートで MCP をサポートする任意のエディターまたは AI クライアントで動作します。 +CLI MCP サーバーと Theming MCP サーバーは、STDIO トランスポートで MCP をサポートする任意のエディターまたは AI クライアントと連携します。 -| クライアント | 設定方法 | -| --------------------------- | ----------------------------------------------------------------- | -| VS Code with GitHub Copilot | `.vscode/mcp.json` | -| Cursor | `.cursor/mcp.json` | -| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` | -| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` | -| Claude Code | `.mcp.json` または Claude Code MCP CLI コマンド | -| JetBrains AI Assistant | **ツール → AI Assistant → Model Context Protocol (MCP)** | +| クライアント | 構成方法 | +| --- | --- | +| GitHub Copilot を使用した VS Code | `.vscode/mcp.json` | +| Cursor | `.cursor/mcp.json` | +| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` | +| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` | +| Claude Code | `.mcp.json` または Claude Code MCP CLI コマンド | +| JetBrains AI Assistant | **Tools → AI Assistant → Model Context Protocol (MCP)** | -エージェント スキルは、GitHub Copilot では `.github/copilot-instructions.md`、Cursor では `.cursorrules` または `.cursor/rules/`、Windsurf では `.windsurfrules`、JetBrains AI Assistant ではプロジェクト レベルのプロンプト設定と互換性があります。 +エージェント スキルは、`.github/copilot-instructions.md` を介した GitHub Copilot、`.cursorrules` または `.cursor/rules/` を介した Cursor、`.windsurfrules` を介した Windsurf、プロジェクト レベルのプロンプト設定を介した JetBrains AI Assistant と互換性があります。 ## AI ツールチェーンのセットアップ -`ig ai-config` を使用して、1 つのコマンドでエージェント スキルと両方の MCP サーバーを設定します。各レイヤーを個別に制御する場合、または既存のプロジェクトでツールチェーンの一部のみを設定する場合は、以下の手順に従ってください。`ig ai-config` を実行すると、1 回の操作でステップ 1、2、3 が完了します。 - -### クイック セットアップ - -`ai-config` コマンドは、Ignite UI エージェント スキルを `.claude/skills/` にコピーし、Ignite UI MCP サーバー設定を `.vscode/mcp.json` に書き込みます。ファイルが既に存在し、最新の状態であれば、このコマンドは何もしません。 - -**Angular Schematics を使用する場合:** - -```bash -ng generate @igniteui/angular-schematics:ai-config -``` +Ignite UI AI ツールチェーンのセットアップには 3 つのステップがあります。フレームワークのエージェント スキルをロードし、CLI MCP サーバーを接続し、オプションで Theming MCP サーバーを接続します。3 つのステップはすべて独立しており、任意の順序で実行できます。 -これにより、Ignite UI サーバーと共に `@angular/cli` MCP サーバーも `.vscode/mcp.json` に登録されます。 +### ステップ 1 - エージェント スキルをロードする -**Ignite UI CLI を使用する場合:** +フレームワークの Ignite UI スキル パッケージをプロジェクトのエージェント検出パスにコピーします。スキル パッケージは `node_modules/igniteui-{framework}/skills/` のライブラリに付属しています。IDE との連携設定はクライアントに応じてその構成ファイルに保存してください。 -```bash -npx igniteui-cli ai-config -``` - -Ignite UI CLI がグローバルにインストールされている場合は、短縮形を使用します: - -```bash -ig ai-config -``` +完全なセットアップについては、[エージェント スキル](skills.md)を参照してください。 - +### ステップ 2 - CLI MCP サーバーを接続する -`npx igniteui-cli` と `ig` 形式は `@angular/cli` MCP サーバーを登録しません。1 回の操作で 3 つのサーバーをすべて設定する場合は、上記の Angular Schematics コマンドを使用してください。 - - - - - - -このコマンドには、プロジェクトに Ignite UI パッケージがインストールされている必要があります (`npm install`)。スキル ファイルが見つからない場合は、パッケージが最新の状態であることを確認してください。 - - - - -### ステップ 1 — エージェント スキルのロード - -フレームワーク用の Ignite UI スキル パッケージをプロジェクトのエージェント検出パスにコピーします。スキル パッケージは `node_modules/igniteui-{framework}/skills/` のライブラリと共に同梱されています。使用しているクライアントの永続的なセットアップを使用して IDE に接続します。 - -完全なセットアップについては、[エージェント スキル](skills.md) を参照してください。 - -### ステップ 2 — CLI MCP サーバーへの接続 - -AI クライアントの設定ファイルに `igniteui-cli` MCP サーバー エントリを追加します。クライアントに合った JSON 構造を使用します: +AI クライアントの構成ファイルに `igniteui-cli` MCP サーバー エントリを追加します。クライアントに合った JSON 構造を使用してください。 **VS Code (`.vscode/mcp.json`):** @@ -158,11 +117,11 @@ AI クライアントの設定ファイルに `igniteui-cli` MCP サーバー } ``` -VS Code、GitHub、Cursor、Claude Desktop、Claude Code、JetBrains、その他の MCP 互換クライアントを含む完全なセットアップ ガイドについては、[CLI MCP](cli-mcp.md) を参照してください。 +VS Code、GitHub、Cursor、Claude Desktop、Claude Code、JetBrains、その他の MCP 互換クライアントを含む完全なセットアップ ガイドについては、[CLI MCP](cli-mcp.md)を参照してください。 -### ステップ 3 — Theming MCP サーバーへの接続 (オプション) +### ステップ 3 - Theming MCP サーバーを接続する (オプション) -`igniteui-cli` と並べて同じ MCP 設定ファイルに `igniteui-theming` エントリを追加します: +`igniteui-cli` と並んで、同じ MCP 構成ファイルに `igniteui-theming` エントリを追加します。 ```json { @@ -175,17 +134,18 @@ VS Code、GitHub、Cursor、Claude Desktop、Claude Code、JetBrains、その他 } ``` -設定の詳細とテーマ ワークフローについては、[Theming MCP](theming-mcp.md) を参照してください。 +構成の詳細とテーマ ワークフローについては、[Theming MCP](theming-mcp.md)を参照してください。 ## その他のリソース + - [エージェント スキル](./skills.md) - [Ignite UI CLI MCP](./cli-mcp.md) - [Ignite UI Theming MCP](./theming-mcp.md)
-コミュニティは常に活気があり、新しいアイデアを歓迎しています。 +コミュニティに参加して新しいアイデアをご提案ください。 - [Ignite UI for Angular **フォーラム** (英語)](https://www.infragistics.com/community/forums/f/ignite-ui-for-angular) - [Ignite UI for Angular **GitHub** (英語)](https://github.com/IgniteUI/igniteui-angular) diff --git a/docs/angular/src/content/jp/components/ai/cli-mcp.mdx b/docs/angular/src/content/jp/components/ai/cli-mcp.mdx index 211b1256b0..186f5cc49c 100644 --- a/docs/angular/src/content/jp/components/ai/cli-mcp.mdx +++ b/docs/angular/src/content/jp/components/ai/cli-mcp.mdx @@ -1,145 +1,151 @@ --- -title: Angular Ignite UI CLI MCP | Infragistics -description: Ignite UI CLI MCP を AI クライアントに接続して、Ignite UI for Angular のプロジェクト スキャフォールディング、既存アプリの変更、コンポーネントの作成と更新、ドキュメントの質問に対応します。VS Code、GitHub、Cursor、Claude Desktop、Claude Code、JetBrains、その他の MCP クライアントのセットアップ オプションをご覧ください。 -keywords: Angular, Ignite UI for Angular, Infragistics, Ignite UI CLI MCP, Ignite UI Theming MCP, MCP, Model Context Protocol, AI, エージェント, GitHub Copilot, Cursor, Claude, JetBrains -_language: ja +title: "Angular Ignite UI CLI MCP | Infragistics" +description: "Ignite UI CLI MCP を AI クライアントに接続して、Ignite UI for Angular のプロジェクトのスキャフォールディング、既存アプリの変更、コンポーネントの作成と更新、ドキュメントの質問に回答します。VS Code、GitHub、Cursor、Claude Desktop、Claude Code、JetBrains、その他の MCP クライアントのセットアップ オプションについて説明します。" +keywords: "Angular, Ignite UI for Angular, Infragistics, Ignite UI CLI MCP, Ignite UI Theming MCP, MCP, Model Context Protocol, AI, エージェント, GitHub Copilot, Cursor, Claude, JetBrains" license: MIT -canonicalLink: "/components/ai/cli-mcp" +_canonicalLink: "{environment:dvUrl}/components/ai/cli-mcp" mentionedTypes: [] last_updated: "2026-04-21" --- - import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro'; # Ignite UI CLI MCP -

Ignite UI CLI MCP は Model Context Protocol (MCP) サーバーで、AI アシスタントが Ignite UI for Angular アプリケーションのプロジェクト スキャフォールディング、既存アプリの変更、コンポーネントの作成と更新、ドキュメントへの質問に対応できるようにします。Ignite UI CLI MCP をエディター、GitHub リポジトリ、またはデスクトップ AI クライアントに接続して、行いたいことを説明すると、アシスタントが CLI ツールを代わりに操作します。

+

Ignite UI CLI MCP は、AI アシスタントが Ignite UI for Angular アプリケーションのプロジェクトのスキャフォールディング、既存アプリの変更、コンポーネントの作成と更新、ドキュメントの質問に回答できるようにする Model Context Protocol (MCP) サーバーです。Ignite UI CLI MCP をエディター、GitHub リポジトリ、またはデスクトップ AI クライアントに接続し、やりたいことを伝えると、アシスタントが CLI ツールを使用します。

## 概要 -Ignite UI CLI MCP は、チャットまたはエージェント モードを通じて Ignite UI CLI プロジェクト スキャフォールディング、コンポーネント生成、プロジェクト変更、ドキュメント対応ワークフローへの直接アクセスを AI アシスタントに提供します。サーバーは Ignite UI Theming MCP と連携して動作します。CLI MCP はプロジェクトとコンポーネントのワークフローを担当し、Theming MCP はパレット、テーマ、トークン、スタイリングを担当します。ほとんどのチームは、同じ AI クライアント セッションで両方のサーバーを接続します。 +Ignite UI CLI MCP は、チャットまたはエージェント モードを通じて、Ignite UI CLI プロジェクトのスキャフォールディング、コンポーネント生成、プロジェクト変更、ドキュメント対応ワークフローへの直接アクセスを AI アシスタントに提供します。サーバーは Ignite UI Theming MCP と連携して動作します。CLI MCP がプロジェクトとコンポーネントのワークフローを処理し、Theming MCP がパレット、テーマ、トークン、スタイリングを処理します。ほとんどのチームは、両方のサーバーを同じ AI クライアント セッションに接続させます。 + +推奨セットアップ手順は、最初に Ignite UI CLI から始めることです。この手順では、Ignite UI CLI がプロジェクトを作成し、必要なパッケージをインストールし、VS Code 用の MCP 構成を初期設定します。また、空のフォルダーでアシスタントが MCP を通じてプロジェクトを作成するところから開始することも、既存のプロジェクトに MCP を接続することもできます。 + -推奨されるセットアップ パスは、最初に Ignite UI CLI を使用することです。このパスでは、プロジェクトの作成、必要なパッケージのインストール、VS Code 用の初期 MCP 設定の書き込みが行われます。空のフォルダーから開始して、アシスタントに MCP 経由でプロジェクトを作成させることも、既存のプロジェクトに MCP を接続することもできます。 -**接続後に試せるプロンプト例:** +**接続後に試すプロンプトの例:** -> _「このフォルダーに新しい Ignite UI for Angular プロジェクトを作成し、推奨のデフォルト設定を使用して、サンプル データを含むスターター ダッシュボード ページを追加してください。」_ +> _「このフォルダーに新しい Ignite UI for Angular プロジェクトを作成し、推奨されるデフォルトを使用して、サンプル データを含むスターター ダッシュボード ページを追加して」_ -> _「このプロジェクトに新しいグリッド ページを追加し、サンプル データに接続して、現在のナビゲーション構造を維持してください。」_ +> _「このプロジェクトに新しいグリッド ページを追加し、サンプル データに接続して、現在のナビゲーション構造を維持して」_ -> _「コンボ コンポーネントが公開するプロパティとイベント、および検索可能なドロップダウンに最も役立つものを教えてください。」_ +> _「コンボ コンポーネントが公開するプロパティとイベントは何ですか? 検索可能なドロップダウンに最も役立つものはどれですか?」_ -> _「既存のプロジェクトを更新してサイド ナビゲーション レイアウトを追加し、現在のページとルートを保持してください。」_ +> _「既存のプロジェクトを更新してサイド ナビゲーション レイアウトを追加し、現在のページとルートを維持して」_ ## 前提条件 -MCP サーバーを設定する前に、以下のものが揃っていることを確認してください: +MCP サーバーを構成する前に、以下の前提条件が満たされていることを確認してください。 -- **Node.js** (v18 以降) のインストール — サーバー起動に使用する `npx` コマンドを提供します。 -- **MCP をサポートする AI クライアント** — 例: VS Code with GitHub Copilot、GitHub Copilot クラウド エージェント、Cursor、Claude Desktop、Claude Code、AI Assistant プラグインを使用した JetBrains IDE。 -- サーバーの初回起動時に `npx` パッケージ解決に必要なインターネット アクセス。 +- **Node.js** (v18 以降) がインストールされていること — これにより、サーバーの起動に使用される `npx` コマンドが提供されます。 +- **MCP サポートを備えた AI クライアント** — 例: VS Code と GitHub Copilot、GitHub Copilot クラウド エージェント、Cursor、Claude Desktop、Claude Code、または AI Assistant プラグインを備えた JetBrains IDE。 +- 最初にサーバーが起動するときの `npx` パッケージ解決のためのインターネット アクセス。 - 以下のいずれかの開始点: - 新しいプロジェクト用の空のフォルダー - Ignite UI CLI で作成したプロジェクト - - 続けて作業したい既存の Ignite UI for Angular プロジェクト + - 引き続き作業する既存の Ignite UI for Angular プロジェクト -同じクライアント セッションでテーマ ツールが必要で、`igniteui-theming` がプロジェクトにまだない場合は、次のコマンドを実行します: +同じクライアント セッションでテーマ ツールも使用したいが、`igniteui-theming` がまだプロジェクトで利用できない場合は、次のコマンドを実行します。 ```bash npm install igniteui-theming ``` -## AI クライアント向けの Ignite UI CLI MCP 設定 +## AI クライアント用の Ignite UI CLI MCP の構成 -MCP サーバーは `npx` を通じて起動します。Node.js と `igniteui-cli` パッケージへのアクセス以外に、別途インストールする必要はありません。 +MCP サーバーは `npx` を通じて起動されます。Node.js と `igniteui-cli` パッケージへのアクセス以外に追加のインストールは必要ありません。 -標準の起動コマンドは次のとおりです: +正規の起動コマンドは次のとおりです。 ```bash npx -y igniteui-cli mcp ``` - - -`-y` フラグは `npx` にパッケージのダウンロード確認を自動承認するよう指示し、手動の操作なしにサーバーを起動できます。 - + +`-y` フラグは、`npx` にパッケージ ダウンロード プロンプトを自動確認するように指示するため、サーバーは手動介入なしで起動できます。 +### セットアップ手順を選択する -### セットアップ パスの選択 +Ignite UI CLI MCP を開始するには 3 つの方法があります。 -Ignite UI CLI MCP を開始するには 3 つの方法があります: - -> **推奨 — CLI を先に使用** -> `ig new` または対応する `npx --package igniteui-cli igniteui new` コマンドを使用して、まず Ignite UI CLI でプロジェクトを作成します。Ignite UI CLI がプロジェクトをスキャフォールディングし、必要なパッケージをインストールし、VS Code 用の `.vscode/mcp.json` を自動的に書き込むため、これが最も簡単なセットアップです。その後は、生成された MCP 設定を確認して AI クライアントでプロジェクトを開くだけです。 +> **推奨 - CLI ファースト** + 最初に `ig new` または `npx --package igniteui-cli igniteui new` コマンドにより Ignite UI CLI を使ってプロジェクトを作成します。Ignite UI CLI がプロジェクトをスキャフォールディングし、必要なパッケージをインストールし、VS Code 用の `.vscode/mcp.json` を自動的に作成するため、これが最も簡単なセットアップです。その後、生成された MCP 構成を確認し、AI クライアントでプロジェクトを開くだけです。 > **空のフォルダー** -> 完全に空のフォルダーから開始し、MCP 設定を手動で追加してから、アシスタントにチャット経由でプロジェクトを作成するよう依頼します。このパスは、CLI を先に実行するのではなく MCP で最初からプロジェクト作成フローを主導したい場合に便利です。 + 完全に空のフォルダーから始め、MCP 構成を手動で追加してから、アシスタントにチャットを通じてプロジェクトを作成するよう依頼します。このパスは、最初に CLI を自分で実行するのではなく、MCP でプロジェクト作成フローを最初から動かしたい場合に便利です。 -> **既存のプロジェクト** -> すでにあるプロジェクトに MCP 設定を追加して、現在のコードベースで作業を継続します。`ig ai-config` (Angular プロジェクトの場合は `ng generate @igniteui/angular-schematics:ai-config`) を実行して、`.vscode/mcp.json` を書き込み、エージェント スキルをプロジェクトに自動的にコピーします。他の AI クライアントの場合は、以下のクライアント固有のセクションからサーバー エントリをコピーします。 +> **既存プロジェクト** + 既存のプロジェクトに MCP 構成を追加し、現在のコードベースで作業を続けます。このパスは、プロジェクトが既に存在し、プロジェクトの変更、コンポーネント作業、ドキュメントへの質問を、何も再生成することなくアシスタントに支援させたい場合に便利です。 -3 つのパスすべてで同じ MCP サーバーを使用します。違いは、プロンプトを開始する前にプロジェクトをどのように準備するかだけです: +3 つのパスはすべて同じ MCP サーバーを使用します。違いは、プロンプトを開始する前にプロジェクトがどのように準備されるかだけです。 -- **CLI 先行** パスでは、Ignite UI CLI がプロジェクトを作成し、最初の MCP 設定を用意します -- **空のフォルダー** パスでは、先に MCP 設定を作成し、その後アシスタントにプロジェクトを作成させます -- **既存のプロジェクト** パスでは、`ig ai-config` を実行して `.vscode/mcp.json` を書き込み、エージェント スキルを自動的にコピーするか、他のクライアント向けに手動で設定を追加します +- **CLI ファースト**の手順では、Ignite UI CLI がプロジェクトを作成し、最初の MCP 構成を準備します +- **空のフォルダー**の手順では、最初に MCP 構成を作成し、その後アシスタントにプロジェクトを作成させます +- **既存プロジェクト**の手順では、MCP を現在のコードベースにアタッチし、既存のものから続行します -どの場合も、MCP サーバーが接続されて AI クライアントに表示されれば、アシスタントは同じセッションで作業を継続できます。 +いずれの場合も、MCP サーバーが接続されて AI クライアントで表示されたら、アシスタントは同じセッションで作業を続けることができます。 -最初に Ignite UI CLI でプロジェクトを作成する場合、次のいずれかの方法で CLI を実行できます: +最初に Ignite UI CLI でプロジェクトを作成する場合は、次のいずれかの方法で CLI を実行できます。 - **グローバル インストール** - ```bash - npm install -g igniteui-cli - ``` + ```bash + npm install -g igniteui-cli + ``` - これにより、どのターミナル セッションでも `ig` コマンドが使用できるようになります。定期的にプロジェクトを作成およびスキャフォールディングする予定であれば、最も明確な選択肢です。 + これにより、任意のターミナル セッションで `ig` コマンドが使用できるようになります。定期的にプロジェクトの作成あるいはスキャフォールディングを行う場合は、最も明確なオプションです。 - **グローバル インストールなし** - ```bash - npx --package igniteui-cli igniteui new - ``` + ```bash + npx --package igniteui-cli igniteui new + ``` - グローバルな `ig` コマンドの代わりに `npx` 経由で CLI を実行します。 + グローバルな `ig` コマンドの代わりに `npx` を通じて CLI を実行します。 -**CLI 先行** パスでは、ガイド モードまたは直接コマンドでプロジェクトを作成できます。 +**CLI ファースト**の手順の場合、ガイド モードまたは直接コマンドでプロジェクトを作成できます。 -利用可能なオプションを CLI が案内してくれるガイド モードを使用する場合: +CLI に利用可能なオプションを案内させたい場合はガイド モードを使用します。 ```bash ig new ``` -対応する `npx` 形式: +`npx` で実行する場合: ```bash npx --package igniteui-cli igniteui new ``` -プロジェクト設定がわかっている場合は直接コマンドを使用します: +プロジェクト設定を既に知っている場合は直接コマンドを使用します。 + ```bash ig new my-app --framework=angular --type=igx-ts --template=empty ``` -対応する `npx` 形式: +`npx` で実行する場合: ```bash npx --package igniteui-cli igniteui new my-app --framework=angular --type=igx-ts --template=empty ``` -ガイド モードでは、Ignite UI CLI がプロジェクト名、フレームワーク、テンプレート、テーマ、コンポーネントを追加するかセットアップを完了するかを確認します。直接モードでは、フレームワークとサポートされているオプションをコマンドで指定します。 -プロジェクト テンプレート、CLI コマンド オプション、`ig add` などのコンポーネント スキャフォールディング コマンドの詳細については、Angular 向けの Ignite UI CLI ドキュメントを参照してください。 + + + + +ガイド モードでは、Ignite UI CLI は、プロジェクト名、フレームワーク、テンプレート、テーマ、コンポーネントを追加するか、セットアップを完了するか、を対話形式で聞いてきます。直接モードでは、フレームワークとサポートされているオプションをコマンド自体に指定します。 + + +プロジェクト テンプレート、CLI コマンド オプション、`ig add` などのコンポーネント スキャフォールディング コマンドの詳細については、Angular の Ignite UI CLI ドキュメントを参照してください。 + + ### VS Code -VS Code の GitHub Copilot は、ワークスペース レベルの設定ファイルを通じて MCP サーバーをサポートします。プロジェクト ルートから `ig ai-config` (または `ng generate @igniteui/angular-schematics:ai-config`) を実行して、このファイルを自動的に生成します。手動で設定するには、プロジェクト ルートに `.vscode/mcp.json` を作成または編集します: +VS Code の GitHub Copilot は、ワークスペース レベルの構成ファイルを介して MCP サーバーをサポートします。プロジェクト ルートに `.vscode/mcp.json` を作成または編集します。 ```json { @@ -156,20 +162,17 @@ VS Code の GitHub Copilot は、ワークスペース レベルの設定ファ } ``` -最初に Ignite UI CLI でプロジェクトを作成した場合は、生成された `.vscode/mcp.json` を確認して両方のエントリが存在することを確認してください。 +最初に Ignite UI CLI でプロジェクトを作成した場合は、生成された `.vscode/mcp.json` を確認し、両方のエントリが存在することを確認してください。 -保存後、GitHub Copilot チャット パネルを開いて**エージェント** モードに切り替えると、Ignite UI CLI MCP ツールが利用可能になります。 - - - -VS Code での MCP サポートには GitHub Copilot と VS Code 1.99 以降が必要です。 +保存したら、GitHub Copilot チャット パネルを開き、**Agent** モードに切り替えると、Ignite UI CLI MCP ツールが利用できるようになります。 + +VS Code での MCP サポートには、GitHub Copilot と VS Code 1.99 以降が必要です。 - ### Cursor -Cursor はプロジェクト スコープの MCP 設定をサポートします。プロジェクト ルートに `.cursor/mcp.json` を作成または編集します: +Cursor はプロジェクト スコープの MCP 構成をサポートします。プロジェクト ルートに `.cursor/mcp.json` を作成または編集します。 ```json { @@ -186,18 +189,15 @@ Cursor はプロジェクト スコープの MCP 設定をサポートします } ``` -新しい Cursor チャット セッションを開くと、サーバーが自動的に検出されます。 - - - -Cursor の **Settings → MCP** からグローバルに MCP サーバーを設定することもできます。 +サーバーは、新しい Cursor チャット セッションを開くと自動的に選択されます。 + +Cursor の **Settings → MCP** を介してグローバルに MCP サーバーを構成することもできます。 - ### Claude Desktop -サーバーを Claude Desktop 設定ファイルに追加します: +サーバーを Claude Desktop 構成ファイルに追加します。 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` @@ -217,11 +217,11 @@ Cursor の **Settings → MCP** からグローバルに MCP サーバーを設 } ``` -保存後、Claude Desktop を再起動します。チャット入力エリアに MCP サーバー インジケーター (スライダー アイコン) が表示され、MCP ツールがアクティブであることが確認できます。 +保存後に Claude Desktop を再起動します。チャット入力エリアに MCP サーバー インジケーター (スライダー アイコン) が表示され、MCP ツールがアクティブであることが確認されます。 ### Claude Code -Claude Code は CLI と プロジェクト スコープの `.mcp.json` ファイルを通じて MCP サーバーをサポートします。チームと設定を共有するには、プロジェクト ルートに `.mcp.json` を作成または編集します: +Claude Code は、CLI とプロジェクト スコープの `.mcp.json` ファイルを介して MCP サーバーをサポートします。チームと構成を共有するには、プロジェクト ルートに `.mcp.json` を作成または編集します。 ```json { @@ -238,26 +238,23 @@ Claude Code は CLI と プロジェクト スコープの `.mcp.json` ファイ } ``` -ローカル環境のみの場合は、コマンドラインでサーバーを追加することもできます: +または、ローカル環境専用にコマンド ラインでサーバーを追加できます。 ```bash claude mcp add igniteui-cli -- npx -y igniteui-cli mcp claude mcp add igniteui-theming -- npx -y igniteui-theming igniteui-theming-mcp ``` -Claude Code 内の `/mcp` コマンドを使用して、サーバーが接続されていることを確認します。 +Claude Code 内で `/mcp` コマンドを使用して、サーバーが接続されていることを確認します。 ### JetBrains IDE -JetBrains AI Assistant は IDE の設定から MCP サーバーをサポートします: +JetBrains AI Assistant は、IDE 設定を介して MCP サーバーをサポートします。 1. **Settings** (macOS では **Preferences**) を開きます。 - 2. **Tools → AI Assistant → Model Context Protocol (MCP)** に移動します。 - -3. **+ Add** をクリックして **As JSON** を選択するか、フォーム フィールドを使用します。 - -4. 次の設定を入力します: +3. **+ Add** をクリックし、**As JSON** を選択するかフォーム フィールドを使用します。 +4. 次の構成を入力します。 ```json { @@ -276,16 +273,13 @@ JetBrains AI Assistant は IDE の設定から MCP サーバーをサポート 5. **OK** をクリックして AI Assistant を再起動します。 - - -MCP サポートには、JetBrains IDE に AI Assistant プラグインがインストールされ有効になっている必要があります。 - + +MCP サポートには、JetBrains IDE に AI Assistant プラグインがインストールされて有効になっている必要があります。 - ### その他の MCP クライアント -他の MCP 互換クライアントでは、次の起動コマンドで STDIO トランスポートを使用します: +他の MCP 互換クライアントの場合は、次の起動コマンドで STDIO トランスポートを使用します。 ```bash npx -y igniteui-cli mcp @@ -294,15 +288,15 @@ npx -y igniteui-theming igniteui-theming-mcp ### GitHub -GitHub Copilot クラウド エージェントは、リポジトリ レベルの MCP 設定をサポートします。リポジトリで以下の操作を行います: +GitHub Copilot クラウド エージェントはリポジトリ レベルの MCP 構成をサポートします。リポジトリで次の操作を行います。 -1. リポジトリのメイン ページを開きます。 +1. メインのリポジトリ ページを開きます。 2. **Settings** をクリックします。 3. サイドバーで **Copilot** → **Cloud agent** に移動します。 4. **MCP configuration** セクションに JSON を貼り付けます。 5. **Save** をクリックします。 -次のようなリポジトリ設定を使用します: +次のようなリポジトリ構成を使用します。 ```json { @@ -323,118 +317,118 @@ GitHub Copilot クラウド エージェントは、リポジトリ レベルの } ``` -このセットアップは、GitHub クラウド エージェントがリポジトリ コンテキストから直接 CLI MCP ツールと Theming MCP ツールを使用する場合に便利です。 +このセットアップは、GitHub クラウド エージェントがリポジトリ コンテキストから直接同じ CLI MCP と Theming MCP ツールを使用する場合に便利です。 ## 利用可能なツール -MCP サーバーはプロンプトに基づいて AI が自動的に使用するツール セットを公開します。これらのツールを直接呼び出す必要はありません。チャットで行いたいことを説明すると、アシスタントが適切なツールを選択します。この表は、作業を開始する前に何が利用可能かを確認するためのものです。 +MCP サーバーは、AI がプロンプトに基づいて自動的に使用するツールのセットを公開しています。これらのツールを直接呼び出す必要はありません。チャットで必要なものを説明すれば、アシスタントが適切なツールを選択します。このテーブルは、開始前に何が利用可能かを把握するためのものです。 -現在のパラメーターを含むライブリストを取得するには、次のように尋ねます: +現在のパラメーターを含むライブ リストを取得するには、次のように質問します。 > _「Ignite UI CLI MCP が提供するツールは何ですか?」_ -各ツールの概要: +各ツールの概要を以下に示します。 -| ツール | 説明 | -| ------------------------ | ------------------------------------------------------------------------------------------------------------------ | -| `list_components` | フレームワーク向けの利用可能な Ignite UI コンポーネント ドキュメントをリスト表示します。名前、キーワード、サマリーに対する大文字と小文字を区別しない部分文字列検索のオプション キーワード フィルターを受け付けます。 | -| `get_doc` | kebab-case 名 (例: `grid-editing`、`combo-overview`) で特定のコンポーネント ドキュメントの完全な Markdown コンテンツを取得します。コード サンプル、テーブル、リンクを含みます。 | -| `search_docs` | フレームワークの Ignite UI ドキュメント全体をフル テキスト検索します。抜粋付きで最大 20 件のランク付き結果を返します。 | -| `get_project_setup_guide` | CLI の手順とインストール指示を含む、特定のフレームワークで新しいプロジェクトを作成するためのプロジェクト セットアップ ガイドを返します。 | -| `search_api` | Angular、React、Web Components 全体でキーワードまたはコンポーネント名で API エントリを検索します。 | -| `get_api_reference` | プロパティ、メソッド、イベントを含む特定のコンポーネントまたはクラスの完全な API リファレンスを返します。Angular、React、Web Components をサポートします。 | +| ツール | 説明 | +|------|-------------| +| `list_components` | フレームワークの利用可能な Ignite UI コンポーネント ドキュメントをリストします。オプションのキーワード フィルター (名前、キーワード、概要に対する大文字と小文字を区別しない部分文字列一致) を受け入れます。 | +| `get_doc` | ケバブ ケース名 (例: `grid-editing`、`combo-overview`) で特定のコンポーネント ドキュメントの完全なマークダウン コンテンツを取得します。コード サンプル、テーブル、リンクを含みます。 | +| `search_docs` | フレームワークの Ignite UI ドキュメント全体でフルテキスト検索を実行します。抜粋付きで最大 20 件のランク付けされた結果を返します。 | +| `get_project_setup_guide` | CLI 手順とインストール手順を含む、特定のフレームワークで新しいプロジェクトを作成するためのプロジェクト セットアップ ガイドを返します。 | +| `search_api` | Angular、React、Web Components 全体でキーワードまたはコンポーネント名によって API エントリを検索します。 | +| `get_api_reference` | プロパティ、メソッド、イベントを含む、特定のコンポーネントまたはクラスの完全な API リファレンスを返します。Angular、React、Web Components をサポートします。 | -CLI MCP ツールは、大まかに次のことに役立ちます: +まとめると、CLI MCP ツールは以下を支援します。 - 新しいプロジェクトの作成 -- 既存のプロジェクトでの作業 +- 既存プロジェクトでの作業 - コンポーネントの追加と変更 -- プロジェクト構造と設定の更新 -- ドキュメントと API に関する質問への回答 - - - -フレームワーク検出はコンポーネント プレフィックス: `for Angular`、`for React`、`for Web Components`、`for Blazor` を使用します。アシスタントは、開いているファイルまたはプロンプトのコンテキストから正しいフレームワークを自動的に検出します。 +- プロジェクト構造と構成の更新 +- ドキュメントと API の質問への回答 + +フレームワークの検出にはコンポーネント名のプレフィックスを参照します: Angular は `Igx`、React は `Igr`、Web Components は `Igc`、Blazor は `Igb` です。アシスタントは、開いているファイルまたはプロンプト コンテキストから正しいフレームワークを自動的に選択します。 +テーマ サーバーは、同じクライアント セッションにスタイリング、テーマ、パレット、トークン ワークフローを追加します。 + -Theming サーバーは、同じクライアント セッションにスタイリング、テーマ、パレット、トークンのワークフローを追加します。 ## 一般的なワークフロー -次のセットアップ シナリオは、各開始点をいつ使用するかを示しています。 +以下のセットアップ シナリオは、各開始点を使用するタイミングを示します。 -### CLI 先行のセットアップ +### CLI ファーストセットアップ -最速のガイド付きセットアップが必要で、`.vscode/mcp.json` を自動生成したい場合は、まず Ignite UI CLI でプロジェクトを作成します。 +最も速いガイド付きセットアップが必要で、`.vscode/mcp.json` を自動生成したい場合は、最初に Ignite UI CLI でプロジェクトを作成します。 -シナリオ例: +シナリオの例: -- _「まず Ignite UI CLI で新しいプロジェクトを作成し、生成されたプロジェクトを VS Code で開いて、MCP を使って続けたいです。」_ -- _「React プロジェクトが欲しいことがわかっているので、CLI で作成してから MCP を使ってページとコンポーネントを追加します。」_ +- _「最初に Ignite UI CLI で新しいプロジェクトを作成し、生成されたプロジェクトを VS Code で開き、そこから MCP で続ける」_ +- _「React プロジェクトが必要なので、CLI で作成してから MCP を使用してページとコンポーネントを追加する」_ ### 空のフォルダーのセットアップ -MCP 設定を追加した後にアシスタントにチャットからプロジェクトを作成させたい場合は、空のフォルダーから開始します。 +自分で MCP 構成を追加した後、アシスタントにチャットからプロジェクトを作成させたい場合は、空のフォルダーから始めます。 -シナリオ例: +シナリオの例: -- _「完全に空のフォルダーがあり、MCP が接続されてからアシスタントにチャットでプロジェクト全体を作成させたいです。」_ -- _「Ignite UI CLI を先に手動で実行したくないので、MCP で最初のプロジェクト作成ステップを主導させます。」_ +- _「完全に空のフォルダーがあり、MCP が接続された後にアシスタントにチャットからプロジェクト全体を作成させる」_ +- _「最初に Ignite UI CLI を手動で実行したくない。MCP で最初のプロジェクト作成ステップを動かしたい」_ -### 既存のプロジェクトのセットアップ +### 既存プロジェクトのセットアップ -現在のコードベースを維持しながら、プロジェクトの変更、コンポーネントの作業、ドキュメントの質問にアシスタントを使用したい場合は、既存のプロジェクトに MCP を接続します。 +現在のコードベースを維持してアシスタントにプロジェクトの変更、コンポーネント作業、ドキュメントの質問を支援させたい場合は、MCP を既存のプロジェクトに接続します。 -シナリオ例: +シナリオの例: -- _「すでにプロジェクトがあり、アシスタントがページとコンポーネントを更新できるように MCP を追加するだけです。」_ -- _「プロジェクトはすでに存在しており、現在のコードベースで作業しながら主にドキュメントと API の質問をしたいです。」_ +- _「プロジェクトは既にあり、アシスタントにページとコンポーネントの更新を支援させるためだけに MCP を追加したい」_ +- _「プロジェクトは既に存在し、主に現在のコードベースで作業しながらドキュメントと API の質問をしたい」_ ## トラブルシューティング **`npx` が認識されない** -Node.js がインストールされていないか、現在のターミナル環境で使用できません。[nodejs.org](https://nodejs.org) から Node.js をインストールして、`node --version` で確認してください。 +Node.js がインストールされていないか、現在のターミナル環境で利用できません。[nodejs.org](https://nodejs.org) から Node.js をインストールし、`node --version` で確認します。 **`ig` が認識されない** -グローバルな `ig` コマンドを使用する場合は、まず `npm install -g igniteui-cli` で Ignite UI CLI をインストールしてください。グローバル インストールを行わない場合は、代わりに `npx --package igniteui-cli igniteui ...` 形式を使用します。 +グローバルな `ig` コマンドを使用したい場合は、最初に `npm install -g igniteui-cli` で Ignite UI CLI をインストールします。グローバル インストールが不要な場合は、代わりに `npx --package igniteui-cli igniteui ...` 形式を使用します。 -**設定を保存した後、MCP ツールが表示されない** +**構成を保存した後に MCP ツールが表示されない** -ワークスペースをリロードするか、エディターを再起動するか、AI クライアントを再起動してください。一部のクライアントでは、新しい MCP 設定ファイルを検出するために完全な再起動が必要です。 +ワークスペースをリロードし、エディターを再起動するか、AI クライアントを再起動します。一部のクライアントでは、新しい MCP 構成ファイルを検出するために完全な再起動が必要です。 -**1 つのサーバーが起動しない** +**一方のサーバーが起動しない** -設定の内容が、キー名と引数の順序を含めてサンプルと完全に一致していることを確認してください。 +構成コンテンツがキー名と引数の順序を含めて例と正確に一致していることを確認します。 -**プロジェクトは作成されたが、MCP 設定が VS Code のみ対応** +**プロジェクトは作成されたが、MCP 構成は VS Code のみで利用可能** -Ignite UI CLI は CLI 先行パスで `.vscode/mcp.json` を書き込みます。Cursor、Claude Desktop、Claude Code、JetBrains、GitHub、または他の MCP クライアントを使用している場合は、そのクライアントの設定形式と場所に合わせて同じサーバー エントリをコピーしてください。 +Ignite UI CLI は CLI ファースト手順のプロジェクト新規作成において `.vscode/mcp.json` を書き込みます。Cursor、Claude Desktop、Claude Code、JetBrains、GitHub、または別の MCP クライアントを使用している場合は、同じサーバー エントリをそのクライアントの構成形式と場所にコピーします。 -**アシスタントが間違ったフォルダーで作業している、またはプロジェクト ファイルが見つからない** +**アシスタントが間違ったフォルダーで作業しているか、プロジェクト ファイルが見つからない** -AI クライアントがプロジェクト ルートを指していることを確認してください。エディター ベースのクライアントを使用している場合は、プロジェクト ルート フォルダーを開きます。デスクトップまたはチャット ファーストのクライアントを使用している場合は、正しいプロジェクト フォルダーをセッション コンテキストとして利用できるようにします。 +AI クライアントがプロジェクト ルートを指していることを確認します。エディター ベースのクライアントを使用している場合は、プロジェクト ルート フォルダーを開きます。デスクトップまたはチャット ファーストのクライアントを使用している場合は、正しいプロジェクト フォルダーをセッション コンテキストとして使用できるようにします。 -**空のフォルダーのセットアップが期待どおりに動作しない** +**空のフォルダーのセットアップが期待通りに動作しない** -開始する前にフォルダーが実際に空であることを確認してください。フォルダーにすでにプロジェクト ファイルが含まれている場合は、新しい空のワークスペースとして扱うのではなく、既存のプロジェクト パスを使用します。 +開始前にフォルダーが実際に空であることを確認します。フォルダーに既にプロジェクト ファイルが含まれている場合は、新しい空のワークスペースとして扱う代わりに、既存プロジェクトの手順を使用します。 -**GitHub MCP 設定が拒否される** +**GitHub MCP 構成が拒否される** -JSON が `mcpServers` 構造を使用し、各ローカル サーバー エントリに `type`、`command`、`args` が含まれていることを確認してください。`tools` フィールドを含める場合は、有効なツール名または `["*"]` を使用します。 +JSON が `mcpServers` 構造を使用していること、および各ローカル サーバー エントリに `type`、`command`、`args` が含まれていることを確認します。`tools` フィールドを含める場合は、有効なツール名または `["*"]` を使用します。 ## その他のリソース -- [Ignite UI を使用した AI 支援開発](./ai-assisted-development-overview.md) + +- [Ignite UI を使った AI 支援開発](./ai-assisted-development-overview.md) - [Ignite UI for Angular スキル](./skills.md) - [Ignite UI Theming MCP](./theming-mcp.md)
-コミュニティは常に活気があり、新しいアイデアを歓迎しています。 +コミュニティに参加して新しいアイデアをご提案ください。 - [Ignite UI for Angular **フォーラム** (英語)](https://www.infragistics.com/community/forums/f/ignite-ui-for-angular) - [Ignite UI for Angular **GitHub** (英語)](https://github.com/IgniteUI/igniteui-angular) diff --git a/docs/angular/src/content/jp/components/ai/skills.mdx b/docs/angular/src/content/jp/components/ai/skills.mdx index b8722c78b7..b599dc6b49 100644 --- a/docs/angular/src/content/jp/components/ai/skills.mdx +++ b/docs/angular/src/content/jp/components/ai/skills.mdx @@ -4,14 +4,13 @@ description: エージェント スキルを使用して、Ignite UI for Angular keywords: Ignite UI for Angular, エージェント スキル, AI 支援開発, github copilot, cursor, windsurf, claude, gemini cli, junie _language: ja --- - import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro'; # Ignite UI for Angular エージェント スキル Ignite UI for Angular には **[エージェント スキル](https://agentskills.io/)** が付属しています。これは、AI コーディング アシスタント (GitHub Copilot、Cursor、Windsurf、Claude、Gemini CLI、JetBrains Junie など) に Ignite UI for Angular の使用方法を教える構造化されたナレッジ ファイルです。これらのスキル ファイルは、コンポーネント、グリッド、データ操作、テーマ設定に関するコンテキスト対応のガイダンスを提供し、AI アシスタントがベスト プラクティスに従った正確で慣用的なコードを生成できるようにします。 - + AI ツールのランドスケープは急速に進化しています。スキルの検出場所と配布オプションは、ツールや IDE の更新に伴って変更される可能性があります。最新情報については、使用しているツールやエージェントの公式ドキュメントを常に参照してください。 @@ -19,6 +18,12 @@ AI ツールのランドスケープは急速に進化しています。スキ スキル ファイルは、Ignite UI for Angular リポジトリの [`skills/`](https://github.com/IgniteUI/igniteui-angular/tree/master/skills) ディレクトリにあります: + + + + + + | スキル | パス | 説明 | |:------|:-----|:------------| | コンポーネントとレイアウト | [`skills/igniteui-angular-components/SKILL.md`](https://github.com/IgniteUI/igniteui-angular/blob/master/skills/igniteui-angular-components/SKILL.md) | スタンドアロン コンポーネント、フォーム コントロール、オーバーレイ、レイアウト | @@ -26,10 +31,12 @@ AI ツールのランドスケープは急速に進化しています。スキ | テーマ設定とスタイル設定 | [`skills/igniteui-angular-theming/SKILL.md`](https://github.com/IgniteUI/igniteui-angular/blob/master/skills/igniteui-angular-theming/SKILL.md) | パレット、タイポグラフィ、エレベーション、コンポーネント テーマ、MCP サーバー | | 画像デザインからの生成 | [`skills/igniteui-angular-generate-from-image-design/SKILL.md`](https://github.com/IgniteUI/igniteui-angular/blob/master/skills/igniteui-angular-generate-from-image-design/SKILL.md) | スクリーンショット、モックアップ、ワイヤーフレームから Ignite UI コンポーネントを使用して Angular アプリを構築 | - + Ignite UI for Angular **21.1.0** 以降、これらのスキルはエージェントのスキル パス (例: `.claude/skills`、`.agents/skills`、`.cursor/rules/`) に配置すると自動的に検出されます。このリリースには、これらのスキルをプロジェクトに自動的に追加するオプションの移行が含まれています。 + + ## スキルの場所 各 AI コーディング ツールは、特定のディレクトリからスキルを検出します。AI アシスタントがスキルを自動的に検出して使用できるように、スキル ファイルを適切な場所に配置します。一般的な `.agents/skills/` の規則は複数のツールでサポートされていますが、各ツールには独自の特定のディレクトリもあります。 @@ -38,6 +45,12 @@ Ignite UI for Angular **21.1.0** 以降、これらのスキルはエージェ `.agents/skills/` ディレクトリは、[VS Code と Copilot](https://code.visualstudio.com/docs/copilot/customization/agent-skills)、[OpenAI Codex](https://developers.openai.com/codex/skills)、[Cursor](https://cursor.com/docs/skills)、[Gemini CLI](https://geminicli.com/docs/cli/skills/#skill-discovery-tiers)、[Antigravity](https://antigravity.google/docs/skills)、[Windsurf](https://docs.windsurf.com/windsurf/cascade/skills#skill-scopes) など、複数のツールでサポートされているクロスエージェントの規則です。プロジェクト ルートの `.agents/skills/` にスキル ディレクトリをコピーします: + + + + + + ``` .agents/ skills/ @@ -51,6 +64,8 @@ Ignite UI for Angular **21.1.0** 以降、これらのスキルはエージェ SKILL.md ``` + + すべてのプロジェクトで利用可能なユーザー レベル (グローバル) スキルの場合は、代わりに `~/.agents/skills/` を使用します。 ### GitHub Copilot @@ -144,7 +159,7 @@ ng generate @igniteui/angular-schematics:ai-config --assistants cursor --agents これにより、Ignite UI サーバーと共に `@angular/cli` MCP サーバーも登録されます。 - + Ignite UI for Angular を手動でインストールした場合や `ai-config` を実行せずにスキルをコピーしたい場合、スキル ファイルは `node_modules` の下でも利用できます。それらをプロジェクトにコピーする (例: `.agents/skills/`) には、次のコマンドを実行します: @@ -164,6 +179,12 @@ robocopy node_modules\igniteui-angular\skills .agents\skills /E **macOS / Linux / Windows (PowerShell)** + + + + + + ```bash cp -r node_modules/igniteui-angular/skills/igniteui-angular-components .agents/skills/ cp -r node_modules/igniteui-angular/skills/igniteui-angular-grids .agents/skills/ @@ -171,8 +192,16 @@ cp -r node_modules/igniteui-angular/skills/igniteui-angular-theming .agents/skil cp -r node_modules/igniteui-angular/skills/igniteui-angular-generate-from-image-design .agents/skills/ ``` + + **Windows (Command Prompt)** + + + + + + ```cmd robocopy node_modules\igniteui-angular\skills\igniteui-angular-components .agents\skills\igniteui-angular-components /E robocopy node_modules\igniteui-angular\skills\igniteui-angular-grids .agents\skills\igniteui-angular-grids /E @@ -196,7 +225,9 @@ gh skill install IgniteUI/igniteui-angular gh skill update IgniteUI/igniteui-angular ``` -### **オプション C — `gemini skills` CLI を使用する** + + +### **オプション B — `gemini skills` CLI を使用する** `gemini skills install` コマンドは、Git リポジトリから直接スキルをインストールします。2 つのスコープをサポートします: @@ -205,6 +236,12 @@ gh skill update IgniteUI/igniteui-angular **ユーザー スコープにインストールする (デフォルト):** + + + + + + ```bash gemini skills install https://github.com/IgniteUI/igniteui-angular.git --path skills/igniteui-angular-components gemini skills install https://github.com/IgniteUI/igniteui-angular.git --path skills/igniteui-angular-grids @@ -212,8 +249,16 @@ gemini skills install https://github.com/IgniteUI/igniteui-angular.git --path sk gemini skills install https://github.com/IgniteUI/igniteui-angular.git --path skills/igniteui-angular-generate-from-image-design ``` + + **ワークスペース スコープにインストールする:** + + + + + + ```bash gemini skills install --scope workspace https://github.com/IgniteUI/igniteui-angular.git --path skills/igniteui-angular-components gemini skills install --scope workspace https://github.com/IgniteUI/igniteui-angular.git --path skills/igniteui-angular-grids @@ -221,9 +266,11 @@ gemini skills install --scope workspace https://github.com/IgniteUI/igniteui-ang gemini skills install --scope workspace https://github.com/IgniteUI/igniteui-angular.git --path skills/igniteui-angular-generate-from-image-design ``` + + インストールが完了すると、スキル ファイルはそれぞれの場所で利用できるようになり、互換性のある AI アシスタントによって自動的に検出されます。 -### **オプション D — `npx skills` CLI を使用する** +### **オプション C — `npx skills` CLI を使用する** `skills` CLI は、スキルをプロジェクトに直接ダウンロードしてインストールするインタラクティブなツールです。プロジェクト ルートで次のコマンドを実行します: @@ -245,21 +292,31 @@ CLI は、一連のプロンプトをガイドします: ## Theming MCP サーバー + + + + + + **Theming スキル**には、`igniteui-theming` MCP サーバーのセットアップ手順が含まれています。これにより、AI アシスタントがパレット生成やコンポーネント テーマのひな形作成などのライブ テーマ ツールにアクセスできます。VS Code、Cursor、Claude Desktop、JetBrains IDE の構成手順については、[Theming スキル ファイル](https://github.com/IgniteUI/igniteui-angular/blob/master/skills/igniteui-angular-theming/SKILL.md)を参照してください。 + + Theming MCP の詳細については、[Ignite UI Theming MCP](./theming-mcp.md) のドキュメントを参照してください。 ## その他のリソース -
+
+ - Ignite UI for Angular で作業を開始 - Angular Schematics & Ignite UI CLI -- [Ignite UI を使用した AI 支援開発](./ai-assisted-development-overview.md) + +- [Ignite UI を使った AI 支援開発](./ai-assisted-development-overview.md) - [Ignite UI CLI MCP](./cli-mcp.md) - [Ignite UI Theming MCP](./theming-mcp.md) -
+
コミュニティに参加して新しいアイデアをご提案ください。 - [Ignite UI for Angular **フォーラム** (英語)](https://www.infragistics.com/community/forums/f/ignite-ui-for-angular) diff --git a/docs/angular/src/content/jp/components/ai/theming-mcp.mdx b/docs/angular/src/content/jp/components/ai/theming-mcp.mdx index 7603b5b135..9d4f591fea 100644 --- a/docs/angular/src/content/jp/components/ai/theming-mcp.mdx +++ b/docs/angular/src/content/jp/components/ai/theming-mcp.mdx @@ -4,14 +4,11 @@ description: Ignite UI for Angular には Ignite UI Theming MCP サーバーが keywords: Ignite UI for Angular, UI コントロール, Angular ウィジェット, web ウィジェット, UI ウィジェット, コンポーネント スイート, 人工知能, AI, MCP, Model Context Protocol, テーマ設定, カスタム テーマ, パレット, タイポグラフィ, エレベーション _language: ja --- - import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro'; # Ignite UI Theming MCP -
-The Ignite UI Theming MCP is a Model Context Protocol (MCP) server that enables AI assistants to generate production-ready theming code for Ignite UI applications. MCP is an open standard that lets AI assistants call specialized tools provided by external servers. Connect the Ignite UI Theming MCP to your editor or desktop AI client and describe what you want — the assistant does the rest. -
+

Ignite UI Theming MCP は、AI アシスタントが Ignite UI アプリケーション用の本番対応のテーマ コードを生成できるようにする Model Context Protocol (MCP) サーバーです。MCP は、AI アシスタントが外部サーバーによって提供される特殊なツールを呼び出すことができるようにするオープン標準です。Ignite UI Theming MCP をエディターまたはデスクトップ AI クライアントに接続し、必要なものを説明すると、アシスタントが残りを行います。

@@ -23,6 +20,10 @@ The Ignite UI Theming MCP is a 「プライマリ #2563eb とコーラル セカンダリ #f97316 を使用して、Angular アプリ用の完全な Material Design ダーク テーマを作成して」 @@ -44,12 +45,16 @@ Angular の場合、これは `igniteui-angular` (v15.0 以降) です。サー - **MCP サポートを備えた AI クライアント** — 例: VS Code と GitHub Copilot、Cursor、Claude Desktop、Claude Code、または AI Assistant プラグインを備えた JetBrains IDE。 + `igniteui-angular` がまだインストールされていない場合は、次のコマンドを実行します。 ```bash ng add igniteui-angular ``` + + + ## セットアップ MCP サーバーは `igniteui-theming` パッケージにバンドルされており、`npx` 経由で起動されます。プロジェクトに Ignite UI パッケージが既にインストールされている以外に、別途インストールする必要はありません。 @@ -64,12 +69,14 @@ npx -y igniteui-theming igniteui-theming-mcp `-y` フラグは、`npx` にパッケージ ダウンロード プロンプトを自動確認するように指示するため、サーバーは手動介入なしで起動できます。
+ ### バージョン解決の仕組み `igniteui-theming` は `igniteui-angular` の依存関係であるため、`npm install` 後には既に `node_modules` に存在します。上記の起動コマンドを実行すると、`npx` はローカルにインストールされたコピーを検出し、直接実行します。ネットワーク リクエストは行われません。つまり、MCP サーバーのバージョンは、常に他の Ignite UI パッケージと同期した状態を保ちます。 プロジェクトの外部 (または `npm install` を実行する前) でコマンドを実行すると、`npx -y` は代わりに npm から**最新**バージョンを一時キャッシュにダウンロードします。サーバーは引き続き起動しますが、検査する `package.json` がないため、`detect_platform` は `generic` を返します。 + 以下から AI クライアントを選択して、特定の構成手順を確認してください。 ### VS Code @@ -161,12 +168,9 @@ Claude Code 内で `/mcp` コマンドを使用して、サーバーが接続さ JetBrains AI Assistant は、IDE 設定を介して MCP サーバーをサポートします。 -1. **\[Settings]** (macOS では **\[Preferences]**) を開きます。 - -2. **\[Tools] → \[AI Assistant] → \[Model Context Protocol (MCP)]** に移動します。 - -3. **\[+ Add]** をクリックし、**\[As JSON]** を選択するか、フォーム フィールドを使用します。 - +1. **[Settings]** (macOS では **[Preferences]**) を開きます。 +2. **[Tools] → [AI Assistant] → [Model Context Protocol (MCP)]** に移動します。 +3. **[+ Add]** をクリックし、**[As JSON]** を選択するか、フォーム フィールドを使用します。 4. 以下の構成を入力します。 ```json @@ -180,7 +184,7 @@ JetBrains AI Assistant は、IDE 設定を介して MCP サーバーをサポー } ``` -5. **\[OK]** をクリックし、AI Assistant を再起動します。 +5. **[OK]** をクリックし、AI Assistant を再起動します。 MCP サポートには、JetBrains IDE に AI Assistant プラグインがインストールされて有効になっている必要があります。 @@ -188,10 +192,11 @@ MCP サポートには、JetBrains IDE に AI Assistant プラグインがイン ### その他の MCP クライアント -その他の MCP 互換クライアントの場合は、次のコマンドと引数で STDIO トランスポートを使用します。 +その他の MCP 互換クライアントの場合は、次の起動コマンドで STDIO トランスポートを使用します。 -- **コマンド**: `npx` -- **引数**: `-y`、`igniteui-theming`、`igniteui-theming-mcp` +```bash +npx -y igniteui-theming igniteui-theming-mcp +``` ## プロジェクト ルールでの AI 動作のカスタマイズ @@ -272,6 +277,7 @@ MCP サーバーは、プロンプトに基づいて AI が自動的に使用す プロジェクトでライセンス版の `@infragistics/igniteui-angular` パッケージを使用している場合は、AI にそのことを伝えてください。そうすることで、パレット、テーマ、コンポーネント ツールで `licensed` パラメーターを設定できます。これにより、生成されるインポート パスがそれに応じて調整されます。 + ## シナリオ例 次のシナリオは、MCP サーバーが接続された後に AI に何を依頼できるかを示します。 @@ -282,6 +288,8 @@ MCP サーバーは、プロンプトに基づいて AI が自動的に使用す AI は `create_theme` を呼び出し、すぐに使用できる `styles.scss` ファイルを返します。生成される出力は次のようになります。 + + ```scss /* styles.scss */ @use 'igniteui-angular/theming' as *; @@ -302,6 +310,10 @@ $my-typography: typography( @include theme($my-palette, $schema: $light-material-schema); ``` + + + + ### ダーク モード バリアント > 「既存のテーマのダーク モード バージョンが必要です。同じプライマリ ブルーを維持しますが、ダーク サーフェス #121212 を使用して。」 @@ -338,6 +350,7 @@ AI がカラーの輝度について警告した場合、選択したカラー ライト テーマには明るいサーフェス (例: `#fafafa`) を使用してください。ダーク テーマには暗いサーフェス (例: `#121212`) を使用してください。不一致のサーフェス カラーは、AI に警告を発生させます。 + **生成された Sass がコンパイルされない** `igniteui-angular` と `igniteui-theming` がインストールされていることを確認してください。 @@ -346,23 +359,17 @@ AI がカラーの輝度について警告した場合、選択したカラー ng add igniteui-angular ``` -また、`styles.scss` で他のテーマ mixin の前に `core()` が呼び出されていることを確認してください。正しいファイルのセットアップについては、「[Sass を使用したテーマ設定]()」を参照してください。 +また、`styles.scss` で他のテーマ mixin の前に `core()` が呼び出されていることを確認してください。正しいファイルのセットアップについては、[Sass を使用したテーマ設定](https://www.infragistics.com/products/ignite-ui-angular/angular/components/themes/sass/index)を参照してください。 + ## その他のリソース + +- [Ignite UI を使った AI 支援開発](./ai-assisted-development-overview.md) - [Ignite UI for Angular スキル](./skills.md) -- [MAKER Framework](./maker-framework.md) - - -{/* Ideally these should be included once documentation is combined -- [Theming Overview](../themes/index.md) -- [Palettes](../themes/palettes.md) -- [Typography](../themes/typography.md) -- [Elevations](../themes/elevations.md) -- [Spacing](../themes/spacing.md) -- [Roundness](../themes/roundness.md) -- [Theming with Sass](../themes/sass/index.md) -*/} +- [Ignite UI CLI MCP](./cli-mcp.md) + +
コミュニティは常に活気があり、新しいアイデアを歓迎しています。 diff --git a/docs/angular/src/content/jp/components/avatar.mdx b/docs/angular/src/content/jp/components/avatar.mdx index 0e5d74b80d..219552d67a 100644 --- a/docs/angular/src/content/jp/components/avatar.mdx +++ b/docs/angular/src/content/jp/components/avatar.mdx @@ -128,7 +128,7 @@ igx-avatar { ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/bullet-graph.mdx b/docs/angular/src/content/jp/components/bullet-graph.mdx index ae9c1b59e4..fa5330e383 100644 --- a/docs/angular/src/content/jp/components/bullet-graph.mdx +++ b/docs/angular/src/content/jp/components/bullet-graph.mdx @@ -19,7 +19,7 @@ Angular Bullet Graph コンポーネントは、目盛り上でメジャーの ## Angular ブレット グラフの例 -以下のサンプルは、同じ `BulletGraph` でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 +以下のサンプルは、同じ でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 @@ -48,7 +48,7 @@ npm install --save igniteui-angular-gauges ## モジュールの要件 -`BulletGraph` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 @@ -157,7 +157,7 @@ export class AppModule {} ## ハイライト値 -バレット グラフのパフォーマンス値をさらに変更して、進捗状況をハイライト値として表示することもできます。これにより、`Value` が低い不透明度で表示されます。良い例としては、`Value` が 50 で、`HighlightValue` が 25 に設定されている場合です。これは、`TargetValue` の値が何に設定されているかに関係なく、50% のパフォーマンスを表します。これを有効にするには、まず `HighlightValueDisplayMode` を Overlay に設定し、次に `HighlightValue` を `Value` よりも低い値に適用します。 +バレット グラフのパフォーマンス値をさらに変更して、進捗状況をハイライト値として表示することもできます。これにより、 が低い不透明度で表示されます。良い例としては、 が 50 で、 が 25 に設定されている場合です。これは、 の値が何に設定されているかに関係なく、50% のパフォーマンスを表します。これを有効にするには、まず を Overlay に設定し、次に よりも低い値に適用します。 @@ -338,7 +338,7 @@ export class AppModule {} ## スケール -スケールはゲージで値の全範囲をハイライト表示する視覚的な要素です。外観やスケールの図形のカスタマイズ、更にスケールを反転 (`IsScaleInverted` プロパティを使用) させて、すべてのラベルを左から右ではなく、右から左へ描画することもできます。 +スケールはゲージで値の全範囲をハイライト表示する視覚的な要素です。外観やスケールの図形のカスタマイズ、更にスケールを反転 ( プロパティを使用) させて、すべてのラベルを左から右ではなく、右から左へ描画することもできます。 diff --git a/docs/angular/src/content/jp/components/button-group.mdx b/docs/angular/src/content/jp/components/button-group.mdx index dd074264eb..b375cdd49b 100644 --- a/docs/angular/src/content/jp/components/button-group.mdx +++ b/docs/angular/src/content/jp/components/button-group.mdx @@ -85,7 +85,7 @@ import { IgxIconComponent } from 'igniteui-angular/icon'; export class HomeComponent {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/button.mdx b/docs/angular/src/content/jp/components/button.mdx index 0fe50de532..2715ed5439 100644 --- a/docs/angular/src/content/jp/components/button.mdx +++ b/docs/angular/src/content/jp/components/button.mdx @@ -84,7 +84,7 @@ Ignite UI for Angular Button モジュールまたはディレクティブをイ ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/card.mdx b/docs/angular/src/content/jp/components/card.mdx index 7352606694..47061025f8 100644 --- a/docs/angular/src/content/jp/components/card.mdx +++ b/docs/angular/src/content/jp/components/card.mdx @@ -107,7 +107,7 @@ import { IGX_CARD_DIRECTIVES } from 'igniteui-angular/card'; export class HomeComponent {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/charts/chart-api.mdx b/docs/angular/src/content/jp/components/charts/chart-api.mdx index 432a1ec4bb..eb1043f802 100644 --- a/docs/angular/src/content/jp/components/charts/chart-api.mdx +++ b/docs/angular/src/content/jp/components/charts/chart-api.mdx @@ -11,85 +11,87 @@ _keywords: Angular charts, chart API, API, Ignite UI for Angular, Infragistics _license: commercial --- +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular チャート API -Ignite UI for Angular チャートは、`CategoryChart`、`FinancialChart`、`DataChart`、`DataPieChart`、`DoughnutChart`、`PieChart`、および `Sparkline` UI 要素でデータをプロットするためのシンプルで使いやすい API を提供します。 +Ignite UI for Angular チャートは、、および UI 要素でデータをプロットするためのシンプルで使いやすい API を提供します。 ## Angular カテゴリ チャート API -Angular `CategoryChart` には次の API メンバーがあります。 +Angular には次の API メンバーがあります。 | チャート プロパティ | 軸プロパティ | シリーズ プロパティ | |-------------------|--------------|-------------------| -| - `CategoryChart.ChartType`
- `ExcludedProperties`
- `IncludedProperties`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `CrosshairsDisplayMode`
- `TransitionInMode`
- `HighlightingBehavior`
- `HighlightingMode`
- `TrendLineType`
| - `XAxisInterval`
- `XAxisLabelLocation`
- `XAxisGap`
- `XAxisOverlap`
- `XAxisTitle`
- `YAxisInterval`
- `YAxisLabelLocation`
- `YAxisTitle`
- `YAxisMinimumValue`
- `YAxisMaximumValue` | - `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `MarkerTypes`
- `ToolTipType`




| +| - `CategoryChart.ChartType`
-
-
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-




| ## Angular ファイナンシャル チャート API -Angular `FinancialChart` には次の API メンバーがあります。 +Angular には次の API メンバーがあります。 | チャート プロパティ | 軸プロパティ | シリーズ プロパティ | |-------------------|-------------|--------------------| -| - `FinancialChart.ChartType`
- `ExcludedProperties`
- `IncludedProperties`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `ToolTipType`
- `CrosshairsDisplayMode`
- `HighlightingBehavior`
- `HighlightingMode`
- `TrendLineType` | - `XAxisInterval`
- `XAxisLabelLocation`
- `XAxisTitle`
- `YAxisInterval`
- `YAxisLabelLocation`
- `YAxisTitle`
- `YAxisMinimumValue`
- `YAxisMaximumValue`
- `YAxisMode`
- `XAxisMode` | - `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `MarkerTypes`
- `IndicatorTypes`
- `VolumeType`
- `ZoomSliderType`


| +| - `FinancialChart.ChartType`
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-


| ## Angular データ チャート API -Angular `DataChart` には次の API メンバーがあります。 +Angular には次の API メンバーがあります。 | チャート プロパティ | 軸クラス | |------------------|--------------| -| - `SeriesViewer.Title`
- `SeriesViewer.Subtitle`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `DataChart.Axes`
- `SeriesViewer.Series`
| - `Axis` はすべての軸タイプの基本クラスです
- [カテゴリ シリーズ](types/column-chart.md)、[積層型シリーズ](types/stacked-chart.md)、および[ファイナンシャル シリーズ](types/stock-chart.md)で使用される `CategoryXAxis`
- [カテゴリ シリーズ](types/column-chart.md)および[積層型シリーズ](types/stacked-chart.md)で使用される `CategoryYAxis`
- [ラジアル シリーズ](types/radial-chart.md)で使用される `CategoryAngleAxis`
- [散布シリーズ](types/scatter-chart.md)および[棒シリーズ](types/bar-chart.md)で使用される `NumericXAxis`
- [散布シリーズ](types/scatter-chart.md)、[カテゴリ シリーズ](types/column-chart.md)、[積層型シリーズ](types/stacked-chart.md)、および[ファイナンシャル シリーズ](types/stock-chart.md)で使用される `NumericYAxis`
- [極座標シリーズ](types/polar-chart.md)で使用される `NumericAngleAxis`
- [極座標シリーズ](types/polar-chart.md) および[ラジアル シリーズ](types/radial-chart.md)で使用される `NumericRadiusAxis`
- [カテゴリ シリーズ](types/column-chart.md)および[ファイナンシャル シリーズ](types/stock-chart.md)で使用される `TimeXAxis`

| +| - `SeriesViewer.Title`
- `SeriesViewer.Subtitle`
-
-
-
-
-
-
- `DataChart.Axes`
- `SeriesViewer.Series`
| - はすべての軸タイプの基本クラスです
- [カテゴリ シリーズ](types/column-chart.md)、[積層型シリーズ](types/stacked-chart.md)、および[ファイナンシャル シリーズ](types/stock-chart.md)で使用される
- [カテゴリ シリーズ](types/column-chart.md)および[積層型シリーズ](types/stacked-chart.md)で使用される
- [ラジアル シリーズ](types/radial-chart.md)で使用される
- [散布シリーズ](types/scatter-chart.md)および[棒シリーズ](types/bar-chart.md)で使用される
- [散布シリーズ](types/scatter-chart.md)、[カテゴリ シリーズ](types/column-chart.md)、[積層型シリーズ](types/stacked-chart.md)、および[ファイナンシャル シリーズ](types/stock-chart.md)で使用される
- [極座標シリーズ](types/polar-chart.md)で使用される
- [極座標シリーズ](types/polar-chart.md) および[ラジアル シリーズ](types/radial-chart.md)で使用される
- [カテゴリ シリーズ](types/column-chart.md)および[ファイナンシャル シリーズ](types/stock-chart.md)で使用される

| -Angular `DataChart` は、`Series` から継承する次のタイプのシリーズを使用できます。 +Angular は、 から継承する次のタイプのシリーズを使用できます。 | カテゴリ シリーズ | 積層シリーズ | |------------------|----------------| -| - `AreaSeries`
- `BarSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries`
| - `StackedAreaSeries`
- `StackedBarSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100BarSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`


| +| -
-
-
-
-
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
-
-


| | 散布シリーズ | ファイナンシャル シリーズ | |----------------|------------------| -| - `BubbleSeries`
- `HighDensityScatterSeries`
- `ScatterSeries`
- `ScatterLineSeries`
- `ScatterSplineSeries`
- `ScatterAreaSeries`
- `ScatterContourSeries`
- `ScatterPolylineSeries`
- `ScatterPolygonSeries`

| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`
- `WeightedCloseIndicator`
- おとび [その他](types/stock-chart.md) | +| -
-
-
-
-
-
-
-
-

| -
-
-
-
-
-
-
-
-
- おとび [その他](types/stock-chart.md) | | ラジアル シリーズ | 極座標シリーズ | |---------------|--------------| -| - `RadialLineSeries`
- `RadialAreaSeries`
- `RadialPieSeries`
- `RadialColumnSeries`

| - `PolarScatterSeries`
- `PolarLineSeries`
- `PolarAreaSeries`
- `PolarSplineSeries`
- `PolarSplineAreaSeries`
| +| -
-
-
-

| -
-
-
-
-
| ## Angular データ凡例の API -Angular `DataLegend` には次の API メンバーがあります: - -- `IncludedColumns` -- `ExcludedColumns` -- `IncludedSeries` -- `ExcludedSeries` -- `ValueFormatAbbreviation` -- `ValueFormatMode` -- `ValueFormatCulture` -- `ValueFormatMinFractions` -- `ValueFormatMaxFractions` -- `ValueTextColor` -- `TitleTextColor` -- `LabelTextColor` -- `UnitsTextColor` -- `SummaryType` -- `HeaderTextColor` -- `BadgeShape` +Angular には次の API メンバーがあります: + +- +- +- +- +- +- +- +- +- +- +- +- +- +- +- +- ## Angular ドーナツ チャート API -Angular `DoughnutChart` には、次の API メンバーがあります。 +Angular には、次の API メンバーがあります。 -- `AllowSliceExplosion` -- `AllowSliceSelection` -- `InnerExtent` +- +- +- ## Angular データ円チャート API -Angular `DataPieChart` には、次の API メンバーがあります。 +Angular には、次の API メンバーがあります。 - `DataPieChart.ChartType` - `DataPieChart.HighlightingBehavior` @@ -100,7 +102,7 @@ Angular `DataPieChart` には、次の API メンバーがあります。 ## Angular 円チャート API -Angular `PieChart` には、次の API メンバーがあります。 +Angular には、次の API メンバーがあります。 - `PieChart.LegendItemBadgeTemplate` - `PieChart.LegendItemTemplate` @@ -111,7 +113,7 @@ Angular `PieChart` には、次の API メンバーがあります。 ## Angular スパークライン チャート API -Angular `Sparkline` には、次の API メンバーがあります。 +Angular には、次の API メンバーがあります。 - `DisplayNormalRangeInFront` - `Sparkline.DisplayType` @@ -119,7 +121,7 @@ Angular `Sparkline` には、次の API メンバーがあります。 - `LowMarkerSize` - `LowMarkerVisibility` - `NormalRangeFill` -- `UnknownValuePlotting` +- ## その他のリソース diff --git a/docs/angular/src/content/jp/components/charts/features/chart-annotations.mdx b/docs/angular/src/content/jp/components/charts/features/chart-annotations.mdx index 62581052e2..8e730ebe44 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-annotations.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-annotations.mdx @@ -58,7 +58,7 @@ Angular チャートのホバー操作と注釈は、シリーズ コレクシ ## Angular 最終値レイヤー -`DataChart` コントロールの は、シリーズに表示された最終値の軸に沿ったクイック ビューをサポートします。 + コントロールの は、シリーズに表示された最終値の軸に沿ったクイック ビューをサポートします。 複数の最終値レイヤーを異なる設定で使用したい場合は、この注釈を設定して特定のシリーズをターゲットにすることができます。これには プロパティを設定します。 diff --git a/docs/angular/src/content/jp/components/charts/features/chart-axis-gridlines.mdx b/docs/angular/src/content/jp/components/charts/features/chart-axis-gridlines.mdx index 1a014457cf..4d0ac1cf28 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-axis-gridlines.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-axis-gridlines.mdx @@ -12,12 +12,14 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular 軸グリッド線 すべての Ignite UI for Angular チャートには、軸線の外観、X 軸と Y 軸に描画される主/副グリッド線および目盛りの頻度を変更するための組み込み機能が含まれています。 -次の例は、`CategoryChart` および `FinancialChart` コントロールに適用されます。 +次の例は、 および コントロールに適用されます。 軸の主グリッド線は、軸ラベルの位置から水平 (Y 軸) または垂直 (X 軸) に伸びる長い線であり、チャートのプロット領域を介して描画されます。軸の副グリッド線は、軸の主グリッド線の間に描画される線です。 @@ -39,20 +41,20 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; 軸間隔プロパティを設定すると、主グリッド線と軸ラベルが軸に描画される頻度を指定します。同様に、軸副間隔のプロパティは副グリッド線が軸に描画される頻度を指定します。 -副間隔に対応する副グリッド線を表示するには、軸に `XAxisMinorStroke` と `XAxisMinorStrokeThickness` プロパティを設定する必要があります。これは、副グリッド線にはデフォルトの色または太さがなく、最初に割り当てるまで表示されないためです。 +副間隔に対応する副グリッド線を表示するには、軸に プロパティを設定する必要があります。これは、副グリッド線にはデフォルトの色または太さがなく、最初に割り当てるまで表示されないためです。 以下のプロパティを設定して、Angular チャートでのグリッド線の表示をカスタマイズできます。 | 軸ビジュアル | タイプ | プロパティ名 | 説明 | | -----------------------|---------|--------------------------------------------------------------|---------------- | -| 主なストロークの色 | 文字列 | `XAxisMajorStroke`
`YAxisMajorStroke` | これらのプロパティは、軸の主グリッド線の色を設定します。 | -| 副ストロークの色 | 文字列 | `XAxisMinorStroke`
`YAxisMinorStroke` | これらのプロパティは、軸の副グリッド線の色を設定します。 | -| 主なストロークの太さ | 数 | `XAxisMajorStrokeThickness`
`YAxisMajorStrokeThickness` | これらのプロパティは、軸の主グリッド線の太さをピクセル単位で設定します。 | -| 副ストロークの太さ | 数 | `XAxisMinorStrokeThickness`
`YAxisMinorStrokeThickness` | これらのプロパティは、軸の副グリッド線の太さをピクセル単位で設定します。 | -| 主間隔 | 数 | `XAxisInterval`
`YAxisInterval` | これらのプロパティは、軸の主グリッド線とラベルの間隔を設定します。 | -| 副間隔 | 数 | `XAxisMinorInterval`
`YAxisMinorInterval` | これらのプロパティは、軸の副グリッド線の間隔を設定します (使用する場合)。 | -| 軸線のストローク色 | 文字列 | `XAxisStroke`
`YAxisStroke` | これらのプロパティは、軸線の色を設定します。 | -| 軸のストロークの太さ | 数 | `XAxisStrokeThickness`
`YAxisStrokeThickness` | これらのプロパティは、軸線のピクセル単位の太さを設定します。 | +| 主なストロークの色 | 文字列 |
| これらのプロパティは、軸の主グリッド線の色を設定します。 | +| 副ストロークの色 | 文字列 |
| これらのプロパティは、軸の副グリッド線の色を設定します。 | +| 主なストロークの太さ | 数 |
| これらのプロパティは、軸の主グリッド線の太さをピクセル単位で設定します。 | +| 副ストロークの太さ | 数 |
| これらのプロパティは、軸の副グリッド線の太さをピクセル単位で設定します。 | +| 主間隔 | 数 |
| これらのプロパティは、軸の主グリッド線とラベルの間隔を設定します。 | +| 副間隔 | 数 |
| これらのプロパティは、軸の副グリッド線の間隔を設定します (使用する場合)。 | +| 軸線のストローク色 | 文字列 |
| これらのプロパティは、軸線の色を設定します。 | +| 軸のストロークの太さ | 数 |
| これらのプロパティは、軸線のピクセル単位の太さを設定します。 | 上記のテーブルの主間隔と副間隔については、軸ラベルの主間隔も、この値によって設定され、間隔に関連付けられた軸のポイントにラベルが 1 つ表示されることに注意してください。副間隔グリッド線は常に主グリッド線の間に描画されるため、副間隔プロパティは常に主間隔プロパティの値よりもはるかに小さい値 (通常は 2〜5 倍小さい値) に設定する必要があります。 @@ -67,9 +69,9 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; -`DataChart` の軸には、それぞれ `MajorStrokeDashArray` プロパティと `MinorStrokeDashArray` プロパティを利用して、主グリッド線と副グリッド線にダッシュ配列を配置する機能もあります。対応する軸の `StrokeDashArray` プロパティを設定することで、実際の軸線も破線にすることができます。これらのプロパティは、対応するグリッド線のダッシュの長さを記述する数値の配列を受け取ります。 + の軸には、それぞれ プロパティと プロパティを利用して、主グリッド線と副グリッド線にダッシュ配列を配置する機能もあります。対応する軸の プロパティを設定することで、実際の軸線も破線にすることができます。これらのプロパティは、対応するグリッド線のダッシュの長さを記述する数値の配列を受け取ります。 -次の例は、上記のダッシュ配列プロパティが設定された `DataChart` を示しています。 +次の例は、上記のダッシュ配列プロパティが設定された を示しています。 @@ -78,9 +80,9 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; ## Angular 軸目盛りの例 -軸の目盛りは、`XAxisTickLength` と `YAxisTickLength` プロパティを 0 より大きい値に設定することで有効になります。これらのプロパティは、目盛りを形成する線セグメントの長さを指定します。 +軸の目盛りは、 プロパティを 0 より大きい値に設定することで有効になります。これらのプロパティは、目盛りを形成する線セグメントの長さを指定します。 -目盛りは常に軸線から伸び、ラベルの方向を指します。ラベルは、重ならないように目盛りの長さの値でオフセットされます。たとえば、`YAxisTickLength` プロパティが 5 に設定されている場合、軸ラベルはその量だけ左にシフトされます。 +目盛りは常に軸線から伸び、ラベルの方向を指します。ラベルは、重ならないように目盛りの長さの値でオフセットされます。たとえば、 プロパティが 5 に設定されている場合、軸ラベルはその量だけ左にシフトされます。 以下の例は、上記のプロパティを設定して目盛りをカスタマイズする方法を示します。 @@ -97,9 +99,9 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; | 軸ビジュアル | タイプ | プロパティ名 | 説明 | | -----------------------|---------|------------------------------------------------------------|------------------------- | -| 目盛りストロークの色 | 文字列 | `XAxisTickStroke`
`YAxisTickStroke` | これらのプロパティは、目盛りの色を設定します。 | -| 目盛りストロークの太さ | 数 | `XAxisTickStrokeThickness`
`YAxisTickStrokeThickness` | これらのプロパティは、軸の目盛りの太さを設定します。 | -| 目盛りストロークの長さ | 数 | `XAxisTickLength`
`YAxisTickLength` | これらのプロパティは、軸の目盛りの長さを設定します。 | +| 目盛りストロークの色 | 文字列 |
| これらのプロパティは、目盛りの色を設定します。 | +| 目盛りストロークの太さ | 数 |
| これらのプロパティは、軸の目盛りの太さを設定します。 | +| 目盛りストロークの長さ | 数 |
| これらのプロパティは、軸の目盛りの長さを設定します。 | ## その他のリソース @@ -113,25 +115,25 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; 以下は、上記のセクションで説明されている API メンバーのリストです。 -| `DataChart` | `CategoryChart` または `FinancialChart` | +| | または | | -------------------------------------------------- | ----------------------------------- | -| `Axes` -> `NumericXAxis` -> `Interval` | `XAxisInterval` (主間隔) | -| `Axes` -> `NumericYAxis` -> `Interval` | `YAxisInterval` (主間隔) | -| `Axes` -> `NumericXAxis` -> `MinorInterval` | `XAxisMinorInterval` | -| `Axes` -> `NumericYAxis` -> `MinorInterval` | `YAxisMinorInterval` | -| `Axes` -> `NumericXAxis` -> `MajorStroke` | `XAxisMajorStroke` | -| `Axes` -> `NumericYAxis` -> `MajorStroke` | `YAxisMajorStroke` | -| `Axes` -> `NumericXAxis` -> `MajorStrokeThickness` | `XAxisMajorStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `MajorStrokeThickness` | `YAxisMajorStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `MinorStrokeThickness` | `XAxisMinorStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `MinorStrokeThickness` | `YAxisMinorStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `StrokeThickness` | `XAxisStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `StrokeThickness` | `YAxisStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `Stroke` | `XAxisStroke` (軸線色) | -| `Axes` -> `NumericYAxis` -> `Stroke` | `YAxisStroke` (軸線色) | -| `Axes` -> `NumericXAxis` -> `TickLength` | `XAxisTickLength` | -| `Axes` -> `NumericYAxis` -> `TickLength` | `YAxisTickLength` | -| `Axes` -> `NumericXAxis` -> `TickStroke` | `XAxisTickStroke` | -| `Axes` -> `NumericYAxis` -> `TickStroke` | `YAxisTickStroke` | -| `Axes` -> `NumericXAxis` -> `Strip` | `XAxisStrip` (軸の主グリッド線の空間) | -| `Axes` -> `NumericYAxis` -> `Strip` | `YAxisStrip` (軸の主グリッド線の空間) | +| -> -> | (主間隔) | +| -> -> | (主間隔) | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | (軸線色) | +| -> -> | (軸線色) | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | (軸の主グリッド線の空間) | +| -> -> | (軸の主グリッド線の空間) | diff --git a/docs/angular/src/content/jp/components/charts/features/chart-axis-layouts.mdx b/docs/angular/src/content/jp/components/charts/features/chart-axis-layouts.mdx index ec9a01f478..b88961c816 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-axis-layouts.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-axis-layouts.mdx @@ -9,19 +9,21 @@ _language: ja import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro'; import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular 軸レイアウト すべての Ignite UI for Angular チャートには、位置などの多くの軸レイアウト オプションを構成するオプションが含まれているほか、シリーズ間で軸を共有したり、同じチャートに複数の軸を含めることができます。これらの機能は、以下の例で示されています。 -次の例は、`CategoryChart` および `FinancialChart` コントロールに適用されます。 +次の例は、 および コントロールに適用されます。 ## 軸位置の例 -すべての軸に対して、チャートのプロット領域に関連して軸の位置を指定できます。Angular チャートの `XAxisLabelLocation` プロパティを使用すると、x 軸の線とそのラベルをプロット領域の上または下に配置できます。同様に、`YAxisLabelLocation` プロパティを使用して、プロット領域の左側または右側に y 軸を配置できます。 +すべての軸に対して、チャートのプロット領域に関連して軸の位置を指定できます。Angular チャートの プロパティを使用すると、x 軸の線とそのラベルをプロット領域の上または下に配置できます。同様に、 プロパティを使用して、プロット領域の左側または右側に y 軸を配置できます。 -以下の例は、2009 年以降に生成された再生可能電力量を[折れ線チャート](../types/line-chart.md)で示しています。チャートのプロット領域の内側または外側の左側または右側にラベルを配置したときに軸がどのように見えるかを視覚化できるように、`YAxisLabelLocation` を構成できるドロップダウンがあります。 +以下の例は、2009 年以降に生成された再生可能電力量を[折れ線チャート](../types/line-chart.md)で示しています。チャートのプロット領域の内側または外側の左側または右側にラベルを配置したときに軸がどのように見えるかを視覚化できるように、 を構成できるドロップダウンがあります。 @@ -29,11 +31,11 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; ## 軸の高度なシナリオ -より高度な軸レイアウト シナリオでは、Angular データ チャートを使用して軸を共有したり、同じプロット領域に複数の y 軸や x 軸を追加したり、特定の値で軸を交差させたりすることができます。次の例は、`DataChart` のこれらの機能の使用方法を示しています。 +より高度な軸レイアウト シナリオでは、Angular データ チャートを使用して軸を共有したり、同じプロット領域に複数の y 軸や x 軸を追加したり、特定の値で軸を交差させたりすることができます。次の例は、 のこれらの機能の使用方法を示しています。 ### 軸共有の例 -Angular `DataChart` の同じプロット領域に複数の軸を共有して追加できます。`TimeXAxis` を共有し、複数の `NumericYAxis` を追加して、さまざまな値 (株価や株取引量など) を持つ多くのデータ ソースをプロットするのが一般的なシナリオです。 +Angular の同じプロット領域に複数の軸を共有して追加できます。 を共有し、複数の を追加して、さまざまな値 (株価や株取引量など) を持つ多くのデータ ソースをプロットするのが一般的なシナリオです。 以下の例は、[株価チャート](../types/stock-chart.md)と[縦棒チャート](../types/column-chart.md)をプロットした株価および株取引量チャートを示しています。この場合、左側の Y 軸は[縦棒チャート](../types/column-chart.md)で使用され、右側の Y 軸は[株価チャート](../types/stock-chart.md)、X 軸は 2 つの間で共有されます。 @@ -43,7 +45,7 @@ Angular `DataChart` の同じプロット領域に複数の軸を共有して追 ### 軸交差の例 -軸をプロット領域の外側に配置することに加えて、Angular `DataChart` は、軸をプロット領域の内側に配置し、特定の値で交差させるオプションも提供します。たとえば、x 軸と y 軸の両方で `CrossingAxis` プロパティと `CrossingValue` プロパティを設定して、原点が (0、0) で 交差するように軸線と軸ラベルを描画することにより、三角関数チャートを作成できます。 +軸をプロット領域の外側に配置することに加えて、Angular は、軸をプロット領域の内側に配置し、特定の値で交差させるオプションも提供します。たとえば、x 軸と y 軸の両方で プロパティと プロパティを設定して、原点が (0、0) で 交差するように軸線と軸ラベルを描画することにより、三角関数チャートを作成できます。 以下の例は、[散布スプライン チャート](../types/scatter-chart.md)で表される Sin と Cos 波を示します。X 軸と Y 軸は (0、0) 原点で交差します。 @@ -64,18 +66,18 @@ Angular `DataChart` の同じプロット領域に複数の軸を共有して追 以下は、上記のセクションで説明した API メンバーのリストです。 -| `DataChart` | `CategoryChart` | +| | | | ------------------------------------------------------ | ------------------------------- | -| `Axes` -> `NumericYAxis` -> `CrossingAxis` | なし | -| `Axes` -> `NumericYAxis` -> `CrossingValue` | なし | -| `Axes` -> `NumericXAxis` -> `IsInverted` | `XAxisInverted` | -| `Axes` -> `NumericYAxis` -> `IsInverted` | `YAxisInverted` | -| `Axes` -> `NumericYAxis` -> `LabelLocation` | `YAxisLabelLocation` | -| `Axes` -> `NumericXAxis` -> `LabelLocation` | `XAxisLabelLocation` | -| `Axes` -> `NumericYAxis` -> `LabelHorizontalAlignment` | `YAxisLabelHorizontalAlignment` | -| `Axes` -> `NumericXAxis` -> `LabelVerticalAlignment` | `XAxisLabelVerticalAlignment` | -| `Axes` -> `NumericYAxis` -> `LabelVisibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `LabelVisibility` | `XAxisLabelVisibility` | +| -> -> | なし | +| -> -> | なし | +| -> -> | | +| -> -> | | +| -> -> `LabelLocation` | | +| -> -> `LabelLocation` | | +| -> -> `LabelHorizontalAlignment` | | +| -> -> `LabelVerticalAlignment` | | +| -> -> `LabelVisibility` | | +| -> -> `LabelVisibility` | | diff --git a/docs/angular/src/content/jp/components/charts/features/chart-axis-options.mdx b/docs/angular/src/content/jp/components/charts/features/chart-axis-options.mdx index c6b97d2746..e4489e9214 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-axis-options.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-axis-options.mdx @@ -78,9 +78,9 @@ Angular チャートは、チャートで表示されるラベルの構成、書 および コントロールでは、 プロパティが true に設定されている場合はデータを Y 軸に沿って対数スケールでプロットするか、このプロパティが false (デフォルト価値) に設定されている場合は線形スケールでプロットするかを選択できます。 -`YAxisLogarithmBase` プロパティを使用すると、対数スケールのベースをデフォルト値の 10 から他の整数値に変更できます。 とコントロールを使用すると、`Numeric` モードと `PercentChange` モードを提供する プロパティを使用して、Y 軸に沿ってデータをどのように表現するかを選択できます。`Numeric` モードは正確な値でデータをプロットし、`PercentChange` モードは提供された最初のデータ ポイントに対する変化率としてデータを表示します。デフォルト値は `Numeric` モードです。 + プロパティを使用すると、対数スケールのベースをデフォルト値の 10 から他の整数値に変更できます。 とコントロールを使用すると、 モードと モードを提供する プロパティを使用して、Y 軸に沿ってデータをどのように表現するかを選択できます。 モードは正確な値でデータをプロットし、 モードは提供された最初のデータ ポイントに対する変化率としてデータを表示します。デフォルト値は モードです。 - プロパティに加えて、 コントロールには X 軸に `Time` モードと `Ordinal` モードを提供する プロパティがあります。`Time` モードはデータのギャップを X 軸にスペースを用いて描画します。つまり、週末または休日に株取引がないことを示します。`Ordinal` モードはデータがない日付領域を縮小します。デフォルト値は `Ordinal` モードです。 + プロパティに加えて、 コントロールには X 軸に モードと モードを提供する プロパティがあります。 モードはデータのギャップを X 軸にスペースを用いて描画します。つまり、週末または休日に株取引がないことを示します。 モードはデータがない日付領域を縮小します。デフォルト値は モードです。 @@ -130,20 +130,20 @@ Angular チャートの | | | | ------------------------------------------------------ | ---------------------- | ---------------------- | -| `Axes` -> `NumericYAxis` -> `MaximumValue` | `YAxisMaximumValue` | `YAxisMaximumValue` | -| `Axes` -> `NumericYAxis` -> `MinimumValue` | `YAxisMinimumValue` | `YAxisMinimumValue` | -| `Axes` -> `NumericYAxis` -> `IsLogarithmic` | `YAxisIsLogarithmic` | `YAxisIsLogarithmic` | -| `Axes` -> `NumericYAxis` -> `LogarithmBase` | `YAxisLogarithmBase` | `YAxisLogarithmBase` | -| `Axes` -> `CategoryXAxis` -> `Gap` | なし | `XAxisGap` | -| `Axes` -> `CategoryXAxis` -> `Overlap` | なし | `XAxisOverlap` | -| `Axes` -> `TimeXAxis` | `XAxisMode` | なし | -| `Axes` -> `PercentChangeYAxis` | `YAxisMode` | なし | -| `Axes` -> `NumericYAxis` -> `labelSettings.angle` | `YAxisLabelAngle` | `YAxisLabelAngle` | -| `Axes` -> `NumericXAxis` -> `labelSettings.angle` | `XAxisLabelAngle` | `XAxisLabelAngle` | -| `Axes` -> `NumericYAxis` -> `labelSettings.textColor` | `YAxisLabelForeground` | `YAxisLabelForeground` | -| `Axes` -> `NumericXAxis` -> `labelSettings.textColor` | `XAxisLabelForeground` | `XAxisLabelForeground` | -| `Axes` -> `NumericYAxis` -> `labelSettings.visibility` | `YAxisLabelVisibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `labelSettings.visibility` | `XAxisLabelVisibility` | `XAxisLabelVisibility` | +| -> -> | | | +| -> -> | | | +| -> -> | | | +| -> -> | | | +| -> -> | なし | | +| -> -> | なし | | +| -> | | なし | +| -> | | なし | +| -> -> `labelSettings.angle` | | | +| -> -> `labelSettings.angle` | | | +| -> -> `labelSettings.textColor` | `YAxisLabelForeground` | `YAxisLabelForeground` | +| -> -> `labelSettings.textColor` | `XAxisLabelForeground` | `XAxisLabelForeground` | +| -> -> `labelSettings.visibility` | | | +| -> -> `labelSettings.visibility` | | | diff --git a/docs/angular/src/content/jp/components/charts/features/chart-axis-types.mdx b/docs/angular/src/content/jp/components/charts/features/chart-axis-types.mdx index 993da8a334..994e79bfeb 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-axis-types.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-axis-types.mdx @@ -11,24 +11,26 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular 軸タイプ -Ignite UI for Angular カテゴリ チャートは、`CategoryXAxis` および `NumericYAxis` タイプを 1 つだけ使用します。同様に、Ignite UI for Angular ファイナンシャル チャートは、`TimeXAxis` タイプと `NumericYAxis` タイプを 1 つだけ使用します。ただし、Ignite UI for Angular データ チャートは複数の軸タイプをサポートしており、[軸の位置](chart-axis-layouts.md#軸位置の例)を設定してチャートの任意の側に配置したり、[軸交差](chart-axis-layouts.md#軸交差の例)プロパティを使用してチャートの内部に配置したりできます。このトピックでは、相互に互換性のある軸とシリーズ、および固有の軸に対するいくつかの特定のプロパティについて、それぞれについて説明します。 +Ignite UI for Angular カテゴリ チャートは、 および タイプを 1 つだけ使用します。同様に、Ignite UI for Angular ファイナンシャル チャートは、 タイプと タイプを 1 つだけ使用します。ただし、Ignite UI for Angular データ チャートは複数の軸タイプをサポートしており、[軸の位置](chart-axis-layouts.md#軸位置の例)を設定してチャートの任意の側に配置したり、[軸交差](chart-axis-layouts.md#軸交差の例)プロパティを使用してチャートの内部に配置したりできます。このトピックでは、相互に互換性のある軸とシリーズ、および固有の軸に対するいくつかの特定のプロパティについて、それぞれについて説明します。 ## デカルト軸 -デカルト軸を持つ `DataChart` では 3 つのタイプの X 軸を使用して水平 (X 軸) および垂直 (X 軸) 方向にデータをプロットすることが可能です。 -(`CategoryXAxis`、`NumericXAxis`、および `TimeXAxis`) と 2 つのタイプの Y 軸 (`CategoryYAxis` および `NumericYAxis`)。 +デカルト軸を持つ では 3 つのタイプの X 軸を使用して水平 (X 軸) および垂直 (X 軸) 方向にデータをプロットすることが可能です。 +(、および ) と 2 つのタイプの Y 軸 ( および )。 ### カテゴリ X 軸 -`CategoryXAxis` は、そのデータを一連のカテゴリ データ項目として扱います。文字列や数値など、ほぼすべてのタイプのデータを表示できます。この軸に数値をプロットする場合、この軸は離散軸であり、連続ではないことに注意してください。これは、各カテゴリ データ項目がその前のデータ項目から等距離に配置されることを意味します。また、項目は軸のデータ ソースに表示される順序でプロットされます。 + は、そのデータを一連のカテゴリ データ項目として扱います。文字列や数値など、ほぼすべてのタイプのデータを表示できます。この軸に数値をプロットする場合、この軸は離散軸であり、連続ではないことに注意してください。これは、各カテゴリ データ項目がその前のデータ項目から等距離に配置されることを意味します。また、項目は軸のデータ ソースに表示される順序でプロットされます。 -`CategoryXAxis` では、データをプロットするために `DataSource` と `Label` を提供する必要があります。通常、次のタイプの系列をプロットするために `NumericYAxis` と共に使用されます。 + では、データをプロットするために `DataSource` と を提供する必要があります。通常、次のタイプの系列をプロットするために と共に使用されます。 | カテゴリ シリーズ | 積層型シリーズ | ファイナンシャル シリーズ | |------------------|----------------|--------------------| -| - `AreaSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries` | - `StackedAreaSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`



| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`



| +| -
-
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-



| -
-
-
-
-
-
-
-



| 次の例は、上記のスタイル設定プロパティの使用法を示しています: @@ -37,124 +39,124 @@ Ignite UI for Angular カテゴリ チャートは、`CategoryXAxis` および ` ### カテゴリ Y 軸 -`CategoryYAxis` は、上記の `CategoryXAxis` と非常によく似た働きをしますが、水平ではなく垂直に配置されます。また、この軸では、データをプロットするために `DataSource` と `Label` を提供する必要があります。`CategoryYAxis` は通常 `NumericXAxis` と組み合わせて次のタイプのシリーズをプロットするために使用されます。 + は、上記の と非常によく似た働きをしますが、水平ではなく垂直に配置されます。また、この軸では、データをプロットするために `DataSource` と を提供する必要があります。 は通常 と組み合わせて次のタイプのシリーズをプロットするために使用されます。 -- `BarSeries` -- `StackedBarSeries` -- `Stacked100BarSeries` +- +- +- - 次の例は、`CategoryYAxis` タイプの使用法を示しています: + 次の例は、 タイプの使用法を示しています: ### 数値 X 軸 -`NumericXAxis` は、そのデータを連続的に変化する数値データ項目として扱います。この軸のラベルは、X 軸に沿って水平に配置されます。`NumericXAxis` ラベルの位置は、`NumericYAxis` と組み合わせた場合にサポートされるさまざまな [ScatterSeries](../types/scatter-chart.md) (散布シリーズ) の `XMemberPath` プロパティに依存します。または、`CategoryXAxis` と組み合わせた場合、これらのラベルは、`BarSeries`、`StackedBarSeries`、および `Stacked100BarSeries` の `ValueMemberPath` に対応して配置されます。 + は、そのデータを連続的に変化する数値データ項目として扱います。この軸のラベルは、X 軸に沿って水平に配置されます。 ラベルの位置は、 と組み合わせた場合にサポートされるさまざまな [ScatterSeries](../types/scatter-chart.md) (散布シリーズ) の プロパティに依存します。または、 と組み合わせた場合、これらのラベルは、、および に対応して配置されます。 -`NumericXAxis` は、次のタイプのシリーズと互換性があります: + は、次のタイプのシリーズと互換性があります: -- `BarSeries` -- `BubbleSeries` -- `HighDensityScatterSeries` -- `ScatterSeries` -- `ScatterLineSeries` -- `ScatterSplineSeries` -- `ScatterAreaSeries` -- `ScatterContourSeries` -- `ScatterPolylineSeries` -- `ScatterPolygonSeries` -- `StackedBarSeries` -- `Stacked100BarSeries` +- +- +- +- +- +- +- +- +- +- +- +- - 次の例は、`NumericXAxis` の使用法を示しています: + 次の例は、 の使用法を示しています: ### 数値 Y 軸 -`NumericYAxis` は、そのデータを連続的に変化する数値データ項目として扱います。この軸のラベルは、Y 軸に沿って垂直に配置されます。`NumericYAxis` ラベルの位置は、`NumericXAxis` と組み合わせた場合にサポートされるさまざまな [ScatterSeries](../types/scatter-chart.md) (散布シリーズ) の `YMemberPath` プロパティに依存します。または、`CategoryYAxis` と組み合わせた場合、これらのラベルは、上記の表に記載されているカテゴリまたは積層シリーズの `ValueMemberPath` に対応して配置されます。財務シリーズのいずれかを使用している場合、Open/High/Low/Close のパスと使用しているシリーズ タイプに対応して配置されます。 + は、そのデータを連続的に変化する数値データ項目として扱います。この軸のラベルは、Y 軸に沿って垂直に配置されます。 ラベルの位置は、 と組み合わせた場合にサポートされるさまざまな [ScatterSeries](../types/scatter-chart.md) (散布シリーズ) の プロパティに依存します。または、 と組み合わせた場合、これらのラベルは、上記の表に記載されているカテゴリまたは積層シリーズの に対応して配置されます。財務シリーズのいずれかを使用している場合、Open/High/Low/Close のパスと使用しているシリーズ タイプに対応して配置されます。 -`NumericYAxis` は、次のタイプのシリーズと互換性があります: + は、次のタイプのシリーズと互換性があります: | カテゴリ シリーズ | 積層型シリーズ | ファイナンシャル シリーズ | 散布シリーズ | |------------------|----------------|------------------|----------------| -| - `AreaSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries`
| - `StackedAreaSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`
| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`
| - `BubbleSeries`
- `HighDensityScatterSeries`
- `ScatterSeries`
- `ScatterLineSeries`
- `ScatterSplineSeries`
- `ScatterAreaSeries`
- `ScatterContourSeries`
- `ScatterPolylineSeries`
- `ScatterPolygonSeries`
| +| -
-
-
-
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
-
| - 次の例は、`NumericYAxis` の使用法を示しています: + 次の例は、 の使用法を示しています: ### 時間 X 軸 -`TimeXAxis` は、そのデータを、日付でソートされた一連のデータ項目として扱います。この軸タイプのラベルは日付であり、日付間隔に従ってフォーマットおよび配置できます。この軸の日付範囲は、`DateTimeMemberPath` を使用してマップされたデータ列の日付値によって決定されます。これは、`DataSource` とともに、この軸タイプでデータをプロットするために必要です。 + は、そのデータを、日付でソートされた一連のデータ項目として扱います。この軸タイプのラベルは日付であり、日付間隔に従ってフォーマットおよび配置できます。この軸の日付範囲は、 を使用してマップされたデータ列の日付値によって決定されます。これは、`DataSource` とともに、この軸タイプでデータをプロットするために必要です。 -`TimeXAxis` は、`FinancialChart` コンポーネントの X 軸タイプです。 + は、 コンポーネントの X 軸タイプです。 #### 時間 X 軸のブレーク -`TimeXAxis` には、`Breaks` (ブレーク) を使用してデータの間隔を除外するオプションがあります。その結果、ラベルとプロットされたデータは除外された間隔では表示されません。たとえば、勤務日/休業日、休日、週末などです。`TimeAxisBreak` のインスタンスを軸の `Breaks` コレクションに追加し、一意の `Start`、`End`、および `Interval` を使用して構成できます。 + には、 (ブレーク) を使用してデータの間隔を除外するオプションがあります。その結果、ラベルとプロットされたデータは除外された間隔では表示されません。たとえば、勤務日/休業日、休日、週末などです。 のインスタンスを軸の コレクションに追加し、一意の 、および を使用して構成できます。 #### 時間 X 軸の書式設定 -`TimeXAxis` には、`TimeAxisLabelFormat` オブジェクトのコレクションを表す `LabelFormats` プロパティがあります。コレクションに追加された各 `TimeAxisLabelFormat` は、一意の `Format` (書式) と `Range` (範囲) を割り当てる役割を果たします。これは、データを年からミリ秒にドリルダウンし、チャートに表示される時間の範囲に応じてラベルを調整する場合に特に役立ちます。 + には、 オブジェクトのコレクションを表す プロパティがあります。コレクションに追加された各 は、一意の (書式) と (範囲) を割り当てる役割を果たします。これは、データを年からミリ秒にドリルダウンし、チャートに表示される時間の範囲に応じてラベルを調整する場合に特に役立ちます。 -`TimeAxisLabelFormat` の `Format` プロパティは、特定の表示範囲に使用する形式を指定します。`TimeAxisLabelFormat` の `Range` プロパティは、軸ラベルの形式が別の形式に切り替わる表示範囲を指定します。たとえば、範囲が 10 日と 5 時間に設定された 2 つの `TimeAxisLabelFormat` 要素がある場合、軸の表示範囲が 10 日未満になるとすぐに、5 時間形式に切り替わります。 + プロパティは、特定の表示範囲に使用する形式を指定します。 プロパティは、軸ラベルの形式が別の形式に切り替わる表示範囲を指定します。たとえば、範囲が 10 日と 5 時間に設定された 2 つの 要素がある場合、軸の表示範囲が 10 日未満になるとすぐに、5 時間形式に切り替わります。 #### 時間 X 軸の間隔 -`TimeXAxis` は、カテゴリ軸と数値軸の従来の `Interval` プロパティを `TimeAxisInterval` 型の `Intervals` コレクションに置き換えます。コレクションに追加された各 `TimeAxisInterval` は、一意の `Interval`、`Range`、および `IntervalType` を割り当てる役割を果たします。これは、データを年単位からミリ秒単位にドリルダウンして、チャートに表示される時間の範囲に応じてラベル間に一意の間隔を設ける場合に特に役立ちます。これらのプロパティの説明は次のとおりです。 + は、カテゴリ軸と数値軸の従来の プロパティを 型の コレクションに置き換えます。コレクションに追加された各 は、一意の 、および を割り当てる役割を果たします。これは、データを年単位からミリ秒単位にドリルダウンして、チャートに表示される時間の範囲に応じてラベル間に一意の間隔を設ける場合に特に役立ちます。これらのプロパティの説明は次のとおりです。 -- `Interval`: 使用する間隔を指定します。`IntervalType` プロパティに関連付けられています。たとえば、`IntervalType` が `Days` に設定されている場合、`Interval` で指定される数値は日数になります。 -- `Range`: 軸間隔が別の間隔に切り替わる可視範囲を指定します。たとえば、範囲が 10 日間および 5 時間に設定された 2 つの TimeAxisInterval がある場合、軸の表示範囲が 10 日間より短くなる際に 5 時間範囲の間隔に変更します。 -- `IntervalType`: `Interval` プロパティの時間単位を指定します。 +- : 使用する間隔を指定します。 プロパティに関連付けられています。たとえば、 が `Days` に設定されている場合、 で指定される数値は日数になります。 +- : 軸間隔が別の間隔に切り替わる可視範囲を指定します。たとえば、範囲が 10 日間および 5 時間に設定された 2 つの TimeAxisInterval がある場合、軸の表示範囲が 10 日間より短くなる際に 5 時間範囲の間隔に変更します。 +- : プロパティの時間単位を指定します。 ## 極座標軸 -極座標軸を持つ `DataChart` により、チャートの中心から外側 (半径軸) およびチャートの中心の周り (角度軸) にデータをプロットできます。 +極座標軸を持つ により、チャートの中心から外側 (半径軸) およびチャートの中心の周り (角度軸) にデータをプロットできます。 ### カテゴリ角度軸 -`CategoryAngleAxis` は、そのデータを一連のカテゴリ データ項目として扱います。この軸のラベルは、その順序での位置に従って円の端に沿って配置されます。この軸のタイプでは、数字、文字列などのほぼすべてのデータのタイプを表示できます。 + は、そのデータを一連のカテゴリ データ項目として扱います。この軸のラベルは、その順序での位置に従って円の端に沿って配置されます。この軸のタイプでは、数字、文字列などのほぼすべてのデータのタイプを表示できます。 -`CategoryAngleAxis` は通常、[ラジアル シリーズ](../types/radial-chart.md)をプロットするために `NumericRadiusAxis` と共に使用されます。 + は通常、[ラジアル シリーズ](../types/radial-chart.md)をプロットするために と共に使用されます。 -次の例は、`CategoryAngleAxis` タイプの使用法を示しています: +次の例は、 タイプの使用法を示しています: ### 比例カテゴリ角度軸 -`ProportionalCategoryAngleAxis` は、そのデータを一連のカテゴリ データ項目として扱います。この軸のラベルは、シーケンス内の位置に応じて円の端に沿って配置されます。この軸の種類では、数字、文字列などのほぼすべてのデータのタイプを表示できます。 + は、そのデータを一連のカテゴリ データ項目として扱います。この軸のラベルは、シーケンス内の位置に応じて円の端に沿って配置されます。この軸の種類では、数字、文字列などのほぼすべてのデータのタイプを表示できます。 -`ProportionalCategoryAngleAxis` は通常、`NumericRadiusAxis` と一緒に使用され、円チャートをプロットします (例: [ラジアル シリーズ](../types/radial-chart.md))。 + は通常、 と一緒に使用され、円チャートをプロットします (例: [ラジアル シリーズ](../types/radial-chart.md))。 -次の例は、`ProportionalCategoryAngleAxis` タイプの使用方法を示しています。 +次の例は、 タイプの使用方法を示しています。 ### 数字角度軸 -`NumericAngleAxis` は、そのデータを連続的に変化する数値データ項目として扱います。この軸領域のラベルは、円形プロットの中心から始まる半径線に沿って配置されます。`NumericAngleAxis` のラベルの位置は、[極座標シリーズ](../types/polar-chart.md) オブジェクトの `RadiusMemberPath` プロパティまたは[ラジアル シリーズ](../types/radial-chart.md) オブジェクトの `ValueMemberPath` プロパティを使用してマップされたデータ列の値によって異なります。 + は、そのデータを連続的に変化する数値データ項目として扱います。この軸領域のラベルは、円形プロットの中心から始まる半径線に沿って配置されます。 のラベルの位置は、[極座標シリーズ](../types/polar-chart.md) オブジェクトの プロパティまたは[ラジアル シリーズ](../types/radial-chart.md) オブジェクトの プロパティを使用してマップされたデータ列の値によって異なります。 -`NumericAngleAxis` は、`CategoryAngleAxis` と共に使用して[ラジアル シリーズ](../types/radial-chart.md)をプロットするか、`NumericRadiusAxis` と共に使用して[極座標シリーズ](../types/polar-chart.md)をプロットすることができます。 + は、 と共に使用して[ラジアル シリーズ](../types/radial-chart.md)をプロットするか、 と共に使用して[極座標シリーズ](../types/polar-chart.md)をプロットすることができます。 -次の例は、`NumericAngleAxis` タイプの使用法を示しています: +次の例は、 タイプの使用法を示しています: ### 数字半径軸 -`NumericRadiusAxis` は、データを連続的に変化する数値データ項目として扱います。この軸のラベルは、円形プロットの周りに配置されます。ラベルの位置は、対応する極座標シリーズの `AngleMemberPath` プロパティを使用してマップされたデータ列の値によって異なります。 + は、データを連続的に変化する数値データ項目として扱います。この軸のラベルは、円形プロットの周りに配置されます。ラベルの位置は、対応する極座標シリーズの `AngleMemberPath` プロパティを使用してマップされたデータ列の値によって異なります。 -`NumericRadiusAxis` を `NumericRadiusAxis` と共に使用して、[極座標シリーズ](../types/polar-chart.md)をプロットできます。 + と共に使用して、[極座標シリーズ](../types/polar-chart.md)をプロットできます。 -次の例は、`NumericRadiusAxis` タイプの使用法を示しています: +次の例は、 タイプの使用法を示しています: diff --git a/docs/angular/src/content/jp/components/charts/features/chart-data-annotations.mdx b/docs/angular/src/content/jp/components/charts/features/chart-data-annotations.mdx index 38e65711e8..1d376ea48b 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-data-annotations.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-data-annotations.mdx @@ -13,6 +13,8 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular チャート データの注釈 Angular チャートでは、データ注釈レイヤーを使用して、データ チャートにプロットされたデータに、傾斜線、垂直/水平線 (軸スライス)、垂直/水平ストリップ (特定の軸をターゲットとする)、四角形、さらには平行四辺形 (バンド) で注釈を付けることができます。データ バインディングがサポートされているため、チャートをカスタマイズするために必要な数の注釈を作成できます。また、さまざまな注釈レイヤーを組み合わせて、プロット領域内にテキストをオーバーレイし、データ内の重要なイベント、パターン、領域に注釈を付けることもできます。 @@ -30,7 +32,7 @@ Angular チャートでは、データ注釈レイヤーを使用して、デー ## Angular データ注釈スライス レイヤーの例 -Angular では、DataAnnotationSliceLayer は、`DataChart` コンポーネントの軸の複数の値でチャートをスライスする複数の垂直線または水平線を描画します。このデータ注釈レイヤーは、X 軸上の重要なイベント (例: 企業の四半期決算) または Y 軸上の重要な値に注釈を付けるためによく使用されます。TargetAxis プロパティを y 軸に設定すると、データ注釈レイヤーは水平スライスとして描画され、TargetAxis プロパティを x 軸に設定すると、データ注釈レイヤーは垂直スライスとして描画されます。すべてのシリーズと同様に、DataAnnotationSliceLayer も `DataSource` プロパティを介したデータ バインディングをサポートします。このプロパティは、`AnnotationValueMemberPath` プロパティにマッピングされた少なくとも 1 つの数値データ列を持つデータ項目のコレクションに設定できます。 +Angular では、DataAnnotationSliceLayer は、 コンポーネントの軸の複数の値でチャートをスライスする複数の垂直線または水平線を描画します。このデータ注釈レイヤーは、X 軸上の重要なイベント (例: 企業の四半期決算) または Y 軸上の重要な値に注釈を付けるためによく使用されます。TargetAxis プロパティを y 軸に設定すると、データ注釈レイヤーは水平スライスとして描画され、TargetAxis プロパティを x 軸に設定すると、データ注釈レイヤーは垂直スライスとして描画されます。すべてのシリーズと同様に、DataAnnotationSliceLayer も `DataSource` プロパティを介したデータ バインディングをサポートします。このプロパティは、`AnnotationValueMemberPath` プロパティにマッピングされた少なくとも 1 つの数値データ列を持つデータ項目のコレクションに設定できます。 たとえば、DataAnnotationSliceLayer を使用して、株式分割や収益報告の結果などの重要なイベントを株価に注釈として付けることができます。 @@ -41,9 +43,9 @@ Angular では、DataAnnotationSliceLayer は、`DataChart` コンポーネン ## Angular データ注釈ストリップ レイヤーの例 -Angular では、`DataAnnotationStripLayer` は、`DataChart` コンポーネントの軸上の 2 つの値の間に複数の垂直または水平のストリップを描画します。このデータ注釈レイヤーを使用して、X 軸にイベントの期間 (株式市場の暴落など) または Y 軸に重要な範囲の値に注釈を付けることができます。TargetAxis プロパティを y 軸に設定すると、データ注釈レイヤーは水平ストリップとして描画され、TargetAxis プロパティを x 軸に設定すると、データ注釈レイヤーは垂直ストリップとして描画されます。すべてのシリーズと同様に、`DataAnnotationStripLayer` も `DataSource` プロパティを介したデータ バインディングをサポートします。このプロパティは、AnnotationValueMemberPath プロパティにマッピングされた少なくとも 1 つの数値データ列を持つデータ項目のコレクションに設定できます。 +Angular では、 は、 コンポーネントの軸上の 2 つの値の間に複数の垂直または水平のストリップを描画します。このデータ注釈レイヤーを使用して、X 軸にイベントの期間 (株式市場の暴落など) または Y 軸に重要な範囲の値に注釈を付けることができます。TargetAxis プロパティを y 軸に設定すると、データ注釈レイヤーは水平ストリップとして描画され、TargetAxis プロパティを x 軸に設定すると、データ注釈レイヤーは垂直ストリップとして描画されます。すべてのシリーズと同様に、 も `DataSource` プロパティを介したデータ バインディングをサポートします。このプロパティは、AnnotationValueMemberPath プロパティにマッピングされた少なくとも 1 つの数値データ列を持つデータ項目のコレクションに設定できます。 -たとえば、`DataAnnotationStripLayer` を使用して、株式市場の暴落や連邦金利の変更をチャートに注釈として付けることができます。 +たとえば、 を使用して、株式市場の暴落や連邦金利の変更をチャートに注釈として付けることができます。 @@ -52,7 +54,7 @@ Angular では、`DataAnnotationStripLayer` は、`DataChart` コンポーネン ## Angular データ注釈ライン レイヤーの例 -Angular では、`DataAnnotationLineLayer` は、`DataChart` コンポーネントのプロット領域内の 2 つのポイント間に複数の線を描画します。このデータ注釈レイヤーを使用すると、株価の上昇と下落を株価チャートに注釈として表示できます。すべてのシリーズと同様に、DataAnnotationLineLayer も `DataSource` プロパティによるデータ バインディングをサポートしています。このプロパティは、線の開始ポイントと終了ポイントの x/y 座標を表す、少なくとも 4 つの数値データ列を持つデータ項目のコレクションを設定する必要があります。開始ポイントは `StartValueXMemberPath` および `StartValueYMemberPath` プロパティを使用してマップする必要があり、終了ポイントは `EndValueXMemberPath` および `EndValueYMemberPath` プロパティを使用してマップする必要があります。 +Angular では、 は、 コンポーネントのプロット領域内の 2 つのポイント間に複数の線を描画します。このデータ注釈レイヤーを使用すると、株価の上昇と下落を株価チャートに注釈として表示できます。すべてのシリーズと同様に、DataAnnotationLineLayer も `DataSource` プロパティによるデータ バインディングをサポートしています。このプロパティは、線の開始ポイントと終了ポイントの x/y 座標を表す、少なくとも 4 つの数値データ列を持つデータ項目のコレクションを設定する必要があります。開始ポイントは および プロパティを使用してマップする必要があり、終了ポイントは および プロパティを使用してマップする必要があります。 たとえば、DataAnnotationLineLayer を使用して、Y 軸に株価の増加と減少のパターン、および株価の 52 週間の高値と安値の注釈を付けることができます。 @@ -63,7 +65,7 @@ Angular では、`DataAnnotationLineLayer` は、`DataChart` コンポーネン ## Angular データ注釈矩形レイヤーの例 -Angular では、`DataAnnotationRectLayer` は、`DataChart` コンポーネントのプロット領域内の開始ポイントと終了ポイントによって定義された複数の四角形をを描画します。このデータ注釈レイヤーは、株価の弱気パターンなどのプロットエリアの領域に注釈を付けることに使用できます。すべてのシリーズと同様に、DataAnnotationRectLayer も `DataSource` プロパティによるデータ バインディングをサポートしています。このプロパティは、矩形の開始ポイントと終了ポイントの x/y 座標を表す、少なくとも 4 つの数値データ列を持つデータ項目のコレクションを設定する必要があります。開始ポイントは `StartValueXMemberPath` および `StartValueYMemberPath` プロパティを使用してマップする必要があり、終了ポイントは `EndValueXMemberPath` および `EndValueYMemberPath` プロパティを使用してマップする必要があります。 +Angular では、 は、 コンポーネントのプロット領域内の開始ポイントと終了ポイントによって定義された複数の四角形をを描画します。このデータ注釈レイヤーは、株価の弱気パターンなどのプロットエリアの領域に注釈を付けることに使用できます。すべてのシリーズと同様に、DataAnnotationRectLayer も `DataSource` プロパティによるデータ バインディングをサポートしています。このプロパティは、矩形の開始ポイントと終了ポイントの x/y 座標を表す、少なくとも 4 つの数値データ列を持つデータ項目のコレクションを設定する必要があります。開始ポイントは および プロパティを使用してマップする必要があり、終了ポイントは および プロパティを使用してマップする必要があります。 たとえば、DataAnnotationRectLayer を使用して、株価の弱気パターンとギャップを Y 軸に注釈付けできます。 @@ -74,7 +76,7 @@ Angular では、`DataAnnotationRectLayer` は、`DataChart` コンポーネン ## Angular データ注釈バンド レイヤーの例 -Angular では、`DataAnnotationBandLayer` は、`DataChart` コンポーネントのプロット領域内の 2 つのポイント間に複数の傾斜した四角形を描画します。このデータ注釈レイヤーは、株価の上昇と下落の範囲を注釈するために使用できます。すべてのシリーズと同様に、DataAnnotationBandLayer も `DataSource` プロパティによるデータ バインディングをサポートしています。このプロパティには、線の開始ポイントと終了ポイントの x/y 座標を表す、少なくとも 4 つの数値データ列を持つデータ項目のコレクションを設定します。開始ポイントは `StartValueXMemberPath` および `StartValueYMemberPath` プロパティを使用してマップする必要があり、終了ポイントは `EndValueXMemberPath` および `EndValueYMemberPath` プロパティを使用してマップする必要があります。さらに、数値データ列を AnnotationBreadthMemberPath プロパティにバインドすることで、傾斜した四角形の太さ/サイズを指定することもできます。 +Angular では、 は、 コンポーネントのプロット領域内の 2 つのポイント間に複数の傾斜した四角形を描画します。このデータ注釈レイヤーは、株価の上昇と下落の範囲を注釈するために使用できます。すべてのシリーズと同様に、DataAnnotationBandLayer も `DataSource` プロパティによるデータ バインディングをサポートしています。このプロパティには、線の開始ポイントと終了ポイントの x/y 座標を表す、少なくとも 4 つの数値データ列を持つデータ項目のコレクションを設定します。開始ポイントは および プロパティを使用してマップする必要があり、終了ポイントは および プロパティを使用してマップする必要があります。さらに、数値データ列を AnnotationBreadthMemberPath プロパティにバインドすることで、傾斜した四角形の太さ/サイズを指定することもできます。 たとえば、DataAnnotationBandLayer を使用して株価の成長範囲に注釈を付けることができます。 @@ -87,14 +89,14 @@ Angular では、`DataAnnotationBandLayer` は、`DataChart` コンポーネン 以下は上記のセクションで説明した API メンバーのリストです。 -- `TargetAxis`: このプロパティは、どの軸に有効な DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer を設定するかを指定します。 +- : このプロパティは、どの軸に有効な DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer を設定するかを指定します。 - `DataSource`: このプロパティは、データを注釈レイヤーにバインドして正確な形状を提供します。 -- `StartValueXMemberPath`: このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の開始位置となる x 座標を含むデータ列の列名にマッピングします。 -- `StartValueYMemberPath`: このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の開始位置となる y 座標を含むデータ列の列名にマッピングします。 -- `EndValueXMemberPath`: このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の終了位置となる x 座標を含むデータ列にマッピングします。 -- `EndValueYMemberPath`: このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の終了位置となる y 座標を含むデータ列にマッピングします。 -- `StartLabelXMemberPath`: このプロパティは、軸に沿った xAxis の開始位置のオーバーレイ ラベルを表すデータ列へのマッピングです。 -- `StartLabelXDisplayMode` | `StartLabelYDisplayMode` | `EndLabelXDisplayMode` | `EndLabelYDisplayMode` | `CenterLabelXDisplayMode`: これらのプロパティは、注釈形状の開始、終了、または中央に注釈ラベルとして何を表示するかを指定します。たとえば、マップされたデータ値、データ ラベル、軸の値を表示したり、特定の注釈ラベルを非表示にします。 -- `StartLabelYMemberPath`: このプロパティは、y 軸上の `DataAnnotationBandLayer`、`DataAnnotationLineLayer`、`DataAnnotationRectLayer` の開始位置の軸ラベルを表すデータ列へのマッピングです。 -- `EndLabelYMemberPath`: このプロパティは、y 軸上の `DataAnnotationBandLayer`、`DataAnnotationLineLayer`、`DataAnnotationRectLayer` の終了位置の軸ラベルを表すデータ列へのマッピングです。 +- : このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の開始位置となる x 座標を含むデータ列の列名にマッピングします。 +- : このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の開始位置となる y 座標を含むデータ列の列名にマッピングします。 +- : このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の終了位置となる x 座標を含むデータ列にマッピングします。 +- : このプロパティは、DataAnnotationBandLayer、DataAnnotationLineLayer、および DataAnnotationRectLayer の終了位置となる y 座標を含むデータ列にマッピングします。 +- : このプロパティは、軸に沿った xAxis の開始位置のオーバーレイ ラベルを表すデータ列へのマッピングです。 +- | | | | : これらのプロパティは、注釈形状の開始、終了、または中央に注釈ラベルとして何を表示するかを指定します。たとえば、マップされたデータ値、データ ラベル、軸の値を表示したり、特定の注釈ラベルを非表示にします。 +- : このプロパティは、y 軸上の の開始位置の軸ラベルを表すデータ列へのマッピングです。 +- : このプロパティは、y 軸上の の終了位置の軸ラベルを表すデータ列へのマッピングです。 diff --git a/docs/angular/src/content/jp/components/charts/features/chart-data-legend.mdx b/docs/angular/src/content/jp/components/charts/features/chart-data-legend.mdx index 941de61435..8d16b153bc 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-data-legend.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-data-legend.mdx @@ -17,37 +17,37 @@ import layoutMode from '@xplat-images/general/layout_mode.png'; # Angular データ凡例 -Ignite UI for Angular では、`DataLegend` は `Legend` の高度にカスタマイズ可能なバージョンであり、シリーズの値を表示するほか、シリーズの行や値の列のフィルタリング、値のスタイルと書式設定を行うための多くの構成プロパティを提供します。この凡例は、`CategoryChart`、`FinancialChart`、および `DataChart` のプロット領域内でマウスを動かすと更新されます。また、ユーザーのマウス ポインターがプロット領域を出ると、最後にホバーされたポイントが維持されます。このコンテンツは、3 種類の行 (ヘッダー、シリーズ、要約) と 4 種類の列 (タイトル、ラベル、値、単位) のセットを使用して表示されます。 +Ignite UI for Angular では、 の高度にカスタマイズ可能なバージョンであり、シリーズの値を表示するほか、シリーズの行や値の列のフィルタリング、値のスタイルと書式設定を行うための多くの構成プロパティを提供します。この凡例は、、および のプロット領域内でマウスを動かすと更新されます。また、ユーザーのマウス ポインターがプロット領域を出ると、最後にホバーされたポイントが維持されます。このコンテンツは、3 種類の行 (ヘッダー、シリーズ、要約) と 4 種類の列 (タイトル、ラベル、値、単位) のセットを使用して表示されます。 ## Angular データ凡例の行 -`DataLegend` の行には、ヘッダー行、シリーズ行、および集計行が含まれます。ヘッダー行には、ホバーされたポイントの軸ラベルが表示され、`HeaderText` プロパティを使用して変更できます。 + の行には、ヘッダー行、シリーズ行、および集計行が含まれます。ヘッダー行には、ホバーされたポイントの軸ラベルが表示され、 プロパティを使用して変更できます。 ### ヘッダー行 -ヘッダー行には、カテゴリ シリーズとファイナンシャル シリーズにマウスを合わせると、x 軸の現在のラベルが表示されます。x 軸に日付が表示されている場合は、`HeaderFormatDate` プロパティと `HeaderFormatTime` プロパティを使用して、`DataLegend` の日付と時刻を書式設定できます。他のタイプのシリーズの場合、`DataLegend` はヘッダー行を描画しません。 +ヘッダー行には、カテゴリ シリーズとファイナンシャル シリーズにマウスを合わせると、x 軸の現在のラベルが表示されます。x 軸に日付が表示されている場合は、 プロパティと プロパティを使用して、 の日付と時刻を書式設定できます。他のタイプのシリーズの場合、 はヘッダー行を描画しません。 ### シリーズ行 -シリーズ行は、チャートにプロットされた各シリーズを表します。これらの行には、凡例バッジ、シリーズ タイトル、シリーズの実際の値 / 省略値、および指定されている場合は省略記号と測定単位が表示されます。`IncludedSeries` または `ExcludedSeries` プロパティをシリーズのインデックス (1、2、3) またはシリーズのタイトル (Tesla、Microsoft) のコレクションに設定することにより、シリーズの行をフィルタできます。 +シリーズ行は、チャートにプロットされた各シリーズを表します。これらの行には、凡例バッジ、シリーズ タイトル、シリーズの実際の値 / 省略値、および指定されている場合は省略記号と測定単位が表示されます。 または プロパティをシリーズのインデックス (1、2、3) またはシリーズのタイトル (Tesla、Microsoft) のコレクションに設定することにより、シリーズの行をフィルタできます。 ### 集計行 -最後に、すべてのシリーズ値の合計を表示する集計行があります。デフォルトの集計タイトルは、凡例の `SummaryTitleText` プロパティを使用して変更できます。また、`SummaryType` プロパティを使用して、集計行にシリーズの値の `Total`、`Min`、`Max`、または `Average` を表示するかどうかをカスタマイズできます。 +最後に、すべてのシリーズ値の合計を表示する集計行があります。デフォルトの集計タイトルは、凡例の プロパティを使用して変更できます。また、 プロパティを使用して、集計行にシリーズの値の 、または を表示するかどうかをカスタマイズできます。 ## Angular データ凡例の列 -`DataLegend` の列には、シリーズのタイトル、ラベル、データ列の値、および値に関連付けられたオプションの単位が含まれます。チャートの一部のシリーズには、ラベル、値、および単位の複数の列を含めることができます。たとえば、財務価格シリーズには、**High**、**Low**、**Open**、および **Close** のデータ列があります。これらは、`IncludedColumns` または `ExcludedColumns` プロパティを使用して `DataLegend` でフィルタリングできます。 + の列には、シリーズのタイトル、ラベル、データ列の値、および値に関連付けられたオプションの単位が含まれます。チャートの一部のシリーズには、ラベル、値、および単位の複数の列を含めることができます。たとえば、財務価格シリーズには、**High**、**Low**、**Open**、および **Close** のデータ列があります。これらは、 または プロパティを使用して でフィルタリングできます。 -`IncludedColumns` プロパティと `ExcludedColumns` プロパティの値の設定は、シリーズのタイプとそれらがサポートするデータ列の数によって異なります。たとえば、`IncludedColumns` プロパティに **Open** および **Close** の文字列コレクションを設定すると、チャートがファイナンシャル シリーズをプロットしているときに、株価の始値と終値のみが表示されます。次の表に、データ シリーズの列をフィルタリングするために使用できるすべての列名を示します。 + プロパティと プロパティの値の設定は、シリーズのタイプとそれらがサポートするデータ列の数によって異なります。たとえば、 プロパティに **Open** および **Close** の文字列コレクションを設定すると、チャートがファイナンシャル シリーズをプロットしているときに、株価の始値と終値のみが表示されます。次の表に、データ シリーズの列をフィルタリングするために使用できるすべての列名を示します。 | シリーズのタイプ | 列名 | | -----------------|-------------- | @@ -63,20 +63,20 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha ### タイトル列 -タイトル列には、チャートにプロットされた各 `Series` の `Title` プロパティに由来する凡例バッジとシリーズ タイトルが表示されます。 +タイトル列には、チャートにプロットされた各 プロパティに由来する凡例バッジとシリーズ タイトルが表示されます。 ### ラベル列 -ラベル列には、値列の左側に短い名前が表示されます。たとえば、**Open** 株価の場合は「O」です。`LabelDisplayMode` プロパティを使用して、この列の表示・非表示を切り替えることができます。 +ラベル列には、値列の左側に短い名前が表示されます。たとえば、**Open** 株価の場合は「O」です。 プロパティを使用して、この列の表示・非表示を切り替えることができます。 ### 値列 -値の列には、シリーズの値が省略形のテキストとして表示されます。このテキストは、`ValueFormatAbbreviation` プロパティを使用して書式設定でき、このプロパティを `Shared` に設定することですべての数値に同じ省略形を適用できます。または、ユーザーは `Independent`、`Kilo`、`Million` などの他の省略形を選択できます。省略値の精度は、最小桁数と最大桁数にそれぞれ `ValueFormatMinFractions` と `ValueFormatMaxFractions` を使用して制御されます。 +値の列には、シリーズの値が省略形のテキストとして表示されます。このテキストは、 プロパティを使用して書式設定でき、このプロパティを に設定することですべての数値に同じ省略形を適用できます。または、ユーザーは などの他の省略形を選択できます。省略値の精度は、最小桁数と最大桁数にそれぞれ を使用して制御されます。 ### 単位列 -単位列には、値列の右側に省略記号が表示されます。単位記号は、`ValueFormatAbbreviation` プロパティに依存します。「M」は「Million」の略語です。 +単位列には、値列の右側に省略記号が表示されます。単位記号は、 プロパティに依存します。「M」は「Million」の略語です。 ### 列のカスタマイズ @@ -90,11 +90,11 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha | 範囲シリーズ | HighMemberAsLegendLabel="H:"
HighMemberAsLegendUnit="K"
LowMemberAsLegendLabel="L:"
LowMemberAsLegendUnit="K" | | ファイナンシャル シリーズ | OpenMemberAsLegendLabel="O:"
OpenMemberAsLegendUnit="K"
HighMemberAsLegendLabel="H:"
HighMemberAsLegendUnit="K"
LowMemberAsLegendLabel="L:"
LowMemberAsLegendUnit="K"
CloseMemberAsLegendLabel="C:"
CloseMemberAsLegendUnit="K"
| -また、`DataLegend` の `UnitText` プロパティを使用して、すべての Unit 列に表示されるテキストを変更できます。 +また、 の `UnitText` プロパティを使用して、すべての Unit 列に表示されるテキストを変更できます。 ## レイアウト モード -凡例項目は、`LayoutMode` プロパティを使って垂直または表形式の構造に配置できます。デフォルト値は `Table` で、以前のリリースと同じ外観と操作性を維持します。 +凡例項目は、 プロパティを使って垂直または表形式の構造に配置できます。デフォルト値は `Table` で、以前のリリースと同じ外観と操作性を維持します。 例: @@ -102,7 +102,7 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha ## Angular データ凡例のスタイル設定 -`DataLegend` は、各タイプの列をスタイル設定するためのプロパティを提供します。これらの各プロパティの名前は、**Title**、**Label**、**Value**、または **Units** で始まります。テキストの色、フォント、余白のスタイルを設定できます。たとえば、すべての列のテキストの色を設定する場合は、`TitleTextColor`、`LabelTextColor`、`ValueTextColor`、および `UnitsTextColor` プロパティを設定します。次の例は、上記のスタイル設定プロパティの使用法を示しています: + は、各タイプの列をスタイル設定するためのプロパティを提供します。これらの各プロパティの名前は、**Title**、**Label**、**Value**、または **Units** で始まります。テキストの色、フォント、余白のスタイルを設定できます。たとえば、すべての列のテキストの色を設定する場合は、、および プロパティを設定します。次の例は、上記のスタイル設定プロパティの使用法を示しています: @@ -111,7 +111,7 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha ## Angular データ凡例値の書式設定 -`DataLegend` は、`ValueFormatAbbreviation` プロパティを使用して、大きな数値の自動省略形を提供します。これにより、単位の列に kilo、million、billion などの乗数が追加されます。`ValueFormatMinFractions` および `ValueFormatMaxFractions` を設定することにより、表示される小数桁数をカスタマイズできます。これにより、小数点以下に表示される最小桁数と最大桁数をそれぞれ決定できます。 + は、 プロパティを使用して、大きな数値の自動省略形を提供します。これにより、単位の列に kilo、million、billion などの乗数が追加されます。 および を設定することにより、表示される小数桁数をカスタマイズできます。これにより、小数点以下に表示される最小桁数と最大桁数をそれぞれ決定できます。 次の例は、これらのプロパティの使用方法を示しています: @@ -121,7 +121,7 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha ## Angular データ凡例の値モード -`ValueFormatMode` プロパティを変更することにより、`DataLegend` 内の値のデフォルトの 10 進表示を通貨表示に変更することができます。また、`ValueFormatCulture` プロパティにカルチャ タグを設定することで、表示される通貨記号のカルチャを変更できます。たとえば、次のデータ凡例の例では、`ValueFormatCulture` が 「en-GB」 に設定されており、英国ポンド (£) の記号が表示されています: + プロパティを変更することにより、 内の値のデフォルトの 10 進表示を通貨表示に変更することができます。また、 プロパティにカルチャ タグを設定することで、表示される通貨記号のカルチャを変更できます。たとえば、次のデータ凡例の例では、 が 「en-GB」 に設定されており、英国ポンド (£) の記号が表示されています: @@ -129,8 +129,8 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha ## Angular データ凡例のグループ化 -`DataLegendGroup` は、すべてのタイプのシリーズで、データ凡例内のシリーズ グループを分類する文字列に設定できます。各グループには、別のシリーズ グループが表示される前に、独自の集計行が表示されます。 -デフォルトでは、DataLegend はグループ名を非表示にしますが、`GroupRowVisible` プロパティを true に設定するとグループ名を表示できます。 + は、すべてのタイプのシリーズで、データ凡例内のシリーズ グループを分類する文字列に設定できます。各グループには、別のシリーズ グループが表示される前に、独自の集計行が表示されます。 +デフォルトでは、DataLegend はグループ名を非表示にしますが、 プロパティを true に設定するとグループ名を表示できます。 @@ -142,21 +142,21 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha - `GroupRowMargin` - `GroupTextMargin` -- `GroupTextColor` +- - `GroupTextFontSize` - `GroupTextFontFamily` - `GroupTextFontStyle` - `GroupTextFontStretch` - `GroupTextFontWeight` - `HeaderTextMargin` -- `HeaderTextColor` +- - `HeaderTextFontSize` - `HeaderTextFontFamily` - `HeaderTextFontStyle` - `HeaderTextFontStretch` - `HeaderTextFontWeight` -`DataLegend` には、値が更新されているマウス操作中であっても、対応する行を描画するときに発生するいくつかのイベントがあります。それらのイベントを、その使用目的とあわせて以下に示します: + には、値が更新されているマウス操作中であっても、対応する行を描画するときに発生するいくつかのイベントがあります。それらのイベントを、その使用目的とあわせて以下に示します: - `StyleGroupRow`: このイベントは、グループ行に表示されるテキストのスタイルを設定するために、グループごとに発生します。 - `StyleHeaderRow`: このイベントは、ヘッダー行を描画するときに発生します。 @@ -165,9 +165,9 @@ OHLC 価格の **TypicalPrice** (標準価格) とパーセンテージの **Cha - `StyleSummaryRow`: このイベントは、集計行を描画するときに 1 回発生します。 - `StyleSummaryColumn`: このイベントは、集計列を描画するときに 1 回発生します。 -一部のイベントは、引数として `DataLegendStylingRowEventArgs` パラメーターを公開します。これにより、各項目のテキスト、テキストの色、および行の全体的な可視性をカスタマイズできます。イベント引数は、イベント固有のプロパティも公開します。たとえば、`StyleSeriesRow` イベントはシリーズごとに発生するため、イベント引数は、シリーズを表す行の、シリーズ インデックスとシリーズ タイトルを返します。 +一部のイベントは、引数として パラメーターを公開します。これにより、各項目のテキスト、テキストの色、および行の全体的な可視性をカスタマイズできます。イベント引数は、イベント固有のプロパティも公開します。たとえば、`StyleSeriesRow` イベントはシリーズごとに発生するため、イベント引数は、シリーズを表す行の、シリーズ インデックスとシリーズ タイトルを返します。 -`StyleSummaryColumn` および `SeriesStyleColumn` イベントは、シリーズ内の各フィールドをカスタマイズするために、引数として `DataLegendStylingColumnEventArgs` パラメーターを公開します。イベント引数は、列インデックスや値メンバーなどの列に関するプロパティに関連するイベント固有のプロパティも公開します。 +`StyleSummaryColumn` および `SeriesStyleColumn` イベントは、シリーズ内の各フィールドをカスタマイズするために、引数として パラメーターを公開します。イベント引数は、列インデックスや値メンバーなどの列に関するプロパティに関連するイベント固有のプロパティも公開します。 diff --git a/docs/angular/src/content/jp/components/charts/features/chart-data-selection.mdx b/docs/angular/src/content/jp/components/charts/features/chart-data-selection.mdx index 0189222d2c..d617e0f335 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-data-selection.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-data-selection.mdx @@ -11,13 +11,15 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular チャートの選択 Angular データ チャートの Ignite UI for Angular 選択機能を使用すると、ユーザーはチャート内の単一または複数のシリーズを対話的に選択、ハイライト表示、アウトライン表示したり、その逆の選択を解除したりできます。これにより、提示されたデータをユーザーがより意味のある方法で操作するさまざまな可能性が提供されます。 ## 選択の設定 -デフォルトの動作 `SelectionMode` はオフになっており、次のいずれかのオプションを選択する必要があります。`{ComponentName}` に使用可能な選択モードがいくつかあります。 +デフォルトの動作 はオフになっており、次のいずれかのオプションを選択する必要があります。`{ComponentName}` に使用可能な選択モードがいくつかあります。 - **Auto** - **None** @@ -33,10 +35,10 @@ Angular データ チャートの Ignite UI for Angular 選択機能を使用す - **ThickOutline** `Brighten` は選択した項目をフェードアウトしますが、`FadeOthers` は反対の効果を引き起こします。 -`GrayscaleOthers` は `FadeOthers` と同様に動作しますが、シリーズの残りの部分にはグレー色を表示します。これは `SelectionBrush` 設定をオーバーライドすることに注意してください。 +`GrayscaleOthers` は `FadeOthers` と同様に動作しますが、シリーズの残りの部分にはグレー色を表示します。これは 設定をオーバーライドすることに注意してください。 `SelectionColorOutline` と `SelectionColorThickOutline` はシリーズの周囲に境界線を描画します。 -併せて、どの項目を選択するかをより細かく制御できる `SelectionBehavior` も利用できます。Auto のデフォルトの動作は `PerSeriesAndDataItemMultiSelect` です。 +併せて、どの項目を選択するかをより細かく制御できる も利用できます。Auto のデフォルトの動作は `PerSeriesAndDataItemMultiSelect` です。 - **Auto** - **PerDataItemMultiSelect** @@ -57,7 +59,7 @@ Angular データ チャートの Ignite UI for Angular 選択機能を使用す ## 複数選択の構成 -その他の選択モードでは、さまざまな選択方法が提供されます。たとえば、`PerDataItemMultiSelect` とともに `SelectionBehavior` を使用すると、複数のシリーズが存在する場合にカテゴリ全体のすべてのシリーズに影響し、カテゴリ間での選択が可能になります。`PerDataItemSingleSelect` と比較すると、一度に選択できるのは 1 つのカテゴリの項目のみです。これは、複数のシリーズが異なるデータ ソースにバインドされている場合に役立ち、カテゴリ間の選択をより細かく制御できます。 +その他の選択モードでは、さまざまな選択方法が提供されます。たとえば、`PerDataItemMultiSelect` とともに を使用すると、複数のシリーズが存在する場合にカテゴリ全体のすべてのシリーズに影響し、カテゴリ間での選択が可能になります。`PerDataItemSingleSelect` と比較すると、一度に選択できるのは 1 つのカテゴリの項目のみです。これは、複数のシリーズが異なるデータ ソースにバインドされている場合に役立ち、カテゴリ間の選択をより細かく制御できます。 `PerSeriesAndDataItemGlobalSingleSelect` を使用すると、一度にすべてのカテゴリで単一のシリーズを選択できます。 @@ -65,19 +67,19 @@ Angular データ チャートの Ignite UI for Angular 選択機能を使用す ## アウトライン選択の構成 -`FocusBrush` を適用すると、`SelectionMode` プロパティがフォーカス オプションの 1 つに設定されている場合に、選択されたシリーズが境界線付きで表示されます。 + を適用すると、 プロパティがフォーカス オプションの 1 つに設定されている場合に、選択されたシリーズが境界線付きで表示されます。 ## ラジアル シリーズの選択 -この例では、各ラジアル シリーズを異なる色で選択できる `DataChart` を介した別のシリーズ タイプを示します。 +この例では、各ラジアル シリーズを異なる色で選択できる を介した別のシリーズ タイプを示します。 ## プログラムによる選択 -チャートの選択項目は、起動時や実行時にチャートの選択項目を表示するようにコードで設定することもできます。これは、`CategoryChart` の `SelectedSeriesCollection` に項目を追加することで実現できます。`ChartSelection` オブジェクトの `Matcher` プロパティを使用すると、「マッチャー」に基づいてシリーズを選択できます。これはチャートから実際のシリーズにアクセスできない場合に最適です。データ ソースに含まれるプロパティがわかっていれば、シリーズが使用される `ValueMemberPath` を使用できます。 +チャートの選択項目は、起動時や実行時にチャートの選択項目を表示するようにコードで設定することもできます。これは、 の `SelectedSeriesCollection` に項目を追加することで実現できます。 オブジェクトの プロパティを使用すると、「マッチャー」に基づいてシリーズを選択できます。これはチャートから実際のシリーズにアクセスできない場合に最適です。データ ソースに含まれるプロパティがわかっていれば、シリーズが使用される `ValueMemberPath` を使用できます。 -マッチャーは、`DataChart` のように実際のシリーズにアクセスできない場合、`CategoryChart` などのチャートで使用するのに最適です。この場合、データ ソースに含まれるプロパティがわかっていれば、シリーズに含まれる ValueMemberPaths を推測できます。たとえば、データ ソースに Nuclear、Coal、Oil、Solar という数値プロパティがある場合、これらのプロパティごとにシリーズが作成されていることがわかります。Solar 値にバインドされたシリーズをハイライト表示する場合は、次のプロパティが設定されたマッチャーを使用して、ChartSelection オブジェクトを `SelectedSeriesItems` コレクションに追加できます。 +マッチャーは、 のように実際のシリーズにアクセスできない場合、 などのチャートで使用するのに最適です。この場合、データ ソースに含まれるプロパティがわかっていれば、シリーズに含まれる ValueMemberPaths を推測できます。たとえば、データ ソースに Nuclear、Coal、Oil、Solar という数値プロパティがある場合、これらのプロパティごとにシリーズが作成されていることがわかります。Solar 値にバインドされたシリーズをハイライト表示する場合は、次のプロパティが設定されたマッチャーを使用して、ChartSelection オブジェクトを コレクションに追加できます。 たとえば、データ ソースに Nuclear、Coal、Oil、Solar という数値プロパティがある場合、これらのプロパティごとにシリーズが作成されていることがわかります。Solar 値にバインドされたシリーズを選択する場合は、次のプロパティが設定されたマッチャーを使用して、ChartSelection オブジェクトを SelectedSeriesItems コレクションに追加できます。 @@ -88,6 +90,6 @@ Angular データ チャートの Ignite UI for Angular 選択機能を使用す 以下は上記のセクションで説明した API メンバーのリストです。 -| `CategoryChart` プロパティ | `DataChart` プロパティ | +| プロパティ | プロパティ | | ----------------------------------------------|---------------------------| | | | diff --git a/docs/angular/src/content/jp/components/charts/features/chart-data-tooltip.mdx b/docs/angular/src/content/jp/components/charts/features/chart-data-tooltip.mdx index 3a944cf622..964d1d4804 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-data-tooltip.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-data-tooltip.mdx @@ -21,11 +21,11 @@ import layoutMode from '@xplat-images/general/layout_mode.png'; # Angular チャート データ ツールチップ -Ignite UI for Angular では、**DataToolTip** は、シリーズの値とタイトル、およびシリーズの凡例バッジをツールチップに表示します。さらに、シリーズの行と値の列をフィルタリングし、値をスタイル設定し、書式を設定するための `DataLegend` の多くの構成プロパティを提供します。このツールチップ タイプは、、および `DataChart` コンポーネントのプロット領域内でマウスを動かすと更新されます。 +Ignite UI for Angular では、**DataToolTip** は、シリーズの値とタイトル、およびシリーズの凡例バッジをツールチップに表示します。さらに、シリーズの行と値の列をフィルタリングし、値をスタイル設定し、書式を設定するための の多くの構成プロパティを提供します。このツールチップ タイプは、、および コンポーネントのプロット領域内でマウスを動かすと更新されます。 ## Angular データ ツールチップのプロパティ - のすべてのプロパティには **DataToolTip** のプレフィックスが付けられ、 および コンポーネントの API で公開されます。ただし、ラジアル チャート、極座標チャート、散布図で使用する場合は、 のインスタンスを作成し、それを `DataChart` コンポーネントのシリーズ コレクションに追加する必要があります。 + のすべてのプロパティには **DataToolTip** のプレフィックスが付けられ、 および コンポーネントの API で公開されます。ただし、ラジアル チャート、極座標チャート、散布図で使用する場合は、 のインスタンスを作成し、それを コンポーネントのシリーズ コレクションに追加する必要があります。 ## Angular データ ツールチップの要素 @@ -52,7 +52,7 @@ Ignite UI for Angular では、**DataToolTip** は、シリーズの値とタイ の列には、タイトル、ラベル、値、および単位の列が含まれます。チャートの各シリーズには、凡例の または コレクションに応じて、ラベル、値、および単位の複数の列を含めることができます。 -タイトル列には、チャートにプロットされた各 `Series` の `Title` プロパティに由来する凡例バッジとシリーズ タイトルが表示されます。 +タイトル列には、チャートにプロットされた各 プロパティに由来する凡例バッジとシリーズ タイトルが表示されます。 ラベル列には、ツールチップの または コレクション内のさまざまなプロパティパスの名前または省略形が表示されます。 @@ -89,7 +89,7 @@ Ignite UI for Angular では、**DataToolTip** は、シリーズの値とタイ ## Angular データ チャートのデータ ツールチップのグループ化 -`DataLegendGroup` は、すべてのタイプのシリーズで、データ凡例内のシリーズ グループを分類する文字列に設定できます。各グループには、別のシリーズ グループが表示される前に、独自の集計行が表示されます。デフォルトでは、DataLegend はグループ名を非表示にしますが、`GroupRowVisible` プロパティを true に設定するとグループ名を表示できます。データ ツールチップ レイヤーで `GroupingMode` を 「Grouped」 に設定し、`LabelDisplayMode` を 「Visible」 に設定する必要があります。 + は、すべてのタイプのシリーズで、データ凡例内のシリーズ グループを分類する文字列に設定できます。各グループには、別のシリーズ グループが表示される前に、独自の集計行が表示されます。デフォルトでは、DataLegend はグループ名を非表示にしますが、 プロパティを true に設定するとグループ名を表示できます。データ ツールチップ レイヤーで を 「Grouped」 に設定し、 を 「Visible」 に設定する必要があります。 @@ -124,7 +124,7 @@ Ignite UI for Angular では、**DataToolTip** は、シリーズの値とタイ ## レイアウト モード -凡例項目は、`LayoutMode` プロパティを使って垂直または表形式の構造に配置できます。デフォルト値は `Table` で、以前のリリースと同じ外観と操作性を維持します。 +凡例項目は、 プロパティを使って垂直または表形式の構造に配置できます。デフォルト値は `Table` で、以前のリリースと同じ外観と操作性を維持します。 例: Layout Mode @@ -144,14 +144,14 @@ Ignite UI for Angular では、**DataToolTip** は、シリーズの値とタイ ツールチップのグループ化部分を含むいくつかのプロパティが公開されています。 - `GroupTextMargin` -- `GroupTextColor` +- - `GroupTextFontSize` - `GroupTextFontFamily` - `GroupTextFontStyle` - `GroupTextFontStretch` - `GroupTextFontWeight` - `HeaderTextMargin` -- `HeaderTextColor` +- - `HeaderTextFontSize` - `HeaderTextFontFamily` - `HeaderTextFontStyle` diff --git a/docs/angular/src/content/jp/components/charts/features/chart-highlight-filter.mdx b/docs/angular/src/content/jp/components/charts/features/chart-highlight-filter.mdx index fa42683d95..31e5e25b9a 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-highlight-filter.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-highlight-filter.mdx @@ -9,48 +9,50 @@ _language: ja --- import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular チャートのハイライト表示フィルター Ignite UI for Angular チャート コンポーネントは、プロットされたデータのサブセットを表示できるようにすることで、これらのチャートにプロットされた系列の視覚化を強化できるデータハイライト表示オーバーレイをサポートしています。これを有効にすると、列シリーズおよびエリア シリーズ タイプの場合は不透明度を下げて全体セットが表示され、線シリーズ タイプの場合は破線が表示されることで、データのサブセットがハイライト表示されます。これは、データセットの目標値と実際の値などを視覚化するのに役立ちます。以下の例で、この機能を説明します。 -データハイライト表示機能は `DataChart` および `CategoryChart` でサポートされていますが、これらのコントロールの動作の性質上、それぞれ異なる方法で構成されることに注意してください。ただし、この機能で変わらない点は、ハイライト表示を表示したい場合は `HighlightedValuesDisplayMode` プロパティを `Overlay` に設定する必要があることです。以下では、ハイライト表示フィルター機能のさまざまな設定について説明します。 +データハイライト表示機能は および でサポートされていますが、これらのコントロールの動作の性質上、それぞれ異なる方法で構成されることに注意してください。ただし、この機能で変わらない点は、ハイライト表示を表示したい場合は プロパティを `Overlay` に設定する必要があることです。以下では、ハイライト表示フィルター機能のさまざまな設定について説明します。 ## DataChart でのハイライト表示フィルターの使用 -`DataChart` では、ハイライト表示フィルター API の多くは主に、ハイライト表示するデータのサブセットを表すコレクションに `HighlightedItemsSource` プロパティを設定することによって、シリーズ自体で発生します。`HighlightedItemsSource` 内の項目の数は、ハイライト表示するシリーズの `ItemsSource` にバインドされているデータの数と一致する必要があります。カテゴリ シリーズの場合は、デフォルトでハイライト表示パスとして定義した `ValueMemberPath` が使用されます。このページの上部にあるサンプルでは、​​`DataChart` の `HighlightedItemsSource` を使用してオーバーレイを表示しています。 + では、ハイライト表示フィルター API の多くは主に、ハイライト表示するデータのサブセットを表すコレクションに プロパティを設定することによって、シリーズ自体で発生します。 内の項目の数は、ハイライト表示するシリーズの にバインドされているデータの数と一致する必要があります。カテゴリ シリーズの場合は、デフォルトでハイライト表示パスとして定義した `ValueMemberPath` が使用されます。このページの上部にあるサンプルでは、​​ を使用してオーバーレイを表示しています。 -シリーズの `HighlightedItemsSource` と `ItemsSource` の間でスキーマが一致しない場合は、シリーズの `HighlightedValueMemberPath` プロパティを使用してこれを構成できます。さらに、シリーズ自体の `ItemsSource` をハイライト表示ソースとして使用し、サブセットを表すデータ項目にパスを設定したい場合は、これを行うことができます。これは、`HighlightedItemsSource` を提供せずに、`HighlightedValueMemberPath` プロパティをそのパスに設定するだけで行われます。 +シリーズの の間でスキーマが一致しない場合は、シリーズの `HighlightedValueMemberPath` プロパティを使用してこれを構成できます。さらに、シリーズ自体の をハイライト表示ソースとして使用し、サブセットを表すデータ項目にパスを設定したい場合は、これを行うことができます。これは、 を提供せずに、`HighlightedValueMemberPath` プロパティをそのパスに設定するだけで行われます。 -列およびエリア シリーズ の場合の不透明度の低減は、シリーズの `HighlightedValuesFadeOpacity` プロパティを設定することで構成できます。オーバーレイをまったく表示したくない場合は、`HighlightedValuesDisplayMode` プロパティを `Hidden` に設定することもできます。 +列およびエリア シリーズ の場合の不透明度の低減は、シリーズの プロパティを設定することで構成できます。オーバーレイをまったく表示したくない場合は、 プロパティを `Hidden` に設定することもできます。 -ハイライト表示フィルターによって表示されるシリーズの部分は、チャートの凡例レイヤーとツールチップ レイヤーに個別に表示されます。`HighlightedTitleSuffix` を設定することで、ツールチップと凡例に表示されるタイトルを構成できます。これにより、指定した値がシリーズの `Title` の末尾に追加されます。 +ハイライト表示フィルターによって表示されるシリーズの部分は、チャートの凡例レイヤーとツールチップ レイヤーに個別に表示されます。 を設定することで、ツールチップと凡例に表示されるタイトルを構成できます。これにより、指定した値がシリーズの の末尾に追加されます。 -`DataLegend` または `DataToolTipLayer` を使用すると、ハイライト表示されたシリーズがグループ化されて表示されます。これは、シリーズの `HighlightedValuesDataLegendGroup` プロパティを設定してシリーズを適切に分類することで管理できます。 + または を使用すると、ハイライト表示されたシリーズがグループ化されて表示されます。これは、シリーズの プロパティを設定してシリーズを適切に分類することで管理できます。 -次の例は、`HighlightedValuesDataLegendGroup` を使用した `DataChart` コントロール内のデータ凡例のグループ化とデータ ハイライト オーバーレイ機能の使用法を示しています。 +次の例は、 を使用した コントロール内のデータ凡例のグループ化とデータ ハイライト オーバーレイ機能の使用法を示しています。 -次の例は、`HighlightedValuesDataLegendGroup` を使用した `DataChart` コントロール内のデータ ツールチップのグループ化とデータ ハイライト オーバーレイ機能の使用法を示しています。 +次の例は、 を使用した コントロール内のデータ ツールチップのグループ化とデータ ハイライト オーバーレイ機能の使用法を示しています。 -次の例は、`HighlightedValueMemberPath` を使用した `DataChart` コントロール内のデータハイライト表示オーバーレイ機能の使用法を示しています。 +次の例は、`HighlightedValueMemberPath` を使用した コントロール内のデータハイライト表示オーバーレイ機能の使用法を示しています。 ## CategoryChart でのハイライト表示フィルターの使用 -`CategoryChart` ハイライト表示フィルターは、`InitialHighlightFilter` プロパティを設定することによってチャート上で発生します。`CategoryChart` は、デフォルトで、基になるデータ項目のすべてのプロパティを考慮します。そのため、データのサブセットをフィルタリングできるようにデータをグループ化および集計できるように、チャート上でも `InitialGroups` を定義する必要があります。`InitialGroups` を基になるデータ項目の値パスに設定して、重複した値を持つパスでグループ化することができます。 + ハイライト表示フィルターは、 プロパティを設定することによってチャート上で発生します。 は、デフォルトで、基になるデータ項目のすべてのプロパティを考慮します。そのため、データのサブセットをフィルタリングできるようにデータをグループ化および集計できるように、チャート上でも を定義する必要があります。 を基になるデータ項目の値パスに設定して、重複した値を持つパスでグループ化することができます。 -`DataChart` と同様に、`HighlightedValuesDisplayMode` プロパティも `CategoryChart` で公開されます。オーバーレイを表示したくない場合は、このプロパティを `Hidden` に設定できます。 + と同様に、 プロパティも で公開されます。オーバーレイを表示したくない場合は、このプロパティを `Hidden` に設定できます。 -以下の例は、`CategoryChart` コントロール内でのデータハイライト表示オーバーレイ機能の使用法を示しています。 +以下の例は、 コントロール内でのデータハイライト表示オーバーレイ機能の使用法を示しています。 @@ -68,7 +70,7 @@ Ignite UI for Angular チャート コンポーネントは、プロットされ 以下は上記のセクションで説明した API メンバーのリストです。 -| `CategoryChart` プロパティ | `DataChart` プロパティ | +| プロパティ | プロパティ | | ----------------------------------------------|---------------------------| | `CategoryChart.HighlightedItemsSource` | `Series.HighlightedItemsSource` | | `CategoryChart.HighlightedTitleSuffix` | `Series.HighlightedTitleSuffix` | diff --git a/docs/angular/src/content/jp/components/charts/features/chart-highlighting.mdx b/docs/angular/src/content/jp/components/charts/features/chart-highlighting.mdx index 5fbd036f11..7c7fe89c25 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-highlighting.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-highlighting.mdx @@ -27,7 +27,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular チャートのハイライト表示モードと動作 -すべての Angular チャートは、さまざまなハイライト表示オプションをサポートしています。 は、プロット領域に描画されたシリーズ/データ項目にマウスを合わせたときに明るくまたはフェードするように設定できます。 は、ハイライト表示の効果をトリガーするために、直接または最も近いデータ項目に設定できます。ハイライト表示のモードと動作は、、および `DataChart` コントロールでサポートされており、ハイライト表示機能を使用するための同じ API を備えています。 +すべての Angular チャートは、さまざまなハイライト表示オプションをサポートしています。 は、プロット領域に描画されたシリーズ/データ項目にマウスを合わせたときに明るくまたはフェードするように設定できます。 は、ハイライト表示の効果をトリガーするために、直接または最も近いデータ項目に設定できます。ハイライト表示のモードと動作は、、および コントロールでサポートされており、ハイライト表示機能を使用するための同じ API を備えています。 以下の例は、 Angular チャートを示しています。 @@ -41,7 +41,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular チャート凡例のハイライト表示 -すべての Angular チャートは、凡例のハイライト表示をサポートしています。 を有効にすると、マウスが凡例マーカー項目にカーソルを合わせると、描画されたシリーズがプロット領域でハイライト表示されます。凡例のハイライト表示は、、および `DataChart` コントロールでサポートされており、ハイライト表示機能を使用するための同じ API を備えています。 +すべての Angular チャートは、凡例のハイライト表示をサポートしています。 を有効にすると、マウスが凡例マーカー項目にカーソルを合わせると、描画されたシリーズがプロット領域でハイライト表示されます。凡例のハイライト表示は、、および コントロールでサポートされており、ハイライト表示機能を使用するための同じ API を備えています。 以下の例は、凡例シリーズハイライト表示の Angular チャートを示しています。 diff --git a/docs/angular/src/content/jp/components/charts/features/chart-markers.mdx b/docs/angular/src/content/jp/components/charts/features/chart-markers.mdx index 64785e5925..77f4f4915f 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-markers.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-markers.mdx @@ -23,7 +23,7 @@ Ignite UI for Angular マーカーは、カテゴリ チャートのプロット ## Angular チャート マーカーの例 -次の例では、[折れチャート](../types/line-chart.md)は、2009 年から 2019 年までのヨーロッパ、中国、および米国の国々の再生可能エネルギーの発電量を比較しています。マーカーが プロパティを `Circle` 列挙値に設定して有効になっています。 +次の例では、[折れチャート](../types/line-chart.md)は、2009 年から 2019 年までのヨーロッパ、中国、および米国の国々の再生可能エネルギーの発電量を比較しています。マーカーが プロパティを 列挙値に設定して有効になっています。 マーカーのカラーは、以下のサンプルの プロパティと プロパティを設定することによっても管理されます。このサンプルでは、ドロップダウンを使用してマーカーと を構成できます。 @@ -34,41 +34,31 @@ Ignite UI for Angular マーカーは、カテゴリ チャートのプロット ## Angular チャート マーカー サイズ -`MarkerSize` プロパティをマーカーをサポートするシリーズに設定することで、データ ポイント マーカーのデバイス非依存ピクセル寸法を正確に制御できます。これにより、マーカー テンプレートやスタイルに関係なく、マーカーが画面上に表示される大きさを正確に制御できます。 + プロパティをマーカーをサポートするシリーズに設定することで、データ ポイント マーカーのデバイス非依存ピクセル寸法を正確に制御できます。これにより、マーカー テンプレートやスタイルに関係なく、マーカーが画面上に表示される大きさを正確に制御できます。 -デフォルトでは、マーカーのサイズはシリーズのマーカー テンプレートによって決まります。`MarkerSize` に特定の数値を設定すると、そのシリーズのすべてのマーカーがその正確なデバイス非依存ピクセルの幅と高さでレンダリングされます。`MarkerSize` を `NaN` に戻すと、デフォルトのテンプレート駆動のサイズ設定が復元されます。 +デフォルトでは、マーカーのサイズはシリーズのマーカー テンプレートによって決まります。 に特定の数値を設定すると、そのシリーズのすべてのマーカーがその正確なデバイス非依存ピクセルの幅と高さでレンダリングされます。 を `NaN` に戻すと、デフォルトのテンプレート駆動のサイズ設定が復元されます。 -`MarkerSize` プロパティは、`MarkerSeries` から派生するすべてのシリーズ タイプ (`LineSeries`、`SplineSeries`、`AreaSeries`、`ColumnSeries`、`ScatterSeries`、`ScatterLineSeries`、`ScatterSplineSeries`、極座標/放射状シリーズ タイプなど) で使用できます。 + プロパティは、 から派生するすべてのシリーズ タイプ (、極座標/放射状シリーズ タイプなど) で使用できます。 -次のコード例は、`XamDataChart` コントロールの `ScatterLineSeries` で `MarkerSize` を 30 デバイス非依存ピクセルに設定する方法を示しています。 +次のコード例は、 コントロールの を 30 デバイス非依存ピクセルに設定する方法を示しています。 +マーカーをデフォルトのテンプレート駆動サイズにリセットするには、 を `NaN` に設定します (またはマークアップで属性を削除します)。 - - - - - -マーカーをデフォルトのテンプレート駆動サイズにリセットするには、`MarkerSize` を `NaN` に設定します (またはマークアップで属性を削除します)。 - - - - - -次のサンプルは、インタラクティブなエディターを使用して散布図シリーズで `MarkerSize` を示しています。 +次のサンプルは、インタラクティブなエディターを使用して散布図シリーズで を示しています。 - -`BubbleSeries` の場合、`MarkerSize` プロパティはバブルの半径をオーバーライドしません。バブルの半径は、半径データ列と `RadiusScale` によって制御されます。バブルのサイズは、データとスケールの構成によって完全に決まります。 + + の場合、 プロパティはバブルの半径をオーバーライドしません。バブルの半径は、半径データ列と によって制御されます。バブルのサイズは、データとスケールの構成によって完全に決まります。
## Angular チャート チェックマーク マーカー タイプ -Ignite UI for Angular チャートは、`MarkerType` 列挙型に `Checkmark` オプションを含んでいます。このマーカーは、チャートのデータ ポイントに円の中に V 字型のチェックマーク アイコンを描画します。 +Ignite UI for Angular チャートは、 列挙型に `Checkmark` オプションを含んでいます。このマーカーは、チャートのデータ ポイントに円の中に V 字型のチェックマーク アイコンを描画します。 -`Checkmark` マーカー タイプを個々のシリーズに適用するには、シリーズの `MarkerType` プロパティを `MarkerType.Checkmark` に設定します。チャート内のすべてのシリーズに同時にチェックマーク形状を使用するには、チャートの `MarkerAutomaticBehavior` プロパティを `MarkerAutomaticBehavior.Checkmark` に設定します。 +`Checkmark` マーカー タイプを個々のシリーズに適用するには、シリーズの プロパティを `MarkerType.Checkmark` に設定します。チャート内のすべてのシリーズに同時にチェックマーク形状を使用するには、チャートの プロパティを `MarkerAutomaticBehavior.Checkmark` に設定します。 `SeriesViewer.CheckmarkMarkerTemplate` プロパティは、チェックマーク マーカー タイプを持つシリーズに使用されるマーカー テンプレートを定義し、チャート全体の外観をカスタマイズするために使用できます。 @@ -76,7 +66,7 @@ Ignite UI for Angular チャートは、`MarkerType` 列挙型に `Checkmark` ## Angular チャート マーカー テンプレート -以下の例に示すように、マーカー プロパティに加えて、`CategoryChart` コントロールで描画されたシリーズの プロパティに関数を設定することで、独自のマーカーを実装できます。 +以下の例に示すように、マーカー プロパティに加えて、 コントロールで描画されたシリーズの プロパティに関数を設定することで、独自のマーカーを実装できます。 diff --git a/docs/angular/src/content/jp/components/charts/features/chart-navigation.mdx b/docs/angular/src/content/jp/components/charts/features/chart-navigation.mdx index f26c8b38a1..8897db9c70 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-navigation.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-navigation.mdx @@ -35,7 +35,7 @@ Ignite UI for Angular チャートを使用すると、マウス、キーボー ## ユーザー インタラクションによるチャート ナビゲーション -ズームがデフォルトでオンになっているかどうかは、使用しているチャートによって異なります。 を使用している場合、デフォルトでオンになっていますが、`DataChart` ではオフです。+UI でナビゲーションを有効または無効にするには、ズームを無効にする方向に応じて、チャートの プロパティおよび/または プロパティを設定する必要があります。 +ズームがデフォルトでオンになっているかどうかは、使用しているチャートによって異なります。 を使用している場合、デフォルトでオンになっていますが、 ではオフです。+UI でナビゲーションを有効または無効にするには、ズームを無効にする方向に応じて、チャートの プロパティおよび/または プロパティを設定する必要があります。 またマウスやタッチでズームまたはパンニングできます。チャートの プロパティは、マウスクリック イベントやタッチ イベントで何が起こるかを決定します。このプロパティはデフォルトで `DragZoom` に設定されており、ズームを有効に設定すると、クリックしてドラッグした際にプロット領域の上に四角形のプレビューが配置され、グラフのズーム領域になります。この プロパティは、パンニングを許可する場合は `DragPan`、これらの操作を禁止する場合は `None` に設定することもできます。 @@ -80,7 +80,7 @@ Angular データ チャートのナビゲーションは、タッチ、マウ ## コードによるチャート ナビゲーション -チャートのコード ナビゲーションは、`DataChart` コントロールにのみ使用できます。 +チャートのコード ナビゲーションは、 コントロールにのみ使用できます。 Angular データ チャートは、チャートでズームまたはパン操作が行われるたびに更新されるいくつかのナビゲーション プロパティを提供します。各プロパティは、チャートでズームやパンニングするためにコードで設定できます。以下は、これらのプロパティの一覧です。 diff --git a/docs/angular/src/content/jp/components/charts/features/chart-overlays.mdx b/docs/angular/src/content/jp/components/charts/features/chart-overlays.mdx index 79e592c845..a4a159d8d2 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-overlays.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-overlays.mdx @@ -19,7 +19,7 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; # Angular チャートのオーバーレイ -Angular `DataChart` を使用すると、 を使用して定義した単一の数値で水平線または垂直線を配置できます。特定のシリーズの平均値や中央値などのデータを視覚化するのに役立ちます。 +Angular を使用すると、 を使用して定義した単一の数値で水平線または垂直線を配置できます。特定のシリーズの平均値や中央値などのデータを視覚化するのに役立ちます。 ## Angular 値オーバーレイの例 @@ -39,9 +39,9 @@ Angular `DataChart` を使用すると、 appearance properties are inherited from `Series` and so and for example are available and work the same way they do with other types of series. + appearance properties are inherited from and so and for example are available and work the same way they do with other types of series. - 外観プロパティは、`Series` から継承されているため、例えば `Brush` と `Thickness` を使用でき、他のタイプのシリーズと同じように機能します。 + 外観プロパティは、 から継承されているため、例えば を使用でき、他のタイプのシリーズと同じように機能します。 ## Angular 値レイヤー @@ -49,17 +49,17 @@ Angular チャート コンポーネントは、値の線を使用して、最 および コンポーネントに を適用するには、チャート上で プロパティを設定します。このプロパティは、 列挙体のコレクションを受け取ります。複数の 列挙をチャートの コレクションに追加することで、同じチャート内で複数の値レイヤーを組み合わせたりできます。 -`DataChart` では、これは、チャートの `Series` コレクションに を追加し、次に プロパティを 列挙の 1 つに設定することによって行われます。これらの各列挙とその意味を以下に示します。 + では、これは、チャートの コレクションに を追加し、次に プロパティを 列挙の 1 つに設定することによって行われます。これらの各列挙とその意味を以下に示します。 -- `Auto`: 列挙体のデフォルト値モード。 -- `Average`: 複数の値の線を適用して、チャートにプロットされた各系列の平均値を呼び出します。 -- `GlobalAverage`: 単一の値線を適用して、チャート内のすべての系列値の平均を呼び出します。 -- `GlobalMaximum`: 単一の値線を適用して、チャート内のすべての系列値の絶対最大値を呼び出します。 -- `GlobalMinimum`: 単一の値線を適用して、チャート内のすべての系列値の絶対最小値を呼び出します。 -- `Maximum`: チャートにプロットされた各系列の最大値を示すために、複数の値線を適用する可能性があります。 -- `Minimum`: チャートにプロットされた各系列の最小値を示すために、複数の値線を適用する可能性があります。 +- : 列挙体のデフォルト値モード。 +- : 複数の値の線を適用して、チャートにプロットされた各系列の平均値を呼び出します。 +- : 単一の値線を適用して、チャート内のすべての系列値の平均を呼び出します。 +- : 単一の値線を適用して、チャート内のすべての系列値の絶対最大値を呼び出します。 +- : 単一の値線を適用して、チャート内のすべての系列値の絶対最小値を呼び出します。 +- : チャートにプロットされた各系列の最大値を示すために、複数の値線を適用する可能性があります。 +- : チャートにプロットされた各系列の最小値を示すために、複数の値線を適用する可能性があります。 - 要素を使用するときに特定のシリーズが考慮されないようにする場合は、レイヤーに プロパティを設定できます。これにより、レイヤーは定義したシリーズを強制的にターゲットにするようになります。単一の `DataChart` 内に必要な数の 要素を含めることができます。 + 要素を使用するときに特定のシリーズが考慮されないようにする場合は、レイヤーに プロパティを設定できます。これにより、レイヤーは定義したシリーズを強制的にターゲットにするようになります。単一の 内に必要な数の 要素を含めることができます。 次のサンプルは、 内のさまざまな の使用法を示しています。 @@ -76,14 +76,14 @@ Angular [株価チャート](../types/stock-chart.md)に組み込みのファイ Angular 、およびすべてのデータ注釈レイヤーは、DataChart コンポーネントのプロット領域内にカスタム オーバーレイ テキストを描画できます。このオーバーレイ テキストを使用すると、レイヤーとの関係において、x 軸上の重要なイベント (例: 企業の四半期決算) または y 軸上の重要な値に注釈を付けることができます。 -たとえば、`DataAnnotationSliceLayer`、 を使用してオーバーレイ テキストを表示できます。 +たとえば、 を使用してオーバーレイ テキストを表示できます。 ### オーバーレイ テキストのスタイル設定 -このコード例は、`DataAnnotationSliceLayer`、、および 上のオーバーレイ テキストのスタイルを設定およびカスタマイズする方法を示しています。 +このコード例は、、および 上のオーバーレイ テキストのスタイルを設定およびカスタマイズする方法を示しています。
diff --git a/docs/angular/src/content/jp/components/charts/features/chart-performance.mdx b/docs/angular/src/content/jp/components/charts/features/chart-performance.mdx index a10bbb5088..28e31ee969 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-performance.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-performance.mdx @@ -23,7 +23,7 @@ Angular チャートは、数百万のデータ ポイントを描画し、そ ## 高頻度 Angular チャート -高頻度シナリオでは、Angular チャートは、リアルタイムまたは指定されたミリ秒間隔で更新されるデータ項目を描画できます。タッチ デバイスでチャートを操作しているときでも、ラグ、画面のちらつき、表示の遅れは発生しません。次のサンプルは、高頻度シナリオでの `CategoryChart` を示しています。 +高頻度シナリオでは、Angular チャートは、リアルタイムまたは指定されたミリ秒間隔で更新されるデータ項目を描画できます。タッチ デバイスでチャートを操作しているときでも、ラグ、画面のちらつき、表示の遅れは発生しません。次のサンプルは、高頻度シナリオでの を示しています。 @@ -34,7 +34,7 @@ Angular チャートは、数百万のデータ ポイントを描画し、そ ## 大量のデータの Angular チャート -大量データのシナリオでは、Angular チャートは 100 万のデータ ポイントを描画できますが、エンドユーザーがチャートのコンテンツをズームイン/ズームアウトまたはナビゲートしようとしたときにチャートはスムーズなパフォーマンスを提供し続けます。次のサンプルは、大量データのシナリオでの `CategoryChart` を示しています。 +大量データのシナリオでは、Angular チャートは 100 万のデータ ポイントを描画できますが、エンドユーザーがチャートのコンテンツをズームイン/ズームアウトまたはナビゲートしようとしたときにチャートはスムーズなパフォーマンスを提供し続けます。次のサンプルは、大量データのシナリオでの を示しています。 @@ -47,7 +47,7 @@ Angular チャートは、数百万のデータ ポイントを描画し、そ ### データ サイズ -多数のデータ ポイント (10,000 以上など) を含むデータ ソースをプロットする必要がある場合は、その目的のために特別にデザインされた次のタイプのシリーズのいずれかで Angular `DataChart` を使用することをお勧めします。 +多数のデータ ポイント (10,000 以上など) を含むデータ ソースをプロットする必要がある場合は、その目的のために特別にデザインされた次のタイプのシリーズのいずれかで Angular を使用することをお勧めします。 - [カテゴリ ポイント チャート](../types/point-chart.md) や[散布マーカー チャート](../types/scatter-chart.md#angular-散布マーカー-チャート) の代わりに[散布高密度チャート](../types/scatter-chart.md#angular-散布高密度チャート) - [カテゴリ折れ線チャート](../types/line-chart.md#angular-折れ線チャートの例) や[散布折れ線チャート](../types/scatter-chart.md#angular-散布折れ線チャート) の代わりに[散布ポリライン チャート](../types/shape-chart.md#angular-散布ポリライン-チャート) @@ -92,7 +92,7 @@ export class MultiDataSources { ### データ フィルタリング -Angular `CategoryChart` および `FinancialChart` コントロールには、データを分析して一連のチャートを生成するデータ アダプターが組み込まれています。ただし、`IncludedProperties` と `ExcludedProperties` を使用して、実際に描画するデータ列のみをフィルタリングすると、より高速に動作します。例: +Angular および コントロールには、データを分析して一連のチャートを生成するデータ アダプターが組み込まれています。ただし、 を使用して、実際に描画するデータ列のみをフィルタリングすると、より高速に動作します。例: @@ -109,7 +109,7 @@ this.Chart.excludedProperties = [ "CHN", "FRN", "GER" ]; ### チャート タイプ -[折れ線チャート](../types/line-chart.md)などの単純なチャート タイプは、データ ポイント間のスプライン線の補間が複雑であるため、[スプライン チャート](../types/spline-chart.md)を使用するよりもパフォーマンスが速くなります。したがって、Angular `CategoryChart` の `CategoryChart.ChartType` プロパティまたは `FinancialChart` コントロールを使用して、描画が高速なチャートのタイプを選択する必要があります。または、Angular `DataChart` コントロールで、シリーズのタイプをより高速なシリーズに変更することもできます。 +[折れ線チャート](../types/line-chart.md)などの単純なチャート タイプは、データ ポイント間のスプライン線の補間が複雑であるため、[スプライン チャート](../types/spline-chart.md)を使用するよりもパフォーマンスが速くなります。したがって、Angular の `CategoryChart.ChartType` プロパティまたは コントロールを使用して、描画が高速なチャートのタイプを選択する必要があります。または、Angular コントロールで、シリーズのタイプをより高速なシリーズに変更することもできます。 次の表に、チャートの各グループで、パフォーマンスが速いものから遅いものの順にチャートのタイプを示します。 @@ -168,7 +168,7 @@ this.LineSeries.markerType = MarkerType.None; ### チャートの解像度 -`Resolution` プロパティをより大きな値に設定するとパフォーマンスは向上しますが、プロットされた系列の線のグラフィカルな忠実度は低下します。このようなわけで、忠実度が受け入れられなくなるまで値を大きくする可能性があります。 + プロパティをより大きな値に設定するとパフォーマンスは向上しますが、プロットされた系列の線のグラフィカルな忠実度は低下します。このようなわけで、忠実度が受け入れられなくなるまで値を大きくする可能性があります。 このコード スニペットは、Angular チャートの解像度を下げる方法を示しています。 @@ -198,10 +198,10 @@ this.LineSeries.Resolution = 10; データ ポイント間の時間間隔に基づくスペースが重要でない場合は、DateTime をサポートする x 軸の使用はお勧めしません。代わりに、順序/カテゴリ軸を使用する必要があります。これは、データを結合する方法がより効率的であるためです。また、順序/カテゴリ軸は、時間ベースの x 軸のようにデータのソートを実行しません。 -`CategoryChart` はすでに順序/カテゴリ軸を使用しているため、そのプロパティを変更する必要はありません。 + はすでに順序/カテゴリ軸を使用しているため、そのプロパティを変更する必要はありません。 -このコード スニペットは、`FinancialChart` および `DataChart` コントロールで x 軸を順序付け/カテゴリ化する方法を示しています。 +このコード スニペットは、 および コントロールで x 軸を順序付け/カテゴリ化する方法を示しています。 @@ -223,7 +223,7 @@ this.LineSeries.Resolution = 10; ### 軸の間隔 -デフォルトでは、Angular チャートは、データの範囲に基づいて `YAxisInterval` を自動的に計算します。したがって、軸のグリッド線と軸のラベルが多すぎないように、軸の間隔を特に小さい値に設定することは避けてください。また、多くの軸グリッド線または軸ラベルが必要ない場合は、`YAxisInterval` プロパティを自動的に計算された軸間隔よりも大きい値に増やすことを検討することをお勧めします。 +デフォルトでは、Angular チャートは、データの範囲に基づいて を自動的に計算します。したがって、軸のグリッド線と軸のラベルが多すぎないように、軸の間隔を特に小さい値に設定することは避けてください。また、多くの軸グリッド線または軸ラベルが必要ない場合は、 プロパティを自動的に計算された軸間隔よりも大きい値に増やすことを検討することをお勧めします。 チャートのパフォーマンスが低下するため、軸の副間隔を設定することはお勧めしません。 @@ -254,7 +254,7 @@ this.LineSeries.Resolution = 10; ### 軸スケール -`YAxisIsLogarithmic` プロパティを false に設定すると、パフォーマンスを向上させるために推奨されます。対数目盛で軸範囲と軸ラベルの値を計算するよりも操作が少なくて済むためです。 + プロパティを false に設定すると、パフォーマンスを向上させるために推奨されます。対数目盛で軸範囲と軸ラベルの値を計算するよりも操作が少なくて済むためです。 ### 軸ラベルの表示状態 @@ -287,7 +287,7 @@ this.LineSeries.Resolution = 10; ### 軸ラベルの省略形 -ただし、Angular チャートは、`YAxisAbbreviateLargeNumbers` が true に設定されている場合に、軸ラベルに表示される大きな数値 (10,000 以上など) の省略形をサポートします。代わりに、データ 項目の大きな値を公約数で除算して前処理し、`YAxisTitle` をデータ値の省略形に使用される約数を表す文字列に設定することをお勧めします。 +ただし、Angular チャートは、 が true に設定されている場合に、軸ラベルに表示される大きな数値 (10,000 以上など) の省略形をサポートします。代わりに、データ 項目の大きな値を公約数で除算して前処理し、 をデータ値の省略形に使用される約数を表す文字列に設定することをお勧めします。 このコード スニペットは、Angular チャートで軸のタイトルを設定する方法を示しています。 @@ -342,78 +342,78 @@ this.LineSeries.Resolution = 10; 追加の軸ビジュアル (軸タイトルなど) を有効にしたり、デフォルト値を変更したりすると、Angular チャートのパフォーマンスが低下する可能性があります。 -たとえば、`CategoryChart` または `FinancialChart` コントロールでこれらのプロパティを変更します。 +たとえば、 または コントロールでこれらのプロパティを変更します。 | 軸ビジュアル | X 軸プロパティ | Y 軸プロパティ | | ---------------------|-------------------|------------------- | -| すべての軸ビジュアル | `XAxisInterval`
`XAxisMinorInterval` | `YAxisInterval`
`YAxisMinorInterval` | -| 軸目盛 | `XAxisTickStroke`
`XAxisTickStrokeThickness`
`XAxisTickLength`
| `YAxisTickStroke`
`YAxisTickStrokeThickness`
`YAxisTickLength`
| -| 軸主グリッド線 | `XAxisMajorStroke`
`XAxisMajorStrokeThickness`
| `YAxisMajorStroke`
`YAxisMajorStrokeThickness`
| -| 軸の副グリッド線 | `XAxisMinorStroke`
`XAxisMinorStrokeThickness`
| `YAxisMinorStroke`
`YAxisMinorStrokeThickness`
| -| 軸主線 | `XAxisStroke`
`XAxisStrokeThickness`
| `YAxisStroke`
`YAxisStrokeThickness`
| -| 軸タイトル | `XAxisTitle`
`XAxisTitleAngle`
| `YAxisTitle`
`YAxisTitleAngle`
| -| 軸ストリップ | `XAxisStrip`
| `YAxisStrip`
| +| すべての軸ビジュアル |
|
| +| 軸目盛 |


|


| +| 軸主グリッド線 |

|

| +| 軸の副グリッド線 |

|

| +| 軸主線 |

|

| +| 軸タイトル |

|

| +| 軸ストリップ |
|
| -または、`DataChart` コントロールの `Axis` のプロパティを変更します。 +または、 コントロールの のプロパティを変更します。 | 軸ビジュアル | 軸プロパティ | | ---------------------|------------------- | | すべての軸ビジュアル | `Interval`、`MinorInterval` | -| 軸目盛 | `TickStroke` 、`TickStrokeThickness`、`TickLength` | -| 軸主グリッド線 | `MajorStroke`、`MajorStrokeThickness` | -| 軸の副グリッド線 | `MinorStroke`、`MinorStrokeThickness` | -| 軸主線 | `Stroke`、`StrokeThickness` | -| 軸タイトル | `Title`、`TitleAngle` | -| 軸ストリップ | `Strip` | +| 軸目盛 | | +| 軸主グリッド線 | | +| 軸の副グリッド線 | | +| 軸主線 | | +| 軸タイトル | 、`TitleAngle` | +| 軸ストリップ | | ## ファイナンシャル チャートのパフォーマンス -上記のパフォーマンスガイドラインに加えて、Angular `FinancialChart` コントロールには、パフォーマンスに影響を与える次の独自の機能があります。 +上記のパフォーマンスガイドラインに加えて、Angular コントロールには、パフォーマンスに影響を与える次の独自の機能があります。 ### Y 軸モード -`PercentChange` モードを使用するよりも必要な操作が少ないため、パフォーマンスを向上させるには、`YAxisMode` オプションを `Numeric` に設定することをお勧めします。 + モードを使用するよりも必要な操作が少ないため、パフォーマンスを向上させるには、 オプションを `Numeric` に設定することをお勧めします。 ### チャート ペイン -`IndicatorTypes` および `OverlayTypes` オプションを使用して複数のペインを設定した場合、パフォーマンスが低下する可能性があり、少数の財務指標および単一の財務オーバーレイを使用することをお勧めします。 + および オプションを使用して複数のペインを設定した場合、パフォーマンスが低下する可能性があり、少数の財務指標および単一の財務オーバーレイを使用することをお勧めします。 ### ズーム スライダー -`ZoomSliderType` オプションを `None` に設定すると、チャート パフォーマンスを向上し、その他のインジケーターおよびボリューム ペインのために垂直スペースを利用可能になります。 + オプションを に設定すると、チャート パフォーマンスを向上し、その他のインジケーターおよびボリューム ペインのために垂直スペースを利用可能になります。 ### ボリューム タイプ -`VolumeType` プロパティの設定はチャート パフォーマンスに次の影響を与える可能性があります: + プロパティの設定はチャート パフォーマンスに次の影響を与える可能性があります: -- `None` - ボリューム ペインが表示されないため、最も簡易です。 -- `Line` - 描画するのにより手間がかかるボリューム タイプです。データ ポイントの大量を描画するか、複数のデータ ソースをプロットする場合に使用することをお勧めします。 -- `Area` - `Line` ボリューム タイプより描画に手間がかかります。 -- `Column` - `Area` ボリューム タイプより描画に手間がかかります。1 つ ~ 3 つの株のボリューム データを描画する場合にお勧めします。 +- - ボリューム ペインが表示されないため、最も簡易です。 +- - 描画するのにより手間がかかるボリューム タイプです。データ ポイントの大量を描画するか、複数のデータ ソースをプロットする場合に使用することをお勧めします。 +- - ボリューム タイプより描画に手間がかかります。 +- - ボリューム タイプより描画に手間がかかります。1 つ ~ 3 つの株のボリューム データを描画する場合にお勧めします。 ## データ チャートのパフォーマンス -一般的なパフォーマンス ガイドラインに加えて、Angular `DataChart` コントロールには、パフォーマンスに影響を与える次の固有の機能があります。 +一般的なパフォーマンス ガイドラインに加えて、Angular コントロールには、パフォーマンスに影響を与える次の固有の機能があります。 ### 軸コレクション -`DataChart` コントロールの `Axes` コレクションに追加する軸が多すぎると、チャートのパフォーマンスが低下するため、シリーズ間で[軸の共有](chart-axis-layouts.md#軸共有の例)をお勧めします。 + コントロールの コレクションに追加する軸が多すぎると、チャートのパフォーマンスが低下するため、シリーズ間で[軸の共有](chart-axis-layouts.md#軸共有の例)をお勧めします。 ### シリーズ コレクション -また、Angular `DataChart` コントロールの `Series` コレクションに多くのシリーズを追加すると、各シリーズに独自の描画キャンバスがあるため、描画にオーバーヘッドが追加されます。これは、データ チャートに 10 を超えるシリーズがある場合に特に重要です。複数のデータ ソースを組み合わせてフラット化したデータ ソースにし ([データ構造](#データ構造)セクションを参照)、次のシリーズの条件付き書式設定機能を使用することをお勧めします。 +また、Angular コントロールの コレクションに多くのシリーズを追加すると、各シリーズに独自の描画キャンバスがあるため、描画にオーバーヘッドが追加されます。これは、データ チャートに 10 を超えるシリーズがある場合に特に重要です。複数のデータ ソースを組み合わせてフラット化したデータ ソースにし ([データ構造](#データ構造)セクションを参照)、次のシリーズの条件付き書式設定機能を使用することをお勧めします。 | パフォーマンスが低下するシナリオ | 条件付き書式設定を使用したより高速なシナリオ | | ----------------------------|---------------------------------------- | -| `LineSeries` の 10 以上 | 単一の `ScatterLineSeries` | -| `LineSeries` の 20 以上 | 単一の `ScatterPolylineSeries` | -| `ScatterLineSeries` の 10 以上 | 単一の `ScatterPolylineSeries` | -| `PointSeries` の 10 以上 | 単一の `ScatterSeries` | -| `PointSeries` の 20 以上 | 単一の `HighDensityScatterSeries` | -| `ScatterSeries` の 20 以上 | 単一の `HighDensityScatterSeries` | -| `AreaSeries` の 10 以上 | 単一の `ScatterPolygonSeries` | -| `ColumnSeries` の 10 以上 | 単一の `ScatterPolygonSeries` | +| の 10 以上 | 単一の | +| の 20 以上 | 単一の | +| の 10 以上 | 単一の | +| の 10 以上 | 単一の | +| の 20 以上 | 単一の | +| の 20 以上 | 単一の | +| の 10 以上 | 単一の | +| の 10 以上 | 単一の | ## その他のリソース diff --git a/docs/angular/src/content/jp/components/charts/features/chart-titles.mdx b/docs/angular/src/content/jp/components/charts/features/chart-titles.mdx index f83a7e6f07..7c1c084f3b 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-titles.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-titles.mdx @@ -30,20 +30,20 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; | プロパティ名 | プロパティ タイプ | 説明 | | ----------------------|------------------|------------ | | `ChartTitle` | 文字列 | タイトルのテキスト コンテンツ | -| `TitleTextColor` | 文字列 | タイトルのテキスト色 | -| `TitleAlignment` | HorizontalAlignment | タイトルの水平方向の配置 | -| `TitleTextStyle` | 文字列 | タイトルのフォント スタイル。例えば、Italic Bold 8pt Times New Roman | -| `TitleTopMargin` | 数 | タイトルの上マージン。 | -| `TitleLeftMargin` | 数 | タイトルの左マージン。 | -| `TitleRightMargin` | 数 | タイトルの右マージン。 | -| `TitleBottomMargin` | 数 | タイトルの下マージン。 | -| `Subtitle` | 文字列 | タイトルのテキスト コンテンツ | -| `SubtitleTextColor` | 文字列 | タイトルのテキスト色 | -| `SubtitleAlignment` | HorizontalAlignment | タイトルの水平方向の配置 | -| `SubtitleTextStyle` | 文字列 | タイトルのフォント スタイル。例えば、Italic Bold 8pt Times New Roman | -| `SubtitleTopMargin` | 数 | タイトルの上マージン。 | -| `SubtitleLeftMargin` | 数 | タイトルの左マージン。 | -| `SubtitleRightMargin` | 数 | タイトルの右マージン。 | -| `SubtitleBottomMargin`| 数 | タイトルの下マージン。 | +| | 文字列 | タイトルのテキスト色 | +| | HorizontalAlignment | タイトルの水平方向の配置 | +| | 文字列 | タイトルのフォント スタイル。例えば、Italic Bold 8pt Times New Roman | +| | 数 | タイトルの上マージン。 | +| | 数 | タイトルの左マージン。 | +| | 数 | タイトルの右マージン。 | +| | 数 | タイトルの下マージン。 | +| | 文字列 | タイトルのテキスト コンテンツ | +| | 文字列 | タイトルのテキスト色 | +| | HorizontalAlignment | タイトルの水平方向の配置 | +| | 文字列 | タイトルのフォント スタイル。例えば、Italic Bold 8pt Times New Roman | +| | 数 | タイトルの上マージン。 | +| | 数 | タイトルの左マージン。 | +| | 数 | タイトルの右マージン。 | +| | 数 | タイトルの下マージン。 | diff --git a/docs/angular/src/content/jp/components/charts/features/chart-tooltips.mdx b/docs/angular/src/content/jp/components/charts/features/chart-tooltips.mdx index 78f581b321..d31b960d9f 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-tooltips.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-tooltips.mdx @@ -14,7 +14,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular チャート ツールチップ -Angular チャートでは、ツールチップはバインドされたデータに関する詳細を提供し、エンドユーザーがデータ ポイントにカーソルを合わせるとポップアップで表示されます。ツールチップは、、および `DataChart` コンポーネントでサポートされています。 +Angular チャートでは、ツールチップはバインドされたデータに関する詳細を提供し、エンドユーザーがデータ ポイントにカーソルを合わせるとポップアップで表示されます。ツールチップは、、および コンポーネントでサポートされています。 ## Angular チャート ツールチップのタイプ @@ -31,10 +31,10 @@ Angular チャートでは、ツールチップはバインドされたデータ | プロパティの値 | 説明 | | -------------------|---------------- | -| `Default` ツールチップ | ツールチップは、ポインタがその上に位置されると、単一の項目のツールチップを表示します。 | -| `Data` ツールチップ | チャートのすべてのシリーズのデータ ツールチップを表示します。 | -| `Item` ツールチップ | ツールチップは、ポインタが位置されているカテゴリの各データ項目のツールチップを表示します。 | -| `Category` ツールチップ | ツールチップはポインターがデータ ポイント上に配置されたときにすべてのデータ ポイントに対してツールチップを表示できます。 | +| ツールチップ | ツールチップは、ポインタがその上に位置されると、単一の項目のツールチップを表示します。 | +| ツールチップ | チャートのすべてのシリーズのデータ ツールチップを表示します。 | +| ツールチップ | ツールチップは、ポインタが位置されているカテゴリの各データ項目のツールチップを表示します。 | +| ツールチップ | ツールチップはポインターがデータ ポイント上に配置されたときにすべてのデータ ポイントに対してツールチップを表示できます。 |
diff --git a/docs/angular/src/content/jp/components/charts/features/chart-trendlines.mdx b/docs/angular/src/content/jp/components/charts/features/chart-trendlines.mdx index bf59b6e1c3..24bb5f0a29 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-trendlines.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-trendlines.mdx @@ -18,7 +18,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular チャート トレンドライン -Ignite UI for Angular チャートでは、トレンドラインはトレンドの識別やデータ内のパターンの検索に役立ちます。トレンドラインは、常にチャートにバインドされたデータ ポイントの前に描画されます。積層シリーズ、シェイプ シリーズ、および範囲シリーズを除き、これらは 、および `DataChart` (積層型シリーズ、シェイプ シリーズ、範囲シリーズを除く) でサポートされています。 +Ignite UI for Angular チャートでは、トレンドラインはトレンドの識別やデータ内のパターンの検索に役立ちます。トレンドラインは、常にチャートにバインドされたデータ ポイントの前に描画されます。積層シリーズ、シェイプ シリーズ、および範囲シリーズを除き、これらは 、および (積層型シリーズ、シェイプ シリーズ、範囲シリーズを除く) でサポートされています。 トレンドラインはデフォルトでオフになっていますが、 プロパティを設定することで有効にできます。また、ブラシ、期間、太さなど、トレンドラインの複数の外観プロパティを変更できます。 @@ -36,7 +36,7 @@ Ignite UI for Angular チャートでは、トレンドラインはトレンド ## Angular チャート トレンドラインのダッシュ配列の例 -次のサンプルは、 プロパティを介して適用された **QuarticFit** 破線トレンドラインを持つ `FinancialPriceSeries` を示す `DataChart` を示しています。 +次のサンプルは、 プロパティを介して適用された **QuarticFit** 破線トレンドラインを持つ を示す を示しています。 @@ -46,7 +46,7 @@ Ignite UI for Angular チャートでは、トレンドラインはトレンド ## Angular チャートト レンドライン レイヤー - は、ターゲット シリーズに対して単一のトレンドライン タイプを表示するように設計されたシリーズ タイプです。これと既存のシリーズ タイプの既存のトレンド ライン機能との違いは、 はシリーズ タイプであるため、チャートの `Series` コレクションに複数のトレンド ラインを追加して、同じシリーズに複数のトレンド ラインを添付できることです。また、これまでできなかったトレンドラインを凡例に表示する ことも可能です。 + は、ターゲット シリーズに対して単一のトレンドライン タイプを表示するように設計されたシリーズ タイプです。これと既存のシリーズ タイプの既存のトレンド ライン機能との違いは、 はシリーズ タイプであるため、チャートの コレクションに複数のトレンド ラインを追加して、同じシリーズに複数のトレンド ラインを添付できることです。また、これまでできなかったトレンドラインを凡例に表示する ことも可能です。 ## トレンドライン レイヤーの使用 @@ -58,7 +58,7 @@ Ignite UI for Angular チャートでは、トレンドラインはトレンド デフォルトでは、 と同じ色の破線で描画されます。これは、 のさまざまなスタイル設定プロパティを使用して構成できます。 -描画されるトレンドラインの色を変更するには、 プロパティを設定します。あるいは、 プロパティを **true** に設定することもできます。これにより、 がチャートの `Series` コレクションに配置されているインデックスに基づいて、チャートの `Brushes` パレットからブラシが取得されます。 +描画されるトレンドラインの色を変更するには、 プロパティを設定します。あるいは、 プロパティを **true** に設定することもできます。これにより、 がチャートの コレクションに配置されているインデックスに基づいて、チャートの パレットからブラシが取得されます。 の表示方法は、 プロパティと プロパティを使用して変更することもできます。 は、-1.0 から 1.0 の範囲の値を受け取り、「Shift」 で終わるオプションに適用する 「シフト」 の量を決定します。 diff --git a/docs/angular/src/content/jp/components/charts/features/chart-user-annotations.mdx b/docs/angular/src/content/jp/components/charts/features/chart-user-annotations.mdx index 07744cd6cd..9dc9005b2b 100644 --- a/docs/angular/src/content/jp/components/charts/features/chart-user-annotations.mdx +++ b/docs/angular/src/content/jp/components/charts/features/chart-user-annotations.mdx @@ -10,18 +10,18 @@ _language: ja import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro'; import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; import { Image } from 'astro:assets'; import dataChartUserAnnotationCreate from '@xplat-images/charts/data-chart-user-annotation-create.gif'; import dataChartUserAnnotationDelete from '@xplat-images/charts/data-chart-user-annotation-delete.gif'; +import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; # Angular チャートのユーザー注釈レイヤー -Ignite UI for Angular では、ユーザー注釈機能を使用して、実行時に `DataChart` にスライス注釈、ストリップ注釈、ポイント注釈を追加できます。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりするなど、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 +Ignite UI for Angular では、ユーザー注釈機能を使用して、実行時に にスライス注釈、ストリップ注釈、ポイント注釈を追加できます。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりするなど、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 -これは、`Toolbar` のデフォルトのツールと統合されています。このトピックでは、`Toolbar` を使用してチャートのプロット領域にユーザー注釈を追加する方法と、これらのユーザー注釈をプログラムから追加する方法を、例と共に解説します。 +これは、 のデフォルトのツールと統合されています。このトピックでは、 を使用してチャートのプロット領域にユーザー注釈を追加する方法と、これらのユーザー注釈をプログラムから追加する方法を、例と共に解説します。 @@ -32,9 +32,9 @@ Ignite UI for Angular では、ユーザー注釈機能を使用して、実行 ## Toolbar でユーザー注釈を使用する -`Toolbar` には、「Annotate Chart」 と 「Delete Note」 という 2 つのツールを含む Annotations メニュー項目が用意されています。このメニュー項目を表示するには、対象のチャートで プロパティを **true** に設定する必要があります。 + には、「Annotate Chart」 と 「Delete Note」 という 2 つのツールを含む Annotations メニュー項目が用意されています。このメニュー項目を表示するには、対象のチャートで プロパティを **true** に設定する必要があります。 -開いた後に表示される 「Annotate Chart」 オプションを使用すると、`DataChart` のプロット領域に注釈を付けることができます。追加できる注釈はスライス注釈、ストリップ注釈、ポイント注釈です。X 軸または Y 軸のラベルをクリックすると、スライス注釈を追加できます。プロット領域をクリックしてドラッグすることで、ストリップ注釈を追加できます。また、チャートにプロットされたシリーズ内のポイントをクリックして、ポイント注釈を追加することもできます。 +開いた後に表示される 「Annotate Chart」 オプションを使用すると、 のプロット領域に注釈を付けることができます。追加できる注釈はスライス注釈、ストリップ注釈、ポイント注釈です。X 軸または Y 軸のラベルをクリックすると、スライス注釈を追加できます。プロット領域をクリックしてドラッグすることで、ストリップ注釈を追加できます。また、チャートにプロットされたシリーズ内のポイントをクリックして、ポイント注釈を追加することもできます。 Angular user-annotation-create @@ -42,34 +42,34 @@ Ignite UI for Angular では、ユーザー注釈機能を使用して、実行 Angular user-annotation-delete -`Toolbar` を使用してこれらのユーザー注釈を追加すると、`DataChart` は `UserAnnotationInformationRequested` イベントを発生させ、そこでユーザー注釈に関する追加情報を提供できます。このイベント引数には `AnnotationInfo` プロパティがあり、追加される注釈のさまざまな要素を構成可能な オブジェクトを返します。 + を使用してこれらのユーザー注釈を追加すると、 は `UserAnnotationInformationRequested` イベントを発生させ、そこでユーザー注釈に関する追加情報を提供できます。このイベント引数には `AnnotationInfo` プロパティがあり、追加される注釈のさまざまな要素を構成可能な オブジェクトを返します。 以下の表は、 で構成可能なさまざまなプロパティの詳細を示しています。 | プロパティ | タイプ | 説明 | |------------|---------|-------------| -|`AnnotationData`|`string`|このプロパティは、ユーザー注釈に追加情報を提供するためのものです。このプロパティは、`UserAnnotationToolTipContentUpdating` イベントと組み合わせて使用され、注釈のツールチップに追加情報を表示するよう設計されています。| -|`AnnotationId`|`string`|この読み取り専用プロパティは、ユーザー注釈の一意の文字列 ID を返します。| -|`BadgeColor`|`string`|このプロパティは、ユーザー注釈のバッジに使用する色を取得または設定します。| -|`BadgeImageUri`|`string`|このプロパティは、ユーザー注釈のバッジに使用する画像へのパスを取得または設定します。| -|`DialogSuggestedXLocation`|`double`|このプロパティは、ユーザー注釈が追加された位置に基づいて、ダイアログを表示する推奨 X 座標を取得します。| -|`DialogSuggestedYLocation`|`double`|このプロパティは、ユーザー注釈が追加された位置に基づいて、ダイアログを表示する推奨 Y 座標を取得します。| -|`Label`|`string`|このプロパティは、ユーザー注釈に表示するラベルを取得または設定します。| -|`MainColor`|`string`|このプロパティは、ユーザー注釈の背景を塗りつぶすために使用する色を取得または設定します。| +||`string`|このプロパティは、ユーザー注釈に追加情報を提供するためのものです。このプロパティは、`UserAnnotationToolTipContentUpdating` イベントと組み合わせて使用され、注釈のツールチップに追加情報を表示するよう設計されています。| +||`string`|この読み取り専用プロパティは、ユーザー注釈の一意の文字列 ID を返します。| +||`string`|このプロパティは、ユーザー注釈のバッジに使用する色を取得または設定します。| +||`string`|このプロパティは、ユーザー注釈のバッジに使用する画像へのパスを取得または設定します。| +||`double`|このプロパティは、ユーザー注釈が追加された位置に基づいて、ダイアログを表示する推奨 X 座標を取得します。| +||`double`|このプロパティは、ユーザー注釈が追加された位置に基づいて、ダイアログを表示する推奨 Y 座標を取得します。| +||`string`|このプロパティは、ユーザー注釈に表示するラベルを取得または設定します。| +||`string`|このプロパティは、ユーザー注釈の背景を塗りつぶすために使用する色を取得または設定します。| -`UserAnnotationInformationRequested` イベントで注釈情報を更新した後、`DataChart` の `FinishAnnotationFlow` メソッドを呼び出して注釈の作成を完了し、変更を確定する必要があります。あるいは、`CancelAnnotationFlow` を呼び出して注釈の `AnnotationId` を渡すことで注釈の作成をキャンセルすることもできます。注釈の `AnnotationId` は、前述のように、`UserAnnotationInformationRequested` イベントの引数の AnnotationInfo パラメーターから取得できます。これにより、プロット領域から注釈が削除されます。 +`UserAnnotationInformationRequested` イベントで注釈情報を更新した後、 メソッドを呼び出して注釈の作成を完了し、変更を確定する必要があります。あるいは、 を呼び出して注釈の を渡すことで注釈の作成をキャンセルすることもできます。注釈の は、前述のように、`UserAnnotationInformationRequested` イベントの引数の AnnotationInfo パラメーターから取得できます。これにより、プロット領域から注釈が削除されます。 ## ユーザー注釈をプログラムで使用する - をプログラムで使用する場合、`DataChart` に対して 2 つのメソッドを呼び出し、ユーザー注釈の追加または削除を行えるモードに切り替えることができます。これらのメソッドは `StartCreatingAnnotation` と `StartDeletingAnnotation` です。 + をプログラムで使用する場合、 に対して 2 つのメソッドを呼び出し、ユーザー注釈の追加または削除を行えるモードに切り替えることができます。これらのメソッドは です。 -`StartCreatingAnnotation` を呼び出した後は、X または Y 軸のラベルをクリックしてスライス注釈を追加したり、プロット領域をクリックしドラッグしてからマウスボタンを離してストリップ注釈を追加したり、チャート内のシリーズ上のデータ ポイントをクリックしてポイント注釈を追加したりできます。 + を呼び出した後は、X または Y 軸のラベルをクリックしてスライス注釈を追加したり、プロット領域をクリックしドラッグしてからマウスボタンを離してストリップ注釈を追加したり、チャート内のシリーズ上のデータ ポイントをクリックしてポイント注釈を追加したりできます。 これらのユーザー注釈のいずれかを追加すると、`UserAnnotationInformationRequested` イベントが発生し、ユーザー注釈に関する詳細情報を提供できます。このイベント引数には `AnnotationInfo` プロパティがあり、追加される注釈のさまざまな要素を構成可能な オブジェクトを返します。 -`UserAnnotationInformationRequested` イベントで注釈情報を更新した後、`DataChart` の `FinishAnnotationFlow` メソッドを呼び出して注釈の作成を完了し、変更を確定する必要があります。あるいは、`CancelAnnotationFlow` を呼び出して注釈の `AnnotationId` を渡すことで注釈の作成をキャンセルすることもできます。注釈の `AnnotationId` は、前述のように、`UserAnnotationInformationRequested` イベントの引数の AnnotationInfo パラメーターから取得できます。これにより、プロット領域から注釈が削除されます。 +`UserAnnotationInformationRequested` イベントで注釈情報を更新した後、 メソッドを呼び出して注釈の作成を完了し、変更を確定する必要があります。あるいは、 を呼び出して注釈の を渡すことで注釈の作成をキャンセルすることもできます。注釈の は、前述のように、`UserAnnotationInformationRequested` イベントの引数の AnnotationInfo パラメーターから取得できます。これにより、プロット領域から注釈が削除されます。 -ユーザー注釈がチャートに追加されると、`Series` コレクションに として表示されます。 には、プロット領域に追加された注釈の種類に応じて 、および 要素を保存できる `Annotations` コレクションがあります。 +ユーザー注釈がチャートに追加されると、 コレクションに として表示されます。 には、プロット領域に追加された注釈の種類に応じて 、および 要素を保存できる コレクションがあります。 ## UserAnnotationToolTip diff --git a/docs/angular/src/content/jp/components/charts/types/area-chart.mdx b/docs/angular/src/content/jp/components/charts/types/area-chart.mdx index 1d47413c53..3e385d3fcd 100644 --- a/docs/angular/src/content/jp/components/charts/types/area-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/area-chart.mdx @@ -60,7 +60,7 @@ Ignite UI for Angular エリア チャートは、線の下の領域が塗りつ ## 単一シリーズの Angular エリア チャート -Angular エリア チャートは、生産される再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Area` 値に設定します。 +Angular エリア チャートは、生産される再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを 値に設定します。 @@ -91,11 +91,11 @@ Angular エリア チャートは、生産される再生可能電力の量な ## 高度なタイプのエリア チャート -次のセクションでは、簡略化された API を使用した コントロールの代わりに `DataChart` コントロールを使用して作成できる、より高度なタイプの Angular エリア チャートについて説明します。 +次のセクションでは、簡略化された API を使用した コントロールの代わりに コントロールを使用して作成できる、より高度なタイプの Angular エリア チャートについて説明します。 ## Angular ステップ エリア チャート -Ignite UI for Angular ステップ エリア チャートはカテゴリ チャートのグループに属し、連続する垂直線と水平線で接続されたポイントのコレクションを使用して描画され、線の下の領域は塗りつぶされます。値は y 軸に表示され、カテゴリが表示されます x 軸上。ステップ エリア チャートは、一定期間の変化量を強調するか、複数の項目を比較します。 コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `StepArea` 値に設定します。 +Ignite UI for Angular ステップ エリア チャートはカテゴリ チャートのグループに属し、連続する垂直線と水平線で接続されたポイントのコレクションを使用して描画され、線の下の領域は塗りつぶされます。値は y 軸に表示され、カテゴリが表示されます x 軸上。ステップ エリア チャートは、一定期間の変化量を強調するか、複数の項目を比較します。 コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを 値に設定します。 @@ -105,11 +105,11 @@ Ignite UI for Angular ステップ エリア チャートはカテゴリ チャ
-次のセクションでは、簡略化された API を使用した コントロールの代わりに `DataChart` コントロールを使用して作成できる、より高度なタイプの Angular エリア チャートについて説明します。 +次のセクションでは、簡略化された API を使用した コントロールの代わりに コントロールを使用して作成できる、より高度なタイプの Angular エリア チャートについて説明します。 ## Angular 範囲エリア チャート -Ignite UI for Angular 範囲エリア チャートは、時間の経過とともに 2 つの値の範囲としてエリアを表示します。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular 範囲エリア チャートは、時間の経過とともに 2 つの値の範囲としてエリアを表示します。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -120,7 +120,7 @@ Ignite UI for Angular 範囲エリア チャートは、時間の経過ととも ## Angular 積層型エリア チャート -Ignite UI for Angular 積層型エリア チャートは、線分で接続されたポイントのコレクションを使用して描画され、線の下のエリアが塗りつぶされ、互いの上に積層されます。積層型エリア チャートは、エリア チャートとすべて同じ要件に従いますが、唯一の違いは、網掛けエリアが互いに積層されていることです。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular 積層型エリア チャートは、線分で接続されたポイントのコレクションを使用して描画され、線の下のエリアが塗りつぶされ、互いの上に積層されます。積層型エリア チャートは、エリア チャートとすべて同じ要件に従いますが、唯一の違いは、網掛けエリアが互いに積層されていることです。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -131,7 +131,7 @@ Ignite UI for Angular 積層型エリア チャートは、線分で接続され ## Angular 積層型 100% エリア チャート -Ignite UI for Angular 積層型 100% エリア チャートを使用して、生産元に関連する国のエネルギー消費量など、時間の経過とともに変化する全体の一部を表します。このような場合、積層されたすべての要素を均等に表すことをお勧めします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular 積層型 100% エリア チャートを使用して、生産元に関連する国のエネルギー消費量など、時間の経過とともに変化する全体の一部を表します。このような場合、積層されたすべての要素を均等に表すことをお勧めします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -142,7 +142,7 @@ Ignite UI for Angular 積層型 100% エリア チャートを使用して、生 ## Angular 積層型スプライン エリア チャート -Ignite UI for Angular 積層型スプライン エリア チャートは、曲線スプライン セグメントで接続されたポイントのコレクションを使用して描画され、曲線スプラインの下の領域が塗りつぶされ、互いに重ねて表示されます。積層型スプライン エリア チャートは、エリア チャートとすべて同じ要件に従いますが、唯一の違いは、網掛けエリアが互いに積み重なっていることです。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular 積層型スプライン エリア チャートは、曲線スプライン セグメントで接続されたポイントのコレクションを使用して描画され、曲線スプラインの下の領域が塗りつぶされ、互いに重ねて表示されます。積層型スプライン エリア チャートは、エリア チャートとすべて同じ要件に従いますが、唯一の違いは、網掛けエリアが互いに積み重なっていることです。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -154,7 +154,7 @@ Ignite UI for Angular 積層型スプライン エリア チャートは、曲 ## Angular 積層型 100% スプライン エリア チャート -Ignite UI for Angular 積層型 100% スプライン エリア チャートは、y 軸の値の処理を除いて、すべての点で積層型スプラインエリア チャートと同じです。データを直接表現するのでなく、積層型 100 スプライン エリア チャートは、特定のデータ ポイント内のすべての値の合計の割合でデータを表します。チャートは、時間の経過とともに変化する全体の一部を表す場合があります。たとえば、生産元に関連する国のエネルギー消費量。このような場合、積層されたすべての要素を均等に表すことをお勧めします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular 積層型 100% スプライン エリア チャートは、y 軸の値の処理を除いて、すべての点で積層型スプラインエリア チャートと同じです。データを直接表現するのでなく、積層型 100 スプライン エリア チャートは、特定のデータ ポイント内のすべての値の合計の割合でデータを表します。チャートは、時間の経過とともに変化する全体の一部を表す場合があります。たとえば、生産元に関連する国のエネルギー消費量。このような場合、積層されたすべての要素を均等に表すことをお勧めします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -165,7 +165,7 @@ Ignite UI for Angular 積層型 100% スプライン エリア チャートは ## Angular ラジアル エリア チャート -Ignite UI for Angular ラジアル エリア チャートは[ラジアル チャート](radial-chart.md)のグループに属し、データ ポイントを接続する直線のコレクションによってバインドされた塗りつぶされたポリゴンの形状を持っています。このグラフ チャートは、エリア チャートと同じデータ プロットの概念を使用しますが、データ ポイントを水平方向に引き伸ばすのではなく、円形の軸の周りにラップします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular ラジアル エリア チャートは[ラジアル チャート](radial-chart.md)のグループに属し、データ ポイントを接続する直線のコレクションによってバインドされた塗りつぶされたポリゴンの形状を持っています。このグラフ チャートは、エリア チャートと同じデータ プロットの概念を使用しますが、データ ポイントを水平方向に引き伸ばすのではなく、円形の軸の周りにラップします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -176,7 +176,7 @@ Ignite UI for Angular ラジアル エリア チャートは[ラジアル チャ ## Angular 極座標型エリア チャート -Ignite UI for Angular 極座標エリア チャートは[極座標チャート](polar-chart.md)のグループに属し、塗りつぶされたポリゴンの形状を持ちます。頂点または角はデータ ポイントの極座標 (角度/半径) に配置され、直線で接続されてから、接続されたポイントによって表された領域を塗りつぶします。極座標エリア チャートは、散布マーカー チャートと同じデータ プロットの概念を使用しますが、水平線に沿って塗りつぶされたポイントと領域を引き伸ばすのではなく、代わりに円の周りにポイントをラップし、描画された領域を塗りつぶします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular 極座標エリア チャートは[極座標チャート](polar-chart.md)のグループに属し、塗りつぶされたポリゴンの形状を持ちます。頂点または角はデータ ポイントの極座標 (角度/半径) に配置され、直線で接続されてから、接続されたポイントによって表された領域を塗りつぶします。極座標エリア チャートは、散布マーカー チャートと同じデータ プロットの概念を使用しますが、水平線に沿って塗りつぶされたポイントと領域を引き伸ばすのではなく、代わりに円の周りにポイントをラップし、描画された領域を塗りつぶします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -187,7 +187,7 @@ Ignite UI for Angular 極座標エリア チャートは[極座標チャート]( ## Angular 極座標型スプライン エリア チャート -Angular 極座標スプライン エリア チャートは[極座標チャート](polar-chart.md)のグループに属し、塗りつぶされたポリゴンの形状を持ちます。頂点または角はデータ ポイントの極座標 (角度/半径) に配置され、曲線スプラインで接続されてから接続されたポイントで表された領域を塗りつぶします。極座標スプライン エリア チャートは、散布マーカー チャートと同じデータ プロットの概念を使用しますが、水平線に沿って塗りつぶされたポイントと領域を引き伸ばすのではなく、代わりに円の周りにポイントをラップして、描画された領域を塗りつぶします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Angular 極座標スプライン エリア チャートは[極座標チャート](polar-chart.md)のグループに属し、塗りつぶされたポリゴンの形状を持ちます。頂点または角はデータ ポイントの極座標 (角度/半径) に配置され、曲線スプラインで接続されてから接続されたポイントで表された領域を塗りつぶします。極座標スプライン エリア チャートは、散布マーカー チャートと同じデータ プロットの概念を使用しますが、水平線に沿って塗りつぶされたポイントと領域を引き伸ばすのではなく、代わりに円の周りにポイントをラップして、描画された領域を塗りつぶします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -214,16 +214,16 @@ Angular 極座標スプライン エリア チャートは[極座標チャート | チャート タイプ | コントロール名 | API メンバー | | -------------------------|--------------------|----------------------- | -| エリア | `CategoryChart` | `CategoryChart.ChartType` = `Area` | -| ステップ エリア | `CategoryChart` | `CategoryChart.ChartType` = `StepArea` | -| 範囲エリア | `DataChart` | `RangeAreaSeries` | -| ラジアル エリア | `DataChart` | `RadialAreaSeries` | -| 極座標エリア | `DataChart` | `PolarAreaSeries` | -| 極座標スプライン エリア | `DataChart` | `PolarSplineAreaSeries` | -| 積層型エリア | `DataChart` | `StackedAreaSeries` | -| 積層型スプライン エリア | `DataChart` | `StackedSplineAreaSeries` | -| 積層型 100% エリア | `DataChart` | `Stacked100AreaSeries` | -| 積層型 100% スプライン エリア | `DataChart` | `Stacked100SplineAreaSeries` | +| エリア | | `CategoryChart.ChartType` = | +| ステップ エリア | | `CategoryChart.ChartType` = | +| 範囲エリア | | | +| ラジアル エリア | | | +| 極座標エリア | | | +| 極座標スプライン エリア | | | +| 積層型エリア | | | +| 積層型スプライン エリア | | | +| 積層型 100% エリア | | | +| 積層型 100% スプライン エリア | | | ## API References diff --git a/docs/angular/src/content/jp/components/charts/types/bar-chart.mdx b/docs/angular/src/content/jp/components/charts/types/bar-chart.mdx index 1123310725..989450b2c7 100644 --- a/docs/angular/src/content/jp/components/charts/types/bar-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/bar-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular 棒チャート、棒グラフ、または水平棒チャ ## Angular 棒チャートの例 -次の例に示すように、データ ソースを複数の にバインドすることにより、`DataChart` コントロールに Angular 棒チャートを作成できます。 +次の例に示すように、データ ソースを複数の にバインドすることにより、 コントロールに Angular 棒チャートを作成できます。 @@ -78,7 +78,7 @@ Angular 棒チャートには、データまたはデータを使用して正し ## 単一シリーズの Angular 棒チャート -棒チャートは、カテゴリ シリーズのグループに属し、チャートの左から右へデータ ポイント値に向かって延びる四角形のコレクションを使用して描画されます。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +棒チャートは、カテゴリ シリーズのグループに属し、チャートの左から右へデータ ポイント値に向かって延びる四角形のコレクションを使用して描画されます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -89,7 +89,7 @@ Angular 棒チャートには、データまたはデータを使用して正し ## 複数シリーズの Angular 棒チャート -棒チャートは、比較のためにカテゴリごとに複数の棒を描画できます。この例では、棒チャートは人気のある映画フランチャイズの興行収益を比較しています。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを複数の にバインドします: +棒チャートは、比較のためにカテゴリごとに複数の棒を描画できます。この例では、棒チャートは人気のある映画フランチャイズの興行収益を比較しています。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを複数の にバインドします: @@ -98,7 +98,7 @@ Angular 棒チャートには、データまたはデータを使用して正し ## Angular 棒チャートのスタイル設定 -棒チャートのスタイルを設定でき、パーセント比較を示すために各棒に[注釈値](../features/chart-annotations.md)を使用できます。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドし、 を追加します。 +棒チャートのスタイルを設定でき、パーセント比較を示すために各棒に[注釈値](../features/chart-annotations.md)を使用できます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドし、 を追加します。 @@ -113,7 +113,7 @@ Angular 棒チャートには、データまたはデータを使用して正し 積層型棒チャートは、データを表すデータ ポイントが水平方向に隣り合って積み重ねられ、データを視覚的にグループ化するという点で、棒チャートとは異なります。各積層は正の値と負の値の両方を含みます。すべての正の値は X 軸の正の側にグループ化され、すべての負の値は X 軸の負の側にグループ化されます。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -126,7 +126,7 @@ Angular 棒チャートには、データまたはデータを使用して正し Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベル) の値の処理を除いて、すべての点で Angular 積層型棒チャートと同じです。データを直接表現するのでなく、積層型棒チャートは、データ ポイント内のすべての値の合計の割合でデータを表します。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: diff --git a/docs/angular/src/content/jp/components/charts/types/bubble-chart.mdx b/docs/angular/src/content/jp/components/charts/types/bubble-chart.mdx index 545ec327e8..1668379ab1 100644 --- a/docs/angular/src/content/jp/components/charts/types/bubble-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/bubble-chart.mdx @@ -21,7 +21,7 @@ Ignite UI for Angular バブル チャートは[散布図](scatter-chart.md)の ## Angular バブル チャートの例 -次の例に示すように、 と 2 つの数値軸を使用して、`DataChart` コントロールで Ignite UI for Angular バブル チャートを作成できます。 +次の例に示すように、 と 2 つの数値軸を使用して、 コントロールで Ignite UI for Angular バブル チャートを作成できます。 diff --git a/docs/angular/src/content/jp/components/charts/types/column-chart.mdx b/docs/angular/src/content/jp/components/charts/types/column-chart.mdx index 1c354105b7..4f3be1b030 100644 --- a/docs/angular/src/content/jp/components/charts/types/column-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/column-chart.mdx @@ -92,14 +92,14 @@ Angular 縦棒チャートには、外観のスタイル設定と変更のため ## 高度なタイプの縦棒チャート -次のセクションでは、簡略化された API を使用した コントロールの代わりに `DataChart` コントロールを使用して作成できる、より高度なタイプの Angular 縦棒チャートについて説明します。 +次のセクションでは、簡略化された API を使用した コントロールの代わりに コントロールを使用して作成できる、より高度なタイプの Angular 縦棒チャートについて説明します。 ## Angular ウォーターフォール チャート ウォーターフォール チャートはカテゴリ チャートのグループに属し、連続するデータポイント間の差を示す垂直列のコレクションを使用して描画されます。値の正/負の変化を区別するため、列は色分けされます。ウォーターフォール チャートは、外観が[範囲縦棒チャート](column-chart.md#angular-範囲縦棒チャート)に似ていますが、各データ ポイントに必要な数値データ列は 2 つでなく 1 つのみです。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -112,7 +112,7 @@ Angular 縦棒チャートには、外観のスタイル設定と変更のため 積層型縦棒チャートは、シリーズが横ではなく上に表示されることを除いて、すべての面で[カテゴリ縦棒チャート](column-chart.md#angular-縦棒チャートの例)に似ています。積層型縦棒チャートは、シリーズ間の結果の比較を示すために使用されます。コレクションのそれぞれの積層フラグメントは各積層の視覚的な要素を表します。各積層は正の値と負の値の両方を含みます。正の値はいずれも Y 軸の正の側にグループ化され、負の値は Y 軸の負の側にグループ化されます。積層型縦棒チャートは[積層型棒チャート](stacked-chart.md#angular-積層型棒チャート)と同じデータプロットの概念を使用していますが、データ ポイントは横の線 (X 軸) に沿ってではなく、縦の線 (Y 軸) に沿って積層されます。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -125,7 +125,7 @@ Angular 縦棒チャートには、外観のスタイル設定と変更のため 積層型 100% 縦棒チャートは、Y 軸上の値の取り扱いを除いたすべての面で[積層型縦棒チャート](stacked-chart.md#angular-積層型縦棒チャート)と同じです。データを直接表現するのでなく、積層型 100 縦棒は、データ ポイント内のすべての値の合計の割合でデータを表します。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -140,7 +140,7 @@ Ignite UI for Angular 範囲縦棒チャートは、範囲チャートのグル 範囲縦棒チャートは、範囲が塗りつぶされた領域ではなく垂直柱の集まりで表されること以外は[範囲エリア チャート](area-chart.md#angular-範囲エリア-チャート)と同じです。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -153,7 +153,7 @@ Ignite UI for Angular 範囲縦棒チャートは、範囲チャートのグル ラジアル縦棒チャートは、[ラジアル チャート](radial-chart.md)のグループに属し、チャートの中心からデータ ポイントの位置に向かって伸びる長方形のコレクションを使用して描画されます。これは[カテゴリ縦棒チャート](column-chart.md#angular-縦棒チャートの例)と同じデータ プロットの概念を使用していますが、データ ポイントを横の線に並べるのではなく、データ ポイントを円でラップします。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -180,12 +180,12 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | --------------------|--------------------|------------------------| -| Column | `CategoryChart` | `CategoryChart.ChartType` = **Column** | -| Radial Column | `DataChart` | `RadialColumnSeries` | -| Range Column | `DataChart` | `RangeColumnSeries` | -| Stacked Column | `DataChart` | `StackedColumnSeries` | -| Stacked 100% Column | `DataChart` | `Stacked100ColumnSeries` | -| Waterfall | `DataChart` | `WaterfallSeries` | +| Column | | `CategoryChart.ChartType` = **Column** | +| Radial Column | | | +| Range Column | | | +| Stacked Column | | | +| Stacked 100% Column | | | +| Waterfall | | |

diff --git a/docs/angular/src/content/jp/components/charts/types/composite-chart.mdx b/docs/angular/src/content/jp/components/charts/types/composite-chart.mdx index 013c36d8fc..119215d9c4 100644 --- a/docs/angular/src/content/jp/components/charts/types/composite-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/composite-chart.mdx @@ -16,7 +16,7 @@ Ignite UI for Angular 複合チャートまたはコンボ チャートは、同 ## Angular 複合 / コンボ チャートの例 -次の例は、 コントロールで `ColumnSeries` と `LineSeries` を使用して複合チャートを作成する方法を示しています。 +次の例は、 コントロールで を使用して複合チャートを作成する方法を示しています。 diff --git a/docs/angular/src/content/jp/components/charts/types/data-pie-chart.mdx b/docs/angular/src/content/jp/components/charts/types/data-pie-chart.mdx index c4070c7cab..5d20bcdab1 100644 --- a/docs/angular/src/content/jp/components/charts/types/data-pie-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/data-pie-chart.mdx @@ -85,7 +85,7 @@ ItemLegend バッジを変更することもできます。デフォルトでは プロパティは、 プロパティと連動して機能します。 では、 を数値として評価するか、パーセンテージとして評価するかを定義できます。たとえば、数値を選択し、 を 5 に設定すると、5 未満の値を持つスライスはすべて「その他」カテゴリの一部になります。パーセント タイプで同じ値 5 を使用すると、 の合計値の 5 パーセント未満の値はすべて「その他」カテゴリの一部になります。 -チャートの Others スライスに含まれる基礎データ項目を取得するには、チャートの `GetOthersContext` メソッドを利用できます。このメソッドの戻り値のタイプは、`Items` プロパティを公開する `OthersCategoryContext` です。`Items` プロパティは、Others スライス内の項目を含む配列を返します。さらに、Others スライスをクリックすると、`SeriesClick` イベントのイベント引数の `Item` プロパティもこの `OthersCategoryContext` を返します。 +チャートの Others スライスに含まれる基礎データ項目を取得するには、チャートの メソッドを利用できます。このメソッドの戻り値のタイプは、 プロパティを公開する です。 プロパティは、Others スライス内の項目を含む配列を返します。さらに、Others スライスをクリックすると、`SeriesClick` イベントのイベント引数の `Item` プロパティもこの を返します。 デフォルトでは、「その他」スライスは「その他」というラベルで表されます。チャートの プロパティを変更することでこれを変更できます。 @@ -118,21 +118,21 @@ ItemLegend バッジを変更することもできます。デフォルトでは は、チャートにプロットされたスライスをマウスでクリックしてスライスを選択できる機能をサポートしています。これは、以下で説明するチャートの プロパティと プロパティを利用して構成できます。 - の主な 2 つのオプションは `PerDataItemSingleSelect` と `PerDataItemMultiSelect` で、それぞれ単一選択と複数選択を有効にします。 + の主な 2 つのオプションは で、それぞれ単一選択と複数選択を有効にします。 プロパティは、円チャートのスライスが選択された場合にどのように反応するかを決定します。以下はその列挙体のオプションとその機能です。 -- `Brighten`: 選択したスライスがハイライト表示されます。 -- `FadeOthers`: 選択したスライスは同じ色のまま残り、他のスライスは色が薄くなります。 -- `FocusColorFill`: 選択したスライスの背景がチャートの FocusBrush に変更されます。 -- `FocusColorOutline`: 選択されたスライスには、チャートの FocusBrush によって定義された色のアウトラインが表示されます。 -- `FocusColorThickOutline`: 選択されたスライスには、チャートの FocusBrush によって定義された色のアウトラインが表示されます。このアウトラインの太さは、コントロールの Thickness プロパティを使用して設定することもできます。 -- `GrayscaleOthers`: 選択されていないスライスにはグレー色のフィルターが適用されます。 -- `None`: 選択されたスライスには影響はありません。 -- `SelectionColorFill`: 選択されたスライスの背景がチャートの SelectionBrush に変更されます。 -- `SelectionColorOutline`: 選択されたスライスには、チャートの SelectionBrush によって定義された色のアウトラインが表示されます。 -- `SelectionColorThickOutline`: 選択されたスライスには、チャートの FocusBrush によって定義された色のアウトラインが表示されます。このアウトラインの太さは、コントロールの Thickness プロパティを使用して設定することもできます。 -- `ThickOutline`: 選択されたスライスには、チャートの Thickness プロパティに応じて太さが異なるアウトラインが適用されます。 +- : 選択したスライスがハイライト表示されます。 +- : 選択したスライスは同じ色のまま残り、他のスライスは色が薄くなります。 +- : 選択したスライスの背景がチャートの FocusBrush に変更されます。 +- : 選択されたスライスには、チャートの FocusBrush によって定義された色のアウトラインが表示されます。 +- : 選択されたスライスには、チャートの FocusBrush によって定義された色のアウトラインが表示されます。このアウトラインの太さは、コントロールの Thickness プロパティを使用して設定することもできます。 +- : 選択されていないスライスにはグレー色のフィルターが適用されます。 +- : 選択されたスライスには影響はありません。 +- : 選択されたスライスの背景がチャートの SelectionBrush に変更されます。 +- : 選択されたスライスには、チャートの SelectionBrush によって定義された色のアウトラインが表示されます。 +- : 選択されたスライスには、チャートの FocusBrush によって定義された色のアウトラインが表示されます。このアウトラインの太さは、コントロールの Thickness プロパティを使用して設定することもできます。 +- : 選択されたスライスには、チャートの Thickness プロパティに応じて太さが異なるアウトラインが適用されます。 スライスが選択されると、その基になるデータ項目がチャートの SelectedSeriesItems コレクションに追加されます。そのため、DataPieChart は SelectedSeriesItemsChanged イベントを公開して、スライスが選択されてこのコレクションが変更されたことを検出します。 @@ -149,18 +149,18 @@ ItemLegend バッジを変更することもできます。デフォルトでは 列挙プロパティは、スライスがどのようにハイライト表示されるかを決定します。以下はそのプロパティのオプションとその機能です。 -- `DirectlyOver`: スライスは、マウスがその上に直接置かれている場合にのみハイライト表示されます。 -- `NearestItems`: マウスの位置に最も近いスライスがハイライト表示されます。 -- `NearestItemsAndSeries`: マウスの位置に最も近いスライスとシリーズがハイライト表示されます。 -- `NearestItemsRetainMainShapes`: マウスの位置に最も近い項目がハイライト表示され、シリーズのメイン図形はハイライト表示されなくなります。 +- : スライスは、マウスがその上に直接置かれている場合にのみハイライト表示されます。 +- : マウスの位置に最も近いスライスがハイライト表示されます。 +- : マウスの位置に最も近いスライスとシリーズがハイライト表示されます。 +- : マウスの位置に最も近い項目がハイライト表示され、シリーズのメイン図形はハイライト表示されなくなります。 列挙プロパティは、データ円チャートのスライスがハイライト表示されたときにどのように反応するかを決定します。以下はそのプロパティのオプションとその機能です。 -- `Brighten`: マウスの位置がそのシリーズ上または近くにあると、そのシリーズの色が明るくなります。 +- : マウスの位置がそのシリーズ上または近くにあると、そのシリーズの色が明るくなります。 - `BrightenSpecific`: マウスの位置が特定のスライスの上または近くにある場合、そのスライスの色が明るくなります。 -- `FadeOthers`: マウスの位置がそのシリーズ上または近くにある場合、そのシリーズは色を保持しますが、他の部分は薄く表示されます。 +- : マウスの位置がそのシリーズ上または近くにある場合、そのシリーズは色を保持しますが、他の部分は薄く表示されます。 - `FadeOthersSpecific`: マウスの位置がそのスライスの上または近くにある場合、そのスライスの色は保持されますが、他のスライスの色は薄く表示されます。 -- `None`: シリーズとスライスはハイライト表示されません。 +- : シリーズとスライスはハイライト表示されません。 以下の例は、 コンポーネントのマウスハイライト表示の動作を示しています。 diff --git a/docs/angular/src/content/jp/components/charts/types/line-chart.mdx b/docs/angular/src/content/jp/components/charts/types/line-chart.mdx index 1abcbbc45b..ce14818cd9 100644 --- a/docs/angular/src/content/jp/components/charts/types/line-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/line-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular 折れ線チャート (または折れ線グラフ) は、 ## Angular 折れ線チャートの例 -次の例に示すように、データを プロパティにバインドし、 プロパティを `Line` 列挙型に設定することで、コントロールに Angular 折れ線チャートを作成できます。 +次の例に示すように、データを プロパティにバインドし、 プロパティを 列挙型に設定することで、コントロールに Angular 折れ線チャートを作成できます。 @@ -75,7 +75,7 @@ Ignite UI for Angular 折れ線チャート (または折れ線グラフ) は、 以下の例に示すように、Angular 折れ線チャートは、2009 年以降の 10 年間の再生可能電力量など、値の経時変化を示すためによく使用されます。 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Line` に設定します: + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを に設定します: @@ -88,7 +88,7 @@ Ignite UI for Angular 折れ線チャート (または折れ線グラフ) は、 Angular 折れ線チャートを使用すると、複数のシリーズを組み合わせて時間の経過に伴う変化を比較または確認できます。中国と米国のデータを含むデータ ソースにバインドするだけで、折れ線チャートは追加データに合わせて自動的に更新されます。 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Line` に設定します: + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを に設定します: @@ -103,7 +103,7 @@ Angular 折れ線チャートは、次のデモに示すように、数百万に この例では、選択した間隔でライブ データを Angular 折れ線チャートにストリーミングしています。データ ポイントを 5,000 から 100 万に設定し、チャートを更新してチャートを描画するデバイスに基づいてスケールを最適化できます。 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Line` に設定します: + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを に設定します: @@ -116,14 +116,14 @@ Angular 折れ線チャートは、次のデモに示すように、数百万に チャートを設定したら、線の色の変更、凡例のフォント ファミリの変更、軸ラベルのサイズの増加など読みやすくするためにスタイル設定をカスタマイズできます。 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Line` に設定します: + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを に設定します: -`DataChart` を使用し、系列に プロパティを設定することで、 内に破線を作成することもできます。このプロパティは、線の結果として得られるダッシュの長さを表す数値の配列を受け取ります。 + を使用し、系列に プロパティを設定することで、 内に破線を作成することもできます。このプロパティは、線の結果として得られるダッシュの長さを表す数値の配列を受け取ります。 -次の例は、`DataChart` の での の使用法を示しています。 +次の例は、 での の使用法を示しています。 @@ -133,11 +133,11 @@ Angular 折れ線チャートは、次のデモに示すように、数百万に ## 高度なタイプの折れ線チャート -次のセクションでは、簡略化された API を使用した コントロールの代わりに `DataChart` コントロールを使用して作成できる、より高度なタイプの Angular 折れ線チャートについて説明します。 +次のセクションでは、簡略化された API を使用した コントロールの代わりに コントロールを使用して作成できる、より高度なタイプの Angular 折れ線チャートについて説明します。 ## Angular 積層型折れ線チャート -積層型折れ線チャートは、地域間で数年間に生成された再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +積層型折れ線チャートは、地域間で数年間に生成された再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -150,7 +150,7 @@ Angular 折れ線チャートは、次のデモに示すように、数百万に 積層型 100% 折れ線チャートは、Y 軸上の値の取り扱いを除いたすべての面で積層型折れ線チャートと同じです。データを直接表現するのでなく、積層型 100% 折れ線チャートは、データ ポイント内のすべての値の合計の割合でデータを表します。以下の例は、タブレット、携帯電話、およびコンピューターを介した部門によるオンライン ショッピング トラフィックについて行われた調査を示しています。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -163,7 +163,7 @@ Angular 折れ線チャートは、次のデモに示すように、数百万に ラジアル折れ線チャートはラジアル チャートのグループに属し、データ ポイントを接続する直線のコレクションによってバインドされた塗りつぶしなしのポリゴンの形状を持っています。このグラフ チャートは、折れ線チャートと同じデータ プロットの概念を使用しますが、データ ポイントを水平方向に引き伸ばすのではなく、円形の軸の周りにラップします。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -176,7 +176,7 @@ Angular 折れ線チャートは、次のデモに示すように、数百万に 極座標折れ線チャートは極座標チャートのグループに属し、極座標 (角度/半径) のデータ ポイントを結ぶ直線のコレクションを使用して描画されます。極座標チャートは、[散布折れ線チャート](scatter-chart.md)と同じデータ プロットの概念を使用しますが、視覚化によってデータ ポイントがを水平方向に引き伸ばされるのではなく、円の周りにラップされる点が異なります。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -202,11 +202,11 @@ Angular 折れ線チャートは、次のデモに示すように、数百万に | チャート タイプ | コントロール名 | API メンバー | | ------------------|--------------------|----------------------- | -| 折れ線 | `CategoryChart` | `CategoryChart.ChartType` = `Line` | -| 極座標折れ線 | `DataChart` | `PolarLineSeries` | -| ラジアル折れ線 | `DataChart` | `RadialLineSeries` | -| 積層型折れ線 | `DataChart` | `StackedLineSeries` | -| 積層型 100% 折れ線 | `DataChart` | `Stacked100LineSeries` | +| 折れ線 | | `CategoryChart.ChartType` = | +| 極座標折れ線 | | | +| ラジアル折れ線 | | | +| 積層型折れ線 | | | +| 積層型 100% 折れ線 | | |

diff --git a/docs/angular/src/content/jp/components/charts/types/pie-chart.mdx b/docs/angular/src/content/jp/components/charts/types/pie-chart.mdx index 69add10166..e9eabcdc56 100644 --- a/docs/angular/src/content/jp/components/charts/types/pie-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/pie-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular 円チャート (円グラフ) は、データセットの ## Angular 円チャートの例 -データ項目を文字列と数値データでバインドすることで、`PieChart` の円チャートが作成できます。これらのデータ値を足すと可視化率 100% になります。この例では部門ごとの予算支出の全体的な内訳を示しています。 +データ項目を文字列と数値データでバインドすることで、 の円チャートが作成できます。これらのデータ値を足すと可視化率 100% になります。この例では部門ごとの予算支出の全体的な内訳を示しています。 @@ -73,7 +73,7 @@ Angular 円チャートは、データを解析するためのビューアー 円チャート コンポーネントの隣に凡例を表示するには、ItemLegend を作成し、 プロパティに割り当てます。 は、各円スライスの凡例項目を表示するために使用するデータ モデルのプロパティを指定します。 -また、凡例項目の外観をカスタマイズするために および プロパティ、`ItemLegend` の複数のフォント プロパティも使用できます。 +また、凡例項目の外観をカスタマイズするために および プロパティ、 の複数のフォント プロパティも使用できます。 @@ -109,7 +109,7 @@ Angular 円チャートは、データを解析するためのビューアー
## Angular 円チャートの選択 -デフォルトで、円チャートはマウス クリックによるスライス選択をサポートします。選択されたスライスは、`SelectedItems` プロパティで取得します。選択したスライスがハイライト表示されます。 +デフォルトで、円チャートはマウス クリックによるスライス選択をサポートします。選択されたスライスは、 プロパティで取得します。選択したスライスがハイライト表示されます。 円チャートのモードは プロパティで設定します。デフォルト値は `Single` です。選択機能を無効化するためにはプロパティを `Manual` に設定します。 @@ -127,7 +127,7 @@ Angular 円チャートは、データを解析するためのビューアー 「Changing」で終わるイベントはキャンセル可能なイベントです。すなわち、イベント引数プロパティ `Cancel` を true に設定することで、スライスの選択を停止します。True に設定すると、関連付けられたプロパティは更新されず、その結果スライスは選択されません。この設定はたとえば、スライスのデータによって一定のスライスの選択を無効化する場合に使用します。 -「その他」スライスをクリックすると、`PieSliceOthersContext` オブジェクトが返されます。オブジェクトは、「その他」スライスに含まれるデータ項目のリストがあります。 +「その他」スライスをクリックすると、 オブジェクトが返されます。オブジェクトは、「その他」スライスに含まれるデータ項目のリストがあります。 diff --git a/docs/angular/src/content/jp/components/charts/types/point-chart.mdx b/docs/angular/src/content/jp/components/charts/types/point-chart.mdx index 872c77f234..cdb60cfc6d 100644 --- a/docs/angular/src/content/jp/components/charts/types/point-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/point-chart.mdx @@ -61,7 +61,7 @@ Angular ポイント チャートを設定したら、マーカーとそのア ## 高度なタイプのポイント チャート -次のトピックに従って、 コントロールの代わりに `DataChart` コントロールを使用して、より高度なタイプの Angular ポイント チャートを作成できます。 +次のトピックに従って、 コントロールの代わりに コントロールを使用して、より高度なタイプの Angular ポイント チャートを作成できます。 - [散布バブル チャート](bubble-chart.md) - [散布マーカー チャート](scatter-chart.md#angular-散布マーカー-チャート) diff --git a/docs/angular/src/content/jp/components/charts/types/polar-chart.mdx b/docs/angular/src/content/jp/components/charts/types/polar-chart.mdx index 1ef6e216ba..fdc8c6e5b2 100644 --- a/docs/angular/src/content/jp/components/charts/types/polar-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/polar-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular 極座標チャートは、デカルト (x、y) 座標系 ## Angular 極座標エリア チャート -極座標型エリア チャートは、データ ポイントを接続するポリゴンのコレクションを使用して描画され、[カテゴリ エリア チャート](area-chart.md#angular-エリア-チャートの例)と同じデータ プロットの概念を使用しますが、視覚化によってデータ ポイントが水平線に沿って配置されるのではなく、円の周りに配置される点が異なります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +極座標型エリア チャートは、データ ポイントを接続するポリゴンのコレクションを使用して描画され、[カテゴリ エリア チャート](area-chart.md#angular-エリア-チャートの例)と同じデータ プロットの概念を使用しますが、視覚化によってデータ ポイントが水平線に沿って配置されるのではなく、円の周りに配置される点が異なります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -28,7 +28,7 @@ Ignite UI for Angular 極座標チャートは、デカルト (x、y) 座標系 ## Angular 極座標スプライン エリア チャート -極座標スプライン エリア チャートもポリゴンのコレクションとして描画されますが、[極座標エリア チャート](polar-chart.md#angular-極座標エリア-チャート)のように直線ではなく、データ ポイントを接続する曲線スプラインを使用します。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +極座標スプライン エリア チャートもポリゴンのコレクションとして描画されますが、[極座標エリア チャート](polar-chart.md#angular-極座標エリア-チャート)のように直線ではなく、データ ポイントを接続する曲線スプラインを使用します。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -39,7 +39,7 @@ Ignite UI for Angular 極座標チャートは、デカルト (x、y) 座標系 ## Angular 極座標型マーカー チャート -極座標型マーカー チャートは、極座標 (角度、半径) でデータ ポイントを表すマーカーのコレクションを使用して描画します。このチャートは、[散布マーカー チャート](scatter-chart.md#angular-散布マーカー-チャート)と同じデータ プロットの概念を使用していますが、視覚化によってデータ ポイントが水平線に沿って引き伸ばされるのではなく、円の周りに折り返される点が異なります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +極座標型マーカー チャートは、極座標 (角度、半径) でデータ ポイントを表すマーカーのコレクションを使用して描画します。このチャートは、[散布マーカー チャート](scatter-chart.md#angular-散布マーカー-チャート)と同じデータ プロットの概念を使用していますが、視覚化によってデータ ポイントが水平線に沿って引き伸ばされるのではなく、円の周りに折り返される点が異なります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -50,7 +50,7 @@ Ignite UI for Angular 極座標チャートは、デカルト (x、y) 座標系 ## Angular 極座標型折れ線チャート -極座標折れ線チャートは極座標 (角度/半径) のデータ ポイントを結ぶ直線のコレクションを使用して描画されます。このチャートは、[散布折れ線チャート](scatter-chart.md#angular-散布折れ線チャート)と同じデータ プロットの概念を使用しますが、視覚化によってデータ ポイントが水平線に沿って引き伸ばされるのではなく、円の周りにラップされる点が異なります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +極座標折れ線チャートは極座標 (角度/半径) のデータ ポイントを結ぶ直線のコレクションを使用して描画されます。このチャートは、[散布折れ線チャート](scatter-chart.md#angular-散布折れ線チャート)と同じデータ プロットの概念を使用しますが、視覚化によってデータ ポイントが水平線に沿って引き伸ばされるのではなく、円の周りにラップされる点が異なります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -61,7 +61,7 @@ Ignite UI for Angular 極座標チャートは、デカルト (x、y) 座標系 ## Angular 極座標スプライン チャート -極座標スプライン チャートは極座標 (角度、半径) でデータ ポイントを接続する曲線スプラインのコレクションを使用して描画されます。このチャートは、[散布スプライン チャート](scatter-chart.md#angular-散布スプライン-チャート)と同じデータ プロットの概念を使用しますが、視覚化によってデータ ポイントが水平線に沿って引き伸ばされるのではなく、円の周りにラップされる点が異なります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +極座標スプライン チャートは極座標 (角度、半径) でデータ ポイントを接続する曲線スプラインのコレクションを使用して描画されます。このチャートは、[散布スプライン チャート](scatter-chart.md#angular-散布スプライン-チャート)と同じデータ プロットの概念を使用しますが、視覚化によってデータ ポイントが水平線に沿って引き伸ばされるのではなく、円の周りにラップされる点が異なります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -72,7 +72,7 @@ Ignite UI for Angular 極座標チャートは、デカルト (x、y) 座標系 ## Angular 極座標チャートのスタイル設定 -極座標チャートを作成したら、線の色、マーカーの種類、またはそれらのマーカーのアウトライン色の変更など、スタイルをさらにカスタマイズしたい場合があります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +極座標チャートを作成したら、線の色、マーカーの種類、またはそれらのマーカーのアウトライン色の変更など、スタイルをさらにカスタマイズしたい場合があります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: diff --git a/docs/angular/src/content/jp/components/charts/types/radial-chart.mdx b/docs/angular/src/content/jp/components/charts/types/radial-chart.mdx index 310b2ac255..638d4a6d0a 100644 --- a/docs/angular/src/content/jp/components/charts/types/radial-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/radial-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular ラジアル チャートは、データを取得し、円 ## Angular ラジアル エリア チャート -Ignite UI for Angular ラジアル エリア チャートは、データ ポイントを結ぶ直線のコレクションによってバインドされた塗りつぶされた多角形の形をしています。このチャートは、[エリア チャート](area-chart.md)と同じデータ プロットの概念を使用しますが、データ ポイントを水平方向に引き伸ばすのではなく、円形の軸の周りにラップします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 +Ignite UI for Angular ラジアル エリア チャートは、データ ポイントを結ぶ直線のコレクションによってバインドされた塗りつぶされた多角形の形をしています。このチャートは、[エリア チャート](area-chart.md)と同じデータ プロットの概念を使用しますが、データ ポイントを水平方向に引き伸ばすのではなく、円形の軸の周りにラップします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -28,7 +28,7 @@ Ignite UI for Angular ラジアル エリア チャートは、データ ポイ ## Angular ラジアル縦棒チャート -ラジアル縦棒チャートは、チャートの中心からデータ ポイントの位置に向けて広がる矩形のコレクションを使用して表示されます。これは[縦棒チャート](column-chart.md)と同じデータ プロットの概念を使用していますが、データ ポイントを水平方向に引き伸ばすのではなく、データ ポイントを円でラップします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +ラジアル縦棒チャートは、チャートの中心からデータ ポイントの位置に向けて広がる矩形のコレクションを使用して表示されます。これは[縦棒チャート](column-chart.md)と同じデータ プロットの概念を使用していますが、データ ポイントを水平方向に引き伸ばすのではなく、データ ポイントを円でラップします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -39,7 +39,7 @@ Ignite UI for Angular ラジアル エリア チャートは、データ ポイ ## Angular ラジアル折れ線チャート -Ignite UI for Angular ラジアル折れ線チャートは、データ ポイントを結ぶ直線のコレクションとして描画されます。このチャートは、[折れ線チャート](line-chart.md)と同じデータ プロットの概念を使用しますが、データ ポイントを水平方向に引き伸ばすのではなく、円形の軸の周りにラップします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +Ignite UI for Angular ラジアル折れ線チャートは、データ ポイントを結ぶ直線のコレクションとして描画されます。このチャートは、[折れ線チャート](line-chart.md)と同じデータ プロットの概念を使用しますが、データ ポイントを水平方向に引き伸ばすのではなく、円形の軸の周りにラップします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -50,7 +50,7 @@ Ignite UI for Angular ラジアル折れ線チャートは、データ ポイン ## Angular ラジアル円チャート -ラジアル円チャートは、チャートの中心からデータ ポイントの位置に向けて広がる円スライスを使用します。このチャート タイプは、複数の一連のデータ ポイントを分類するという概念を採用しており、データ ポイントを水平線に沿って引き伸ばすのではなく、円形の軸に沿ってラップします。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +ラジアル円チャートは、チャートの中心からデータ ポイントの位置に向けて広がる円スライスを使用します。このチャート タイプは、複数の一連のデータ ポイントを分類するという概念を採用しており、データ ポイントを水平線に沿って引き伸ばすのではなく、円形の軸に沿ってラップします。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -61,7 +61,7 @@ Ignite UI for Angular ラジアル折れ線チャートは、データ ポイン ## Angular ラジアル チャートのスタイル設定 -ラジアル チャートを作成したら、線の色、マーカーの種類、またはそれらのマーカーのアウトライン色の変更など、スタイルをさらにカスタマイズしたい場合があります。この例は、`DataChart` コントロールのスタイルをカスタマイズする方法を示しています。 +ラジアル チャートを作成したら、線の色、マーカーの種類、またはそれらのマーカーのアウトライン色の変更など、スタイルをさらにカスタマイズしたい場合があります。この例は、 コントロールのスタイルをカスタマイズする方法を示しています。 @@ -70,7 +70,7 @@ Ignite UI for Angular ラジアル折れ線チャートは、データ ポイン ## Angular ラジアル チャートの設定 -さらに、ラベルはチャートの近くまたは広い位置に表示されるように設定できます。これは、 の `LabelMode` プロパティで設定できます。 +さらに、ラベルはチャートの近くまたは広い位置に表示されるように設定できます。これは、 プロパティで設定できます。
diff --git a/docs/angular/src/content/jp/components/charts/types/scatter-chart.mdx b/docs/angular/src/content/jp/components/charts/types/scatter-chart.mdx index 83193b3d64..ea823f445b 100644 --- a/docs/angular/src/content/jp/components/charts/types/scatter-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/scatter-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular 散布図は、異なる一連のデータ内の項目間 ## Angular 散布マーカー チャート -Angular 散布図は、マーカーのコレクションとして描画されます。各マーカーには、デカルト座標系での位置を決定する 1 対の数値 X/Y 値があります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +Angular 散布図は、マーカーのコレクションとして描画されます。各マーカーには、デカルト座標系での位置を決定する 1 対の数値 X/Y 値があります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -28,7 +28,7 @@ Angular 散布図は、マーカーのコレクションとして描画されま ## Angular 散布折れ線チャート -Angular は、直線で接続されたマーカーのコレクションとして描画され、各マーカーにはデカルト座標系での位置を決定する X/Y の数値のペアがあります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +Angular は、直線で接続されたマーカーのコレクションとして描画され、各マーカーにはデカルト座標系での位置を決定する X/Y の数値のペアがあります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -39,7 +39,7 @@ Angular は、直線で接続されたマーカーのコレクションとして ## Angular 散布スプライン チャート -Angular は、曲線スプラインで接続されたマーカーのコレクションとして描画され、各マーカーにはデカルト座標系での位置を決定する X/Y の数値のペアがあります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +Angular は、曲線スプラインで接続されたマーカーのコレクションとして描画され、各マーカーにはデカルト座標系での位置を決定する X/Y の数値のペアがあります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -50,7 +50,7 @@ Angular は、曲線スプラインで接続されたマーカーのコレクシ ## Angular 散布高密度チャート -Angular 散布高密度 (HD) チャートを使用して、わずかな読み込み時間で数千から数百万のデータ ポイントに及ぶ散布データをバインドして表示します。このチャート タイプは非常に多くのポイント用に設計されているため、フル サイズのマーカーではなく小さな点として視覚化され、データ ポイントのクラスターを表すより高い色密度を使用してデータが最も多い領域を表示します。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +Angular 散布高密度 (HD) チャートを使用して、わずかな読み込み時間で数千から数百万のデータ ポイントに及ぶ散布データをバインドして表示します。このチャート タイプは非常に多くのポイント用に設計されているため、フル サイズのマーカーではなく小さな点として視覚化され、データ ポイントのクラスターを表すより高い色密度を使用してデータが最も多い領域を表示します。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -61,7 +61,7 @@ Angular 散布高密度 (HD) チャートを使用して、わずかな読み込 ## Angular 散布エリア チャート -Angular 散布エリア チャートは各ポイントに割り当てられた数値を使って、X および Y データの三角形分割に基づいて、色付きのサーフェスを描画します。このチャートはヒート マップ、磁場の強さ、またはオフィスの Wi-Fi の強さを描画する場合などに便利です。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +Angular 散布エリア チャートは各ポイントに割り当てられた数値を使って、X および Y データの三角形分割に基づいて、色付きのサーフェスを描画します。このチャートはヒート マップ、磁場の強さ、またはオフィスの Wi-Fi の強さを描画する場合などに便利です。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -72,7 +72,7 @@ Angular 散布エリア チャートは各ポイントに割り当てられた ## Angular 散布等高線チャート -Angular 散布等高線チャートは、X データと Y データの三角形分割に基づいて、各ポイントに数値データ値が割り当てられた色付きの等高線を描画します。このチャートはヒート マップ、磁場の強さ、またはオフィスの Wi-Fi の強さを描画する場合などに便利です。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: +Angular 散布等高線チャートは、X データと Y データの三角形分割に基づいて、各ポイントに数値データ値が割り当てられた色付きの等高線を描画します。このチャートはヒート マップ、磁場の強さ、またはオフィスの Wi-Fi の強さを描画する場合などに便利です。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -97,12 +97,12 @@ Angular 散布等高線チャートは、X データと Y データの三角形 | チャート タイプ | コントロール名 | API メンバー | | ----------------------------|----------------|------------------------ | -| 散布マーカー | `DataChart` | `ScatterSeries` | -| 散布折れ線 | `DataChart` | `ScatterLineSeries` | -| 散布スプライン | `DataChart` | `ScatterSplineSeries` | -| 高密度散布 | `DataChart` | `HighDensityScatterSeries` | -| 散布エリア | `DataChart` | `ScatterAreaSeries` | -| 散布等高線 | `DataChart` | `ScatterContourSeries` | +| 散布マーカー | | | +| 散布折れ線 | | | +| 散布スプライン | | | +| 高密度散布 | | | +| 散布エリア | | | +| 散布等高線 | | | ## API References diff --git a/docs/angular/src/content/jp/components/charts/types/shape-chart.mdx b/docs/angular/src/content/jp/components/charts/types/shape-chart.mdx index 8b7497a143..759f523027 100644 --- a/docs/angular/src/content/jp/components/charts/types/shape-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/shape-chart.mdx @@ -21,9 +21,9 @@ Ignite UI for Angular シェープ チャートは、一連の形状 (1 つま ## Angular 散布ポリゴン チャート -Angular 散布ポリゴン チャートは、`DataChart` コントロールの を使用して、デカルト (x、y) 座標系でポリゴンの配列または配列の配列を描画します。このチャートは、プロット図、青写真、さらには建物の間取り図の塗りつぶし図形に使用できます。 +Angular 散布ポリゴン チャートは、 コントロールの を使用して、デカルト (x、y) 座標系でポリゴンの配列または配列の配列を描画します。このチャートは、プロット図、青写真、さらには建物の間取り図の塗りつぶし図形に使用できます。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -34,9 +34,9 @@ Angular 散布ポリゴン チャートは、`DataChart` コントロールの < ## Angular 散布ポリライン チャート -Angular 散布ポリライン チャートは、`DataChart` コントロールの を使用して、デカルト (x、y) 座標系でポリラインの配列または配列の配列を描画します。このチャートは、プロット図、青写真、さらには建物の間取り図のアウトラインに使用できます。また、大量の要素間の複雑な関係を視覚化することもできます。 +Angular 散布ポリライン チャートは、 コントロールの を使用して、デカルト (x、y) 座標系でポリラインの配列または配列の配列を描画します。このチャートは、プロット図、青写真、さらには建物の間取り図のアウトラインに使用できます。また、大量の要素間の複雑な関係を視覚化することもできます。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: diff --git a/docs/angular/src/content/jp/components/charts/types/sparkline-chart.mdx b/docs/angular/src/content/jp/components/charts/types/sparkline-chart.mdx index 5d354e7c23..e80d084a6c 100644 --- a/docs/angular/src/content/jp/components/charts/types/sparkline-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/sparkline-chart.mdx @@ -18,7 +18,7 @@ Ignite UI for Angular スパークラインは、軽量なチャート コント ## Angular スパークラインの例 -次の例は、使用可能なすべての異なる のタイプを示しています。タイプは プロパティの設定により定義されます。 プロパティが指定されていない場合は、既定では `Line` 型が表示されます。 +次の例は、使用可能なすべての異なる のタイプを示しています。タイプは プロパティの設定により定義されます。 プロパティが指定されていない場合は、既定では 型が表示されます。 @@ -63,10 +63,10 @@ Angular スパークライン コンポーネントには、最高、最低、 Angular スパークライン コンポーネントは、それに応じて プロパティを設定することにより、以下のスパークライン タイプをサポートしています。 -- `Line`: スパークラインの折れ線チャート タイプを数値データで表示し、データ ポイントを線分で接続します。スパークラインでデータを視覚化するには、少なくとも 2 つのデータ ポイントを指定する必要があります。 -- `Area`: スパークラインのエリア チャート タイプを数値データで表示します。これは折れ線タイプに似ており、各線が描画された後に領域を閉じる追加の手順があります。スパークラインでデータを視覚化するには、少なくとも 2 つのデータ ポイントを指定する必要があります。 -- `Column`: スパークラインの縦棒チャート タイプを数値データで表示します。縦棒と表現される場合もあります。このタイプは単一データ ポイントを描画できますが、Sparkline に最小の値範囲プロパティ (minimum) を指定する必要があるので、供給される単一データ ポイントは表示可能です。そうでなければ、値は最小値として取り扱われ、表示されません。 -- `WinLoss`: このタイプは、外観は柱状チャートに似ています。各列の値はデータセットの正の最大値 (正の値の場合) または負の最小値 (負の値の場合) に等しくなります。ウィンまたはロス シナリオを示すのが目的です。Win/Loss チャートを正しく表示するには、データセットには正の値と負の値がなければなりません。WinLoss スパークラインが、数値のコレクションにバインドできる Line タイプなどの他のタイプと同じデータにバインドされている場合、Angular スパークライン コンポーネントはそのコレクションから最大値と最小値の 2 つの値を選択し、それらの値に基づいてスパークラインをレンダリングします。 +- : スパークラインの折れ線チャート タイプを数値データで表示し、データ ポイントを線分で接続します。スパークラインでデータを視覚化するには、少なくとも 2 つのデータ ポイントを指定する必要があります。 +- : スパークラインのエリア チャート タイプを数値データで表示します。これは折れ線タイプに似ており、各線が描画された後に領域を閉じる追加の手順があります。スパークラインでデータを視覚化するには、少なくとも 2 つのデータ ポイントを指定する必要があります。 +- : スパークラインの縦棒チャート タイプを数値データで表示します。縦棒と表現される場合もあります。このタイプは単一データ ポイントを描画できますが、Sparkline に最小の値範囲プロパティ (minimum) を指定する必要があるので、供給される単一データ ポイントは表示可能です。そうでなければ、値は最小値として取り扱われ、表示されません。 +- : このタイプは、外観は柱状チャートに似ています。各列の値はデータセットの正の最大値 (正の値の場合) または負の最小値 (負の値の場合) に等しくなります。ウィンまたはロス シナリオを示すのが目的です。Win/Loss チャートを正しく表示するには、データセットには正の値と負の値がなければなりません。WinLoss スパークラインが、数値のコレクションにバインドできる Line タイプなどの他のタイプと同じデータにバインドされている場合、Angular スパークライン コンポーネントはそのコレクションから最大値と最小値の 2 つの値を選択し、それらの値に基づいてスパークラインをレンダリングします。 @@ -77,7 +77,7 @@ Angular スパークライン コンポーネントは、それに応じて 、および のスパークラインに設定できます。 型のスパークラインは、現在マーカーを設定できません。デフォルトでは、マーカーは表示されませんが、対応するマーカーの可視性プロパティを設定することで有効にできます。 スパークライン内のマーカーは、以下の場所を任意に組み合わせて配置できます。 @@ -100,7 +100,7 @@ Angular スパークライン コンポーネントを使用すると、マー Angular スパークラインの通常の範囲機能は、データが視覚化されているときに定義済みの意味のある範囲を表す水平方向の縞模様です。標準範囲は、指定した色のアウトラインで網掛けエリアとして設定できます。 -通常の範囲は、最大データ ポイントよりも広い場合もあれば、それを超える場合もあります。また、しきい値インジケータとして機能するように、スパークラインの `Line` 表示タイプと同じ幅にすることもできます。正常範囲の幅は、正常範囲を表示するために最低限必要な以下の 3 つのプロパティによって決まります。 +通常の範囲は、最大データ ポイントよりも広い場合もあれば、それを超える場合もあります。また、しきい値インジケータとして機能するように、スパークラインの 表示タイプと同じ幅にすることもできます。正常範囲の幅は、正常範囲を表示するために最低限必要な以下の 3 つのプロパティによって決まります。 - `NormalRangeVisibility`: 標準範囲が表示されるかどうか。 - `NormalRangeMaximum`: 範囲の下境界線。 @@ -118,9 +118,9 @@ Angular スパークラインの通常の範囲機能は、データが視覚化 ## トレンドライン -Angular スパークラインは、実際のスパークライン レイヤーの上に別のレイヤーとして表示される一連のトレンドラインをサポートしています。トレンドラインを表示するには、`TrendLineType` プロパティを使用します。 +Angular スパークラインは、実際のスパークライン レイヤーの上に別のレイヤーとして表示される一連のトレンドラインをサポートしています。トレンドラインを表示するには、 プロパティを使用します。 -トレンドラインは、チャートがバインドされているデータの値を使用して、`TrendLineType` プロパティで指定されたアルゴリズムに従って計算されます。 +トレンドラインは、チャートがバインドされているデータの値を使用して、 プロパティで指定されたアルゴリズムに従って計算されます。 トレンドラインは一度に 1 つだけ表示でき、デフォルトではトレンドラインは表示されません。 diff --git a/docs/angular/src/content/jp/components/charts/types/spline-chart.mdx b/docs/angular/src/content/jp/components/charts/types/spline-chart.mdx index 6c6bb09861..5431ef5bb9 100644 --- a/docs/angular/src/content/jp/components/charts/types/spline-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/spline-chart.mdx @@ -16,7 +16,7 @@ Ignite UI for Angular スプライン チャートは、スプラインのスム ## Angular スプライン チャートの例 -次の例は、データをバインドし、 プロパティを `Spline` 列挙型に設定することにより、 コントロールで Angular スプライン チャートを作成する方法を示しています。 +次の例は、データをバインドし、 プロパティを 列挙型に設定することにより、 コントロールで Angular スプライン チャートを作成する方法を示しています。 @@ -29,7 +29,7 @@ Ignite UI for Angular スプライン チャートは、スプラインのスム 以下の例に示すように、スプライン チャートは、ヨーロッパで 2009 年以降の 10 年間の再生可能電力量など、値の経時変化を示すためによく使用されます。 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Spline` に設定します: + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを に設定します: @@ -42,7 +42,7 @@ Ignite UI for Angular スプライン チャートは、スプラインのスム スプライン チャートを使用すると、複数のシリーズを組み合わせて、時間の経過とともにどのように変化するかを比較または確認できます。中国と米国のデータを含むデータ ソースにバインドするだけで、チャートは追加データに合わせて自動的に更新されます。 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Spline` に設定します: + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを に設定します: @@ -55,7 +55,7 @@ Ignite UI for Angular スプライン チャートは、スプラインのスム 他のシリーズの複合などのより多くの機能を備えたスプライン チャートが必要な場合は、以下に示すように、マーカー、マーカー ブラシ、マーカー アウトライン、シリーズ ブラシ、シリーズ アウトラインを構成できます。 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを `Spline` に設定します: + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、 プロパティを に設定します: @@ -66,13 +66,13 @@ Ignite UI for Angular スプライン チャートは、スプラインのスム ## 高度なタイプのスプライン チャート -次のセクションでは、簡略化された API を使用した コントロールの代わりに `DataChart` コントロールを使用して作成できる、より高度なタイプの Angular スプライン チャートについて説明します。 +次のセクションでは、簡略化された API を使用した コントロールの代わりに コントロールを使用して作成できる、より高度なタイプの Angular スプライン チャートについて説明します。 ## Angular 積層型スプライン チャート 以下の例に示すように、積層型スプライン チャートは、地域間で数年間に生成された再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -85,7 +85,7 @@ Ignite UI for Angular スプライン チャートは、スプラインのスム 積層型 100 スプライン チャートは、Y 軸上の値の取り扱いを除いたすべての面で積層型スプライン チャートと同じです。データを直接表現するのでなく、積層型 100% スプライン チャートは、データ ポイント内のすべての値の合計の割合でデータを表します。以下の例は、タブレット、携帯電話、およびコンピューターを介した部門によるオンライン ショッピング トラフィックについて行われた調査を示しています。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -110,9 +110,9 @@ Ignite UI for Angular スプライン チャートは、スプラインのスム | チャート タイプ | コントロール名 | API メンバー | | --------------------|--------------------|-------------------------- | -| スプライン | `CategoryChart` | `CategoryChart.ChartType` = `Spline` | -| 積層型スプライン | `DataChart` | `StackedSplineSeries` | -| 積層型 100% スプライン | `DataChart` | `Stacked100SplineSeries` | +| スプライン | | `CategoryChart.ChartType` = | +| 積層型スプライン | | | +| 積層型 100% スプライン | | |

diff --git a/docs/angular/src/content/jp/components/charts/types/stacked-chart.mdx b/docs/angular/src/content/jp/components/charts/types/stacked-chart.mdx index eeca421a25..a47f6cb988 100644 --- a/docs/angular/src/content/jp/components/charts/types/stacked-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/stacked-chart.mdx @@ -32,7 +32,7 @@ Ignite UI for Angular 積層型チャートは、データ項目の複数の値 積層型エリア チャートは、線分で接続されたポイントのコレクションを使用して描画され、線の下のエリアが塗りつぶされ、互いの上に積層されます。積層型エリア チャートは、[エリア チャート](area-chart.md)とすべて同じ要件に従いますが、唯一の違いは、網掛けエリアが互いに積層されていることです。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `StackedAreaSeries` にバインドします。 + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -45,7 +45,7 @@ Ignite UI for Angular 積層型チャートは、データ項目の複数の値 ## Angular 積層型 100 エリア チャート このシリーズは、生産元に関連する国のエネルギー消費量など、時間の経過とともに変化する全体の一部を表す場合があります。このような場合積層されたすべての要素を均等に表すことをお勧めします。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `Stacked100AreaSeries` にバインドします。 + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -61,7 +61,7 @@ Ignite UI for Angular 積層型チャートは、データ項目の複数の値 積層型棒チャートは、データを表すデータ ポイントが水平方向に隣り合って積み重ねられ、データを視覚的にグループ化するという点で、[棒チャート](bar-chart.md)とは異なります。各積層は正の値と負の値の両方を含みます。すべての正の値は X 軸の正の側にグループ化され、すべての負の値は X 軸の負の側にグループ化されます。 -積層型棒チャートのこの例では、数値の X 軸 (チャートの下部のラベル) とカテゴリの Y 軸 (チャートの左側のラベル) があります。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `StackedBarSeries` にバインドします: +積層型棒チャートのこの例では、数値の X 軸 (チャートの下部のラベル) とカテゴリの Y 軸 (チャートの左側のラベル) があります。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -75,7 +75,7 @@ Ignite UI for Angular 積層型チャートは、データ項目の複数の値 Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベル) の値の処理を除いて、すべての点で Angular 積層型棒チャートと同じです。データを直接表現するのでなく、積層型棒チャートは、データ ポイント内のすべての値の合計の割合でデータを表します。 -積層型 100% 棒チャートのこの例では、Energy Product (エネルギー積) の値は、水平棒のフラグメント内のすべてのデータの 100% 値として表示されます。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `Stacked100BarSeries` にバインドします: +積層型 100% 棒チャートのこの例では、Energy Product (エネルギー積) の値は、水平棒のフラグメント内のすべてのデータの 100% 値として表示されます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -89,7 +89,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ 積層型縦棒チャートは、シリーズが横ではなく上に表示されることを除いて、すべての面で[縦棒チャート](column-chart.md)と同じです。積層型縦棒チャートは、シリーズ間の結果の比較を示すために使用されます。コレクションのそれぞれの積層フラグメントは各積層の視覚的な要素を表します。各積層は正の値と負の値の両方を含みます。正の値はいずれも Y 軸の正の側にグループ化され、負の値は Y 軸の負の側にグループ化されます。積層型縦棒チャートは積層型棒チャートと同じデータプロットの概念を使用していますが、データ ポイントは横の線 (X 軸) に沿ってではなく、縦の線 (Y 軸) に沿って積層されます。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `StackedColumnSeries` にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -103,7 +103,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ 積層型 100% 縦棒チャートは、Y 軸上の値の取り扱いを除いたすべての面で積層型縦棒チャートと同じです。データを直接表現するのでなく、積層型 100% 縦棒チャートは、データ ポイント内のすべての値の合計の割合でデータを表します。 -以下の例は、タブレット、携帯電話、およびコンピューターを介した部門によるオンライン ショッピング トラフィックについて行われた調査を示しています。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `Stacked100ColumnSeries` にバインドします: +以下の例は、タブレット、携帯電話、およびコンピューターを介した部門によるオンライン ショッピング トラフィックについて行われた調査を示しています。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -115,7 +115,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ ## Angular 積層型折れ線チャート -積層型折れ線チャートは、地域間で数年間に生成された再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `StackedLineSeries` にバインドします: +積層型折れ線チャートは、地域間で数年間に生成された再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -129,7 +129,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ 積層型 100% 折れ線チャートは、Y 軸上の値の取り扱いを除いたすべての面で積層型折れ線チャートと同じです。データを直接表現するのでなく、積層型 100% 折れ線チャートは、データ ポイント内のすべての値の合計の割合でデータを表します。以下の例は、タブレット、携帯電話、およびコンピューターを介した部門によるオンライン ショッピング トラフィックについて行われた調査を示しています。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `Stacked100LineSeries` にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -143,7 +143,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ 積層型スプライン エリア チャートは、曲線スプライン セグメントで接続されたポイントのコレクションを使用して描画され、曲線スプラインの下の領域が塗りつぶされ、互いに重ねて表示されます。積層型スプライン エリア チャートは、[エリア チャート](area-chart.md)とすべて同じ要件に従いますが、唯一の違いは、網掛けエリアが互いに積み重なっていることです。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `StackedSplineAreaSeries` にバインドします。 + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします。 @@ -157,7 +157,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ 積層型 100% スプライン エリア チャートは、y 軸の値の処理を除いて、すべての点で積層型スプラインエリア チャートと同じです。データを直接表現するのでなく、積層型 100% スプライン エリア チャートは、特定のデータ ポイント内のすべての値の合計の割合でデータを表します。チャートは、時間の経過とともに変化する全体の一部を表す場合があります。たとえば、生産元に関連する国のエネルギー消費量。このような場合、積層されたすべての要素を均等に表すことをお勧めします。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `Stacked100SplineAreaSeries` にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -169,7 +169,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ ## Angular 積層型スプライン チャート -積層型スプライン チャートは、地域間で数年間に生成された再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `StackedSplineSeries` にバインドします: +積層型スプライン チャートは、地域間で数年間に生成された再生可能電力の量など、時間の経過に伴う価値の変化を示すためによく使用されます。 コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -183,7 +183,7 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ 積層型 100% スプライン チャートは、Y 軸上の値の取り扱いを除いたすべての面で積層型スプライン チャートと同じです。データを直接表現するのでなく、積層型 100% スプライン チャートは、データ ポイント内のすべての値の合計の割合でデータを表します。以下の例は、タブレット、携帯電話、およびコンピューターを介した部門によるオンライン ショッピング トラフィックについて行われた調査を示しています。 -`DataChart` コントロールでこのチャート タイプを作成するには、以下の例のように、データを `Stacked100SplineSeries` にバインドします: + コントロールでこのチャート タイプを作成するには、以下の例のように、データを にバインドします: @@ -209,15 +209,15 @@ Angular 積層型 100% 棒チャートは、X 軸 (チャートの下のラベ | チャート タイプ | コントロール名 | API メンバー | | -------------------------|----------------|-------------------------------- | -| 積層型エリア | `DataChart` | `StackedAreaSeries` | -| 積層型棒 | `DataChart` | `StackedBarSeries` | -| 積層型縦棒 | `DataChart` | `StackedColumnSeries` | -| 積層型折れ線 | `DataChart` | `StackedLineSeries` | -| 積層型スプライン | `DataChart` | `StackedSplineSeries` | -| 積層型スプライン エリア | `DataChart` | `StackedSplineAreaSeries` | -| 積層型 100% エリア | `DataChart` | `Stacked100AreaSeries` | -| 積層型 100% 棒 | `DataChart` | `Stacked100BarSeries` | -| 積層型 100% 縦棒 | `DataChart` | `Stacked100ColumnSeries` | -| 積層型 100% 折れ線 | `DataChart` | `Stacked100LineSeries` | -| 積層型 100% スプライン | `DataChart` | `Stacked100SplineSeries` | -| 積層型 100% スプライン エリア | `DataChart` | `Stacked100SplineAreaSeries` | +| 積層型エリア | | | +| 積層型棒 | | | +| 積層型縦棒 | | | +| 積層型折れ線 | | | +| 積層型スプライン | | | +| 積層型スプライン エリア | | | +| 積層型 100% エリア | | | +| 積層型 100% 棒 | | | +| 積層型 100% 縦棒 | | | +| 積層型 100% 折れ線 | | | +| 積層型 100% スプライン | | | +| 積層型 100% スプライン エリア | | | diff --git a/docs/angular/src/content/jp/components/charts/types/step-chart.mdx b/docs/angular/src/content/jp/components/charts/types/step-chart.mdx index 8fd411a507..40b2751a5c 100644 --- a/docs/angular/src/content/jp/components/charts/types/step-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/step-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular ステップ チャートは連続する垂直線と水平 ## Angular ステップ エリア チャート - コントロールでステップ エリア チャートを作成するには、以下の例のように、 プロパティを `StepArea` 列挙型に設定します。 + コントロールでステップ エリア チャートを作成するには、以下の例のように、 プロパティを 列挙型に設定します。 @@ -30,7 +30,7 @@ Ignite UI for Angular ステップ チャートは連続する垂直線と水平 Angular ステップ折れ線チャートは、線の下の領域が塗りつぶされていないことを除いて、ステップ エリア チャートと非常によく似ています。 -次の例に示すように、データをバインドし、 プロパティを `StepLine` 値に設定することで、 コントロールでステップ折れ線チャートを作成できます。 +次の例に示すように、データをバインドし、 プロパティを 値に設定することで、 コントロールでステップ折れ線チャートを作成できます。 @@ -41,7 +41,7 @@ Angular ステップ折れ線チャートは、線の下の領域が塗りつぶ ## Angular ステップ チャートのスタイル設定 -他のシリーズの複合などのより多くの機能を備えたステップ チャートが必要な場合は、以下に示すように、 コントロールの `MarkerTypes`、`MarkerBrushes`、`MarkerOutlines`、折れ線の `Brushes`、および折れ線の `Outlines` プロパティを構成できます。 +他のシリーズの複合などのより多くの機能を備えたステップ チャートが必要な場合は、以下に示すように、 コントロールの 、折れ線の 、および折れ線の プロパティを構成できます。 diff --git a/docs/angular/src/content/jp/components/charts/types/stock-chart.mdx b/docs/angular/src/content/jp/components/charts/types/stock-chart.mdx index 38358e0250..67b326f709 100644 --- a/docs/angular/src/content/jp/components/charts/types/stock-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/stock-chart.mdx @@ -17,7 +17,7 @@ Ignite UI for Angular 株価チャート (Angular ファイナンシャル チ ## Angular 株価チャートの例 - コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、`FinancialChart.ChartType` プロパティを `Line` 値に設定します。 + コントロールでこのチャート タイプを作成するには、以下の例のように、データをバインドし、`FinancialChart.ChartType` プロパティを 値に設定します。 @@ -131,14 +131,14 @@ Ignite UI for Angular 株価チャート (Angular ファイナンシャル チ ボリューム ペインは指定した期間に取引された株式数を表します。出来高の低さは関心が低いことを示し、出来高の多さは取引が多く、関心が高いことを示します。縦棒、折れ線、またはエリア チャート タイプを使用して表示できます。ツールバーでチャート タイプを選択すると、ランタイムにデータを表示するボリューム ペインが表示されます。ペインを表示するには、以下のコードのようにボリューム タイプを設定する必要があります: ### 価格ペイン -このペインは、在庫価格を表示し、経時的な在庫の高値、安値、始値、終値を示します。さらに、トレンドラインおよびオーバーレイを表示できます。ツールバーからチャート タイプを選択できます。デフォルトで、チャート タイプは `Auto` に設定されています。次のコードに示すように、デフォルト設定をオーバーライドできます: +このペインは、在庫価格を表示し、経時的な在庫の高値、安値、始値、終値を示します。さらに、トレンドラインおよびオーバーレイを表示できます。ツールバーからチャート タイプを選択できます。デフォルトで、チャート タイプは に設定されています。次のコードに示すように、デフォルト設定をオーバーライドできます: 注: 複数のデータ ソースまたはデータ ポイントが大量にあるデータ ソースを描画する場合、折れ線チャート タイプを使用してください。 ### ズーム ペイン -このペインはすべての表示されるペインのズームを制御します。このペインはデフォルトで表示されます。以下のコードのように `ZoomSliderType` を `none` に設定すると機能を無効にできます: +このペインはすべての表示されるペインのズームを制御します。このペインはデフォルトで表示されます。以下のコードのように を `none` に設定すると機能を無効にできます: -注: `ZoomSliderType` オプションを `FinancialChart.ChartType` オプションと同じ値に設定してください。このように、ズーム スライダーは価格ペインの正しいプレビューを表示します。以下のコードはその方法を示しています。 +注: オプションを `FinancialChart.ChartType` オプションと同じ値に設定してください。このように、ズーム スライダーは価格ペインの正しいプレビューを表示します。以下のコードはその方法を示しています。 この例では、株価チャートは米国の収益をプロットしています。 diff --git a/docs/angular/src/content/jp/components/charts/types/treemap-chart.mdx b/docs/angular/src/content/jp/components/charts/types/treemap-chart.mdx index 3852eb817a..6acaa0e185 100644 --- a/docs/angular/src/content/jp/components/charts/types/treemap-chart.mdx +++ b/docs/angular/src/content/jp/components/charts/types/treemap-chart.mdx @@ -59,13 +59,13 @@ Ignite UI for Angular ツリーマップ チャートは、ネストされた一 - データ ソースはデータ項目の配列またはリストである必要があります。 - データ ソースにはデータ項目を少なくとも 1 つ含む必要があり、含まれない場合はマップでノードがレンダリングされません。 -- すべてのデータ項目には、`LabelMemberPath` プロパティにマッピングする必要があるデータ列 (文字列など) を少なくとも 1 列含める必要があります。 -- すべてのデータ項目には、`ValueMemberPath` プロパティにマッピングする必要がある数値データ列を少なくとも 1 列含める必要があります。 -- データを整理されたタイルに分類するには、オプションで `ParentIdMemberPath` および `IdMemberPath` を使用できます。 +- すべてのデータ項目には、 プロパティにマッピングする必要があるデータ列 (文字列など) を少なくとも 1 列含める必要があります。 +- すべてのデータ項目には、 プロパティにマッピングする必要がある数値データ列を少なくとも 1 列含める必要があります。 +- データを整理されたタイルに分類するには、オプションで および を使用できます。 ## Angular ツリーマップの構成 -次の例では、ツリーマップは、`LayoutType` プロパティと `LayoutOrientation` プロパティを変更することにより、アルゴリズム構造を変更する機能を示しています。 +次の例では、ツリーマップは、 プロパティと プロパティを変更することにより、アルゴリズム構造を変更する機能を示しています。 @@ -89,9 +89,9 @@ Ignite UI for Angular ツリーマップ チャートは、ネストされた一 ### レイアウト方向: -`LayoutOrientation` プロパティによってユーザーは階層のノードが展開される方向を設定できます。 + プロパティによってユーザーは階層のノードが展開される方向を設定できます。 -`LayoutOrientation` プロパティがレイアウト タイプ SliceAndDice および Strip と動作することに注意してください。 + プロパティがレイアウト タイプ SliceAndDice および Strip と動作することに注意してください。 - `Horizontal` – 子ノードは水平に積み重ねられます (SliceAndDice)。 - `Vertical` – 子ノードは垂直に積み重ねられます (SliceAndDice)。 @@ -106,17 +106,17 @@ Ignite UI for Angular ツリーマップ チャートは、ネストされた一 ### Angular ツリーマップのハイライト表示 次の例では、ツリーマップでノードのハイライト機能を示しています。 -この機能には 2 つのオプションがあります。各ノードは、不透明度を下げることで個別に明るくしたり、他のすべてのノードに同じ効果をトリガーさせたりすることができます。この機能を有効にするには、`HighlightingMode` を Brighten または FadeOthers に設定します。 +この機能には 2 つのオプションがあります。各ノードは、不透明度を下げることで個別に明るくしたり、他のすべてのノードに同じ効果をトリガーさせたりすることができます。この機能を有効にするには、 を Brighten または FadeOthers に設定します。 ## Angular ツリーマップのパーセントベースのハイライト表示 -- `HighlightedItemsSource`: ハイライト表示された値を読み取るデータ ソースを指定します。null の場合、ハイライト表示された値は ItemsSource プロパティから読み取られます。 -- `HighlightedValueMemberPath`: ハイライト表示された値が読み取られるデータ ソース内のプロパティの名前を指定します。 -- `HighlightedValueOpacity`: ハイライト表示された値の背後にある通常の値の不透明度を制御します。 -- `HighlightedValuesDisplayMode`: ハイライト表示された値を有効または無効にします。 +- : ハイライト表示された値を読み取るデータ ソースを指定します。null の場合、ハイライト表示された値は ItemsSource プロパティから読み取られます。 +- : ハイライト表示された値が読み取られるデータ ソース内のプロパティの名前を指定します。 +- : ハイライト表示された値の背後にある通常の値の不透明度を制御します。 +- : ハイライト表示された値を有効または無効にします。 - Auto: ツリーマップによって、使用するモードが決まります。 - Overlay: ツリーマップには、通常の値の上にハイライト表示された値が表示され、通常の値にはわずかに不透明度が適用されます。 - Hidden: ツリーマップにはハイライト表示された値は表示されません。 diff --git a/docs/angular/src/content/jp/components/chip.mdx b/docs/angular/src/content/jp/components/chip.mdx index bf6c7292b3..1e7c7535a6 100644 --- a/docs/angular/src/content/jp/components/chip.mdx +++ b/docs/angular/src/content/jp/components/chip.mdx @@ -112,7 +112,7 @@ Ignite UI for Angular Chips モジュールまたはディレクティブをイ ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/circular-progress.mdx b/docs/angular/src/content/jp/components/circular-progress.mdx index ba980a538f..ac25965c2a 100644 --- a/docs/angular/src/content/jp/components/circular-progress.mdx +++ b/docs/angular/src/content/jp/components/circular-progress.mdx @@ -131,7 +131,7 @@ Ignite UI for Angular Progress Bar モジュールまたはディレクティブ ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/combo-templates.mdx b/docs/angular/src/content/jp/components/combo-templates.mdx index f249661cb9..2d65c2e353 100644 --- a/docs/angular/src/content/jp/components/combo-templates.mdx +++ b/docs/angular/src/content/jp/components/combo-templates.mdx @@ -132,7 +132,7 @@ export class AppModule {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/dashboard-tile.mdx b/docs/angular/src/content/jp/components/dashboard-tile.mdx index ce20722e43..942f7cca6b 100644 --- a/docs/angular/src/content/jp/components/dashboard-tile.mdx +++ b/docs/angular/src/content/jp/components/dashboard-tile.mdx @@ -9,15 +9,15 @@ _language: ja import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; import { Image } from 'astro:assets'; import dashboardTileToolbar from '@xplat-images/dashboard-tile-toolbar.png'; +import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; # Angular Dashboard Tile (ダッシュボード タイル) -Angular Dashboard Tile は、データ ソース コレクション/配列または単一のデータ ポイントを分析して、表示する最も適切な視覚化を決定する自動データ視覚化コンポーネントです。また、埋め込みの で提供される一連のツールを使用して、さまざまな方法で表示される視覚化を変更できます。 +Angular Dashboard Tile は、データ ソース コレクション/配列または単一のデータ ポイントを分析して、表示する最も適切な視覚化を決定する自動データ視覚化コンポーネントです。また、埋め込みの で提供される一連のツールを使用して、さまざまな方法で表示される視覚化を変更できます。 提供されたデータの形状に応じて、以下を含む多種多様な視覚化が選択可能です。これには以下が含まれますが、これらに限定されません: カテゴリ チャート、`ラジアル チャートと極座標チャート、散布図、地理マップ、ラジアル ゲージとリニア ゲージ、ファイナンシャル チャート、積層型チャート。 @@ -89,7 +89,7 @@ export class AppModule {} - [IgxLinearGauge](linear-gauge.md) - [IgxRadialGauge](radial-gauge.md) -デフォルトで選択されるデータ視覚化は、主にスキーマとバインドした `DataSource` の数によって決まります。たとえば、単一の数値をバインドすると `RadialGauge` が取得されますが、互いに区別しやすい値とラベルのペアのコレクションをバインドすると `DataPieChart` が取得されます。より多くの値パスを持つ `DataSource` をバインドすると、バインドされたコレクションの数に応じて、複数の列シリーズまたは線シリーズを持つ を受け取ります。また、`GeographicMap` を取得するために、`ShapeDataSource` または地理的ポイントを含むデータにバインドすることもできます。 +デフォルトで選択されるデータ視覚化は、主にスキーマとバインドした `DataSource` の数によって決まります。たとえば、単一の数値をバインドすると が取得されますが、互いに区別しやすい値とラベルのペアのコレクションをバインドすると が取得されます。より多くの値パスを持つ `DataSource` をバインドすると、バインドされたコレクションの数に応じて、複数の列シリーズまたは線シリーズを持つ を受け取ります。また、 を取得するために、`ShapeDataSource` または地理的ポイントを含むデータにバインドすることもできます。 `DataSource` をバインドするときに単一の視覚化にロックされることはなく、`VisualizationType` プロパティを設定することで、特定の視覚化を表示することをコントロールに指示できます。たとえば、特に折れ線チャートを表示したい場合は、次のように Dashboard Tile を定義できます。 @@ -97,7 +97,7 @@ export class AppModule {} -視覚化または視覚化のプロパティも、コントロールの上部にある を使用して構成できます。この には、現在の視覚化の既定のツールに加えて、以下で強調表示されている 4 つの Dashboard Tile 固有のツールが含まれています。 +視覚化または視覚化のプロパティも、コントロールの上部にある を使用して構成できます。この には、現在の視覚化の既定のツールに加えて、以下で強調表示されている 4 つの Dashboard Tile 固有のツールが含まれています。 Dashboard Tile Toolbar @@ -106,7 +106,7 @@ export class AppModule {} - 最初のツールは、コントロールに提供された `DataSource` を含むデータ グリッドを表示します。これは切り替えツールなので、グリッドを表示した後にもう一度クリックすると、視覚化に戻ります。 - 2 番目のツールを使用すると、現在のデータ視覚化の設定を構成できます。 - 3 番目のツールを使用すると、現在の視覚化を変更して、異なるシリーズ タイプをプロットしたり、まったく異なるタイプの視覚化を表示したりすることができます。これは、前述の `VisualizationType` プロパティを設定することによってコントロール上で設定できます。 -- 最後のツールを使用すると、基になるデータ項目のどのプロパティをコントロールに含めるかを構成できます。これを構成するには、コントロールに `IncludedProperties` または `ExcludedProperties` コレクションを設定します。 +- 最後のツールを使用すると、基になるデータ項目のどのプロパティをコントロールに含めるかを構成できます。これを構成するには、コントロールに または コレクションを設定します。 このデモでは、ダッシュボード タイルと Angular 円チャートの統合を示します。右上のツールバー オプションを使用すると、スタイル設定やデータ視覚化の変更にアクセスできます。 @@ -122,7 +122,7 @@ export class AppModule {} -
+



diff --git a/docs/angular/src/content/jp/components/date-picker.mdx b/docs/angular/src/content/jp/components/date-picker.mdx index 438a15de31..00402da7ed 100644 --- a/docs/angular/src/content/jp/components/date-picker.mdx +++ b/docs/angular/src/content/jp/components/date-picker.mdx @@ -160,7 +160,7 @@ export class SampleFormComponent { ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/date-range-picker.mdx b/docs/angular/src/content/jp/components/date-range-picker.mdx index 0a87db4870..64fb44fa33 100644 --- a/docs/angular/src/content/jp/components/date-range-picker.mdx +++ b/docs/angular/src/content/jp/components/date-range-picker.mdx @@ -119,7 +119,7 @@ Angular Date Range Picker コンポーネントは、開始日と終了日の 2 ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/dialog.mdx b/docs/angular/src/content/jp/components/dialog.mdx index a9722eff8f..a7612ef67a 100644 --- a/docs/angular/src/content/jp/components/dialog.mdx +++ b/docs/angular/src/content/jp/components/dialog.mdx @@ -80,7 +80,7 @@ export class HomeComponent {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/drop-down.mdx b/docs/angular/src/content/jp/components/drop-down.mdx index d61ee714cd..44220fc51b 100644 --- a/docs/angular/src/content/jp/components/drop-down.mdx +++ b/docs/angular/src/content/jp/components/drop-down.mdx @@ -106,7 +106,7 @@ Ignite UI for Angular Drop Down モジュールまたはディレクティブを ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/excel-library-using-cells.mdx b/docs/angular/src/content/jp/components/excel-library-using-cells.mdx index 7f5e0f731b..6e541ac0f8 100644 --- a/docs/angular/src/content/jp/components/excel-library-using-cells.mdx +++ b/docs/angular/src/content/jp/components/excel-library-using-cells.mdx @@ -47,7 +47,7 @@ import { FormattedString } from "igniteui-angular-excel"; ## セルと領域を参照 - オブジェクトの `GetCell` または `GetRegion` メソッドを呼び出して オブジェクト または オブジェクトへアクセスできます。両メソッドはセルを参照する文字列パラメーターを許容します。書式設定を適用する場合または数式とセルのコンテンツで作業する場合にセル参照を取得すると便利です。 + オブジェクトの または メソッドを呼び出して オブジェクト または オブジェクトへアクセスできます。両メソッドはセルを参照する文字列パラメーターを許容します。書式設定を適用する場合または数式とセルのコンテンツで作業する場合にセル参照を取得すると便利です。 以下のコード例では、セルと領域を参照する方法を示します。 @@ -67,7 +67,7 @@ var region = worksheet.getRegion("G1:G10"); Microsoft Excel では各セルとセル領域に名前が割り当てられています。アドレスの代わりにセルまたは領域の名前を使用してセルまたは領域を参照できます。 -Infragistics Angular Excel Library は、 オブジェクトの `GetCell` と `GetRegion` メソッドによって、名前によるセルおよび領域の参照をサポートします。そのセルまたは領域を参照する `NamedReference` インスタンスを使用してセルまたは領域を参照します。 +Infragistics Angular Excel Library は、 オブジェクトの メソッドによって、名前によるセルおよび領域の参照をサポートします。そのセルまたは領域を参照する インスタンスを使用してセルまたは領域を参照します。 以下のコード スニペットは、セルまたは領域の名前の例です。 @@ -111,7 +111,7 @@ worksheet.rows(0).cells(0).comment = cellComment; ## セルに数式を追加 -Infragistics Excel ライブラリは、ワークシートでセルまたはセルのグループに Microsoft Excel の数式を追加できます。 オブジェクトの `ApplyFormula` メソッドを使用、または オブジェクトを初期化してセルに割り当てることができます。セルに数式を適用する方法に関わらず、 オブジェクトのプロパティを使用して オブジェクトにアクセスできます。値が必要な場合、セルの `Value` プロパティを使用します。 +Infragistics Excel ライブラリは、ワークシートでセルまたはセルのグループに Microsoft Excel の数式を追加できます。 オブジェクトの メソッドを使用、または オブジェクトを初期化してセルに割り当てることができます。セルに数式を適用する方法に関わらず、 オブジェクトのプロパティを使用して オブジェクトにアクセスできます。値が必要な場合、セルの プロパティを使用します。 以下のコードは、セルに数式を追加する方法を示します。 @@ -128,7 +128,7 @@ Infragistics Excel ライブラリは、ワークシートでセルまたはセ ## セル書式のコピー -セルには背景色、書式文字列、フォント スタイルなどさまざまな書式を持つことができます。以前書式設定したセルと同じ書式を持つようにする場合、 オブジェクトの プロパティで公開した各オプションを設定する代わりに オブジェクトの `SetFormatting` メソッドを呼び出して オブジェクトへ渡してコピーします。これによって最初のセルから 2 番目のセルにすべての書式設定をコピーします。行、結合セル領域、または列でも行うことができます。 +セルには背景色、書式文字列、フォント スタイルなどさまざまな書式を持つことができます。以前書式設定したセルと同じ書式を持つようにする場合、 オブジェクトの プロパティで公開した各オプションを設定する代わりに オブジェクトの メソッドを呼び出して オブジェクトへ渡してコピーします。これによって最初のセルから 2 番目のセルにすべての書式設定をコピーします。行、結合セル領域、または列でも行うことができます。 以下のコードは、2 列目の書式を 4 列目にコピーする方法を示します。 @@ -148,7 +148,7 @@ worksheet.columns(3).cellFormat.setFormatting(worksheet.columns(1).cellFormat); ## セルの書式設定 -Infragistics Angular Excel Library は、セルの外観と動作をカスタマイズすることができます。、または `WorksheetMergedCellsRegion` オブジェクトの プロパティで公開したプロパティを設定してセルをカスタマイズできます。 +Infragistics Angular Excel Library は、セルの外観と動作をカスタマイズすることができます。、または オブジェクトの プロパティで公開したプロパティを設定してセルをカスタマイズできます。 セル外観の各アスペクトをカスタマイズできます。セルのフォント、背景、境界線だけでなくテキストの配列と回転を設定できます。セルのテキストで文字ごとに異なる書式を適用することさえ可能です。 @@ -173,9 +173,9 @@ worksheet.columns(2).cellFormat.formatString = "\"$\"#,##0.00"; - `NoColor` - 色なしの塗りつぶしを表すプロパティ。ワークシートの背景画像がある場合は透けて見えます。 -- `CreateSolidFill` - Solid のパターン スタイルと、メソッドで指定された `Color` または に設定された背景色を持つ インスタンスを返します。 +- `CreateSolidFill` - Solid のパターン スタイルと、メソッドで指定された または に設定された背景色を持つ インスタンスを返します。 -- `CreatePatternFill` - 指定されたパターン スタイルと、背景とパターンの色に指定された `Color` または 値がある インスタンスを返します。 +- `CreatePatternFill` - 指定されたパターン スタイルと、背景とパターンの色に指定された または 値がある インスタンスを返します。 - `CreateLinearGradientFill` - 角度とグラデーション境界が指定された インスタンスを返します。 @@ -243,7 +243,7 @@ RGB またはテーマの色が使用される場合、色を明るくする、 色は、シールされた不変クラスである クラスで定義されます。このクラスには静的な `Automatic` プロパティがあり、自動的な色を返します。色またはテーマ値とオプションの濃淡で インスタンスを作成することを可能にするさまざまなコンストラクタがあります。 - の `GetResolvedColor` メソッドは、Excel でファイルを開く際にユーザーに実際に表示される色を決定することが可能となります。 + メソッドは、Excel でファイルを開く際にユーザーに実際に表示される色を決定することが可能となります。 がテーマの色を表す場合、Workbook インストールをこのメソッドに渡す必要があります。これによってテーマの色の RGB 値をワークブックから取得できます。 @@ -255,35 +255,35 @@ RGB またはテーマの色が使用される場合、色を明るくする、 セルの `cellFormat` プロパティから返された オブジェクトを使用して でさまざまな形式のホストを設定できます。この オブジェクトはさまざまなセルの側面 (境界線、フォント、塗りつぶし、配置) のスタイル設定、セルのサイズ自動調整やロックなどを設定できます。 - オブジェクトの `Styles` コレクションを使用して Microsoft Excel 2007 ビルトイン スタイルにアクセスできます。Excel のスタイル リストは、Microsoft Excel 2007 で [ホーム] タブの [セルのスタイル] ギャラリーにあります。 + オブジェクトの コレクションを使用して Microsoft Excel 2007 ビルトイン スタイルにアクセスできます。Excel のスタイル リストは、Microsoft Excel 2007 で [ホーム] タブの [セルのスタイル] ギャラリーにあります。 -ワークブックの `Styles` コレクションに標準スタイルという特別なタイプのスタイルがあり、コレクションの `NormalStyle` プロパティによって、または Normal という名前でコレクションにインデックスしてアクセスできます。 +ワークブックの コレクションに標準スタイルという特別なタイプのスタイルがあり、コレクションの プロパティによって、または Normal という名前でコレクションにインデックスしてアクセスできます。 -`NormalStyle` にはワークブックのすべてのセルのデフォルトのプロパティが含まれています。ただし、行、列またはセルで指定されている場合はその限りではありません。`NormalStyle` でプロパティを変更すると、ワークブックのすべてのデフォルトのセル書式プロパティが変更されます。ワークブックの既定のフォント以外に変更したい場合などに便利です。 + にはワークブックのすべてのセルのデフォルトのプロパティが含まれています。ただし、行、列またはセルで指定されている場合はその限りではありません。 でプロパティを変更すると、ワークブックのすべてのデフォルトのセル書式プロパティが変更されます。ワークブックの既定のフォント以外に変更したい場合などに便利です。 -以下のメソッドを使用して `Styles` コレクションのクリア、または `Clear` や `Reset` メソッドで定義された状態にリセットすることができます。両メソッドはすべてのユーザー定義スタイルを削除しますが `Clear` は `Styles` コレクション全体をクリアします。 +以下のメソッドを使用して コレクションのクリア、または メソッドで定義された状態にリセットすることができます。両メソッドはすべてのユーザー定義スタイルを削除しますが コレクション全体をクリアします。 -この機能では、`Style` プロパティが オブジェクトに追加されています。これは書式の親スタイルを表す、 インターフェイスへの参照です。スタイルの書式では、このプロパティは常に null です。スタイルが親スタイルを持つことができないためです。行、列およびセル書式には、`Style` プロパティが常にデフォルトで `NormalStyle` スタイルを返します。 +この機能では、 プロパティが オブジェクトに追加されています。これは書式の親スタイルを表す、 インターフェイスへの参照です。スタイルの書式では、このプロパティは常に null です。スタイルが親スタイルを持つことができないためです。行、列およびセル書式には、 プロパティが常にデフォルトで スタイルを返します。 -`Style` プロパティを null に設定した場合、`NormalStyle` スタイルに戻ります。スタイル コレクションで別のスタイルに設定される場合、そのスタイルはセル書式にすべての未設定のプロパティのデフォルトを保持するようになります。 + プロパティを null に設定した場合、 スタイルに戻ります。スタイル コレクションで別のスタイルに設定される場合、そのスタイルはセル書式にすべての未設定のプロパティのデフォルトを保持するようになります。 -`Style` プロパティをセル書式に設定した場合、`Style` に含まれる書式オプションはセル書式から削除されます。すべてのその他のプロパティはそのまま残されます。たとえば、境界線の書式を含むセルの `Style` を作成してスタイルをセルのスタイルとして設定した場合、セル書式の境界線の書式オプションは削除され、セル書式に塗りつぶしの書式のみ含まれます。 + プロパティをセル書式に設定した場合、 に含まれる書式オプションはセル書式から削除されます。すべてのその他のプロパティはそのまま残されます。たとえば、境界線の書式を含むセルの を作成してスタイルをセルのスタイルとして設定した場合、セル書式の境界線の書式オプションは削除され、セル書式に塗りつぶしの書式のみ含まれます。 書式オプション フラグが書式から削除されると、すべての関連付けたプロパティは未設定値にリセットされます。したがってセル書式の罫線プロパティはデフォルト/未設定値に暗黙的にリセットされます。 -行、列、セルおよび結合セルを表すクラスで、`GetResolvedCellFormat` メソッドを使用することで、セルに実際に何が表示されるかを決定できます。 +行、列、セルおよび結合セルを表すクラスで、 メソッドを使用することで、セルに実際に何が表示されるかを決定できます。 -このメソッドは、ベースとなった関連付けられた に参照を返す インスタンスを返します。そのため プロパティへの以降の変更は、`GetResolvedCellFormat` の呼び出しから返されるインスタンスに反映されます。 +このメソッドは、ベースとなった関連付けられた に参照を返す インスタンスを返します。そのため プロパティへの以降の変更は、 の呼び出しから返されるインスタンスに反映されます。 ## セルの結合 セルの値または書式の設定以外に、2 つ以上のセルをひとつのセルとして表示するためにセルを結合することができます。セルを結合する場合、長方形の領域内にセルがなければなりません。 -セルを結合した場合、領域の各セルが同じ値とセル書式になります。結合セルは同じ `WorksheetMergedCellsRegion` オブジェクトに関連付けされ、`AssociatedMergedCellsRegion` プロパティからアクセスできるようになります。`WorksheetMergedCellsRegion` オブジェクトも結果としてセルと同じ値およびセル書式になります。 +セルを結合した場合、領域の各セルが同じ値とセル書式になります。結合セルは同じ オブジェクトに関連付けされ、 プロパティからアクセスできるようになります。 オブジェクトも結果としてセルと同じ値およびセル書式になります。 領域または領域内の任意のセルの値 (またはセル書式) を設定すると、すべてのセルおよび領域の値を変更します。セルを結合を解除する場合、以前結合したセルすべて結合以前に指定された共有のセル書式を保持します。ただし、領域の左上のセルのみが共有値を保持します。 -結合されたセル領域を作成するには、セルの範囲を オブジェクトの `MergedCellsRegions` コレクションに追加する必要があります。このコレクションは、4 つの整数パラメーターを取得する `Add` メソッドを公開します。4 つのパラメーターは、開始する行と列 (左上隅のセル) のインデックス、および終了する行と列 (右下隅のセル) のインデックスを決定します。 +結合されたセル領域を作成するには、セルの範囲を オブジェクトの コレクションに追加する必要があります。このコレクションは、4 つの整数パラメーターを取得する `Add` メソッドを公開します。4 つのパラメーターは、開始する行と列 (左上隅のセル) のインデックス、および終了する行と列 (右下隅のセル) のインデックスを決定します。 ```ts var workbook = new Workbook(); @@ -347,11 +347,11 @@ worksheet.rows(0).cells(2).cellFormat.alignment = HorizontalCellAlignment.Center これが該当しない唯一のときは、パディング文字が書式文字列で使用される時です。テキストのために十分な余地がないとき、値はすべてのハッシュ マークとして表示されます。 -ワークシートの `DisplayOptions` の `ShowFormulasInCells` プロパティを設定してセルに結果の代わりに数式を表示できます。書式文字列やセル幅は無視されます。テキスト値は書式文字列が @ であるかのように表示します。整数でない数値は書式文字列が 0.0 であるかのように表示し、整数の数値は書式文字列が 0 のように表示します。 +ワークシートの プロパティを設定してセルに結果の代わりに数式を表示できます。書式文字列やセル幅は無視されます。テキスト値は書式文字列が @ であるかのように表示します。整数でない数値は書式文字列が 0.0 であるかのように表示し、整数の数値は書式文字列が 0 のように表示します。 さらに、値が合わない場合、すべてのハッシュとして表示しません。完全に表示できないとしても、表示テキストはセル テキストとしてフル テキストを今まで通り返します。 -以下のコード スニペットは、`GetText` メソッドを使用して Excel で表示されるようなテキストを取得する方法を示します。 +以下のコード スニペットは、 メソッドを使用して Excel で表示されるようなテキストを取得する方法を示します。 ```ts var workbook = new Workbook(); diff --git a/docs/angular/src/content/jp/components/excel-library-using-tables.mdx b/docs/angular/src/content/jp/components/excel-library-using-tables.mdx index 85ee3e66f2..d799112105 100644 --- a/docs/angular/src/content/jp/components/excel-library-using-tables.mdx +++ b/docs/angular/src/content/jp/components/excel-library-using-tables.mdx @@ -20,7 +20,7 @@ Angular Using Tables Example
## テーブルをワークシートに追加 -Infragistics Angular Excel Engine のワークシート テーブルは オブジェクトによって表され、ワー​​クシートの `Tables` コレクションに追加されます。テーブルを追加するには、このコレクションの `Add` メソッドを呼び出す必要があります。このメソッドでは、テーブルを追加する領域、テーブルにヘッダーを含めるかどうか、およびオプションで `WorksheetTableStyle` オブジェクトとしてテーブルのスタイルを指定できます。 +Infragistics Angular Excel Engine のワークシート テーブルは オブジェクトによって表され、ワー​​クシートの コレクションに追加されます。テーブルを追加するには、このコレクションの `Add` メソッドを呼び出す必要があります。このメソッドでは、テーブルを追加する領域、テーブルにヘッダーを含めるかどうか、およびオプションで オブジェクトとしてテーブルのスタイルを指定できます。 以下のコード サンプルは、ヘッダーを含むテーブルを の A1 to G10 (A1 to G1 が列ヘッダー) 領域に追加する方法を示します。 @@ -33,7 +33,7 @@ worksheet.tables().add("A1:G10", true); -テーブルを追加後 で `InsertColumns`、`InsertDataRows`、`DeleteColumns`、または `DeleteDataRows` メソッドを呼び出して行列を追加または削除して変更できます。テーブルの `Resize` メソッドを使用して新しいテーブル範囲を設定できます。 +テーブルを追加後 、または メソッドを呼び出して行列を追加または削除して変更できます。テーブルの メソッドを使用して新しいテーブル範囲を設定できます。 以下のコード スニペットは、3 つのメソッドの使用方法を示します。 @@ -63,19 +63,19 @@ table.resize("A1:G15"); ## テーブルのフィルタリング の列にフィルターを適用します。フィルターが列で適用されると、テーブルに適用したすべてのフィルター条件と一致する行を決定するために再評価されます。 -テーブルのデータを後で変更または行の `Hidden` プロパティを変更した場合、フィルター条件は自動的に再評価されません。テーブルのフィルター条件は、テーブルの列フィルターが追加、削除、変更されたときか、`ReapplyFilters` メソッドがテーブルに対して呼び出されたときに限り再適用されます。 +テーブルのデータを後で変更または行の `Hidden` プロパティを変更した場合、フィルター条件は自動的に再評価されません。テーブルのフィルター条件は、テーブルの列フィルターが追加、削除、変更されたときか、 メソッドがテーブルに対して呼び出されたときに限り再適用されます。 以下は、 の列で使用できるフィルター タイプです。 -- `AverageFilter` - このコードは、列のすべてのセルの平均値の上か下かに基づいてセルをフィルターする方法を示します。 -- `CustomFilter` - 1 つ以上のカスタム条件に基づいてセルをフィルターできます。 -- `DatePeriodFilter` - 年の特定の月または四半期の日付を含むセルのみが表示されます。 -- `FillFilter` - 特定の塗りつぶしを含むセルのみが表示されます。 -- `FixedValuesFilter` - 特定の表示値のみに一致するまたは日付/時間の特定のグループ内に分類されるセルが表示されます。 -- `FontColorFilter` - 特定のフォントの色を含むセルのみが表示されます。 -- `RelativeDateRangeFilter` - フィルターが適用されたときに、以下の日または前の四半期のように日付の相対的な時間の範囲内で発生するかどうかに基づいて、日付値ををフィルターできます。 -- `TopOrBottomFilter` - このフィルターはトップまたはボトム N 値をフィルターします。このフィルターはトップまたはボトム N %値をフィルターします。 -- `YearToDateFilter` - 年の始まりとフィルターが適用される日付の間に発生する場合、日付値を含むYearToDateFilter-をフィルターできます。 +- - このコードは、列のすべてのセルの平均値の上か下かに基づいてセルをフィルターする方法を示します。 +- - 1 つ以上のカスタム条件に基づいてセルをフィルターできます。 +- - 年の特定の月または四半期の日付を含むセルのみが表示されます。 +- - 特定の塗りつぶしを含むセルのみが表示されます。 +- - 特定の表示値のみに一致するまたは日付/時間の特定のグループ内に分類されるセルが表示されます。 +- - 特定のフォントの色を含むセルのみが表示されます。 +- - フィルターが適用されたときに、以下の日または前の四半期のように日付の相対的な時間の範囲内で発生するかどうかに基づいて、日付値ををフィルターできます。 +- - このフィルターはトップまたはボトム N 値をフィルターします。このフィルターはトップまたはボトム N %値をフィルターします。 +- - 年の始まりとフィルターが適用される日付の間に発生する場合、日付値を含むYearToDateFilter-をフィルターできます。 以下のコード スニペットは、 の最初の列に平均を超えるフィルターを適用する方法を示します。 @@ -92,20 +92,20 @@ table.columns(0).applyAverageFilter(AverageFilterType.AboveAverage); ## テーブルのソート テーブル列でソート条件を設定するとソートが実行されます。ソート条件が列で設定されると、テーブルのセルの順番を決定するためにテーブルのすべてのソート条件が再評価されます。ソートの基準を満たすためにセルを移動させる必要があるとき、テーブルのセルの行全体が 1 つの単位として移動されます。 -テーブルのデータが後で変更される場合、ソート条件は自動的に再評価されません。テーブルのソート条件は、ソート条件が追加、削除、変更される時に、または `ReapplySortConditions` メソッドがテーブルで呼び出されるときに限り再適用されます。ソート条件が再評価されると、表示されたセルのみがソートられます。非表示行のすべてのセルは適切に維持されます。 +テーブルのデータが後で変更される場合、ソート条件は自動的に再評価されません。テーブルのソート条件は、ソート条件が追加、削除、変更される時に、または メソッドがテーブルで呼び出されるときに限り再適用されます。ソート条件が再評価されると、表示されたセルのみがソートられます。非表示行のすべてのセルは適切に維持されます。 -テーブル列からソート条件へアクセスする以外に の `SortSettings` プロパティの `SortConditions` コレクションからも公開されます。これは、列/ソート条件のペアの順番に並べられたコレクションです。このコレクション内の順序はソートの優先順位です。 +テーブル列からソート条件へアクセスする以外に プロパティの コレクションからも公開されます。これは、列/ソート条件のペアの順番に並べられたコレクションです。このコレクション内の順序はソートの優先順位です。 列に設定可能なソート条件タイプは以下のとおりです。 -- `OrderedSortCondition` - セル値に基づいてセルを昇順または降順にソートします。 -- `CustomListSortCondition` - テキストまたは表示値に基づいて定義された順序でセルをソートします。このソート方法は、日付がカレンダーに表示されるためアルファベット順よりも便利です。 -- `FillSortCondition` - 塗りつぶしが特定のパターン/グラデーションであるかどうかに基づいてセルをソートします。 -- `FontColorSortCondition` - フォントが特定の色であるかどうかによってセルをソートします。 +- - セル値に基づいてセルを昇順または降順にソートします。 +- - テキストまたは表示値に基づいて定義された順序でセルをソートします。このソート方法は、日付がカレンダーに表示されるためアルファベット順よりも便利です。 +- - 塗りつぶしが特定のパターン/グラデーションであるかどうかに基づいてセルをソートします。 +- - フォントが特定の色であるかどうかによってセルをソートします。 -また の `SortSettings` の `CaseSensitive` プロパティは、文字列が大文字と小文字を区別してソートできるかどうかを開発者が設定できます。 +また プロパティは、文字列が大文字と小文字を区別してソートできるかどうかを開発者が設定できます。 -以下のコード スニペットは、 に `OrderedSortCondition` を適用する方法です。 +以下のコード スニペットは、 を適用する方法です。 ```ts var workbook = new Workbook(WorkbookFormat.Excel2007); diff --git a/docs/angular/src/content/jp/components/excel-library-using-workbooks.mdx b/docs/angular/src/content/jp/components/excel-library-using-workbooks.mdx index c3b28e70bb..92ee64f0b7 100644 --- a/docs/angular/src/content/jp/components/excel-library-using-workbooks.mdx +++ b/docs/angular/src/content/jp/components/excel-library-using-workbooks.mdx @@ -26,7 +26,7 @@ Infragistics Angular Excel Engine は、データを Microsoft® Excel® に保 ## 既定のフォントを変更 - の新しいインスタンスを作成します。 の `Styles` コレクションに新しいフォントを追加します。このスタイルにはワークブックのすべてのセルのデフォルトのプロパティが含まれています。ただし、行、列またはセルで指定されている場合はその限りではありません。スタイルのプロパティを変更すると、ワークブックのデフォルトのセル書式プロパティが変更します。 + の新しいインスタンスを作成します。 コレクションに新しいフォントを追加します。このスタイルにはワークブックのすべてのセルのデフォルトのプロパティが含まれています。ただし、行、列またはセルで指定されている場合はその限りではありません。スタイルのプロパティを変更すると、ワークブックのデフォルトのセル書式プロパティが変更します。 ```ts var workbook = new Workbook(); @@ -42,23 +42,23 @@ font.height = 16 * 20; Microsoft Excel® ドキュメント プロパティは、ドキュメントの整理やトラッキングを改善するための情報を提供します。 オブジェクトの プロパティを使用してこれらのプロパティを設定するために、Infragistics Angular Excel Engine を使用できます。使用可能なプロパティは以下のとおりです。 -- `Author` +- -- `Title` +- -- `Subject` +- -- `Keywords` +- -- `Category` +- -- `Status` +- -- `Comments` +- -- `Company` +- -- `Manager` +- 以下のコードは、ブックを作成し、`title` および `status` ドキュメント プロパティを設定する方法を示します。 diff --git a/docs/angular/src/content/jp/components/excel-library-using-worksheets.mdx b/docs/angular/src/content/jp/components/excel-library-using-worksheets.mdx index 2771d780eb..73523cfc45 100644 --- a/docs/angular/src/content/jp/components/excel-library-using-worksheets.mdx +++ b/docs/angular/src/content/jp/components/excel-library-using-worksheets.mdx @@ -89,7 +89,7 @@ worksheet.displayOptions.showRowAndColumnHeaders = false; ## ワークシートの編集を設定 -デフォルトで保存する オブジェクトが有効です。 オブジェクトの `Protect` メソッドを使用してワークシートを保護することにより、ワークシートの編集を禁止できます。このメソッドは、保護する部分を決定する null 許容型 `bool` 引数が多くあり、オプションの 1 つは編集オブジェクトを許容し、**false** に設定した場合はワークシートの編集を防止します。 +デフォルトで保存する オブジェクトが有効です。 オブジェクトの メソッドを使用してワークシートを保護することにより、ワークシートの編集を禁止できます。このメソッドは、保護する部分を決定する null 許容型 `bool` 引数が多くあり、オプションの 1 つは編集オブジェクトを許容し、**false** に設定した場合はワークシートの編集を防止します。 以下のコードは、ワークシートで編集を無効にする方法を示します。 @@ -102,9 +102,9 @@ worksheet.protect(); - オブジェクトの `Protect` メソッドを使用して構造変更からワークシートを保護できます。 + オブジェクトの メソッドを使用して構造変更からワークシートを保護できます。 -保護が設定されると、Worksheet オブジェクトの保護をこれらのオブジェクトでオーバーライドするために、 オブジェクトの `Locked` プロパティを各セル、行、マージされたセル領域、または列で設定することができます。たとえば、1 つの列のセルを除き、ワークシートのすべてのセルを読み取り専用にする必要がある場合、特定の オブジェクトで プロパティの `Locked` を **false** に設定します。これにより、その列内のセルの編集をユーザーに許可し、ワークシートの他のセルの編集は禁止できます。 +保護が設定されると、Worksheet オブジェクトの保護をこれらのオブジェクトでオーバーライドするために、 オブジェクトの プロパティを各セル、行、マージされたセル領域、または列で設定することができます。たとえば、1 つの列のセルを除き、ワークシートのすべてのセルを読み取り専用にする必要がある場合、特定の オブジェクトで プロパティの を **false** に設定します。これにより、その列内のセルの編集をユーザーに許可し、ワークシートの他のセルの編集は禁止できます。 以下のコードはその方法を示します。 @@ -119,24 +119,24 @@ worksheet.columns(0).cellFormat.locked = false; ## ワークシート領域のフィルタリング -フィルタリングは、 オブジェクトの `filterSettings` プロパティから取得できるワークシートの でフィルター条件を設定できます。フィルター条件は、フィルター条件追加、削除、変更される時に、または `ReapplyFilters` メソッドがワークシートで呼び出されるときに限り再適用されます。フィルターは、領域内で常にデータを評価するわけではありません。 +フィルタリングは、 オブジェクトの `filterSettings` プロパティから取得できるワークシートの でフィルター条件を設定できます。フィルター条件は、フィルター条件追加、削除、変更される時に、または メソッドがワークシートで呼び出されるときに限り再適用されます。フィルターは、領域内で常にデータを評価するわけではありません。 - オブジェクトの `SetRegion` メソッドでフィルターを適用する領域を指定できます。 + オブジェクトの メソッドでフィルターを適用する領域を指定できます。 以下は、フィルターをワークシートに追加するためのメソッド一覧と概要です。 | メソッド | 説明 | | -------------|:-------------:| -|`ApplyAverageFilter`|データ範囲全体の平均を下回るデータであるか上回るデータであるかという条件に基づいてデータを絞り込むことのできるフィルターです。| -|`ApplyDatePeriodFilter`|月または四半期の日付をフィルターできるフィルターを表します。| -|`ApplyFillFilter`|背景の塗りつぶしに基づいてセルを絞り込むフィルターを表します。このフィルターには CellFill を 1 つ指定します。この塗りつぶしのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| +||データ範囲全体の平均を下回るデータであるか上回るデータであるかという条件に基づいてデータを絞り込むことのできるフィルターです。| +||月または四半期の日付をフィルターできるフィルターを表します。| +||背景の塗りつぶしに基づいてセルを絞り込むフィルターを表します。このフィルターには CellFill を 1 つ指定します。この塗りつぶしのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| |`ApplyFixedValuesFilter`|具体的な指定値に基づいて表示セルを絞り込むことのできるフィルターです。| -|`ApplyFontColorFilter`|フォントの色に基づいてセルを絞り込むフィルターを表します。このフィルターには 1 つの色を指定します。この色のフォントのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| -|`ApplyIconFilter`|条件付き書式アイコンに基づいてセルを絞り込むフィルターを表します。| -|`ApplyRelativeDateRangeFilter`|フィルターの適用日を基点とした相対日付によって日付セルの範囲を絞り込むことのできるフィルターです。| -|`ApplyTopOrBottomFilter`|ソートされた値リストの上位または下位にあるセルを表示できるフィルターです。| -|`ApplyYearToDateFilter`|日付セルの範囲を現在の年の開始日からフィルターの評価実施日までの期間に絞り込むことのできるフィルターです。| -|`ApplyCustomFilter`|1 つ、ないし 2 つのカスタム条件に基づいてデータを絞り込むことのできるフィルターです。この 2 つの絞り込み条件は論理積 (and) または論理和 (or) 演算子と組み合わせて使用できます。| +||フォントの色に基づいてセルを絞り込むフィルターを表します。このフィルターには 1 つの色を指定します。この色のフォントのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| +||条件付き書式アイコンに基づいてセルを絞り込むフィルターを表します。| +||フィルターの適用日を基点とした相対日付によって日付セルの範囲を絞り込むことのできるフィルターです。| +||ソートされた値リストの上位または下位にあるセルを表示できるフィルターです。| +||日付セルの範囲を現在の年の開始日からフィルターの評価実施日までの期間に絞り込むことのできるフィルターです。| +||1 つ、ないし 2 つのカスタム条件に基づいてデータを絞り込むことのできるフィルターです。この 2 つの絞り込み条件は論理積 (and) または論理和 (or) 演算子と組み合わせて使用できます。| 以下のコード スニペットを使用してフィルターをワークシート領域に追加します。 @@ -153,7 +153,7 @@ worksheet.filterSettings.applyAverageFilter(0, AverageFilterType.AboveAverage); ## ペインの固定と分割 ペイン固定機能は、行をワークシートの上または列を左にで固定できます。ユーザーがスクロールしている間、固定した行や列は表示されたままになります。固定された行列は、削除できない実線によってワークシートの残りの部分と区切られます。 -ペイン固定を有効にするために オブジェクトの プロパティを **true** に設定する必要があります。表示オプション `FrozenPaneSettings` の `FrozenRows` と `FrozenColumns` プロパティを使用して固定する行列を指定できます。 +ペイン固定を有効にするために オブジェクトの プロパティを **true** に設定する必要があります。表示オプション の `FrozenRows` と `FrozenColumns` プロパティを使用して固定する行列を指定できます。 また `FirstRowInBottomPane` と `FirstColumnInRightPane` を個々に使用して下ペインの最初の行または右ペインの最初の列を指定できます。 @@ -194,7 +194,7 @@ worksheet.displayOptions.magnificationInNormalView = 300; これには、シートの プロパティを使用して取得できる オブジェクトの に領域とソートタイプを指定します。 -シートのソート条件は、ソート条件が追加、削除、変更される時に、または `ReapplySortConditions` メソッドがワークシートで呼び出されるときに限り再適用されます。列または行を領域でソートします。'Rows' はデフォルトのソートタイプです。 +シートのソート条件は、ソート条件が追加、削除、変更される時に、または メソッドがワークシートで呼び出されるときに限り再適用されます。列または行を領域でソートします。'Rows' はデフォルトのソートタイプです。 以下のコード スニペットは、ワークシートのセル領域を適用する方法を示します。 @@ -208,7 +208,7 @@ worksheet.sortSettings.sortConditions().addItem(new RelativeIndex(0), new Ordere ## ワークシートの保護 - オブジェクトで `Protect` メソッドを呼び出してワークシートを保護できます。このメソッドは、以下のユーザー操作を制限または許容する null 許容型 `bool` パラメーターを公開します。 + オブジェクトで メソッドを呼び出してワークシートを保護できます。このメソッドは、以下のユーザー操作を制限または許容する null 許容型 `bool` パラメーターを公開します。 - セルの編集 - 図形、コメント、チャートなどのオブジェクトやコントロールを編集します。 @@ -221,7 +221,7 @@ worksheet.sortSettings.sortConditions().addItem(new RelativeIndex(0), new Ordere - データのソート。 - ピボット テーブルの使用 - オブジェクトで `Unprotect` メソッドを呼び出してワークシートの保護を削除できます。 + オブジェクトで メソッドを呼び出してワークシートの保護を削除できます。 以下のコード スニペットは、上記にリストされたすべてのユーザー操作を保護を有効にします。 @@ -236,11 +236,11 @@ worksheet.protect(); ## ワークシートの条件付き書式設定 - の条件付き書式を設定するには、ワークシートの `ConditionalFormats` コレクションで公開される多数の Add メソッドを使用できます。この Add メソッドの最初のパラメーターは条件付き書式に適用する Worksheet の `string` 領域です。 + の条件付き書式を設定するには、ワークシートの コレクションで公開される多数の Add メソッドを使用できます。この Add メソッドの最初のパラメーターは条件付き書式に適用する Worksheet の `string` 領域です。 -Worksheet に追加可能な条件付き書式にその条件が true の場合に 要素の外観を決定する プロパティがあります。たとえば、`Fill` や `Font` などのこの プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 +Worksheet に追加可能な条件付き書式にその条件が true の場合に 要素の外観を決定する プロパティがあります。たとえば、 などのこの プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 -ワークシート セルの可視化の動作が異なるため、 プロパティがない条件付き書式もあります。この条件付き書式は 、`IconSetConditionalFormat` です。 +ワークシート セルの可視化の動作が異なるため、 プロパティがない条件付き書式もあります。この条件付き書式は です。 既存の を Excel から読み込む際に、その が読み込まれた場合も書式設定は保持されます。 を Excel ファイルに保存する場合も保持されます。 diff --git a/docs/angular/src/content/jp/components/excel-library.mdx b/docs/angular/src/content/jp/components/excel-library.mdx index df22958e54..539adf0ee3 100644 --- a/docs/angular/src/content/jp/components/excel-library.mdx +++ b/docs/angular/src/content/jp/components/excel-library.mdx @@ -118,11 +118,11 @@ Excel ライブラリ は Excel Binary Workbook (.xlsb) フォーマットを現 -次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して `Workbook` を保存およびロードしています。 +次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して を保存およびロードしています。 -`Workbook` オブジェクトを読み込んで保存するために、実際の `Workbook` の保存メソッドや static な `Load` メソッドを使用できます。 + オブジェクトを読み込んで保存するために、実際の の保存メソッドや static な `Load` メソッドを使用できます。 ```ts diff --git a/docs/angular/src/content/jp/components/general-changelog-dv.mdx b/docs/angular/src/content/jp/components/general-changelog-dv.mdx index 159596fa67..e3a2623977 100644 --- a/docs/angular/src/content/jp/components/general-changelog-dv.mdx +++ b/docs/angular/src/content/jp/components/general-changelog-dv.mdx @@ -8,14 +8,16 @@ _language: ja --- import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro'; -import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; import { Image } from 'astro:assets'; import dataChartUserAnnotationCreate from '@xplat-images/charts/data-chart-user-annotation-create.gif'; import chartdefaults1 from '@xplat-images/chartDefaults1.png'; import chartdefaults2 from '@xplat-images/chartDefaults2.png'; import chartdefaults3 from '@xplat-images/chartDefaults3.png'; import chartdefaults4 from '@xplat-images/chartDefaults4.png'; +import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; + +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Ignite UI for Angular 変更ログ @@ -78,9 +80,9 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と #### ユーザー注釈 -Ignite UI for Angular では、ユーザー注釈機能により、実行時に `DataChart` にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 +Ignite UI for Angular では、ユーザー注釈機能により、実行時に にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 -これは、`Toolbar` のデフォルトのツールと統合されています。 +これは、 のデフォルトのツールと統合されています。 Angular user-annotation-create @@ -88,8 +90,8 @@ Ignite UI for Angular では、ユーザー注釈機能により、実行時に 軸注釈が自動で衝突を検出し、適切に収まるよう切り詰めます。この機能を有効にするには、次のプロパティを設定します: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### igniteui-angular-maps (地理マップ) @@ -131,15 +133,15 @@ Ignite UI for Angular では、ユーザー注釈機能により、実行時に #### 対応軸 -X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。`CompanionAxisEnabled` プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 +X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。 プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 #### RadialPieSeries インセット アウトライン -`RadialPieSeries` のアウトライン レンダリング方法を制御するために `UseInsetOutlines` プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 + のアウトライン レンダリング方法を制御するために プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 **重大な変更** -- `ChartMouseEventArgs` クラスの `PlotAreaPosition` プロパティと `ChartPosition` プロパティが逆になっている問題が修正されました。これにより、`PlotAreaPosition` と `ChartPosition` が返す値が変更されます。 +- クラスの プロパティと プロパティが逆になっている問題が修正されました。これにより、 が返す値が変更されます。 ### 機能拡張 @@ -151,11 +153,11 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 - DataToolTipLayer、ItemToolTipLayer、CategoryToolTipLayer にスタイル設定用の新しいプロパティが追加されました: `ToolTipBackground`、`ToolTipBorderBrush`、および `ToolTipBorderThickness`。 -- DataLegend にスタイル設定用の新しいプロパティが追加されました: `ContentBackground`、`ContentBorderBrush`、および `ContentBorderThickness`。`ContentBorderBrush` と `ContentBorderThickness` はそれぞれ既定で transparent と 0 に設定されているため、境界線を表示するにはこれらのプロパティを設定する必要があります。 +- DataLegend にスタイル設定用の新しいプロパティが追加されました: 、および はそれぞれ既定で transparent と 0 に設定されているため、境界線を表示するにはこれらのプロパティを設定する必要があります。 -- マウスのワールド相対位置を提供する `WorldPosition` という新しいプロパティが `ChartMouseEventArgs` に追加されました。この位置は、軸空間内の X 軸と Y 軸の両方に対して 0 から 1 の間の値になります。 +- マウスのワールド相対位置を提供する という新しいプロパティが に追加されました。この位置は、軸空間内の X 軸と Y 軸の両方に対して 0 から 1 の間の値になります。 -- `SeriesViewer` と `DomainChart` に `HighlightingFadeOpacity` が追加されました。ハイライト表示されたシリーズに適用される不透明度を設定できます。 +- が追加されました。ハイライト表示されたシリーズに適用される不透明度を設定できます。 - ドメイン チャートの `CalloutLabelUpdating` イベントを公開しました。 @@ -211,11 +213,11 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 - データ注釈スライス レイヤー - データ注釈ストリップ レイヤー -- [データ ツールチップ](charts/features/chart-data-tooltip.md)と[データ 凡例](charts/features/chart-data-legend.md)では、ツールチップまたは凡例のコンテンツをテーブルまたは垂直レイアウト構造でレイアウトするために使用できる `LayoutMode` プロパティが公開されています。 +- [データ ツールチップ](charts/features/chart-data-tooltip.md)と[データ 凡例](charts/features/chart-data-legend.md)では、ツールチップまたは凡例のコンテンツをテーブルまたは垂直レイアウト構造でレイアウトするために使用できる プロパティが公開されています。 -- チャートの `DefaultInteraction` プロパティが更新され、新しい列挙体 `DragSelect` が含まれるようになりました。これにより、ドラッグされたプレビュー Rect は、その中に含まれるポイントを選択します。 (ベータ版) +- チャートの プロパティが更新され、新しい列挙体 `DragSelect` が含まれるようになりました。これにより、ドラッグされたプレビュー Rect は、その中に含まれるポイントを選択します。 (ベータ版) -- [ValueOverlay と ValueLayer](charts/features/chart-overlays.md) は、上記にリストした [チャート データ注釈](charts/features/chart-data-annotations.md)に加えて、プロット領域に追加の注釈テキストをオーバーレイするために使用できる `OverlayText` プロパティを公開するようになりました。これらの注釈の外観は、OverlayText プレフィックスが付いた多くのプロパティを使用して構成できます。たとえば、`OverlayTextBrush` プロパティはオーバーレイ テキストの色を構成します。 (ベータ版) +- [ValueOverlay と ValueLayer](charts/features/chart-overlays.md) は、上記にリストした [チャート データ注釈](charts/features/chart-data-annotations.md)に加えて、プロット領域に追加の注釈テキストをオーバーレイするために使用できる プロパティを公開するようになりました。これらの注釈の外観は、OverlayText プレフィックスが付いた多くのプロパティを使用して構成できます。たとえば、`OverlayTextBrush` プロパティはオーバーレイ テキストの色を構成します。 (ベータ版) - [トレンドライン レイヤー](charts/features/chart-trendlines.md) シリーズ タイプを使用すると、トレンド ライン レイヤーごとに 1 つのトレンド ラインを特定のシリーズに適用できます。これにより、チャートに複数の [TrendlineLayer](charts/features/chart-overlays.md) シリーズ タイプを使用できるため、単一のシリーズで複数のトレンド ラインを使用できるようになります。 @@ -252,9 +254,9 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 #### Toolbar -- `Toolbar` と `ToolPanel` に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての `ToolActionGroupHeader` アクションに適用されます。 -- タイトル テキストの水平方向の配置を制御する `TitleHorizontalAlignment` という新しいプロパティを `ToolAction` に追加しました。 -- `ToolActionSubPanel` に、パネル内の項目間の間隔を制御する `ItemSpacing` という新しいプロパティを追加しました。 +- に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての アクションに適用されます。 +- タイトル テキストの水平方向の配置を制御する という新しいプロパティを に追加しました。 +- に、パネル内の項目間の間隔を制御する という新しいプロパティを追加しました。 ### バグ修正 @@ -292,11 +294,11 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 ## **18.1.0 (September 2024)** -- [データ円チャート](charts/types/data-pie-chart.md) - `DataPieChart` は円ャートを表示する新しいコンポーネントです。このコンポーネントは、`CategoryChart` と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、ハイライト表示、アニメーション、凡例のサポートを可能にします。 +- [データ円チャート](charts/types/data-pie-chart.md) - は円ャートを表示する新しいコンポーネントです。このコンポーネントは、 と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、ハイライト表示、アニメーション、凡例のサポートを可能にします。 -- [比例カテゴリ角度軸](charts/types/radial-chart.md) - スライスをプロットするための、`DataChart` のラジアル円シリーズの新しい軸。円チャートに似ており、データ ポイントが円グラフ内のセグメントとして表されます。 +- [比例カテゴリ角度軸](charts/types/radial-chart.md) - スライスをプロットするための、 のラジアル円シリーズの新しい軸。円チャートに似ており、データ ポイントが円グラフ内のセグメントとして表されます。 -- `Toolbar` +- - 新しい ToolActionCheckboxList 選択用のチェックボックスを備えた項目のコレクションを表示する新しい CheckboxList ToolAction。ToolAction CheckboxList 内のグリッドの高さは 5 項目まで大きくなり、その後スクロールバーが表示されます。 @@ -315,78 +317,78 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 ### igniteui-angular-charts (チャート) -- [データ凡例のグループ化](charts/features/chart-data-legend.md#angular-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#angular-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。`GroupRowVisible` プロパティは、各シリーズのグループ化を切り替え、オプトインすると `DataLegendGroup` プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 +- [データ凡例のグループ化](charts/features/chart-data-legend.md#angular-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#angular-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。 プロパティは、各シリーズのグループ化を切り替え、オプトインすると プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 -- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、`CategoryChart` および `DataChart` のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 -複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと `SelectedSeriesItems` は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 +- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、 および のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 +複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 -- [ツリーマップのハイライト表示](charts/types/treemap-chart.md#angular-リーマップのハイライト表示) - ツリー マップの項目のマウスオーバーによるハイライト表示を構成できる `HighlightingMode` プロパティが公開されました。このプロパティには 2 つのオプションがあります: `Brighten` では、マウスを置いた項目にのみハイライト表示が適用され、`FadeOthers` では、マウスホバーした項目のハイライト表示はそのままで、それ以外はすべてフェードアウトします。このハイライト表示はアニメーション化されており、`HighlightingTransitionDuration` プロパティを使用して制御できます。 +- [ツリーマップのハイライト表示](charts/types/treemap-chart.md#angular-リーマップのハイライト表示) - ツリー マップの項目のマウスオーバーによるハイライト表示を構成できる プロパティが公開されました。このプロパティには 2 つのオプションがあります: `Brighten` では、マウスを置いた項目にのみハイライト表示が適用され、`FadeOthers` では、マウスホバーした項目のハイライト表示はそのままで、それ以外はすべてフェードアウトします。このハイライト表示はアニメーション化されており、 プロパティを使用して制御できます。 -- [ツリーマップのパーセントベースのハイライト表示](charts/types/treemap-chart.md#angular-ツリーマップのパーセントベースのハイライト表示) - 新しいパーセントベースのハイライト表示により、ノードはコレクションの進行状況またはサブセットを表すことができます。外観は、データ項目のメンバーによって、または新しい `HighlightedItemsSource` を指定することによって、特定の値までの背景色の塗りつぶしとして表示されます。`HighlightedValuesDisplayMode` で切り替えることができ、`FillBrushes` でスタイルを設定できます。 +- [ツリーマップのパーセントベースのハイライト表示](charts/types/treemap-chart.md#angular-ツリーマップのパーセントベースのハイライト表示) - 新しいパーセントベースのハイライト表示により、ノードはコレクションの進行状況またはサブセットを表すことができます。外観は、データ項目のメンバーによって、または新しい を指定することによって、特定の値までの背景色の塗りつぶしとして表示されます。 で切り替えることができ、`FillBrushes` でスタイルを設定できます。 -- `Toolbar` - 選択した特定のツールの周囲に境界線を描くための ToolAction の新しい `IsHighlighted` オプション。 +- - 選択した特定のツールの周囲に境界線を描くための ToolAction の新しい オプション。 ### igniteui-angular-gauges (ゲージ) -- `RadialGauge` - - ハイライト針の新しいラベル。`HighlightLabelText` と `HighlightLabelSnapsToNeedlePivot` および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 +- + - ハイライト針の新しいラベル。 および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 ## **18.0.0 (June 2024)** ### igniteui-angular-charts (チャート) -- [データ凡例のグループ化](charts/features/chart-data-legend.md#angular-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#angular-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。`GroupRowVisible` プロパティは、各シリーズのグループ化を切り替え、オプトインすると `DataLegendGroup` プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 +- [データ凡例のグループ化](charts/features/chart-data-legend.md#angular-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#angular-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。 プロパティは、各シリーズのグループ化を切り替え、オプトインすると プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 -- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、`CategoryChart` および `DataChart` のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 -複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと `SelectedSeriesItems` は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 +- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、 および のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 +複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 ### igniteui-angular-gauges (ゲージ) -- `RadialGauge` - - ハイライト針の新しいラベル。`HighlightLabelText` と `HighlightLabelSnapsToNeedlePivot` および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 +- + - ハイライト針の新しいラベル。 および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 ## **17.3.0 (March 2024)** ### igniteui-angular-charts -- `InitialFilter` プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 +- プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 ## igniteui-angular-gauges ### **17.2.0 (January 2024)** - Save tool action has been added to save the chart to an image via the clipboard. -- Vertical orientation has been added via the toolbar's `Orientation` property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. +- Vertical orientation has been added via the toolbar's property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's `renderImageFromText` method, further enhancing custom tool creation. ## igniteui-angular-charts (チャート) ### **17.0.0 (November 2023)** -- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our `DataChart` or `CategoryChart` components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. +- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our or components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. ### igniteui-angular - Toolbar - - クリップボードを介してチャートを画像に保存するための保存ツール アクションが追加されました。 -- ツールバーの `Orientation` プロパティを介して垂直方向が追加されました。デフォルトでは、ツールバーは水平方向ですが、ツールバーを垂直方向に表示できるようになり、ツールが左右にポップアップ表示されます。 +- ツールバーの プロパティを介して垂直方向が追加されました。デフォルトでは、ツールバーは水平方向ですが、ツールバーを垂直方向に表示できるようになり、ツールが左右にポップアップ表示されます。 - ツールバーの `renderImageFromText` メソッドを介してカスタム SVG アイコンのサポートが追加され、カスタム ツールの作成がさらに強化されました。 -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#angular-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#angular-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#angular-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#angular-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#angular-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#angular-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **16.1.0 (June 2023)** - Angular 16 support. ## 新しいコンポーネント -- [Toolbar](menus/toolbar.md) - このコンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、`DataChart` または `CategoryChart` コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 +- [Toolbar](menus/toolbar.md) - このコンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、 または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 ## igniteui-angular-charts (チャート) -- [ValueLayer](charts/features/chart-overlays.md#angular-value-layer) - `ValueLayer` という名前の新しいシリーズ タイプが公開されました。これにより、Maximum、Minimum、Average など、プロットされたデータのさまざまな焦点のオーバーレイを描画できます。これは、新しい `ValueLines` コレクションに追加することで、`CategoryChart` と `FinancialChart` に適用されます。 +- [ValueLayer](charts/features/chart-overlays.md#angular-value-layer) - という名前の新しいシリーズ タイプが公開されました。これにより、Maximum、Minimum、Average など、プロットされたデータのさまざまな焦点のオーバーレイを描画できます。これは、新しい コレクションに追加することで、 に適用されます。 -- **ダッシュ配列**を `DataChart` のシリーズのさまざまな部分に適用できるようになりました。これは、チャートにプロットされた[シリーズ](charts/types/line-chart.md#angular-折れ線チャートのスタイル設定)、チャートの[グリッド線](charts/features/chart-axis-gridlines.md#angular-軸グリッド線のプロパティ)、およびチャートにプロットされたシリーズの[トレンドライン](charts/features/chart-trendlines.md#angular-チャート-トレンドラインのダッシュ配列の例)に適用できます。 +- **ダッシュ配列**を のシリーズのさまざまな部分に適用できるようになりました。これは、チャートにプロットされた[シリーズ](charts/types/line-chart.md#angular-折れ線チャートのスタイル設定)、チャートの[グリッド線](charts/features/chart-axis-gridlines.md#angular-軸グリッド線のプロパティ)、およびチャートにプロットされたシリーズの[トレンドライン](charts/features/chart-trendlines.md#angular-チャート-トレンドラインのダッシュ配列の例)に適用できます。 -The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties` because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using | because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ## **16.0.0 (May 2023)** ### **15.0.0 (December 2022)** @@ -403,29 +405,29 @@ The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not w This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -446,23 +448,23 @@ This release introduces a few improvements and simplifications to visual design - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -502,30 +504,30 @@ These features are CTP ## igniteui-angular-charts (チャート) -このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、`DataChart`、`CategoryChart`、および `FinancialChart`。 +このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、、および 。 - 棒/縦棒/ウォーターフォール シリーズを、角丸ではなく角が四角になるように変更しました。 - heat min プロパティの 散布高密度シリーズの色を #8a5bb1 から #000000 に変更しました。 - heat max プロパティの 散布高密度シリーズの色を #ee5879 から #ee5879 に変更しました。 - ファイナンシャル/ウォーターフォール シリーズの `NegativeBrush` および `NegativeOutline` プロパティを #C62828 から #ee5879 に変更しました。 - マーカーの厚さを 1px から 2px に変更しました。 -- `PointSeries`、`BubbleSeries`、`ScatterSeries`、`PolarScatterSeries` のマーカーのアウトラインに一致するようにマーカーの塗りつぶしを変更しました。`MarkerFillMode` プロパティを Normal に設定すると、この変更を元に戻すことができます。 -- `TimeXAxis` および `OrdinalTimeXAxis` のラベリングを圧縮しました。 +- のマーカーのアウトラインに一致するようにマーカーの塗りつぶしを変更しました。 プロパティを Normal に設定すると、この変更を元に戻すことができます。 +- および のラベリングを圧縮しました。 - 新しいマーカー プロパティ: - - series.`MarkerFillMode` - マーカーがアウトラインに依存するように、`MatchMarkerOutline` に設定できます。 - - series.`MarkerFillOpacity` - 0〜1 の値に設定できます。 - - series.`MarkerOutlineMode` - マーカーのアウトラインが塗りブラシの色に依存するように、`MatchMarkerBrush` に設定できます。 + - series. - マーカーがアウトラインに依存するように、`MatchMarkerOutline` に設定できます。 + - series. - 0〜1 の値に設定できます。 + - series. - マーカーのアウトラインが塗りブラシの色に依存するように、`MatchMarkerBrush` に設定できます。 - 新シリーズプロパティ: - - series.`OutlineMode` - シリーズ アウトラインの表示を切り替えるように設定できます。データ チャートの場合、プロパティはシリーズ上にあることに注意してください。 - - チャートがデフォルトのズーム レベルにあるときにビューポートに導入されるブリード オーバー領域を定義する新しいチャート プロパティを追加しました。一般的な使用例では、軸と最初/最後のデータ ポイントの間にスペースを提供します。以下にリストされている `ComputedPlotAreaMarginMode` は、マーカーが有効になっているときに自動的にマージンを設定することに注意してください。その他は、厚さを表す `Double` を指定するように設計されており、PlotAreaMarginLeft などがチャートの 4 辺すべてにスペースを調整します: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - シリーズ アウトラインの表示を切り替えるように設定できます。データ チャートの場合、プロパティはシリーズ上にあることに注意してください。 + - チャートがデフォルトのズーム レベルにあるときにビューポートに導入されるブリード オーバー領域を定義する新しいチャート プロパティを追加しました。一般的な使用例では、軸と最初/最後のデータ ポイントの間にスペースを提供します。以下にリストされている は、マーカーが有効になっているときに自動的にマージンを設定することに注意してください。その他は、厚さを表す `Double` を指定するように設計されており、PlotAreaMarginLeft などがチャートの 4 辺すべてにスペースを調整します: + - chart. + - chart. + - chart. + - chart. + - chart. - 新しいハイライト表示プロパティ: - - chart.`HighlightingMode` - ホバーされたシリーズとホバーされていないシリーズをフェードまたは明るくするかを設定します。 - - chart.`HighlightingBehavior` - 真上または最も近い項目など、マウスの位置に応じてシリーズをハイライト表示するかどうかを設定します。 + - chart. - ホバーされたシリーズとホバーされていないシリーズをフェードまたは明るくするかを設定します。 + - chart. - 真上または最も近い項目など、マウスの位置に応じてシリーズをハイライト表示するかどうかを設定します。 - 以前のリリースでは、ハイライト表示はホバー時にフェードするように制限されていたことに注意してください。 - 積層型、散布図、極座標、ラジアル、図形シリーズにハイライト表示を追加しました。 - 積層型、散布図、極座標、ラジアル、図形注釈レイヤーを追加しました。 diff --git a/docs/angular/src/content/jp/components/general/cli/getting-started-with-angular-schematics.mdx b/docs/angular/src/content/jp/components/general/cli/getting-started-with-angular-schematics.mdx index 27630e2107..509615173e 100644 --- a/docs/angular/src/content/jp/components/general/cli/getting-started-with-angular-schematics.mdx +++ b/docs/angular/src/content/jp/components/general/cli/getting-started-with-angular-schematics.mdx @@ -222,7 +222,7 @@ Ignite UI CLI がグローバルにインストールされている場合、同 ig ai-config ``` - + `ig ai-config` コマンドは `igniteui mcp` と `igniteui-theming-mcp` の 2 つの Ignite UI エントリのみを設定し、`@angular/cli` は登録しません。3 つのサーバーをすべて一括設定するには `ng generate @igniteui/angular-schematics:ai-config` を使用してください。 diff --git a/docs/angular/src/content/jp/components/general/localization.mdx b/docs/angular/src/content/jp/components/general/localization.mdx index 30896b78ba..3ec4fcb45a 100644 --- a/docs/angular/src/content/jp/components/general/localization.mdx +++ b/docs/angular/src/content/jp/components/general/localization.mdx @@ -14,7 +14,7 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' ## ローカライズ (i18n) - + 21.1.0 以降、これが Ignite UI for Angular コンポーネントにローカライズを適用する推奨方法です。 @@ -26,7 +26,7 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' - + サンプルに含まれているヒンディー語 (HI) は、説明のみを目的としており、カスタム ローカライズ オブジェクトを渡す可能性を強調するためのものです。このサンプルでは、集計用にローカライズされたいくつかの文字列のみが含まれています。詳細については、以下の[カスタム ローカライズ リソース文字列](#カスタム-ローカライズ-リソース文字列)セクションをご覧ください。 @@ -54,7 +54,7 @@ setCurrentI18n('de'); この方法では、`HTML` タグの `lang` グローバル属性を通じてローカライズを設定できます。この属性は監視されており、変更されると、レンダリングされたすべてのコンポーネントが現在設定されている言語にリソース文字列を更新します。使用されるタグに関するすべてのルールは、上記の説明と同様に適用されます。 - + これはルート レベルでのみ機能し、ページ上の内部要素では機能しません。 @@ -246,7 +246,7 @@ public resourcesDE = GridResourceStringsDE; アプリをローカライズしたいが、使用している言語のリソース文字列が提供されておらず、独自の翻訳を提供したい場合は、いつでもカスタム リソース文字列を提供できます。これはグローバルに、またはコンポーネントごとに (`resourceStrings` プロパティを使用して) 実行できます。 - + より多くの言語を含む [`igniteui-i18n-resources`](https://github.com/IgniteUI/igniteui-i18n/tree/master/projects/igniteui-i18n-resources) パッケージに自由にコントリビュートしてください。`igniteui-angular-i18n` はこれらに基づいています。 @@ -296,7 +296,7 @@ registerI18n(customResources, 'en'); ``` - + 最後の例では、特定のリソース文字列のみを設定しています。つまり、残りは、使用中のコンポーネントで取得できない場合、デフォルトで英語になります。 @@ -325,7 +325,7 @@ registerI18n(customResources, 'en'); ## レガシー ローカライズ (i18n) - + これは 21.0.x まで推奨されていた古いローカライズ処理方法です。新しいバージョンを使用している場合は、上記の新しい方法の使用を推奨します。これは、今後の通知があるまで引き続き機能します。 @@ -337,7 +337,7 @@ registerI18n(customResources, 'en'); - + サンプルに含まれているヒンディー語 (HI) は、説明のみを目的としており、カスタム ローカライズ オブジェクトを渡す可能性を強調するためのものです。このサンプルでは、集計用にローカライズされたいくつかの文字列のみが含まれています。詳細については、以下の[独自のローカライズされたリソースを使用する](#独自のローカライズされたリソースを活用する)セクションを参照してください。 @@ -413,7 +413,7 @@ export class AppComponent implements OnInit { } ``` - + より多くの言語を含む [`igniteui-angular-i18n`](https://github.com/IgniteUI/igniteui-angular/tree/master/projects/igniteui-angular-i18n) パッケージに自由にコントリビュートしてください。 diff --git a/docs/angular/src/content/jp/components/geo-map-binding-data-model.mdx b/docs/angular/src/content/jp/components/geo-map-binding-data-model.mdx index 3bf7e7bb50..f7f7d7ece2 100644 --- a/docs/angular/src/content/jp/components/geo-map-binding-data-model.mdx +++ b/docs/angular/src/content/jp/components/geo-map-binding-data-model.mdx @@ -29,13 +29,13 @@ Ignite UI for Angular マップ コンポーネントは、シェイプ ファ | Geographic シリーズ | プロパティ | 概要 | |--------------|---------------| ---------------| -| | `LongitudeMemberPath`、`LatitudeMemberPath` | 2 つの数値の経度と緯度座標の名前を指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath` | 2 つの数値の経度と緯度座標の名前を指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath`、`RadiusMemberPath` | 2 つの経度座標と緯度座標の名前と、シンボルのサイズ/半径の数字列を 1 列指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath`、`ColorMemberPath` | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath`、`ValueMemberPath` | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | -||`ShapeMemberPath`|図形の地理的ポイントを含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | -||`ShapeMemberPath`|線の地理的座標を含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | +| | | 2 つの数値の経度と緯度座標の名前を指定します。 | +| | | 2 つの数値の経度と緯度座標の名前を指定します。 | +| | | 2 つの経度座標と緯度座標の名前と、シンボルのサイズ/半径の数字列を 1 列指定します。 | +| | | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | +| | | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | +|||図形の地理的ポイントを含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | +|||線の地理的座標を含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | ## コード スニペット 以下のコードは、 を、経度と緯度の座標を使用して格納された世界の一部の都市の地理的位置を含むカスタム データ モデルにバインドする方法を示します。また、[WorldUtility](geo-map-resources-world-util.md) を使用してこれらの場所間の最短の地理的経路をプロットするために を使用します。 diff --git a/docs/angular/src/content/jp/components/geo-map-binding-shp-file.mdx b/docs/angular/src/content/jp/components/geo-map-binding-shp-file.mdx index cba857e7a7..445b21770f 100644 --- a/docs/angular/src/content/jp/components/geo-map-binding-shp-file.mdx +++ b/docs/angular/src/content/jp/components/geo-map-binding-shp-file.mdx @@ -11,7 +11,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular シェープ ファイルを地理的データにバインディング -Ignite UI for Angular Map コンポーネントの クラスは、形状ファイルから地理空間データ (ポイント/位置、ポリライン、ポリゴン) を読み込み、それを オブジェクトのコレクションに変換します。 +Ignite UI for Angular Map コンポーネントの クラスは、形状ファイルから地理空間データ (ポイント/位置、ポリライン、ポリゴン) を読み込み、それを オブジェクトのコレクションに変換します。 ## Angular シェープ ファイルを地理的データにバインディングの例 @@ -19,29 +19,29 @@ Ignite UI for Angular Map コンポーネントの -以下の表は、シェイプ ファイルを読み込むための クラスのプロパティを説明します。 +以下の表は、シェイプ ファイルを読み込むための クラスのプロパティを説明します。 | プロパティ | 型 | 概要 | |----------|------|---------------| -| `ShapefileSource` | string |シェイプ ファイル(.shp) から読み込まれた 1 つの地理空間シェープにすべてのポイントが含まれます。| -|`DatabaseSource` | string |たとえば、シェープファイルで日本は、以下でポイント オブジェクト リストのリストとして表されます。| +| | string |シェイプ ファイル(.shp) から読み込まれた 1 つの地理空間シェープにすべてのポイントが含まれます。| +| | string |たとえば、シェープファイルで日本は、以下でポイント オブジェクト リストのリストとして表されます。| -両方のソース プロパティが null 以外の値に設定されると、 オブジェクトの ImportAsync メソッドが起動し、シェイプ ファイルを取得して読み込み、最終的に変換を実行します。この操作が完了すると、 オブジェクトで生成され、シェイプ ファイルから地理空間データを読み込んで変換するプロセスが完了したことを通知するために、`ImportCompleted` イベントが起動されます。 +両方のソース プロパティが null 以外の値に設定されると、 オブジェクトの ImportAsync メソッドが起動し、シェイプ ファイルを取得して読み込み、最終的に変換を実行します。この操作が完了すると、 オブジェクトで生成され、シェイプ ファイルから地理空間データを読み込んで変換するプロセスが完了したことを通知するために、`ImportCompleted` イベントが起動されます。 ## シェープファイルの読み込み -以下のコードは、世界の主要都市の場所を含むシェイプ ファイルを読み込むための オブジェクトのインスタンスを作成します。また、xamGeographicMap コントロールにデータをバインドするための前提条件として `ImportCompleted` イベントを処理する方法も示します。 +以下のコードは、世界の主要都市の場所を含むシェイプ ファイルを読み込むための オブジェクトのインスタンスを作成します。また、xamGeographicMap コントロールにデータをバインドするための前提条件として `ImportCompleted` イベントを処理する方法も示します。 ## シェープファイルをバインド -Map コンポーネントでは、Geographic Series は、シェイプ ファイルから読み込まれる地理的データを表示するために使用されます。すべてのタイプの地理的シリーズには、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。 オブジェクトのリストを含むため、このような配列の例です。 +Map コンポーネントでは、Geographic Series は、シェイプ ファイルから読み込まれる地理的データを表示するために使用されます。すべてのタイプの地理的シリーズには、オブジェクトの配列にバインドできる プロパティがあります。 オブジェクトのリストを含むため、このような配列の例です。 -`ShapefileRecord` クラスは、以下の表にリストする地理的データを保存するためのプロパティを提供します。 + クラスは、以下の表にリストする地理的データを保存するためのプロパティを提供します。 | プロパティ | 概要 | |--------------|---------------| @@ -51,8 +51,8 @@ Map コンポーネントでは、Geographic Series は、シェイプ ファイ このデータ構造は、適切なデータ列がマップされている限り、ほとんどの地理的シリーズでの使用に適しています。 ## コード スニペット -このコード例は、シェープ ファイルが を使用して読み込まれたことを前提としています。 -以下のコードは、マップ コンポーネント内の にバインドし、すべての オブジェクトの `Points` プロパティをマップします。 +このコード例は、シェープ ファイルが を使用して読み込まれたことを前提としています。 +以下のコードは、マップ コンポーネント内の にバインドし、すべての オブジェクトの `Points` プロパティをマップします。 @@ -154,4 +154,4 @@ export class MapBindingShapefilePolylinesComponent implements AfterViewInit { ## API リファレンス
-
+
diff --git a/docs/angular/src/content/jp/components/geo-map-display-azure-imagery.mdx b/docs/angular/src/content/jp/components/geo-map-display-azure-imagery.mdx index e29e85005c..7edfb42b7b 100644 --- a/docs/angular/src/content/jp/components/geo-map-display-azure-imagery.mdx +++ b/docs/angular/src/content/jp/components/geo-map-display-azure-imagery.mdx @@ -9,10 +9,10 @@ _language: ja import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; import { Image } from 'astro:assets'; import azuremapsimagery from '@xplat-images/general/AzureMapsImagery.png'; import azureTrafficTileSeriesWithBackground from '@xplat-images/general/Azure_Traffic_Tile_Series_With_Background.png'; +import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; # Angular Azure Maps からの画像 @@ -28,7 +28,7 @@ Angular は、Micr ## Angular Azure Maps からの画像の表示 - コード例 -以下のコード スニペットは、 クラスを使用して Angular `GeographicMap` で Azure Maps からの地理的画像タイルを表示する方法を示します。 +以下のコード スニペットは、 クラスを使用して Angular で Azure Maps からの地理的画像タイルを表示する方法を示します。 @@ -70,8 +70,8 @@ this.map.backgroundContent = tileSource; を使用する際には、**ベース マップ スタイル** (例: **Satellite**, **Road**, **DarkGrey**) の上に**オーバーレイ** (交通情報、天気、ラベル) を重ね合わせることができます。例えば **Satellite** と **TerraOverlay** を組み合わせることで、地形を視覚化できます。 - **ベース スタイル**: Satellite、Road、Terra、DarkGrey がコアとなる背景タイルを提供します。 -- **オーバーレイ スタイル**: 交通情報や天気の画像 (`TrafficRelativeOverlay`、`WeatherRadarOverlay` など) は、タイル シリーズに割り当てることでベース スタイル上に重ねられるよう設計されています。 -- **ハイブリッド スタイル**: `HybridRoadOverlay` や `HybridDarkGreyOverlay` などのバリエーションは、ベース スタイルにラベルや道路などのオーバーレイをあらかじめ組み合わせているため、複数のレイヤーを手動で管理する必要はありません。 +- **オーバーレイ スタイル**: 交通情報や天気の画像 ( など) は、タイル シリーズに割り当てることでベース スタイル上に重ねられるよう設計されています。 +- **ハイブリッド スタイル**: などのバリエーションは、ベース スタイルにラベルや道路などのオーバーレイをあらかじめ組み合わせているため、複数のレイヤーを手動で管理する必要はありません。 この設計により、より豊かなマップ表現が可能になります。例えば: - **Satellite** 画像に **TrafficOverlay** を重ねて、実際の地図上に渋滞状況をハイライト表示。 @@ -83,7 +83,7 @@ this.map.backgroundContent = tileSource;
## Azure Maps からの画像オーバーレイ - コード例 -次のコード スニペットは、 クラスと クラスを使用して、Angular `GeographicMap` の交通情報と濃い灰色のマップを結合した背景画像の上に地理画像タイルを表示する方法を示しています。 +次のコード スニペットは、 クラスと クラスを使用して、Angular の交通情報と濃い灰色のマップを結合した背景画像の上に地理画像タイルを表示する方法を示しています。 @@ -137,7 +137,7 @@ export class AppComponent implements AfterViewInit { | プロパティ名 | プロパティ タイプ | 説明 | |----------------|-----------------|---------------| ||string|Azure Maps 画像サービスで必要となる API キーを設定するためのプロパティを表します。このキーは
azure.microsoft.com ウェブサイトから取得してください。| -||`AzureMapsImageryStyle`|Azure Maps 画像タイルのマップ スタイルを設定するプロパティを表します。このプロパティは、以下の `AzureMapsImageryStyle` 列挙値に設定できます。
  • Satellite - 道路またはラベルのオーバーレイなしの衛星地図スタイルを指定します。
  • Road - 道路およびラベル付きの衛星地図スタイルを指定します。
  • DarkGrey - コントラストやオーバーレイのハイライト表示に適したダーク グレーのベース マップ スタイルを指定します。
  • TerraOverlay - 標高や地形の特徴をハイライト表示する陰影起伏付きの地形マップ スタイルを指定します。
  • LabelsRoadOverlay - 航空写真オーバーレイなしで都市ラベルを表示する複数のオーバーレイの 1 つです。
  • HybridRoadOverlay - 衛星画像の背景に道路とラベルのオーバーレイを組み合わせます。
  • HybridDarkGreyOverlay - 衛星画像の背景にダーク グレーのラベル オーバーレイを組み合わせます。
  • LabelsDarkGreyOverlay - ダーク グレーのベース マップ上に都市ラベルを表示する複数のオーバーレイの 1 つです。
  • TrafficDelayOverlay - 交通遅延や渋滞エリアをリアルタイムで表示します。
  • TrafficAbsoluteOverlay - 現在の交通速度を絶対値で表示します。
  • TrafficReducedOverlay - 減少した交通流を光ベースの視覚化で表示します。
  • TrafficRelativeOverlay - 通常の状況に対する相対的な交通速度を表示します。
  • TrafficRelativeDarkOverlay - 通常時と比較した交通速度をダーク ベースマップ上に表示し、コントラストを強調します。
  • WeatherRadarOverlay - 降水のほぼリアルタイムのレーダー画像を表示します。
  • WeatherInfraredOverlay - 雲量の赤外線衛星画像を表示します。
| +|||Azure Maps 画像タイルのマップ スタイルを設定するプロパティを表します。このプロパティは、以下の 列挙値に設定できます。
  • Satellite - 道路またはラベルのオーバーレイなしの衛星地図スタイルを指定します。
  • Road - 道路およびラベル付きの衛星地図スタイルを指定します。
  • DarkGrey - コントラストやオーバーレイのハイライト表示に適したダーク グレーのベース マップ スタイルを指定します。
  • TerraOverlay - 標高や地形の特徴をハイライト表示する陰影起伏付きの地形マップ スタイルを指定します。
  • LabelsRoadOverlay - 航空写真オーバーレイなしで都市ラベルを表示する複数のオーバーレイの 1 つです。
  • HybridRoadOverlay - 衛星画像の背景に道路とラベルのオーバーレイを組み合わせます。
  • HybridDarkGreyOverlay - 衛星画像の背景にダーク グレーのラベル オーバーレイを組み合わせます。
  • LabelsDarkGreyOverlay - ダーク グレーのベース マップ上に都市ラベルを表示する複数のオーバーレイの 1 つです。
  • TrafficDelayOverlay - 交通遅延や渋滞エリアをリアルタイムで表示します。
  • TrafficAbsoluteOverlay - 現在の交通速度を絶対値で表示します。
  • TrafficReducedOverlay - 減少した交通流を光ベースの視覚化で表示します。
  • TrafficRelativeOverlay - 通常の状況に対する相対的な交通速度を表示します。
  • TrafficRelativeDarkOverlay - 通常時と比較した交通速度をダーク ベースマップ上に表示し、コントラストを強調します。
  • WeatherRadarOverlay - 降水のほぼリアルタイムのレーダー画像を表示します。
  • WeatherInfraredOverlay - 雲量の赤外線衛星画像を表示します。
| ## API リファレンス diff --git a/docs/angular/src/content/jp/components/geo-map-display-bing-imagery.mdx b/docs/angular/src/content/jp/components/geo-map-display-bing-imagery.mdx index e0699c46b0..7bd3ca6fea 100644 --- a/docs/angular/src/content/jp/components/geo-map-display-bing-imagery.mdx +++ b/docs/angular/src/content/jp/components/geo-map-display-bing-imagery.mdx @@ -33,7 +33,7 @@ import bingmapsimagery from '@xplat-images/general/BingMapsImagery.png';
## コード スニペット -以下のコード スニペットは、 を使用して Angular `GeographicMap` で Bing Maps からの地理的画像を表示する方法を示します。 +以下のコード スニペットは、 を使用して Angular で Bing Maps からの地理的画像を表示する方法を示します。 diff --git a/docs/angular/src/content/jp/components/geo-map-display-esri-imagery.mdx b/docs/angular/src/content/jp/components/geo-map-display-esri-imagery.mdx index f60c16f42f..cdeb7d847d 100644 --- a/docs/angular/src/content/jp/components/geo-map-display-esri-imagery.mdx +++ b/docs/angular/src/content/jp/components/geo-map-display-esri-imagery.mdx @@ -25,7 +25,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro';
## コード スニペット -以下のコード スニペットは、 クラスを使用して `GeographicMap` で Esri 画像サーバーからの Angular 地理的画像タイルを表示する方法を示します。 +以下のコード スニペットは、 クラスを使用して で Esri 画像サーバーからの Angular 地理的画像タイルを表示する方法を示します。 diff --git a/docs/angular/src/content/jp/components/geo-map-display-heat-imagery.mdx b/docs/angular/src/content/jp/components/geo-map-display-heat-imagery.mdx index b9e0900721..8c75939ed4 100644 --- a/docs/angular/src/content/jp/components/geo-map-display-heat-imagery.mdx +++ b/docs/angular/src/content/jp/components/geo-map-display-heat-imagery.mdx @@ -25,18 +25,18 @@ Ignite UI for Angular マップ コントロールには、Shape ファイルを
- がそのシェイプ ファイルを読み込むと、そのデータを オブジェクトに変換します。これらのオブジェクトは、 の `GetPointData()` メソッドから取得でき、`TileGenerator` プロパティに割り当てられた オブジェクトを使用してヒートマップを作成するために使用できます。この は、`TileImagery` ソースとして で使用できます。 + がそのシェイプ ファイルを読み込むと、そのデータを オブジェクトに変換します。これらのオブジェクトは、 の `GetPointData()` メソッドから取得でき、 プロパティに割り当てられた オブジェクトを使用してヒートマップを作成するために使用できます。この は、 ソースとして で使用できます。 - オブジェクトは、`XValues`、`YValues`、`Values` の 3 つの値パスを持つように機能します。これらの使用方法の例として、人口に関する情報を持つ形状ファイルの場合、`XValues` を経度、`YValues` を緯度、`Values` を人口データとみなすことができます。これらの各プロパティは、`number[]` を取得します。 + オブジェクトは、 の 3 つの値パスを持つように機能します。これらの使用方法の例として、人口に関する情報を持つ形状ファイルの場合、 を経度、 を緯度、 を人口データとみなすことができます。これらの各プロパティは、`number[]` を取得します。 -ヒートマップ機能を使用する際の地理的タイルシリーズの表示は、`MinimumColor` プロパティと `MaximumColor` プロパティを の `Values` プロパティに割り当てるコレクションの最小値と最大値に対応する色を記述する「rgba」文字列に設定することでカスタマイズできます。これをさらにカスタマイズするには、ジェネレーターの `ScaleColors` プロパティを設定して、色を説明する文字列のコレクションを含めます。これにより、 に、マップに表示される値に使用する色がわかります。`BlurRadius`、`MaxBlurRadius`、`UseBlurRadiusAdjustedForZoom` プロパティを使用して、`ScaleColors` コレクション内の色が一緒にぼやける方法をカスタマイズすることもできます。 +ヒートマップ機能を使用する際の地理的タイルシリーズの表示は、 プロパティと プロパティを プロパティに割り当てるコレクションの最小値と最大値に対応する色を記述する「rgba」文字列に設定することでカスタマイズできます。これをさらにカスタマイズするには、ジェネレーターの プロパティを設定して、色を説明する文字列のコレクションを含めます。これにより、 に、マップに表示される値に使用する色がわかります。 プロパティを使用して、 コレクション内の色が一緒にぼやける方法をカスタマイズすることもできます。 - は対数スケールも使用できます。これを使用する場合は、`UseLogarithmicScale` プロパティを **true** に設定できます。 + は対数スケールも使用できます。これを使用する場合は、 プロパティを **true** に設定できます。 ## Web Worker -また、`HeatTileGenerator` は、Web Worker が、別のスレッドでシェイプ ファイルからタイル イメージをロードする際の重いリフティングをサポートしています。これにより、ヒートマップ機能を使用する際に地理マップのパフォーマンスが大幅に向上します。ジェネレーターでWebワーカーを使用するには、`UseWebWorkers` プロパティを **true** に設定し、`WebWorkerInstance` プロパティを Web Worker のインスタンスに設定できます。 +また、 は、Web Worker が、別のスレッドでシェイプ ファイルからタイル イメージをロードする際の重いリフティングをサポートしています。これにより、ヒートマップ機能を使用する際に地理マップのパフォーマンスが大幅に向上します。ジェネレーターでWebワーカーを使用するには、 プロパティを **true** に設定し、 プロパティを Web Worker のインスタンスに設定できます。 ```ts @@ -182,7 +182,7 @@ constructor() { ## API リファレンス
-
+



diff --git a/docs/angular/src/content/jp/components/geo-map-display-imagery-types.mdx b/docs/angular/src/content/jp/components/geo-map-display-imagery-types.mdx index 527f21efd7..9cc0efa58d 100644 --- a/docs/angular/src/content/jp/components/geo-map-display-imagery-types.mdx +++ b/docs/angular/src/content/jp/components/geo-map-display-imagery-types.mdx @@ -53,6 +53,6 @@ Angular 地理的画像は、上空から見た世界の詳細な表現です。 ## API リファレンス -`BackgroundContent`
+


diff --git a/docs/angular/src/content/jp/components/geo-map-navigation.mdx b/docs/angular/src/content/jp/components/geo-map-navigation.mdx index a7e1789269..a1723d4503 100644 --- a/docs/angular/src/content/jp/components/geo-map-navigation.mdx +++ b/docs/angular/src/content/jp/components/geo-map-navigation.mdx @@ -16,7 +16,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular コンテンツのナビゲーション -`GeographicMap` コントロールのナビゲーションは、既定では有効にされており、マップ コンテンツのズームとパンが可能です。ただし、この動作は プロパティを使用して変更できます。マップでは同期ズームのみが許可されていること、つまり、アスペクト比を維持したままマップコンテンツをスケーリングすることを知っておくことが重要です。結果として、マップコンテンツを水平方向にスケーリングせずに垂直方向にスケーリングすることはできません。 + コントロールのナビゲーションは、既定では有効にされており、マップ コンテンツのズームとパンが可能です。ただし、この動作は プロパティを使用して変更できます。マップでは同期ズームのみが許可されていること、つまり、アスペクト比を維持したままマップコンテンツをスケーリングすることを知っておくことが重要です。結果として、マップコンテンツを水平方向にスケーリングせずに垂直方向にスケーリングすることはできません。 ## Angular コンテンツのナビゲーションの例 @@ -53,7 +53,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## プロパティ -以下の表は `GeographicMap` コントロールのナビゲーションで使用できるプロパティをまとめたものです。 +以下の表は コントロールのナビゲーションで使用できるプロパティをまとめたものです。 | プロパティ名 | プロパティ型 | 概要 | |----------------|-----------------|---------------| diff --git a/docs/angular/src/content/jp/components/geo-map-resources-esri.mdx b/docs/angular/src/content/jp/components/geo-map-resources-esri.mdx index f20fc7a935..187b10214a 100644 --- a/docs/angular/src/content/jp/components/geo-map-resources-esri.mdx +++ b/docs/angular/src/content/jp/components/geo-map-resources-esri.mdx @@ -11,7 +11,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Esri ユーティリティ -リソース トピックは、Esri Maps が `GeographicMap` で提供する の使用に役立つユーティリティの実装を提供します。 +リソース トピックは、Esri Maps が で提供する の使用に役立つユーティリティの実装を提供します。 ## コード スニペット diff --git a/docs/angular/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx b/docs/angular/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx index 3f9430eedd..2da2148809 100644 --- a/docs/angular/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx +++ b/docs/angular/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx @@ -11,7 +11,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular シェイプ スタイリング ユーティリティ -リソース トピックは、Angular `GeographicMap` コンポーネントで の UI 要素のスタイリングに役立つユーティリティの実装を提供します。 +リソース トピックは、Angular コンポーネントで の UI 要素のスタイリングに役立つユーティリティの実装を提供します。 ## 必要なインポート diff --git a/docs/angular/src/content/jp/components/geo-map-shape-styling.mdx b/docs/angular/src/content/jp/components/geo-map-shape-styling.mdx index cf8e8a7c7a..7dbf385975 100644 --- a/docs/angular/src/content/jp/components/geo-map-shape-styling.mdx +++ b/docs/angular/src/content/jp/components/geo-map-shape-styling.mdx @@ -12,7 +12,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular 地理シェイプ シリーズのスタイル設定 -このトピックでは、Angular `GeographicMap` で にカスタム スタイリングを適用する方法を説明します。 +このトピックでは、Angular にカスタム スタイリングを適用する方法を説明します。 ## Angular 地理シェイプ シリーズのスタイル設定の例 diff --git a/docs/angular/src/content/jp/components/geo-map-type-scatter-area-series.mdx b/docs/angular/src/content/jp/components/geo-map-type-scatter-area-series.mdx index 9d1914b01b..0846dec00a 100644 --- a/docs/angular/src/content/jp/components/geo-map-type-scatter-area-series.mdx +++ b/docs/angular/src/content/jp/components/geo-map-type-scatter-area-series.mdx @@ -27,35 +27,35 @@ Angular マップ コンポーネントでは、 と同様ですが、同じ値を持つデータポイントを接続する等線の置換に補完で色つきサーフェス エリアとしてデータを表します。 ## データ要件 -マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的な経度および緯度座標を保管し、1 つのデータ列は地理的位置に関連した値を保管します。地理的シリーズの `LongitudeMemberPath`、`LatitudeMemberPath` および `ColorMemberPath` プロパティはこれらのデータ列を識別します。 - は、三角測量が `TrianglesSource` プロパティに設定されていない場合、ItemsSource の項目で組み込みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために TriangulationSource を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 +マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的な経度および緯度座標を保管し、1 つのデータ列は地理的位置に関連した値を保管します。地理的シリーズの および プロパティはこれらのデータ列を識別します。 + は、三角測量が プロパティに設定されていない場合、ItemsSource の項目で組み込みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために TriangulationSource を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 ## データ バインディング 以下の表に、データ バインドに使用される GeographicScatterAreaSeries のプロパティをまとめています。 | プロパティ名 | プロパティ型 | 説明 | |--------------|---------------| ---------------| -|`ItemsSource`|任意|`TrianglesSource` プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| -|`LongitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の経度を含むプロパティの名前。| -|`LatitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の Latitude を含むプロパティの名前。| -|`ColorMemberPath`|文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。`ColorScale` プロパティが設定されている場合、この数値は色に変換されます。| -|`TrianglesSource`|任意|三角測量データのソース。`TriangulationSource` オブジェクトの Triangles をこのプロパティに設定すると、ランタイム パフォーマンスと地理的シリーズの描画の両方が改善します。| -|`TriangleVertexMemberPath1`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、`TrianglesSource` 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath2`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、`TrianglesSource` 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath3`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、`TrianglesSource` 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||任意| プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| +||文字列| にバインドされているすべての項目の経度を含むプロパティの名前。| +||文字列| にバインドされているすべての項目の Latitude を含むプロパティの名前。| +||文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。 プロパティが設定されている場合、この数値は色に変換されます。| +||任意|三角測量データのソース。`TriangulationSource` オブジェクトの Triangles をこのプロパティに設定すると、ランタイム パフォーマンスと地理的シリーズの描画の両方が改善します。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| ## カラー スケール の ColorScale プロパティを使用して、ポイントの色の値を解決し、地理的シリーズの面を塗りつぶします。色は、ピクセル単位の三角ラスタライザーを三角測量データに適用することによって、サーフェスの図形の周りをなめらかに補間します。サーフェスの描画がピクセル単位であるため、カラー スケールはブラシではなく色を使用します。 提供される クラスはほとんどのカラーリングのニーズを満たすはずですが、ColorScale ベースのクラスはカスタムのカラリング ロジックのアプリケーションによって継承できます。 -以下の表は GeographicScatterAreaSeries の面のカラリングに影響する `CustomPaletteColorScale` プロパティをリストします。 +以下の表は GeographicScatterAreaSeries の面のカラリングに影響する プロパティをリストします。 | Property Name | Property Type | Description | |--------------|---------------| ---------------| -|`Palette`| `ObservableCollection` |Gets or sets the collection of colors to select from or to interpolate between.| -|`InterpolationMode`|`ColorScaleInterpolationMode`|Gets or sets the method getting a color from the Palette.| -|`MaximumValue`|double|The highest value to assign a color. Any given value greater than this value will be Transparent.| -|`MinimumValue`|double|The lowest value to assign a color. Any given value less than this value will be Transparent.| +|| `ObservableCollection` |Gets or sets the collection of colors to select from or to interpolate between.| +|||Gets or sets the method getting a color from the Palette.| +||double|The highest value to assign a color. Any given value greater than this value will be Transparent.| +||double|The lowest value to assign a color. Any given value less than this value will be Transparent.| ## コード スニペット 以下のコードは、 を世界の表面温度を表す三角測量データにバインドする方法を示しています。 diff --git a/docs/angular/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx b/docs/angular/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx index adfba40f7b..e13f94b34d 100644 --- a/docs/angular/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx +++ b/docs/angular/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx @@ -27,19 +27,19 @@ Angular マップ コンポーネントでは、 シリーズと、シリーズのデータ​​バインディングオプションを指定する方法を示しています。予定表連動マーカー選択は、マーカー競合回避ロジックと合わせて構成され、マーカー アウトラインと塗りつぶしの色も指定されます。 ## 構成の概要 - マップコントロールの他のタイプの散布シリーズと同様に、 シリーズには、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。`LongitudeMemberPath` と `LatitudeMemberPath` プロパティを使用してこのデータ列をマップします。`RadiusScale` と `RadiusMemberPath` は、バブルの半径を設定します。 + マップコントロールの他のタイプの散布シリーズと同様に、 シリーズには、オブジェクトの配列にバインドできる プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。 プロパティを使用してこのデータ列をマップします。 は、バブルの半径を設定します。 以下の表に、データ バインドに使用される GeographicHighDensityScatterSeries シリーズのプロパティをまとめています。 | プロパティ|タイプ|概要 | | ---|---|--- | -| `ItemsSource`|any|項目のソースを取得または設定します | -| `LongitudeMemberPath`|string|ItemsSource プロパティを使用して、割り当てられた商品の経度の値の場所を特定します。 | -| `LatitudeMemberPath`|string|ItemsSource プロパティを使用して、割り当てられた商品の緯度値の場所を決定します。 | -| `RadiusMemberPath`|string|シリーズの半径値を取得するために使用するパスを設定します。 | -| `RadiusScale`|`SizeScale`|現在のバブル シリーズの半径スケール プロパティを取得または設定します。 | -| `MinimumValue`|any|値のサブ範囲を計算するための最小値を設定します。 | -| `MaximumValue`|any|値のサブ範囲を計算するための最大値を設定します。 | +| |any|項目のソースを取得または設定します | +| |string|ItemsSource プロパティを使用して、割り当てられた商品の経度の値の場所を特定します。 | +| |string|ItemsSource プロパティを使用して、割り当てられた商品の緯度値の場所を決定します。 | +| |string|シリーズの半径値を取得するために使用するパスを設定します。 | +| ||現在のバブル シリーズの半径スケール プロパティを取得または設定します。 | +| |any|値のサブ範囲を計算するための最小値を設定します。 | +| |any|値のサブ範囲を計算するための最大値を設定します。 | ## コード スニペット @@ -181,4 +181,4 @@ export class MapTypeScatterBubbleSeriesComponent implements AfterViewInit { ## API リファレンス
-`RadiusScale`
+
diff --git a/docs/angular/src/content/jp/components/geo-map-type-scatter-contour-series.mdx b/docs/angular/src/content/jp/components/geo-map-type-scatter-contour-series.mdx index 328e7dc810..736768fa2f 100644 --- a/docs/angular/src/content/jp/components/geo-map-type-scatter-contour-series.mdx +++ b/docs/angular/src/content/jp/components/geo-map-type-scatter-contour-series.mdx @@ -27,33 +27,33 @@ Angular マップ コンポーネントでは、 とよく似ていますが、塗りつぶしスケールを使用して色付けされた等高線としてデータを表し、地理散布エリア シリーズはカラースケールを使用して補間された面としてデータを表します。 ## データ要件 -マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的位置 (経度および緯度座標) を保管し、1 つのデータ列は地理的位置に関連した値を保管します。これらのデータ列は、地理的シリーズの `LongitudeMemberPath`、`LatitudeMemberPath` および `ValueMemberPath` プロパティによって識別されます。 - は、三角測量が `TrianglesSource` プロパティに設定されていない場合、ItemsSource の項目で定義済みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために `TriangulationSource` を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 +マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的位置 (経度および緯度座標) を保管し、1 つのデータ列は地理的位置に関連した値を保管します。これらのデータ列は、地理的シリーズの および プロパティによって識別されます。 + は、三角測量が プロパティに設定されていない場合、ItemsSource の項目で定義済みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために `TriangulationSource` を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 ## データ バインディング -以下の表は、データ バインドに使用される `GeographicContourLineSeries` プロパティの概要です。 +以下の表は、データ バインドに使用される プロパティの概要です。 | プロパティ名 | プロパティ型 | 概要 | |--------------|---------------| ---------------| -|`ItemsSource`|任意|`TrianglesSource` プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| -|`LongitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の経度を含むプロパティの名前。| -|`LatitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の Latitude を含むプロパティの名前。| -|`ValueMemberPath`|文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。`FillScale` プロパティが設定されている場合、この数値は色に変換されます。| -|`TrianglesSource`|任意|三角測量データのソースを取得または設定します。TriangulationSource オブジェクトの Triangles をこのプロパティに設定すると、ランタイムパフォーマンスと地理的シリーズレンダリングの両方が向上します。| -|`TriangleVertexMemberPath1`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath2`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath3`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||任意| プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| +||文字列| にバインドされているすべての項目の経度を含むプロパティの名前。| +||文字列| にバインドされているすべての項目の Latitude を含むプロパティの名前。| +||文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。 プロパティが設定されている場合、この数値は色に変換されます。| +||任意|三角測量データのソースを取得または設定します。TriangulationSource オブジェクトの Triangles をこのプロパティに設定すると、ランタイムパフォーマンスと地理的シリーズレンダリングの両方が向上します。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| ## 等高線の塗りつぶしスケール - の `FillScale` を使用して地理的シリーズの等高線の塗りブラシを解決します。 + を使用して地理的シリーズの等高線の塗りブラシを解決します。 ValueBrushScale クラスは、ユーザーの色分けのニーズもほとんどを満たすはずですが、カスタムの色分けロジックのアプリケーションで ValueBrushScale クラスを継承できます。 以下の表は、GeographicContourLineSeries のサーフェス カラーリングに影響を与える CustomPaletteColorScale のプロパティの一覧です。 | プロパティ名 | プロパティ型 | 概要 | |--------------|---------------| ---------------| -|`Brushes`|BrushCollection|`GeographicContourLineSeries` の輪郭を塗りつぶすためのブラシのコレクションを取得または設定します。| -|`MaximumValue`|double|塗りつぶしスケールでブラシを割り当てるための最高値。| -|`MinimumValue`|double|塗りつぶしスケールでブラシを割り当てるための最低値。| +||BrushCollection| の輪郭を塗りつぶすためのブラシのコレクションを取得または設定します。| +||double|塗りつぶしスケールでブラシを割り当てるための最高値。| +||double|塗りつぶしスケールでブラシを割り当てるための最低値。| ## コード スニペット @@ -182,7 +182,7 @@ export class MapTypeScatterContourSeriesComponent implements AfterViewInit { ## API リファレンス -`FillScale`
+



diff --git a/docs/angular/src/content/jp/components/geo-map-type-scatter-density-series.mdx b/docs/angular/src/content/jp/components/geo-map-type-scatter-density-series.mdx index 78da59e374..7880ef8374 100644 --- a/docs/angular/src/content/jp/components/geo-map-type-scatter-density-series.mdx +++ b/docs/angular/src/content/jp/components/geo-map-type-scatter-density-series.mdx @@ -29,30 +29,30 @@ Angular マップ コンポーネントでは、 シリーズには、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。`LongitudeMemberPath` と `LatitudeMemberPath` プロパティを使用してこのデータ列をマップします。 +マップ コントロールの他のタイプの散布図シリーズと同様に、 シリーズには、オブジェクトの配列にバインドできる プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。 プロパティを使用してこのデータ列をマップします。 ### データ バインディング 以下の表に、データ バインドに使用される GeographicHighDensityScatterSeries シリーズのプロパティをまとめています。 | プロパティ|タイプ|概要 | | ---|---|--- | -| `ItemsSource`|any|項目ソースを取得または設定します。 | -| `LongitudeMemberPath`|経度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | -| `LatitudeMemberPath`|string|緯度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | +| |any|項目ソースを取得または設定します。 | +| |経度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | +| |string|緯度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | ## 熱色スケール 熱色スケールは、シリーズ内のカラー パターンを決定するオプションの機能です。以下の表は、カラー スケールを決定するために使用するプロパティをまとめたものです。 | プロパティ|タイプ|概要 | | ---|---|--- | -| `HeatMinimum`|カラー スケールの最小端を表す double 値を定義します。 | -| `HeatMaximum`|カラー スケールの最大端を表す double 値を定義します。 | -| `HeatMinimumColor`|Color|カラー スケールの下端で使用するポイント密度カラーを定義します。 | -| `HeatMaximumColor`|Color|カラー スケールの上端で使用するポイント密度カラーを定義します。 | +| |カラー スケールの最小端を表す double 値を定義します。 | +| |カラー スケールの最大端を表す double 値を定義します。 | +| |Color|カラー スケールの下端で使用するポイント密度カラーを定義します。 | +| |Color|カラー スケールの上端で使用するポイント密度カラーを定義します。 | ## コード例 -以下のコードは、 の `HeatMinimumColor` と `HeatMaximumColor` プロパティを設定する方法を示します。 +以下のコードは、 プロパティを設定する方法を示します。 diff --git a/docs/angular/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx b/docs/angular/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx index c5f426ae69..e0b60f9f57 100644 --- a/docs/angular/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx +++ b/docs/angular/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx @@ -25,7 +25,7 @@ Angular マップ コンポーネントでは、 ## データ要件 -マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、このオブジェクトの各データ項目は、地理的位置 (経度と緯度) を保存する 2 つの数値データ列を持つ必要があります。これらのデータ列は、`LatitudeMemberPath` および `LongitudeMemberPath` プロパティにマップされます。 は、これらのマップされたデータ列の値を使用して、地理マップコンポーネントにシンボル要素をプロットします。 +マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、このオブジェクトの各データ項目は、地理的位置 (経度と緯度) を保存する 2 つの数値データ列を持つ必要があります。これらのデータ列は、 および プロパティにマップされます。 は、これらのマップされたデータ列の値を使用して、地理マップコンポーネントにシンボル要素をプロットします。 ## コード スニペット 以下のコードは、 を使用してシェイプ ファイルからロードした都市の場所に をバインドする方法を示します。 diff --git a/docs/angular/src/content/jp/components/geo-map-type-shape-polygon-series.mdx b/docs/angular/src/content/jp/components/geo-map-type-shape-polygon-series.mdx index dc649c9251..ba210e2bee 100644 --- a/docs/angular/src/content/jp/components/geo-map-type-shape-polygon-series.mdx +++ b/docs/angular/src/content/jp/components/geo-map-type-shape-polygon-series.mdx @@ -27,7 +27,7 @@ Angular マップ コンポーネントでは、 は、地理空間データがポリラインではなくポリゴンでレンダリングされる以外、 とほとんど同じです。 ## データ要件 -マップコントロールの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、`ShapeMemberPath` プロパティにマップされます。 は、マップされたデータ列の点を使用してマップコントロールにポリゴンをプロットします。 +マップコントロールの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、 プロパティにマップされます。 は、マップされたデータ列の点を使用してマップコントロールにポリゴンをプロットします。 ## コード スニペット 以下のコードは、 を使用してシェイプ ファイルからロードした世界の国々の図形に をバインドする方法を示します。 diff --git a/docs/angular/src/content/jp/components/geo-map-type-shape-polyline-series.mdx b/docs/angular/src/content/jp/components/geo-map-type-shape-polyline-series.mdx index d00115b865..5f0956154e 100644 --- a/docs/angular/src/content/jp/components/geo-map-type-shape-polyline-series.mdx +++ b/docs/angular/src/content/jp/components/geo-map-type-shape-polyline-series.mdx @@ -27,7 +27,7 @@ Angular マップ コンポーネントでは、 は、 とよく似ていますが、地理空間データがポリゴンではなくポリラインでレンダリングされる点が異なります。 ## データ要件 -コントロール内の他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、ShapeMemberPath プロパティにマップされます。 は、コントロールで多角形をプロットするために、このマップされたデータ列のポイントを使用します。 +コントロール内の他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、ShapeMemberPath プロパティにマップされます。 は、コントロールで多角形をプロットするために、このマップされたデータ列のポイントを使用します。 ## コード スニペット 以下のコードは、 を使用してシェイプ ファイルからロードした都市の場所に をバインドする方法を示します。 diff --git a/docs/angular/src/content/jp/components/geo-map.mdx b/docs/angular/src/content/jp/components/geo-map.mdx index 7a8c376bbb..517f5f58c6 100644 --- a/docs/angular/src/content/jp/components/geo-map.mdx +++ b/docs/angular/src/content/jp/components/geo-map.mdx @@ -15,7 +15,7 @@ Ignite UI for Angular Map コンポーネントを使用すると、ビューモ ## Angular マップの例 -以下のサンプルは、Bubble Series (バブル シリーズ) とも呼ばれる を使用して `GeographicMap` にデータを表示する方法を示しています。 +以下のサンプルは、Bubble Series (バブル シリーズ) とも呼ばれる を使用して にデータを表示する方法を示しています。 @@ -49,7 +49,7 @@ npm install --save igniteui-angular-maps ## モジュールの要件 -`GeographicMap` には以下のモジュールが必要ですが、DataChartInteractivityModule は、マップ コンテンツのパンやズームなどのマウス操作にのみ必要です。 + には以下のモジュールが必要ですが、DataChartInteractivityModule は、マップ コンテンツのパンやズームなどのマウス操作にのみ必要です。 diff --git a/docs/angular/src/content/jp/components/grid/grid.mdx b/docs/angular/src/content/jp/components/grid/grid.mdx index f655765628..200d5391cf 100644 --- a/docs/angular/src/content/jp/components/grid/grid.mdx +++ b/docs/angular/src/content/jp/components/grid/grid.mdx @@ -231,7 +231,7 @@ public contextObject = { firstProperty: 'testValue', secondProperty: 'testValue1 ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/hierarchicalgrid/hierarchical-grid.mdx b/docs/angular/src/content/jp/components/hierarchicalgrid/hierarchical-grid.mdx index f06703757e..dcde0286ef 100644 --- a/docs/angular/src/content/jp/components/hierarchicalgrid/hierarchical-grid.mdx +++ b/docs/angular/src/content/jp/components/hierarchicalgrid/hierarchical-grid.mdx @@ -32,7 +32,7 @@ Ignite UI for Angular Hierarchical Data Grid は、階層表形式データの このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` - + このコンポーネントは、**オプションで** [`HammerModule`](https://angular.io/api/platform-browser/HammerModule) を利用できます。タッチ操作が想定通りに動作するために、アプリケーションのルート モジュールにインポートできます。 diff --git a/docs/angular/src/content/jp/components/icon-button.mdx b/docs/angular/src/content/jp/components/icon-button.mdx index 6953936eba..bf649354ad 100644 --- a/docs/angular/src/content/jp/components/icon-button.mdx +++ b/docs/angular/src/content/jp/components/icon-button.mdx @@ -52,7 +52,7 @@ import { IgxIconButtonDirective } from 'igniteui-angular/directives'; export class HomeComponent {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/icon-service.mdx b/docs/angular/src/content/jp/components/icon-service.mdx index d005d1cc9f..daa33d13aa 100644 --- a/docs/angular/src/content/jp/components/icon-service.mdx +++ b/docs/angular/src/content/jp/components/icon-service.mdx @@ -68,11 +68,11 @@ iconService.setFamily('fa-solid', { className: 'fas', type: 'font', prefix: 'fa' ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` - + デフォルトの `material` ファミリーのアイコンを `igx-icon` でレンダリングするには、次のリンクを `index.html` に追加してください: `` diff --git a/docs/angular/src/content/jp/components/inputs/color-editor.mdx b/docs/angular/src/content/jp/components/inputs/color-editor.mdx index 6358c23b16..9ab00c099f 100644 --- a/docs/angular/src/content/jp/components/inputs/color-editor.mdx +++ b/docs/angular/src/content/jp/components/inputs/color-editor.mdx @@ -33,7 +33,7 @@ npm install igniteui-angular-core npm install igniteui-angular-inputs ``` - を使用する前に、次のモジュールを登録する必要があります: +`ColorEditor` を使用する前に、次のモジュールを登録する必要があります: @@ -49,7 +49,7 @@ npm install igniteui-angular-inputs ## 使用方法 - の使用を開始する最も簡単な方法は次のとおりです: +`ColorEditor` の使用を開始する最も簡単な方法は次のとおりです: @@ -109,7 +109,7 @@ public onValueChanged = (e: any) => { ## API リファレンス -
+`ColorEditor`
## その他のリソース diff --git a/docs/angular/src/content/jp/components/linear-gauge.mdx b/docs/angular/src/content/jp/components/linear-gauge.mdx index 90f773194c..a1340cf794 100644 --- a/docs/angular/src/content/jp/components/linear-gauge.mdx +++ b/docs/angular/src/content/jp/components/linear-gauge.mdx @@ -13,11 +13,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular リニア ゲージの概要 -Ignite UI for Angular リニア ゲージ コンポーネントを使用すると、リニア ゲージの形式でデータを視覚化できます。`LinearGauge` は、スケールおよび 1 つ以上の範囲と比較した値のシンプルで簡潔なビューを提供します。1 つのスケール、1 セットの目盛り、および 1 セットのラベルをサポートします。このコンポーネントには、アニメーション化されたトランジションのサポートも組み込まれており、アニメーションでは、 プロパティの設定で簡単にカスタマイズできます。また構成可能な向きや方向、視覚要素やツールチップなどがサポートされます。 +Ignite UI for Angular リニア ゲージ コンポーネントを使用すると、リニア ゲージの形式でデータを視覚化できます。 は、スケールおよび 1 つ以上の範囲と比較した値のシンプルで簡潔なビューを提供します。1 つのスケール、1 セットの目盛り、および 1 セットのラベルをサポートします。このコンポーネントには、アニメーション化されたトランジションのサポートも組み込まれており、アニメーションでは、 プロパティの設定で簡単にカスタマイズできます。また構成可能な向きや方向、視覚要素やツールチップなどがサポートされます。 ## Angular リニア ゲージの例 -以下のサンプルは、同じ `LinearGauge` でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 +以下のサンプルは、同じ でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 @@ -44,7 +44,7 @@ npm install --save igniteui-angular-gauges ## モジュールの要件 -`LinearGauge` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 @@ -154,7 +154,7 @@ export class AppModule {} ## 針のハイライト -リニア ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の `Value` の不透明度が低く表示されます。これを有効にするには、まず `HighlightValueDisplayMode` を Overlay に設定し、次に `HighlightValue` を適用します。 +リニア ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の の不透明度が低く表示されます。これを有効にするには、まず を Overlay に設定し、次に を適用します。 @@ -337,7 +337,7 @@ export class AppModule {} ## スケール -スケールはゲージで値の全範囲をハイライト表示する視覚的な要素です。外観やスケールの図形のカスタマイズ、更にスケールを反転 (`IsScaleInverted` プロパティを使用) させて、すべてのラベルを左から右ではなく、右から左へ描画することもできます。 +スケールはゲージで値の全範囲をハイライト表示する視覚的な要素です。外観やスケールの図形のカスタマイズ、更にスケールを反転 ( プロパティを使用) させて、すべてのラベルを左から右ではなく、右から左へ描画することもできます。 diff --git a/docs/angular/src/content/jp/components/linear-progress.mdx b/docs/angular/src/content/jp/components/linear-progress.mdx index 779ec5c583..a9ad2469e9 100644 --- a/docs/angular/src/content/jp/components/linear-progress.mdx +++ b/docs/angular/src/content/jp/components/linear-progress.mdx @@ -206,7 +206,7 @@ public positionEnd: IgxTextAlign = IgxTextAlign.END; ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/maps/map-api.mdx b/docs/angular/src/content/jp/components/maps/map-api.mdx index 0f53a3dae5..b704ec0c86 100644 --- a/docs/angular/src/content/jp/components/maps/map-api.mdx +++ b/docs/angular/src/content/jp/components/maps/map-api.mdx @@ -7,89 +7,91 @@ mentionedTypes: ["GeographicMap", "Series", "SeriesViewer", "GeographicSymbolSer namespace: Infragistics.Controls.Maps _language: ja --- +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # Angular 地理マップ API -Angular `GeographicMap` には次の API メンバーがあります: +Angular には次の API メンバーがあります: -- `Zoomable` -- `ZoomToGeographic` -- `WorldRect` -- `WindowRect` -- `WindowScale` -- `GetGeographicFromZoom` -- `GetGeographicPoint` -- `GetPixelPoint` +- +- +- +- +- +- +- +- ## Angular 地理的シリーズの種類 -Angular `GeographicMap` には 7 種類のシリーズがあり、データ バインディング用の `ItemsSource` プロパティがあります。 +Angular には 7 種類のシリーズがあり、データ バインディング用の プロパティがあります。 -- `GeographicHighDensityScatterSeries` -- `GeographicSymbolSeries` -- `GeographicProportionalSymbolSeries` -- `GeographicPolylineSeries` -- `GeographicShapeSeries` -- `GeographicScatterAreaSeries` -- `GeographicContourLineSeries` +- +- +- +- +- +- +- さらに、シリーズの各種類には、データ項目をマッピングし、その外観をスタイル設定するための特定のプロパティがあります。 ## Angular 地理記号シリーズ API -Angular `GeographicSymbolSeries` (地理マーカー シリーズ) には、次の API メンバーがあります。 +Angular (地理マーカー シリーズ) には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `MarkerType` -- `MarkerBrush` -- `MarkerOutline` +- +- +- +- +- ## Angular 地理バブル シリーズ API -Angular `GeographicProportionalSymbolSeries` (地理バブル シリーズ) には、次の API メンバーがあります。 +Angular (地理バブル シリーズ) には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `RadiusMemberPath` -- `RadiusScale` -- `FillScale` -- `FillMemberPath` +- +- +- +- +- +- ## Angular 地理シェイプ シリーズ API -Angular `GeographicShapeSeries` と `GeographicPolylineSeries` には同じ API メンバーがあります。 +Angular には同じ API メンバーがあります。 -- `ShapeMemberPath` -- `Thickness` -- `Brush` -- `Outline` +- +- +- +- ## Angular 地理エリア シリーズ API -Angular `GeographicScatterAreaSeries` には、次の API メンバーがあります。 +Angular には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `ColorMemberPath` -- `ColorScale` +- +- +- +- ## Angular 地理等高線シリーズ API -Angular `GeographicContourLineSeries` には、次の API メンバーがあります。 +Angular には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `ValueMemberPath` -- `FillScale` +- +- +- +- ## Angular 地理 HD シリーズ API -Angular `GeographicHighDensityScatterSeries` には、次の API メンバーがあります。 +Angular には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `HeatMaximumColor` -- `HeatMinimumColor` \ No newline at end of file +- +- +- +- \ No newline at end of file diff --git a/docs/angular/src/content/jp/components/mask.mdx b/docs/angular/src/content/jp/components/mask.mdx index fc2b64c58e..84127e6c27 100644 --- a/docs/angular/src/content/jp/components/mask.mdx +++ b/docs/angular/src/content/jp/components/mask.mdx @@ -78,7 +78,7 @@ import { IgxMaskDirective, IGX_INPUT_GROUP_DIRECTIVES } from 'igniteui-angular/i export class HomeComponent {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/menus/toolbar.mdx b/docs/angular/src/content/jp/components/menus/toolbar.mdx index 0548047148..791b57c6bb 100644 --- a/docs/angular/src/content/jp/components/menus/toolbar.mdx +++ b/docs/angular/src/content/jp/components/menus/toolbar.mdx @@ -13,7 +13,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Toolbar (ツールバー) の概要 -Angular ツールバー コンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、`DataChart` または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 +Angular ツールバー コンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、 または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 ## Angular ツールバーの例 @@ -32,7 +32,7 @@ npm install igniteui-angular-charts npm install igniteui-angular-core ``` -`DataChart` コンポーネントとその機能とともに を使用する場合、次のモジュールが必要です。 + コンポーネントとその機能とともに を使用する場合、次のモジュールが必要です。 @@ -60,21 +60,6 @@ export class AppModule {} -```ts -import { IgxToolbarModule } from 'igniteui-react-layouts'; -import { IgrDataChartToolbarModule, IgrDataChartCoreModule, IgrDataChartCategoryModule, IgrDataChartAnnotationModule, IgrDataChartInteractivityModule, IgrDataChartCategoryTrendLineModule } from 'igniteui-react-charts'; - -IgxToolbarModule.register(); -IgrDataChartToolbarModule.register(); -IgrDataChartCoreModule.register(); -IgrDataChartCategoryModule.register(); -IgrDataChartAnnotationModule.register(); -IgrDataChartInteractivityModule.register(); -IgrDataChartCategoryTrendLineModule.register(); -``` - - - @@ -87,29 +72,29 @@ IgrDataChartCategoryTrendLineModule.register(); ### ツール操作 -以下は、ツールバーに追加できるさまざまな 項目のリストです。 +以下は、ツールバーに追加できるさまざまな 項目のリストです。 -- -- -- -- -- -- -- -- +- +- +- +- +- +- +- +- -これらのツールはそれぞれ、マウスのクリックによってトリガーされる イベントを公開します。注: は、 内にラップすることもできる他のツールのラッパーです。 +これらのツールはそれぞれ、マウスのクリックによってトリガーされる `OnCommand` イベントを公開します。注: は、 内にラップすることもできる他のツールのラッパーです。 - オブジェクトの 、および プロパティを使用して、新規および既存のツールの位置を変更したり、非表示にマークしたりすることができます。ToolActions は プロパティも公開します。 + オブジェクトの 、および プロパティを使用して、新規および既存のツールの位置を変更したり、非表示にマークしたりすることができます。ToolActions は プロパティも公開します。 -次の例は、いくつかの機能を示しています。まず、**ZoomReset** や **AnalyzeMenu** メニュー ツール操作などの組み込みツールを非表示にするなど、`ToolActionSubPanel` でツールをグループ化できます。この例では、`AfterId` プロパティを使用して **ZoomMenu** 内に **ZoomReset** ツール操作の新しいインスタンスを作成し、それを **ZoomOut** に割り当てて配置を正確にします。また、ツールの プロパティによってもハイライト表示されます。 +次の例は、いくつかの機能を示しています。まず、**ZoomReset** や **AnalyzeMenu** メニュー ツール操作などの組み込みツールを非表示にするなど、 でツールをグループ化できます。この例では、 プロパティを使用して **ZoomMenu** 内に **ZoomReset** ツール操作の新しいインスタンスを作成し、それを **ZoomOut** に割り当てて配置を正確にします。また、ツールの プロパティによってもハイライト表示されます。 ### Angular データ チャートの統合 -Angular ツールバーには、 プロパティが含まれています。これは、以下のコードに示すように、`DataChart` などのコンポーネントをリンクするために使用されます。 +Angular ツールバーには、 プロパティが含まれています。これは、以下のコードに示すように、 などのコンポーネントをリンクするために使用されます。 @@ -138,47 +123,47 @@ Angular ツールバーには、 項目とメニューが使用可能になります。以下は、組み込みの Angular `DataChart` ツール操作とそれに関連付けられた `OverlayId` のリストです。 + が Toolbar にリンクされると、いくつかの既存の 項目とメニューが使用可能になります。以下は、組み込みの Angular ツール操作とそれに関連付けられた のリストです。 ズーム操作 -- `ZoomMenu`: チャートのズーム レベルを増減するための `ZoomIn` および `ZoomOut` メソッドを呼び出す 3 つの `ToolActionLabel` 項目を公開する `ToolActionIconMenu` には、チャートの `ResetZoom` メソッドを呼び出してズーム レベルをデフォルトの位置にリセットする `ZoomReset` が含まれます。 +- `ZoomMenu`: チャートのズーム レベルを増減するための および メソッドを呼び出す 3 つの 項目を公開する には、チャートの メソッドを呼び出してズーム レベルをデフォルトの位置にリセットする `ZoomReset` が含まれます。 トレンド操作 -- `AnalyzeMenu`: チャートのさまざまなオプションを構成するためのいくつかのオプションを含む `ToolActionIconMenu`。 +- `AnalyzeMenu`: チャートのさまざまなオプションを構成するためのいくつかのオプションを含む 。 - `AnalyzeHeader`: サブ セクションのヘッダー。 - `LinesMenu`: チャート上で水平破線を表示するためのさまざまなツールが含まれるサブ メニュー。 - `LinesHeader`: 次の 3 つのツールのサブメニュー セクション ヘッダー: - - `MaxValue`: シリーズの最大値で yAxis に沿って水平破線を表示する `ToolActionCheckbox`。 - - `MinValue`: シリーズの最小値で yAxis に沿って水平破線を表示する `ToolActionCheckbox`。 - - `Average`: シリーズの平均値で yAxis に沿って水平破線を表示する `ToolActionCheckbox`。 - - `TrendsMenu`: さまざまな近似曲線を `DataChart` プロット領域に適用するためのツールを含むサブ メニュー。 + - `MaxValue`: シリーズの最大値で yAxis に沿って水平破線を表示する 。 + - `MinValue`: シリーズの最小値で yAxis に沿って水平破線を表示する 。 + - : シリーズの平均値で yAxis に沿って水平破線を表示する 。 + - `TrendsMenu`: さまざまな近似曲線を プロット領域に適用するためのツールを含むサブ メニュー。 - `TrendsHeader`: 次の 3 つのツールのサブメニュー セクション ヘッダー: - - **Exponential**: チャート内の各シリーズの `TrendLineType` を **ExponentialFit** に設定する `ToolActionRadio`。 - - **Linear**: チャート内の各シリーズの `TrendLineType` を **LinearFit** に設定する `ToolActionRadio`。 - - **Logarithmic**: チャート内の各シリーズの `TrendLineType` を **LogarithmicFit** に設定する `ToolActionRadio`。 + - **Exponential**: チャート内の各シリーズの を **ExponentialFit** に設定する 。 + - **Linear**: チャート内の各シリーズの を **LinearFit** に設定する 。 + - **Logarithmic**: チャート内の各シリーズの を **LogarithmicFit** に設定する 。 - `HelpersHeader`: サブ セクションのヘッダー。 - - `SeriesAvg`: `Average` タイプの `ValueLayerValueMode` を使用して、チャートのシリーズ コレクションに `ValueLayer` を追加または削除する `ToolActionCheckbox`。 - - `ValueLabelsMenu`: `DataChart` のプロット領域に注釈を表示するためのさまざまなツールを含むサブ メニュー。 + - `SeriesAvg`: タイプの を使用して、チャートのシリーズ コレクションに を追加または削除する 。 + - `ValueLabelsMenu`: のプロット領域に注釈を表示するためのさまざまなツールを含むサブ メニュー。 - `ValueLabelsHeader`: 次のツールのサブ メニュー セクション ヘッダー: - - `ShowValueLabels`: `CalloutLayer` を使用してデータ ポイント値を切り替える `ToolActionCheckbox`。 - - `ShowLastValueLabel`: `FinalValueLayer` を使用して最終値軸の注釈を切り替える `ToolActionCheckbox`。 -- `ShowCrosshairs`: チャートの `CrosshairsDisplayMode` プロパティを介してマウスオーバー十字線の注釈を切り替える `ToolActionCheckbox`。 -- `ShowGridlines`: X-Axis に `MajorStroke` を適用することで追加のグリッド線を切り替える `ToolActionCheckbox`。 + - `ShowValueLabels`: を使用してデータ ポイント値を切り替える 。 + - `ShowLastValueLabel`: を使用して最終値軸の注釈を切り替える 。 +- `ShowCrosshairs`: チャートの プロパティを介してマウスオーバー十字線の注釈を切り替える 。 +- `ShowGridlines`: X-Axis に `MajorStroke` を適用することで追加のグリッド線を切り替える 。 画像に保存アクション -- `CopyAsImage`: チャートをクリップボードにコピーするオプションを公開する `ToolActionLabel`。 +- `CopyAsImage`: チャートをクリップボードにコピーするオプションを公開する 。 - `CopyHeader`: サブ セクションのヘッダー。 ### SVG アイコン -ツールを手動で追加する場合、 メソッドを使用してアイコンを割り当てることができます。このメソッドには 3 つのパラメーターを渡す必要があります。1 つ目は、ツールで定義されたアイコン コレクション名です (例: `IconCollectionName`)。2 つ目は、ツールで定義されたアイコンの名前 (例: `IconName`) で、その後に SVG 文字列を追加します。 +ツールを手動で追加する場合、`RenderIconFromText` メソッドを使用してアイコンを割り当てることができます。このメソッドには 3 つのパラメーターを渡す必要があります。1 つ目は、ツールで定義されたアイコン コレクション名です (例: )。2 つ目は、ツールで定義されたアイコンの名前 (例: ) で、その後に SVG 文字列を追加します。 ### データ URL アイコン -svg を追加するのと同様に、 を介して URL からアイコン画像を追加することもできます。メソッドの 3 番目のパラメーターは、文字列 URL を入力するために使用されます。 +svg を追加するのと同様に、 を介して URL からアイコン画像を追加することもできます。メソッドの 3 番目のパラメーターは、文字列 URL を入力するために使用されます。 次のスニペットは、アイコンを追加する両方の方法を示しています。 @@ -237,7 +222,7 @@ public toolbarCustomIconOnViewInit(): void { ### Vertical Orientation -By default the Angular Toolbar is shown horizontally, but it also has the ability to shown vertically by setting the property. +By default the Angular Toolbar is shown horizontally, but it also has the ability to shown vertically by setting the property. @@ -291,7 +276,7 @@ The following example demonstrates styling the Angular Data Chart series brush w {/* ## Styling/Theming -The icon component can be styled by using it's `BaseTheme` property directly to the `Toolbar`. +The icon component can be styled by using it's property directly to the . @@ -314,7 +299,7 @@ The icon component can be styled by using it's `BaseTheme` property directly to ## API References -
+

## Additional Resources diff --git a/docs/angular/src/content/jp/components/navbar.mdx b/docs/angular/src/content/jp/components/navbar.mdx index 9af72c4c3f..7039793f46 100644 --- a/docs/angular/src/content/jp/components/navbar.mdx +++ b/docs/angular/src/content/jp/components/navbar.mdx @@ -207,7 +207,7 @@ export class NavbarSample3Component { } ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/pivotgrid/pivot-grid.mdx b/docs/angular/src/content/jp/components/pivotgrid/pivot-grid.mdx index 2bf374bf84..c8bd786545 100644 --- a/docs/angular/src/content/jp/components/pivotgrid/pivot-grid.mdx +++ b/docs/angular/src/content/jp/components/pivotgrid/pivot-grid.mdx @@ -38,7 +38,7 @@ Ignite UI for Angular Pivot Grid コンポーネントを使用した作業を ng add igniteui-angular ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/radial-gauge.mdx b/docs/angular/src/content/jp/components/radial-gauge.mdx index d869b4e649..c0711b8736 100644 --- a/docs/angular/src/content/jp/components/radial-gauge.mdx +++ b/docs/angular/src/content/jp/components/radial-gauge.mdx @@ -13,11 +13,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular ラジアル ゲージの概要 -Angular Radial Gauge コンポーネントは、針、目盛り、範囲、ラベルなどの視覚要素をサポートし、定義済みの図形やスケールを表示できます。`RadialGauge` には、アニメーション化されたトランジションのサポートも組み込まれています。アニメーションは、 プロパティの設定で簡単にカスタマイズできます。 +Angular Radial Gauge コンポーネントは、針、目盛り、範囲、ラベルなどの視覚要素をサポートし、定義済みの図形やスケールを表示できます。 には、アニメーション化されたトランジションのサポートも組み込まれています。アニメーションは、 プロパティの設定で簡単にカスタマイズできます。 ## Angular ラジアル ゲージの例 -以下のサンプルは、同じ `RadialGauge` でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 +以下のサンプルは、同じ でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 @@ -49,7 +49,7 @@ npm install --save igniteui-angular-gauges ## モジュールの要件 -`RadialGauge` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 @@ -123,7 +123,7 @@ export class AppModule {} バッキング要素はラジアル ゲージ コントロールの背景と境界線を表します。常に最初に描画される要素で針、ラベルやメモリなどの残りの要素はその上のオーバーレイです。 -バッキングは、円形またはフィットにできます。円形の場合は 360 度の円形のゲージが作成されますが、一方フィット図形の場合は `ScaleStartAngle` および `ScaleEndAngle` プロパティで円弧部分が塗りつぶされます。これには、`BackingShape` プロパティを設定します。 +バッキングは、円形またはフィットにできます。円形の場合は 360 度の円形のゲージが作成されますが、一方フィット図形の場合は および プロパティで円弧部分が塗りつぶされます。これには、 プロパティを設定します。 @@ -159,7 +159,7 @@ export class AppModule {} ## スケール -スケールは視覚要素で、`MinimumValue` と `MaximumValue` 値を設定してゲージの値範囲全体をハイライト表示できます。バッキングとともにゲージの全体的な図形を定義します。`ScaleStartAngle` と `ScaleEndAngle` プロパティは、スケールの円弧の境界線を定義します。`ScaleSweepDirection` プロパティが、スケールが時計回りまたは反時計回りのどちらの方向に動くかを指定します。`ScaleBrush`、`ScaleStartExtent`、`ScaleEndExtent` プロパティを設定してスケールの外観をカスタマイズできます。 +スケールは視覚要素で、 値を設定してゲージの値範囲全体をハイライト表示できます。バッキングとともにゲージの全体的な図形を定義します。 プロパティは、スケールの円弧の境界線を定義します。 プロパティが、スケールが時計回りまたは反時計回りのどちらの方向に動くかを指定します。 プロパティを設定してスケールの外観をカスタマイズできます。 @@ -194,9 +194,9 @@ export class AppModule {} ## ラベルとタイトル -ゲージ ラベルは `MinimumValue` と `MaximumValue` の値の間で指定された間隔で数値を表示する視覚要素です。0 はゲージ中央、1 はゲージ バッキングの外側範囲を表す `LabelExtent` プロパティで小数を使用してラベルの配置を設定できます。`FontBrush` や `Font` など、さまざまなスタイル プロパティを設定してラベルをカスタマイズできます。 +ゲージ ラベルは の値の間で指定された間隔で数値を表示する視覚要素です。0 はゲージ中央、1 はゲージ バッキングの外側範囲を表す プロパティで小数を使用してラベルの配置を設定できます。 など、さまざまなスタイル プロパティを設定してラベルをカスタマイズできます。 -これらの針のラベルにはそれぞれ、`TitleExtent`、`TitleAngle`、`SubtitleFontSize`、`HighlightLabelBrush` など、フォント、角度、ブラシ、ゲージの中心からの距離を変更するために適用できるさまざまなスタイル属性があります。 +これらの針のラベルにはそれぞれ、、`SubtitleFontSize`、 など、フォント、角度、ブラシ、ゲージの中心からの距離を変更するために適用できるさまざまなスタイル属性があります。 @@ -226,9 +226,9 @@ export class AppModule {} ## タイトルとサブタイトル -`TitleText` プロパティと `SubtitleText` プロパティが使用可能であり、どちらも針のカスタム テキストを表示するために使用できます。あるいは、`TitleDisplaysValue` と `SubtitleDisplaysValue` を true に設定すると、針の値が表示され、`TitleText` と `SubtitleText` がオーバーライドされます。したがって、タイトルにカスタム テキストを使用しながらサブタイトルで値を表示したり、その逆を行ったりすることができます。 + プロパティと プロパティが使用可能であり、どちらも針のカスタム テキストを表示するために使用できます。あるいは、 を true に設定すると、針の値が表示され、 がオーバーライドされます。したがって、タイトルにカスタム テキストを使用しながらサブタイトルで値を表示したり、その逆を行ったりすることができます。 -以下に説明するように針のハイライトが表示されている場合は、`HighlightLabelText` を介してカスタム テキストを表示できます。それ以外の場合は、`HighlightLabelDisplaysValue` を有効にしてその値を表示できます。 +以下に説明するように針のハイライトが表示されている場合は、 を介してカスタム テキストを表示できます。それ以外の場合は、 を有効にしてその値を表示できます。 @@ -249,14 +249,14 @@ export class AppModule {} ## オプティカル スケーリング -ラジアル ゲージのラベルとタイトルにより、スケーリングを変更できます。これを有効にするには、まず `OpticalScalingEnabled` を true に設定します。次に、ラベルが 100% のオプティカル スケーリングを持つサイズを管理する `OpticalScalingSize` を設定できます。ゲージのサイズが大きくなると、ラベルのフォントも大きくなります。たとえば、このプロパティが 500 に設定され、ゲージのピクセル単位のサイズが 2 倍の 1000 になると、ラベルのフォント サイズは 200% 大きくなります。 +ラジアル ゲージのラベルとタイトルにより、スケーリングを変更できます。これを有効にするには、まず を true に設定します。次に、ラベルが 100% のオプティカル スケーリングを持つサイズを管理する を設定できます。ゲージのサイズが大きくなると、ラベルのフォントも大きくなります。たとえば、このプロパティが 500 に設定され、ゲージのピクセル単位のサイズが 2 倍の 1000 になると、ラベルのフォント サイズは 200% 大きくなります。 ## 目盛 -目盛は、ラジアル ゲージの中央から放射状に表示される細い線です。目盛には、主目盛および副目盛の 2 種類があり、主目盛りは `MinimumValue` と `MaximumValue` の間の `Interval` に表示されます。また `MinorTickCount` プロパティは、隣接する 2 つの主目盛間の副目盛の数を指定します。目盛りの長さは、`TickStartExtent`、`TickEndExtent`、`MinorTickStartExtent`、`MinorTickEndExtent` に少数値 (0 から 1 の間) を設定して制御できます。 +目盛は、ラジアル ゲージの中央から放射状に表示される細い線です。目盛には、主目盛および副目盛の 2 種類があり、主目盛りは の間の に表示されます。また プロパティは、隣接する 2 つの主目盛間の副目盛の数を指定します。目盛りの長さは、 に少数値 (0 から 1 の間) を設定して制御できます。 @@ -292,7 +292,7 @@ export class AppModule {} ## 範囲 -範囲に `MinimumValue` や `MaximumValue` プロパティで指定した連続値の境界をハイライト表示します。開始値と終了値を指定してゲージに複数の範囲を追加でき、各範囲には、`Brush` や `Outline` などのカスタマイズ プロパティがあります。または、`RangeBrushes` や `RangeOutlines` プロパティを範囲の色リストに設定することもできます。 +範囲に プロパティで指定した連続値の境界をハイライト表示します。開始値と終了値を指定してゲージに複数の範囲を追加でき、各範囲には、 などのカスタマイズ プロパティがあります。または、 プロパティを範囲の色リストに設定することもできます。 @@ -332,9 +332,9 @@ export class AppModule {} ゲージ針は、ゲージの設定値を示す視覚要素です。針は、あらかじめ定義されたいくつかの図形の中から選択でき、ピボット図形をゲージの中心に配置できます。またピボット図形は、事前に定義された図形の 1 つを使用します。オーバーレイとアンダーレイを含むピボット図形には、図形に適用する別のピボット ブラシがあります。 -サポートされている針の形とキャップは、`NeedleShape` と `NeedlePivotShape` プロパティで設定します。 +サポートされている針の形とキャップは、 プロパティで設定します。 -ゲージのインタラクティブ モードを有効 (`IsNeedleDraggingEnabled` プロパティを使用) にするとユーザーは `MinimumValue` と `MaximumValue` の値間で針をドラッグして値を変更できるようになります。 +ゲージのインタラクティブ モードを有効 ( プロパティを使用) にするとユーザーは の値間で針をドラッグして値を変更できるようになります。 @@ -372,7 +372,7 @@ export class AppModule {} ## 針のハイライト -ラジアル ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の `Value` の不透明度が低く表示されます。これを有効にするには、まず `HighlightValueDisplayMode` を Overlay に設定し、次に `HighlightValue` を適用します。 +ラジアル ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の の不透明度が低く表示されます。これを有効にするには、まず を Overlay に設定し、次に を適用します。 diff --git a/docs/angular/src/content/jp/components/select.mdx b/docs/angular/src/content/jp/components/select.mdx index 7d285a7838..cb105689e1 100644 --- a/docs/angular/src/content/jp/components/select.mdx +++ b/docs/angular/src/content/jp/components/select.mdx @@ -92,7 +92,7 @@ Ignite UI for Angular Select モジュールまたはディレクティブをイ ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/snackbar.mdx b/docs/angular/src/content/jp/components/snackbar.mdx index 696b64d394..394fb56956 100644 --- a/docs/angular/src/content/jp/components/snackbar.mdx +++ b/docs/angular/src/content/jp/components/snackbar.mdx @@ -217,7 +217,7 @@ Snackbar の主な機能を説明しました。次の例はより複雑なサ ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/spreadsheet-activation.mdx b/docs/angular/src/content/jp/components/spreadsheet-activation.mdx index e7b2becc6c..e6cba4d7f3 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-activation.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-activation.mdx @@ -31,15 +31,15 @@ Angular Spreadsheet コンポーネントは、コントロールで現在アク ## アクティベーションの概要 -Angular コントロールのアクティブ化は、スプレッドシートの現在の のセル、ペイン、およびワークシート間で分割されます。3 つの アクティブなプロパティは以下のとおりです。 +Angular コントロールのアクティブ化は、スプレッドシートの現在の のセル、ペイン、およびワークシート間で分割されます。3 つの アクティブなプロパティは以下のとおりです。 -- : スプレッドシートのアクティブ セルを設定します。設定するには、 の新しいインスタンスを作成し、そのセルに関する列と行、またはセルの文字列アドレスなどの情報を渡す必要があります。 -- : スプレッドシート コントロールの現在アクティブなワークシートのアクティブ ペインを返します。 -- : スプレッドシート コントロールの 内のアクティブ ワークシートを返すか、設定します。これは、スプレッドシートに添付されている 内の既存のワークシートに設定することで設定できます。 +- : スプレッドシートのアクティブ セルを設定します。設定するには、 の新しいインスタンスを作成し、そのセルに関する列と行、またはセルの文字列アドレスなどの情報を渡す必要があります。 +- : スプレッドシート コントロールの現在アクティブなワークシートのアクティブ ペインを返します。 +- : スプレッドシート コントロールの 内のアクティブ ワークシートを返すか、設定します。これは、スプレッドシートに添付されている 内の既存のワークシートに設定することで設定できます。 ## コード スニペット -次のコード スニペットは、 コントロールのセルとワークシートのアクティブ化の設定を示しています。 +次のコード スニペットは、 コントロールのセルとワークシートのアクティブ化の設定を示しています。 ```ts this.spreadsheet.activeWorksheet = this.spreadsheet.workbook.worksheets(1); @@ -50,6 +50,6 @@ this.spreadsheet.activeCell = new SpreadsheetCell("C5"); ## API リファレンス -
-
+
+

diff --git a/docs/angular/src/content/jp/components/spreadsheet-chart-adapter.mdx b/docs/angular/src/content/jp/components/spreadsheet-chart-adapter.mdx index 586e32a33c..6e11dfca72 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-chart-adapter.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-chart-adapter.mdx @@ -13,7 +13,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Spreadsheet チャート アダプター -Angular Spreadsheet コンポーネントを使用して にチャートを表示できます。 +Angular Spreadsheet コンポーネントを使用して にチャートを表示できます。 ## Angular Spreadsheet チャート アダプターの例 @@ -24,9 +24,9 @@ Angular Spreadsheet コンポーネントを使用して を使用すると、スプレッドシートにチャートを表示できます。スプレッドシート チャート アダプターは、Infragistics.Documents.Excel.WorksheetChart インスタンスに基づいてスプレッド シートのチャート要素を作成し、初期化します。 -WorksheetChart をワークシートに追加するには、ワークシートの Shapes コレクションの `AddChart` メソッドを使用する必要があります。チャートの追加の詳細については、下記をご覧ください。 +WorksheetChart をワークシートに追加するには、ワークシートの Shapes コレクションの メソッドを使用する必要があります。チャートの追加の詳細については、下記をご覧ください。 以下はその手順です。 @@ -86,10 +86,10 @@ Spreadsheet ChartAdapter は、折れ線、エリア、縦棒、ドーナツを -以下のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して `Workbook` を保存およびロードしています。 +以下のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して を保存およびロードしています。 -ハイパーリンクを使用するように Angular スプレッドシート コントロールを設定するときは、`SpreadsheetChartAdapter` クラスをインポートする必要があります。 +ハイパーリンクを使用するように Angular スプレッドシート コントロールを設定するときは、 クラスをインポートする必要があります。 @@ -111,7 +111,7 @@ import { WorksheetCell } from 'igniteui-angular-excel'; ## コード スニペット -以下のコード スニペットは、 コントロールで現在表示されているワークシートにハイパーリンクを追加する方法を示しています。 +以下のコード スニペットは、 コントロールで現在表示されているワークシートにハイパーリンクを追加する方法を示しています。 ```typescript this.spreadsheet.chartAdapter = new SpreadsheetChartAdapter(); @@ -168,6 +168,6 @@ ExcelUtility.loadFromUrl(process.env.PUBLIC_URL + "/ExcelFiles/ChartData.xlsx"). ## API リファレンス -
-
+
+

diff --git a/docs/angular/src/content/jp/components/spreadsheet-clipboard.mdx b/docs/angular/src/content/jp/components/spreadsheet-clipboard.mdx index 2adb3dbc23..872c079979 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-clipboard.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-clipboard.mdx @@ -26,7 +26,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 依存関係 -クリップボードを利用する前に、 列挙型をインポートします。 +クリップボードを利用する前に、`SpreadsheetAction` 列挙型をインポートします。 @@ -46,7 +46,7 @@ import { SpreadsheetAction } from 'igniteui-angular-spreadsheet'; ## 使用方法 -次のコード スニペットは、Angular コントロールでクリップボードに関連するコマンドを実行する方法を示しています。 +次のコード スニペットは、Angular コントロールでクリップボードに関連するコマンドを実行する方法を示しています。 ```ts public cut(): void { @@ -65,5 +65,5 @@ public paste(): void { ## API リファレンス -
-
+`SpreadsheetAction`
+
diff --git a/docs/angular/src/content/jp/components/spreadsheet-commands.mdx b/docs/angular/src/content/jp/components/spreadsheet-commands.mdx index eb991aa3d4..7ba4c2377b 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-commands.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-commands.mdx @@ -26,7 +26,7 @@ Angular Spreadsheet コンポーネントは、スプレッドシートのさま ## 依存関係 -コマンドボードを利用する前に、 をインポートします。 +コマンドボードを利用する前に、`SpreadsheetAction` をインポートします。 @@ -74,4 +74,4 @@ public zoomOut(): void { ## API リファレンス -
+`SpreadsheetAction`
diff --git a/docs/angular/src/content/jp/components/spreadsheet-conditional-formatting.mdx b/docs/angular/src/content/jp/components/spreadsheet-conditional-formatting.mdx index fc4eb00a46..8772ad2210 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-conditional-formatting.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-conditional-formatting.mdx @@ -26,37 +26,37 @@ Angular Spreadsheet コンポーネントは、ワークシートのセルに条 ## 条件付き書式設定の概要 -特定のワークシートの条件付き書式を構成するには、ワークシートの `ConditionalFormats` コレクションに公開される `Add` メソッドを使用できます。この `Add` メソッドの最初のパラメーターは条件付き書式に適用するワークシートの string 領域です。 +特定のワークシートの条件付き書式を構成するには、ワークシートの コレクションに公開される `Add` メソッドを使用できます。この `Add` メソッドの最初のパラメーターは条件付き書式に適用するワークシートの string 領域です。 -ワークシートに追加できる条件付き書式の多くには、その条件付き書式の条件が満たされたときにセルを表示する方法を決定する `CellFormat` プロパティがあります。たとえば、`Fill` および `Font` などのこの `CellFormat` プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 +ワークシートに追加できる条件付き書式の多くには、その条件付き書式の条件が満たされたときにセルを表示する方法を決定する プロパティがあります。たとえば、 および などのこの プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 -条件付き書式が作成され、`CellFormat` が適用される場合、ワークシートのセルにサポートされるプロパティのサブセットがあります。現在サポートされる `CellFormat` プロパティは `Fill`、`Border` プロパティ、`FormatString`、および strikethrough、underline、italic、bold、color などの `Font` プロパティです。以下のコード スニペットに複数のプロパティが設定されます。 +条件付き書式が作成され、 が適用される場合、ワークシートのセルにサポートされるプロパティのサブセットがあります。現在サポートされる プロパティは 、`Border` プロパティ、、および strikethrough、underline、italic、bold、color などの プロパティです。以下のコード スニペットに複数のプロパティが設定されます。 -ワーク セルの可視化の動作が異なるため、`CellFormat` プロパティがない条件付き書式もあります。この条件付き書式は `DataBarConditionalFormat`、`ColorScaleConditionalFormat`、`IconSetConditionalFormat` です。 +ワーク セルの可視化の動作が異なるため、 プロパティがない条件付き書式もあります。この条件付き書式は です。 既存の Workbook を Excel から読み込む際に、ワークブックが読み込まれた場合も書式設定は保持されます。ワークブックを Excel ファイルに保存する場合も保持されます。 -以下は、Angular コントロールでサポートされている条件付き書式の一覧です。 - -- `AverageConditionalFormat`: `AddAverageCondition` メソッドを使用して追加されたこの条件付きフォーマットは、セルの値が関連する範囲の平均または標準偏差より上か下かに基づいて、ワークシートセルの視覚属性を制御するプロパティを公開します。 -- `BlanksConditionalFormat`: `AddBlanksCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `ColorScaleConditionalFormat`: `AddColorScaleCondition` メソッドを使用して追加された条件付き書式は、最小値、中央値、最大値に対するセルの値に基づいてワークシート セルの色を制御するプロパティを公開します。 -- `DataBarConditionalFormat`: `AddDataBarCondition` メソッドを使用して追加されたこの条件付き書式は、関連付けられた値の範囲に対するセルの値に基づいてワークシートのセルにデータバーを表示するプロパティを公開します。 -- `DateTimeConditionalFormat`: `AddDateTimeCondition` メソッドを使用して追加されたこの条件付き書式は、セルの日付値が指定された時間範囲内にあるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `DuplicateConditionalFormat`: `AddDuplicateCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が一意であるか、関連付けられた範囲全体で複製されるかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `ErrorsConditionalFormat`: `AddErrorsCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `FormulaConditionalFormat`: `AddFormulaCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が式で定義された基準を満たすかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 -- `IconSetConditionalFormat`: `AddIconSetCondition` メソッドを使用して追加されたこの条件付き書式は、しきい値に対するセルの値に基づいてワークシートのセルにアイコンを表示するプロパティを公開します。 -- `NoBlanksConditionalFormat`: `AddNoBlanksCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `NoErrorsConditionalFormat`: `AddNoErrorsCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `OperatorConditionalFormat`: `AddOperatorCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が論理演算子で定義された基準を満たすかどうかに基づいてワークシートセルの視覚属性を制御するプロパティを公開します。 -- `RankConditionalFormat`: `AddRankCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が関連する範囲全体の値の最下位ランクの上部にあるかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 -- `TextOperatorConditionalFormat`: `AddRankCondition` メソッドを使用して追加されたこの条件付き書式は、セルのテキスト値が `AddTextCondition` メソッドのパラメーターの文字列および `FormatConditionTextOperator` 値にで定義された基準を満たすかどうかに基づいてワークシート セルのビジュアル属性を制御するプロパティを公開します。 -- `UniqueConditionalFormat`: `AddUniqueCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が関連付けられた範囲全体で一意であるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +以下は、Angular コントロールでサポートされている条件付き書式の一覧です。 + +- : メソッドを使用して追加されたこの条件付きフォーマットは、セルの値が関連する範囲の平均または標準偏差より上か下かに基づいて、ワークシートセルの視覚属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加された条件付き書式は、最小値、中央値、最大値に対するセルの値に基づいてワークシート セルの色を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、関連付けられた値の範囲に対するセルの値に基づいてワークシートのセルにデータバーを表示するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの日付値が指定された時間範囲内にあるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が一意であるか、関連付けられた範囲全体で複製されるかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が式で定義された基準を満たすかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、しきい値に対するセルの値に基づいてワークシートのセルにアイコンを表示するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が論理演算子で定義された基準を満たすかどうかに基づいてワークシートセルの視覚属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が関連する範囲全体の値の最下位ランクの上部にあるかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルのテキスト値が メソッドのパラメーターの文字列および 値にで定義された基準を満たすかどうかに基づいてワークシート セルのビジュアル属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が関連付けられた範囲全体で一意であるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 ## 依存関係 -`Spreadsheet` コントロールに条件付き書式を追加するには、以下の依存関係をインポートする必要があります。 + コントロールに条件付き書式を追加するには、以下の依存関係をインポートする必要があります。 ```ts diff --git a/docs/angular/src/content/jp/components/spreadsheet-configuring.mdx b/docs/angular/src/content/jp/components/spreadsheet-configuring.mdx index 2038b7c45e..8c12ea7fb4 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-configuring.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-configuring.mdx @@ -26,11 +26,11 @@ Angular Spreadsheet コンポネントは、セルの編集、グリッド線と ## セル編集の構成 -ユーザーがセルの値を編集して新しい入力を確認すると、スプレッドシートの構成に応じて、`Spreadsheet` コントロールに ENTER キーを押すと現在アクティブなセルに隣接するセルに移動できます。 +ユーザーがセルの値を編集して新しい入力を確認すると、スプレッドシートの構成に応じて、 コントロールに ENTER キーを押すと現在アクティブなセルに隣接するセルに移動できます。 -この ENTER キーナビゲーションを有効にするために、`IsEnterKeyNavigationEnabled` プロパティを **true** に設定できます。false に設定すると、ENTER キーを押してもアクティブ セルは変わりません。 +この ENTER キーナビゲーションを有効にするために、 プロパティを **true** に設定できます。false に設定すると、ENTER キーを押してもアクティブ セルは変わりません。 -Enter キーを押したときに移動する隣接セルの方向は、`EnterKeyNavigationDirection` プロパティを `Down`、`Up`、`Left`、`Right` に設定して構成することもできます。 +Enter キーを押したときに移動する隣接セルの方向は、 プロパティを `Down`、`Up`、`Left`、`Right` に設定して構成することもできます。 以下のコード スニペットは上記のデモです。 @@ -59,7 +59,7 @@ this.spreadsheet.enterKeyNavigationDirection = SpreadsheetEnterKeyNavigationDire ## 数式バーの構成 -Angular `Spreadsheet` は、コントロールの `IsFormulaBarVisible` プロパティを設定して数式バーの表示/非表示を設定できます。 +Angular は、コントロールの プロパティを設定して数式バーの表示/非表示を設定できます。 以下のコード スニペットは上記のデモです。 @@ -81,7 +81,7 @@ this.spreadsheet.isFormulaBarVisible = true; ## ガイドラインの設定 -`Spreadsheet` は、コントロールの `AreGridlinesVisible` プロパティを設定して数式バーの表示/非表示を設定できます。 + は、コントロールの プロパティを設定して数式バーの表示/非表示を設定できます。 以下のコード スニペットは上記のデモです。 @@ -103,7 +103,7 @@ this.spreadsheet.areGridlinesVisible = true; ## ヘッダーの構成 -`Spreadsheet` は、`AreHeadersVisible` プロパティを設定してへッダーの可視性を設定できます。 + は、 プロパティを設定してへッダーの可視性を設定できます。 以下のコード スニペットは上記のデモです。 @@ -125,13 +125,13 @@ this.spreadsheet.areHeadersVisible = false; ## ナビゲーションの構成 -`Spreadsheet` コントロールは、コントロールが「終了モード」にあるかどうかを構成することによって、ワークシートのセル間のナビゲーションを構成できます。終了モードは、矢印キーを押すと、アクティブなセルが、押された矢印キーの方向に応じて、現在のセルからデータが隣接するセルの行または列の末尾に移動する機能です。この機能は、大規模なデータ ブロックの最後まですばやく移動する際に役立ちます。 + コントロールは、コントロールが「終了モード」にあるかどうかを構成することによって、ワークシートのセル間のナビゲーションを構成できます。終了モードは、矢印キーを押すと、アクティブなセルが、押された矢印キーの方向に応じて、現在のセルからデータが隣接するセルの行または列の末尾に移動する機能です。この機能は、大規模なデータ ブロックの最後まですばやく移動する際に役立ちます。 -たとえば、終了モードになっているときに、100x100 の大きなデータブロックをクリックして 矢印キーを押すと、現在の行の右端に移動し、データのある一番右の列に移動します。この操作の後、`Spreadsheet` は終了モードから飛び出します。 +たとえば、終了モードになっているときに、100x100 の大きなデータブロックをクリックして 矢印キーを押すと、現在の行の右端に移動し、データのある一番右の列に移動します。この操作の後、 は終了モードから飛び出します。 -ユーザーが END キーを押すと、実行時に終了モードが有効になりますが、スプレッドシート コントロールの `IsInEndMode` プロパティを設定することでプログラムで設定できます。 +ユーザーが END キーを押すと、実行時に終了モードが有効になりますが、スプレッドシート コントロールの プロパティを設定することでプログラムで設定できます。 -以下のコード スニペットは、`Spreadsheet` を終了モードで開始させる方法を示しています。 +以下のコード スニペットは、 を終了モードで開始させる方法を示しています。 @@ -151,9 +151,9 @@ this.spreadsheet.isInEndMode = true; ## 保護の設定 -`Spreadsheet` は、ワークシートごとにブックを保護します。ワークシートの保護の設定は、ワークシートの `Protect()` メソッドを呼び出して保護し、`Unprotect()` メソッドを呼び出して保護解除することで設定できます。 + は、ワークシートごとにブックを保護します。ワークシートの保護の設定は、ワークシートの `Protect()` メソッドを呼び出して保護し、`Unprotect()` メソッドを呼び出して保護解除することで設定できます。 -以下のコードは、`Spreadsheet` コントロールの現在アクティブなワークシートの保護を有効または無効にすることができます。 +以下のコードは、 コントロールの現在アクティブなワークシートの保護を有効または無効にすることができます。 ```ts this.spreadsheet.activeWorksheet.protect(); @@ -162,13 +162,13 @@ this.spreadsheet.activeWorksheet.unprotect(); ## 選択の設定 -`Spreadsheet` コントロールは、コントロールで許可されている選択の種類を設定できます。その後、ユーザーが修飾キー (SHIFT または CTRL) を押します。これは、スプレッドシートの `SelectionMode` プロパティを次のいずれかの値に設定することによって行われます。 + コントロールは、コントロールで許可されている選択の種類を設定できます。その後、ユーザーが修飾キー (SHIFT または CTRL) を押します。これは、スプレッドシートの プロパティを次のいずれかの値に設定することによって行われます。 -- `AddToSelection`: マウスでドラッグするときに CTRL キーを押す必要はありません。新しいセル範囲が `SpreadsheetSelection` オブジェクトの `CellRanges` コレクションに追加され、モードに入った後に最初の矢印キーナビゲーションで範囲が追加されます。シフト+F8 を押すとモードに入ります。 -- `ExtendSelection`: `SpreadsheetSelection` オブジェクトの `CellRanges` コレクション内の選択範囲は、マウスを使用してセルを選択するかキーボードで移動すると更新されます。 +- `AddToSelection`: マウスでドラッグするときに CTRL キーを押す必要はありません。新しいセル範囲が オブジェクトの コレクションに追加され、モードに入った後に最初の矢印キーナビゲーションで範囲が追加されます。シフト+F8 を押すとモードに入ります。 +- `ExtendSelection`: オブジェクトの コレクション内の選択範囲は、マウスを使用してセルを選択するかキーボードで移動すると更新されます。 - `Normal`: セルまたはセルの範囲を選択するためにマウスをドラッグすると選択が置き換えられます。同様に、キーボードで移動すると新しい選択範囲が作成されます。CTRL キーを押したままマウスを使用することで新しい範囲を追加できます。また、SHIFT キーを押したままマウスでクリックする、あるいはキーボードで移動することでアクティブ セルを含む選択範囲を変更できます。 -上記の説明で述べた `SpreadsheetSelection` オブジェクトは、`Spreadsheet` コントロールの `ActiveSelection` プロパティを使用して取得できます。 +上記の説明で述べた オブジェクトは、 コントロールの プロパティを使用して取得できます。 次のコード スニペットは、選択モードの設定を示しています。 @@ -192,9 +192,9 @@ this.spreadsheet.activeWorksheet.unprotect(); this.spreadsheet.selectionMode = SpreadsheetCellSelectionMode.ExtendSelection; ``` -`Spreadsheet` コントロールの選択は、プログラムで設定または取得することもできます。単一選択の場合は、`ActiveCell` プロパティを設定できます。複数選択は、`Spreadsheet` コントロールの `ActiveSelection` プロパティによって返される `SpreadsheetSelection` オブジェクトを介して行われます。 + コントロールの選択は、プログラムで設定または取得することもできます。単一選択の場合は、 プロパティを設定できます。複数選択は、 コントロールの プロパティによって返される オブジェクトを介して行われます。 -`SpreadsheetSelection` オブジェクトには、新しい `SpreadsheetCellRange` オブジェクトの形式でスプレッドシートの選択範囲にプログラムでセルの範囲を追加できる `AddCellRange()` メソッドがあります。 + オブジェクトには、新しい オブジェクトの形式でスプレッドシートの選択範囲にプログラムでセルの範囲を追加できる `AddCellRange()` メソッドがあります。 次のコード スニペットは、スプレッドシートの選択範囲にセル範囲を追加する方法を示しています。 @@ -204,7 +204,7 @@ this.spreadsheet.activeSelection.addCellRange(new SpreadsheetCellRange(2, 2, 5, ## タブバー領域の構成 -`Spreadsheet` コントロールは、`TabBarWidth` プロパティと `TabBarVisibility` プロパティを介して、現在アクティブな `Workbook` の `WindowOptions` からタブバー領域の表示設定と幅の設定を使用します。 + コントロールは、`TabBarWidth` プロパティと `TabBarVisibility` プロパティを介して、現在アクティブな からタブバー領域の表示設定と幅の設定を使用します。 タブバー領域は、ワークシート名をコントロール内のタブとして可視化する領域です。 @@ -218,9 +218,9 @@ this.spreadsheet.workbook.windowOptions.tabBarWidth = 200; ## ズーム レベルの設定 -Angular Spreadsheet コンポーネントは、`ZoomLevel` プロパティを設定してズームインとズームアウト機能を追加できます。ズーム レベルは最大 400%、最小 10% です。 +Angular Spreadsheet コンポーネントは、 プロパティを設定してズームインとズームアウト機能を追加できます。ズーム レベルは最大 400%、最小 10% です。 -このプロパティを数値に設定すると、整数としてのパーセンテージが表されるため、`ZoomLevel` を 100 に設定することは、100% に設定することと同じです。 +このプロパティを数値に設定すると、整数としてのパーセンテージが表されるため、 を 100 に設定することは、100% に設定することと同じです。 次のコード スニペットは、スプレッドシートのズームレベルを設定する方法を示しています。 @@ -243,7 +243,7 @@ this.spreadsheet.zoomLevel = 200; ## API リファレンス -
-
-
+
+
+

diff --git a/docs/angular/src/content/jp/components/spreadsheet-hyperlinks.mdx b/docs/angular/src/content/jp/components/spreadsheet-hyperlinks.mdx index d3b5623b73..f9b3921b96 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-hyperlinks.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-hyperlinks.mdx @@ -26,11 +26,11 @@ Angular Spreadsheet コンポーネントは、Excel ワークブックに既存 ## ハイパーリンク概要 -ハイパーリンクを配置するワークシートの `Hyperlinks` コレクションにアクセスすると、ハイパーリンクが表計算、`Spreadsheet` コントロールに追加されます。このコレクションには、`WorksheetHyperlink` オブジェクトを受け取る `Add` メソッドがあり、セル アドレス、移動先のハイパーリンク URL、表示テキスト、およびオプションでホバー時に表示するツールチップを定義できます。 +ハイパーリンクを配置するワークシートの `Hyperlinks` コレクションにアクセスすると、ハイパーリンクが表計算、 コントロールに追加されます。このコレクションには、 オブジェクトを受け取る `Add` メソッドがあり、セル アドレス、移動先のハイパーリンク URL、表示テキスト、およびオプションでホバー時に表示するツールチップを定義できます。 ## 依存関係 -ハイパーリンクを使用するように Angular スプレッドシート コントロールを設定するときは、`WorksheetHyperlink` クラスをインポートする必要があります。 +ハイパーリンクを使用するように Angular スプレッドシート コントロールを設定するときは、 クラスをインポートする必要があります。 ```ts diff --git a/docs/angular/src/content/jp/components/spreadsheet-overview.mdx b/docs/angular/src/content/jp/components/spreadsheet-overview.mdx index 85d4a6cc73..a206ed8912 100644 --- a/docs/angular/src/content/jp/components/spreadsheet-overview.mdx +++ b/docs/angular/src/content/jp/components/spreadsheet-overview.mdx @@ -13,7 +13,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # Angular Spreadsheet の概要 -Angular Spreadsheet (Excel ビューア) コンポーネントは軽量で機能が豊富で、科学、ビジネス、財務など、あらゆる種類のスプレッドシート データを操作、視覚化、編集するために必要なすべてのオプションが用意されています。すべての情報は、セル、ペイン、およびワークシート間を直感的かつ簡単にナビゲートできる表形式で表示できます。`Spreadsheet` は、Excel のような柔軟なインターフェイス、詳細なチャート、およびアクティブ化、セル編集、条件付き書式設定、スタイル設定、選択、クリップボードなどの機能によって補完されます。 +Angular Spreadsheet (Excel ビューア) コンポーネントは軽量で機能が豊富で、科学、ビジネス、財務など、あらゆる種類のスプレッドシート データを操作、視覚化、編集するために必要なすべてのオプションが用意されています。すべての情報は、セル、ペイン、およびワークシート間を直感的かつ簡単にナビゲートできる表形式で表示できます。 は、Excel のような柔軟なインターフェイス、詳細なチャート、およびアクティブ化、セル編集、条件付き書式設定、スタイル設定、選択、クリップボードなどの機能によって補完されます。 ## Angular Spreadsheet の例 @@ -69,7 +69,7 @@ npm install --save igniteui-angular-spreadsheet ## モジュールの要件 -`Spreadsheet` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 @@ -116,7 +116,7 @@ Angular スプレッドシート モジュールがインポートされたの -次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して `Workbook` を保存およびロードしています。 +次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して を保存およびロードしています。 以下は、ワークブックを Angular スプレッドシートにロードする方法を示しています。 @@ -149,5 +149,5 @@ ngOnInit() { ## API リファレンス -
+

diff --git a/docs/angular/src/content/jp/components/stepper.mdx b/docs/angular/src/content/jp/components/stepper.mdx index 77da71c868..9028cc8a45 100644 --- a/docs/angular/src/content/jp/components/stepper.mdx +++ b/docs/angular/src/content/jp/components/stepper.mdx @@ -117,7 +117,7 @@ Angular Stepper モジュールまたはディレクティブをインポート ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/style-guide.mdx b/docs/angular/src/content/jp/components/style-guide.mdx index f9be4a8a4d..3a7c6eb74a 100644 --- a/docs/angular/src/content/jp/components/style-guide.mdx +++ b/docs/angular/src/content/jp/components/style-guide.mdx @@ -130,11 +130,11 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' これはメモのテキストです。 2 行にわたっています。 - + 1 行の注記です。 - + 帽子をかぶることを忘れないでください! diff --git a/docs/angular/src/content/jp/components/tabbar.mdx b/docs/angular/src/content/jp/components/tabbar.mdx index 27255ff7eb..c5f2cf1af9 100644 --- a/docs/angular/src/content/jp/components/tabbar.mdx +++ b/docs/angular/src/content/jp/components/tabbar.mdx @@ -18,7 +18,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; `igx-tab-bar` セレクターは非推奨です。代わりに を使用してください。`IgxTabBarComponent` クラスは に名前変更しました。`IgxTabBarModule` は `IgxBottomNavModule` に名前変更しました。 - + `igx-tab-bar` selector is deprecated. You could use instead. `IgxTabBarComponent` class is renamed to . `IgxTabBarModule` is renamed to `IgxBottomNavModule`. diff --git a/docs/angular/src/content/jp/components/texthighlight.mdx b/docs/angular/src/content/jp/components/texthighlight.mdx index 842a08778a..a4ed227034 100644 --- a/docs/angular/src/content/jp/components/texthighlight.mdx +++ b/docs/angular/src/content/jp/components/texthighlight.mdx @@ -144,7 +144,7 @@ Ignite UI for Angular Text Highlight モジュールまたはディレクティ ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/time-picker.mdx b/docs/angular/src/content/jp/components/time-picker.mdx index e59b0792dc..79eeb16c79 100644 --- a/docs/angular/src/content/jp/components/time-picker.mdx +++ b/docs/angular/src/content/jp/components/time-picker.mdx @@ -160,7 +160,7 @@ Time Picker コンポーネントを使用すると、子コンポーネント ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` @@ -356,7 +356,7 @@ public onValidationFailed() { ドロップダウンには、項目のデルタに基づいて、最小/最大範囲 (09:15:30 AM~06:15:30 PM) 内の値が表示されます。無効な時間が入力されたときにメッセージを表示するためにトーストが追加されます。 - + ドロップダウン/ダイアログの各時間部分に表示される値は、常にゼロから始まる項目のデルタに基づいて計算されます。 が項目のデルタと一致しない場合、表示される値は、しきい値に一致する次の/最後の可能な値から開始/終了します。 diff --git a/docs/angular/src/content/jp/components/tooltip.mdx b/docs/angular/src/content/jp/components/tooltip.mdx index 85290111ba..7e4902b194 100644 --- a/docs/angular/src/content/jp/components/tooltip.mdx +++ b/docs/angular/src/content/jp/components/tooltip.mdx @@ -231,7 +231,7 @@ export class AppModule {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/transaction-how-to-use.mdx b/docs/angular/src/content/jp/components/transaction-how-to-use.mdx index a098a74f51..6853a640db 100644 --- a/docs/angular/src/content/jp/components/transaction-how-to-use.mdx +++ b/docs/angular/src/content/jp/components/transaction-how-to-use.mdx @@ -86,7 +86,7 @@ html テンプレートで コンポー ``` - + この例ではデフォルトのマテリアル アイコン ファミリーで `igx-icon` を使用します。次のリンクを `index.html` に追加してください: `` diff --git a/docs/angular/src/content/jp/components/tree.mdx b/docs/angular/src/content/jp/components/tree.mdx index 51d7f7059f..36656fe4d8 100644 --- a/docs/angular/src/content/jp/components/tree.mdx +++ b/docs/angular/src/content/jp/components/tree.mdx @@ -92,7 +92,7 @@ export class HomeComponent {} ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/treegrid/load-on-demand.mdx b/docs/angular/src/content/jp/components/treegrid/load-on-demand.mdx index e6257cecbc..06fd4fc410 100644 --- a/docs/angular/src/content/jp/components/treegrid/load-on-demand.mdx +++ b/docs/angular/src/content/jp/components/treegrid/load-on-demand.mdx @@ -71,7 +71,7 @@ public loadChildren = (parentID: any, done: (children: any[]) => void) => { ``` - + このコンポーネントはマテリアル アイコンを使用します。`index.html` に次のリンクを追加してください: `` diff --git a/docs/angular/src/content/jp/components/treegrid/tree-grid.mdx b/docs/angular/src/content/jp/components/treegrid/tree-grid.mdx index b563dc4bf1..584204cf10 100644 --- a/docs/angular/src/content/jp/components/treegrid/tree-grid.mdx +++ b/docs/angular/src/content/jp/components/treegrid/tree-grid.mdx @@ -301,7 +301,7 @@ Tree Grid は、[`Ignite UI for Angular テーマ ライブラリ`](/themes/sass 次に、 を拡張し、必要に応じてツリー グリッドをカスタマイズするために必要なパラメーターを受け取る新しいテーマを作成します。 - + `sass` 階層グリッド固有の機能はありません。 @@ -320,8 +320,8 @@ $custom-theme: grid-theme( ); ``` - -上記のようにカラーの値をハードコーディングする代わりに、 および 関数を使用してカラーに関してより高い柔軟性を実現することができます。使い方の詳細については[`パレット`](/themes/sass/palettes)のトピックをご覧ください。 + +上記のようにカラーの値をハードコーディングする代わりに、[`palette`]({environment:sassApiUrl}/palettes#function-palette) および [`color`]({environment:sassApiUrl}/palettes#function-color) 関数を使用してカラーに関してより高い柔軟性を実現することができます。使い方の詳細については[`パレット`](/themes/sass/palettes)のトピックをご覧ください。 最後にコンポーネントのテーマを**含めます**。 diff --git a/docs/angular/src/content/jp/components/zoomslider-overview.mdx b/docs/angular/src/content/jp/components/zoomslider-overview.mdx index f1b71f1bed..aa5fe3d6a2 100644 --- a/docs/angular/src/content/jp/components/zoomslider-overview.mdx +++ b/docs/angular/src/content/jp/components/zoomslider-overview.mdx @@ -17,7 +17,7 @@ Angular ZoomSlider コントロールは、範囲対応コントロールにズ ## Angular ズーム スライダーの例 -以下のサンプルは、`ZoomSlider` を使用して `DataChart` のコンテンツをナビゲートする方法を示しています。 +以下のサンプルは、 を使用して のコンテンツをナビゲートする方法を示しています。 @@ -55,7 +55,7 @@ npm install --save igniteui-angular-charts ## モジュールの要件 -`ZoomSlider` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 diff --git a/docs/angular/src/content/jp/grids_templates/column-types.mdx b/docs/angular/src/content/jp/grids_templates/column-types.mdx index e3a56f9e04..1e5e32694a 100644 --- a/docs/angular/src/content/jp/grids_templates/column-types.mdx +++ b/docs/angular/src/content/jp/grids_templates/column-types.mdx @@ -74,7 +74,7 @@ public formatOptions = this.options; - **format** - 日付の書式設定のデフォルト値は 'mediumDate' です。その他の利用可能なオプションは 'short'、'long'、'shortDate'、'fullDate'、'longTime'、'fullTime' などです。以下は利用可能なすべての[定義済みの書式オプション](https://angular.io/api/common/DatePipe#pre-defined-format-options) (レガシー) の完全なリストです。 - **timezone** - ユーザーのローカル システム タイムゾーンがデフォルト値です。タイムゾーン オフセットまたは標準の UTC/GMT または米国本土のタイムゾーンの略語も渡すことができます。世界の任意の場所の対応する時間を表示するさまざまなタイムゾーンの例: - + 20.2.x 以降、Angular のローカリゼーションを無効にしている場合、利用可能な形式オプションの一覧は新しい[ローカライズ トピック](../general/localization.md#書式設定)を参照してください。 diff --git a/docs/angular/src/content/jp/grids_templates/keyboard-navigation.mdx b/docs/angular/src/content/jp/grids_templates/keyboard-navigation.mdx index f74ad66297..97030f8651 100644 --- a/docs/angular/src/content/jp/grids_templates/keyboard-navigation.mdx +++ b/docs/angular/src/content/jp/grids_templates/keyboard-navigation.mdx @@ -280,7 +280,7 @@ public customKeydown(args: IGridKeydownEventArgs) { (obj) => { obj.target.nativeElement.focus(); }); ``` - + 実装の詳細は、サンプルコードを参照してください。 @@ -308,7 +308,7 @@ public customKeydown(args: IGridKeydownEventArgs) { (obj) => { obj.target.nativeElement.focus(); }); ``` - + 実装の詳細は、サンプルコードを参照してください。 diff --git a/docs/angular/src/content/jp/grids_templates/row-selection.mdx b/docs/angular/src/content/jp/grids_templates/row-selection.mdx index 033171d60f..e5ecc23a3b 100644 --- a/docs/angular/src/content/jp/grids_templates/row-selection.mdx +++ b/docs/angular/src/content/jp/grids_templates/row-selection.mdx @@ -305,7 +305,7 @@ public handleRowSelectionChange(args) { ### 全行の選択 が提供するもう 1 つの便利な API メソッドが `selectAll(onlyFilteredData)` です。このメソッドはデフォルトですべてのデータ行を選択しますが、フィルタリングが適用される場合、フィルター条件に一致する行のみが選択されます。ただし、false パラメーターを指定してメソッドを呼び出すと、`selectAll(false)` は、フィルターが適用されているかどうかに関係なく、常にグリッド内のすべてのデータを選択します。 - + `selectAll()` は削除された行を選択しないことに注意してください。 diff --git a/docs/angular/src/content/jp/grids_templates/toolbar.mdx b/docs/angular/src/content/jp/grids_templates/toolbar.mdx index d26ce7b8ef..24d48bc349 100644 --- a/docs/angular/src/content/jp/grids_templates/toolbar.mdx +++ b/docs/angular/src/content/jp/grids_templates/toolbar.mdx @@ -108,7 +108,7 @@ Ignite UI for Angular の {ComponentTitle} は、UI 操作のコンテナーと - + 上記のコード スニペットに示されているように、事前定義された `actions` UI コンポーネントは にラップされています。このように、ツールバーのタイトルはツールバーの左側に配置され、アクションはツールバーの右側に配置されます。 diff --git a/docs/angular/src/content/jp/grids_templates/validation.mdx b/docs/angular/src/content/jp/grids_templates/validation.mdx index ab24e413f9..0981fbfbc0 100644 --- a/docs/angular/src/content/jp/grids_templates/validation.mdx +++ b/docs/angular/src/content/jp/grids_templates/validation.mdx @@ -139,7 +139,7 @@ Invalid states will persist until the validation errors in them are fixed accord - などの API を使用してセル/行を更新する場合 。 - トランザクション サービスの一括編集および / API を使用する場合。 - + ユーザー入力または編集 API で編集されていないレコードに対しては、検証はトリガーされません。セルの視覚的なインジケーターは、ユーザー操作または検証サービスの `markAsTouched` API を介して入力がタッチ済みと見なされる場合のみ表示されます。 diff --git a/docs/xplat/build.log b/docs/xplat/build.log new file mode 100644 index 0000000000..531354d9bd --- /dev/null +++ b/docs/xplat/build.log @@ -0,0 +1,533 @@ + +> xplat-docs@0.0.1 build-staging:react +> cross-env PLATFORM=React DOCS_ENV=staging NODE_ENV=production NODE_OPTIONS=--max-old-space-size=4096 npm run build:react + + +> xplat-docs@0.0.1 build:react +> npm run generate:react && cross-env PLATFORM=React NODE_OPTIONS=--max-old-space-size=4096 astro build --outDir=../../dist/react + + +> xplat-docs@0.0.1 generate:react +> node scripts/generate.mjs --platform=React + +[generate] Excluded pages for React: 73 +[generate] Platform : React +[generate] Language : en +[generate] Source : C:\Repos\docs\docs-template\docs\xplat\src\content\en\components +[generate] Output : C:\Repos\docs\docs-template\docs\xplat\generated\React\en\components +[generate] Cleaned output: C:\Repos\docs\docs-template\docs\xplat\generated\React\en +[generate] Skipping excluded: blazor-excel-library-temporarily-stop-automatic-calculation-of-formulas-to-speed-up-processing +[generate] Skipping excluded: blazor-webassembly-how-to-read-and-write-excel-files-to-reduce-server-load +[generate] Skipping excluded: charts/types/gantt-chart +[generate] Skipping excluded: charts/types/network-chart +[generate] Skipping excluded: charts/types/pyramid-chart +[generate] Skipping excluded: customize-marker-display-in-blazor-charts +[generate] Skipping excluded: general-changelog-dv-blazor +[generate] Skipping excluded: general-changelog-dv-wc +[generate] Skipping excluded: general-changelog-dv +[generate] Skipping excluded: general-getting-started-blazor-client +[generate] Skipping excluded: general-getting-started-blazor-maui +[generate] Skipping excluded: general-getting-started-blazor-web-app +[generate] Skipping excluded: general-getting-started-oss +[generate] Skipping excluded: general-installing-blazor +[generate] Skipping excluded: general-nuget-feed +[generate] Skipping excluded: grids/grids +[generate] Skipping excluded: grids/pivot-grid/remote-operations +[generate] Skipping excluded: grids/theming +[generate] Skipping excluded: grids/tree-grid/load-on-demand +[generate] Skipping excluded: inputs/file-input +[generate] Skipping excluded: layouts/dock-manager-customization +[generate] Skipping excluded: layouts/dock-manager-electron +[generate] Skipping excluded: themes/configuration +[generate] Skipping excluded: themes/elevations +[generate] Skipping excluded: themes/palettes +[generate] Skipping excluded: themes/styles +[generate] Skipping excluded: themes/tailwind +[generate] Skipping excluded: themes/typography +[generate] _shared/advanced-filtering.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/batch-editing.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/cascading-combos.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/cell-editing.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/cell-merging.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/cell-selection.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/clipboard-interactions.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/collapsible-column-groups.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/column-hiding.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/tree-grid/column-moving +[generate] _shared/column-moving.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/column-pinning.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/column-resizing.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/column-selection.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/column-types.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/conditional-cell-styling.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/editing.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/tree-grid/excel-style-filtering +[generate] _shared/excel-style-filtering.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/export-excel.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/filtering.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/hierarchical-grid/keyboard-navigation +[generate] Skipping excluded: grids/tree-grid/keyboard-navigation +[generate] _shared/keyboard-navigation.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/tree-grid/live-data +[generate] _shared/live-data.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/multi-column-headers.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/hierarchical-grid/multi-row-layout +[generate] Skipping excluded: grids/tree-grid/multi-row-layout +[generate] _shared/multi-row-layout.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/hierarchical-grid/paging +[generate] _shared/paging.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/tree-grid/remote-data-operations +[generate] _shared/remote-data-operations.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/row-actions.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/row-adding.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/row-drag.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/row-editing.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/row-pinning.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/row-selection.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/search.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Skipping excluded: grids/pivot-grid/selection +[generate] _shared/selection.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/size.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/sizing.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/sorting.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/state-persistence.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/summaries.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/toolbar.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/validation.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] _shared/virtualization.mdx → grid/, hierarchical-grid/, tree-grid/, pivot-grid/ +[generate] Cleared .astro cache. +[generate] Done. +[astro.config] toc.json → React/en +[astro.config] Platform: React lang: en mode: staging +[astro.config] Platform: React lang: en mode: staging site: https://staging.infragistics.com/products/ignite-ui-react/react/components +[content.config] platform=React lang=en → C:\Repos\docs\docs-template\docs\xplat\generated\React\en\components +16:01:38 [content] Syncing content +16:01:38 [content] Synced content +16:01:38 [types] Generated 1.43s +16:01:38 [build] output: "static" +16:01:38 [build] mode: "static" +16:01:38 [build] directory: C:\Repos\docs\docs-template\dist\react\ +16:01:38 [build] Collecting build info... +16:01:38 [build] ✓ Completed in 1.48s. +16:01:38 [build] Building static entrypoints... +16:02:19 [vite] ✓ built in 40.88s +16:02:22 [vite] ✓ built in 2.94s +16:02:23 [build] Rearranging server assets... + + generating static routes  +16:02:23 ├─ /sitemap.xml (+22ms) +16:02:23 ├─ /index.html (+10ms) +16:02:23 ├─ /ai/ai-assisted-development-overview.html (+2.71s) +16:02:26 ├─ /ai/cli-mcp.html (+58ms) +16:02:26 ├─ /ai/maker-framework.html (+48ms) +16:02:26 ├─ /ai/skills.html (+69ms) +16:02:26 ├─ /ai/theming-mcp.html (+66ms) +16:02:26 ├─ /bullet-graph.html (+98ms) +16:02:26 ├─ /changelog/igniteui-charts.html (+49ms) +16:02:26 ├─ /changelog/igniteui-core.html (+43ms) +16:02:27 ├─ /changelog/igniteui-dashboards.html (+51ms) +16:02:27 ├─ /changelog/igniteui-data-grids.html (+40ms) +16:02:27 ├─ /changelog/igniteui-datasources.html (+48ms) +16:02:27 ├─ /changelog/igniteui-dc3.html (+33ms) +16:02:27 ├─ /changelog/igniteui-dockmanager.html (+39ms) +16:02:27 ├─ /changelog/igniteui-excel.html (+36ms) +16:02:27 ├─ /changelog/igniteui-gauges.html (+42ms) +16:02:27 ├─ /changelog/igniteui-grids.html (+42ms) +16:02:27 ├─ /changelog/igniteui-inputs.html (+40ms) +16:02:27 ├─ /changelog/igniteui-layouts.html (+44ms) +16:02:27 ├─ /changelog/igniteui-maps.html (+39ms) +16:02:27 ├─ /changelog/igniteui-react.html (+38ms) +16:02:27 ├─ /changelog/igniteui-spreadsheet.html (+37ms) +16:02:27 ├─ /changelog/igniteui-spreadsheet-chart-adapter.html (+33ms) +16:02:27 ├─ /changelog/igniteui-webcomponents.html (+37ms) +16:02:27 ├─ /charts/chart-api.html (+51ms) +16:02:27 ├─ /charts/chart-features.html (+44ms) +16:02:27 ├─ /charts/chart-overview.html (+58ms) +16:02:27 ├─ /charts/features/chart-animations.html (+41ms) +16:02:27 ├─ /charts/features/chart-annotations.html (+42ms) +16:02:27 ├─ /charts/features/chart-axis-gridlines.html (+41ms) +16:02:27 ├─ /charts/features/chart-axis-layouts.html (+34ms) +16:02:27 ├─ /charts/features/chart-axis-options.html (+53ms) +16:02:27 ├─ /charts/features/chart-axis-types.html (+51ms) +16:02:28 ├─ /charts/features/chart-data-aggregations.html (+42ms) +16:02:28 ├─ /charts/features/chart-data-annotations.html (+32ms) +16:02:28 ├─ /charts/features/chart-data-filtering.html (+38ms) +16:02:28 ├─ /charts/features/chart-data-legend.html (+40ms) +16:02:28 ├─ /charts/features/chart-data-selection.html (+45ms) +16:02:28 ├─ /charts/features/chart-data-tooltip.html (+44ms) +16:02:28 ├─ /charts/features/chart-highlight-filter.html (+50ms) +16:02:28 ├─ /charts/features/chart-highlighting.html (+38ms) +16:02:28 ├─ /charts/features/chart-markers.html (+45ms) +16:02:28 ├─ /charts/features/chart-navigation.html (+40ms) +16:02:28 ├─ /charts/features/chart-overlays.html (+54ms) +16:02:28 ├─ /charts/features/chart-performance.html (+54ms) +16:02:28 ├─ /charts/features/chart-synchronization.html (+42ms) +16:02:28 ├─ /charts/features/chart-titles.html (+39ms) +16:02:28 ├─ /charts/features/chart-tooltips.html (+38ms) +16:02:28 ├─ /charts/features/chart-trendlines.html (+37ms) +16:02:28 ├─ /charts/features/chart-user-annotations.html (+36ms) +16:02:28 ├─ /charts/types/area-chart.html (+37ms) +16:02:28 ├─ /charts/types/bar-chart.html (+45ms) +16:02:28 ├─ /charts/types/bubble-chart.html (+33ms) +16:02:28 ├─ /charts/types/column-chart.html (+56ms) +16:02:28 ├─ /charts/types/composite-chart.html (+36ms) +16:02:28 ├─ /charts/types/data-pie-chart.html (+42ms) +16:02:28 ├─ /charts/types/donut-chart.html (+35ms) +16:02:29 ├─ /charts/types/line-chart.html (+44ms) +16:02:29 ├─ /charts/types/pie-chart.html (+38ms) +16:02:29 ├─ /charts/types/point-chart.html (+40ms) +16:02:29 ├─ /charts/types/polar-chart.html (+33ms) +16:02:29 ├─ /charts/types/radial-chart.html (+33ms) +16:02:29 ├─ /charts/types/scatter-chart.html (+41ms) +16:02:29 ├─ /charts/types/shape-chart.html (+44ms) +16:02:29 ├─ /charts/types/sparkline-chart.html (+34ms) +16:02:29 ├─ /charts/types/spline-chart.html (+33ms) +16:02:29 ├─ /charts/types/stacked-chart.html (+41ms) +16:02:29 ├─ /charts/types/step-chart.html (+36ms) +16:02:29 ├─ /charts/types/stock-chart.html (+49ms) +16:02:29 ├─ /charts/types/treemap-chart.html (+38ms) +16:02:29 ├─ /dashboard-tile.html (+43ms) +16:02:29 ├─ /excel-library.html (+39ms) +16:02:29 ├─ /excel-library-using-cells.html (+47ms) +16:02:29 ├─ /excel-library-using-tables.html (+41ms) +16:02:29 ├─ /excel-library-using-workbooks.html (+44ms) +16:02:29 ├─ /excel-library-using-worksheets.html (+60ms) +16:02:29 ├─ /excel-library-working-with-charts.html (+31ms) +16:02:29 ├─ /excel-library-working-with-grids.html (+30ms) +16:02:29 ├─ /excel-library-working-with-sparklines.html (+35ms) +16:02:29 ├─ /excel-utility.html (+46ms) +16:02:29 ├─ /general-changelog-dv-react.html (+91ms) +16:02:30 ├─ /general-cli-overview.html (+42ms) +16:02:30 ├─ /general-getting-started.html (+48ms) +16:02:30 ├─ /general-how-to-mcp-e2e.html (+44ms) +16:02:30 ├─ /general-licensing.html (+38ms) +16:02:30 ├─ /general-open-source-vs-premium.html (+39ms) +16:02:30 ├─ /general-step-by-step-guide-using-cli.html (+43ms) +16:02:30 ├─ /geo-map.html (+44ms) +16:02:30 ├─ /geo-map-binding-data-csv.html (+37ms) +16:02:30 ├─ /geo-map-binding-data-json-points.html (+45ms) +16:02:30 ├─ /geo-map-binding-data-model.html (+51ms) +16:02:30 ├─ /geo-map-binding-data-overview.html (+42ms) +16:02:30 ├─ /geo-map-binding-multiple-shapes.html (+65ms) +16:02:30 ├─ /geo-map-binding-multiple-sources.html (+38ms) +16:02:30 ├─ /geo-map-binding-shp-file.html (+31ms) +16:02:30 ├─ /geo-map-display-azure-imagery.html (+31ms) +16:02:30 ├─ /geo-map-display-bing-imagery.html (+33ms) +16:02:30 ├─ /geo-map-display-esri-imagery.html (+36ms) +16:02:30 ├─ /geo-map-display-heat-imagery.html (+38ms) +16:02:30 ├─ /geo-map-display-imagery-types.html (+31ms) +16:02:30 ├─ /geo-map-display-osm-imagery.html (+41ms) +16:02:30 ├─ /geo-map-navigation.html (+39ms) +16:02:30 ├─ /geo-map-resources-esri.html (+30ms) +16:02:30 ├─ /geo-map-resources-shape-styling-utility.html (+48ms) +16:02:30 ├─ /geo-map-resources-world-connections.html (+40ms) +16:02:31 ├─ /geo-map-resources-world-locations.html (+187ms) +16:02:31 ├─ /geo-map-resources-world-util.html (+57ms) +16:02:31 ├─ /geo-map-shape-files-reference.html (+38ms) +16:02:31 ├─ /geo-map-shape-styling.html (+57ms) +16:02:31 ├─ /geo-map-type-scatter-area-series.html (+55ms) +16:02:31 ├─ /geo-map-type-scatter-bubble-series.html (+43ms) +16:02:31 ├─ /geo-map-type-scatter-contour-series.html (+47ms) +16:02:31 ├─ /geo-map-type-scatter-density-series.html (+47ms) +16:02:31 ├─ /geo-map-type-scatter-symbol-series.html (+48ms) +16:02:31 ├─ /geo-map-type-series.html (+36ms) +16:02:31 ├─ /geo-map-type-shape-polygon-series.html (+46ms) +16:02:31 ├─ /geo-map-type-shape-polyline-series.html (+52ms) +16:02:31 ├─ /grid-lite/binding.html (+36ms) +16:02:31 ├─ /grid-lite/cell-template.html (+35ms) +16:02:31 ├─ /grid-lite/column-configuration.html (+49ms) +16:02:31 ├─ /grid-lite/filtering.html (+48ms) +16:02:31 ├─ /grid-lite/header-template.html (+32ms) +16:02:31 ├─ /grid-lite/overview.html (+37ms) +16:02:31 ├─ /grid-lite/sorting.html (+45ms) +16:02:32 ├─ /grid-lite/theming.html (+42ms) +16:02:32 ├─ /grids/data-grid.html (+79ms) +16:02:32 ├─ /grids/grid/advanced-filtering.html (+42ms) +16:02:32 ├─ /grids/grid/batch-editing.html (+45ms) +16:02:32 ├─ /grids/grid/cascading-combos.html (+43ms) +16:02:32 ├─ /grids/grid/cell-editing.html (+45ms) +16:02:32 ├─ /grids/grid/cell-merging.html (+41ms) +16:02:32 ├─ /grids/grid/cell-selection.html (+45ms) +16:02:32 ├─ /grids/grid/clipboard-interactions.html (+38ms) +16:02:32 ├─ /grids/grid/collapsible-column-groups.html (+42ms) +16:02:32 ├─ /grids/grid/column-hiding.html (+52ms) +16:02:32 ├─ /grids/grid/column-moving.html (+51ms) +16:02:32 ├─ /grids/grid/column-pinning.html (+47ms) +16:02:32 ├─ /grids/grid/column-resizing.html (+49ms) +16:02:32 ├─ /grids/grid/column-selection.html (+41ms) +16:02:32 ├─ /grids/grid/column-types.html (+46ms) +16:02:32 ├─ /grids/grid/conditional-cell-styling.html (+47ms) +16:02:32 ├─ /grids/grid/editing.html (+44ms) +16:02:32 ├─ /grids/grid/excel-style-filtering.html (+38ms) +16:02:32 ├─ /grids/grid/export-excel.html (+37ms) +16:02:32 ├─ /grids/grid/filtering.html (+46ms) +16:02:32 ├─ /grids/grid/groupby.html (+48ms) +16:02:33 ├─ /grids/grid/icons.html (+37ms) +16:02:33 ├─ /grids/grid/keyboard-navigation.html (+39ms) +16:02:33 ├─ /grids/grid/live-data.html (+37ms) +16:02:33 ├─ /grids/grid/master-detail.html (+37ms) +16:02:33 ├─ /grids/grid/multi-column-headers.html (+45ms) +16:02:33 ├─ /grids/grid/multi-row-layout.html (+59ms) +16:02:33 ├─ /grids/grid/paging.html (+42ms) +16:02:33 ├─ /grids/grid/paste-excel.html (+55ms) +16:02:33 ├─ /grids/grid/remote-data-operations.html (+185ms) +16:02:33 ├─ /grids/grid/row-actions.html (+29ms) +16:02:33 ├─ /grids/grid/row-adding.html (+30ms) +16:02:33 ├─ /grids/grid/row-drag.html (+30ms) +16:02:33 ├─ /grids/grid/row-editing.html (+31ms) +16:02:33 ├─ /grids/grid/row-pinning.html (+35ms) +16:02:33 ├─ /grids/grid/row-selection.html (+36ms) +16:02:33 ├─ /grids/grid/search.html (+45ms) +16:02:33 ├─ /grids/grid/selection.html (+37ms) +16:02:33 ├─ /grids/grid/selection-based-aggregates.html (+42ms) +16:02:33 ├─ /grids/grid/size.html (+42ms) +16:02:33 ├─ /grids/grid/sizing.html (+56ms) +16:02:33 ├─ /grids/grid/sorting.html (+47ms) +16:02:34 ├─ /grids/grid/state-persistence.html (+43ms) +16:02:34 ├─ /grids/grid/summaries.html (+98ms) +16:02:34 ├─ /grids/grid/theming-grid.html (+133ms) +16:02:34 ├─ /grids/grid/toolbar.html (+59ms) +16:02:34 ├─ /grids/grid/validation.html (+51ms) +16:02:34 ├─ /grids/grid/virtualization.html (+38ms) +16:02:34 ├─ /grids/grids-header.html (+51ms) +16:02:34 ├─ /grids/hierarchical-grid/advanced-filtering.html (+42ms) +16:02:34 ├─ /grids/hierarchical-grid/batch-editing.html (+27ms) +16:02:34 ├─ /grids/hierarchical-grid/cell-editing.html (+42ms) +16:02:34 ├─ /grids/hierarchical-grid/cell-merging.html (+40ms) +16:02:34 ├─ /grids/hierarchical-grid/cell-selection.html (+48ms) +16:02:34 ├─ /grids/hierarchical-grid/clipboard-interactions.html (+37ms) +16:02:34 ├─ /grids/hierarchical-grid/collapsible-column-groups.html (+69ms) +16:02:34 ├─ /grids/hierarchical-grid/column-hiding.html (+67ms) +16:02:34 ├─ /grids/hierarchical-grid/column-moving.html (+75ms) +16:02:34 ├─ /grids/hierarchical-grid/column-pinning.html (+72ms) +16:02:35 ├─ /grids/hierarchical-grid/column-resizing.html (+53ms) +16:02:35 ├─ /grids/hierarchical-grid/column-selection.html (+47ms) +16:02:35 ├─ /grids/hierarchical-grid/column-types.html (+40ms) +16:02:35 ├─ /grids/hierarchical-grid/conditional-cell-styling.html (+41ms) +16:02:35 ├─ /grids/hierarchical-grid/editing.html (+38ms) +16:02:35 ├─ /grids/hierarchical-grid/excel-style-filtering.html (+46ms) +16:02:35 ├─ /grids/hierarchical-grid/export-excel.html (+42ms) +16:02:35 ├─ /grids/hierarchical-grid/filtering.html (+38ms) +16:02:35 ├─ /grids/hierarchical-grid/load-on-demand.html (+48ms) +16:02:35 ├─ /grids/hierarchical-grid/multi-column-headers.html (+46ms) +16:02:35 ├─ /grids/hierarchical-grid/overview.html (+48ms) +16:02:35 ├─ /grids/hierarchical-grid/remote-data-operations.html (+41ms) +16:02:35 ├─ /grids/hierarchical-grid/row-actions.html (+33ms) +16:02:35 ├─ /grids/hierarchical-grid/row-adding.html (+53ms) +16:02:35 ├─ /grids/hierarchical-grid/row-drag.html (+30ms) +16:02:35 ├─ /grids/hierarchical-grid/row-editing.html (+43ms) +16:02:35 ├─ /grids/hierarchical-grid/row-pinning.html (+30ms) +16:02:35 ├─ /grids/hierarchical-grid/row-selection.html (+48ms) +16:02:35 ├─ /grids/hierarchical-grid/selection.html (+35ms) +16:02:35 ├─ /grids/hierarchical-grid/size.html (+43ms) +16:02:35 ├─ /grids/hierarchical-grid/sizing.html (+35ms) +16:02:35 ├─ /grids/hierarchical-grid/sorting.html (+40ms) +16:02:35 ├─ /grids/hierarchical-grid/state-persistence.html (+37ms) +16:02:35 ├─ /grids/hierarchical-grid/summaries.html (+51ms) +16:02:36 ├─ /grids/hierarchical-grid/theming-grid.html (+41ms) +16:02:36 ├─ /grids/hierarchical-grid/toolbar.html (+48ms) +16:02:36 ├─ /grids/hierarchical-grid/validation.html (+29ms) +16:02:36 ├─ /grids/hierarchical-grid/virtualization.html (+33ms) +16:02:36 ├─ /grids/list.html (+40ms) +16:02:36 ├─ /grids/pivot-grid/clipboard-interactions.html (+38ms) +16:02:36 ├─ /grids/pivot-grid/excel-style-filtering.html (+30ms) +16:02:36 ├─ /grids/pivot-grid/features.html (+48ms) +16:02:36 ├─ /grids/pivot-grid/overview.html (+45ms) +16:02:36 ├─ /grids/pivot-grid/row-editing.html (+31ms) +16:02:36 ├─ /grids/pivot-grid/row-selection.html (+47ms) +16:02:36 ├─ /grids/pivot-grid/state-persistence.html (+34ms) +16:02:36 ├─ /grids/pivot-grid/validation.html (+28ms) +16:02:36 ├─ /grids/tree.html (+40ms) +16:02:36 ├─ /grids/tree-grid/advanced-filtering.html (+28ms) +16:02:36 ├─ /grids/tree-grid/batch-editing.html (+28ms) +16:02:36 ├─ /grids/tree-grid/cell-editing.html (+30ms) +16:02:36 ├─ /grids/tree-grid/cell-merging.html (+32ms) +16:02:36 ├─ /grids/tree-grid/cell-selection.html (+35ms) +16:02:36 ├─ /grids/tree-grid/clipboard-interactions.html (+24ms) +16:02:36 ├─ /grids/tree-grid/collapsible-column-groups.html (+33ms) +16:02:36 ├─ /grids/tree-grid/column-hiding.html (+32ms) +16:02:36 ├─ /grids/tree-grid/column-pinning.html (+31ms) +16:02:36 ├─ /grids/tree-grid/column-resizing.html (+28ms) +16:02:36 ├─ /grids/tree-grid/column-selection.html (+25ms) +16:02:36 ├─ /grids/tree-grid/column-types.html (+35ms) +16:02:36 ├─ /grids/tree-grid/conditional-cell-styling.html (+30ms) +16:02:36 ├─ /grids/tree-grid/editing.html (+28ms) +16:02:36 ├─ /grids/tree-grid/export-excel.html (+23ms) +16:02:37 ├─ /grids/tree-grid/filtering.html (+34ms) +16:02:37 ├─ /grids/tree-grid/multi-column-headers.html (+41ms) +16:02:37 ├─ /grids/tree-grid/overview.html (+25ms) +16:02:37 ├─ /grids/tree-grid/paging.html (+27ms) +16:02:37 ├─ /grids/tree-grid/row-actions.html (+27ms) +16:02:37 ├─ /grids/tree-grid/row-adding.html (+26ms) +16:02:37 ├─ /grids/tree-grid/row-drag.html (+26ms) +16:02:37 ├─ /grids/tree-grid/row-editing.html (+29ms) +16:02:37 ├─ /grids/tree-grid/row-pinning.html (+32ms) +16:02:37 ├─ /grids/tree-grid/row-selection.html (+32ms) +16:02:37 ├─ /grids/tree-grid/search.html (+43ms) +16:02:37 ├─ /grids/tree-grid/selection.html (+24ms) +16:02:37 ├─ /grids/tree-grid/size.html (+34ms) +16:02:37 ├─ /grids/tree-grid/sizing.html (+33ms) +16:02:37 ├─ /grids/tree-grid/sorting.html (+28ms) +16:02:37 ├─ /grids/tree-grid/state-persistence.html (+31ms) +16:02:37 ├─ /grids/tree-grid/summaries.html (+34ms) +16:02:37 ├─ /grids/tree-grid/theming-grid.html (+25ms) +16:02:37 ├─ /grids/tree-grid/toolbar.html (+34ms) +16:02:37 ├─ /grids/tree-grid/validation.html (+26ms) +16:02:37 ├─ /grids/tree-grid/virtualization.html (+27ms) +16:02:37 ├─ /inputs/badge.html (+23ms) +16:02:37 ├─ /inputs/button.html (+38ms) +16:02:37 ├─ /inputs/button-group.html (+92ms) +16:02:37 ├─ /inputs/checkbox.html (+67ms) +16:02:37 ├─ /inputs/chip.html (+39ms) +16:02:37 ├─ /inputs/circular-progress.html (+32ms) +16:02:37 ├─ /inputs/color-editor.html (+36ms) +16:02:37 ├─ /inputs/combo/features.html (+48ms) +16:02:38 ├─ /inputs/combo/overview.html (+50ms) +16:02:38 ├─ /inputs/combo/single-selection.html (+41ms) +16:02:38 ├─ /inputs/combo/templates.html (+39ms) +16:02:38 ├─ /inputs/date-time-input.html (+57ms) +16:02:38 ├─ /inputs/dropdown.html (+42ms) +16:02:38 ├─ /inputs/icon-button.html (+50ms) +16:02:38 ├─ /inputs/input.html (+45ms) +16:02:38 ├─ /inputs/linear-progress.html (+38ms) +16:02:38 ├─ /inputs/mask-input.html (+40ms) +16:02:38 ├─ /inputs/query-builder.html (+69ms) +16:02:38 ├─ /inputs/radio.html (+53ms) +16:02:38 ├─ /inputs/rating.html (+56ms) +16:02:38 ├─ /inputs/ripple.html (+37ms) +16:02:38 ├─ /inputs/select.html (+47ms) +16:02:38 ├─ /inputs/slider.html (+45ms) +16:02:38 ├─ /inputs/switch.html (+42ms) +16:02:38 ├─ /inputs/text-area.html (+40ms) +16:02:38 ├─ /inputs/tooltip.html (+46ms) +16:02:38 ├─ /interactivity/accessibility-compliance.html (+72ms) +16:02:38 ├─ /interactivity/chat.html (+57ms) +16:02:38 ├─ /layouts/accordion.html (+57ms) +16:02:39 ├─ /layouts/avatar.html (+39ms) +16:02:39 ├─ /layouts/card.html (+52ms) +16:02:39 ├─ /layouts/carousel.html (+68ms) +16:02:39 ├─ /layouts/divider.html (+33ms) +16:02:39 ├─ /layouts/dock-manager.html (+73ms) +16:02:39 ├─ /layouts/dock-manager-embedding-frames.html (+38ms) +16:02:39 ├─ /layouts/dock-manager-updating-panes.html (+39ms) +16:02:39 ├─ /layouts/expansion-panel.html (+45ms) +16:02:39 ├─ /layouts/icon.html (+46ms) +16:02:39 ├─ /layouts/splitter.html (+50ms) +16:02:39 ├─ /layouts/stepper.html (+56ms) +16:02:39 ├─ /layouts/tabs.html (+47ms) +16:02:39 ├─ /layouts/tile-manager.html (+89ms) +16:02:39 ├─ /linear-gauge.html (+73ms) +16:02:39 ├─ /localization.html (+53ms) +16:02:39 ├─ /maps/map-api.html (+41ms) +16:02:39 ├─ /menus/navbar.html (+43ms) +16:02:39 ├─ /menus/navigation-drawer.html (+50ms) +16:02:39 ├─ /menus/toolbar.html (+38ms) +16:02:40 ├─ /nextjs-usage.html (+44ms) +16:02:40 ├─ /notifications/banner.html (+41ms) +16:02:40 ├─ /notifications/dialog.html (+44ms) +16:02:40 ├─ /notifications/snackbar.html (+45ms) +16:02:40 ├─ /notifications/toast.html (+39ms) +16:02:40 ├─ /radial-gauge.html (+66ms) +16:02:40 ├─ /scheduling/calendar.html (+53ms) +16:02:40 ├─ /scheduling/date-picker.html (+45ms) +16:02:40 ├─ /scheduling/date-range-picker.html (+52ms) +16:02:40 ├─ /spreadsheet-activation.html (+31ms) +16:02:40 ├─ /spreadsheet-chart-adapter.html (+35ms) +16:02:40 ├─ /spreadsheet-clipboard.html (+33ms) +16:02:40 ├─ /spreadsheet-commands.html (+26ms) +16:02:40 ├─ /spreadsheet-conditional-formatting.html (+37ms) +16:02:40 ├─ /spreadsheet-configuring.html (+29ms) +16:02:40 ├─ /spreadsheet-data-validation.html (+31ms) +16:02:40 ├─ /spreadsheet-hyperlinks.html (+22ms) +16:02:40 ├─ /spreadsheet-overview.html (+28ms) +16:02:40 ├─ /themes/overview.html (+27ms) +16:02:40 ├─ /update-guide.html (+23ms) +16:02:40 ├─ /zoomslider-overview.html (+25ms) +16:02:40 ✓ Completed in 17.05s. + + generating optimized images  +16:02:40 ▶ /_astro/ignite-ui-angular-financial-chart-smart-data-binding-1100.C34W4_nk_Z2givIA.webp (reused cache entry) (+3ms) (1/77) +16:02:40 ▶ /_astro/ignite-ui-angular-financial-chart-trendlines-1100.7HUxt5eD_VgDVz.webp (reused cache entry) (+3ms) (2/77) +16:02:40 ▶ /_astro/ignite-ui-angular-financial-chart-modular-design-1100.BczRufvv_M833N.webp (reused cache entry) (+4ms) (3/77) +16:02:40 ▶ /_astro/ignite-ui-angular-financial-chart-zooming-1100.DgPFrbsd_ZPeCW2.webp (reused cache entry) (+4ms) (4/77) +16:02:40 ▶ /_astro/ignite-ui-angular-financial-chart-custom-tooltips-1100.BpFWR0Jn_ZtdL2E.webp (reused cache entry) (+5ms) (5/77) +16:02:40 ▶ /_astro/layout_mode.C1pvfy4V_Z1Sq8oP.webp (reused cache entry) (+5ms) (6/77) +16:02:40 ▶ /_astro/data-chart-user-annotation-delete.BDtvLOw6_1RjFRB.webp (reused cache entry) (+5ms) (7/77) +16:02:40 ▶ /_astro/data-chart-user-annotation-create.DfG99k4a_2jfPU1.webp (reused cache entry) (+5ms) (8/77) +16:02:40 ▶ /_astro/dashboard-tile-toolbar.DVqG7NWu_Z2naQxj.webp (reused cache entry) (+6ms) (9/77) +16:02:40 ▶ /_astro/chartDefaults1.kZ50GFkA_1L7mBR.webp (reused cache entry) (+6ms) (10/77) +16:02:40 ▶ /_astro/chartDefaults2.DvaiasdX_1dtttI.webp (reused cache entry) (+7ms) (11/77) +16:02:40 ▶ /_astro/chartDefaults3.Co9cSZuz_Z1c0J0w.webp (reused cache entry) (+7ms) (12/77) +16:02:40 ▶ /_astro/chartDefaults4.PIZOV6pt_2bjMSz.webp (reused cache entry) (+4ms) (13/77) +16:02:40 ▶ /_astro/vs-code.D21C6_1__Z2wqAqN.svg (reused cache entry) (+4ms) (14/77) +16:02:40 ▶ /_astro/ig-vite-grid.u_6si0ns_1xzpjB.webp (reused cache entry) (+4ms) (15/77) +16:02:40 ▶ /_astro/nodejs.nJJw1uxH_Z1VHqi7.svg (reused cache entry) (+5ms) (16/77) +16:02:40 ▶ /_astro/azure-ci-add-token-variable-1.BG7yDgVm_ZELzHK.webp (reused cache entry) (+4ms) (17/77) +16:02:40 ▶ /_astro/ig-cli-grid.Clz-HEhc_1zKur.webp (reused cache entry) (+5ms) (18/77) +16:02:40 ▶ /_astro/generate-token.D8qg8lHK_BKHa3.webp (reused cache entry) (+5ms) (19/77) +16:02:40 ▶ /_astro/azure-ci-new-variable-2.-3_1M6Er_cmOue.webp (reused cache entry) (+5ms) (20/77) +16:02:40 ▶ /_astro/Azure_Traffic_Tile_Series_With_Background.CgAiavem_ZaeLCp.webp (reused cache entry) (+5ms) (21/77) +16:02:40 ▶ /_astro/AzureMapsImagery.DSwntf3m_a64Fy.webp (reused cache entry) (+6ms) (22/77) +16:02:40 ▶ /_astro/BingMapsImagery.BMALrZng_ZoSb7f.webp (reused cache entry) (+6ms) (23/77) +16:02:40 ▶ /_astro/landing-grid-page.dXi1dknm_Z1CMDu5.webp (reused cache entry) (+6ms) (24/77) +16:02:40 ▶ /_astro/expand_indicator.BRyW0VxR_Z15JUuk.webp (reused cache entry) (+5ms) (25/77) +16:02:40 ▶ /_astro/collapsed_indicator.CsdFYQKS_2qQc8M.webp (reused cache entry) (+5ms) (26/77) +16:02:40 ▶ /_astro/multi-row-layout-1.TMwEylib_Z24PpDI.webp (reused cache entry) (+5ms) (27/77) +16:02:40 ▶ /_astro/columns-default-gridWidth-null-v2.DPuDttCv_Z26bLI6.webp (reused cache entry) (+5ms) (28/77) +16:02:40 ▶ /_astro/width-null-no-scroll-v2.CEIVaE2Z_Z2hTJm4.webp (reused cache entry) (+4ms) (29/77) +16:02:40 ▶ /_astro/width-null-scroll-v2.8FdFQ2MH_ZS0Uzf.webp (reused cache entry) (+4ms) (30/77) +16:02:40 ▶ /_astro/width-cols-scrollbar-v2.Cqw6hf38_Z1KBtSY.webp (reused cache entry) (+5ms) (31/77) +16:02:40 ▶ /_astro/width-null-parent-scroll-v2.Bc2VppIq_1Fk2tJ.webp (reused cache entry) (+5ms) (32/77) +16:02:40 ▶ /_astro/width-cols-scroll-parent-noscroll-v2.BhSwYnX6_1OWI2Y.webp (reused cache entry) (+5ms) (33/77) +16:02:40 ▶ /_astro/width-cols-scroll-parent-scroll-v2.DWuMr2J7_1vTq3p.webp (reused cache entry) (+5ms) (34/77) +16:02:40 ▶ /_astro/width-percent-100p-v2.laKQzQST_vyiA0.webp (reused cache entry) (+5ms) (35/77) +16:02:40 ▶ /_astro/width-percent-parent-100p-v2.eelP72O1_Z5oA6N.webp (reused cache entry) (+6ms) (36/77) +16:02:40 ▶ /_astro/width-percent-150p-parent-scroll-v2.hzvoWed7_ZhzxgF.webp (reused cache entry) (+5ms) (37/77) +16:02:40 ▶ /_astro/height-null-14rows-v2.CBOHLegX_Z1RhDg.webp (reused cache entry) (+5ms) (38/77) +16:02:40 ▶ /_astro/width-percent-150p-parent-noscroll-v2.plSZoIv7_Z1WGYvd.webp (reused cache entry) (+5ms) (39/77) +16:02:40 ▶ /_astro/height-null-24rows-v2.DTK3qFDM_1g7S3y.webp (reused cache entry) (+5ms) (40/77) +16:02:40 ▶ /_astro/height-null-24rows-parent-noscroll-v2.CjfBo0KF_Z1FKt9U.webp (reused cache entry) (+5ms) (41/77) +16:02:40 ▶ /_astro/height-null-24rows-parent-scroll-v2.BGj42l8H_Z1NiCt0.webp (reused cache entry) (+5ms) (42/77) +16:02:40 ▶ /_astro/height-500px-4rows-v2.BML-9vFr_Z253hVM.webp (reused cache entry) (+6ms) (43/77) +16:02:40 ▶ /_astro/height-500px-14rows-v2.DPlC-1qf_Z1ArL3k.webp (reused cache entry) (+6ms) (44/77) +16:02:40 ▶ /_astro/height-700px-14rows-parent-noscroll-v2.cSKBwkSK_1SHRhp.webp (reused cache entry) (+6ms) (45/77) +16:02:40 ▶ /_astro/height-700px-14rows-parent-scroll-v2.E--kb-Zw_Z1T6inK.webp (reused cache entry) (+7ms) (46/77) +16:02:40 ▶ /_astro/height-undefined-7rows-v2.SxXd5y2__iHLQJ.webp (reused cache entry) (+8ms) (47/77) +16:02:40 ▶ /_astro/height-undefined-14rows-v2.DUiI_xI2_Z1Limtp.webp (reused cache entry) (+6ms) (48/77) +16:02:40 ▶ /_astro/height-percent-130p-parent-scroll-v2.CP7s79YA_2hCWPk.webp (reused cache entry) (+6ms) (49/77) +16:02:40 ▶ /_astro/height-percent-100-parent-800px-v2.BANXKzVQ_24qIsO.webp (reused cache entry) (+6ms) (50/77) +16:02:40 ▶ /_astro/height-percent-130p-parent-noscroll-v2.BNSz44X4_1753TK.webp (reused cache entry) (+6ms) (51/77) +16:02:40 ▶ /_astro/height-percent-100-parent-100-v2.DqA0I7zs_InJVu.webp (reused cache entry) (+4ms) (52/77) +16:02:40 ▶ /_astro/columns-default-all-row-selectors-v2.DMN8tTRU_ZrVisR.webp (reused cache entry) (+4ms) (53/77) +16:02:40 ▶ /_astro/columns-default-all-min-136px-v2.BS8E8ZX8_171vJi.webp (reused cache entry) (+5ms) (54/77) +16:02:40 ▶ /_astro/columns-default-first-rest-100px-v2.DoB1ORD-_1rIp48.webp (reused cache entry) (+5ms) (55/77) +16:02:40 ▶ /_astro/columns-default-all-first-100px-v2.BFq6q8mz_yGaH6.webp (reused cache entry) (+5ms) (56/77) +16:02:40 ▶ /_astro/columns-150px-empty-area-v2.BJhcnUYA_1c1Cyq.webp (reused cache entry) (+5ms) (57/77) +16:02:40 ▶ /_astro/columns-150px-extra-area-v2.BcO_idjo_2eN4t2.webp (reused cache entry) (+6ms) (58/77) +16:02:40 ▶ /_astro/columns-percent-less-100p-v2.M3_NJf0Q_ZRdkjE.webp (reused cache entry) (+5ms) (59/77) +16:02:40 ▶ /_astro/columns-percent-100p-v2.WkWVgm4a_Z17IQA5.webp (reused cache entry) (+5ms) (60/77) +16:02:40 ▶ /_astro/columns-percent-bigger-100p-v2.uMaClhrz_EJfIq.webp (reused cache entry) (+3ms) (61/77) +16:02:40 ▶ /_astro/columns-percent-gridWidth-null-v2.CLNx9X3g_M2r38.webp (reused cache entry) (+4ms) (62/77) +16:02:40 ▶ /_astro/hgrid-database.DnTYvCPF_aaDdD.webp (reused cache entry) (+4ms) (63/77) +16:02:40 ▶ /_astro/unfold_less_icon_screenshot.Dz5F8pgz_Z1KDuPN.webp (reused cache entry) (+4ms) (64/77) +16:02:40 ▶ /_astro/hgrid-width-percentages-v2.BmgZYX0U_Z9x4yR.webp (reused cache entry) (+4ms) (65/77) +16:02:40 ▶ /_astro/hgrid-height-percentages-v2.b-ltXv1v_1VfI47.webp (reused cache entry) (+5ms) (66/77) +16:02:40 ▶ /_astro/query-builder-drag-and-drop.C2_RNPkN_Z1CkRkT.webp (reused cache entry) (+5ms) (67/77) +16:02:40 ▶ /_astro/query-builder-keyboard-drag-and-drop.BeXDuV_x_Z2dmt6t.webp (reused cache entry) (+5ms) (68/77) +16:02:40 ▶ /_astro/dockmanager-root-docking.BR_pSl98_Z2dcsr9.webp (reused cache entry) (+5ms) (69/77) +16:02:40 ▶ /_astro/dockmanager-pane-docking.BayHthBu_Z13yBqs.webp (reused cache entry) (+6ms) (70/77) +16:02:40 ▶ /_astro/dockmanager-document-host-docking.3vVpt3zq_Z1JlsAg.webp (reused cache entry) (+5ms) (71/77) +16:02:40 ▶ /_astro/dockmanager-edge-docking.BPAqd-z2_12AQf2.webp (reused cache entry) (+5ms) (72/77) +16:02:40 ▶ /_astro/stepper-step.CthHVWGB_IRRP3.webp (reused cache entry) (+5ms) (73/77) +16:02:40 ▶ /_astro/stepper-contentTop.DdLph9-H_Z4JPzS.webp (reused cache entry) (+5ms) (74/77) +16:02:40 ▶ /_astro/dockmanager-splitter-docking.5o9r-3xC_1RDpXW.webp (reused cache entry) (+6ms) (75/77) +16:02:40 ▶ /_astro/geo-map.6fxT5KYe_vUA2k.webp (reused cache entry) (+6ms) (76/77) +16:02:40 ▶ /_astro/tile-manager-actions.y1ZwoiR1_pXMbk.webp (reused cache entry) (+6ms) (77/77) +16:02:40 ✓ Completed in 47ms. + +16:02:40 [build] ✓ Completed in 1m 2s. +[docs-template] Running pagefind… +16:02:43 [build] Waiting for integration "docs-template:site-meta", hook "astro:build:done"... +[docs-template] pagefind index written. +16:02:45 [build] 327 page(s) built in 1m 8s +16:02:45 [build] Complete! diff --git a/docs/xplat/scripts/fix-api-link-attrs.mjs b/docs/xplat/scripts/fix-api-link-attrs.mjs new file mode 100644 index 0000000000..81087d5bd9 --- /dev/null +++ b/docs/xplat/scripts/fix-api-link-attrs.mjs @@ -0,0 +1,114 @@ +#!/usr/bin/env node +/** + * Post-pass over MDX files to fix already-emitted elements: + * 1. For kind="enum": add prefixed={false} when missing. + * DV / TypeDoc-generated React/WC enum URLs use the bare name (e.g. + * .../enums/CategoryChartType), never with an Igr/Igx/Igc prefix. + * 2. Strip CLR backtick-arity suffix in type="X`N" → type="X". + * + * Idempotent — safe to re-run. + * + * Usage: + * node scripts/fix-api-link-attrs.mjs # walk src/content + * node scripts/fix-api-link-attrs.mjs # walk specific dir + */ + +import { readdirSync, readFileSync, writeFileSync, statSync } from 'node:fs'; +import { join, resolve } from 'node:path'; + +const root = resolve(process.argv[2] ?? 'src/content'); + +/** Recursively collect .mdx files. */ +function walk(dir, out = []) { + for (const e of readdirSync(dir, { withFileTypes: true })) { + const full = join(dir, e.name); + if (e.isDirectory()) walk(full, out); + else if (e.isFile() && full.endsWith('.mdx')) out.push(full); + } + return out; +} + +const TAG_RE = /]*\/>/g; + +// Types that the apiMap marks as "class" but TypeDoc actually publishes as +// `interfaces/X`. Routing them through kind="interface" fixes the URL. +const FORCE_INTERFACE_RAW = [ + // Excel + 'IWorksheetCellFormat', + // Grids + 'ColumnPipeArgs', + 'GridBaseDirective', + 'GridStateBaseDirective', + 'GridStateInfo', + 'HierarchicalGridBaseDirective', + 'PivotConfiguration', + 'PivotDimension', + 'PivotValue', + 'PositionStrategy', + 'RowSelectorTemplateDetails', + 'HeadSelectorTemplateDetails', + 'CellType', + 'CellTemplateContext', +]; +const FORCE_INTERFACE = new Set([ + ...FORCE_INTERFACE_RAW, + ...FORCE_INTERFACE_RAW.map(n => 'Igr' + n), + ...FORCE_INTERFACE_RAW.map(n => 'Igx' + n), + ...FORCE_INTERFACE_RAW.map(n => 'Igc' + n), +]); + +function transformTag(tag) { + let out = tag; + let changed = false; + + // 1. Strip backtick-arity in type="X`N" + out = out.replace(/(\stype=")([^"]+?)`\d+(")/g, (m, a, name, c) => { + changed = true; + return `${a}${name}${c}`; + }); + + // 2. Add prefixed={false} to kind="enum" tags that don't already have it. + if (/\skind="enum"/.test(out) && !/\sprefixed=\{false\}/.test(out)) { + // Insert before the closing " />" or "/>" + out = out.replace(/\s*\/>$/, ' prefixed={false} />'); + changed = true; + } + + // 3. Reclassify class → interface for known mis-classified types. + const typeMatch = out.match(/\stype="([^"]+)"/); + if (typeMatch && FORCE_INTERFACE.has(typeMatch[1]) && !/\skind="/.test(out)) { + // No kind specified → defaults to class. Insert kind="interface" before type. + out = out.replace(/(\stype=")/, ' kind="interface"$1'); + changed = true; + } + + // 4. Spreadsheet types DO carry the platform Igr/Igx/Igc prefix + // (only excel types are unprefixed). Strip incorrect prefixed={false}. + if (/\spkg="spreadsheet"/.test(out) && /\sprefixed=\{false\}/.test(out)) { + out = out.replace(/\s+prefixed=\{false\}/, ''); + changed = true; + } + + return { out, changed }; +} + +let filesScanned = 0; +let filesChanged = 0; +let tagsTouched = 0; + +for (const file of walk(root)) { + filesScanned++; + const src = readFileSync(file, 'utf-8'); + let fileChanged = false; + const next = src.replace(TAG_RE, (tag) => { + const { out, changed } = transformTag(tag); + if (changed) { tagsTouched++; fileChanged = true; } + return out; + }); + if (fileChanged) { + writeFileSync(file, next); + filesChanged++; + } +} + +console.log(`[fix-api-link-attrs] scanned=${filesScanned}, changed=${filesChanged}, tags fixed=${tagsTouched}`); diff --git a/docs/xplat/scripts/resolve-api-links.mjs b/docs/xplat/scripts/resolve-api-links.mjs new file mode 100644 index 0000000000..53a0da2d08 --- /dev/null +++ b/docs/xplat/scripts/resolve-api-links.mjs @@ -0,0 +1,631 @@ +#!/usr/bin/env node +/** + * resolve-api-links.mjs + * + * Converts bare inline-code references (e.g. `Value`, `transitionDuration`) + * in xplat MDX files into components, using the same apiMap JSON + * files that the original igniteui-xplat-docs gulpfile uses + * (https://github.com/IgniteUI/igniteui-xplat-docs). + * + * For each MDX file with `mentionedTypes:` frontmatter, the script: + * 1. Reads the mentionedTypes list. + * 2. Builds a lookup of every member on those types (and their base types) + * via the merged apiMap from all 4 platforms. + * 3. Scans the body (outside code fences, outside JSX attributes) for + * inline `code` references. + * 4. If the backticked text matches either a member of any mentioned type + * or a known type name, replaces the inline code with an . + * 5. Ensures `import ApiLink ...` is present. + * + * Usage: + * node scripts/resolve-api-links.mjs # convert all en/ jp/ kr/ files + * node scripts/resolve-api-links.mjs --dry-run # show what would change, no writes + * node scripts/resolve-api-links.mjs --file # process a single file + * node scripts/resolve-api-links.mjs --limit 5 # stop after 5 modified files + * node scripts/resolve-api-links.mjs --verbose # log every replacement + */ + +import fs from 'node:fs'; +import path from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const __dirname = path.dirname(fileURLToPath(import.meta.url)); +const XPLAT_ROOT = path.resolve(__dirname, '..'); +const REPO_ROOT = path.resolve(XPLAT_ROOT, '..', '..'); +const CONTENT_ROOT = path.join(XPLAT_ROOT, 'src', 'content'); + +// Locate the igniteui-xplat-docs repo. +// Resolution order: +// 1. XPLAT_DOCS_ROOT env variable (set explicitly, e.g. in CI) +// 2. Sibling directory next to this repo (standard local dev layout) +// 3. Fetch from GitHub (https://github.com/IgniteUI/igniteui-xplat-docs) — no local clone needed +const XPLAT_DOCS_ROOT_LOCAL = process.env.XPLAT_DOCS_ROOT + ?? path.resolve(REPO_ROOT, '..', 'igniteui-xplat-docs'); +const API_MAP_ROOT_LOCAL = path.join(XPLAT_DOCS_ROOT_LOCAL, 'apiMap'); +const USE_LOCAL = fs.existsSync(API_MAP_ROOT_LOCAL); + +const GITHUB_RAW_BASE = 'https://raw.githubusercontent.com/IgniteUI/igniteui-xplat-docs/master'; +const GITHUB_API_BASE = 'https://api.github.com/repos/IgniteUI/igniteui-xplat-docs'; + +const args = process.argv.slice(2); +const DRY_RUN = args.includes('--dry-run'); +const VERBOSE = args.includes('--verbose'); +const LIMIT = (() => { + const i = args.indexOf('--limit'); + return i >= 0 ? parseInt(args[i + 1], 10) : Infinity; +})(); +const SINGLE_FILE = (() => { + const i = args.indexOf('--file'); + return i >= 0 ? args[i + 1] : null; +})(); + +// ----------------------------------------------------------------------------- +// 1. Load and merge apiMap JSON across all 4 platforms. +// ----------------------------------------------------------------------------- + +const PLATFORMS = ['Angular', 'React', 'WebComponents', 'Blazor']; + +/** + * Merged type map: + * originalName -> { + * originalName, + * originalNamespace, + * packageName, + * originalBaseTypeName, + * originalBaseTypeNamespace, + * isEnum, isInterface, + * names: { [platform]: mappedName }, + * members: Map + * } + */ +const typeMap = new Map(); + +function ensureType(originalName) { + let t = typeMap.get(originalName); + if (!t) { + t = { + originalName, + originalNamespace: null, + packageName: null, + originalBaseTypeName: null, + originalBaseTypeNamespace: null, + isEnum: false, + isInterface: false, + names: {}, + members: new Map(), + }; + typeMap.set(originalName, t); + } + return t; +} + +function mergeType(type) { + const t = ensureType(type.originalName); + if (type.originalNamespace) t.originalNamespace = type.originalNamespace; + if (type.packageName) t.packageName = type.packageName; + if (type.originalBaseTypeName) t.originalBaseTypeName = type.originalBaseTypeName; + if (type.originalBaseTypeNamespace) t.originalBaseTypeNamespace = type.originalBaseTypeNamespace; + if (type.isEnum) t.isEnum = true; + if (type.isInterface) t.isInterface = true; + + if (Array.isArray(type.names)) { + for (const n of type.names) { + if (n.platform && n.mappedName && !t.names[n.platform]) { + t.names[n.platform] = n.mappedName; + } + } + } + if (Array.isArray(type.members)) { + for (const m of type.members) { + if (!m.originalName) continue; + let existing = t.members.get(m.originalName); + if (!existing) { + existing = { originalName: m.originalName, names: {} }; + t.members.set(m.originalName, existing); + } + for (const n of (m.names || [])) { + if (n.platform && n.mappedName && !existing.names[n.platform]) { + existing.names[n.platform] = n.mappedName; + } + } + } + } +} + +async function loadApiMaps() { + let apiMapFileCount = 0; + + if (USE_LOCAL) { + for (const platform of PLATFORMS) { + const dir = path.join(API_MAP_ROOT_LOCAL, platform); + if (!fs.existsSync(dir)) continue; + for (const file of fs.readdirSync(dir)) { + if (!file.endsWith('.apiMap.json')) continue; + apiMapFileCount++; + const json = JSON.parse(fs.readFileSync(path.join(dir, file), 'utf8')); + for (const t of (json.types || [])) mergeType(t); + } + } + console.log(`[resolve-api-links] loaded ${apiMapFileCount} apiMap JSON file(s) from local clone, ${typeMap.size} unique types`); + return; + } + + // No local clone — fetch from GitHub. + console.log('[resolve-api-links] no local igniteui-xplat-docs clone found, fetching apiMap from GitHub...'); + const headers = { 'Accept': 'application/vnd.github+json', 'X-GitHub-Api-Version': '2022-11-28' }; + if (process.env.GITHUB_TOKEN) headers['Authorization'] = `Bearer ${process.env.GITHUB_TOKEN}`; + + // Get the full tree to enumerate all apiMap JSON paths. + const treeUrl = `${GITHUB_API_BASE}/git/trees/master?recursive=1`; + const treeResp = await fetch(treeUrl, { headers }); + if (!treeResp.ok) { + console.error(`[resolve-api-links] GitHub tree fetch failed: ${treeResp.status} ${treeResp.statusText}`); + console.error(` Tip: set GITHUB_TOKEN env variable to avoid rate limits.`); + process.exit(2); + } + const treeData = await treeResp.json(); + const apiMapPaths = (treeData.tree || []) + .filter(e => e.type === 'blob' && e.path.startsWith('apiMap/') && e.path.endsWith('.apiMap.json')) + .map(e => e.path); + + if (apiMapPaths.length === 0) { + console.error('[resolve-api-links] no apiMap JSON files found in GitHub tree'); + process.exit(2); + } + + // Fetch all files in parallel. + const results = await Promise.all( + apiMapPaths.map(async (filePath) => { + const url = `${GITHUB_RAW_BASE}/${filePath}`; + const resp = await fetch(url, { headers }); + if (!resp.ok) throw new Error(`Failed to fetch ${url}: ${resp.status}`); + return resp.json(); + }) + ); + + for (const json of results) { + apiMapFileCount++; + for (const t of (json.types || [])) mergeType(t); + } + console.log(`[resolve-api-links] fetched ${apiMapFileCount} apiMap JSON file(s) from GitHub, ${typeMap.size} unique types`); +} + +await loadApiMaps(); + +// ----------------------------------------------------------------------------- +// 2. Helpers — type / member resolution, pkg mapping. +// ----------------------------------------------------------------------------- + +const PACKAGE_NAME_TO_PKG = { + 'igniteui-core': 'core', + 'igniteui-charts': 'charts', + 'igniteui-data-grids': 'grids', + 'igniteui-webgrids': 'grids', + 'igniteui-excel': 'excel', + 'igniteui-spreadsheet': 'spreadsheet', + 'igniteui-spreadsheet-chart-adapter': 'spreadsheet', + 'igniteui-gauges': 'gauges', + 'igniteui-inputs': 'inputs', + 'igniteui-webinputs': 'inputs', + 'igniteui-layouts': 'layouts', + 'igniteui-maps': 'maps', + 'igniteui-dashboards': null, +}; + +function pkgForType(t) { + if (!t) return 'core'; + if (t.packageName && PACKAGE_NAME_TO_PKG[t.packageName] !== undefined) { + return PACKAGE_NAME_TO_PKG[t.packageName] || 'core'; + } + return 'core'; +} + +/** + * Utility / non-component classes that should be rendered with suffix={false} + * because Angular DV doesn't wrap them in a Component (no `Component` suffix + * in the URL). + * + * Heuristic: any type whose name matches one of these suffix patterns. + */ +const NON_COMPONENT_SUFFIXES = [ + 'Operand', // SummaryOperand, NumberSummaryOperand + 'Strategy', // SortingStrategy + 'Service', // GridSelectionService + 'EventArgs', + 'Args', + 'Descriptor', + 'Description', + 'Information', + 'Settings', + 'Options', + 'Behavior', + 'Provider', + 'Manager', + 'Factory', + 'Mapping', + 'Comparer', + 'Resolver', + 'Adapter', + 'Item', + 'Frame', + 'Layout', +]; + +function needsSuffix(typeName, type) { + // Enums and interfaces never get a Component suffix. + if (type && (type.isEnum || type.isInterface)) return false; + for (const s of NON_COMPONENT_SUFFIXES) { + if (typeName.endsWith(s)) return false; + } + return true; +} + +/** + * Find a type by name. Falls back to the `Xam`-prefixed form because the + * migration to MDX dropped the `Xam` prefix from `mentionedTypes` entries + * (apiMap still uses originals like `XamBulletGraph`). + */ +function findType(name) { + return typeMap.get(name) + || typeMap.get('Xam' + name) + || null; +} + +/** Walk inheritance chain of `typeName`, calling visit(type) for each. */ +function* walkBaseTypes(typeName) { + const seen = new Set(); + let cur = findType(typeName); + while (cur && !seen.has(cur.originalName)) { + seen.add(cur.originalName); + yield cur; + if (!cur.originalBaseTypeName) break; + cur = findType(cur.originalBaseTypeName); + } +} + +/** Display name strips Xam prefix so docs read naturally. */ +function shortTypeName(originalName) { + return originalName.startsWith('Xam') ? originalName.slice(3) : originalName; +} + +/** + * Resolve a backticked identifier against mentionedTypes. + * Returns { kind: 'member'|'type', type, member?, originalText } + * or null if no match. + */ +function resolveIdentifier(ident, mentionedTypes, mentionedPkgs) { + // 0. If ident exactly matches a type name listed in mentionedTypes, prefer + // the type match over any coincidental member match on another type. + // e.g. `Grid` listed in mentionedTypes should resolve to the Grid component, + // not to DataGridCellEventArgs.grid member. + if (mentionedTypes.includes(ident)) { + const directType = findType(ident); + if (directType) return { kind: 'type', type: directType }; + } + + // 1. Member match against each mentioned type's inheritance chain. + // (Member match wins over a coincidentally-matching unrelated type.) + for (const mt of mentionedTypes) { + for (const t of walkBaseTypes(mt)) { + if (t.members.has(ident)) { + return { + kind: 'member', + type: findType(mt) || t, + member: t.members.get(ident), + }; + } + } + } + // 2. Direct type match — but only when the candidate type belongs to the + // same package as one of the mentionedTypes. Avoids cross-package + // false positives (e.g. `ChartTitle` matching the unrelated Excel type + // in a charts file). + const directType = findType(ident); + if (directType) { + const candidatePkg = pkgForType(directType); + if (mentionedPkgs.has(candidatePkg) || mentionedTypes.includes(directType.originalName) + || mentionedTypes.includes(shortTypeName(directType.originalName))) { + return { kind: 'type', type: directType }; + } + } + return null; +} + +/** Pick the camelCase / JS-style member name from Angular/React/WC. */ +function jsMemberName(member) { + return member.names.Angular || member.names.React || member.names.WebComponents + || member.names.Blazor || member.originalName; +} + +// ----------------------------------------------------------------------------- +// 3. MDX scanning — find inline-code outside code fences / JSX attributes. +// ----------------------------------------------------------------------------- + +const IMPORT_LINE = `import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro';`; + +function hasApiLinkImport(text) { + return /import\s+ApiLink\s+from\s+['"][^'"]*ApiLink\.astro['"]/m.test(text); +} + +function addApiLinkImport(text) { + if (hasApiLinkImport(text)) return text; + // Only look at the top-of-file import block (after frontmatter, before any + // heading/content). This avoids picking up `import …` lines inside code + // fences further down the file. + const fmEnd = text.startsWith('---') ? text.indexOf('\n---', 4) : -1; + let scanStart = fmEnd >= 0 ? fmEnd + 4 : 0; + // Skip leading newlines/whitespace. + while (scanStart < text.length && /[\r\n]/.test(text[scanStart])) scanStart++; + + // Walk lines: stop at the first line that isn't blank and isn't an + // `import …;` line. + let pos = scanStart; + let lastImportEnd = -1; + while (pos < text.length) { + const nlIdx = text.indexOf('\n', pos); + const lineEnd = nlIdx < 0 ? text.length : nlIdx; + const line = text.slice(pos, lineEnd).replace(/\r$/, ''); + if (line.trim() === '') { + // blank — keep scanning + } else if (/^import\s.*;\s*$/.test(line)) { + lastImportEnd = lineEnd; // position of '\n' (or end) + } else { + break; // hit non-import content + } + if (nlIdx < 0) break; + pos = nlIdx + 1; + } + + if (lastImportEnd >= 0) { + // Place the new import directly after the last import line and any + // trailing blank lines that follow it, ensuring exactly one blank + // line separates the new import from following content. + let insertAt = lastImportEnd; + if (text[insertAt] === '\n') insertAt++; + // Skip subsequent blank lines. + while (insertAt < text.length) { + const c0 = text[insertAt]; + const c1 = text[insertAt + 1]; + if (c0 === '\n') { insertAt++; continue; } + if (c0 === '\r' && c1 === '\n') { insertAt += 2; continue; } + if (c0 === '\r') { insertAt++; continue; } + break; + } + return text.slice(0, insertAt) + IMPORT_LINE + '\n\n' + text.slice(insertAt); + } + + // No top-level imports — insert right after frontmatter (or at the + // beginning of file when no frontmatter is present). + if (fmEnd >= 0) { + let insertAt = fmEnd + 4; + if (text[insertAt] === '\r') insertAt++; + if (text[insertAt] === '\n') insertAt++; + return text.slice(0, insertAt) + IMPORT_LINE + '\n\n' + text.slice(insertAt); + } + return IMPORT_LINE + '\n\n' + text; +} + +function parseFrontmatter(text) { + if (!text.startsWith('---')) return { fm: null, body: text, fmRaw: '' }; + const end = text.indexOf('\n---', 3); + if (end < 0) return { fm: null, body: text, fmRaw: '' }; + const raw = text.slice(0, end + 4); + // Very small YAML subset — we only need `mentionedTypes`. + const fm = {}; + const mtMatch = raw.match(/^mentionedTypes:\s*\[([^\]]*)\]/m); + if (mtMatch) { + fm.mentionedTypes = mtMatch[1] + .split(',') + .map(s => s.trim().replace(/^["']|["']$/g, '')) + .filter(Boolean); + } else { + fm.mentionedTypes = []; + } + return { fm, body: text.slice(end + 4), fmRaw: raw }; +} + +/** Build ApiLink JSX from a resolved match. */ +function buildApiLink(match, originalText) { + const t = match.type; + const pkg = pkgForType(t); + const isExcel = pkg === 'excel' || pkg === 'spreadsheet'; + const suffix = isExcel ? false : needsSuffix(t.originalName, t); + const isEnum = t.isEnum; + const isIface = t.isInterface; + const kind = isEnum ? 'enum' : (isIface ? 'interface' : 'class'); + + // Strip backtick-N generic arity suffix (e.g. "SortSettings`1" → "SortSettings"). + const shortName = shortTypeName(t.originalName).replace(/`\d+$/, ''); + + const props = []; + if (pkg !== 'core') props.push(`pkg="${pkg}"`); + if (kind !== 'class') props.push(`kind="${kind}"`); + props.push(`type="${shortName}"`); + + if (match.kind === 'member') { + props.push(`member="${jsMemberName(match.member)}"`); + props.push(`label="${originalText}"`); + } + // Cases where the platform Igr/Igx/Igc/Igb prefix must NOT be auto-added: + // 1. Excel / Spreadsheet types — DV docs don't prefix these. + // 2. Enums — TypeDoc-generated DV docs publish enums under bare names + // (e.g. `enums/CategoryChartType`, never `enums/IgrCategoryChartType`). + // 3. Inline backticks that already contain the prefix (avoids "IgrIgrFoo"). + const alreadyPrefixed = /^(Igr|Igx|Igc|Igb)/.test(originalText) && match.kind === 'type'; + if (isExcel || isEnum || alreadyPrefixed) { + props.push(`prefixed={false}`); + } + if (!suffix && kind === 'class') props.push(`suffix={false}`); + + return ``; +} + +/** + * Walk the MDX body line-by-line, skipping fenced code blocks (``` … ```) + * and JSX attribute values, then replace inline `…` matches. + */ +function transformBody(body, mentionedTypes, mentionedPkgs, stats) { + const lines = body.split('\n'); + let inFence = false; + let fenceMarker = ''; + for (let i = 0; i < lines.length; i++) { + const line = lines[i]; + const fenceMatch = line.match(/^(\s*)(```+|~~~+)/); + if (fenceMatch) { + if (!inFence) { + inFence = true; + fenceMarker = fenceMatch[2]; + } else if (line.includes(fenceMarker)) { + inFence = false; + fenceMarker = ''; + } + continue; + } + if (inFence) continue; + + // Replace inline `…` outside JSX attributes. + // Strategy: split the line on JSX tag boundaries; only process text + // segments that are not inside <... ...> tags. A simple heuristic + // that handles the common case (we don't need a full JSX parser). + lines[i] = replaceInlineCodeOutsideTags(line, mentionedTypes, mentionedPkgs, stats); + } + return lines.join('\n'); +} + +function replaceInlineCodeOutsideTags(line, mentionedTypes, mentionedPkgs, stats) { + // Tokenize: split into runs of "inside-tag" and "outside-tag". + // Naive: a "<" begins a tag, ">" ends it. Inside a tag we never touch + // backticks. Outside, we run the inline-code regex. + let out = ''; + let i = 0; + let inTag = false; + let buffer = ''; + while (i < line.length) { + const ch = line[i]; + if (!inTag && ch === '<' && /[A-Za-z/!]/.test(line[i + 1] || '')) { + // Flush buffer with replacements. + out += processOutside(buffer, mentionedTypes, mentionedPkgs, stats); + buffer = ''; + inTag = true; + out += ch; + } else if (inTag && ch === '>') { + out += ch; + inTag = false; + } else if (inTag) { + out += ch; + } else { + buffer += ch; + } + i++; + } + if (buffer) out += processOutside(buffer, mentionedTypes, mentionedPkgs, stats); + return out; +} + +const INLINE_CODE_RE = /`([A-Za-z_][A-Za-z0-9_]*)`/g; + +function processOutside(segment, mentionedTypes, mentionedPkgs, stats) { + return segment.replace(INLINE_CODE_RE, (full, ident) => { + const resolved = resolveIdentifier(ident, mentionedTypes, mentionedPkgs); + if (!resolved) return full; + const replacement = buildApiLink(resolved, ident); + stats.replacements++; + if (VERBOSE) { + console.log(` \`${ident}\` -> ${replacement}`); + } + return replacement; + }); +} + +// ----------------------------------------------------------------------------- +// 4. File iteration. +// ----------------------------------------------------------------------------- + +function* walkMdx(dir) { + if (!fs.existsSync(dir)) return; + for (const entry of fs.readdirSync(dir, { withFileTypes: true })) { + const full = path.join(dir, entry.name); + if (entry.isDirectory()) yield* walkMdx(full); + else if (entry.isFile() && entry.name.endsWith('.mdx')) yield full; + } +} + +/** + * If the MDX file has no `mentionedTypes:`, fall back to reading the + * corresponding original .md from the sibling igniteui-xplat-docs repo + * (https://github.com/IgniteUI/igniteui-xplat-docs). + */ +function loadMentionedTypesFromOriginal(mdxPath) { + const rel = path.relative(CONTENT_ROOT, mdxPath).replace(/\\/g, '/'); + const mdPath = path.join(ORIG_DOC_ROOT, rel).replace(/\.mdx$/, '.md'); + if (!fs.existsSync(mdPath)) return []; + const raw = fs.readFileSync(mdPath, 'utf8'); + if (!raw.startsWith('---')) return []; + const end = raw.indexOf('\n---', 3); + if (end < 0) return []; + const fmRaw = raw.slice(0, end + 4); + const m = fmRaw.match(/^mentionedTypes:\s*\[([^\]]*)\]/m); + if (!m) return []; + return m[1].split(',').map(s => s.trim().replace(/^["']|["']$/g, '')).filter(Boolean); +} + +/** Derive additional mentioned types from any existing already in the body. */ +function deriveMentionedTypesFromBody(body) { + const found = new Set(); + const re = /]*\btype="([A-Za-z_][A-Za-z0-9_]*)"/g; + let m; + while ((m = re.exec(body))) found.add(m[1]); + return [...found]; +} + +function processFile(file) { + const text = fs.readFileSync(file, 'utf8'); + const { fm, body, fmRaw } = parseFrontmatter(text); + if (!fm) return null; + + let mentionedTypes = fm.mentionedTypes; + if (mentionedTypes.length === 0) { + mentionedTypes = loadMentionedTypesFromOriginal(file); + } + // Augment with any types already referenced via existing . + const fromBody = deriveMentionedTypesFromBody(body); + if (fromBody.length) { + const seen = new Set(mentionedTypes); + for (const t of fromBody) if (!seen.has(t)) { mentionedTypes.push(t); seen.add(t); } + } + if (mentionedTypes.length === 0) return null; + + const stats = { replacements: 0 }; + const mentionedPkgs = new Set(); + for (const mt of mentionedTypes) { + const t = findType(mt); + if (t) mentionedPkgs.add(pkgForType(t)); + } + let newBody = transformBody(body, mentionedTypes, mentionedPkgs, stats); + if (stats.replacements === 0) return null; + + let newText = fmRaw + newBody; + newText = addApiLinkImport(newText); + return { newText, stats }; +} + +const allFiles = SINGLE_FILE + ? [path.resolve(SINGLE_FILE)] + : [...walkMdx(path.join(CONTENT_ROOT, 'en')), + ...walkMdx(path.join(CONTENT_ROOT, 'jp')), + ...walkMdx(path.join(CONTENT_ROOT, 'kr'))]; + +let modified = 0; +let totalRepl = 0; +for (const file of allFiles) { + if (modified >= LIMIT) break; + const result = processFile(file); + if (!result) continue; + const rel = path.relative(XPLAT_ROOT, file).replace(/\\/g, '/'); + console.log(`${DRY_RUN ? '[dry]' : '[fix]'} ${rel} (+${result.stats.replacements} ApiLinks)`); + totalRepl += result.stats.replacements; + modified++; + if (!DRY_RUN) fs.writeFileSync(file, result.newText, 'utf8'); +} + +console.log(`\n[resolve-api-links] ${DRY_RUN ? 'would update' : 'updated'} ${modified} file(s), ${totalRepl} total ApiLink replacements`); diff --git a/docs/xplat/src/content/en/components/ai/ai-assisted-development-overview.mdx b/docs/xplat/src/content/en/components/ai/ai-assisted-development-overview.mdx index 127fec2cbf..76e80826de 100644 --- a/docs/xplat/src/content/en/components/ai/ai-assisted-development-overview.mdx +++ b/docs/xplat/src/content/en/components/ai/ai-assisted-development-overview.mdx @@ -34,12 +34,12 @@ Run this command from the root of your existing Angular, React, Blazor, or Web C npx igniteui-cli ai-config ``` - + Without a version pin, `npx` may pull an older CLI version that does not recognize the `ai-config` subcommand and will instead launch an interactive project-creation prompt, scaffolding a new project inside your existing one. Make sure that you have installed CLI version 16.x. - + For Blazor, `ai-config` detects your project by looking for a `.csproj` or `.sln` file. The `IgniteUI.Blazor` NuGet package does not need to be installed. @@ -53,14 +53,14 @@ After the command finishes, start the MCP servers in your AI client. The servers If Ignite UI is **not** installed in the project: - + Ignite UI MCP servers configured for your selected clients
No AI skill files found. Make sure packages are installed (`npm install`) and your Ignite UI packages are up-to-date.
- + Ignite UI MCP servers configured for your selected clients @@ -69,7 +69,7 @@ The MCP servers are ready to use. Skills will be added automatically the next ti If Ignite UI **is** installed in the project: - + Ignite UI MCP servers configured for your selected clients
Agent Skills copied to your selected agents' skills directories
@@ -229,19 +229,19 @@ ig ai-config ``` - + The `npx igniteui-cli` and `ig` forms do not register the `@angular/cli` MCP server. Use the Angular Schematics command above if you want all three servers configured in a single step. - + The command requires Ignite UI packages to be installed in your project (`npm install`). If no skill files are found, make sure your packages are up-to-date. - + For Blazor, `ai-config` detects your project via `.csproj` or `.sln`. If no project file is found, the command prompts you to select a framework. diff --git a/docs/xplat/src/content/en/components/ai/cli-mcp.mdx b/docs/xplat/src/content/en/components/ai/cli-mcp.mdx index 7e6473daf5..a22d61a7da 100644 --- a/docs/xplat/src/content/en/components/ai/cli-mcp.mdx +++ b/docs/xplat/src/content/en/components/ai/cli-mcp.mdx @@ -60,7 +60,7 @@ The canonical launch command is: npx -y igniteui-cli mcp ``` - + The `-y` flag tells `npx` to auto-confirm the package download prompt so the server can start without manual intervention. @@ -190,7 +190,7 @@ If you created the project with Ignite UI CLI first, review the generated `.vsco Once saved, open the GitHub Copilot chat panel, switch to **Agent** mode, and the Ignite UI CLI MCP tools will be available. - + MCP support in VS Code requires GitHub Copilot and VS Code 1.99 or later. @@ -215,7 +215,7 @@ Cursor supports project-scoped MCP configuration. Create or edit `.cursor/mcp.js The servers will be picked up automatically when you open a new Cursor chat session. - + You can also configure MCP servers globally via **Settings → MCP** in Cursor. @@ -300,7 +300,7 @@ JetBrains AI Assistant supports MCP servers through the IDE settings: 5. Click **OK** and restart the AI Assistant. - + MCP support requires the AI Assistant plugin to be installed and enabled in your JetBrains IDE. @@ -373,7 +373,7 @@ At a high level, the CLI MCP tools help with: - updating project structure and configuration - answering documentation and API questions - + Framework detection uses component prefixes: `for Angular`, `for React`, `for Web Components`, `for Blazor`. The assistant picks up the right framework automatically from your open files or prompt context. diff --git a/docs/xplat/src/content/en/components/ai/skills.mdx b/docs/xplat/src/content/en/components/ai/skills.mdx index 28e9916fd4..81914e05e3 100644 --- a/docs/xplat/src/content/en/components/ai/skills.mdx +++ b/docs/xplat/src/content/en/components/ai/skills.mdx @@ -14,7 +14,7 @@ import PlatformBlock from 'igniteui-astro-components/components/mdx/PlatformBloc {ProductName} ships with **[Agent Skills](https://agentskills.io/)** - structured knowledge files that teach AI coding assistants (GitHub Copilot, Cursor, Windsurf, Claude, Gemini CLI, JetBrains Junie, etc.) how to work with {ProductName}. These skill files provide context-aware guidance on components, grids, data operations, and theming, enabling your AI assistant to generate accurate, idiomatic code that follows best practices. - + The AI tooling landscape is evolving rapidly. Skill discovery locations and distribution options may change as tools and IDEs are updated. Always consult the official documentation for your specific tool or agent for the latest information. @@ -54,7 +54,7 @@ The skill files live in the [`skills/`]({GithubLink}/tree/master/skills) directo | Theming & Styling | [`skills/igniteui-angular-theming/SKILL.md`]({GithubLink}/blob/master/skills/igniteui-angular-theming/SKILL.md) | Palettes, typography, elevations, component themes, MCP server | | Generate From Image Design | [`skills/igniteui-angular-generate-from-image-design/SKILL.md`]({GithubLink}/blob/master/skills/igniteui-angular-generate-from-image-design/SKILL.md) | Build Angular apps from screenshots, mockups, and wireframes using Ignite UI components | - + Starting with {ProductName} **21.1.0**, these skills are automatically discovered when placed in your agent's skills path (e.g., `.claude/skills`, `.agents/skills`, `.cursor/rules/`). This release ships with an optional migration to add these skills to your project automatically. @@ -235,7 +235,7 @@ ig ai-config --assistants generic vscode --agents claude copilot cursor | `--agents` | `generic`, `claude`, `copilot`, `cursor`, `codex`, `windsurf`, `gemini`, `junie`, `none` | Prompted interactively | - + For Blazor, `ai-config` detects your project via `.csproj` or `.sln`. The `IgniteUI.Blazor` NuGet package does not need to be installed. If no project file is found, the command prompts you to select a framework. @@ -255,7 +255,7 @@ This also registers the `@angular/cli` MCP server alongside the Ignite UI server - + If you installed {ProductName} manually and want to copy skills without running `ai-config`, the skill files are also available under `node_modules`. To copy them into your project (e.g. into `.agents/skills/`), run: diff --git a/docs/xplat/src/content/en/components/ai/theming-mcp.mdx b/docs/xplat/src/content/en/components/ai/theming-mcp.mdx index 99869ea104..a0904199a9 100644 --- a/docs/xplat/src/content/en/components/ai/theming-mcp.mdx +++ b/docs/xplat/src/content/en/components/ai/theming-mcp.mdx @@ -63,7 +63,7 @@ npm install igniteui-theming - + The Theming MCP server is an npm package launched directly via `npx` - no local npm install is required in your Blazor project. `npx -y` fetches it from the npm registry on first use and caches it automatically. @@ -293,7 +293,7 @@ For compound components (e.g., `combo`, `select`, `grid`), `get_component_design - + If your project uses the licensed `@infragistics/igniteui-angular` package, tell the AI so it can set the `licensed` parameter on palette, theme, and component tools. This adjusts the generated import paths accordingly. diff --git a/docs/xplat/src/content/en/components/bullet-graph.mdx b/docs/xplat/src/content/en/components/bullet-graph.mdx index eaa3974396..3a93db3fef 100644 --- a/docs/xplat/src/content/en/components/bullet-graph.mdx +++ b/docs/xplat/src/content/en/components/bullet-graph.mdx @@ -319,7 +319,7 @@ Performance value is the primary measure displayed by the component and it is vi ## Highlight Value -The bullet graph's performance value can be further modified to show progress represented as a highlighted value. This will make the `Value` appear with a lower opacity. A good example is if `Value` is 50 and `HighlightValue` is set to 25. This would represent a performance of 50% regardless of what the value of `TargetValue` is set to. To enable this first set `HighlightValueDisplayMode` to Overlay and then apply a `HighlightValue` to something lower than `Value`. +The bullet graph's performance value can be further modified to show progress represented as a highlighted value. This will make the appear with a lower opacity. A good example is if is 50 and is set to 25. This would represent a performance of 50% regardless of what the value of is set to. To enable this first set to Overlay and then apply a to something lower than . @@ -795,7 +795,7 @@ The backing element represents background and border of the bullet graph compone ## Scale -The scale is visual element that highlights the full range of values in the gauge. You can customize appearance and shape of the scale. The scale can also be inverted (using `IsScaleInverted` property) and all labels will be rendered from right-to-left instead of left-to-right. +The scale is visual element that highlights the full range of values in the gauge. You can customize appearance and shape of the scale. The scale can also be inverted (using property) and all labels will be rendered from right-to-left instead of left-to-right. diff --git a/docs/xplat/src/content/en/components/charts/chart-api.mdx b/docs/xplat/src/content/en/components/charts/chart-api.mdx index f68beee510..00ca06cf88 100644 --- a/docs/xplat/src/content/en/components/charts/chart-api.mdx +++ b/docs/xplat/src/content/en/components/charts/chart-api.mdx @@ -6,85 +6,87 @@ _license: commercial namespace: Infragistics.Controls.Charts --- +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} Charts API -The {ProductName} charts provide simple and easy to use APIs to plot your data in `CategoryChart`, `FinancialChart`, `DataChart`, `DataPieChart`, `DoughnutChart`, `PieChart`, and `Sparkline` UI elements. +The {ProductName} charts provide simple and easy to use APIs to plot your data in , , , , , , and UI elements. ## {Platform} Category Chart API -The {Platform} `CategoryChart` has the following API members: +The {Platform} has the following API members: | Chart Properties | Axis Properties | Series Properties | |------------------|-----------------|-------------------| -| - `CategoryChart.ChartType`
- `ExcludedProperties`
- `IncludedProperties`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `CrosshairsDisplayMode`
- `TransitionInMode`
- `HighlightingBehavior`
- `HighlightingMode`
- `TrendLineType`
| - `XAxisInterval`
- `XAxisLabelLocation`
- `XAxisGap`
- `XAxisOverlap`
- `XAxisTitle`
- `YAxisInterval`
- `YAxisLabelLocation`
- `YAxisTitle`
- `YAxisMinimumValue`
- `YAxisMaximumValue` | - `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `MarkerTypes`
- `ToolTipType`




| +| - `CategoryChart.ChartType`
-
-
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-




| ## {Platform} Financial Chart API -The {Platform} `FinancialChart` has the following API members: +The {Platform} has the following API members: | Chart Properties | Axis Properties | Series Properties | |------------------|-----------------|-------------------| -| - `FinancialChart.ChartType`
- `ExcludedProperties`
- `IncludedProperties`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `ToolTipType`
- `CrosshairsDisplayMode`
- `HighlightingBehavior`
- `HighlightingMode`
- `TrendLineType` | - `XAxisInterval`
- `XAxisLabelLocation`
- `XAxisTitle`
- `YAxisInterval`
- `YAxisLabelLocation`
- `YAxisTitle`
- `YAxisMinimumValue`
- `YAxisMaximumValue`
- `YAxisMode`
- `XAxisMode` | - `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `MarkerTypes`
- `IndicatorTypes`
- `VolumeType`
- `ZoomSliderType`


| +| - `FinancialChart.ChartType`
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-


| ## {Platform} Data Chart API -The {Platform} `DataChart` has the following API members: +The {Platform} has the following API members: | Chart Properties | Axis Classes | |------------------|--------------| -| - `SeriesViewer.Title`
- `SeriesViewer.Subtitle`
- `IsHorizontalZoomEnabled`
- `IsVerticalZoomEnabled`
- `Brushes`
- `Outlines`
- `MarkerBrushes`
- `MarkerOutlines`
- `DataChart.Axes`
- `SeriesViewer.Series`
| - `Axis` is base class for all axis types
- `CategoryXAxis` used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- `CategoryYAxis` used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md)
- `CategoryAngleAxis` used with [Radial Series](types/radial-chart.md)
- `NumericXAxis` used with [Scatter Series](types/scatter-chart.md) and [Bar Series](types/bar-chart.md)
- `NumericYAxis` used with [Scatter Series](types/scatter-chart.md), [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- `NumericAngleAxis` used with [Polar Series](types/polar-chart.md)
- `NumericRadiusAxis` used with [Polar Series](types/polar-chart.md) and [Radial Series](types/radial-chart.md)
- `TimeXAxis` used with [Category Series](types/column-chart.md) and [Financial Series](types/stock-chart.md)

| +| - `SeriesViewer.Title`
- `SeriesViewer.Subtitle`
-
-
-
-
-
-
- `DataChart.Axes`
- `SeriesViewer.Series`
| - is base class for all axis types
- used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- used with [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md)
- used with [Radial Series](types/radial-chart.md)
- used with [Scatter Series](types/scatter-chart.md) and [Bar Series](types/bar-chart.md)
- used with [Scatter Series](types/scatter-chart.md), [Category Series](types/column-chart.md), [Stacked Series](types/stacked-chart.md), and [Financial Series](types/stock-chart.md)
- used with [Polar Series](types/polar-chart.md)
- used with [Polar Series](types/polar-chart.md) and [Radial Series](types/radial-chart.md)
- used with [Category Series](types/column-chart.md) and [Financial Series](types/stock-chart.md)

| -The {Platform} `DataChart` can use the following type of series that inherit from `Series`: +The {Platform} can use the following type of series that inherit from : | Category Series | Stacked Series | |------------------|----------------| -| - `AreaSeries`
- `BarSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries`
| - `StackedAreaSeries`
- `StackedBarSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100BarSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`


| +| -
-
-
-
-
-
-
-
-
-
-
- `RangeBarSeries`
-
| -
-
-
-
-
-
-
-
-
-


| | Scatter Series | Financial Series | |----------------|------------------| -| - `BubbleSeries`
- `HighDensityScatterSeries`
- `ScatterSeries`
- `ScatterLineSeries`
- `ScatterSplineSeries`
- `ScatterAreaSeries`
- `ScatterContourSeries`
- `ScatterPolylineSeries`
- `ScatterPolygonSeries`

| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`
- `WeightedCloseIndicator`
- and [many more](types/stock-chart.md) | +| -
-
-
-
-
-
-
-
-

| -
-
-
-
-
-
-
-
-
- and [many more](types/stock-chart.md) | | Radial Series | Polar Series | |---------------|--------------| -| - `RadialLineSeries`
- `RadialAreaSeries`
- `RadialPieSeries`
- `RadialColumnSeries`

| - `PolarScatterSeries`
- `PolarLineSeries`
- `PolarAreaSeries`
- `PolarSplineSeries`
- `PolarSplineAreaSeries`
| +| -
-
-
-

| -
-
-
-
-
| ## {Platform} Data Legend API -The {Platform} `DataLegend` has the following API members: - -- `IncludedColumns` -- `ExcludedColumns` -- `IncludedSeries` -- `ExcludedSeries` -- `ValueFormatAbbreviation` -- `ValueFormatMode` -- `ValueFormatCulture` -- `ValueFormatMinFractions` -- `ValueFormatMaxFractions` -- `ValueTextColor` -- `TitleTextColor` -- `LabelTextColor` -- `UnitsTextColor` -- `SummaryType` -- `HeaderTextColor` -- `BadgeShape` +The {Platform} has the following API members: + +- +- +- +- +- +- +- +- +- +- +- +- +- +- +- +- ## {Platform} Donut Chart API -The {Platform} `DoughnutChart` has the following API members: +The {Platform} has the following API members: -- `AllowSliceExplosion` -- `AllowSliceSelection` -- `InnerExtent` +- +- +- ## {Platform} Data Pie Chart API -The {Platform} `DataPieChart` has the following API members: +The {Platform} has the following API members: - `DataPieChart.ChartType` - `DataPieChart.HighlightingBehavior` @@ -95,7 +97,7 @@ The {Platform} `DataPieChart` has the following API members: ## {Platform} Pie Chart API -The {Platform} `PieChart` has the following API members: +The {Platform} has the following API members: - `PieChart.LegendItemBadgeTemplate` - `PieChart.LegendItemTemplate` @@ -106,15 +108,15 @@ The {Platform} `PieChart` has the following API members: ## {Platform} Sparkline Chart API -The {Platform} `Sparkline` has the following API members: +The {Platform} has the following API members: -- `DisplayNormalRangeInFront` +- - `Sparkline.DisplayType` -- `LowMarkerBrush` -- `LowMarkerSize` -- `LowMarkerVisibility` -- `NormalRangeFill` -- `UnknownValuePlotting` +- +- +- +- +- ## Additional Resources diff --git a/docs/xplat/src/content/en/components/charts/features/chart-annotations.mdx b/docs/xplat/src/content/en/components/charts/features/chart-annotations.mdx index 7de9ed17d0..0d79eaa0c7 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-annotations.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-annotations.mdx @@ -194,7 +194,7 @@ chart.calloutsLabelMemberPath = "info"; ### Timeline Styling -The following example demonstrates how to style the data chart as a timeline with annotations by setting the `AllowedPositions` properties listed above: +The following example demonstrates how to style the data chart as a timeline with annotations by setting the properties listed above: diff --git a/docs/xplat/src/content/en/components/charts/features/chart-axis-gridlines.mdx b/docs/xplat/src/content/en/components/charts/features/chart-axis-gridlines.mdx index e9a760dc7f..e7082aea3d 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-axis-gridlines.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-axis-gridlines.mdx @@ -10,12 +10,14 @@ import DocsAside from 'igniteui-astro-components/components/mdx/DocsAside.astro' import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} Axis Gridlines All {ProductName} charts include built-in capability to modify appearance of axis lines as well as frequency of major/minor gridlines and tickmarks that are rendered on the X-Axis and Y-Axis. -the following examples can be applied to `CategoryChart` as well as `FinancialChart` controls. +the following examples can be applied to as well as controls. Axis major gridlines are long lines that extend horizontally along the Y-Axis or vertically along the X-Axis from locations of axis labels, and they render through the plot area of the chart. Axis minor gridlines are lines that render between axis major gridlines. @@ -37,20 +39,20 @@ This example shows how configure the axis gridline to display major and minor gr Setting the axis interval property specifies how often major gridlines and axis labels are rendered on an axis. Similarly, the axis minor interval property specifies how frequent minor gridlines are rendered on an axis. -In order to display minor gridlines that correspond to minor interval, you need to set `XAxisMinorStroke` and `XAxisMinorStrokeThickness` properties on the axis. This is because minor gridlines do not have a default color or thickness and they will not be displayed without first assigning them. +In order to display minor gridlines that correspond to minor interval, you need to set  and  properties on the axis. This is because minor gridlines do not have a default color or thickness and they will not be displayed without first assigning them. You can customize how the gridlines are displayed in your {Platform} chart by setting the following properties: | Axis Visuals | Type | Property Names | Description | | -----------------------|---------|--------------------------------------------------------------|---------------- | -| Major Stroke Color | string | `XAxisMajorStroke`
`YAxisMajorStroke` | These properties set the color of axis major gridlines. | -| Minor Stroke Color | string | `XAxisMinorStroke`
`YAxisMinorStroke` | These properties set the color of axis minor gridlines. | -| Major Stroke Thickness | number | `XAxisMajorStrokeThickness`
`YAxisMajorStrokeThickness` | These properties set the thickness in pixels of the axis major gridlines. | -| Minor Stroke Thickness | number | `XAxisMinorStrokeThickness`
`YAxisMinorStrokeThickness` | These properties set the thickness in pixels of the axis minor gridlines. | -| Major Interval | number | `XAxisInterval`
`YAxisInterval` | These properties set interval between axis major gridlines and labels. | -| Minor Interval | number | `XAxisMinorInterval`
`YAxisMinorInterval` | These properties set interval between axis minor gridlines, if used. | -| Axis Line Stroke Color | string | `XAxisStroke`
`YAxisStroke` | These properties set the color of an axis line. | -| Axis Stroke Thickness | number | `XAxisStrokeThickness`
`YAxisStrokeThickness` | These properties set the thickness in pixels of an axis line. | +| Major Stroke Color | string |
| These properties set the color of axis major gridlines. | +| Minor Stroke Color | string |
| These properties set the color of axis minor gridlines. | +| Major Stroke Thickness | number |
| These properties set the thickness in pixels of the axis major gridlines. | +| Minor Stroke Thickness | number |
| These properties set the thickness in pixels of the axis minor gridlines. | +| Major Interval | number |
| These properties set interval between axis major gridlines and labels. | +| Minor Interval | number |
| These properties set interval between axis minor gridlines, if used. | +| Axis Line Stroke Color | string |
| These properties set the color of an axis line. | +| Axis Stroke Thickness | number |
| These properties set the thickness in pixels of an axis line. | Regarding the Major and Minor Interval in the table above, it is important to note that the major interval for axis labels will also be set by this value, displaying one label at the point on the axis associated with the interval. The minor interval gridlines are always rendered between the major gridlines, and as such, the minor interval properties should always be set to something much smaller (usually 2-5 times smaller) than the value of the major Interval properties. @@ -65,9 +67,9 @@ The following example demonstrates how to customize the gridlines by setting the -The axes of the `DataChart` also have the ability to place a dash array on the major and minor gridlines by utilizing the `MajorStrokeDashArray` and `MinorStrokeDashArray` properties, respectively. The actual axis line can be dashed as well by setting the `StrokeDashArray` property of the corresponding axis. These properties take an array of numbers that will describe the length of the dashes for the corresponding grid lines. +The axes of the also have the ability to place a dash array on the major and minor gridlines by utilizing the and properties, respectively. The actual axis line can be dashed as well by setting the property of the corresponding axis. These properties take an array of numbers that will describe the length of the dashes for the corresponding grid lines. -The following example demonstrates a `DataChart` with the above dash array properties set: +The following example demonstrates a with the above dash array properties set: @@ -76,9 +78,9 @@ The following example demonstrates a `DataChart` with the above dash array prope ## {Platform} Axis Tickmarks Example -Axis tick marks are enabled by setting the `XAxisTickLength` and `YAxisTickLength` properties to a value greater than 0. These properties specifies the length of the line segments forming the tick marks. +Axis tick marks are enabled by setting the  and  properties to a value greater than 0. These properties specifies the length of the line segments forming the tick marks. -Tick marks are always extend from the axis line and point to the direction of the labels. Labels are offset by the value of the length of tickmarks to avoid overlapping. For example, with the `YAxisTickLength` property is set to 5, axis labels will be shifted left by that amount. +Tick marks are always extend from the axis line and point to the direction of the labels. Labels are offset by the value of the length of tickmarks to avoid overlapping. For example, with the  property is set to 5, axis labels will be shifted left by that amount. The following example demonstrates how to customize the tickmarks by setting the properties above: @@ -95,9 +97,9 @@ You can customize how the axis tickmarks are displayed in our {Platform} chats b | Axis Visuals | Type | Property Names | Description | | -----------------------|---------|------------------------------------------------------------|------------------------- | -| Tick Stroke Color | string | `XAxisTickStroke`
`YAxisTickStroke` | These properties set the color of the tickmarks. | -| Tick Stroke Thickness | number | `XAxisTickStrokeThickness`
`YAxisTickStrokeThickness` | These properties set the thickness of the axis tick marks. | -| Tick Stroke Length | number | `XAxisTickLength`
`YAxisTickLength` | These properties set the length of the axis tick marks. | +| Tick Stroke Color | string |
| These properties set the color of the tickmarks. | +| Tick Stroke Thickness | number |
| These properties set the thickness of the axis tick marks. | +| Tick Stroke Length | number |
| These properties set the length of the axis tick marks. | ## Additional Resources @@ -111,25 +113,25 @@ You can find more information about related chart features in these topics: The following is a list of API members mentioned in the above sections: -| `DataChart` | `CategoryChart` or `FinancialChart` | +| | or | | -------------------------------------------------- | ----------------------------------- | -| `Axes` -> `NumericXAxis` -> `Interval` | `XAxisInterval` (Major Interval) | -| `Axes` -> `NumericYAxis` -> `Interval` | `YAxisInterval` (Major Interval) | -| `Axes` -> `NumericXAxis` -> `MinorInterval` | `XAxisMinorInterval` | -| `Axes` -> `NumericYAxis` -> `MinorInterval` | `YAxisMinorInterval` | -| `Axes` -> `NumericXAxis` -> `MajorStroke` | `XAxisMajorStroke` | -| `Axes` -> `NumericYAxis` -> `MajorStroke` | `YAxisMajorStroke` | -| `Axes` -> `NumericXAxis` -> `MajorStrokeThickness` | `XAxisMajorStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `MajorStrokeThickness` | `YAxisMajorStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `MinorStrokeThickness` | `XAxisMinorStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `MinorStrokeThickness` | `YAxisMinorStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `StrokeThickness` | `XAxisStrokeThickness` | -| `Axes` -> `NumericYAxis` -> `StrokeThickness` | `YAxisStrokeThickness` | -| `Axes` -> `NumericXAxis` -> `Stroke` | `XAxisStroke` (Axis Line Color) | -| `Axes` -> `NumericYAxis` -> `Stroke` | `YAxisStroke` (Axis Line Color) | -| `Axes` -> `NumericXAxis` -> `TickLength` | `XAxisTickLength` | -| `Axes` -> `NumericYAxis` -> `TickLength` | `YAxisTickLength` | -| `Axes` -> `NumericXAxis` -> `TickStroke` | `XAxisTickStroke` | -| `Axes` -> `NumericYAxis` -> `TickStroke` | `YAxisTickStroke` | -| `Axes` -> `NumericXAxis` -> `Strip` | `XAxisStrip` (Space between Major Gridlines) | -| `Axes` -> `NumericYAxis` -> `Strip` | `YAxisStrip` (Space between Major Gridlines) | +| -> -> | (Major Interval) | +| -> -> | (Major Interval) | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | (Axis Line Color) | +| -> -> | (Axis Line Color) | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | | +| -> -> | (Space between Major Gridlines) | +| -> -> | (Space between Major Gridlines) | diff --git a/docs/xplat/src/content/en/components/charts/features/chart-axis-layouts.mdx b/docs/xplat/src/content/en/components/charts/features/chart-axis-layouts.mdx index 81f1b76d42..ca7723a0b6 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-axis-layouts.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-axis-layouts.mdx @@ -10,19 +10,21 @@ import PlatformBlock from 'igniteui-astro-components/components/mdx/PlatformBloc import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} Axis Layouts All {ProductName} charts include options to configure many axis layout options such as location as well as having the ability to share axis between series or have multiple axes in the same chart. These features are demonstrated in the examples given below. -the following examples can be applied to `CategoryChart` as well as `FinancialChart` controls. +the following examples can be applied to as well as controls. ## Axis Locations Example -For all axes, you can specify axis location in relationship to chart plot area. The `XAxisLabelLocation` property of the {Platform} charts, allows you to position x-axis line and its labels on above or below plot area. Similarly, you can use the `YAxisLabelLocation` property to position y-axis on left side or right side of plot area. +For all axes, you can specify axis location in relationship to chart plot area. The property of the {Platform} charts, allows you to position x-axis line and its labels on above or below plot area. Similarly, you can use the property to position y-axis on left side or right side of plot area. -The following example depicts the amount of renewable electricity produced since 2009, represented by a [Line Chart](../types/line-chart.md). There is a drop-down that lets you configure the `YAxisLabelLocation` so that you can visualize what the axes look like when the labels are placed on the left or right side on the inside or outside of the chart's plot area. +The following example depicts the amount of renewable electricity produced since 2009, represented by a [Line Chart](../types/line-chart.md). There is a drop-down that lets you configure the so that you can visualize what the axes look like when the labels are placed on the left or right side on the inside or outside of the chart's plot area. @@ -37,11 +39,11 @@ e.g. https://www.infragistics.com/help/wpf/datachart-axis-orientation ## Axis Advanced Scenarios -For more advanced axis layout scenarios, you can use {Platform} Data Chart to share axis, add multiple y-axis and/or x-axis in the same plot area, or even cross axes at specific values. The following examples show how to use these features of the `DataChart`. +For more advanced axis layout scenarios, you can use {Platform} Data Chart to share axis, add multiple y-axis and/or x-axis in the same plot area, or even cross axes at specific values. The following examples show how to use these features of the . ### Axis Sharing Example -You can share and add multiple axes in the same plot area of the {Platform} `DataChart`. It a common scenario to use share `TimeXAxis` and add multiple `NumericYAxis` to plot many data sources that have wide range of values (e.g. stock prices and stock trade volumes). +You can share and add multiple axes in the same plot area of the {Platform} . It a common scenario to use share and add multiple to plot many data sources that have wide range of values (e.g. stock prices and stock trade volumes). The following example depicts a stock price and trade volume chart with a [Stock Chart](../types/stock-chart.md) and a [Column Chart](../types/column-chart.md) plotted. In this case, the Y-Axis on the left is used by the [Column Chart](../types/column-chart.md) and the Y-Axis on the right is used by the [Stock Chart](../types/stock-chart.md), while the X-Axis is shared between the two. @@ -54,7 +56,7 @@ The following example depicts a stock price and trade volume chart with a [Stock ### Axis Crossing Example -In addition to placing axes outside plot area, the {Platform} `DataChart` also provides options to position axes inside of plot area and make them cross at specific values. For example, you can create trigonometric chart by setting `CrossingAxis` and `CrossingValue` properties on both x-axis and y-axis to render axis lines and axis labels such that they are crossing at (0, 0) origin point. +In addition to placing axes outside plot area, the {Platform} also provides options to position axes inside of plot area and make them cross at specific values. For example, you can create trigonometric chart by setting and properties on both x-axis and y-axis to render axis lines and axis labels such that they are crossing at (0, 0) origin point. The following example shows a Sin and Cos wave represented by a [Scatter Spline Chart](../types/scatter-chart.md) with the X and Y axes crossing each other at the (0, 0) origin point. @@ -71,7 +73,7 @@ The following example shows a Sin and Cos wave represented by a [Scatter Spline ### Axis Timeline Example -The following example demonstrates how to style the data chart using the `TimeXAxis` as a timeline: +The following example demonstrates how to style the data chart using the as a timeline: @@ -97,25 +99,25 @@ The following is a list of API members mentioned in the above sections: d in the above sections: -| `DataChart` | `CategoryChart` | +| | | | ------------------------------------------------------ | ------------------------------- | -| `Axes` -> `NumericYAxis` -> `CrossingAxis` | None | -| `Axes` -> `NumericYAxis` -> `CrossingValue` | None | -| `Axes` -> `NumericXAxis` -> `IsInverted` | `XAxisInverted` | -| `Axes` -> `NumericYAxis` -> `IsInverted` | `YAxisInverted` | -| `Axes` -> `NumericYAxis` -> `LabelLocation` | `YAxisLabelLocation` | -| `Axes` -> `NumericXAxis` -> `LabelLocation` | `XAxisLabelLocation` | -| `Axes` -> `NumericYAxis` -> `LabelHorizontalAlignment` | `YAxisLabelHorizontalAlignment` | -| `Axes` -> `NumericXAxis` -> `LabelVerticalAlignment` | `XAxisLabelVerticalAlignment` | -| `Axes` -> `NumericYAxis` -> `LabelVisibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `LabelVisibility` | `XAxisLabelVisibility` | +| -> -> | None | +| -> -> | None | +| -> -> | | +| -> -> | | +| -> -> `LabelLocation` | | +| -> -> `LabelLocation` | | +| -> -> `LabelHorizontalAlignment` | | +| -> -> `LabelVerticalAlignment` | | +| -> -> `LabelVisibility` | | +| -> -> `LabelVisibility` | | {/* TODO correct links in Transformer */} {/* -| `Axes` -> `NumericYAxis` -> `labelSettings.location` | `YAxisLabelLocation` | -| `Axes` -> `NumericXAxis` -> `labelSettings.location` | `XAxisLabelLocation` | -| `Axes` -> `NumericYAxis` -> `labelSettings.horizontalAlignment` | `YAxisLabelHorizontalAlignment` | -| `Axes` -> `NumericXAxis` -> `labelSettings.verticalAlignment` | `XAxisLabelVerticalAlignment` | -| `Axes` -> `NumericYAxis` -> `labelSettings.visibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `labelSettings.visibility` | `XAxisLabelVisibility` | */} +| -> -> `labelSettings.location` | | +| -> -> `labelSettings.location` | | +| -> -> `labelSettings.horizontalAlignment` | | +| -> -> `labelSettings.verticalAlignment` | | +| -> -> `labelSettings.visibility` | | +| -> -> `labelSettings.visibility` | | */} diff --git a/docs/xplat/src/content/en/components/charts/features/chart-axis-options.mdx b/docs/xplat/src/content/en/components/charts/features/chart-axis-options.mdx index 7d0491b3c1..1794f79635 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-axis-options.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-axis-options.mdx @@ -72,9 +72,9 @@ By default, charts will calculate the minimum and maximum values for the numeric In the and controls, you can choose if your data is plotted on logarithmic scale along the y-axis when the property is set to true or on linear scale when this property is set to false (default value). With the property, you can change base of logarithmic scale from default value of 10 to other integer value. -The and control allows you to choose how your data is represented along the y-axis using property that provides `Numeric` and `PercentChange` modes. The `Numeric` mode will plot data with the exact values while the `PercentChange` mode will display the data as percentage change relative to the first data point provided. The default value is `Numeric` mode. +The and control allows you to choose how your data is represented along the y-axis using property that provides and modes. The mode will plot data with the exact values while the mode will display the data as percentage change relative to the first data point provided. The default value is mode. -In addition to property, the control has property that provides `Time` and `Ordinal` modes for the x-axis. The `Time` mode will render space along the x-axis for gaps in data (e.g. no stock trading on weekends or holidays). The `Ordinal` mode will collapse date areas where data does not exist. The default value is `Ordinal` mode. +In addition to property, the control has property that provides and modes for the x-axis. The mode will render space along the x-axis for gaps in data (e.g. no stock trading on weekends or holidays). The mode will collapse date areas where data does not exist. The default value is mode. @@ -124,20 +124,20 @@ You can find more information about related chart features in these topics: The following is a list of API members mentioned in the above sections: -| `DataChart` | `FinancialChart` | `CategoryChart` | +| | | | | ------------------------------------------------------ | ---------------------- | ---------------------- | -| `Axes` -> `NumericYAxis` -> `MaximumValue` | `YAxisMaximumValue` | `YAxisMaximumValue` | -| `Axes` -> `NumericYAxis` -> `MinimumValue` | `YAxisMinimumValue` | `YAxisMinimumValue` | -| `Axes` -> `NumericYAxis` -> `IsLogarithmic` | `YAxisIsLogarithmic` | `YAxisIsLogarithmic` | -| `Axes` -> `NumericYAxis` -> `LogarithmBase` | `YAxisLogarithmBase` | `YAxisLogarithmBase` | -| `Axes` -> `CategoryXAxis` -> `Gap` | None | `XAxisGap` | -| `Axes` -> `CategoryXAxis` -> `Overlap` | None | `XAxisOverlap` | -| `Axes` -> `TimeXAxis` | `XAxisMode` | None | -| `Axes` -> `PercentChangeYAxis` | `YAxisMode` | None | -| `Axes` -> `NumericYAxis` -> `labelSettings.angle` | `YAxisLabelAngle` | `YAxisLabelAngle` | -| `Axes` -> `NumericXAxis` -> `labelSettings.angle` | `XAxisLabelAngle` | `XAxisLabelAngle` | -| `Axes` -> `NumericYAxis` -> `labelSettings.textColor` | `YAxisLabelForeground` | `YAxisLabelForeground` | -| `Axes` -> `NumericXAxis` -> `labelSettings.textColor` | `XAxisLabelForeground` | `XAxisLabelForeground` | -| `Axes` -> `NumericYAxis` -> `labelSettings.visibility` | `YAxisLabelVisibility` | `YAxisLabelVisibility` | -| `Axes` -> `NumericXAxis` -> `labelSettings.visibility` | `XAxisLabelVisibility` | `XAxisLabelVisibility` | +| -> -> | | | +| -> -> | | | +| -> -> | | | +| -> -> | | | +| -> -> | None | | +| -> -> | None | | +| -> | | None | +| -> | | None | +| -> -> `labelSettings.angle` | | | +| -> -> `labelSettings.angle` | | | +| -> -> `labelSettings.textColor` | `YAxisLabelForeground` | `YAxisLabelForeground` | +| -> -> `labelSettings.textColor` | `XAxisLabelForeground` | `XAxisLabelForeground` | +| -> -> `labelSettings.visibility` | | | +| -> -> `labelSettings.visibility` | | | diff --git a/docs/xplat/src/content/en/components/charts/features/chart-axis-types.mdx b/docs/xplat/src/content/en/components/charts/features/chart-axis-types.mdx index 6feed3edc7..3987b4564d 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-axis-types.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-axis-types.mdx @@ -9,150 +9,154 @@ namespace: Infragistics.Controls.Charts import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} Axis Types -The {ProductName} Category Chart uses only one `CategoryXAxis` and one `NumericYAxis` type. Similarly, {ProductName} Financial Chart uses only one `TimeXAxis` and one `NumericYAxis` types. However, the {ProductName} Data Chart provides support for multiple axis types that you can position on any side of the chart by setting [axis location](chart-axis-layouts.md#axis-locations-example) or even inside of the chart by using [axis crossing](chart-axis-layouts.md#axis-crossing-example) properties. This topic goes over each one, which axes and series are compatible with each other, and some specific properties to the unique axes. +The {ProductName} Category Chart uses only one and one type. Similarly, {ProductName} Financial Chart uses only one and one types. However, the {ProductName} Data Chart provides support for multiple axis types that you can position on any side of the chart by setting [axis location](chart-axis-layouts.md#axis-locations-example) or even inside of the chart by using [axis crossing](chart-axis-layouts.md#axis-crossing-example) properties. This topic goes over each one, which axes and series are compatible with each other, and some specific properties to the unique axes. ## Cartesian Axes -The `DataChart` with Cartesian Axes, allows you to plot data in horizontal (X-axis) and vertical (X-axis) direction with 3 types of X-Axis -(`CategoryXAxis`, `NumericXAxis`, and `TimeXAxis`) and 2 types of Y-Axis (`CategoryYAxis` and `NumericYAxis`). +The with Cartesian Axes, allows you to plot data in horizontal (X-axis) and vertical (X-axis) direction with 3 types of X-Axis +(, , and ) and 2 types of Y-Axis ( and ). ### Category X-Axis -The `CategoryXAxis` treats its data as a sequence of categorical data items. It can display almost any type of data including strings and numbers. If you are plotting numbers on this axis, it is important to keep in mind that this axis is a discrete axis and not continuous. This means that each categorical data item will be placed equidistant from the one before it. The items will also be plotted in the order that they appear in the axis' data source. +The treats its data as a sequence of categorical data items. It can display almost any type of data including strings and numbers. If you are plotting numbers on this axis, it is important to keep in mind that this axis is a discrete axis and not continuous. This means that each categorical data item will be placed equidistant from the one before it. The items will also be plotted in the order that they appear in the axis' data source. -The `CategoryXAxis` requires you to provide a `DataSource` and a `Label` in order to plot data with it. It is generally used with the `NumericYAxis` to plot the following type of series: +The requires you to provide a `DataSource` and a in order to plot data with it. It is generally used with the to plot the following type of series: | Category Series | Stacked Series | Financial Series | |------------------|----------------|--------------------| -| - `AreaSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries` | - `StackedAreaSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`



| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`



| +| -
-
-
-
-
-
-
-
-
-
- | -
-
-
-
-
-
-
-



| -
-
-
-
-
-
-
-



| - The following example demonstrates usage of the `CategoryXAxis` type: + The following example demonstrates usage of the type: ### Category Y-Axis -The `CategoryYAxis` works very similarly to the `CategoryXAxis` described above, but it is placed vertically rather than horizontally. Also, this axis requires you to provide a `DataSource` and a `Label` in order to plot data with it. The `CategoryYAxis` is generally used with the `NumericXAxis` to plot the following type of series: +The works very similarly to the described above, but it is placed vertically rather than horizontally. Also, this axis requires you to provide a `DataSource` and a in order to plot data with it. The is generally used with the to plot the following type of series: -- `BarSeries` -- `StackedBarSeries` -- `Stacked100BarSeries` +- +- `RangeBarSeries` +- +- - The following example demonstrates usage of the `CategoryYAxis` type: + The following example demonstrates usage of the type: ### Numeric X-Axis -The `NumericXAxis` treats its data as continuously varying numerical data items. Labels on this axis are placed horizontally along the X-Axis. The location of the `NumericXAxis` labels depends on the `XMemberPath` property of the various [Scatter Series](../types/scatter-chart.md) that it supports if combined with a `NumericYAxis`. Alternatively, if combined with the `CategoryXAxis`, these labels will be placed corresponding to the `ValueMemberPath` of the `BarSeries`, `StackedBarSeries`, and `Stacked100BarSeries`. +The treats its data as continuously varying numerical data items. Labels on this axis are placed horizontally along the X-Axis. The location of the labels depends on the property of the various [Scatter Series](../types/scatter-chart.md) that it supports if combined with a . Alternatively, if combined with the , these labels will be placed corresponding to the of the , `RangeBarSeries`, , and . -The `NumericXAxis` is compatible with the following type of series: +The is compatible with the following type of series: -- `BarSeries` -- `BubbleSeries` -- `HighDensityScatterSeries` -- `ScatterSeries` -- `ScatterLineSeries` -- `ScatterSplineSeries` -- `ScatterAreaSeries` -- `ScatterContourSeries` -- `ScatterPolylineSeries` -- `ScatterPolygonSeries` -- `StackedBarSeries` -- `Stacked100BarSeries` +- +- `RangeBarSeries` +- +- +- +- +- +- +- +- +- +- +- - The following example demonstrates usage of the `NumericXAxis`: + The following example demonstrates usage of the : ### Numeric Y-Axis -The `NumericYAxis` treats its data as continuously varying numerical data items. Labels on this axis are placed vertically along the Y-Axis. The location of the `NumericYAxis` labels depends on the `YMemberPath` property of the various [ScatterSeries](../types/scatter-chart.md) that is supports if combined with a `NumericXAxis`. Alternatively, if combined with the `CategoryYAxis`, these labels will be placed corresponding to the `ValueMemberPath` of the category or stacked series mentioned in the table above. If you are using one of the financial series, they will be placed corresponding to the Open/High/Low/Close paths and the series type that you are using. +The treats its data as continuously varying numerical data items. Labels on this axis are placed vertically along the Y-Axis. The location of the labels depends on the property of the various [ScatterSeries](../types/scatter-chart.md) that is supports if combined with a . Alternatively, if combined with the , these labels will be placed corresponding to the of the category or stacked series mentioned in the table above. If you are using one of the financial series, they will be placed corresponding to the Open/High/Low/Close paths and the series type that you are using. -The `NumericYAxis` is compatible with the following type of series: +The is compatible with the following type of series: | Category Series | Stacked Series | Financial Series | Scatter Series | |------------------|----------------|------------------|----------------| -| - `AreaSeries`
- `ColumnSeries`
- `LineSeries`
- `PointSeries`
- `SplineSeries`
- `SplineAreaSeries`
- `StepLineSeries`
- `StepAreaSeries`
- `RangeAreaSeries`
- `RangeColumnSeries`
- `WaterfallSeries`
| - `StackedAreaSeries`
- `StackedColumnSeries`
- `StackedLineSeries`
- `StackedSplineSeries`
- `Stacked100AreaSeries`
- `Stacked100ColumnSeries`
- `Stacked100LineSeries`
- `Stacked100SplineSeries`
| - `FinancialPriceSeries`
- `BollingerBandsOverlay`
- `ForceIndexIndicator`
- `MedianPriceIndicator`
- `MassIndexIndicator`
- `RelativeStrengthIndexIndicator`
- `StandardDeviationIndicator`
- `TypicalPriceIndicator`
| - `BubbleSeries`
- `HighDensityScatterSeries`
- `ScatterSeries`
- `ScatterLineSeries`
- `ScatterSplineSeries`
- `ScatterAreaSeries`
- `ScatterContourSeries`
- `ScatterPolylineSeries`
- `ScatterPolygonSeries`
| +| -
-
-
-
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
| -
-
-
-
-
-
-
-
-
| - The following example demonstrates usage of the `NumericYAxis`: + The following example demonstrates usage of the : ### Time X Axis -The `TimeXAxis` treats its data as a sequence of data items, sorted by date. Labels on this axis type are dates and can be formatted and arranged according to date intervals. The date range of this axis is determined by the date values in a data column that is mapped using its `DateTimeMemberPath`. This, along with a `DataSource` is required to plot data with this axis type. +The treats its data as a sequence of data items, sorted by date. Labels on this axis type are dates and can be formatted and arranged according to date intervals. The date range of this axis is determined by the date values in a data column that is mapped using its . This, along with a `DataSource` is required to plot data with this axis type. -The `TimeXAxis` is the X-Axis type in the `FinancialChart` component. +The is the X-Axis type in the component. #### Breaks in Time X Axis -The `TimeXAxis` has the option to exclude intervals of data by using `Breaks`. As a result, the labels and plotted data will not appear at the excluded interval. For example, working/non-working days, holidays, and/or weekends. An instance of `TimeAxisBreak` can be added to the `Breaks` collection of the axis and configured by using a unique `Start`, `End` and `Interval`. +The has the option to exclude intervals of data by using . As a result, the labels and plotted data will not appear at the excluded interval. For example, working/non-working days, holidays, and/or weekends. An instance of can be added to the collection of the axis and configured by using a unique , and . #### Formatting in Time X Axis -The `TimeXAxis` has the `LabelFormats` property, which represents a collection of `TimeAxisLabelFormat` objects. Each `TimeAxisLabelFormat` added to the collection is responsible for assigning a unique `Format` and `Range`. This can be especially useful for drilling down data from years to milliseconds and adjusting the labels depending on the range of time shown by the chart. +The has the property, which represents a collection of objects. Each added to the collection is responsible for assigning a unique and . This can be especially useful for drilling down data from years to milliseconds and adjusting the labels depending on the range of time shown by the chart. -The `Format` property of the `TimeAxisLabelFormat` specifies what format to use for a particular visible range. The `Range` property of the `TimeAxisLabelFormat` specifies the visible range at which the axis label formats will switch to a different format. For example, if you have two `TimeAxisLabelFormat` elements with a range set to 10 days and another set to 5 hours, then as soon as the visible range of the axis becomes less than 10 days, it will switch to 5-hour format. +The property of the specifies what format to use for a particular visible range. The property of the specifies the visible range at which the axis label formats will switch to a different format. For example, if you have two elements with a range set to 10 days and another set to 5 hours, then as soon as the visible range of the axis becomes less than 10 days, it will switch to 5-hour format. #### Intervals in Time X Axis -The `TimeXAxis` replaces the conventional `Interval` property of the category and numeric axes with an `Intervals` collection of type `TimeAxisInterval`. Each `TimeAxisInterval` added to the collection is responsible for assigning a unique `Interval`, `Range` and `IntervalType`. This can be especially useful for drilling down data from years to milliseconds to provide unique spacing between labels depending on the range of time shown by the chart. A description of these properties is below: +The replaces the conventional property of the category and numeric axes with an collection of type . Each added to the collection is responsible for assigning a unique , and . This can be especially useful for drilling down data from years to milliseconds to provide unique spacing between labels depending on the range of time shown by the chart. A description of these properties is below: -- `Interval`: This specifies the interval to use. This is tied to the `IntervalType` property. For example, if the `IntervalType` is set to `Days`, then the numeric value specified in `Interval` will be in days. -- `Range`: This specifies the visible range at which the axis interval will switch to a different interval. For example, if you have two TimeAxisInterval with a range set to 10 days and another set to 5 hours, as soon as the visible range in the axis becomes less than 10 days it will switch to the interval whose range is 5 hours. -- `IntervalType`: This specifies the unit of time for the `Interval` property. +- : This specifies the interval to use. This is tied to the property. For example, if the is set to `Days`, then the numeric value specified in will be in days. +- : This specifies the visible range at which the axis interval will switch to a different interval. For example, if you have two TimeAxisInterval with a range set to 10 days and another set to 5 hours, as soon as the visible range in the axis becomes less than 10 days it will switch to the interval whose range is 5 hours. +- : This specifies the unit of time for the property. ## Polar Axes -The `DataChart` with Polar Axes, allows you to plot data outwards (radius axis) from center of the chart and around (angle axis) of center of the chart. +The with Polar Axes, allows you to plot data outwards (radius axis) from center of the chart and around (angle axis) of center of the chart. ### Category Angle Axis -The `CategoryAngleAxis` treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. +The treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. -The `CategoryAngleAxis` is generally used with the `NumericRadiusAxis` to plot [Radial Series](../types/radial-chart.md). +The is generally used with the to plot [Radial Series](../types/radial-chart.md). -The following example demonstrates usage of the `CategoryAngleAxis` type: +The following example demonstrates usage of the type: ### Proportional Category Angle Axis -The `ProportionalCategoryAngleAxis` treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. +The treats its data as a sequence of category data items. The labels on this axis are placed along the edge of a circle according to their position in that sequence. This type of axis can display almost any type of data including strings and numbers. -The `ProportionalCategoryAngleAxis` is generally used with the `NumericRadiusAxis` to plot a pie chart eg. [Radial Series](../types/radial-chart.md). +The is generally used with the to plot a pie chart eg. [Radial Series](../types/radial-chart.md). -The following example demonstrates usage of the `ProportionalCategoryAngleAxis` type: +The following example demonstrates usage of the type: ### Numeric Angle Axis -The `NumericAngleAxis` treats its data as continuously varying numerical data items. The labels on this axis area placed along a radius line starting from the center of the circular plot. The location of the labels on the `NumericAngleAxis` varies according to the value in the data column mapped using the `RadiusMemberPath` property of the [Polar Series](../types/polar-chart.md) object or the `ValueMemberPath` property of the [Radial Series](../types/radial-chart.md) object. +The treats its data as continuously varying numerical data items. The labels on this axis area placed along a radius line starting from the center of the circular plot. The location of the labels on the varies according to the value in the data column mapped using the property of the [Polar Series](../types/polar-chart.md) object or the property of the [Radial Series](../types/radial-chart.md) object. -The The `NumericAngleAxis` can be used with either the `CategoryAngleAxis` to plot [Radial Series](../types/radial-chart.md) or with the `NumericRadiusAxis` to plot [Polar Series](../types/polar-chart.md) respectively. +The The can be used with either the to plot [Radial Series](../types/radial-chart.md) or with the to plot [Polar Series](../types/polar-chart.md) respectively. -The following example demonstrates usage of the `NumericAngleAxis` type: +The following example demonstrates usage of the type: ### Numeric Radius Axis -The `NumericRadiusAxis` treats the data as continuously varying numerical data items. The labels on this axis are placed around the circular plot. The location of the labels varies according to the value in a data column mapped using the `AngleMemberPath` property of the corresponding polar series. +The treats the data as continuously varying numerical data items. The labels on this axis are placed around the circular plot. The location of the labels varies according to the value in a data column mapped using the `AngleMemberPath` property of the corresponding polar series. -The `NumericRadiusAxis` can be used with the `NumericRadiusAxis` to plot [Polar Series](../types/polar-chart.md). +The can be used with the to plot [Polar Series](../types/polar-chart.md). -The following example demonstrates usage of the `NumericRadiusAxis` type: +The following example demonstrates usage of the type: diff --git a/docs/xplat/src/content/en/components/charts/features/chart-data-annotations.mdx b/docs/xplat/src/content/en/components/charts/features/chart-data-annotations.mdx index 3793bd717b..e558fa365d 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-data-annotations.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-data-annotations.mdx @@ -11,6 +11,8 @@ import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} Chart Data Annotations In the {Platform} chart, the data annotation layers allow you to annotate data plotted in Data Chart with sloped lines, vertical/horizontal lines (aka axis slices), vertical/horizontal strips (targeting specific axis), rectangles, and even parallelograms (aka bands). With data-binding supported, you can create as many annotations as you want to customize your charts. Also, you can combine different annotation layers and you can overlay text inside of plot area to annotated important events, patterns, and regions in your data. @@ -28,7 +30,7 @@ Like this sample? Get access to our complete {Platform} toolkit and start buildi ## {Platform} Data Annotation Slice Layer Example -In {Platform}, the `DataAnnotationSliceLayer` renders multiple vertical or horizontal lines that slice the chart at multiple values of an axis in the `DataChart` component. This data annotation layer is often used to annotate important events (e.g. company quarter reports) on x-axis or important values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal slices or setting TargetAxis property to x-axis will render data annotation layer as vertical slices. Similarly to all series, the DataAnnotationSliceLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the `AnnotationValueMemberPath` property. +In {Platform}, the renders multiple vertical or horizontal lines that slice the chart at multiple values of an axis in the component. This data annotation layer is often used to annotate important events (e.g. company quarter reports) on x-axis or important values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal slices or setting TargetAxis property to x-axis will render data annotation layer as vertical slices. Similarly to all series, the DataAnnotationSliceLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the property. For example, you can use DataAnnotationSliceLayer to annotate stock prices with important events such as stock split and outcome of earning reports. @@ -39,9 +41,9 @@ For example, you can use DataAnnotationSliceLayer to annotate stock prices with ## {Platform} Data Annotation Strip Layer Example -In {Platform}, the `DataAnnotationStripLayer` renders multiple vertical or horizontal strips between 2 values on an axis in the `DataChart` component. This data annotation layer can be used to annotate duration of events (e.g. stock market crash) on x-axis or important range of values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal strips or setting TargetAxis property to x-axis will render data annotation layer as vertical strips. Similarly to all series, the `DataAnnotationStripLayer` also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the AnnotationValueMemberPath property. +In {Platform}, the renders multiple vertical or horizontal strips between 2 values on an axis in the component. This data annotation layer can be used to annotate duration of events (e.g. stock market crash) on x-axis or important range of values on y-axis. Setting the TargetAxis property to y-axis will render data annotation layer as horizontal strips or setting TargetAxis property to x-axis will render data annotation layer as vertical strips. Similarly to all series, the also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 1 numeric data column mapped to the AnnotationValueMemberPath property. -For example, you can use `DataAnnotationStripLayer` to annotate chart with stock market crashes and changes in federal interest rates. +For example, you can use to annotate chart with stock market crashes and changes in federal interest rates. @@ -50,7 +52,7 @@ For example, you can use `DataAnnotationStripLayer` to annotate chart with stock ## {Platform} Data Annotation Line Layer Example -In {Platform}, `DataAnnotationLineLayer` renders multiple lines between 2 points in plot area of the `DataChart` component. This data annotation layer can be used to annotate stock chart with growth and decline in stock prices. Similarly to all series, the DataAnnotationLineLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using using `StartValueXMemberPath` and `StartValueYMemberPath` properties and the ending points should be mapped using `EndValueXMemberPath` and `EndValueYMemberPath` properties. +In {Platform}, renders multiple lines between 2 points in plot area of the component. This data annotation layer can be used to annotate stock chart with growth and decline in stock prices. Similarly to all series, the DataAnnotationLineLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using using and properties and the ending points should be mapped using and properties. For example, you can use DataAnnotationLineLayer to annotate growth and decline patterns in stock prices and 52-week high and low of stock prices on y-axis. @@ -61,7 +63,7 @@ For example, you can use DataAnnotationLineLayer to annotate growth and decline ## {Platform} Data Annotation Rect Layer Example -In {Platform}, the `DataAnnotationRectLayer` renders multiple rectangles defined by starting and ending points in plot area of the `DataChart` component. This data annotation layer can be used to annotate region of plot area such as bearish patterns in stock prices. Similarly to all series, the DataAnnotationRectLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the rectangles. The starting points should be mapped using using `StartValueXMemberPath` and `StartValueYMemberPath` properties and the ending points should be mapped using `EndValueXMemberPath` and `EndValueYMemberPath` properties. +In {Platform}, the renders multiple rectangles defined by starting and ending points in plot area of the component. This data annotation layer can be used to annotate region of plot area such as bearish patterns in stock prices. Similarly to all series, the DataAnnotationRectLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the rectangles. The starting points should be mapped using using and properties and the ending points should be mapped using and properties. For example, you can use DataAnnotationRectLayer to annotate bearish patterns and gaps in stock prices on y-axis. @@ -72,7 +74,7 @@ For example, you can use DataAnnotationRectLayer to annotate bearish patterns an ## {Platform} Data Annotation Band Layer Example -In {Platform}, the `DataAnnotationBandLayer` renders multiple skewed rectangles (free-form parallelogram) between 2 points in plot area of the `DataChart` component. This data annotation layer can be used to annotate range of growth and decline in stock prices. Similarly to all series, the DataAnnotationBandLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using `StartValueXMemberPath` and `StartValueYMemberPath` properties and the ending points should be mapped using `EndValueXMemberPath` and `EndValueYMemberPath` properties. In addition, you can specify thickness/size of the skewed rectangle by binding numeric data column to the AnnotationBreadthMemberPath property. +In {Platform}, the renders multiple skewed rectangles (free-form parallelogram) between 2 points in plot area of the component. This data annotation layer can be used to annotate range of growth and decline in stock prices. Similarly to all series, the DataAnnotationBandLayer also supports data binding via the `DataSource` property that can be set to a collection of data items which should have at least 4 numeric data columns representing x/y coordinates of starting point and ending point of the lines. The starting points should be mapped using and properties and the ending points should be mapped using and properties. In addition, you can specify thickness/size of the skewed rectangle by binding numeric data column to the AnnotationBreadthMemberPath property. For example, you can use DataAnnotationBandLayer to annotate range of growth in stock prices. @@ -85,14 +87,14 @@ For example, you can use DataAnnotationBandLayer to annotate range of growth in The following is a list of API members mentioned in the above sections: -- `TargetAxis`: This property specifies which axis should have an enabled DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property specifies which axis should have an enabled DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. - `DataSource`: This property binds data to the annotation layer to provide the precise shape. -- `StartValueXMemberPath`: This property is a mapping to the name of the data column with x-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `StartValueYMemberPath`: This property is a mapping to the name of data column with y-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `EndValueXMemberPath`: This property is a mapping to the data column with x-positions for the end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `EndValueYMemberPath`: This property is a mapping to the data column with y-positions for end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. -- `StartLabelXMemberPath`: This property is a mapping to the data column representing the overlay label for the starting position of the xAxis along the axis. -- `StartLabelXDisplayMode` | `StartLabelYDisplayMode` | `EndLabelXDisplayMode` | `EndLabelYDisplayMode` | `CenterLabelXDisplayMode`: These properties specify what should annotation labels display on starting, ending, or center of the annotation shape, e.g. mapped data value, mapped data label, axis value, or hide a given annotation label. -- `StartLabelYMemberPath`: This property is a mapping to the data column representing the axis label for the starting position of `DataAnnotationBandLayer`, `DataAnnotationLineLayer`, `DataAnnotationRectLayer` on the y-axis. -- `EndLabelYMemberPath`: This property is a mapping to the data column representing the axis label for the ending position of `DataAnnotationBandLayer`, `DataAnnotationLineLayer`, `DataAnnotationRectLayer` on the y-axis. +- : This property is a mapping to the name of the data column with x-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the name of data column with y-positions for the start of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the data column with x-positions for the end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the data column with y-positions for end of the DataAnnotationBandLayer, DataAnnotationLineLayer, DataAnnotationRectLayer. +- : This property is a mapping to the data column representing the overlay label for the starting position of the xAxis along the axis. +- | | | | : These properties specify what should annotation labels display on starting, ending, or center of the annotation shape, e.g. mapped data value, mapped data label, axis value, or hide a given annotation label. +- : This property is a mapping to the data column representing the axis label for the starting position of , , on the y-axis. +- : This property is a mapping to the data column representing the axis label for the ending position of , , on the y-axis. diff --git a/docs/xplat/src/content/en/components/charts/features/chart-data-legend.mdx b/docs/xplat/src/content/en/components/charts/features/chart-data-legend.mdx index 168ae02cf5..15b3577f4e 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-data-legend.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-data-legend.mdx @@ -15,37 +15,37 @@ import layoutMode from '@xplat-images/general/layout_mode.png'; # {Platform} Data Legend -In {ProductName}, the `DataLegend` is highly-customizable version of the `Legend`, that shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. This legend updates when moving the mouse inside of the plot area of the `CategoryChart`, `FinancialChart`, and `DataChart`. Also, it has a persistent state that remembers the last hovered point when the user's mouse pointer exits the plot area. It displays this content using a set of three type of rows (header, series, summary) and four types of columns (title, label, value, unit). +In {ProductName}, the is highly-customizable version of the , that shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. This legend updates when moving the mouse inside of the plot area of the , , and . Also, it has a persistent state that remembers the last hovered point when the user's mouse pointer exits the plot area. It displays this content using a set of three type of rows (header, series, summary) and four types of columns (title, label, value, unit). ## {Platform} Data Legend Rows -The rows of the `DataLegend` include the header row, series row(s), and the summary row. The header row displays the axis label of the point that is hovered, and can be changed using the `HeaderText` property. +The rows of the include the header row, series row(s), and the summary row. The header row displays the axis label of the point that is hovered, and can be changed using the property. ### Header Row -The header row displays the current label of x-axis when hovering mouse over category series and financial series. You can use `HeaderFormatDate` and `HeaderFormatTime` properties to format date and time in the `DataLegend` if the x-axis shows dates. For other types of series, the `DataLegend` does not render the header row. +The header row displays the current label of x-axis when hovering mouse over category series and financial series. You can use and properties to format date and time in the if the x-axis shows dates. For other types of series, the does not render the header row. ### Series Row -The series row represents each series plotted in the chart. These rows will display the legend badge, series title, actual/abbreviated value of the the series, and abbreviation symbol or unit of measurement, if specified. You can filter series rows by setting `IncludedSeries` or `ExcludedSeries` properties to a collection of series' indexes (1, 2, 3) or series' titles (Tesla, Microsoft). +The series row represents each series plotted in the chart. These rows will display the legend badge, series title, actual/abbreviated value of the the series, and abbreviation symbol or unit of measurement, if specified. You can filter series rows by setting or properties to a collection of series' indexes (1, 2, 3) or series' titles (Tesla, Microsoft). ### Summary Row -Finally, there is a summary row that displays the total of all series values. The default summary title can be changed using the `SummaryTitleText` property of the legend. Also, you can use the `SummaryType` property to customize whether you display the `Total`, `Min`, `Max`, or `Average` of series values in the summary row. +Finally, there is a summary row that displays the total of all series values. The default summary title can be changed using the property of the legend. Also, you can use the property to customize whether you display the , , , or of series values in the summary row. ## {Platform} Data Legend Columns -The columns of the `DataLegend` include the series title, label, value of data column, and optional unit associated with the value. Some series in the chart can have multiple columns for label, value, and units. For example, financial price series has **High**, **Low**, **Open**, and **Close** data columns which can be filtered in the `DataLegend` using the `IncludedColumns` or `ExcludedColumns` properties. +The columns of the include the series title, label, value of data column, and optional unit associated with the value. Some series in the chart can have multiple columns for label, value, and units. For example, financial price series has **High**, **Low**, **Open**, and **Close** data columns which can be filtered in the using the or properties. -Setting values on the `IncludedColumns` and `ExcludedColumns` properties, depends on type of series and how many data columns they support. For example, you can set `IncludedColumns` property to a collection of **Open** and **Close** strings and the legend will show only open and close values for stock prices when the chart is plotting financial series. The following table lists all column names that can be use to filter columns in data legend. +Setting values on the and properties, depends on type of series and how many data columns they support. For example, you can set property to a collection of **Open** and **Close** strings and the legend will show only open and close values for stock prices when the chart is plotting financial series. The following table lists all column names that can be use to filter columns in data legend. | Type of Series | Column Names | | -----------------|-------------- | @@ -61,20 +61,20 @@ Where the **TypicalPrice** and percentage **Change** of OHLC prices are automati ### Title Column -The title column displays legend badges and series titles, which come from the `Title` property of the different `Series` plotted in the chart. +The title column displays legend badges and series titles, which come from the property of the different plotted in the chart. ### Label Column -The label column displays short name on the left side of value column, e.g. "O" for **Open** stock price. You can toggle visibility of this column using the `LabelDisplayMode` property. +The label column displays short name on the left side of value column, e.g. "O" for **Open** stock price. You can toggle visibility of this column using the property. ### Value Column -The value column displays values of series as abbreviated text which can be formatted using the `ValueFormatAbbreviation` property to apply the same abbreviation for all numbers by setting this property to `Shared`. Alternatively, a user can select other abbreviations such as `Independent`, `Kilo`, `Million`, etc. Precision of abbreviated values is controlled using the `ValueFormatMinFractions` and `ValueFormatMaxFractions` for minimum and maximum digits, respectively. +The value column displays values of series as abbreviated text which can be formatted using the property to apply the same abbreviation for all numbers by setting this property to . Alternatively, a user can select other abbreviations such as , , , etc. Precision of abbreviated values is controlled using the and for minimum and maximum digits, respectively. ### Unit Column -The unit column displays an abbreviation symbol on the right side of value column. The unit symbol depends on the `ValueFormatAbbreviation` property, e.g. "M" for the `Million` abbreviation. +The unit column displays an abbreviation symbol on the right side of value column. The unit symbol depends on the property, e.g. "M" for the abbreviation. ### Customizing Columns @@ -88,11 +88,11 @@ You can customize text displayed in the **Label** and **Unit** columns using pr | Range Series | HighMemberAsLegendLabel="H:"
HighMemberAsLegendUnit="K"
LowMemberAsLegendLabel="L:"
LowMemberAsLegendUnit="K" | | Financial Series | OpenMemberAsLegendLabel="O:"
OpenMemberAsLegendUnit="K"
HighMemberAsLegendLabel="H:"
HighMemberAsLegendUnit="K"
LowMemberAsLegendLabel="L:"
LowMemberAsLegendUnit="K"
CloseMemberAsLegendLabel="C:"
CloseMemberAsLegendUnit="K"
| -Also, you can use the `UnitText` property on the `DataLegend` to change text displayed in all Unit columns. +Also, you can use the `UnitText` property on the to change text displayed in all Unit columns. ## Layout Mode -Legend items can be positioned in a vertical or table structure via the `LayoutMode` property. The default value is `Table`, which retains the same look and feel as seen in previous releases. +Legend items can be positioned in a vertical or table structure via the property. The default value is `Table`, which retains the same look and feel as seen in previous releases. eg. @@ -100,7 +100,7 @@ eg. ## {Platform} Data Legend Styling -The `DataLegend` provides properties for styling each type of column. Each of these properties begins with **Title**, **Label**, **Value**, or **Units**. You can style the text's color, font, and margin. For example, if you wanted to set the text color of all columns, you would set the `TitleTextColor`, `LabelTextColor`, `ValueTextColor`, and `UnitsTextColor` properties. The following example demonstrates a utilization of the styling properties mentioned above: +The provides properties for styling each type of column. Each of these properties begins with **Title**, **Label**, **Value**, or **Units**. You can style the text's color, font, and margin. For example, if you wanted to set the text color of all columns, you would set the , , , and properties. The following example demonstrates a utilization of the styling properties mentioned above: @@ -109,7 +109,7 @@ The `DataLegend` provides properties for styling each type of column. Each of th ## {Platform} Data Legend Value Formatting -The `DataLegend` provides automatic abbreviation of large numbers using its `ValueFormatAbbreviation` property. This adds a multiplier in the units column such as kilo, million, billion, etc. You can customize the number of fractional digits that are displayed by setting the `ValueFormatMinFractions` and `ValueFormatMaxFractions`. This will allow you to determine the minimum and maximum number of digits that appear after the decimal point, respectively. +The provides automatic abbreviation of large numbers using its property. This adds a multiplier in the units column such as kilo, million, billion, etc. You can customize the number of fractional digits that are displayed by setting the and . This will allow you to determine the minimum and maximum number of digits that appear after the decimal point, respectively. The following example demonstrates how to use those properties: @@ -119,7 +119,7 @@ The following example demonstrates how to use those properties: ## {Platform} Data Legend Value Mode -You have the ability to change the default decimal display of values within the `DataLegend` to a currency by changing the `ValueFormatMode` property. Also, you can change the culture of the displayed currency symbol by setting the `ValueFormatCulture` property a culture tag. For example, the following example data legend with the `ValueFormatCulture` set to "en-GB" to display British Pounds (£) symbol: +You have the ability to change the default decimal display of values within the to a currency by changing the property. Also, you can change the culture of the displayed currency symbol by setting the property a culture tag. For example, the following example data legend with the set to "en-GB" to display British Pounds (£) symbol: @@ -127,8 +127,8 @@ You have the ability to change the default decimal display of values within the ## {Platform} Data Legend Grouping -`DataLegendGroup` can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: -By default, DataLegend will hide names of groups, but you can display group names by setting the `GroupRowVisible` property to true. + can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: +By default, DataLegend will hide names of groups, but you can display group names by setting the property to true. @@ -140,21 +140,21 @@ Several properties are exposed including grouping portions of the legend. - `GroupRowMargin` - `GroupTextMargin` -- `GroupTextColor` +- - `GroupTextFontSize` - `GroupTextFontFamily` - `GroupTextFontStyle` - `GroupTextFontStretch` - `GroupTextFontWeight` - `HeaderTextMargin` -- `HeaderTextColor` +- - `HeaderTextFontSize` - `HeaderTextFontFamily` - `HeaderTextFontStyle` - `HeaderTextFontStretch` - `HeaderTextFontWeight` -The `DataLegend` has several events that fire when rendering their corresponding row, even during mouse interactions where the values are updating. These events are listed below with a description of what they are designed to be used for: +The has several events that fire when rendering their corresponding row, even during mouse interactions where the values are updating. These events are listed below with a description of what they are designed to be used for: - `StyleGroupRow`: This event fires for each group to style text displayed in group rows. - `StyleHeaderRow`: This event fires when rendering the header row. @@ -163,9 +163,9 @@ The `DataLegend` has several events that fire when rendering their corresponding - `StyleSummaryRow`: This event fires once when rendering the summary row. - `StyleSummaryColumn`: This event fires once when rendering the summary column. -Some of the events exposes a `DataLegendStylingRowEventArgs` parameter as its arguments, which lets you customize each item's text, text color, and the overall visibility of the row. The event arguments also expose event-specific properties. For example, since the `StyleSeriesRow` event fires for each series, the event arguments will return the series index and series title for the row that represents the series. +Some of the events exposes a parameter as its arguments, which lets you customize each item's text, text color, and the overall visibility of the row. The event arguments also expose event-specific properties. For example, since the `StyleSeriesRow` event fires for each series, the event arguments will return the series index and series title for the row that represents the series. -`StyleSummaryColumn` and `SeriesStyleColumn` events expose a `DataLegendStylingColumnEventArgs` parameter as its arguments, for customizing each field in the series. The event arguments also expose event-specific properties such as column index and value member related properties about the columns. +`StyleSummaryColumn` and `SeriesStyleColumn` events expose a parameter as its arguments, for customizing each field in the series. The event arguments also expose event-specific properties such as column index and value member related properties about the columns. diff --git a/docs/xplat/src/content/en/components/charts/features/chart-data-selection.mdx b/docs/xplat/src/content/en/components/charts/features/chart-data-selection.mdx index 981bbc44ca..1d26c02395 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-data-selection.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-data-selection.mdx @@ -10,13 +10,15 @@ namespace: Infragistics.Controls.Charts import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} Chart Selection The {ProductName} selection feature in {Platform} Data Chart allows users to interactively select, highlight, outline and vice-versa deselect single or multiple series within a chart. This provides many different possibilities with how users interact with the data presented in more meaningful ways. ## Configuring Selection -The default behavior `SelectionMode` turned off and requires opting into one of the following options. There are several selection modes available in the `DataChart`: +The default behavior turned off and requires opting into one of the following options. There are several selection modes available in the : - **Auto** - **None** @@ -32,10 +34,10 @@ The default behavior `SelectionMode` turned off and requires opting into one of - **ThickOutline** `Brighten` will fade the selected item while `FadeOthers` will cause the opposite effect occur. -`GrayscaleOthers` will behave similarly to `FadeOthers` but instead show a gray color to the rest of the series. Note this will override any `SelectionBrush` setting. +`GrayscaleOthers` will behave similarly to `FadeOthers` but instead show a gray color to the rest of the series. Note this will override any setting. `SelectionColorOutline` and `SelectionColorThickOutline` will draw a border around the series. -In conjunction, a `SelectionBehavior` is available to provide greater control on which items get selected. The default behavior for Auto is `PerSeriesAndDataItemMultiSelect`. +In conjunction, a is available to provide greater control on which items get selected. The default behavior for Auto is `PerSeriesAndDataItemMultiSelect`. - **Auto** - **PerDataItemMultiSelect** @@ -56,7 +58,7 @@ The following example shows the combination of both `SelectionColorFill` and `Au ## Configuring Multiple Selection -Other selection modes offer various methods of selection. For example using `SelectionBehavior` with `PerDataItemMultiSelect` will affect all series in entire category when multiple series are present while allowing selection across categories. Compared to `PerDataItemSingleSelect`, only a single category of items can be selected at a time. This is useful if multiple series are bound to different datasources and provides greater control of selection between categories. +Other selection modes offer various methods of selection. For example using with `PerDataItemMultiSelect` will affect all series in entire category when multiple series are present while allowing selection across categories. Compared to `PerDataItemSingleSelect`, only a single category of items can be selected at a time. This is useful if multiple series are bound to different datasources and provides greater control of selection between categories. `PerSeriesAndDataItemGlobalSingleSelect` allows single series selection across all categories at a time. @@ -64,19 +66,19 @@ Other selection modes offer various methods of selection. For example using `Sel ## Configuring Outline Selection -When `FocusBrush` is applied, selected series will appear with a border when the `SelectionMode` property is set to one of the focus options. +When is applied, selected series will appear with a border when the property is set to one of the focus options. ## Radial Series Selection -This example demonstrates another series type via the `DataChart` where each radial series can be selected with different colors. +This example demonstrates another series type via the where each radial series can be selected with different colors. ## Programmatic Selection -Chart Selection can also be configured in code where selected items in the chart can be seen on startup or runtime. This can be achieved by adding items to the `SelectedSeriesCollection` of the `CategoryChart`. The `Matcher` property of the `ChartSelection` object allows for selecting a series based on a "matcher", ideal when you do not have access to the actual series from the chart. If you know the properties that your datasource contains, you can use the `ValueMemberPath` that the series would be. +Chart Selection can also be configured in code where selected items in the chart can be seen on startup or runtime. This can be achieved by adding items to the `SelectedSeriesCollection` of the . The property of the object allows for selecting a series based on a "matcher", ideal when you do not have access to the actual series from the chart. If you know the properties that your datasource contains, you can use the `ValueMemberPath` that the series would be. -The matcher is ideal for using in charts, such as the `CategoryChart` when you do not have access to the actual series, like the `DataChart`. In this case you if you know the properties that your datasource contained you can surmise the ValueMemberPaths that the series would have. For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to highlight the series bound to Solar values, you can add a ChartSelection object to the `SelectedSeriesItems` collection using a matcher with the following properties set +The matcher is ideal for using in charts, such as the when you do not have access to the actual series, like the . In this case you if you know the properties that your datasource contained you can surmise the ValueMemberPaths that the series would have. For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to highlight the series bound to Solar values, you can add a ChartSelection object to the collection using a matcher with the following properties set For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar then you know there are series created for each of these properties. If you want to select the series bound to Solar values, you can add a ChartSelection object to the SelectedSeriesItems collection using a matcher with the following properties set. @@ -87,6 +89,6 @@ For example, if you datasource has numeric properties Nuclear, Coal, Oil, Solar The following is a list of API members mentioned in the above sections: -| `CategoryChart` Properties | `DataChart` Properties | +| Properties | Properties | | ----------------------------------------------|---------------------------| | | | diff --git a/docs/xplat/src/content/en/components/charts/features/chart-data-tooltip.mdx b/docs/xplat/src/content/en/components/charts/features/chart-data-tooltip.mdx index cc6ea3b8b0..4ae0ccfda9 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-data-tooltip.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-data-tooltip.mdx @@ -46,7 +46,7 @@ The following example demonstrates the data tooltip with a summary applied: The columns of the include the title, label, value, and units columns. Each series in the chart can have multiple columns for label, value, and units depending on the or collections of the chart. -The title column displays legend badges and series titles, which come from the `Title` property of the different `Series` plotted in the chart. +The title column displays legend badges and series titles, which come from the property of the different plotted in the chart. The label column displays the name or abbreviation of the different property paths in the or collections of the tooltip. @@ -83,8 +83,8 @@ The following example demonstrates a data tooltip with the added columns of Open ## {Platform} Data Tooltip Grouping for Data Chart -`DataLegendGroup` can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: -By default, DataLegend will hide names of groups, but you can display group names by setting the `GroupRowVisible` property to true. `GroupingMode` should be set to "Grouped" and `LabelDisplayMode` should be set to "Visible" on the Data Tooltip Layer. + can be set, on all types of series, to a string that will categorize a group of series in Data Legend. Each group will have its own summary row displayed before another group of series is displayed: +By default, DataLegend will hide names of groups, but you can display group names by setting the property to true. should be set to "Grouped" and should be set to "Visible" on the Data Tooltip Layer. @@ -119,7 +119,7 @@ You can change the default decimal display of values within the **DataToolTip** ## Layout Mode -Legend items can be positioned in a vertical or table structure via the `LayoutMode` property. The default value is `Table`, which retains the same look and feel as seen in previous releases. +Legend items can be positioned in a vertical or table structure via the property. The default value is `Table`, which retains the same look and feel as seen in previous releases. eg. @@ -138,14 +138,14 @@ The following example demonstrates usage of the styling properties mentioned abo Several properties are exposed including grouping portions of the tooltip. - `GroupTextMargin` -- `GroupTextColor` +- - `GroupTextFontSize` - `GroupTextFontFamily` - `GroupTextFontStyle` - `GroupTextFontStretch` - `GroupTextFontWeight` - `HeaderTextMargin` -- `HeaderTextColor` +- - `HeaderTextFontSize` - `HeaderTextFontFamily` - `HeaderTextFontStyle` diff --git a/docs/xplat/src/content/en/components/charts/features/chart-highlight-filter.mdx b/docs/xplat/src/content/en/components/charts/features/chart-highlight-filter.mdx index b0cea8d76a..fa32ce31e2 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-highlight-filter.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-highlight-filter.mdx @@ -9,6 +9,8 @@ namespace: Infragistics.Controls.Charts import Sample from 'igniteui-astro-components/components/mdx/Sample.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} Chart Highlight Filter The {ProductName} Chart components support a data highlighting overlay that can enhance the visualization of the series plotted in those charts by allowing you to view a subset of the data plotted. When enabled, this will highlight a subset of data while showing the total set with a reduced opacity in the case of column and area series types, and a dashed line in the case of line series types. This can help you to visualize things like target values versus actual values with your data set. This feature is demonstrated in the following example: @@ -16,45 +18,45 @@ The {ProductName} Chart components support a data highlighting overlay that can -Note that data highlighting feature is supported by the `DataChart` and `CategoryChart`, but it is configured in different ways in those controls due to the nature of how those controls work. One thing remains constant with this feature though, in that you need to set the `HighlightedValuesDisplayMode` property to `Overlay` if you want to see the highlight. The following will explain the different configurations for the highlight filter feature. +Note that data highlighting feature is supported by the and , but it is configured in different ways in those controls due to the nature of how those controls work. One thing remains constant with this feature though, in that you need to set the property to `Overlay` if you want to see the highlight. The following will explain the different configurations for the highlight filter feature. ## Using Highlight Filter with DataChart -In the `DataChart`, much of the highlight filter API happens on the series themselves, mainly by setting the `HighlightedItemsSource` property to a collection representing a subset of the data you want to highlight. The count of the items in the `HighlightedItemsSource` needs to match the count of the data bound to the `ItemsSource` of the series that you are looking to highlight, and in the case of category series, it will use the `ValueMemberPath` that you have defined as the highlight path by default. The sample at the top of this page uses the `HighlightedItemsSource` in the `DataChart` to show the overlay. +In the , much of the highlight filter API happens on the series themselves, mainly by setting the property to a collection representing a subset of the data you want to highlight. The count of the items in the needs to match the count of the data bound to the of the series that you are looking to highlight, and in the case of category series, it will use the `ValueMemberPath` that you have defined as the highlight path by default. The sample at the top of this page uses the in the to show the overlay. -In the case that the schema does not match between the `HighlightedItemsSource` and the `ItemsSource` of the series, you can configure this using the `HighlightedValueMemberPath` property on the series. Additionally, if you would like to use the `ItemsSource` of the series itself as the highlight source and have a path on your data item that represents the subset, you can do this. This is done by simply setting the `HighlightedValueMemberPath` property to that path and not providing a `HighlightedItemsSource`. +In the case that the schema does not match between the and the of the series, you can configure this using the `HighlightedValueMemberPath` property on the series. Additionally, if you would like to use the of the series itself as the highlight source and have a path on your data item that represents the subset, you can do this. This is done by simply setting the `HighlightedValueMemberPath` property to that path and not providing a . -The reduced opacity of the column and area series types is configurable by setting the `HighlightedValuesFadeOpacity` property on the series. You can also set the `HighlightedValuesDisplayMode` property to `Hidden` if you do not wish to see the overlay at all. +The reduced opacity of the column and area series types is configurable by setting the property on the series. You can also set the property to `Hidden` if you do not wish to see the overlay at all. -The part of the series shown by the highlight filter will be represented in the legend and tooltip layers of the chart separately. You can configure the title that this is given in the tooltip and legend by setting the `HighlightedTitleSuffix`. This will append the value that you provide to the end of the `Title` of the series. +The part of the series shown by the highlight filter will be represented in the legend and tooltip layers of the chart separately. You can configure the title that this is given in the tooltip and legend by setting the . This will append the value that you provide to the end of the of the series. -If the `DataLegend` or `DataToolTipLayer` is used then the highlighted series will appear grouped. This can be managed by setting the `HighlightedValuesDataLegendGroup` property on the series to categorize them appropriately. +If the or is used then the highlighted series will appear grouped. This can be managed by setting the property on the series to categorize them appropriately. -The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the `DataChart` control using the `HighlightedValuesDataLegendGroup`: +The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the control using the : -The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the `DataChart` control using the `HighlightedValuesDataLegendGroup`: +The following example demonstrates the usage of the data legend grouping and highlighting overlay feature within the control using the : -The following example demonstrates the usage of the data highlighting overlay feature within the `DataChart` control using the `HighlightedValueMemberPath`: +The following example demonstrates the usage of the data highlighting overlay feature within the control using the `HighlightedValueMemberPath`: ## Using Highlight Filter in CategoryChart -The `CategoryChart` highlight filter happens on the chart by setting the `InitialHighlightFilter` property. Since the `CategoryChart` takes all of the properties on your underlying data item into account by default, you will need to define the `InitialGroups` on the chart as well so that the data can be grouped and aggregated in a way that you can have a subset of the data to filter on. You can set the `InitialGroups` to a value path in your underlying data item to group by a path that has duplicate values. +The highlight filter happens on the chart by setting the property. Since the takes all of the properties on your underlying data item into account by default, you will need to define the on the chart as well so that the data can be grouped and aggregated in a way that you can have a subset of the data to filter on. You can set the to a value path in your underlying data item to group by a path that has duplicate values. {/* Unsure of this part. Need to review */} -{/* ????? The `InitialHighlightFilter` is done using OData filter query syntax. The syntax for this is an abbreviation of the filter operator. For example, if you wanted to have an InitialHighlightFilter of "Month not equals January" it would be represented as "Month ne 'January'"*/} +{/* ????? The is done using OData filter query syntax. The syntax for this is an abbreviation of the filter operator. For example, if you wanted to have an InitialHighlightFilter of "Month not equals January" it would be represented as "Month ne 'January'"*/} -Similar to the `DataChart`, the `HighlightedValuesDisplayMode` property is also exposed on the `CategoryChart`. In the case that you do not want to see the overlay, you can set this property to `Hidden`. +Similar to the , the property is also exposed on the . In the case that you do not want to see the overlay, you can set this property to `Hidden`. -The following example demonstrates the usage of the data highlighting overlay feature within the `CategoryChart` control: +The following example demonstrates the usage of the data highlighting overlay feature within the control: @@ -76,7 +78,7 @@ You can find more information about related chart features in these topics: The following is a list of API members mentioned in the above sections: -| `CategoryChart` Properties | `DataChart` Properties | +| Properties | Properties | | ----------------------------------------------|---------------------------| | `CategoryChart.HighlightedItemsSource` | `Series.HighlightedItemsSource` | | `CategoryChart.HighlightedTitleSuffix` | `Series.HighlightedTitleSuffix` | diff --git a/docs/xplat/src/content/en/components/charts/features/chart-markers.mdx b/docs/xplat/src/content/en/components/charts/features/chart-markers.mdx index 813b6b0d2f..a6e82c5d6a 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-markers.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-markers.mdx @@ -18,7 +18,7 @@ In {ProductName}, markers are visual elements that display the values of data po ## {Platform} Chart Marker Example -In the following example, the [Line Chart](../types/line-chart.md) is comparing the generation of renewable electricity for the countries Europe, China, and USA over the years of 2009 to 2019 with markers enabled by setting the property to `Circle` enum value. +In the following example, the [Line Chart](../types/line-chart.md) is comparing the generation of renewable electricity for the countries Europe, China, and USA over the years of 2009 to 2019 with markers enabled by setting the property to enum value. The colors of the markers are also managed by setting the and properties in the sample below. The markers and is configurable in this sample by using the drop-downs as well. diff --git a/docs/xplat/src/content/en/components/charts/features/chart-overlays.mdx b/docs/xplat/src/content/en/components/charts/features/chart-overlays.mdx index 91c83052a5..5a09e9a411 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-overlays.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-overlays.mdx @@ -28,13 +28,13 @@ The following example depicts a [Column Chart](../types/column-chart.md) with a ## {Platform} Value Overlay Properties -Unlike other series types that use a `ItemsSource` for data binding, the value overlay uses a property to bind a single numeric value. In addition, the value overlay requires you to define a single to use. If you use an X-axis, the value overlay will be a vertical line, and if you use a Y-axis, it will be a horizontal line. +Unlike other series types that use a for data binding, the value overlay uses a property to bind a single numeric value. In addition, the value overlay requires you to define a single to use. If you use an X-axis, the value overlay will be a vertical line, and if you use a Y-axis, it will be a horizontal line. When using a numeric X or Y axis, the property should reflect the actual numeric value on the axis where you want the value overlay to be drawn. When using a category X or Y axis, the should reflect the index of the category at which you want the value overlay to appear. When using the value overlay with a numeric angle axis, it will appear as a line from the center of the chart and when using a numeric radius axis, it will appear as a circle. - appearance properties are inherited from `Series` and so and for example are available and work the same way they do with other types of series. + appearance properties are inherited from and so and for example are available and work the same way they do with other types of series. It is also possible to show an axis annotation on a to show the value of the overlay on the owning axis. In order to show this, you can set the property to true. @@ -44,15 +44,15 @@ The {Platform} charting components also expose the ability to use value lines to Applying the in the and components is done by setting the property on the chart. This property takes a collection of the enumeration. You can mix and match multiple value layers in the same chart by adding multiple enumerations to the collection of the chart. -In the , this is done by adding a to the `Series` collection of the chart and then setting the property to one of the enumerations. Each of these enumerations and what they mean is listed below: +In the , this is done by adding a to the collection of the chart and then setting the property to one of the enumerations. Each of these enumerations and what they mean is listed below: -- `Auto`: The default value mode of the enumeration. -- `Average`: Applies potentially multiple value lines to call out the average value of each series plotted in the chart. -- `GlobalAverage`: Applies a single value line to call out the average of all of the series values in the chart. -- `GlobalMaximum`: Applies a single value line to call out the absolute maximum value of all of the series values in the chart. -- `GlobalMinimum`: Applies a single value line to call out the absolute minimum value of all of the series values in the chart. -- `Maximum`: Applies potentially multiple value lines to call out the maximum value of each series plotted in the chart. -- `Minimum`: Applies potentially multiple value lines to call out the minimum value of each series plotted in the chart. +- : The default value mode of the enumeration. +- : Applies potentially multiple value lines to call out the average value of each series plotted in the chart. +- : Applies a single value line to call out the average of all of the series values in the chart. +- : Applies a single value line to call out the absolute maximum value of all of the series values in the chart. +- : Applies a single value line to call out the absolute minimum value of all of the series values in the chart. +- : Applies potentially multiple value lines to call out the maximum value of each series plotted in the chart. +- : Applies potentially multiple value lines to call out the minimum value of each series plotted in the chart. If you want to prevent any particular series from being taken into account when using the element, you can set the property on the layer. This will force the layer to target the series that you define. You can have as many elements within a single as you want. @@ -71,7 +71,7 @@ You can also plot built-in financial overlays and indicators in {Platform} [Stoc The {Platform} , , and all Data Annotation Layers can render custom overlay text inside plot area of the DataChart component. You can use this overlay text to annotate important events (e.g. company quarter reports) on x-axis or important values on y-axis in relationship to the layers. -For example, you can use `DataAnnotationSliceLayer`, , and to show overlay text. +For example, you can use , , and to show overlay text. @@ -79,7 +79,7 @@ For example, you can use `DataAnnotationSliceLayer`, , and . +the , , and .
diff --git a/docs/xplat/src/content/en/components/charts/features/chart-performance.mdx b/docs/xplat/src/content/en/components/charts/features/chart-performance.mdx index 3583dcbea9..4d8eca0266 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-performance.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-performance.mdx @@ -22,7 +22,7 @@ The following examples demonstrates two high performance scenarios of {Platform} ## {Platform} Chart with High-Frequency -In High-Frequency scenario, the {Platform} Charts can render data items that are updating in real time or at specified milliseconds intervals. You will experience no lag, no screen-flicker, and no visual delays, even as you interact with the chart on a touch-device. The following sample demonstrates the `CategoryChart` in High-Frequency scenario. +In High-Frequency scenario, the {Platform} Charts can render data items that are updating in real time or at specified milliseconds intervals. You will experience no lag, no screen-flicker, and no visual delays, even as you interact with the chart on a touch-device. The following sample demonstrates the in High-Frequency scenario. @@ -33,7 +33,7 @@ In High-Frequency scenario, the {Platform} Charts can render data items that are ## {Platform} Chart with High-Volume -In High-Volume scenario, the {Platform} Charts can render 1 million of data points while the chart keeps providing smooth performance when end-users tries zooming in/out or navigating chart content. The following sample demonstrates the `CategoryChart` in High-Volume scenario. +In High-Volume scenario, the {Platform} Charts can render 1 million of data points while the chart keeps providing smooth performance when end-users tries zooming in/out or navigating chart content. The following sample demonstrates the in High-Volume scenario. @@ -46,7 +46,7 @@ This section lists guidelines and chart features that add to the overhead and pr ### Data Size -If you need to plot data sources with large number of data points (e.g. 10,000+), we recommend using {Platform} `DataChart` with one of the following type of series which where designed for specially for that purpose. +If you need to plot data sources with large number of data points (e.g. 10,000+), we recommend using {Platform} with one of the following type of series which where designed for specially for that purpose. - [Scatter HD Chart](../types/scatter-chart.md#{PlatformLower}-scatter-high-density-chart) instead of [Category Point Chart](../types/point-chart.md) or [Scatter Marker Chart](../types/scatter-chart.md#{PlatformLower}-scatter-marker-chart) - [Scatter Polyline Chart](../types/shape-chart.md#{PlatformLower}-scatter-polyline-chart) instead of [Category Line Chart](../types/line-chart.md#{PlatformLower}-line-chart-example) or [Scatter Line Chart](../types/scatter-chart.md#{PlatformLower}-scatter-line-chart) @@ -54,7 +54,7 @@ If you need to plot data sources with large number of data points (e.g. 10,000+) ### Data Structure -Although {Platform} charts support rendering of multiple data sources by binding array of arrays of data points to `ItemsSource` property. It is much faster for charts if multiple data sources are flatten into single data source where each data item contains multiple data columns rather just one data column. For example: +Although {Platform} charts support rendering of multiple data sources by binding array of arrays of data points to property. It is much faster for charts if multiple data sources are flatten into single data source where each data item contains multiple data columns rather just one data column. For example: @@ -138,7 +138,7 @@ export class MultiDataSources { ### Data Filtering -{Platform} `CategoryChart` and the `FinancialChart` controls have built-in data adapter that analyzes your data and generates chart series for you. However, it works faster if you use `IncludedProperties` and `ExcludedProperties` to filter only those data columns that you actually want to render. For example, +{Platform} and the controls have built-in data adapter that analyzes your data and generates chart series for you. However, it works faster if you use and to filter only those data columns that you actually want to render. For example, @@ -162,7 +162,7 @@ this.Chart.excludedProperties = [ "CHN", "FRN", "GER" ]; ### Chart Types -Simpler chart types such as [Line Chart](../types/line-chart.md) have faster performance than using [Spline Chart](../types/spline-chart.md) because of the complex interpolation of spline lines between data points. Therefore, you should use `CategoryChart.ChartType` property of {Platform} `CategoryChart` or the `FinancialChart` control to select type of chart that renders faster. Alternatively, you can change a type of series to a faster series in {Platform} `DataChart` control. +Simpler chart types such as [Line Chart](../types/line-chart.md) have faster performance than using [Spline Chart](../types/spline-chart.md) because of the complex interpolation of spline lines between data points. Therefore, you should use `CategoryChart.ChartType` property of {Platform} or the control to select type of chart that renders faster. Alternatively, you can change a type of series to a faster series in {Platform} control. The following table lists chart types in order from the fastest performance to slower performance in each group of charts: @@ -232,7 +232,7 @@ this.LineSeries.markerType = MarkerType.None; ### Chart Resolution -Setting the `Resolution` property to a higher value will improve performance, but it will lower the graphical fidelity of lines of plotted series. As such, it can be increased up until the fidelity is unacceptable. +Setting the property to a higher value will improve performance, but it will lower the graphical fidelity of lines of plotted series. As such, it can be increased up until the fidelity is unacceptable. This code snippet shows how to decrease resolution in the {Platform} charts. @@ -273,10 +273,10 @@ Enabling [Chart Trendlines](chart-trendlines.md) will slightly decrease performa Usage of x-axis with DateTime support is not recommended if spaces between data points, based on the amount of time span between them, are not important. Instead, ordinal/category axis should be used because it is more efficient in the way it coalesces data. Also, ordinal/category axis doesn’t perform any sorting on the data like the time-based x-axis does. -The `CategoryChart` already uses ordinal/category axis so there is no need to change its properties. +The already uses ordinal/category axis so there is no need to change its properties. -This code snippet shows how to ordinal/category x-axis in the `FinancialChart` and `DataChart` controls. +This code snippet shows how to ordinal/category x-axis in the and controls. @@ -328,7 +328,7 @@ This code snippet shows how to ordinal/category x-axis in the `FinancialChart` a ### Axis Intervals -By default, {Platform} charts will automatically calculate `YAxisInterval` based on range of your data. Therefore, you should avoid setting axis interval especially to a small value to prevent rendering of too many of axis gridlines and axis labels. Also, you might want to consider increasing `YAxisInterval` property to a larger value than the automatically calculated axis interval if you do not need many axis gridlines or axis labels. +By default, {Platform} charts will automatically calculate based on range of your data. Therefore, you should avoid setting axis interval especially to a small value to prevent rendering of too many of axis gridlines and axis labels. Also, you might want to consider increasing property to a larger value than the automatically calculated axis interval if you do not need many axis gridlines or axis labels. We do not recommend setting axis minor interval as it will decrease chart performance. @@ -398,7 +398,7 @@ This code snippet shows how to set axis major interval in the {Platform} charts. ### Axis Scale -Setting the `YAxisIsLogarithmic` property to false is recommended for higher performance, as fewer operations are needed than calculating axis range and values of axis labels in logarithmic scale. +Setting the property to false is recommended for higher performance, as fewer operations are needed than calculating axis range and values of axis labels in logarithmic scale. ### Axis Labels Visibility @@ -478,7 +478,7 @@ This code snippet shows how to hide axis labels in the {Platform} charts. ### Axis Labels Abbreviation -Although, the {Platform} charts support abbreviation of large numbers (e.g. 10,000+) displayed in axis labels when `YAxisAbbreviateLargeNumbers` is set to true. We recommend, instead pre-processing large values in your data items by dividing them a common factor and then setting `YAxisTitle` to a string that represents factor used used to abbreviate your data values. +Although, the {Platform} charts support abbreviation of large numbers (e.g. 10,000+) displayed in axis labels when is set to true. We recommend, instead pre-processing large values in your data items by dividing them a common factor and then setting to a string that represents factor used used to abbreviate your data values. This code snippet shows how to set axis title in the {Platform} charts. @@ -608,78 +608,78 @@ The following code snippet shows how to set a fixed extent for labels on y-axis Enabling additional axis visuals (e.g. axis titles) or changing their default values might decrease performance in the {Platform} charts. -For example, changing these properties on the `CategoryChart` or `FinancialChart` control: +For example, changing these properties on the or control: | Axis Visual | X-Axis Properties | Y-Axis Properties | | ---------------------|-------------------|------------------- | -| All Axis Visual | `XAxisInterval`
`XAxisMinorInterval` | `YAxisInterval`
`YAxisMinorInterval` | -| Axis Tickmarks | `XAxisTickStroke`
`XAxisTickStrokeThickness`
`XAxisTickLength`
| `YAxisTickStroke`
`YAxisTickStrokeThickness`
`YAxisTickLength`
| -| Axis Major Gridlines | `XAxisMajorStroke`
`XAxisMajorStrokeThickness`
| `YAxisMajorStroke`
`YAxisMajorStrokeThickness`
| -| Axis Minor Gridlines | `XAxisMinorStroke`
`XAxisMinorStrokeThickness`
| `YAxisMinorStroke`
`YAxisMinorStrokeThickness`
| -| Axis Main Line | `XAxisStroke`
`XAxisStrokeThickness`
| `YAxisStroke`
`YAxisStrokeThickness`
| -| Axis Titles | `XAxisTitle`
`XAxisTitleAngle`
| `YAxisTitle`
`YAxisTitleAngle`
| -| Axis Strips | `XAxisStrip`
| `YAxisStrip`
| +| All Axis Visual |
|
| +| Axis Tickmarks |


|


| +| Axis Major Gridlines |

|

| +| Axis Minor Gridlines |

|

| +| Axis Main Line |

|

| +| Axis Titles |

|

| +| Axis Strips |
|
| -Or changing properties of an `Axis` in the `DataChart` control: +Or changing properties of an in the control: | Axis Visual | Axis Properties | | ---------------------|------------------- | | All Axis Visuals | `Interval`, `MinorInterval` | -| Axis Tickmarks | `TickStroke` , `TickStrokeThickness`, `TickLength` | -| Axis Major Gridlines | `MajorStroke`, `MajorStrokeThickness` | -| Axis Minor Gridlines | `MinorStroke`, `MinorStrokeThickness` | -| Axis Main Line | `Stroke`, `StrokeThickness` | -| Axis Titles | `Title`, `TitleAngle` | -| Axis Strips | `Strip` | +| Axis Tickmarks | , , | +| Axis Major Gridlines | , | +| Axis Minor Gridlines | , | +| Axis Main Line | , | +| Axis Titles | , `TitleAngle` | +| Axis Strips | | ## Performance in Financial Chart -In addition to above performance guidelines, the {Platform} `FinancialChart` control has the following unique features that affect performance. +In addition to above performance guidelines, the {Platform} control has the following unique features that affect performance. ### Y-Axis Mode -Setting the `YAxisMode` option to `Numeric` is recommended for higher performance, as fewer operations are needed than using `PercentChange` mode. +Setting the option to `Numeric` is recommended for higher performance, as fewer operations are needed than using mode. ### Chart Panes -Setting a lot of panes using `IndicatorTypes` and `OverlayTypes` options, might decrease performance and it is recommended to use a few financial indicators and one financial overlay. +Setting a lot of panes using and options, might decrease performance and it is recommended to use a few financial indicators and one financial overlay. ### Zoom Slider -Setting the `ZoomSliderType` option to `None` will improve chart performance and enable more vertical space for other indicators and the volume pane. +Setting the option to will improve chart performance and enable more vertical space for other indicators and the volume pane. ### Volume Type -Setting the `VolumeType` property can have the following impact on chart performance: +Setting the property can have the following impact on chart performance: -- `None` - is the least expensive since it does not display the volume pane. -- `Line` - is more expensive volume type to render and it is recommended when rendering a lot of data points or when plotting a lot of data sources. -- `Area` - is more expensive to render than the `Line` volume type. -- `Column` - is more expensive to render than the `Area` volume type and it is recommended when rendering volume data of 1-3 stocks. +- - is the least expensive since it does not display the volume pane. +- - is more expensive volume type to render and it is recommended when rendering a lot of data points or when plotting a lot of data sources. +- - is more expensive to render than the volume type. +- - is more expensive to render than the volume type and it is recommended when rendering volume data of 1-3 stocks. ## Performance in Data Chart -In addition to the general performance guidelines, the {Platform} `DataChart` control has the following unique features that affect performance. +In addition to the general performance guidelines, the {Platform} control has the following unique features that affect performance. ### Axes Collection -Adding too many axis to the `Axes` collection of the `DataChart` control will decrease chart performance and we recommend [Sharing Axes](chart-axis-layouts.md#axis-sharing-example) between series. +Adding too many axis to the collection of the control will decrease chart performance and we recommend [Sharing Axes](chart-axis-layouts.md#axis-sharing-example) between series. ### Series Collection -Also, adding a lot of series to the `Series` collection of the {Platform} `DataChart` control will add overhead to rendering because each series has its own rendering canvas. This is especially important if you have more than 10 series in the Data Chart. We recommend combining multiple data sources into flatten data source (see [Data Structure](#data-structure) section) and then using conditional styling feature of the following series: +Also, adding a lot of series to the collection of the {Platform} control will add overhead to rendering because each series has its own rendering canvas. This is especially important if you have more than 10 series in the Data Chart. We recommend combining multiple data sources into flatten data source (see [Data Structure](#data-structure) section) and then using conditional styling feature of the following series: | Slower Performance Scenario | Faster Scenario with Conditional Styling | | ----------------------------|---------------------------------------- | -| 10+ of `LineSeries` | Single `ScatterLineSeries` | -| 20+ of `LineSeries` | Single `ScatterPolylineSeries` | -| 10+ of `ScatterLineSeries` | Single `ScatterPolylineSeries` | -| 10+ of `PointSeries` | Single `ScatterSeries` | -| 20+ of `PointSeries` | Single `HighDensityScatterSeries` | -| 20+ of `ScatterSeries` | Single `HighDensityScatterSeries` | -| 10+ of `AreaSeries` | Single `ScatterPolygonSeries` | -| 10+ of `ColumnSeries` | Single `ScatterPolygonSeries` | +| 10+ of | Single | +| 20+ of | Single | +| 10+ of | Single | +| 10+ of | Single | +| 20+ of | Single | +| 20+ of | Single | +| 10+ of | Single | +| 10+ of | Single | ## Additional Resources diff --git a/docs/xplat/src/content/en/components/charts/features/chart-titles.mdx b/docs/xplat/src/content/en/components/charts/features/chart-titles.mdx index 2b16796c56..d1b7f49490 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-titles.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-titles.mdx @@ -28,20 +28,20 @@ When adding a title or subtitle to the chart control, the content of the chart a | Property Name | Property Type | Description | | ----------------------|------------------|------------| | `ChartTitle` | string | Title's text content. | -| `TitleTextColor` | string | Title's text. color | -| `TitleAlignment` | HorizontalAlignment | Title's horizontal alignment. | -| `TitleTextStyle` | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | -| `TitleTopMargin` | number | Title's top margin. | -| `TitleLeftMargin` | number | Title's left margin. | -| `TitleRightMargin` | number | Title's right margin. | -| `TitleBottomMargin` | number | Title's bottom margin. | -| `Subtitle` | string | Title's text content. | -| `SubtitleTextColor` | string | Title's text. color | -| `SubtitleAlignment` | HorizontalAlignment | Title's horizontal alignment. | -| `SubtitleTextStyle` | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | -| `SubtitleTopMargin` | number | Title's top margin. | -| `SubtitleLeftMargin` | number | Title's left margin. | -| `SubtitleRightMargin` | number | Title's right margin. | -| `SubtitleBottomMargin`| number | Title's bottom margin. | +| | string | Title's text. color | +| | HorizontalAlignment | Title's horizontal alignment. | +| | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | +| | number | Title's top margin. | +| | number | Title's left margin. | +| | number | Title's right margin. | +| | number | Title's bottom margin. | +| | string | Title's text content. | +| | string | Title's text. color | +| | HorizontalAlignment | Title's horizontal alignment. | +| | string | Title's font style, e.g. Italic Bold 8pt Times New Roman | +| | number | Title's top margin. | +| | number | Title's left margin. | +| | number | Title's right margin. | +| | number | Title's bottom margin. | diff --git a/docs/xplat/src/content/en/components/charts/features/chart-tooltips.mdx b/docs/xplat/src/content/en/components/charts/features/chart-tooltips.mdx index df801d32e1..03755234ae 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-tooltips.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-tooltips.mdx @@ -29,10 +29,10 @@ The Tooltip | Display a tooltip for a single item when the pointer is positioned over it. | +| Tooltip | Display the data tooltips for all series in the chart. | +| Tooltip | Display a tooltip for each data item in the category that the pointer is positioned over. | +| Tooltip | Display a grouped tooltip for all data points in the category that the pointer is positioned over. |
diff --git a/docs/xplat/src/content/en/components/charts/features/chart-trendlines.mdx b/docs/xplat/src/content/en/components/charts/features/chart-trendlines.mdx index 8186b9e434..69d3aeb511 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-trendlines.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-trendlines.mdx @@ -30,7 +30,7 @@ The following sample depicts a sh ## {Platform} Chart Trendlines Dash Array Example -The following sample depicts a showing a `FinancialPriceSeries` with a **QuarticFit** dashed trendline applied via the property: +The following sample depicts a showing a with a **QuarticFit** dashed trendline applied via the property: @@ -40,7 +40,7 @@ The following sample depicts a showing ## {Platform} Chart Trendline Layer -The is a series type that is designed to display a single trendline type for a target series. The difference between this and the existing trendline features on the existing series types is that since the is a series type, you can add more than one of them to the `Series` collection of the chart to have multiple trendlines attached to the same series. You can also have the trendline appear in the legend, which was not possible previously. +The is a series type that is designed to display a single trendline type for a target series. The difference between this and the existing trendline features on the existing series types is that since the is a series type, you can add more than one of them to the collection of the chart to have multiple trendlines attached to the same series. You can also have the trendline appear in the legend, which was not possible previously. ## Trendline Layer Usage @@ -52,7 +52,7 @@ If you would like to show the in By default, the renders with the same color as its in a dashed line. This can be configured by using the various styling properties on the . -To change the color of the trendline that is drawn, you can set its property. Alternatively, you can also set the property to `true`, which will pull from the chart's `Brushes` palette based on the index in which the is placed in the chart's `Series` collection. +To change the color of the trendline that is drawn, you can set its property. Alternatively, you can also set the property to `true`, which will pull from the chart's palette based on the index in which the is placed in the chart's collection. You can also modify the way that the appears by using its and properties. The takes a value between -1.0 and 1.0 to determine how much of a "shift" to apply to the options that end in "Shift". diff --git a/docs/xplat/src/content/en/components/charts/features/chart-user-annotations.mdx b/docs/xplat/src/content/en/components/charts/features/chart-user-annotations.mdx index d167278574..749e1cd877 100644 --- a/docs/xplat/src/content/en/components/charts/features/chart-user-annotations.mdx +++ b/docs/xplat/src/content/en/components/charts/features/chart-user-annotations.mdx @@ -19,7 +19,7 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; In {ProductName}, you can annotate the with slice, strip, and point annotations at runtime using the user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. The following topic explains, with examples, how you can utilize the `Toolbar` to add user annotations to the plot area of the chart, as well as how to do add these user annotations programmatically. +This is directly integrated with the available tools of the . The following topic explains, with examples, how you can utilize the to add user annotations to the plot area of the chart, as well as how to do add these user annotations programmatically. @@ -30,7 +30,7 @@ This feature is designed to support X and Y axes and does not currently support ## Using the User Annotations with the Toolbar -The `Toolbar` exposes an Annotations menu item with two tools with the labels of "Annotate Chart" and "Delete Note." In order for this menu item to appear, you first need to set the property on the corresponding chart to `true`. +The exposes an Annotations menu item with two tools with the labels of "Annotate Chart" and "Delete Note." In order for this menu item to appear, you first need to set the property on the corresponding chart to `true`. The "Annotate Chart" option that appears after opening allows you to annotate the plot area of the . This can be done by adding slice, strip, or point annotations. You can add a slice annotation by clicking on a label on the X or Y axis. You can add a strip annotation by clicking and dragging in the plot area. Also, you can add a point annotation by clicking on a point in a series plotted in the chart. @@ -40,34 +40,34 @@ You can delete the annotations that you have previously added by selecting the " {Platform} user-annotation-delete -When adding one of these user annotations via the `Toolbar`, the will raise an event named `UserAnnotationInformationRequested` where you can provide more information for the user annotations. This event's arguments have a property named `AnnotationInfo` that will return a object that allows the configuration of multiple different aspects of the annotation to be added. +When adding one of these user annotations via the , the will raise an event named `UserAnnotationInformationRequested` where you can provide more information for the user annotations. This event's arguments have a property named `AnnotationInfo` that will return a object that allows the configuration of multiple different aspects of the annotation to be added. The table below details the different configurable properties on : | Property | Type | Description | |------------|---------|-------------| -|`AnnotationData`|`string`|This property allows additional information for the user annotation. This property is designed to be utilized with the `UserAnnotationToolTipContentUpdating` event to show additional information in the annotation's tooltip.| -|`AnnotationId`|`string`|This read-only property returns the unique string ID of the user annotation.| -|`BadgeColor`|`string`|This property gets or sets the color to use for the badge in the user annotation.| -|`BadgeImageUri`|`string`|This property gets or sets a path to an image to use for the badge in the user annotation.| -|`DialogSuggestedXLocation`|`double`|This property gets a recommended X location to show a dialog based on the location that the user annotation was added.| -|`DialogSuggestedYLocation`|`double`|This property gets a recommended Y location to show a dialog based on the location that the user annotation was added.| -|`Label`|`string`|This property gets or sets the label to be shown in the user annotation.| -|`MainColor`|`string`|This property gets or sets the color to be used to fill the background of the user annotation.| +||`string`|This property allows additional information for the user annotation. This property is designed to be utilized with the `UserAnnotationToolTipContentUpdating` event to show additional information in the annotation's tooltip.| +||`string`|This read-only property returns the unique string ID of the user annotation.| +||`string`|This property gets or sets the color to use for the badge in the user annotation.| +||`string`|This property gets or sets a path to an image to use for the badge in the user annotation.| +||`double`|This property gets a recommended X location to show a dialog based on the location that the user annotation was added.| +||`double`|This property gets a recommended Y location to show a dialog based on the location that the user annotation was added.| +||`string`|This property gets or sets the label to be shown in the user annotation.| +||`string`|This property gets or sets the color to be used to fill the background of the user annotation.| -After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the `FinishAnnotationFlow` method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling `CancelAnnotationFlow` and passing the `AnnotationId` of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. +After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling and passing the of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. ## Using the User Annotations Programmatically -When using the programmatically, you can invoke two different methods on the to put the chart into a mode where you can add or remove a user annotation. These methods are named `StartCreatingAnnotation` and `StartDeletingAnnotation`, respectively. +When using the programmatically, you can invoke two different methods on the to put the chart into a mode where you can add or remove a user annotation. These methods are named and , respectively. -After invoking `StartCreatingAnnotation`, you can add a slice annotation by clicking on a label on the X or Y axis, add a strip annotation by clicking and dragging in the plot area and releasing the mouse button, or add a point annotation by clicking on a data point on a series plotted in the chart. +After invoking , you can add a slice annotation by clicking on a label on the X or Y axis, add a strip annotation by clicking and dragging in the plot area and releasing the mouse button, or add a point annotation by clicking on a data point on a series plotted in the chart. Adding one of these user annotations will raise an event named `UserAnnotationInformationRequested`, where you can provide more information for the user annotation. This event's arguments have a property named `AnnotationInfo` that will return a object that allows the configuration of multiple different aspects of the annotation to be added. -After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the `FinishAnnotationFlow` method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling `CancelAnnotationFlow` and passing the `AnnotationId` of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. +After you have made the changes to the annotation through the `UserAnnotationInformationRequested` event, you should invoke the method on the to finish creating the annotation and commit the changes to it. Alternatively, you can also cancel the annotation's creation by calling and passing the of the annotation, which can be obtained from the `AnnotationInfo` parameter of the `UserAnnotationInformationRequested` event's arguments, as mentioned above. This will remove the annotation from the plot area. -Once the user annotation has been added to the chart, it will appear in the `Series` collection as a . The has an `Annotations` collection that can store , and elements depending on the type of annotations added to the plot area. +Once the user annotation has been added to the chart, it will appear in the collection as a . The has an collection that can store , and elements depending on the type of annotations added to the plot area. ## User Annotation ToolTip diff --git a/docs/xplat/src/content/en/components/charts/types/area-chart.mdx b/docs/xplat/src/content/en/components/charts/types/area-chart.mdx index aca28a70f1..d38b9b8530 100644 --- a/docs/xplat/src/content/en/components/charts/types/area-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/area-chart.mdx @@ -58,7 +58,7 @@ There are several common use cases for choosing an Area Chart: ## {Platform} Area Chart with Single Series -{Platform} Area Chart is often used to show the change of value over time such as the amount of renewable electricity produced. You can create this type of chart in control by binding your data and setting property to `Area` value, as shown in the example below. +{Platform} Area Chart is often used to show the change of value over time such as the amount of renewable electricity produced. You can create this type of chart in control by binding your data and setting property to value, as shown in the example below. @@ -93,7 +93,7 @@ The following sections explain more advanced types of {Platform} Area Charts tha ## {Platform} Step Area Chart -The {Platform} Step Area Chart belongs to a group of category charts and it is rendered using a collection of points connected by continuous vertical and horizontal lines with the area below lines filled in. Values are represented on the y-axis and categories are displayed on the x-axis. The step area chart emphasizes the amount of change over a period of time or compares multiple items. You can create this type of chart in control by binding your data and setting property to `StepArea` value, as shown in the example below. +The {Platform} Step Area Chart belongs to a group of category charts and it is rendered using a collection of points connected by continuous vertical and horizontal lines with the area below lines filled in. Values are represented on the y-axis and categories are displayed on the x-axis. The step area chart emphasizes the amount of change over a period of time or compares multiple items. You can create this type of chart in control by binding your data and setting property to value, as shown in the example below. @@ -212,16 +212,16 @@ The following table lists API members mentioned in above sections: | Chart Type | Control Name | API Members | | -------------------------|-----------------|-----------------------| -| Area | `CategoryChart` | `CategoryChart.ChartType` = `Area` | -| Step Area | `CategoryChart` | `CategoryChart.ChartType` = `StepArea` | -| Range Area | `DataChart` | `RangeAreaSeries` | -| Radial Area | `DataChart` | `RadialAreaSeries` | -| Polar Area | `DataChart` | `PolarAreaSeries` | -| Polar Spline Area | `DataChart` | `PolarSplineAreaSeries` | -| Stacked Area | `DataChart` | `StackedAreaSeries` | -| Stacked Spline Area | `DataChart` | `StackedSplineAreaSeries` | -| Stacked 100% Area | `DataChart` | `Stacked100AreaSeries` | -| Stacked 100% Spline Area | `DataChart` | `Stacked100SplineAreaSeries` | +| Area | | `CategoryChart.ChartType` = | +| Step Area | | `CategoryChart.ChartType` = | +| Range Area | | | +| Radial Area | | | +| Polar Area | | | +| Polar Spline Area | | | +| Stacked Area | | | +| Stacked Spline Area | | | +| Stacked 100% Area | | | +| Stacked 100% Spline Area | | | ## API References diff --git a/docs/xplat/src/content/en/components/charts/types/column-chart.mdx b/docs/xplat/src/content/en/components/charts/types/column-chart.mdx index 10e750ae14..51a5278f05 100644 --- a/docs/xplat/src/content/en/components/charts/types/column-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/column-chart.mdx @@ -178,12 +178,12 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | --------------------|--------------------|------------------------| -| Column | `CategoryChart` | `CategoryChart.ChartType` = **Column** | -| Radial Column | `DataChart` | `RadialColumnSeries` | -| Range Column | `DataChart` | `RangeColumnSeries` | -| Stacked Column | `DataChart` | `StackedColumnSeries` | -| Stacked 100% Column | `DataChart` | `Stacked100ColumnSeries` | -| Waterfall | `DataChart` | `WaterfallSeries` | +| Column | | `CategoryChart.ChartType` = **Column** | +| Radial Column | | | +| Range Column | | | +| Stacked Column | | | +| Stacked 100% Column | | | +| Waterfall | | |

diff --git a/docs/xplat/src/content/en/components/charts/types/composite-chart.mdx b/docs/xplat/src/content/en/components/charts/types/composite-chart.mdx index 5ec3132d71..fc0d017d1a 100644 --- a/docs/xplat/src/content/en/components/charts/types/composite-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/composite-chart.mdx @@ -15,7 +15,7 @@ The {ProductName} Composite Chart, also called a Combo Chart, is visualization t ## {Platform} Composite / Combo Example -The following example demonstrates how to create Composite Chart using `ColumnSeries` and `LineSeries` in the control. +The following example demonstrates how to create Composite Chart using and in the control. diff --git a/docs/xplat/src/content/en/components/charts/types/data-pie-chart.mdx b/docs/xplat/src/content/en/components/charts/types/data-pie-chart.mdx index 14da58de2a..b29247210a 100644 --- a/docs/xplat/src/content/en/components/charts/types/data-pie-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/data-pie-chart.mdx @@ -79,7 +79,7 @@ The Others category in the has thre The property works in tandem with the property of the . For the , you can define whether you want the to be evaluated as a number or a percentage. For example, if you decide on number and set the to 5, any slices that have a value less than 5 will become part of the Others category. Using the same value of 5 with a percent type, any values that are less than 5 percent of the total values of the will become part of the Others category. -To get the underlying data items that are contained within the Others slice in the chart, you can utilize the `GetOthersContext` method on the chart. This return type of this method is an `OthersCategoryContext` which exposes an `Items` property. The `Items` property returns an array that will contain the items in the Others slice. Additionally, when clicking the Others slice, the `Item` property of the event arguments for the `SeriesClick` event will be will also return this `OthersCategoryContext`. +To get the underlying data items that are contained within the Others slice in the chart, you can utilize the method on the chart. This return type of this method is an which exposes an property. The property returns an array that will contain the items in the Others slice. Additionally, when clicking the Others slice, the `Item` property of the event arguments for the `SeriesClick` event will be will also return this . By default, the Others slice will be represented by a label of "Others." You can change this by modifying the property of the chart. @@ -112,21 +112,21 @@ The following sample demonstrates usage of the Others slice in the supports slice selection by mouse click on the slices plotted in the chart. This can be configured by utilizing the and properties of the chart, described below: -The main two options of the are `PerDataItemSingleSelect` and `PerDataItemMultiSelect`, which will enable single and multiple selection, respectively. +The main two options of the are and , which will enable single and multiple selection, respectively. The property exposes an enumeration that determines how the pie chart slices respond to being selected. The following are the options of that enumeration and what they do: -- `Brighten`: The selected slices will be highlighted. -- `FadeOthers`: The selected slices will remain their same color and others will fade. -- `FocusColorFill`: The selected slices will change their background to the FocusBrush of the chart. -- `FocusColorOutline`: The selected slices will have an outline with the color defined by the FocusBrush of the chart. -- `FocusColorThickOutline`: The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. -- `GrayscaleOthers`: The unselected slices will have a gray color filter applied to them. -- `None`: There is no effect on the selected slices. -- `SelectionColorFill`: The selected slices will change their background to the SelectionBrush of the chart. -- `SelectionColorOutline`: The selected slices will have an outline with the color defined by the SelectionBrush of the chart. -- `SelectionColorThickOutline`: The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. -- `ThickOutline`: The selected slices will apply an outline with the thickness dependent on the Thickness property of the chart. +- : The selected slices will be highlighted. +- : The selected slices will remain their same color and others will fade. +- : The selected slices will change their background to the FocusBrush of the chart. +- : The selected slices will have an outline with the color defined by the FocusBrush of the chart. +- : The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. +- : The unselected slices will have a gray color filter applied to them. +- : There is no effect on the selected slices. +- : The selected slices will change their background to the SelectionBrush of the chart. +- : The selected slices will have an outline with the color defined by the SelectionBrush of the chart. +- : The selected slices will have an outline with the color defined by the FocusBrush of the chart. The thickness of this outline can be configured via the Thickness property of the control as well. +- : The selected slices will apply an outline with the thickness dependent on the Thickness property of the chart. When a slice is selected, its underlying data item will be added to the SelectedSeriesItems collection of the chart. As such, the DataPieChart exposes the SelectedSeriesItemsChanged event to detect when a slice has been selected and this collection is changed. @@ -143,18 +143,18 @@ The supports mouse over highlightin First, the enumerated property determines how a slice will be highlighted. The following are the options of that property and what they do: -- `DirectlyOver`: The slices are only highlighted when the mouse is directly over them. -- `NearestItems`: The nearest slice to the mouse position will be highlighted. -- `NearestItemsAndSeries`: The nearest slice and series to the mouse position will be highlighted. -- `NearestItemsRetainMainShapes`: The nearest items to the mouse position will be highlighted and the main shapes of the series will not be de-emphasized. +- : The slices are only highlighted when the mouse is directly over them. +- : The nearest slice to the mouse position will be highlighted. +- : The nearest slice and series to the mouse position will be highlighted. +- : The nearest items to the mouse position will be highlighted and the main shapes of the series will not be de-emphasized. The enumerated property determines how the data pie chart slices respond to being highlighted. The following are the options of that property and what they do: -- `Brighten`: The series will have its color brightened when the mouse position is over or near it. +- : The series will have its color brightened when the mouse position is over or near it. - `BrightenSpecific`: The specific slice will have its color brightened when the mouse position is over or near it. -- `FadeOthers`: The series will retain its color when the mouse position is over or near it, while the others will appear faded. +- : The series will retain its color when the mouse position is over or near it, while the others will appear faded. - `FadeOthersSpecific`: The specific slice will retain its color when the mouse position is over or near it, while the others will appear faded. -- `None`: The series and slices will not be highlighted. +- : The series and slices will not be highlighted. The following example demonstrates the mouse highlighting behaviors of the component: diff --git a/docs/xplat/src/content/en/components/charts/types/gantt-chart.mdx b/docs/xplat/src/content/en/components/charts/types/gantt-chart.mdx index e3ea5c0545..622e41d906 100644 --- a/docs/xplat/src/content/en/components/charts/types/gantt-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/gantt-chart.mdx @@ -16,7 +16,7 @@ The {ProductName} Gantt Chart is a type of bar chart, that visualizes various ca ## {Platform} Gantt Chart Example -The following example demonstrates how to create Gantt Chart using `ScatterPolygonSeries` in the control. +The following example demonstrates how to create Gantt Chart using in the control. diff --git a/docs/xplat/src/content/en/components/charts/types/line-chart.mdx b/docs/xplat/src/content/en/components/charts/types/line-chart.mdx index 30e044ff99..a727fd2b5d 100644 --- a/docs/xplat/src/content/en/components/charts/types/line-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/line-chart.mdx @@ -15,7 +15,7 @@ The {ProductName} Line Chart or Line Graph is a type of category charts that sho ## {Platform} Line Chart Example -You can create the {Platform} Line Chart in the control by binding your data to property and setting property to `Line` enum, as shown in the example below. +You can create the {Platform} Line Chart in the control by binding your data to property and setting property to enum, as shown in the example below. @@ -73,7 +73,7 @@ There are several common use cases for choosing a Line Chart: The {Platform} Line Chart is often used to show the change of value over time such as the amount of renewable electricity produced since 2009 over a ten-year period, as we have shown in the example below. -You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -86,7 +86,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -101,7 +101,7 @@ The {Platform} Line chart is capable of handling high volumes of data, ranging i In this example, we are streaming live data into the {Platform} Line Chart at an interval of your choosing. You can set the data points from 5,000 to 1 million and update the chart to optimize the scale based on the device you are rendering the chart on. -You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -114,7 +114,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Line`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -200,11 +200,11 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | ------------------|--------------------|----------------------- | -| Line | `CategoryChart` | `CategoryChart.ChartType` = `Line` | -| Polar Line | `DataChart` | `PolarLineSeries` | -| Radial Line | `DataChart` | `RadialLineSeries` | -| Stacked Line | `DataChart` | `StackedLineSeries` | -| Stacked 100% Line | `DataChart` | `Stacked100LineSeries` | +| Line | | `CategoryChart.ChartType` = | +| Polar Line | | | +| Radial Line | | | +| Stacked Line | | | +| Stacked 100% Line | | |

diff --git a/docs/xplat/src/content/en/components/charts/types/pie-chart.mdx b/docs/xplat/src/content/en/components/charts/types/pie-chart.mdx index d927364ea8..b193d319a7 100644 --- a/docs/xplat/src/content/en/components/charts/types/pie-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/pie-chart.mdx @@ -107,7 +107,7 @@ The pie chart supports explosion of individual pie slices as well as a `SliceCli
## {Platform} Pie Chart Selection -The pie chart supports slice selection by mouse click as the default behavior. You can determine the selected slices by using the `SelectedItems` property. The selected slices are then highlighted. +The pie chart supports slice selection by mouse click as the default behavior. You can determine the selected slices by using the property. The selected slices are then highlighted. There is a property called which is how you set what mode you want the pie chart to use. The default value is `Single`. In order to disable selection, set the property to `Manual`. @@ -125,7 +125,7 @@ The pie chart has 4 events associated with selection: The events that end in "Changing" are cancelable events which means you can stop the selection of a slice by setting the event argument property `Cancel` to true. When set to true the associated property will not update and the slice will not become selected. This is useful for scenarios where you want to keep users from being able to select certain slices based on the data inside it. -For scenarios where you click on the Others slice, the pie chart will return an object called `PieSliceOthersContext`. This object contains a list of the data items contained within the Others slice. +For scenarios where you click on the Others slice, the pie chart will return an object called . This object contains a list of the data items contained within the Others slice. diff --git a/docs/xplat/src/content/en/components/charts/types/pyramid-chart.mdx b/docs/xplat/src/content/en/components/charts/types/pyramid-chart.mdx index 854d37250b..9fc4dd1a83 100644 --- a/docs/xplat/src/content/en/components/charts/types/pyramid-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/pyramid-chart.mdx @@ -15,7 +15,7 @@ The {ProductName} Pyramid Chart, also called an age pyramid or population pyrami ## {Platform} Pyramid Chart Example -The following example demonstrates how to create Pyramid Chart using `BarSeries` in the control. +The following example demonstrates how to create Pyramid Chart using in the control. diff --git a/docs/xplat/src/content/en/components/charts/types/radial-chart.mdx b/docs/xplat/src/content/en/components/charts/types/radial-chart.mdx index 694b6630ad..e3c2ec00ee 100644 --- a/docs/xplat/src/content/en/components/charts/types/radial-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/radial-chart.mdx @@ -68,7 +68,7 @@ Once our radial chart is created, we may want to make some further styling custo ## {Platform} Radial Chart Settings -In addition, the labels can be configured to appear near or wide from the chart. This can be configured with the `LabelMode` property for the . +In addition, the labels can be configured to appear near or wide from the chart. This can be configured with the property for the .
diff --git a/docs/xplat/src/content/en/components/charts/types/scatter-chart.mdx b/docs/xplat/src/content/en/components/charts/types/scatter-chart.mdx index 9dbfe715de..7dd921143c 100644 --- a/docs/xplat/src/content/en/components/charts/types/scatter-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/scatter-chart.mdx @@ -95,12 +95,12 @@ The following table lists API members mentioned in the above sections: |Chart Type | Control Name | API Members | |----------------------------|----------------|------------------------ | - |Scatter Marker | `DataChart` | `ScatterSeries` | - |Scatter Line | `DataChart` | `ScatterLineSeries` | - |Scatter Spline | `DataChart` | `ScatterSplineSeries` | - |High Density Scatter | `DataChart` | `HighDensityScatterSeries` | - |Scatter Area | `DataChart` | `ScatterAreaSeries` | - |Scatter Contour | `DataChart` | `ScatterContourSeries` | + |Scatter Marker | | | + |Scatter Line | | | + |Scatter Spline | | | + |High Density Scatter | | | + |Scatter Area | | | + |Scatter Contour | | | ## API References diff --git a/docs/xplat/src/content/en/components/charts/types/sparkline-chart.mdx b/docs/xplat/src/content/en/components/charts/types/sparkline-chart.mdx index 770b21e781..fe6417634c 100644 --- a/docs/xplat/src/content/en/components/charts/types/sparkline-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/sparkline-chart.mdx @@ -16,7 +16,7 @@ The {ProductName} Sparkline is a lightweight charting control. It is intended fo ## {Platform} Sparkline Example -The following example shows all the different types of available. The type is defined by setting the property. If the property is not specified, then by default, the `Line` type is displayed. +The following example shows all the different types of available. The type is defined by setting the property. If the property is not specified, then by default, the type is displayed. @@ -61,10 +61,10 @@ The {Platform} Sparkline has the ability to mark the data points with elliptical The {Platform} Sparkline supports the following types of sparklines by setting the property accordingly: -- `Line`: Displays the line chart type of Sparkline with numeric data, connecting the data points with line segments. At least two data points must be supplied to visualize the data in Sparkline. -- `Area`: Displays the Area chart type of Sparkline with numeric data. This is like line type with additional steps of closing the area after each line is drawn. At least two data points must be supplied to visualize the data in Sparkline. -- `Column`: Displays the Column chart type of Sparkline with numeric data. Some may refer to it as vertical bars. This type can render a single data point, but it would require specifying the minimum value range property (minimum) in Sparkline so the supplied single data point can be visible, otherwise the value will be treated as the minimum value and will not be visible. -- `WinLoss`: This type is similar in its visual appearance to Column chart type, in which the value of each column is equal to either the positive maximum (for positive values) or the negative minimum (for negative value) of the data set. The idea is to indicate a win or loss scenario. For the Win/Loss chart to display properly, the data set must have both positive and negative values. If the WinLoss sparkline is bound to the same data as the other types such as the Line type, which can be bound to a collection of numeric values, then the {Platform} Sparkline will select two values from the collection - the highest and the lowest - and will render the sparkline based upon those values. +- : Displays the line chart type of Sparkline with numeric data, connecting the data points with line segments. At least two data points must be supplied to visualize the data in Sparkline. +- : Displays the Area chart type of Sparkline with numeric data. This is like line type with additional steps of closing the area after each line is drawn. At least two data points must be supplied to visualize the data in Sparkline. +- : Displays the Column chart type of Sparkline with numeric data. Some may refer to it as vertical bars. This type can render a single data point, but it would require specifying the minimum value range property (minimum) in Sparkline so the supplied single data point can be visible, otherwise the value will be treated as the minimum value and will not be visible. +- : This type is similar in its visual appearance to Column chart type, in which the value of each column is equal to either the positive maximum (for positive values) or the negative minimum (for negative value) of the data set. The idea is to indicate a win or loss scenario. For the Win/Loss chart to display properly, the data set must have both positive and negative values. If the WinLoss sparkline is bound to the same data as the other types such as the Line type, which can be bound to a collection of numeric values, then the {Platform} Sparkline will select two values from the collection - the highest and the lowest - and will render the sparkline based upon those values. @@ -75,7 +75,7 @@ The {Platform} Sparkline supports the following types of sparklines by setting t ## Markers -The {Platform} Sparkline allows you to show markers as circular-colored icons on your series to indicate the individual data points based on X/Y coordinates. Markers can be set on sparklines of display types of `Line`, `Area`, and `Column`. The `WinLoss` type of sparkline does not currently accept markers. By default, markers are not displayed, but they can be enabled by setting the corresponding marker visibility property. +The {Platform} Sparkline allows you to show markers as circular-colored icons on your series to indicate the individual data points based on X/Y coordinates. Markers can be set on sparklines of display types of , , and . The type of sparkline does not currently accept markers. By default, markers are not displayed, but they can be enabled by setting the corresponding marker visibility property. Markers in the sparkline can be placed in any combination of the following locations: @@ -98,7 +98,7 @@ All of the markers mentioned above can be customized using the related marker ty The normal range feature of the {Platform} Sparkline is a horizontal stripe representing some pre-defined meaningful range when the data is being visualized. The normal range can be set as a shaded area outlined with the desired color. -The normal range can be wider than the maximum data point or beyond, and it can also be as thin as the sparkline's `Line` display type, to serve as a threshold indicator, for instance. The width of the normal range is determined by the following three properties, which serve as the minimum settings required for displaying the normal range: +The normal range can be wider than the maximum data point or beyond, and it can also be as thin as the sparkline's display type, to serve as a threshold indicator, for instance. The width of the normal range is determined by the following three properties, which serve as the minimum settings required for displaying the normal range: - `NormalRangeVisibility`: Whether the normal range is visible. - `NormalRangeMaximum`: The bottom border of the range. @@ -116,9 +116,9 @@ You can also configure whether to show the normal range in front of or behind th ## Trendlines -The {Platform} Sparkline has support for a range of trendlines that display as another layer on top of the actual sparkline layer. To display a sparkline, you can use the `TrendLineType` property. +The {Platform} Sparkline has support for a range of trendlines that display as another layer on top of the actual sparkline layer. To display a sparkline, you can use the property. -The trendlines are calculated according to the algorithm specified by the `TrendLineType` property using the values of the data the the chart is bound to. +The trendlines are calculated according to the algorithm specified by the property using the values of the data the the chart is bound to. Trendlines can only be displayed one at a time and by default, the trendline is not displayed. diff --git a/docs/xplat/src/content/en/components/charts/types/spline-chart.mdx b/docs/xplat/src/content/en/components/charts/types/spline-chart.mdx index f021977f9e..c2f75b05c6 100644 --- a/docs/xplat/src/content/en/components/charts/types/spline-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/spline-chart.mdx @@ -14,7 +14,7 @@ The {ProductName} Spline Chart belongs to a group of Category Charts that render ## {Platform} Spline Chart Example -The following example shows how to create {Platform} Spline Chart in the control by binding your data and setting the property to `Spline` enum. +The following example shows how to create {Platform} Spline Chart in the control by binding your data and setting the property to enum. @@ -27,7 +27,7 @@ The following example shows how to create {Platform} Spline Chart in the control by binding your data and setting the property to `Spline`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -40,7 +40,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Spline`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -53,7 +53,7 @@ You can create this type of chart in the control by binding your data and setting the property to `Spline`, as shown in the example below: +You can create this type of chart in the control by binding your data and setting the property to , as shown in the example below: @@ -108,9 +108,9 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | --------------------|--------------------|-------------------------- | -| Spline | `CategoryChart` | `CategoryChart.ChartType` = `Spline` | -| Stacked Spline | `DataChart` | `StackedSplineSeries` | -| Stacked 100% Spline | `DataChart` | `Stacked100SplineSeries` | +| Spline | | `CategoryChart.ChartType` = | +| Stacked Spline | | | +| Stacked 100% Spline | | |

diff --git a/docs/xplat/src/content/en/components/charts/types/stacked-chart.mdx b/docs/xplat/src/content/en/components/charts/types/stacked-chart.mdx index 3ac303019f..81f6daa1ef 100644 --- a/docs/xplat/src/content/en/components/charts/types/stacked-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/stacked-chart.mdx @@ -30,7 +30,7 @@ The following sections demonstrate individual types of {ProductName} Stacked Cha Stacked Area Charts are rendered using a collection of points connected by line segments, with the area below the line filled in and stacked on top of each other. Stacked Area Charts follow all the same requirements as [Area Chart](area-chart.md), with the only difference being that visually, the shaded areas are stacked on top of each other. -You can create this type of chart in the `DataChart` control by binding your data to a `StackedAreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -43,7 +43,7 @@ You can create this type of chart in the `DataChart` control by binding your dat ## {Platform} Stacked 100 Area Chart Sometimes the series represent part of a whole being changed over time e.g. a country's energy consumption related to the sources from which it is produced. In such cases representing all stacked elements equally may be a better idea. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100AreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -59,7 +59,7 @@ A Stacked Bar Chart, or Stacked Bar Graph, is a type of category chart that is u The Stacked Bar Chart differs from the [Bar Chart](bar-chart.md) in that the data points representing your data are stacked next to each other horizontally to visually group your data. Each stack can contain both positive and negative values. All positive values are grouped on the positive side of the X-Axis, and all negative values are grouped on the negative side of the X-Axis. -In this example of an Stacked Bar Chart, we have a Numeric X Axis (bottom labels of the chart) and a Category Y Axis (left labels of the chart). You can create this type of chart in the `DataChart` control by binding your data to a `StackedBarSeries`, as shown in the example below. +In this example of an Stacked Bar Chart, we have a Numeric X Axis (bottom labels of the chart) and a Category Y Axis (left labels of the chart). You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -73,7 +73,7 @@ In this example of an Stacked Bar Chart, we have a Numeric X Axis (bottom labels The {Platform} Stacked 100% Bar Chart is identical to the {Platform} stacked bar chart in all aspects except in their treatment of the values on X-Axis (bottom labels of the chart). Instead of presenting a direct representation of the data, the stacked 100% bar chart presents the data in terms of percent of the sum of all values in a data point. -In this example of a Stacked 100% Bar Chart, the Energy Product values are shown as a 100% value of all of the data in the fragments of the horizontal bars. You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100BarSeries`, as shown in the example below. +In this example of a Stacked 100% Bar Chart, the Energy Product values are shown as a 100% value of all of the data in the fragments of the horizontal bars. You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -87,7 +87,7 @@ In this example of a Stacked 100% Bar Chart, the Energy Product values are shown The Stacked Column Chart is identical to the [Column Chart](column-chart.md) in all aspects, except the series are represented on top of one another rather than to the side. The Stacked Column Chart is used to show comparing results between series. Each stacked fragment in the collection represents one visual element in each stack. Each stack can contain both positive and negative values. All positive values are grouped on the positive side of the Y-Axis, and all negative values are grouped on the negative side of the Y-Axis. The Stacked Column Chart uses the same concepts of data plotting as the Stacked Bar Chart but data points are stacked along vertical line (Y-Axis) rather than along horizontal line (X-Axis). -You can create this type of chart in the `DataChart` control by binding your data to a `StackedColumnSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -101,7 +101,7 @@ You can create this type of chart in the `DataChart` control by binding your dat The Stacked 100% Column Chart is identical to the Stacked Column Chart in all aspects except in their treatment of the values on Y-Axis. Instead of presenting a direct representation of the data, the Stacked 100% Column Chart presents the data in terms of percent of the sum of all values in a data point. -The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100ColumnSeries`, as shown in the example below. +The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -113,7 +113,7 @@ The example below shows a study made for online shopping traffic by departments ## {Platform} Stacked Line Chart -The Stacked Line Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the `DataChart` control by binding your data to a `StackedLineSeries`, as shown in the example below: +The Stacked Line Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the control by binding your data to a , as shown in the example below: @@ -127,7 +127,7 @@ The Stacked Line Chart is often used to show the change of value over time such The Stacked 100% Line Chart is identical to the Stacked Line Chart in all aspects except in their treatment of the values on y-axis. Instead of presenting a direct representation of the data, the Stacked 100% Line Chart presents the data in terms of percent of the sum of all values in a data point. The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100LineSeries`, as shown in the example below: +You can create this type of chart in the control by binding your data to a , as shown in the example below: @@ -141,7 +141,7 @@ You can create this type of chart in the `DataChart` control by binding your dat Stacked Spline Area Charts are rendered using a collection of points connected by curved spline segments, with the area below the curved spline fill in and stacked on top of each other. Stacked Spline Area Charts follow all of the same requirements as [Area Chart](area-chart.md), with the only difference being that the visually shaded areas are stacked on top of each other. -You can create this type of chart in the `DataChart` control by binding your data to a `StackedSplineAreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -155,7 +155,7 @@ You can create this type of chart in the `DataChart` control by binding your dat The Stacked 100% Spline Area Chart is identical to the Stacked Spline Area Chart in all aspects except for the treatment of the values on the y-axis. Instead of presenting a direct representation of the data, the Stacked 100% Spline Area Chart presents the data in terms of a percent of the sum of all values in a particular data point. Sometimes the chart represents part of a whole being changed over time. For example, a country's energy consumption related to the sources from which it is produced. In such cases, representing all stacked elements equally may be a better idea. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100SplineAreaSeries`, as shown in the example below. +You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -167,7 +167,7 @@ You can create this type of chart in the `DataChart` control by binding your dat ## {Platform} Stacked Spline Chart -The Stacked Spline Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the `DataChart` control by binding your data to a `StackedSplineSeries`, as shown in the example below. +The Stacked Spline Chart is often used to show the change of value over time such as the amount of renewable electricity produced for several years between regions. You can create this type of chart in the control by binding your data to a , as shown in the example below. @@ -181,7 +181,7 @@ The Stacked Spline Chart is often used to show the change of value over time suc The Stacked 100% Spline Chart is identical to the Stacked Spline Chart in all aspects except in their treatment of the values on y-axis. Instead of presenting a direct representation of the data, the Stacked 100% Spline Chart presents the data in terms of percent of the sum of all values in a data point. The example below shows a study made for online shopping traffic by departments via tablet, phone and personal computers. -You can create this type of chart in the `DataChart` control by binding your data to a `Stacked100SplineSeries`. +You can create this type of chart in the control by binding your data to a . @@ -207,15 +207,15 @@ The following table lists API members mentioned in the above sections: | Chart Type | Control Name | API Members | | -------------------------|----------------|-------------------------------- | -| Stacked Area | `DataChart` | `StackedAreaSeries` | -| Stacked Bar | `DataChart` | `StackedBarSeries` | -| Stacked Column | `DataChart` | `StackedColumnSeries` | -| Stacked Line | `DataChart` | `StackedLineSeries` | -| Stacked Spline | `DataChart` | `StackedSplineSeries` | -| Stacked Spline Area | `DataChart` | `StackedSplineAreaSeries` | -| Stacked 100% Area | `DataChart` | `Stacked100AreaSeries` | -| Stacked 100% Bar | `DataChart` | `Stacked100BarSeries` | -| Stacked 100% Column | `DataChart` | `Stacked100ColumnSeries` | -| Stacked 100% Line | `DataChart` | `Stacked100LineSeries` | -| Stacked 100% Spline | `DataChart` | `Stacked100SplineSeries` | -| Stacked 100% Spline Area | `DataChart` | `Stacked100SplineAreaSeries` | +| Stacked Area | | | +| Stacked Bar | | | +| Stacked Column | | | +| Stacked Line | | | +| Stacked Spline | | | +| Stacked Spline Area | | | +| Stacked 100% Area | | | +| Stacked 100% Bar | | | +| Stacked 100% Column | | | +| Stacked 100% Line | | | +| Stacked 100% Spline | | | +| Stacked 100% Spline Area | | | diff --git a/docs/xplat/src/content/en/components/charts/types/step-chart.mdx b/docs/xplat/src/content/en/components/charts/types/step-chart.mdx index 88995f328b..47e46e892d 100644 --- a/docs/xplat/src/content/en/components/charts/types/step-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/step-chart.mdx @@ -15,7 +15,7 @@ The {ProductName} Step Chart belongs to a group of category charts that render a ## {Platform} Step Area Chart -You can create {Platform} Step Area Chart in the control by setting property to `StepArea` enum, as shown in the example below. +You can create {Platform} Step Area Chart in the control by setting property to enum, as shown in the example below. @@ -28,7 +28,7 @@ You can create {Platform} Step Area Chart in the control by binding your data and setting property to `StepLine` value, as shown in the example below. +You can create Step Line Chart in the control by binding your data and setting property to value, as shown in the example below. @@ -39,7 +39,7 @@ You can create Step Line Chart in the control as demonstrated below. +If you need Step Charts with more features such as composite other series, you can configure the , , , lines' , and lines' properties on the control as demonstrated below. diff --git a/docs/xplat/src/content/en/components/charts/types/stock-chart.mdx b/docs/xplat/src/content/en/components/charts/types/stock-chart.mdx index 9f3a0d72af..7df47a834e 100644 --- a/docs/xplat/src/content/en/components/charts/types/stock-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/stock-chart.mdx @@ -15,7 +15,7 @@ The {ProductName} Stock Chart, sometimes referred to as {Platform} Financial Cha ## {Platform} Stock Chart Example -You can create Stock Chart using the control by binding your data and optionally setting property to `Line` value, as shown in the example below. +You can create Stock Chart using the control by binding your data and optionally setting property to value, as shown in the example below. @@ -96,7 +96,7 @@ If you need a Stock Chart with more features such as composite other series, you ## {Platform} Chart Annotations -The Crosshair Annotation Layer provides crossing lines that meet at the actual value of every targeted series. Crosshair types include: Horizontal, Vertical, and Both. The Crosshairs can also be configured to snap to data points by setting the `CrosshairsSnapToData` property to true, otherwise the crosshairs will be interpolated between data points. Annotations can also be enabled to display the crosshair's value along the axis. +The Crosshair Annotation Layer provides crossing lines that meet at the actual value of every targeted series. Crosshair types include: Horizontal, Vertical, and Both. The Crosshairs can also be configured to snap to data points by setting the property to true, otherwise the crosshairs will be interpolated between data points. Annotations can also be enabled to display the crosshair's value along the axis. The Final Value Layer provides a quick view along the axis of the ending value displayed in a series. @@ -124,20 +124,20 @@ The following panes are available: Financial Indicators are often used by traders to measure changes and to show trends in stock prices. These indicators are usually displayed below the price pane because they do not share the same Y-Axis scale. By default the indicator panes are not displayed. The toolbar allows the end user to select which indicator to display at run time. -In order to display an indicator pane initially, the `IndicatorTypes` property must be set to a least one type of indicator, as demonstrated in the following code: +In order to display an indicator pane initially, the property must be set to a least one type of indicator, as demonstrated in the following code: ### Volume Pane The volume pane represents the number of shares traded during a given period. Low volume would indicate little interest, while high volume would indicate high interest with a lot of trades. This can be displayed using column, line or area chart types. The toolbar allows the end user to display the volume pane by selecting a chart type to render the data at runtime. In order the display the pane, a volume type must be set, as demonstrated in the following code: ### Price Pane -This pane displays stock prices and shows the stock's high, low, open and close prices over time. In addition it can display trend lines and overlays. Your end user can choose different chart types from the toolbar. By default, the chart type is set to `Auto`. You can override the default setting, as demonstrated in the following code: +This pane displays stock prices and shows the stock's high, low, open and close prices over time. In addition it can display trend lines and overlays. Your end user can choose different chart types from the toolbar. By default, the chart type is set to . You can override the default setting, as demonstrated in the following code: Note that is recommended to use line chart type if plotting multiple data sources or if plotting data source with a lot of data points. ### Zoom Pane -This pane controls the zoom of all the displayed panes. This pane is displayed by default. It can be turned off by setting the `ZoomSliderType` to `none` as demonstrated in the following code: +This pane controls the zoom of all the displayed panes. This pane is displayed by default. It can be turned off by setting the to `none` as demonstrated in the following code: -Note that you should set the `ZoomSliderType` option to the same value as the `ChartType` option is set to. This way, the zoom slider will show correct preview of the price pane. The following code demonstrates how to do this: +Note that you should set the option to the same value as the option is set to. This way, the zoom slider will show correct preview of the price pane. The following code demonstrates how to do this: In this example, the stock chart is plotting revenue for United States. diff --git a/docs/xplat/src/content/en/components/charts/types/treemap-chart.mdx b/docs/xplat/src/content/en/components/charts/types/treemap-chart.mdx index 5b9d69103d..8592af2907 100644 --- a/docs/xplat/src/content/en/components/charts/types/treemap-chart.mdx +++ b/docs/xplat/src/content/en/components/charts/types/treemap-chart.mdx @@ -57,13 +57,13 @@ There are several common use cases for choosing a Treemap. When you: - The data source must be an array or a list of data items - The data source must contain at least one data item otherwise the map will not render any nodes. -- All data items must contain at least one data column (e.g. string) which should be mapped to the `LabelMemberPath` property. -- All data items must contain at least one numeric data column which should be mapped using the `ValueMemberPath` property. -- To categorize data into organized tiles you can optionally use `ParentIdMemberPath` and `IdMemberPath`. +- All data items must contain at least one data column (e.g. string) which should be mapped to the  property. +- All data items must contain at least one numeric data column which should be mapped using the  property. +- To categorize data into organized tiles you can optionally use  and . ## {Platform} Treemap Configuration -In the following example, the treemap demonstrates the ability of changing it's algorithmic structure by modifying the `LayoutType` and `LayoutOrientation` properties. +In the following example, the treemap demonstrates the ability of changing it's algorithmic structure by modifying the and properties. @@ -87,9 +87,9 @@ The Treemap allows you to choose the algorithm that is best for your requirement ### Layout Orientation -`LayoutOrientation` property enables the user to set the direction in which the nodes of the hierarchy will be expanded. + property enables the user to set the direction in which the nodes of the hierarchy will be expanded. -Note that the `LayoutOrientation` property works with the layout types SliceAndDice and Strip. +Note that the property works with the layout types SliceAndDice and Strip. - `Horizontal` – the child nodes are going to be stacked horizontally(SliceAndDice). - `Vertical` – the child nodes are going to be stacked vertically (SliceAndDice). @@ -103,17 +103,17 @@ In the following example, the treemap demonstrates the ability of changing the l ### {Platform} Treemap Highlighting -In the following example, the treemap demonstrates the ability of node highlighting. There are two options for this feature. Each node can individually brighten, by decreasing its opacity, or cause all other nodes to trigger the same effect. To enable this feature, set `HighlightingMode`to Brighten or FadeOthers. +In the following example, the treemap demonstrates the ability of node highlighting. There are two options for this feature. Each node can individually brighten, by decreasing its opacity, or cause all other nodes to trigger the same effect. To enable this feature, set to Brighten or FadeOthers. ## {Platform} Treemap Percent based highlighting -- `HighlightedItemsSource`: Specifies the datasource to read highlighted values from. If null, then highlighted values are read from the ItemsSource property. -- `HighlightedValueMemberPath`: Specifies the name of the property in the datasource where the highlighted values are read. -- `HighlightedValueOpacity`: Controls the opacity of the normal value behind the highlighted value. -- `HighlightedValuesDisplayMode`: Enables or disables highlighted values. +- : Specifies the datasource to read highlighted values from. If null, then highlighted values are read from the ItemsSource property. +- : Specifies the name of the property in the datasource where the highlighted values are read. +- : Controls the opacity of the normal value behind the highlighted value. +- : Enables or disables highlighted values. - Auto: The treemap decides what mode to use. - Overlay: The treemap displays highlighted values over top the normal value with a slight opacity applied to the normal value. - Hidden: The treemap does not show highlighted values. diff --git a/docs/xplat/src/content/en/components/dashboard-tile.mdx b/docs/xplat/src/content/en/components/dashboard-tile.mdx index 5acbcc50ba..92577a0297 100644 --- a/docs/xplat/src/content/en/components/dashboard-tile.mdx +++ b/docs/xplat/src/content/en/components/dashboard-tile.mdx @@ -16,7 +16,7 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; # {Platform} Dashboard Tile -The {Platform} 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 that let you alter the visualization that is presented in a variety of ways. +The {Platform} 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 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. @@ -155,7 +155,7 @@ You are not locked into a single visualization when you bind the `DataSource`, a -The visualization or properties of the visualization are also configurable using the at the top of the control. This has the default tools for the current visualization with the addition of four Dashboard Tile specific ones, highlighted below: +The visualization or properties of the visualization are also configurable using the at the top of the control. This has the default tools for the current visualization with the addition of four Dashboard Tile specific ones, highlighted below: Dashboard Tile Toolbar @@ -164,7 +164,7 @@ 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` or `ExcludedProperties` collection on the control. +- 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 or collection on the control. This demo demonstrates dashboard tile integration with the {Platform} Pie Chart. The toolbar options at the top right provides access to styling and changing the data visualization. @@ -180,7 +180,7 @@ This demo demonstrates dashboard tile integration with the {Platform} Geographic -
+



diff --git a/docs/xplat/src/content/en/components/excel-library-using-cells.mdx b/docs/xplat/src/content/en/components/excel-library-using-cells.mdx index 0073f5c484..3374709ce9 100644 --- a/docs/xplat/src/content/en/components/excel-library-using-cells.mdx +++ b/docs/xplat/src/content/en/components/excel-library-using-cells.mdx @@ -46,7 +46,7 @@ import { FormattedString } from "{PackageExcel}"; ## Referencing Cells and Regions -You can access a object or a object by calling the object’s `GetCell` or `GetRegion` methods, respectively. Both methods accept a string parameter that references a cell. Getting a reference to a cell is useful when applying formats or working with formulas and cell contents. +You can access a object or a object by calling the object’s or methods, respectively. Both methods accept a string parameter that references a cell. Getting a reference to a cell is useful when applying formats or working with formulas and cell contents. The following example code demonstrates how to reference cells and regions: @@ -78,7 +78,7 @@ var region = worksheet.GetRegion("G1:G10"); In Microsoft Excel, individual cells, as well as cell regions can have names assigned to them. The name of a cell or region can be used to reference that cell or region instead of their address. -The Infragistics {Platform} Excel Library supports the referencing of cells and regions by name through the `GetCell` and `GetRegion` methods of the object. You refer to the cell or region using the `NamedReference` instance that refers to that cell or region. +The Infragistics {Platform} Excel Library supports the referencing of cells and regions by name through the and methods of the object. You refer to the cell or region using the instance that refers to that cell or region. You can use the following code snippet as an example for naming a cell or region: @@ -152,7 +152,7 @@ worksheet.Rows[0].Cells[0].Comment = cellComment; ## Adding a Formula to a Cell -The Infragistics {Platform} Excel Library allows you to add Microsoft Excel formulas to a cell or group of cells in a worksheet. You can do this using the object’s `ApplyFormula` method or by instantiating a object and applying it to a cell. Regardless of the manner in which you apply a formula to a cell, you can access the object using the object’s property. If you need the value, use the cell’s `Value` property. +The Infragistics {Platform} Excel Library allows you to add Microsoft Excel formulas to a cell or group of cells in a worksheet. You can do this using the object’s method or by instantiating a object and applying it to a cell. Regardless of the manner in which you apply a formula to a cell, you can access the object using the object’s property. If you need the value, use the cell’s property. The following code shows you how to add a formula to a cell. @@ -181,7 +181,7 @@ sumFormula.ApplyTo(worksheet.Rows[5].Cells[0]);
## Copying a Cell’s Format -Cells can have different formatting, including background color, format string, and font style. If you need a cell to have the same format as a previously formatted cell, instead of individually setting each option exposed by the object’s property, you can call the object’s `SetFormatting` method and pass it a object to copy. This will copy every format setting from the first cell to the second cell. You can also do this for a row, merged cell region, or column. +Cells can have different formatting, including background color, format string, and font style. If you need a cell to have the same format as a previously formatted cell, instead of individually setting each option exposed by the object’s property, you can call the object’s method and pass it a object to copy. This will copy every format setting from the first cell to the second cell. You can also do this for a row, merged cell region, or column. The following code shows you how to copy the format of the 2nd column to the 4th column: @@ -215,7 +215,7 @@ worksheet.Columns[3].CellFormat.SetFormatting(worksheet.Columns[1].CellFormat); ## Formatting a Cell -The Infragistics {Platform} Excel Library allows you to customize the look and behavior of a cell. You can customize a cell by setting properties exposed by the property of the , , , or `WorksheetMergedCellsRegion` objects. +The Infragistics {Platform} Excel Library allows you to customize the look and behavior of a cell. You can customize a cell by setting properties exposed by the property of the , , , or objects. You can customize every aspect of a cell’s appearance. You can set a cell’s font, background, and borders, as well as text alignment and rotation. You can even apply a different format on a character-by-character basis for a cell’s text. @@ -249,9 +249,9 @@ You can create all possible fill types using static properties and methods on th - `NoColor` - A property that represents a fill with no color, which allows a background image of the worksheet, if any, to show through. -- `CreateSolidFill` - Returns a instance which has a pattern style of `Solid` and a background color set to the `Color` or specified in the method. +- `CreateSolidFill` - Returns a instance which has a pattern style of `Solid` and a background color set to the or specified in the method. -- `CreatePatternFill` - Returns a instance which has the specified pattern style and the `Color` or values, specified for the background and pattern colors. +- `CreatePatternFill` - Returns a instance which has the specified pattern style and the or values, specified for the background and pattern colors. - `CreateLinearGradientFill` - Returns a instance with the specified angle and gradient stops. @@ -329,7 +329,7 @@ Each workbook has 12 associated theme colors. They are the following: Colors are defined by the class, which is a sealed immutable class. The class has a static `Automatic` property, which returns the automatic color, and there are various constructors which allow you to create a instance with a color or a theme value and an optional tint. -The `GetResolvedColor` method on allows you to determine what color will actually be seen by the user when they open the file in Excel. +The method on allows you to determine what color will actually be seen by the user when they open the file in Excel. If the represents a theme color, you must pass in a Workbook instance to the method so it can get the theme color’s RGB value from the workbook. @@ -341,35 +341,35 @@ When the older formats are opened in Microsoft Excel 2003 and earlier versions, You can set a host of different formats on a by using the object returned by the property of that cell. This object enables you to style many different aspects of the cell such as borders, font, fill, alignments, and whether or not the cell should shrink to fit or be locked. -You can also access the built-in styles to Microsoft Excel 2007 using the `Styles` collection of the object. The full list of styles in Excel can be found in the Cell Styles gallery of the Home tab of Microsoft Excel 2007. +You can also access the built-in styles to Microsoft Excel 2007 using the collection of the object. The full list of styles in Excel can be found in the Cell Styles gallery of the Home tab of Microsoft Excel 2007. -There is a special type of style on the workbook’s `Styles` collection known as the "normal" style, which can be accessed using that collection’s `NormalStyle` property, or by indexing into the collection with the name "Normal". +There is a special type of style on the workbook’s collection known as the "normal" style, which can be accessed using that collection’s property, or by indexing into the collection with the name "Normal". -The `NormalStyle` contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing the properties on the `NormalStyle` will change all of the default cell format properties on the workbook. This is useful, for example, if you want to change the default font for your workbook. +The contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing the properties on the will change all of the default cell format properties on the workbook. This is useful, for example, if you want to change the default font for your workbook. -You can clear the `Styles` collection or reset it to its predefined state by using the `Clear` and `Reset` methods, respectively. Both of these will remove all user-defined styles, but `Clear` will clear the `Styles` collection entirely. +You can clear the collection or reset it to its predefined state by using the and methods, respectively. Both of these will remove all user-defined styles, but will clear the collection entirely. -With this feature, a `Style` property has been added to the object. This is a reference to a instance, representing the parent style of the format. For formats of a style, this property will always be null, because styles cannot have a parent style. For row, column, and cell formats, the `Style` property always returns the `NormalStyle` by default. +With this feature, a property has been added to the object. This is a reference to a instance, representing the parent style of the format. For formats of a style, this property will always be null, because styles cannot have a parent style. For row, column, and cell formats, the property always returns the by default. -If the `Style` property is set to null, it will revert back to the `NormalStyle`. If it is set to another style in the styles collection, that style will now hold the defaults for all unset properties on the cell format. +If the property is set to null, it will revert back to the . If it is set to another style in the styles collection, that style will now hold the defaults for all unset properties on the cell format. -When the `Style` property is set on a cell format, the format options included on the `Style` are removed from the cell format. All other properties are left intact. For example, if a cell style including border formatting was created and that style was set as the cell’s `Style`, the border format option on the cell format would be removed and the cell format only includes fill formatting. +When the property is set on a cell format, the format options included on the are removed from the cell format. All other properties are left intact. For example, if a cell style including border formatting was created and that style was set as the cell’s , the border format option on the cell format would be removed and the cell format only includes fill formatting. When a format option flag is removed from a format, all associated properties are reset to their unset values, so the cell format’s border properties are implicitly reset to default/unset values. -You can determine what would really be seen in cells by using the `GetResolvedCellFormat` method on classes which represent a row, column, cell, and merged cell. +You can determine what would really be seen in cells by using the method on classes which represent a row, column, cell, and merged cell. -This method returns a instance which refers back to the associated on which it is based. So subsequent changes to the property will be reflected in the instance returned from a `GetResolvedCellFormat` call. +This method returns a instance which refers back to the associated on which it is based. So subsequent changes to the property will be reflected in the instance returned from a call. ## Merging Cells Aside from setting the value or format of cells, you can also merge cells to make two or more cells appear as one. If you merge cells, they must be in a rectangular region. -When you merge cells, each cell in the region will have the same value and cell format. The merged cells will also be associated with the same `WorksheetMergedCellsRegion` object, accessible from their `AssociatedMergedCellsRegion` property. The resultant `WorksheetMergedCellsRegion` object will also have the same value and cell format as the cells. +When you merge cells, each cell in the region will have the same value and cell format. The merged cells will also be associated with the same object, accessible from their property. The resultant object will also have the same value and cell format as the cells. Setting the value (or cell format) of the region or any cell in the region will change the value of all cells and the region. If you un-merge cells, all of the previously merged cells will retain the shared cell format they had before they were unmerged. However, only the top-left cell of the region will retain the shared value. -In order to create a merged cell region, you must add a range of cells to the object’s `MergedCellsRegions` collection. This collection exposes an `Add` method that takes four integer parameters. The four parameters determine the index of the starting row and column (top-left most cell) and the index of the ending row and column (bottom-right most cell). +In order to create a merged cell region, you must add a range of cells to the object’s collection. This collection exposes an `Add` method that takes four integer parameters. The four parameters determine the index of the starting row and column (top-left most cell) and the index of the ending row and column (bottom-right most cell). ```ts var workbook = new Workbook(); @@ -455,11 +455,11 @@ If a text is used in the cell, the cell displayed text will always be full value The only time when this is not the case is when padding characters are used in format string. Then the value will be displayed as all hash marks when there is not enough room for the text. -You can set the worksheet's `DisplayOptions`' `ShowFormulasInCells` property to have formulas be displayed in cells instead of their results, and format strings and cell widths are ignored. Text values display as if their format string were @ , non-integral numeric values display as if their format string were 0.0 and integral numeric values display as if their format string were 0 . +You can set the worksheet's ' property to have formulas be displayed in cells instead of their results, and format strings and cell widths are ignored. Text values display as if their format string were @ , non-integral numeric values display as if their format string were 0.0 and integral numeric values display as if their format string were 0 . Additionally, if the value cannot fit, it will not display as all hashes. Display text will still return its full text as the cell text, even though it may not be fully seen. -The following code snippet demonstrates the usage of the `GetText` method to get the text as it would be displayed in Excel: +The following code snippet demonstrates the usage of the method to get the text as it would be displayed in Excel: ```ts var workbook = new Workbook(); diff --git a/docs/xplat/src/content/en/components/excel-library-using-tables.mdx b/docs/xplat/src/content/en/components/excel-library-using-tables.mdx index 07da899b24..9b43a189af 100644 --- a/docs/xplat/src/content/en/components/excel-library-using-tables.mdx +++ b/docs/xplat/src/content/en/components/excel-library-using-tables.mdx @@ -25,7 +25,7 @@ The Infragistics {Platform} Excel Engine's ## Adding a Table to a Worksheet -Worksheet tables in the Infragistics {Platform} Excel Engine are represented by the object and are added in the worksheet's `Tables` collection. In order to add a table, you need to invoke the `Add` method on this collection. In this method, you can specify the region in which you would like to add a table, whether or not the table should contain headers, and optionally, specify the table's style as a `WorksheetTableStyle` object. +Worksheet tables in the Infragistics {Platform} Excel Engine are represented by the object and are added in the worksheet's collection. In order to add a table, you need to invoke the `Add` method on this collection. In this method, you can specify the region in which you would like to add a table, whether or not the table should contain headers, and optionally, specify the table's style as a object. The following code demonstrates how you can add a table with headers to a spanning a region of A1 to G10, where A1 to G1 will be the column headers: @@ -47,7 +47,7 @@ worksheet.Tables.Add("A1:G10", true);
-Once you have added a table, you can modify it by adding or deleting rows and columns by calling the `InsertColumns`, `InsertDataRows`, `DeleteColumns`, or `DeleteDataRows` methods on the . You can also set a new table range by using the `Resize` method of the table. +Once you have added a table, you can modify it by adding or deleting rows and columns by calling the , , , or methods on the . You can also set a new table range by using the method of the table. The following code snippet shows the usage of these methods: @@ -100,19 +100,19 @@ table.Resize("A1:G15"); ## Filtering Tables Filtering is done by applying a filter on a column in the . When the filter is applied on a column, all filters in the table will be reevaluated to determine which rows meet the criteria of all filters applied. -If the data in the table is subsequently changed or you change the `Hidden` property of the rows, the filter conditions will not automatically reevaluate. The filter conditions in a table are only reapplied when table column filters are added, removed, modified, or when the `ReapplyFilters` method is called on the table. +If the data in the table is subsequently changed or you change the `Hidden` property of the rows, the filter conditions will not automatically reevaluate. The filter conditions in a table are only reapplied when table column filters are added, removed, modified, or when the method is called on the table. The following are the filter types available to the columns of your : -- `AverageFilter` - Cells can be filtered based on whether they are above or below the average value of all cells in the column. -- `CustomFilter` - Cells can be filtered based on one or more custom conditions. -- `DatePeriodFilter` - Only cells with dates in a specific month or quarter of any year will be displayed. -- `FillFilter` - Only cells with a specific fill will be displayed. -- `FixedValuesFilter` - Cells which only match specific display values or which fall within a specific group of dates/times will be displayed. -- `FontColorFilter` - Only cells with a specific font color will be displayed. -- `RelativeDateRangeFilter` - Cells with date values can be filtered based on whether they occur within a relative time range of the date when the filter was applied, such as the next day or previous quarter. -- `TopOrBottomFilter` - This filter allows for filtering the top or bottom N values. It also allows filtering the top or bottom N% values. -- `YearToDateFilter` - Cells with date values can be filtered if they occur between the start of the year and the date on which the filter was applied. +- - Cells can be filtered based on whether they are above or below the average value of all cells in the column. +- - Cells can be filtered based on one or more custom conditions. +- - Only cells with dates in a specific month or quarter of any year will be displayed. +- - Only cells with a specific fill will be displayed. +- - Cells which only match specific display values or which fall within a specific group of dates/times will be displayed. +- - Only cells with a specific font color will be displayed. +- - Cells with date values can be filtered based on whether they occur within a relative time range of the date when the filter was applied, such as the next day or previous quarter. +- - This filter allows for filtering the top or bottom N values. It also allows filtering the top or bottom N% values. +- - Cells with date values can be filtered if they occur between the start of the year and the date on which the filter was applied. The following code snippet demonstrates how to apply an "above average" filter to a 's first column: @@ -139,20 +139,20 @@ table.Columns[0].ApplyAverageFilter(Documents.Excel.Filtering.AverageFilterType. ## Sorting Tables Sorting is done by setting a sorting condition on a table column. When a sorting condition is set on a column, all sorting conditions in the table will be reevaluated to determine the order of the cells in the table. When cells need to be moved to meet their sort criteria, the entire row of cells in the table is moved as a unit. -If the data in the table is subsequently changed, the sort conditions do not automatically reevaluate. The sort conditions in a table are only reapplied when sort conditions are added, removed, modified, or when the `ReapplySortConditions` method is called on the table. When sorting conditions are reevaluated, only the visible cells are sorted. All cells in hidden rows are kept in place. +If the data in the table is subsequently changed, the sort conditions do not automatically reevaluate. The sort conditions in a table are only reapplied when sort conditions are added, removed, modified, or when the method is called on the table. When sorting conditions are reevaluated, only the visible cells are sorted. All cells in hidden rows are kept in place. -In addition to accessing sort conditions from the table columns, they are also exposed off the 's SortSettings property's `SortConditions` collection. This is an ordered collection of columns/sort condition pairs. The order of this collection is the precedence of the sorting. +In addition to accessing sort conditions from the table columns, they are also exposed off the 's SortSettings property's collection. This is an ordered collection of columns/sort condition pairs. The order of this collection is the precedence of the sorting. The following sort condition types are available to set on columns: -- `OrderedSortCondition` - Sort cells in an ascending or descending order based on their value. -- `CustomListSortCondition` - Sort cells in a defined order based on their text or display value. For example, this might be useful for sorting days as they appear on a calendar, rather than alphabetically. -- `FillSortCondition` - Sort cells based on whether their fill is a specific pattern or gradient. -- `FontColorSortCondition` - Sort cells based on whether their font is a specific color. +- - Sort cells in an ascending or descending order based on their value. +- - Sort cells in a defined order based on their text or display value. For example, this might be useful for sorting days as they appear on a calendar, rather than alphabetically. +- - Sort cells based on whether their fill is a specific pattern or gradient. +- - Sort cells based on whether their font is a specific color. -There is also a `CaseSensitive` property on the SortSettings of the to determine whether strings should be sorted case sensitively or not. +There is also a property on the SortSettings of the to determine whether strings should be sorted case sensitively or not. -The following code snippet demonstrates how to apply an `OrderedSortCondition` to a : +The following code snippet demonstrates how to apply an to a : ```ts var workbook = new Workbook(WorkbookFormat.Excel2007); diff --git a/docs/xplat/src/content/en/components/excel-library-using-workbooks.mdx b/docs/xplat/src/content/en/components/excel-library-using-workbooks.mdx index 2f979a8fce..a0556e8338 100644 --- a/docs/xplat/src/content/en/components/excel-library-using-workbooks.mdx +++ b/docs/xplat/src/content/en/components/excel-library-using-workbooks.mdx @@ -25,7 +25,7 @@ The Infragistics {Platform} Excel Engine enables you to save data to and load da ## Change Default Font -First create a new instance of . Next, add the new font to the `Styles` collection of the . This style contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing properties of the style will change the default cell format properties in the workbook. +First create a new instance of . Next, add the new font to the collection of the . This style contains the default properties for all cells in the workbook, unless otherwise specified on a row, column, or cell. Changing properties of the style will change the default cell format properties in the workbook. ```ts var workbook = new Workbook(); @@ -50,23 +50,23 @@ font.Height = 16 * 20; Microsoft Excel® document properties provide information to help organize and keep track of your documents. You can use the Infragistics {Platform} Excel Library to set these properties using the object’s property. The available properties are: -- `Author` +- -- `Title` +- -- `Subject` +- -- `Keywords` +- -- `Category` +- -- `Status` +- -- `Comments` +- -- `Company` +- -- `Manager` +- The following code demonstrates how to create a workbook and set its `title` and `status` document properties. diff --git a/docs/xplat/src/content/en/components/excel-library-using-worksheets.mdx b/docs/xplat/src/content/en/components/excel-library-using-worksheets.mdx index 45f8720f1d..2b85651069 100644 --- a/docs/xplat/src/content/en/components/excel-library-using-worksheets.mdx +++ b/docs/xplat/src/content/en/components/excel-library-using-worksheets.mdx @@ -115,7 +115,7 @@ worksheet.DisplayOptions.ShowRowAndColumnHeaders = false;
## Configuring Editing of the Worksheet -By default, the objects that you save will be editable. You can disable editing of a worksheet by protecting it using the object's `Protect` method. This method has a lot of nullable `bool` arguments that determine which pieces are protected, and one of these options is to allow editing of objects, which if set to **false** will prevent editing of the worksheet. +By default, the objects that you save will be editable. You can disable editing of a worksheet by protecting it using the object's method. This method has a lot of nullable `bool` arguments that determine which pieces are protected, and one of these options is to allow editing of objects, which if set to **false** will prevent editing of the worksheet. The following code demonstrates how to disable editing in your worksheet: @@ -137,9 +137,9 @@ worksheet.Protect();
-You can also use the object's `Protect` method to protect a worksheet against structural changes. +You can also use the object's method to protect a worksheet against structural changes. -When protection is set, you can set the object's `Locked` property on individual cells, rows, merged cell regions, or columns to override the worksheet object's protection on those objects. For example, if you need all cells of a worksheet to be read-only except for the cells of one column, you can protect the worksheet and then set the object's `Locked` property to **false** on a specific object. This will allow your users to edit cells within the column while disabling editing of the other cells in the worksheet. +When protection is set, you can set the object's property on individual cells, rows, merged cell regions, or columns to override the worksheet object's protection on those objects. For example, if you need all cells of a worksheet to be read-only except for the cells of one column, you can protect the worksheet and then set the object's property to **false** on a specific object. This will allow your users to edit cells within the column while disabling editing of the other cells in the worksheet. The following code demonstrates how you can do this: @@ -164,24 +164,24 @@ worksheet.Columns[0].CellFormat.Locked = ExcelDefaultableBoolean.False;
## Filtering Worksheet Regions -Filtering is done by setting a filter condition on a worksheet's which can be retrieved from the object's property. Filter conditions are only reapplied when they're added, removed, modified, or when the `ReapplyFilters` method is called on the worksheet. They are not constantly evaluated as data within the region changes. +Filtering is done by setting a filter condition on a worksheet's which can be retrieved from the object's property. Filter conditions are only reapplied when they're added, removed, modified, or when the method is called on the worksheet. They are not constantly evaluated as data within the region changes. -You can specify the region to apply the filter by using the `SetRegion` method on the object. +You can specify the region to apply the filter by using the method on the object. Below is a list of methods and their descriptions that you can use to add a filter to a worksheet: | Method | Description | | --------------|-------------| -|`ApplyAverageFilter`|Represents a filter which can filter data based on whether the data is below or above the average of the entire data range.| -|`ApplyDatePeriodFilter`|Represents a filter which can filter dates in a Month, or quarter of any year.| -|`ApplyFillFilter`|Represents a filter which will filter cells based on their background fills. This filter specifies a single CellFill. Cells of with this fill will be visible in the data range. All other cells will be hidden.| +||Represents a filter which can filter data based on whether the data is below or above the average of the entire data range.| +||Represents a filter which can filter dates in a Month, or quarter of any year.| +||Represents a filter which will filter cells based on their background fills. This filter specifies a single CellFill. Cells of with this fill will be visible in the data range. All other cells will be hidden.| |`ApplyFixedValuesFilter`|Represents a filter which can filter cells based on specific, fixed values, which are allowed to display.| -|`ApplyFontColorFilter`|Represents a filter which will filter cells based on their font colors. This filter specifies a single color. Cells with this color font will be visible in the data range. All other cells will be hidden.| -|`ApplyIconFilter`|Represents a filter which can filter cells based on their conditional formatting icon.| -|`ApplyRelativeDateRangeFilter`|Represents a filter which can filter date cells based on dates relative to the when the filter was applied.| -|`ApplyTopOrBottomFilter`|Represents a filter which can filter in cells in the upper or lower portion of the sorted values.| -|`ApplyYearToDateFilter`|Represents a filter which can filter in date cells if the dates occur between the start of the current year and the time when the filter is evaluated.| -|`ApplyCustomFilter`|Represents a filter which can filter data based on one or two custom conditions. These two filter conditions can be combined with a logical "and" or a logical "or" operation.| +||Represents a filter which will filter cells based on their font colors. This filter specifies a single color. Cells with this color font will be visible in the data range. All other cells will be hidden.| +||Represents a filter which can filter cells based on their conditional formatting icon.| +||Represents a filter which can filter date cells based on dates relative to the when the filter was applied.| +||Represents a filter which can filter in cells in the upper or lower portion of the sorted values.| +||Represents a filter which can filter in date cells if the dates occur between the start of the current year and the time when the filter is evaluated.| +||Represents a filter which can filter data based on one or two custom conditions. These two filter conditions can be combined with a logical "and" or a logical "or" operation.| You can use the following code snippet as an example to add a filter to a worksheet region: @@ -208,7 +208,7 @@ worksheet.FilterSettings.ApplyAverageFilter(0, Documents.Excel.Filtering.Average ## Freezing and Splitting Panes You can freeze rows at the top of your worksheet or columns at the left using the freezing panes features. Frozen rows and columns remain visible at all times while the user is scrolling. The frozen rows and columns are separated from the rest of the worksheet by a single, solid line, which cannot be removed. -In order to enable pane freezing, you need to set the property of the object's to **true**. You can then specify the rows or columns to freeze by using the `FrozenRows` and `FrozenColumns` properties of the display options `FrozenPaneSettings`, respectively. +In order to enable pane freezing, you need to set the property of the object's to **true**. You can then specify the rows or columns to freeze by using the `FrozenRows` and `FrozenColumns` properties of the display options , respectively. You can also specify the first row in the bottom pane or first column in the right pane using the `FirstRowInBottomPane` and `FirstColumnInRightPane` properties, respectively. @@ -273,7 +273,7 @@ Sorting is done by setting a sorting condition on a worksheet level object on ei This is done by specifying a region and sort type to the object's that can be retrieved using the property of the sheet. -The sort conditions in a sheet are only reapplied when sort conditions are added, removed, modified, or when the `ReapplySortConditions` method is called on the worksheet. Columns or rows will be sorted within the region. "Rows" is the default sort type. +The sort conditions in a sheet are only reapplied when sort conditions are added, removed, modified, or when the method is called on the worksheet. Columns or rows will be sorted within the region. "Rows" is the default sort type. The following code snippet demonstrates how to apply a sort to a region of cells in a worksheet: @@ -296,7 +296,7 @@ worksheet.SortSettings.SortConditions.Add(new RelativeIndex(0), new Infragistics ## Worksheet Protection -You can protect a worksheet by calling the `Protect` method on the object. This method exposes many nullable `bool` parameters that allow you to restrict or allow the following user operations: +You can protect a worksheet by calling the method on the object. This method exposes many nullable `bool` parameters that allow you to restrict or allow the following user operations: - Editing of cells. - Editing of objects such as shapes, comments, charts, or other controls. @@ -309,7 +309,7 @@ You can protect a worksheet by calling the `Protect` method on the object. +You can remove worksheet protection by calling the method on the object. The following code snippet shows how to enable protection of all of the above-listed user operations: @@ -333,11 +333,11 @@ worksheet.Protect(); ## Worksheet Conditional Formatting -You can configure the conditional formatting of a object by using the many "Add" methods exposed on the `ConditionalFormats` collection of that worksheet. The first parameter of these "Add" methods is the `string` region of the worksheet that you would like to apply the conditional format to. +You can configure the conditional formatting of a object by using the many "Add" methods exposed on the collection of that worksheet. The first parameter of these "Add" methods is the `string` region of the worksheet that you would like to apply the conditional format to. -Many of the conditional formats that you can add to your worksheet have a property that determines the way that the elements should look when the condition in that conditional format holds true. For example, you can use the properties attached to this property such as `Fill` and `Font` to determine the background and font settings of your cells under a particular conditional format, respectively. +Many of the conditional formats that you can add to your worksheet have a property that determines the way that the elements should look when the condition in that conditional format holds true. For example, you can use the properties attached to this property such as and to determine the background and font settings of your cells under a particular conditional format, respectively. -There are a few conditional formats that do not have a property, as their visualization on the worksheet cell behaves differently. These conditional formats are the , , and `IconSetConditionalFormat`. +There are a few conditional formats that do not have a property, as their visualization on the worksheet cell behaves differently. These conditional formats are the , , and . When loading a pre-existing from Excel, the formats will be preserved when that is loaded. The same is true for when you save the out to an Excel file. diff --git a/docs/xplat/src/content/en/components/general-changelog-dv-blazor.mdx b/docs/xplat/src/content/en/components/general-changelog-dv-blazor.mdx index e01fdbde14..2a19874d75 100644 --- a/docs/xplat/src/content/en/components/general-changelog-dv-blazor.mdx +++ b/docs/xplat/src/content/en/components/general-changelog-dv-blazor.mdx @@ -17,6 +17,8 @@ import chartdefaults3 from '@xplat-images/chartDefaults3.png'; import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} Changelog @@ -162,9 +164,9 @@ As of the 2025.2 release, we no longer support .NET 6. This corresponds with the #### User Annotations -In {ProductName}, you can now annotate the `DataChart` with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. +In {ProductName}, you can now annotate the with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. +This is directly integrated with the available tools of the . {Platform} user-annotation-create @@ -172,8 +174,8 @@ This is directly integrated with the available tools of the `Toolbar`. Ability for axis annotations to automatically detect collisions and truncate to fit better. To enable this feature you must set the following properties: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### {PackageMaps} (Geographic Map) @@ -197,7 +199,7 @@ Ability for axis annotations to automatically detect collisions and truncate to - The merging can be configured on the grid level to apply either: - `OnSort` - only when the column is sorted. - `Always` - always, regardless of data operations. - The default `CellMergeMode` is `OnSort`. + The default is `OnSort`. ```razor @@ -208,7 +210,7 @@ Ability for axis annotations to automatically detect collisions and truncate to - **Column Pinning** - - Added ability to pin individual columns to a specific side (start or end of the grid), so that you can now have pinning from both sides. This can be done either declaratively by setting the `PinningPosition` property on the column: + - Added ability to pin individual columns to a specific side (start or end of the grid), so that you can now have pinning from both sides. This can be done either declaratively by setting the property on the column: ```razor @@ -229,7 +231,7 @@ col.Pinned = true; ``` - - If property `PinningPosition` is not set on a column, the column will default to the position specified on the grid's pinning options for columns. + - If property is not set on a column, the column will default to the position specified on the grid's pinning options for columns. - **Sorting and Grouping Improvements** - Improved sorting algorithm efficiency using Schwartzian transformation. This is a technique, also known as decorate-sort-undecorate, which avoids recomputing the sort keys by temporarily associating them with the original data records. @@ -238,23 +240,23 @@ col.Pinned = true; - Optimized grouping operations. - **Other Improvements** - - A column's `MinWidth` and `MaxWidth` constrain the user-specified width so that it cannot go outside their bounds. - - The `PagingMode` property can now be set as simple strings "local" and "remote" and does not require importing the `GridPagingMode` enum. + - A column's and constrain the user-specified width so that it cannot go outside their bounds. + - The property can now be set as simple strings "local" and "remote" and does not require importing the `GridPagingMode` enum. ### General #### Added -- `DateRangePicker` +- #### Changed - Updated the readonly styles of most form associated components across all themes to better signify when a component is in a readonly state. -- `Tooltip` - - Behavioral change: `Tooltip` default placement is "bottom" now. - - Behavioral change: `Tooltip` will not render an arrow indicator by default unless with-arrow is set. - - Breaking change: `Tooltip` events will no longer return its anchor target in its detail property. You can still access it at event.target.anchor. +- + - Behavioral change: default placement is "bottom" now. + - Behavioral change: will not render an arrow indicator by default unless with-arrow is set. + - Breaking change: events will no longer return its anchor target in its detail property. You can still access it at event.target.anchor. #### Deprecated -- `Tooltip` - `DisableArrow` is deprecated. Use `WithArrow` to render an arrow indicator. +- - is deprecated. Use to render an arrow indicator. ### Bug Fixes @@ -270,21 +272,21 @@ col.Pinned = true; **Breaking Changes** -- `AzureMapsMapImagery` was renamed to `AzureMapsImagery` +- `AzureMapsMapImagery` was renamed to - `AzureMapsImageryStyle.Imagery` was renamed to `AzureMapsImageryStyle.Satellite` -- The following `AzureMapsImageryStyle` enum values were renamed to include the Overlay suffix: - - `TerraOverlay`, - - `LabelsRoadOverlay` - - `LabelsDarkGreyOverlay` - - `HybridRoadOverlay` - - `HybridDarkGreyOverlay` - - `WeatherRadarOverlay` - - `WeatherInfraredOverlay` - - `TrafficAbsoluteOverlay` - - `TrafficRelativeOverlay` - - `TrafficRelativeDarkOverlay` - - `TrafficDelayOverlay` - - `TrafficReducedOverlay` +- The following enum values were renamed to include the Overlay suffix: + - , + - + - + - + - + - + - + - + - + - + - + - ### {PackageCharts} (Charts) @@ -301,34 +303,34 @@ The following events have been added to the `IgbDataChart` to allow you to detec #### Companion Axis -Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the `CompanionAxisEnabled` property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. +Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. #### RadialPieSeries Inset Outlines -There is a new property called `UseInsetOutlines` to control how outlines on the `RadialPieSeries` are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. +There is a new property called to control how outlines on the are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### {PackageGrids} (Grids) #### Cell Suffix Content -Added support for suffix content within the cells that allows you to add additional text or icons to the end of the cell value and style it. The full list of added properties for the cell suffix content is listed below and is available on the `DataGridColumn` and `CellInfo` class: +Added support for suffix content within the cells that allows you to add additional text or icons to the end of the cell value and style it. The full list of added properties for the cell suffix content is listed below and is available on the and class: -- `SuffixText` -- `SuffixTextColor` +- +- - `SuffixTextFont` -- `SuffixIconName` -- `SuffixIconCollectionName` -- `SuffixIconStroke` -- `SuffixIconFill` -- `SuffixIconViewBoxLeft` -- `SuffixIconViewBoxTop` -- `SuffixIconViewBoxWidth` -- `SuffixIconViewBoxHeight` -- `TextDecoration` +- +- +- +- +- +- +- +- +- Please note that the maximum size available for the icons is 24x24. You can provide an icon that is larger or smaller than this, but you will need to configure the viewbox settings in order to properly scale it to fit in the 24x24 space so it is fully visible. @@ -348,17 +350,17 @@ Please note that the maximum size available for the icons is 24x24. You can prov #### IgbBulletGraph -- Added new `LabelsVisible` property +- Added new property #### Charts - New properties added to the DataToolTipLayer, ItemToolTipLayer, and CategoryToolTipLayer to aid in styling: `ToolTipBackground`, `ToolTipBorderBrush`, and `ToolTipBorderThickness` -- New properties added to the DataLegend to aid in styling: `ContentBackground`, `ContentBorderBrush`, and `ContentBorderThickness`. The `ContentBorderBrush` and `ContentBorderThickness` default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. +- New properties added to the DataLegend to aid in styling: , , and . The and default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. -- Added a new property to `ChartMouseEventArgs` called `WorldPosition` that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. +- Added a new property to called that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. -- Added `HighlightingFadeOpacity` to `SeriesViewer` and `DomainChart`. This allows you to configure the opacity applied to highlighted series. +- Added to and . This allows you to configure the opacity applied to highlighted series. #### IgbDataGrid @@ -366,7 +368,7 @@ Please note that the maximum size available for the icons is 24x24. You can prov #### IgbLinearGauge -- Added new `LabelsVisible` property +- Added new property ## **{PackageVerChanges-25-1-AUG}** @@ -395,16 +397,16 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ### General The following properties of these components are now nullable: -- `Button`: `Form` -- `Calendar`: `SpecialDates`, `DisabledDates` -- `Combo`: `ValueKey`, `DisplayKey`, `GroupKey` -- `DatePicker`: `Value`, `Min`, `Max` -- `DateTimePicker`: `Value`, `Min`, `Max` -- `Dropdown`: `SelectedItem` -- `Input`: `Pattern`, `MinLength`, `MaxLength`, `Min`, `Max`, `Step` -- `Select`: `Value`, `SelectedItem` -- `Tile`: `ColStart`, `RowStart` -- `TileManager`: `MinColumnWidth`, `MinRowHeight`, `Gap` +- : +- : , +- : , , +- : , , +- `DateTimePicker`: , , +- : +- : , , , , , +- : , +- : , +- : , , ## **{PackageVerChanges-25-1-JULY}** @@ -440,16 +442,16 @@ For more details please visit: - Data Annotation Slice Layer - Data Annotation Strip Layer -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. -- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. +- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. - [Trendline Layer](charts/features/chart-trendlines.md) series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple [TrendlineLayer](charts/features/chart-overlays.md) series types in the chart. ### General -- `Tooltip` component provides a way to display a tooltip for a specific element. To use, set content as desired and link via the `Anchor` property to the target element's id: +- component provides a way to display a tooltip for a specific element. To use, set content as desired and link via the property to the target element's id: @@ -462,25 +464,25 @@ For more details please visit: - The tooltip can be further customized with `Show/HideDelay`, `Placement` around the target and customizable `Show/HideTriggers` events. + The tooltip can be further customized with `Show/HideDelay`, around the target and customizable `Show/HideTriggers` events. ### Changes - A number of enumerations have been renamed and/or merged with others. Renames (with affected components): - - `BaseAlertLikePosition` (`Snackbar` and `Toast`) has been renamed to `AbsolutePosition` - - `ButtonGroupAlignment` (`ButtonGroup`), `CalendarOrientation` (`Calendar`), `CardActionsOrientation` (`CardActions`), `DatePickerOrientation` (`DatePicker`), `RadioGroupAlignment` (`RadioGroup`) have been merged and renamed to `ContentOrientation` - - `CalendarBaseSelection` (`Calendar`) has been renamed to `CalendarSelection` - - `CarouselAnimationType` (`Carousel`) and `StepperHorizontalAnimation` (`Stepper`) have been merged and renamed to `HorizontalTransitionAnimation` - - `CheckboxBaseLabelPosition` (`Checkbox` and `Switch`) and `RadioLabelPosition` (`Radio`) have been merged and renamed to `ToggleLabelPosition` - - `DatePickerMode` (`DatePicker`) has been renamed to `PickerMode` - - `DatePickerHeaderOrientation` (`DatePicker`) has been renamed to/merged with `CalendarHeaderOrientation` - - `DropdownPlacement` (`Dropdown` and `Select`) has been renamed to `PopoverPlacement` - - `DropdownScrollStrategy` (`Dropdown`) and `SelectScrollStrategy` (`Select`) have been merged and renamed to `PopoverScrollStrategy` - - `SliderBaseTickOrientation` (`Slider` and `RangeSlider`) has been renamed to `SliderTickOrientation` - - `TickLabelRotation` (`Slider` and `RangeSlider`) has been renamed to `SliderTickLabelRotation` -- `Tabs` - - Simplified configuration by removing the need to define separate panel and linking the panel and tab header. The `Panel` property and the `IgbTabPanel` itself have been removed. Content can be now assigned directly to the `Tab` and header text can be set conveniently via the new `Label` property or by projecting an element to `slot="label"` for more involved customization. + - `BaseAlertLikePosition` ( and ) has been renamed to `AbsolutePosition` + - `ButtonGroupAlignment` (), `CalendarOrientation` (), `CardActionsOrientation` (), `DatePickerOrientation` (), `RadioGroupAlignment` () have been merged and renamed to `ContentOrientation` + - `CalendarBaseSelection` () has been renamed to `CalendarSelection` + - `CarouselAnimationType` () and `StepperHorizontalAnimation` () have been merged and renamed to `HorizontalTransitionAnimation` + - `CheckboxBaseLabelPosition` ( and ) and `RadioLabelPosition` () have been merged and renamed to `ToggleLabelPosition` + - `DatePickerMode` () has been renamed to `PickerMode` + - `DatePickerHeaderOrientation` () has been renamed to/merged with `CalendarHeaderOrientation` + - `DropdownPlacement` ( and ) has been renamed to `PopoverPlacement` + - `DropdownScrollStrategy` () and `SelectScrollStrategy` () have been merged and renamed to `PopoverScrollStrategy` + - `SliderBaseTickOrientation` ( and ) has been renamed to `SliderTickOrientation` + - ( and ) has been renamed to `SliderTickLabelRotation` +- + + Simplified configuration by removing the need to define separate panel and linking the panel and tab header. The `Panel` property and the `IgbTabPanel` itself have been removed. Content can be now assigned directly to the and header text can be set conveniently via the new property or by projecting an element to `slot="label"` for more involved customization. Before: @@ -525,32 +527,32 @@ For more details please visit: ``` -- `Input` - - `Min` & `Max` are now `double` instead of `string` -- `Stepper` - - `ActiveStepChangingArgsEventArgs` has been renamed to `ActiveStepChangingEventArgs` - - `ActiveStepChangedArgsEventArgs` has been renamed to `ActiveStepChangedEventArgs` +- + - & are now `double` instead of `string` +- + - `ActiveStepChangingArgsEventArgs` has been renamed to + - `ActiveStepChangedArgsEventArgs` has been renamed to - `StepperTitlePosition` now defaults to `Auto` to correctly reflect the default behavior -- `Tree` - - `TreeSelectionChangeEventArgs` has been renamed to `TreeSelectionEventArgs` -- `Textarea` - - `Autocapitalize` & `InputMode` are now `string` properties instead of explicit enums +- + - `TreeSelectionChangeEventArgs` has been renamed to +- + - & are now `string` properties instead of explicit enums ### {PackageGrids} (Grids) -- `Column` +- - Added events: `HiddenChange`, `ExpandedChange`, `WidthChange`, `PinnedChange` -- `Grid` +- - Added events: `GroupingExpressionsChange`, `GroupingExpansionStateChange` -- `RowIsland` - - Added new parameter `ParentRowData` in `GridCreatedEventArgsDetail` args for `GridCreated` event -- `Grid`, `HierarchicalGrid`, `TreeGrid` - - Added property - `ExpansionStates` - represents a list of key-value pairs [row ID, expansion state]. +- + - Added new parameter in args for `GridCreated` event +- , , + - Added property - - represents a list of key-value pairs [row ID, expansion state]. - Added event: `ExpansionStatesChange` - Type of `Rendered` event is changed from `VoidHandler` to `ComponentBoolValueChangedEventHandler` - Type of DataChanging event is changed from `ForOfDataChangingEventHandler` to `ForOfDataChangeEventHandler` - Type of DataChanged event is changed from `VoidHandler` to `ForOfDataChangeEventHandler` -- `PivotDataSelector` +- - Added events: `ColumnsExpandedChange`, `RowsExpandedChange`, `FiltersExpandedChange`, `ValuesExpandedChange` ### {PackageDashboards} (Dashboards) @@ -593,15 +595,15 @@ For more details please visit: ### Enhancements #### List -- Added new property on `ListItem` called `Selected` +- Added new property on called #### Accordion -- Added new events `Open` and `Close` +- Added new events and `Close` ### {PackageGrids} - **All Grids** - - Allow applying initial filtering through `FilteringExpressionsTree` property + - Allow applying initial filtering through property ### Bug Fixes @@ -618,7 +620,7 @@ For more details please visit: ### {PackageGrids} - **All Grids** - - Added new `DisabledSummaries` for the columns of the grid, allowing the developers to skip some of the summaries + - Added new for the columns of the grid, allowing the developers to skip some of the summaries - Encapsulate internal grid action button ### Bug Fixes @@ -633,9 +635,9 @@ For more details please visit: #### Toolbar -- Added new `GroupHeaderTextStyle` property to `Toolbar` and `ToolPanel`. If set, it will apply to all `ToolActionGroupHeader` actions. -- Added new property on `ToolAction` called `TitleHorizontalAlignment` which controls the horizontal alignment of the title text. -- Added new property on `ToolActionSubPanel` called `ItemSpacing` which controls the spacing between items inside the panel. +- Added new `GroupHeaderTextStyle` property to and . If set, it will apply to all actions. +- Added new property on called which controls the horizontal alignment of the title text. +- Added new property on called which controls the spacing between items inside the panel. ### Bug Fixes @@ -689,18 +691,18 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ### General - New [Carousel](layouts/carousel.md) component. -- `Input` - - Changed `change` event argument type from `ComponentDataValueChangedEventArgs` to `ComponentValueChangedEventArgs` +- + - Changed `change` event argument type from to ## **{PackageVerChanges-24-1-SEP}** ### {PackageCharts} (Charts) -- New [Data Pie Chart](charts/types/data-pie-chart.md) - The `DataPieChart` is a new component that renders a pie chart. This component works similarly to the `CategoryChart`, 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. +- New [Data Pie Chart](charts/types/data-pie-chart.md) - The is a new component that renders a pie chart. This component works similarly to the , 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. -- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. +- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -717,124 +719,124 @@ The following table lists the bug fixes made for the {ProductName} toolset for t - New [Banner](notifications/banner.md) component. - New [DatePicker](scheduling/date-picker.md) component. -- New `Divider` component. -- `Icon` - - Added `SetIconRef` method. This allows to register and replace icons by SVG files. +- New component. +- + - Added method. This allows to register and replace icons by SVG files. - All components now use icons by reference internally so that it's easy to replace them without explicitly providing custom templates. -- `Combo`, `DatePicker`, `Dialog`, `Dropdown`, `ExpansionPanel`, `NavDrawer`, `Toast`, `Snackbar`, **IgbSelectComponent** - - Toggle methods `Show`, `Hide`, `Toggle` methods return **true** now on success. Otherwise **false**. -- `RadioGroup` - - Added `Name` and `Value` properties. `Value` also supports two-way binding. +- , , , , , , , , **IgbSelectComponent** + - Toggle methods , , methods return **true** now on success. Otherwise **false**. +- + - Added and properties. also supports two-way binding. **Breaking Changes** - Renamed old **IgbDatePicker** to **IgbXDatePicker**. -- Removed `Form` component. Use native form instead. +- Removed component. Use native form instead. - Removed `size` property in favor of the `--ig-size` CSS custom property for the following components: - - `Avatar`, `Button`,`IconButton`, `Calendar`, `Chip`, `Dropdown`, `Icon`, `Input`, `List`, `Rating`, `Snackbar`, `Tabs`, `Tree` -- `Badge`, `Chip`, `LinearProgress`, `CircularProgress` - - Renamed `Variant` property type to `StyleVariant`. -- `Calendar` - - Renamed `WeekStart` property type to `WeekDays`. -- `Checkbox`, `Switch` - - Changed `Change` event argument type from `ComponentBoolValueChangedEventArgs` to `CheckboxChangeEventArgs`. -- `Combo` - - The `IgbCombo` is now of generic type and the `Value` type is now of type `T[]`. This means that either you need to specify `T` or it will be inferred by the assigned `Value` type. - - Removed `PositionStrategy`, `Flip`, `SameWidth` properties. + - , ,, , , , , , , , , , +- , , , + - Renamed property type to `StyleVariant`. +- + - Renamed property type to `WeekDays`. +- , + - Changed `Change` event argument type from to . +- + - The `IgbCombo` is now of generic type and the type is now of type `T[]`. This means that either you need to specify `T` or it will be inferred by the assigned type. + - Removed , , properties. - **IgbSelectComponent** - - Removed `PositionStrategy`, `Flip`, `SameWidth` properties. -- `DateTimeInput` - - Removed `MaxValue` and `MinValue` properties. Use `Max` and `Min` instead. -- `Dropdown` - - Removed `PositionStrategy` property. -- `Input` - - Removed old named `Maxlength` and `Minlength` properties. Use `MaxLength` and `MinLength`. - - Removed old named `Readonly` and `Inputmode` properties. Use `ReadOnly` and `InputMode`. - - Changed `InputMode` type also to `string`. -- `Radio` - - Changed `Change` event argument type from `ComponentBoolValueChangedEventArgs` to `RadioChangeEventArgs`. -- `RangeSlider` - - Removed `AriaThumbLower` and `AriaThumbUpper` properties. Use `ThumbLabelLower` and `ThumbLabelUpper` instead. -- `Rating` - - Renamed `Readonly` property to `ReadOnly`. + - Removed , , properties. +- + - Removed `MaxValue` and `MinValue` properties. Use and instead. +- + - Removed property. +- + - Removed old named `Maxlength` and `Minlength` properties. Use and . + - Removed old named `Readonly` and `Inputmode` properties. Use and . + - Changed type also to `string`. +- + - Changed `Change` event argument type from to . +- + - Removed `AriaThumbLower` and `AriaThumbUpper` properties. Use and instead. +- + - Renamed `Readonly` property to . ### {PackageGrids} - **All Grids** - Added `GetColumns` / `GetColumnsAsync` methods, which return the grid columns collection. - Added new `RowClick` event. -- `PivotGrid` - - Added `Sortable` property for a `PivotDimension`. - - Added horizontal layout. Can be enabled inside the new `PivotUI` property as `RowLayout` `Horizontal`. - - Added row dimension summaries for horizontal layout only. Can be enabled for each `PivotDimension` by setting `HorizontalSummary` to **true**. - - Added `HorizontalSummariesPosition` property to the `PivotUI`, configuring horizontal summaries position. - - Added row headers for the row dimensions. Can be enabled inside the new `PivotUI` property as `ShowHeaders` **true**. +- + - Added property for a . + - Added horizontal layout. Can be enabled inside the new property as `RowLayout` `Horizontal`. + - Added row dimension summaries for horizontal layout only. Can be enabled for each by setting to **true**. + - Added `HorizontalSummariesPosition` property to the , configuring horizontal summaries position. + - Added row headers for the row dimensions. Can be enabled inside the new property as `ShowHeaders` **true**. - Keyboard navigation now can move in to row headers back and forth from any row dimension headers or column headers. - Added keyboard interactions for row dimension collapse using ALT + arrows and row headers sorting using CTRL + arrows. **Breaking Changes** - **All Grids** - - `RowIsland` + - - Removed `DisplayDensity` deprecated property. - - Renamed `Columns`, `ActualColumns`, `ContentColumns` properties to `ColumnList`, `ActualColumnList` and `ContentColumnList`. Recommended to use the new `GetColumns` method instead. - - Renamed `RowDelete` and `RowAdd` event argument type to `RowDataCancelableEventArgs`. - - Renamed `ContextMenu` event argument type to `GridContextMenuEventArgs`. - - Removed `GridEditEventArgs`, `GridEditDoneEventArgs`, `PinRowEventArgs` events `RowID` and `PrimaryKey` properties. Use `RowKey` instead. -- `PivotGrid` - - removed `ShowPivotConfigurationUI` property. Use `PivotUI` and set inside it the new `ShowConfiguration` option. -- `Column` - - Removed `Movable` property. Use Grid's `Moving` property now. - - Removed `ColumnChildren` property. Use `ChildColumns` instead. -- `ColumnGroup` - - Removed `Children` property. Use `ChildColumns` instead. -- `Paginator` - - Removed `IsFirstPageDisabled` and `IsLastPageDisabled` properties. Use `IsFirstPage` and `IsLastPage` instead. + - Renamed , , `ContentColumns` properties to , and `ContentColumnList`. Recommended to use the new `GetColumns` method instead. + - Renamed `RowDelete` and `RowAdd` event argument type to . + - Renamed `ContextMenu` event argument type to . + - Removed , , events `RowID` and properties. Use `RowKey` instead. +- + - removed `ShowPivotConfigurationUI` property. Use and set inside it the new `ShowConfiguration` option. +- + - Removed `Movable` property. Use Grid's property now. + - Removed `ColumnChildren` property. Use instead. +- + - Removed property. Use instead. +- + - Removed `IsFirstPageDisabled` and `IsLastPageDisabled` properties. Use and instead. ## **{PackageVerChanges-24-1-JUN}** ### General -- `Input`, `Textarea` - exposed `ValidateOnly` to enable validation rules being enforced without restricting user input. -- `Dropdown` - `PositionStrategy` property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. -- `DockManager` - `SplitPane` `IsMaximized` is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the `IsMaximized` property of `TabGroupPane` and/or `ContentPane` instead. +- , - exposed to enable validation rules being enforced without restricting user input. +- - property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. +- - is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the property of and/or instead. ### {PackageGrids} - `DisplayDensity` deprecated in favor of the `--ig-size` CSS custom property. Check out the [Grid Size](grids/grid/size.md) topic for more. -- `PivotGrid` - The type of Columns, Rows, Filters from `PivotConfiguration` option is now array of IgbPivotDimension - `IgbPivotDimension[]`, it was `IgbPivotDimensionCollection` previously. +- - The type of Columns, Rows, Filters from option is now array of IgbPivotDimension - `IgbPivotDimension[]`, it was `IgbPivotDimensionCollection` previously. -The type of Values from `PivotConfiguration` option is now array of IgbPivotValue - `IgbPivotValue[]`, it was `IgbPivotValueCollection` previously. +The type of Values from option is now array of IgbPivotValue - `IgbPivotValue[]`, it was `IgbPivotValueCollection` previously. ### {PackageCharts} (Charts) -- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property `GroupRowVisible` toggles grouping with each series opting in can assign group text via the `DataLegendGroup` property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. +- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property toggles grouping with each series opting in can assign group text via the property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. -- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via . -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### {PackageGauges} (Gauges) -- `RadialGauge` - - New label for the highlight needle. `HighlightLabelText` and `HighlightLabelSnapsToNeedlePivot` and many other styling related properties for the HighlightLabel were added. +- + - New label for the highlight needle. and and many other styling related properties for the HighlightLabel were added. ## **{PackageVerChanges-23-2-APR2}** ### {PackageCharts} (Charts) -Data Filtering via the `InitialFilter` property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. +Data Filtering via the property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. -- `BulletGraph` - - The Performance bar will now reflect a difference between the value and new `HighlightValue` when the `HighlightValueDisplayMode` is applied to the 'Overlay' setting. The highlight value will show a filtered/subset measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. -- `LinearGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `RadialGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - The Performance bar will now reflect a difference between the value and new when the is applied to the 'Overlay' setting. The highlight value will show a filtered/subset measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. ## **{PackageVerChanges-23-2-APR}** @@ -850,31 +852,31 @@ Data Filtering via the `InitialFilter` property. Apply filter expressions to fil ### New Features -- `DockManager` - - New `ProximityDock` property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. - - New `ContainedInBoundaries` property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. - - New `ShowPaneHeaders` property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. -- `Tree` +- + - New property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. + - New property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. + - New property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. +- - Added `toggleNodeOnClick` property that determines whether clicking over a node will change its expanded state or not. Defaults to `false`. -- `Rating` +- - `allowReset` added. When enabled selecting the same value will reset the component. **Behavioral change** - In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. -- `Select`, `Dropdown` +- , - exposed `selectedItem`, `items` and `groups` getters -- `RadialGauge` - - New title/subtitle properties. `TitleText`, `SubtitleText` will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and `TitleExtent`. Finally, the new `TitleDisplaysValue` will allow the value to correspond with the needle's position. - - New `OpticalScalingEnabled` and `OpticalScalingSize` properties for the `RadialGauge`. This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New title/subtitle properties. , will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and . Finally, the new will allow the value to correspond with the needle's position. + - New and properties for the . This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### General -- `Input`, `MaskInput`, `DateTimeInput`, `Rating` - - `Readonly` has been renamed to `ReadOnly` -- `Input` - - `Maxlength` has been renamed to `MaxLength` - - `Minlength` has been renamed to `MinLength` +- , , , + - `Readonly` has been renamed to +- + - `Maxlength` has been renamed to + - `Minlength` has been renamed to ### Deprecations @@ -884,18 +886,18 @@ Data Filtering via the `InitialFilter` property. Apply filter expressions to fil --ig-size: var(--ig-size-small); } ``` -- `DateTimeInput` - - `MinValue` and `MaxValue` properties have been deprecated. Please, use `Min` and `Max` instead. -- `RangeSlider` - - `AriaLabelLower` and `AriaLabelUpper` properties have been deprecated. Please, use `ThumbLabelLower` and `ThumbLabelUpper` instead. +- + - `MinValue` and `MaxValue` properties have been deprecated. Please, use and instead. +- + - `AriaLabelLower` and `AriaLabelUpper` properties have been deprecated. Please, use and instead. ### Removed - Removed our own `dir` attribute which shadowed the default one. This is a non-breaking change. -- `Slider` - `ariaLabel` shadowed property. This is a non-breaking change. -- `Checkbox` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. -- `Switch` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. -- `Radio` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabel` shadowed property. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. ## **{PackageVerChanges-23-2-JAN}** @@ -905,14 +907,14 @@ Data Filtering via the `InitialFilter` property. Apply filter expressions to fil ### {PackageCharts} (Charts) -- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The `CategoryChart` and `DataChart` now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. +- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The and now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. ## **{PackageVerChanges-23-2}** ### {PackageGrids} - Toolbar - - Save tool action has been added to save the chart to an image via the clipboard. -- Vertical orientation has been added via the toolbar's `Orientation` property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. +- Vertical orientation has been added via the toolbar's property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's `renderImageFromText` method, further enhancing custom tool creation. ### {PackageGrids} (Grid) @@ -923,13 +925,13 @@ Data Filtering via the `InitialFilter` property. Apply filter expressions to fil ### New Components -- [Toolbar](menus/toolbar.md) - component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tools when linked to our `DataChart` or `CategoryChart` components, but it also gives you the ability to create custom tools for your project. +- [Toolbar](menus/toolbar.md) - component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tools when linked to our or components, but it also gives you the ability to create custom tools for your project. ### {PackageCharts} (Charts) -- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the `ValueLayer` is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the `CategoryChart` and `FinancialChart` by adding to the new `ValueLines` collection. +- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the and by adding to the new collection. -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **{PackageVerChanges-22-2.65}** ### New Components @@ -943,7 +945,7 @@ Data Filtering via the `InitialFilter` property. Apply filter expressions to fil ### {PackageGrids} (Data Grid) -- A new argument `PrimaryKey` has been introduced to `IgbRowDataEventArgs` from `Detail`, and part of the event arguments that are emitted by the `RowAdded` and `RowDeleted` events. When the grid has a primary key attribute added, then the emitted primaryKey event argument represents the row ID, otherwise it defaults to null. +- A new argument has been introduced to `IgbRowDataEventArgs` from , and part of the event arguments that are emitted by the `RowAdded` and `RowDeleted` events. When the grid has a primary key attribute added, then the emitted primaryKey event argument represents the row ID, otherwise it defaults to null. - `RowSelectionChanging` event arguments are changed. Now, the `OldSelection`, `NewSelection`, `Added` and `Removed` collections no longer consist of the row keys of the selected elements when the grid has set a primaryKey, but now in any case the row data is emitted. - When the grid is working with remote data and a primary key has been set, the selected rows that are not currently part of the grid view will be emitted for a partial row data object. - When selected row is deleted from the grid component `RowSelectionChanging` event will no longer be emitted. @@ -959,8 +961,8 @@ Data Filtering via the `InitialFilter` property. Apply filter expressions to fil - `IgbDateTimeInput`, the StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date) is now trimmed down to DatePart instead of DateTimeInputDatePart - `IgbRadio` and `IgbRadioGroup`, added component validation along with styles for invalid state - `IgbMask`, added the capability to escape mask pattern literals. -- `IgbBadge` added a `Shape` property that controls the shape of the badge and can be either `Square` or `Rounded`. The default shape of the badge is rounded. -- `IgbAvatar`, the `RoundShape` property has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly added `Shape` attribute that can be `Square`, `Rounded` or `Circle`. The default shape of the avatar is `Square`. +- `IgbBadge` added a property that controls the shape of the badge and can be either or `Rounded`. The default shape of the badge is rounded. +- `IgbAvatar`, the `RoundShape` property has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly added attribute that can be , `Rounded` or . The default shape of the avatar is . ### {PackageDockManager} (DockManager) @@ -988,7 +990,7 @@ Added significant improvements to default behaviors, and refined the Category Ch - Responsive layouts for horizontal label rotation based on browser / screen size. - Enhanced rendering for rounded labels on all platforms. - Added marker properties to StackedFragmentSeries. -- Added `ShouldPanOnMaximumZoom` property. +- Added property. - New Category Axis Properties: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -1009,33 +1011,33 @@ Added significant improvements to default behaviors, and refined the Category Ch - GroupSortDescriptions -[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties`. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using | . These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ### {PackageGrids} (Data Grid) -- Changed **{IgPrefix}Column** to `DataGridColumn` -- Changed **GridCellEventArgs** to `DataGridCellEventArgs` -- Changed **GridSelectionMode** to `DataGridSelectionMode` +- Changed **{IgPrefix}Column** to +- Changed **GridCellEventArgs** to +- Changed **GridSelectionMode** to - Changed **SummaryOperand** to `DataSourceSummaryOperand` ## **{PackageVerChanges-22-1}** ### {PackageCharts} (Charts) -- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the `Legend`, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. +- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the , but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable [DataToolTip](charts/features/chart-data-tooltip.md) which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types. -- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the `IsTransitionInEnabled` property to true. From there, you can set the `TransitionInDuration` property to determine how long your animation should take to complete and the `TransitionInMode` to determine the type of animation that takes place. -- Added `AssigningCategoryStyle` event, is now available to all series in `DataChart`. This event is handled when you want to conditionally configure aspects of the series items such as `Fill` background-color and highlighting. -- New `AllowedPositions` enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. +- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the property to true. From there, you can set the property to determine how long your animation should take to complete and the to determine the type of animation that takes place. +- Added `AssigningCategoryStyle` event, is now available to all series in . This event is handled when you want to conditionally configure aspects of the series items such as background-color and highlighting. +- New enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default. - - `CalloutCornerRadius` for CalloutLayer - - `AxisAnnotationBackgroundCornerRadius` for FinalValueLayer - - `XAxisAnnotationBackgroundCornerRadius` and `YAxisAnnotationBackgroundCornerRadius` for CrosshairLayer -- New `HorizontalViewScrollbarMode` and `VerticalViewScrollbarMode` enumeration to enable scrollbars in various ways. When paired with `IsVerticalZoomEnabled` or `IsHorizontalZoomEnabled`, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. -- New `FavorLabellingScaleEnd`, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. `NumericXAxis`, `NumericYAxis`, `PercentChangeAxis`). -- New `IsSplineShapePartOfRange` determines whether to include the spline shape in the axis range requested of the axis. -- New `XAxisMaximumGap`, determines the maximum allowed value for the plotted series when using `XAxisGap`. The gap determines the amount of space between columns or bars of plotted series. -- New `XAxisMinimumGapSize`, determines the minimum allowed pixel-based value for the plotted series when using `XAxisGap` to ensure there is always some spacing between each category. + - for CalloutLayer + - for FinalValueLayer + - and for CrosshairLayer +- New and enumeration to enable scrollbars in various ways. When paired with or , you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. +- New , determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. , , `PercentChangeAxis`). +- New determines whether to include the spline shape in the axis range requested of the axis. +- New , determines the maximum allowed value for the plotted series when using . The gap determines the amount of space between columns or bars of plotted series. +- New , determines the minimum allowed pixel-based value for the plotted series when using to ensure there is always some spacing between each category. ### {PackageGrids} (Data Grid) @@ -1063,11 +1065,11 @@ The following breaking changes were introduced ### {PackageGrids} (Data Grid) -- Changed `ValueField` property from type string[] to string. +- Changed property from type string[] to string. ### {PackageInputs} (Inputs) -- A new `ValueChanged` event supports 2-way binding and should only be handled if you have not bound the `Value` property. In order to read the Value field from the control without data binding the `ValueChanged` event should be handled, otherwise if your data is not bound you should use GetCurrentValueAsync to read the controls Value. +- A new `ValueChanged` event supports 2-way binding and should only be handled if you have not bound the property. In order to read the Value field from the control without data binding the `ValueChanged` event should be handled, otherwise if your data is not bound you should use GetCurrentValueAsync to read the controls Value. #### Date Picker - Changed `ValueChanged` event to `SelectedValueChanged`. @@ -1104,29 +1106,29 @@ For example, ``` ``` instead of ``` ``` This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -1152,30 +1154,30 @@ This release introduces a few improvements and simplifications to visual design #### Charts & Maps -This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. `DataChart`, `CategoryChart`, and `FinancialChart`. +This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. , , and . - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners - Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000 - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -1198,8 +1200,8 @@ for example: #### Chart Legend -- Added horizontal `Orientation` property to ItemLegend that can be used with Bubble, Donut, and Pie Chart -- Added `LegendHighlightingMode` property - Enables series highlighting when hovering over legend items +- Added horizontal property to ItemLegend that can be used with Bubble, Donut, and Pie Chart +- Added property - Enables series highlighting when hovering over legend items #### Geographic Map @@ -1214,11 +1216,11 @@ These features are CTP ### {PackageGrids} (Data Grid) -- Added `EditOnKeyPress` aka Excel-style Editing, instantly begin editing when typing. -- Added `EditModeClickAction` property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. -- Added `EnterKeyBehaviors` property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) -- Added `EnterKeyBehaviorAfterEdit` property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) -- Added `SelectAllRows` - method. +- Added aka Excel-style Editing, instantly begin editing when typing. +- Added property - By default double-clicking is required to enter edit mode. This can be set to to allow for edit mode to occur when selecting a new cell. +- Added property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) +- Added property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) +- Added - method. - Added Row Range Selection - With `GridSelectionMode` property set to MultipleRow the following new functionality is now included: - Click and drag to select rows - SHIFT and click to select multiple rows. @@ -1230,13 +1232,13 @@ These features are CTP #### Date Picker -- `ShowTodayButton` - Toggles Today button visibility -- `Label` - Adds a label above the date value -- `Placeholder` property - adds custom text when no value is selected -- `FormatString` - Customize input date string e.g. (`yyyy-MM-dd`) -- `DateFormat` - Specifies whether to display selected dates as LongDate or ShortDate -- `FirstDayOfWeek` - Specifies first day of week -- `FirstWeekOfYear` - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) -- `ShowWeekNumbers` - Toggles Week number visibility -- `MinDate` & `MaxDate` - Date limits, specifying a range of available selectable dates. +- - Toggles Today button visibility +- - Adds a label above the date value +- property - adds custom text when no value is selected +- - Customize input date string e.g. (`yyyy-MM-dd`) +- - Specifies whether to display selected dates as LongDate or ShortDate +- - Specifies first day of week +- - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) +- - Toggles Week number visibility +- & - Date limits, specifying a range of available selectable dates. - Added Accessibility diff --git a/docs/xplat/src/content/en/components/general-changelog-dv-react.mdx b/docs/xplat/src/content/en/components/general-changelog-dv-react.mdx index e031ee86a5..88d181a77f 100644 --- a/docs/xplat/src/content/en/components/general-changelog-dv-react.mdx +++ b/docs/xplat/src/content/en/components/general-changelog-dv-react.mdx @@ -16,6 +16,8 @@ import chartdefaults3 from '@xplat-images/chartDefaults3.png'; import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} Changelog @@ -28,8 +30,8 @@ All notable changes for each version of {ProductName} are documented on this pag #### Changed -- `DockManager`: Updated to use the latest `igniteui-dockmanager@2.1.0` with new `minResizeWidth` and `minResizeHeight` properties, `paneFlyoutToggle` event; additional `layoutChange` event detail and fixes. See the [full changelog](https://github.com/IgniteUI/igniteui-dockmanager/blob/master/CHANGELOG.md#210). -- Updated to use the latest `igniteui-webcomponents@7.1.0` including new `Splitter` and `Highlight` container components and fixes. See the [full changelog](https://github.com/IgniteUI/igniteui-webcomponents/blob/master/CHANGELOG.md#710---2026-03-19). +- : Updated to use the latest `igniteui-dockmanager@2.1.0` with new `minResizeWidth` and `minResizeHeight` properties, `paneFlyoutToggle` event; additional `layoutChange` event detail and fixes. See the [full changelog](https://github.com/IgniteUI/igniteui-dockmanager/blob/master/CHANGELOG.md#210). +- Updated to use the latest `igniteui-webcomponents@7.1.0` including new and `Highlight` container components and fixes. See the [full changelog](https://github.com/IgniteUI/igniteui-webcomponents/blob/master/CHANGELOG.md#710---2026-03-19). #### New Features @@ -92,18 +94,18 @@ All notable changes for each version of {ProductName} are documented on this pag ### {PackageGrids} (Grids) -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid`, `IgrPivotGrid` +- , , , - Improved performance by dynamically adjusting the scroll throttle based on the data displayed in grid. **Breaking Changes** -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid`, `IgrPivotGrid` +- , , , - Original `data` array mutations (like adding/removing/moving records in the original array) are no longer detected automatically. Components need an array reference change for the change to be detected. **Localization(i18n)** -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid`, `IgrPivotGrid`, `IgrCombo`, `IgrDatePicker`, `IgrDateRangePicker`, `IgrCalendar`, `IgrCarousel`, `IgrChip`, `IgrInput`, `IgrTree` - - New `Intl` implementation for the grid components that format and render data like dates and numbers. Updated `Intl` implementation for `IgrCalendar`, `IgrDatePicker`, and `IgrDateRangePicker`. +- , , , , , , , , , , , + - New `Intl` implementation for the grid components that format and render data like dates and numbers. Updated `Intl` implementation for , , and . - New localization implementation for the currently supported languages for all components that have resource strings in the currently supported languages. - New public localization API and package named `igniteui-i18n-resources` containing the new resources that are used in conjunction. @@ -159,9 +161,9 @@ Added OthersCategoryBrush and OthersCategoryOutline to DataPieChart and Proporti #### User Annotations -In {ProductName}, you can now annotate the `DataChart` with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. +In {ProductName}, you can now annotate the with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. +This is directly integrated with the available tools of the . {Platform} user-annotation-create @@ -169,8 +171,8 @@ This is directly integrated with the available tools of the `Toolbar`. Ability for axis annotations to automatically detect collisions and truncate to fit better. To enable this feature you must set the following properties: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### {PackageMaps} (Geographic Map) @@ -189,10 +191,10 @@ Ability for axis annotations to automatically detect collisions and truncate to ### New Components -- Added `IgrChat` component +- Added `Chat` component ### {PackageGrids} (Grids) -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid` +- , , - Introduced a new cell merging feature that allows you to configure and merge cells in a column based on same data or other custom condition, into a single cell. It can be enabled on the individual columns: @@ -296,34 +298,34 @@ The following events have been added to the `IgbDataChart` to allow you to detec #### Companion Axis -Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the `CompanionAxisEnabled` property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. +Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. #### RadialPieSeries Inset Outlines -There is a new property called `UseInsetOutlines` to control how outlines on the `RadialPieSeries` are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. +There is a new property called to control how outlines on the are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### {PackageGrids} (Grids) #### Cell Suffix Content -Added support for suffix content within the cells that allows you to add additional text or icons to the end of the cell value and style it. The full list of added properties for the cell suffix content is listed below and is available on the `DataGridColumn` and `CellInfo` class: +Added support for suffix content within the cells that allows you to add additional text or icons to the end of the cell value and style it. The full list of added properties for the cell suffix content is listed below and is available on the and class: -- `SuffixText` -- `SuffixTextColor` +- +- - `SuffixTextFont` -- `SuffixIconName` -- `SuffixIconCollectionName` -- `SuffixIconStroke` -- `SuffixIconFill` -- `SuffixIconViewBoxLeft` -- `SuffixIconViewBoxTop` -- `SuffixIconViewBoxWidth` -- `SuffixIconViewBoxHeight` -- `TextDecoration` +- +- +- +- +- +- +- +- +- Please note that the maximum size available for the icons is 24x24. You can provide an icon that is larger or smaller than this, but you will need to configure the viewbox settings in order to properly scale it to fit in the 24x24 space so it is fully visible. @@ -331,28 +333,28 @@ Please note that the maximum size available for the icons is 24x24. You can prov | Bug Number | Control | Description | |------------|---------|-------------| -|31624 | `IgrCategoryChart` | Resizing the containing window of the `IgrCategoryChart` causes the chart to fail to render the series| -|27304 | `IgrDataChart` | Zoom rectangle is not positioned the same as the background rectangle| -|37930 | `IgrDataChart` | Data Annotation Overlay Text Color not working| -|30600 | `IgrDoughnutChart` | No textStyle property for either the chart or series (pie chart has this)| -|38231 | `IgrGrid` | Unpinned column does not return to the original position if hidden columns exist| +|31624 | | Resizing the containing window of the causes the chart to fail to render the series| +|27304 | | Zoom rectangle is not positioned the same as the background rectangle| +|37930 | | Data Annotation Overlay Text Color not working| +|30600 | | No textStyle property for either the chart or series (pie chart has this)| +|38231 | | Unpinned column does not return to the original position if hidden columns exist| |33861 | Excel Library | Adding line chart corrupts excel File for German culture| ### Enhancements #### IgrBulletGraph -- Added new `LabelsVisible` property +- Added new property #### Charts - New properties added to the DataToolTipLayer, ItemToolTipLayer, and CategoryToolTipLayer to aid in styling: `ToolTipBackground`, `ToolTipBorderBrush`, and `ToolTipBorderThickness` -- New properties added to the DataLegend to aid in styling: `ContentBackground`, `ContentBorderBrush`, and `ContentBorderThickness`. The `ContentBorderBrush` and `ContentBorderThickness` default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. +- New properties added to the DataLegend to aid in styling: , , and . The and default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. -- Added a new property to `ChartMouseEventArgs` called `WorldPosition` that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. +- Added a new property to called that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. -- Added `HighlightingFadeOpacity` to `SeriesViewer` and `DomainChart`. This allows you to configure the opacity applied to highlighted series. +- Added to and . This allows you to configure the opacity applied to highlighted series. - Expose `CalloutLabelUpdating` event for domain charts. @@ -362,7 +364,7 @@ Please note that the maximum size available for the icons is 24x24. You can prov #### IgrLinearGauge -- Added new `LabelsVisible` property +- Added new property ## **{PackageVerChanges-25-1-SEP}** @@ -455,7 +457,7 @@ Please note that the maximum size available for the icons is 24x24. You can prov | Bug Number | Control | Description | |------------|---------|------------------| -|36448 | `IgrRadialGauge` | Radial label format properties do not work. (eg. Title, SubTitles)| +|36448 | | Radial label format properties do not work. (eg. Title, SubTitles)| ### {PackageCharts} (Charts) @@ -481,23 +483,23 @@ For more details please visit: - Data Annotation Slice Layer - Data Annotation Strip Layer -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. -- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. +- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. - [Trendline Layer](charts/features/chart-trendlines.md) series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple [TrendlineLayer](charts/features/chart-overlays.md) series types in the chart. ### {PackageDashboards} (Dashboards) -- The `IgrDashboardTile` now supports propagating the aggregations from its DataGrid view to the chart visualization such as sorting, grouping, filtering and selection. This is currently supported by binding the `DataSource` of the `IgrDashboardTile` to an instance of `IgrLocalDataSource`. +- The now supports propagating the aggregations from its DataGrid view to the chart visualization such as sorting, grouping, filtering and selection. This is currently supported by binding the `DataSource` of the to an instance of . ### {PackageGrids} **Breaking Changes** -- The `IgrDataGrid` & `IgrMultiColumnComboBox` are now part of the igniteui-react-data-grids package. +- The `DataGrid` & are now part of the igniteui-react-data-grids package. ### Enhancements @@ -512,9 +514,9 @@ For more details please visit: | Bug Number | Control | Description | |------------|---------|------------------| -|25997 | `IgrDataGrid` | Summaries are only showing for first grouped child row| -|37023 | `IgrDataChart` | Tooltips are cut-off/offscreen if overflow hidden is set.| -|37685 | `IgrSpreadsheet` | Poor rendering of numbers formatted with Arial font.| +|25997 | `DataGrid` | Summaries are only showing for first grouped child row| +|37023 | | Tooltips are cut-off/offscreen if overflow hidden is set.| +|37685 | `Spreadsheet` | Poor rendering of numbers formatted with Arial font.| |37244 | Excel Library | Custom Data Validation is not working.| ## **{PackageVerChanges-24-2-APR2}** @@ -525,11 +527,11 @@ With 19.0.0 the React product introduces many breaking changes done to improve a [Update Guide](update-guide.md) ### Removed -- `CheckboxChangeEventArgs` removed, use `IgrCheckboxChangeEventArgs` instead. -- `RadioChangeEventArgs` removed, use `IgrRadioChangeEventArgs` instead. -- `IgrRangeSliderValue` removed, use `IgrRangeSliderValueEventArgs` instead. -- `IgrActiveStepChangingArgs` removed, use `IgrActiveStepChangingEventArgs` instead. -- `IgrActiveStepChangedArgs` removed, use `IgrActiveStepChangedEventArgs` instead. +- removed, use instead. +- removed, use instead. +- removed, use instead. +- `ActiveStepChangingArgs` removed, use instead. +- `ActiveStepChangedArgs` removed, use instead. ### Enhancements @@ -551,29 +553,29 @@ igr-tab-panel component is removed. The igr-tab now encompasses both the tab hea ### Enhancements #### List -- Added new property on `ListItem` called `Selected` +- Added new property on called #### Accordion -- Added new events `Open` and `Close` +- Added new events and `Close` ### {PackageGrids} - **All Grids** - - Allow applying initial filtering through `FilteringExpressionsTree` property + - Allow applying initial filtering through property ### Deprecations -- The `clicked` event of the `Button` is deprecated. Use the native `onClick` handler. +- The `clicked` event of the is deprecated. Use the native `onClick` handler. ### Bug Fixes | Bug Number | Control | Description | |------------|---------|------------------| -|25602 | `IgrDataGrid` | Loading a layout with one of the date-specific filter operators results in a TypeError console error| -|28480 | `IgrCombo` | Undefined reference error is thrown when a datasource is replaced| -|30319 | `IgrDataGrid` | Records are sorted despite no value changed| -|32598 | `IgrDataGrid` | Multi-selection is not working correctly -|36374 | `IgrInput` | A previous value was bound when a form was submitted on any touch device| +|25602 | `DataGrid` | Loading a layout with one of the date-specific filter operators results in a TypeError console error| +|28480 | | Undefined reference error is thrown when a datasource is replaced| +|30319 | `DataGrid` | Records are sorted despite no value changed| +|32598 | `DataGrid` | Multi-selection is not working correctly +|36374 | | A previous value was bound when a form was submitted on any touch device| ## **{PackageVerChanges-24-2-MAR}** @@ -594,15 +596,15 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ### {PackageCommon} - Added new `allowSplitterDock` property for `Dockmanager` that allows docking directly in a split. -- Added new `useFixedSize` property for the `SplitPane` of `Dockmanager` that allows new resize behavior. +- Added new `useFixedSize` property for the of `Dockmanager` that allows new resize behavior. ### Enhancements #### Toolbar -- Added new `groupHeaderTextStyle` property to `Toolbar` and `ToolPanel`. If set, it will apply to all `ToolActionGroupHeader` actions. -- Added new property on `ToolAction` called `TitleHorizontalAlignment` which controls the horizontal alignment of the title text. -- Added new property on `ToolActionSubPanel` called `itemSpacing` which controls the spacing between items inside the panel. +- Added new `groupHeaderTextStyle` property to and . If set, it will apply to all actions. +- Added new property on called which controls the horizontal alignment of the title text. +- Added new property on called `itemSpacing` which controls the spacing between items inside the panel. ### Bug Fixes @@ -610,16 +612,16 @@ The following table lists the bug fixes made for the {ProductName} toolset for t | Bug Number | Control | Description | |------------|---------|------------------| -|30286 | `IgrDataChart` | Bubble Series tooltip content is switched to that of nearby bubble data in clicking a bubble| -|32906 | `IgrDataChart` | `IgrDataChart` is showing two xAxis on the top| -|33605 | `IgrDataChart` | ScatterLineSeries is not showing the color of the line correctly in the legend| -|34776 | `IgrDataChart` | Repeatedly showing and hiding the `IgrDataChart` causes memory leakage in JS Heap| -|35498 | `IgrDataChart` | Tooltips for the series specified in IncludedSeries are not displayed| -|34324 | `IgrGrid` | Column hiding through condition in the grid template is not working| -|34678 | `IgrGrid` | Enum values coerced to strings, breaking expected numeric behavior in some grid properties| -|32093 | `IgrPivotGrid` | PivotDateDimensionOptions are not applied to the PivotDateDimension| -|34053 | `IgrRadialGauge` | The position of the scale label is shifted| -|35496 | `IgrSpreadsheet` | Error when setting styles in Excel with images| +|30286 | | Bubble Series tooltip content is switched to that of nearby bubble data in clicking a bubble| +|32906 | | is showing two xAxis on the top| +|33605 | | ScatterLineSeries is not showing the color of the line correctly in the legend| +|34776 | | Repeatedly showing and hiding the causes memory leakage in JS Heap| +|35498 | | Tooltips for the series specified in IncludedSeries are not displayed| +|34324 | | Column hiding through condition in the grid template is not working| +|34678 | | Enum values coerced to strings, breaking expected numeric behavior in some grid properties| +|32093 | | PivotDateDimensionOptions are not applied to the PivotDateDimension| +|34053 | | The position of the scale label is shifted| +|35496 | `Spreadsheet` | Error when setting styles in Excel with images| |36176 | Excel Library | Exception occurs when loading an Excel workbook that has a LET function| |36379 | Excel Library | Colors with any alpha channel in an excel workbook fail to load| |26218 | Excel Library | Chart's plot area right margin becomes narrower and fill pattern and fill foreground are gone just by loading an Excel file| @@ -651,18 +653,18 @@ DashboardTile ### General - New [Carousel](layouts/carousel.md) component. -- `Input` - - Changed `change` event argument type from `ComponentDataValueChangedEventArgs` to `ComponentValueChangedEventArgs` +- + - Changed `change` event argument type from to ## **{PackageVerChanges-24-1-SEP}** ### {PackageCharts} (Charts) -- New [Data Pie Chart](charts/types/data-pie-chart.md) - The `DataPieChart` is a new component that renders a pie chart. This component works similarly to the `CategoryChart`, 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. +- New [Data Pie Chart](charts/types/data-pie-chart.md) - The is a new component that renders a pie chart. This component works similarly to the , 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. -- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. +- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -679,55 +681,55 @@ DashboardTile - New [Banner](notifications/banner.md) component. - New [DatePicker](scheduling/date-picker.md) component. -- New `Divider` component. +- New component. - Added support for native events to all components. -- `Icon` +- - Added `setIconRef` method. This allows to register and replace icons by SVG files. - All components now use icons by reference internally so that it's easy to replace them without explicitly providing custom templates. -- `Combo`, `DatePicker`, `Dialog`, `Dropdown`, `ExpansionPanel`, `NavDrawer`, `Toast`, `Snackbar`, **IgrSelectComponent** +- , , , , , , , , **IgrSelectComponent** - Toggle methods `show`, `hide`, `toggle` methods return **true** now on success, otherwise **false**. -- **IgrButtonComponent**, `IconButton`, `Checkbox`, `Switch`, `Combo`, `DateTimeInput`, `Input`, `MaskInput`, `Radio`, **IgrSelectComponent**, `Textarea` +- **IgrButtonComponent**, , , , , , , , , **IgrSelectComponent**, - Deprecated custom `focus` and `blur` events. Use the native `onFocus` and `onBlur` events instead -- `RadioGroup` - - Added `Name` and `Value` properties. +- + - Added and properties. **Breaking Changes** - Renamed old **IgrDatePicker** to **IgrXDatePicker**. -- Removed `Form` component. Use native form instead. +- Removed component. Use native form instead. - Removed `size` property in favor of the `--ig-size` CSS custom property for the following components: - - `Avatar`, **IgrButtonComponent**, `IconButton`, `Calendar`, `Chip`, `Dropdown`, `Icon`, `Input`, `List`, `Rating`, `Snackbar`, `Tabs`, `Tree` -- `Badge`, `Chip`, `LinearProgress`, `CircularProgress` - - Renamed `Variant` property type to `StyleVariant`. -- `Calendar` - - Renamed `WeekStart` property type to `WeekDays`. -- `Checkbox`, `Switch` - - Changed `change` event argument type from `ComponentBoolValueChangedEventArgs` to `CheckboxChangeEventArgs`. -- `Combo`, **IgrSelectComponent** + - , **IgrButtonComponent**, , , , , , , , , , , +- , , , + - Renamed property type to `StyleVariant`. +- + - Renamed property type to `WeekDays`. +- , + - Changed `change` event argument type from to . +- , **IgrSelectComponent** - Removed `positionStrategy`, `flip`, `sameWidth` properties. -- `DateTimeInput` +- - Removed `maxValue` and `minValue` properties. Use `max` and `min` instead. -- `Dropdown` +- - Removed `positionStrategy` property. -- `Input` +- - Removed old named `maxlength` and `minlength` properties. Use `maxLength` and `minLength`. - Removed old named `readonly` and `inputmode` properties. Use `readOnly` and `inputMode`. - Changed `inputMode` type also to `string`. -- `Radio` - - Changed `change` event argument type from `ComponentBoolValueChangedEventArgs` to `RadioChangeEventArgs`. -- `RangeSlider` +- + - Changed `change` event argument type from to . +- - Removed `ariaThumbLower` and `ariaThumbUpper` properties. Use `thumbLabelLower` and `thumbLabelUpper` instead. -- `Rating` +- - Renamed `readonly` property to `readOnly`. ### {PackageGrids} - **All Grids** - Added new `RowClick` event. -- `PivotGrid` - - Added `sortable` property for a `PivotDimension`. +- + - Added `sortable` property for a . - Added horizontal layout. Can be enabled inside the new `pivotUI` property as `rowLayout` `horizontal`. - - Added row dimension summaries for horizontal layout only. Can be enabled for each `PivotDimension` by setting `horizontalSummary` to **true**. + - Added row dimension summaries for horizontal layout only. Can be enabled for each by setting `horizontalSummary` to **true**. - Added `horizontalSummariesPosition` property to the `pivotUI`, configuring horizontal summaries position. - Added row headers for the row dimensions. Can be enabled inside the new `pivotUI` property as `showHeaders` **true**. - Keyboard navigation now can move in to row headers back and forth from any row dimension headers or column headers. @@ -736,127 +738,127 @@ DashboardTile **Breaking Changes** - **All Grids** - - `RowIsland` + - - Removed `displayDensity` deprecated property. - Renamed `actualColumns`, `contentColumns` properties to `actualColumnList` and `contentColumnList`. Use `columns` or `columnList` property to get all columns now. - - Renamed `rowDelete` and `rowAdd` event argument type to `RowDataCancelableEventArgs`. - - Renamed `contextMenu` event argument type to `GridContextMenuEventArgs`. - - Removed `GridEditEventArgs`, `GridEditDoneEventArgs`, `PinRowEventArgs` events `rowID` and `primaryKey` properties. Use `rowKey` instead. -- `PivotGrid` + - Renamed `rowDelete` and `rowAdd` event argument type to . + - Renamed `contextMenu` event argument type to . + - Removed , , events `rowID` and `primaryKey` properties. Use `rowKey` instead. +- - removed `showPivotConfigurationUI` property. Use `pivotUI` and set inside it the new `showConfiguration` option. -- `Column` +- - Removed `movable` property. Use Grid's `moving` property now. - Removed `columnChildren` property. Use `childColumns` instead. -- `ColumnGroup` +- - Removed `children` property. Use `childColumns` instead. -- `Paginator` +- - Removed `isFirstPageDisabled` and `isLastPageDisabled` properties. Use `isFirstPage` and `isLastPage` instead. ## **{PackageVerChanges-24-1-JUN}** ### {PackageCommon} -- `Input`, `Textarea` - exposed `ValidateOnly` to enable validation rules being enforced without restricting user input. -- `Dropdown` - `PositionStrategy` property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. -- `DockManager` - `SplitPane` `IsMaximized` is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the `IsMaximized` property of `TabGroupPane` and/or `ContentPane` instead. +- , - exposed to enable validation rules being enforced without restricting user input. +- - property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. +- - is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the property of and/or instead. ### {PackageGrids} - `DisplayDensity` deprecated in favor of the `--ig-size` CSS custom property. Check out the [Grid Size](grids/grid/size.md) topic for more. -- `PivotGrid` - Configuration of the component can now be applied correctly. +- - Configuration of the component can now be applied correctly. ### {PackageCharts} (Charts) -- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property `GroupRowVisible` toggles grouping with each series opting in can assign group text via the `DataLegendGroup` property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. +- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property toggles grouping with each series opting in can assign group text via the property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. -- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via `FillBrushes`. -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### {PackageGauges} (Gauges) -- `RadialGauge` - - New label for the highlight needle. `HighlightLabelText` and `HighlightLabelSnapsToNeedlePivot` and many other styling related properties for the HighlightLabel were added. +- + - New label for the highlight needle. and and many other styling related properties for the HighlightLabel were added. ## **{PackageVerChanges-23-2-MAR}** ### {PackageCharts} -- New Data Filtering via the `InitialFilter` property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. +- New Data Filtering via the property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### {PackageGrids} -- New [`HierarchicalGrid`](grids/hierarchical-grid/overview.md) component +- New [](grids/hierarchical-grid/overview.md) component ### {PackageGauges} -- `RadialGauge` - - New title/subtitle properties. `TitleText`, `SubtitleText` will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and `TitleExtent`. Finally, the new `TitleDisplaysValue` will allow the value to correspond with the needle's position. - - New `OpticalScalingEnabled` and `OpticalScalingSize` properties for the `RadialGauge`. This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `LinearGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `BulletGraph` - - The Performance bar will now reflect a difference between the value and new `HighlightValue` when the `HighlightValueDisplayMode` is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. +- + - New title/subtitle properties. , will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and . Finally, the new will allow the value to correspond with the needle's position. + - New and properties for the . This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - The Performance bar will now reflect a difference between the value and new when the is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. ### {PackageCommon} -- New `Textarea` component -- New `ButtonGroup` component -- `DockManager` - - New `ProximityDock` property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. - - New `ContainedInBoundaries` property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. - - New `ShowPaneHeaders` property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. -- `Input`, `MaskInput`, `DateTimeInput`, `Rating` - - `Readonly` has been renamed to `ReadOnly` -- `Input` - - `Maxlength` has been renamed to `MaxLength` - - `Minlength` has been renamed to `MinLength` -- `Tree` +- New component +- New component +- + - New property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. + - New property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. + - New property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. +- , , , + - `Readonly` has been renamed to +- + - `Maxlength` has been renamed to + - `Minlength` has been renamed to +- - Added `toggleNodeOnClick` property that determines whether clicking over a node will change its expanded state or not. Defaults to `false`. -- `Rating` +- - `allowReset` added. When enabled selecting the same value will reset the component. **Behavioral change** - In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. -- `Select`, `Dropdown` +- , - exposed `selectedItem`, `items` and `groups` getters #### Deprecations -- The `Form` component has been deprecated. Please, use the native form element instead. +- The component has been deprecated. Please, use the native form element instead. - The `size` property and attribute have been deprecated for all components. Use the `--ig-size` CSS custom property instead. The following example sets the size of the avatar component to small: ```css .avatar { --ig-size: var(--ig-size-small); } ``` -- `DateTimeInput` - - `MinValue` and `MaxValue` properties have been deprecated. Please, use `Min` and `Max` instead. -- `RangeSlider` - - `AriaLabelLower` and `AriaLabelUpper` properties have been deprecated. Please, use `ThumbLabelLower` and `ThumbLabelUpper` instead. +- + - `MinValue` and `MaxValue` properties have been deprecated. Please, use and instead. +- + - `AriaLabelLower` and `AriaLabelUpper` properties have been deprecated. Please, use and instead. #### Removed - Removed our own `dir` attribute which shadowed the default one. This is a non-breaking change. -- `Slider` - `ariaLabel` shadowed property. This is a non-breaking change. -- `Checkbox` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. -- `Switch` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. -- `Radio` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabel` shadowed property. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. ## **{PackageVerChanges-23-2-JAN}** ### {PackageCharts} (Charts) -- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The `CategoryChart` and `DataChart` now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. +- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The and now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. ## **{PackageVerChanges-23-2-DEC}** @@ -869,7 +871,7 @@ DashboardTile ### {PackageGrids} - Toolbar - - Save tool action has been added to save the chart to an image via the clipboard. -- Vertical orientation has been added via the toolbar's `Orientation` property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. +- Vertical orientation has been added via the toolbar's property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's `renderImageFromText` method, further enhancing custom tool creation. - [Grid](grids/data-grid.md) - This is a new fully functional cross-platform grid and includes features like filtering, sorting, templates, row selection, row grouping, row pinning and movable columns. @@ -882,13 +884,13 @@ DashboardTile ### New Components -- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our `DataChart` or `CategoryChart` components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. +- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our or components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. ### {PackageCharts} (Charts) -- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the `ValueLayer` is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the `CategoryChart` and `FinancialChart` by adding to the new `ValueLines` collection. +- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the and by adding to the new collection. -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **{PackageVerChanges-22-2}** @@ -897,7 +899,7 @@ Added significant improvements to default behaviors, and refined the Category Ch - Responsive layouts for horizontal label rotation based on browser / screen size. - Enhanced rendering for rounded labels on all platforms. - Added marker properties to StackedFragmentSeries. -- Added `ShouldPanOnMaximumZoom` property. +- Added property. - New Category Axis Properties: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -918,32 +920,32 @@ Added significant improvements to default behaviors, and refined the Category Ch - GroupSortDescriptions -[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties`. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using | . These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ### {PackageGrids} (Data Grid) -- Changed **{IgPrefix}Column** to `DataGridColumn` -- Changed **GridCellEventArgs** to `DataGridCellEventArgs` -- Changed **GridSelectionMode** to `DataGridSelectionMode` -- Changed **SummaryOperand** to `DataSourceSummaryOperand` +- Changed **{IgPrefix}Column** to +- Changed **GridCellEventArgs** to +- Changed **GridSelectionMode** to +- Changed **SummaryOperand** to ## **{PackageVerChanges-22-1}** ### {PackageCharts} (Charts) -- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the `Legend`, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. +- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the , but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable [DataToolTip](charts/features/chart-data-tooltip.md) which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types. -- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the `IsTransitionInEnabled` property to true. From there, you can set the `TransitionInDuration` property to determine how long your animation should take to complete and the `TransitionInMode` to determine the type of animation that takes place. -- Added `AssigningCategoryStyle` event, is now available to all series in `DataChart`. This event is handled when you want to conditionally configure aspects of the series items such as `Fill` background-color and highlighting. -- New `AllowedPositions` enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. +- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the property to true. From there, you can set the property to determine how long your animation should take to complete and the to determine the type of animation that takes place. +- Added `AssigningCategoryStyle` event, is now available to all series in . This event is handled when you want to conditionally configure aspects of the series items such as background-color and highlighting. +- New enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default. - - `CalloutCornerRadius` for CalloutLayer - - `AxisAnnotationBackgroundCornerRadius` for FinalValueLayer - - `XAxisAnnotationBackgroundCornerRadius` and `YAxisAnnotationBackgroundCornerRadius` for CrosshairLayer -- New `HorizontalViewScrollbarMode` and `VerticalViewScrollbarMode` enumeration to enable scrollbars in various ways. When paired with `IsVerticalZoomEnabled` or `IsHorizontalZoomEnabled`, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. -- New `FavorLabellingScaleEnd`, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. `NumericXAxis`, `NumericYAxis`, `PercentChangeAxis`). -- New `IsSplineShapePartOfRange` determines whether to include the spline shape in the axis range requested of the axis. -- New `XAxisMaximumGap`, determines the maximum allowed value for the plotted series when using `XAxisGap`. The gap determines the amount of space between columns or bars of plotted series. -- New `XAxisMinimumGapSize`, determines the minimum allowed pixel-based value for the plotted series when using `XAxisGap` to ensure there is always some spacing between each category. + - for CalloutLayer + - for FinalValueLayer + - and for CrosshairLayer +- New and enumeration to enable scrollbars in various ways. When paired with or , you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. +- New , determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. , , `PercentChangeAxis`). +- New determines whether to include the spline shape in the axis range requested of the axis. +- New , determines the maximum allowed value for the plotted series when using . The gap determines the amount of space between columns or bars of plotted series. +- New , determines the minimum allowed pixel-based value for the plotted series when using to ensure there is always some spacing between each category. ### {PackageGrids} (Data Grid) @@ -954,13 +956,13 @@ Added New Feature - [Row Paging](grids/data-grid/row-paging.md) which is used to ### {PackageGrids} (Data Grid) #### Data Grid -- Added `ValueMultiField`, of type string[], in the `ComboBoxColumn` to be used when your items in the drop down contain a key that consists of multiple fields. +- Added , of type string[], in the to be used when your items in the drop down contain a key that consists of multiple fields. The following breaking changes were introduced -- Changed `ValueField` property from type string[] to string. +- Changed property from type string[] to string. ### {PackageInputs} (Inputs) @@ -983,29 +985,29 @@ Please ensure package "lit-html": "^2.0.0" or newer is added to your project for This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -1025,38 +1027,38 @@ This release introduces a few improvements and simplifications to visual design - Added `SelectionChanged` event. Used to detect changes on selection interactions e.g. Multiple row selection. - Breaking Changes: - - Changed grid's SummaryScope property's type to SummaryScope from `DataSourceSummaryScope` - - Changed GroupHeaderDisplayMode property's type to GroupHeaderDisplayMode from `DataSourceSectionHeaderDisplayMode` + - Changed grid's SummaryScope property's type to SummaryScope from + - Changed GroupHeaderDisplayMode property's type to GroupHeaderDisplayMode from
## **{PackageVerChanges-21-1}** ### {PackageCharts} (Charts) -This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. `DataChart`, `CategoryChart`, and `FinancialChart`. +This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. , , and . - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners - Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000 - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -1079,8 +1081,8 @@ for example: #### Chart Legend -- Added horizontal `Orientation` property to ItemLegend that can be used with Bubble, Donut, and Pie Chart -- Added `LegendHighlightingMode` property - Enables series highlighting when hovering over legend items +- Added horizontal property to ItemLegend that can be used with Bubble, Donut, and Pie Chart +- Added property - Enables series highlighting when hovering over legend items ### {PackageMaps} (GeoMap) @@ -1097,11 +1099,11 @@ These features are CTP ### {PackageGrids} (Data Grid) -- Added `EditOnKeyPress` aka Excel-style Editing, instantly begin editing when typing. -- Added `EditModeClickAction` property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. -- Added `EnterKeyBehaviors` property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) -- Added `EnterKeyBehaviorAfterEdit` property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) -- Added `SelectAllRows` - method. +- Added aka Excel-style Editing, instantly begin editing when typing. +- Added property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. +- Added property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) +- Added property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) +- Added - method. - Added Row Range Selection - With `GridSelectionMode` property set to MultipleRow the following new functionality is now included: - Click and drag to select rows - SHIFT and click to select multiple rows. @@ -1113,15 +1115,15 @@ These features are CTP #### Date Picker -- `ShowTodayButton` - Toggles Today button visibility -- `Label` - Adds a label above the date value -- `Placeholder` property - adds custom text when no value is selected -- `FormatString` - Customize input date string e.g. (`yyyy-MM-dd`) -- `DateFormat` - Specifies whether to display selected dates as LongDate or ShortDate -- `FirstDayOfWeek` - Specifies first day of week -- `FirstWeekOfYear` - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) -- `ShowWeekNumbers` - Toggles Week number visibility -- `MinDate` & `MaxDate` - Date limits, specifying a range of available selectable dates. +- - Toggles Today button visibility +- - Adds a label above the date value +- property - adds custom text when no value is selected +- - Customize input date string e.g. (`yyyy-MM-dd`) +- - Specifies whether to display selected dates as LongDate or ShortDate +- - Specifies first day of week +- - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) +- - Toggles Week number visibility +- & - Date limits, specifying a range of available selectable dates. - Added Accessibility
diff --git a/docs/xplat/src/content/en/components/general-changelog-dv-wc.mdx b/docs/xplat/src/content/en/components/general-changelog-dv-wc.mdx index ad25eeb92c..1c6a835875 100644 --- a/docs/xplat/src/content/en/components/general-changelog-dv-wc.mdx +++ b/docs/xplat/src/content/en/components/general-changelog-dv-wc.mdx @@ -17,6 +17,8 @@ import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} Changelog @@ -126,9 +128,9 @@ Added OthersCategoryBrush and OthersCategoryOutline to DataPieChart and Proporti #### User Annotations -In {ProductName}, you can now annotate the `DataChart` with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. +In {ProductName}, you can now annotate the with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. +This is directly integrated with the available tools of the . {Platform} user-annotation-create @@ -136,8 +138,8 @@ This is directly integrated with the available tools of the `Toolbar`. Ability for axis annotations to automatically detect collisions and truncate to fit better. To enable this feature you must set the following properties: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### {PackageMaps} (Geographic Map) @@ -159,7 +161,7 @@ Ability for axis annotations to automatically detect collisions and truncate to ### New Components -- Added `IgrChat` component +- Added `Chat` component ### {PackageGrids} (Grids) - `IgcGrid`, `IgcTreeGrid`, `IgcHierarchicalGrid` @@ -269,34 +271,34 @@ The following events have been added to the `IgcDataChart` to allow you to detec #### Companion Axis -Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the `CompanionAxisEnabled` property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. +Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. #### RadialPieSeries Inset Outlines -There is a new property called `UseInsetOutlines` to control how outlines on the `RadialPieSeries` are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. +There is a new property called to control how outlines on the are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### {PackageGrids} #### Cell Suffix Content -Added support for suffix content within the cells that allows you to add additional text or icons to the end of the cell value and style it. The full list of added properties for the cell suffix content is listed below and is available on the `DataGridColumn` and `CellInfo` class: +Added support for suffix content within the cells that allows you to add additional text or icons to the end of the cell value and style it. The full list of added properties for the cell suffix content is listed below and is available on the and class: -- `SuffixText` -- `SuffixTextColor` +- +- - `SuffixTextFont` -- `SuffixIconName` -- `SuffixIconCollectionName` -- `SuffixIconStroke` -- `SuffixIconFill` -- `SuffixIconViewBoxLeft` -- `SuffixIconViewBoxTop` -- `SuffixIconViewBoxWidth` -- `SuffixIconViewBoxHeight` -- `TextDecoration` +- +- +- +- +- +- +- +- +- Please note that the maximum size available for the icons is 24x24. You can provide an icon that is larger or smaller than this, but you will need to configure the viewbox settings in order to properly scale it to fit in the 24x24 space so it is fully visible. @@ -314,19 +316,19 @@ Please note that the maximum size available for the icons is 24x24. You can prov ### Enhancements -#### IgrBulletGraph +#### BulletGraph -- Added new `LabelsVisible` property +- Added new property #### Charts - New properties added to the DataToolTipLayer, ItemToolTipLayer, and CategoryToolTipLayer to aid in styling: `ToolTipBackground`, `ToolTipBorderBrush`, and `ToolTipBorderThickness` -- New properties added to the DataLegend to aid in styling: `ContentBackground`, `ContentBorderBrush`, and `ContentBorderThickness`. The `ContentBorderBrush` and `ContentBorderThickness` default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. +- New properties added to the DataLegend to aid in styling: , , and . The and default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. -- Added a new property to `ChartMouseEventArgs` called `WorldPosition` that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. +- Added a new property to called that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. -- Added `HighlightingFadeOpacity` to `SeriesViewer` and `DomainChart`. This allows you to configure the opacity applied to highlighted series. +- Added to and . This allows you to configure the opacity applied to highlighted series. - Expose `CalloutLabelUpdating` event for domain charts. @@ -336,7 +338,7 @@ Please note that the maximum size available for the icons is 24x24. You can prov #### IgcLinearGauge -- Added new `LabelsVisible` property +- Added new property ## **{PackageVerChanges-25-1-AUG}** @@ -438,11 +440,11 @@ For more details please visit: - Data Annotation Strip Layer -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. -- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. +- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. - [Trendline Layer](charts/features/chart-trendlines.md) series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple [TrendlineLayer](charts/features/chart-overlays.md) series types in the chart. @@ -479,7 +481,7 @@ For more details please visit: ### {PackageGrids} - **All Grids** - - Allow applying initial filtering through `FilteringExpressionsTree` property + - Allow applying initial filtering through property ### Bug Fixes @@ -497,9 +499,9 @@ For more details please visit: #### Toolbar -- Added new `GroupHeaderTextStyle` property to `Toolbar` and `ToolPanel`. If set, it will apply to all `ToolActionGroupHeader` actions. -- Added new property on `ToolAction` called `TitleHorizontalAlignment` which controls the horizontal alignment of the title text. -- Added new property on `ToolActionSubPanel` called `ItemSpacing` which controls the spacing between items inside the panel. +- Added new `GroupHeaderTextStyle` property to and . If set, it will apply to all actions. +- Added new property on called which controls the horizontal alignment of the title text. +- Added new property on called which controls the spacing between items inside the panel. ### Bug Fixes @@ -543,11 +545,11 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ### {PackageCharts} -- New [Data Pie Chart](charts/types/data-pie-chart.md) - The `DataPieChart` is a new component that renders a pie chart. This component works similarly to the `CategoryChart`, 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. +- New [Data Pie Chart](charts/types/data-pie-chart.md) - The is a new component that renders a pie chart. This component works similarly to the , 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. -- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. +- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -564,10 +566,10 @@ The following table lists the bug fixes made for the {ProductName} toolset for t - **All Grids** - Added new `RowClick` event. -- `PivotGrid` - - Added `sortable` property for a `PivotDimension`. +- + - Added `sortable` property for a . - Added horizontal layout. Can be enabled inside the new `pivotUI` property as `rowLayout` `horizontal`. - - Added row dimension summaries for horizontal layout only. Can be enabled for each `PivotDimension` by setting `horizontalSummary` to **true**. + - Added row dimension summaries for horizontal layout only. Can be enabled for each by setting `horizontalSummary` to **true**. - Added `horizontalSummariesPosition` property to the `pivotUI`, configuring horizontal summaries position. - Added row headers for the row dimensions. Can be enabled inside the new `pivotUI` property as `showHeaders` **true**. - Keyboard navigation now can move in to row headers back and forth from any row dimension headers or column headers. @@ -575,84 +577,84 @@ The following table lists the bug fixes made for the {ProductName} toolset for t **Breaking Changes** - **All Grids** - - `RowIsland` + - - Removed `displayDensity` deprecated property. - Renamed `actualColumns`, `contentColumns` properties to `actualColumnList` and `contentColumnList`. Use `column` or `columnList` property to get all columns now. - - Renamed `rowDelete` and `rowAdd` event argument type to `RowDataCancelableEventArgs`. - - Renamed `contextMenu` event argument type to `GridContextMenuEventArgs`. - - Removed `GridEditEventArgs`, `GridEditDoneEventArgs`, `PinRowEventArgs` events `rowID` and `primaryKey` properties. Use `rowKey` instead. -- `PivotGrid` + - Renamed `rowDelete` and `rowAdd` event argument type to . + - Renamed `contextMenu` event argument type to . + - Removed , , events `rowID` and `primaryKey` properties. Use `rowKey` instead. +- - removed `showPivotConfigurationUI` property. Use `pivotUI` and set inside it the new `showConfiguration` option. -- `Column` +- - Removed `movable` property. Use Grid's `moving` property now. - Removed `columnChildren` property. Use `childColumns` instead. -- `ColumnGroup` +- - Removed `children` property. Use `childColumns` instead. -- `Paginator` +- - Removed `isFirstPageDisabled` and `isLastPageDisabled` properties. Use `isFirstPage` and `isLastPage` instead. ## **{PackageVerChanges-24-1-JUN}** ### {PackageCommon} -- `Input`, `Textarea` - exposed `ValidateOnly` to enable validation rules being enforced without restricting user input. -- `Dropdown` - `PositionStrategy` property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. -- `DockManager` - `SplitPane` `IsMaximized` is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the `IsMaximized` property of `TabGroupPane` and/or `ContentPane` instead. +- , - exposed to enable validation rules being enforced without restricting user input. +- - property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. +- - is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the property of and/or instead. ### {PackageGrids} - `DisplayDensity` deprecated in favor of the `--ig-size` CSS custom property. Check out the [Grid Size](grids/grid/size.md) topic for more regarding the Grid. ### {PackageCharts} -- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property `GroupRowVisible` toggles grouping with each series opting in can assign group text via the `DataLegendGroup` property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. +- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property toggles grouping with each series opting in can assign group text via the property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. -- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via `FillBrushes`. -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### {PackageGauges} -- `RadialGauge` - - New label for the highlight needle. `HighlightLabelText` and `HighlightLabelSnapsToNeedlePivot` and many other styling related properties for the HighlightLabel were added. +- + - New label for the highlight needle. and and many other styling related properties for the HighlightLabel were added. ## **{PackageVerChanges-23-2-MAR}** ### {PackageGrids} -- New [`HierarchicalGrid`](grids/hierarchical-grid/overview.md) component. +- New [](grids/hierarchical-grid/overview.md) component. ### {PackageCharts} -- New Data Filtering via the `InitialFilter` property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. +- New Data Filtering via the property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### {PackageGauges} -- `RadialGauge` - - New title/subtitle properties. `TitleText`, `SubtitleText` will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and `TitleExtent`. Finally, the new `TitleDisplaysValue` will allow the value to correspond with the needle's position. - - New `OpticalScalingEnabled` and `OpticalScalingSize` properties for the `RadialGauge`. This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `LinearGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `BulletGraph` - - The Performance bar will now reflect a difference between the value and new `HighlightValue` when the `HighlightValueDisplayMode` is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. +- + - New title/subtitle properties. , will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and . Finally, the new will allow the value to correspond with the needle's position. + - New and properties for the . This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - The Performance bar will now reflect a difference between the value and new when the is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. ## **{PackageVerChanges-23-2-JAN}** ### {PackageCharts} -- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The `CategoryChart` and `DataChart` now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. +- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The and now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. ## **{PackageVerChanges-23-2-DEC}** @@ -667,7 +669,7 @@ The following table lists the bug fixes made for the {ProductName} toolset for t - [Toolbar](menus/toolbar.md) - Save tool action has been added to save the chart to an image via the clipboard. - - Vertical orientation has been added via the toolbar's `Orientation` property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. + - Vertical orientation has been added via the toolbar's property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's `renderImageFromText` method, further enhancing custom tool creation. @@ -675,13 +677,13 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ### {PackageLayouts} -- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our `DataChart` or `CategoryChart` components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. +- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our or components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. ### {PackageCharts} -- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the `ValueLayer` is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the `CategoryChart` and `FinancialChart` by adding to the new `ValueLines` collection. +- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the and by adding to the new collection. -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **{PackageVerChanges-22-2.2}** @@ -689,14 +691,14 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ### {PackageGrids} -- A new argument `PrimaryKey` has been introduced to `IgcRowDataEventArgs`, and part of the event arguments that are emitted by the `RowAdded` and `RowDeleted` events. When the grid has a primary key attribute added, then the emitted primaryKey event argument represents the row ID, otherwise it defaults to undefined. +- A new argument has been introduced to `IgcRowDataEventArgs`, and part of the event arguments that are emitted by the `RowAdded` and `RowDeleted` events. When the grid has a primary key attribute added, then the emitted primaryKey event argument represents the row ID, otherwise it defaults to undefined. - `RowSelectionChanging` event arguments are changed. Now, the `OldSelection`, `NewSelection`, `Added` and `Removed` collections no longer consist of the row keys of the selected elements when the grid has set a primaryKey, but now in any case the row data is emitted. - When the grid is working with remote data and a primary key has been set, the selected rows that are not currently part of the grid view will be emitted for a partial row data object. - When selected row is deleted from the grid component `RowSelectionChanging` event will no longer be emitted. - The `OnGroupingDone` event has been renamed to `GroupingDone` to not violate the no on-prefixed outputs convention. - The `OnDensityChanged` event has been renamed to `DensityChanged` to not violate the no on-prefixed outputs convention. All components exposing this event are affected. -- `PivotGrid`: The `IgcPivotDateDimension` properties `InBaseDimension` and `InOption` have been deprecated and renamed to `BaseDimension` and `Options` respectively. +- : The `IgcPivotDateDimension` properties `InBaseDimension` and `InOption` have been deprecated and renamed to `BaseDimension` and `Options` respectively. ### {PackageInputs} @@ -704,8 +706,8 @@ The following table lists the bug fixes made for the {ProductName} toolset for t - `IgcDateTimeInput`, the StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date) is now trimmed down to DatePart instead of DateTimeInputDatePart - `IgcRadio` and `IgcRadioGroup`, added component validation along with styles for invalid state - `IgcMask`, added the capability to escape mask pattern literals. -- `IgcBadge` added a `Shape` property that controls the shape of the badge and can be either `Square` or `Rounded`. The default shape of the badge is rounded. -- `IgcAvatar`, the `RoundShape` property has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly added `Shape` attribute that can be `Square`, `Rounded` or `Circle`. The default shape of the avatar is `Square`. +- `IgcBadge` added a property that controls the shape of the badge and can be either or `Rounded`. The default shape of the badge is rounded. +- `IgcAvatar`, the `RoundShape` property has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly added attribute that can be , `Rounded` or . The default shape of the avatar is . ## **{PackageVerChanges-22-2.1}** @@ -721,9 +723,9 @@ The following table lists the bug fixes made for the {ProductName} toolset for t - New [Grid](grids/data-grid.md) component. - New [Tree Grid](grids/tree-grid/overview.md) component. - `DataGrid`: - - Changed **{IgPrefix}Column** to `DataGridColumn` - - Changed **GridCellEventArgs** to `DataGridCellEventArgs` - - Changed **GridSelectionMode** to `DataGridSelectionMode` + - Changed **{IgPrefix}Column** to + - Changed **GridCellEventArgs** to + - Changed **GridSelectionMode** to - Changed **SummaryOperand** to `DataSourceSummaryOperand` ### {PackageCharts} @@ -733,7 +735,7 @@ The following table lists the bug fixes made for the {ProductName} toolset for t - Responsive layouts for horizontal label rotation based on browser / screen size. - Enhanced rendering for rounded labels on all platforms. - Added marker properties to StackedFragmentSeries. -- Added `ShouldPanOnMaximumZoom` property. +- Added property. - New Category Axis Properties: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -753,7 +755,7 @@ The following table lists the bug fixes made for the {ProductName} toolset for t - GroupSorts - GroupSortDescriptions -[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties`. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using | . These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ## **{PackageVerChanges-22-1}** @@ -765,27 +767,27 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ### {PackageCharts} -- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the `Legend`, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. +- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the , but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable [DataToolTip](charts/features/chart-data-tooltip.md) which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types. -- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the `IsTransitionInEnabled` property to true. From there, you can set the `TransitionInDuration` property to determine how long your animation should take to complete and the `TransitionInMode` to determine the type of animation that takes place. -- Added `AssigningCategoryStyle` event, is now available to all series in `DataChart`. This event is handled when you want to conditionally configure aspects of the series items such as `Fill` background-color and highlighting. -- New `AllowedPositions` enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. +- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the property to true. From there, you can set the property to determine how long your animation should take to complete and the to determine the type of animation that takes place. +- Added `AssigningCategoryStyle` event, is now available to all series in . This event is handled when you want to conditionally configure aspects of the series items such as background-color and highlighting. +- New enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default. - - `CalloutCornerRadius` for CalloutLayer - - `AxisAnnotationBackgroundCornerRadius` for FinalValueLayer - - `XAxisAnnotationBackgroundCornerRadius` and `YAxisAnnotationBackgroundCornerRadius` for CrosshairLayer -- New `HorizontalViewScrollbarMode` and `VerticalViewScrollbarMode` enumeration to enable scrollbars in various ways. When paired with `IsVerticalZoomEnabled` or `IsHorizontalZoomEnabled`, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. -- New `FavorLabellingScaleEnd`, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. `NumericXAxis`, `NumericYAxis`, `PercentChangeAxis`). -- New `IsSplineShapePartOfRange` determines whether to include the spline shape in the axis range requested of the axis. -- New `XAxisMaximumGap`, determines the maximum allowed value for the plotted series when using `XAxisGap`. The gap determines the amount of space between columns or bars of plotted series. -- New `XAxisMinimumGapSize`, determines the minimum allowed pixel-based value for the plotted series when using `XAxisGap` to ensure there is always some spacing between each category. + - for CalloutLayer + - for FinalValueLayer + - and for CrosshairLayer +- New and enumeration to enable scrollbars in various ways. When paired with or , you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. +- New , determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. , , `PercentChangeAxis`). +- New determines whether to include the spline shape in the axis range requested of the axis. +- New , determines the maximum allowed value for the plotted series when using . The gap determines the amount of space between columns or bars of plotted series. +- New , determines the minimum allowed pixel-based value for the plotted series when using to ensure there is always some spacing between each category. ## **{PackageVerChanges-21-2.1}** ### {PackageGrids} - `DataGrid`: - - Added `ValueMultiField`, of type string[], in the `ComboBoxColumn` to be used when your items in the drop down contain a key that consists of multiple fields. + - Added , of type string[], in the to be used when your items in the drop down contain a key that consists of multiple fields. The following breaking changes were introduced: Changed `ValueField` property from type string[] to string. @@ -824,29 +826,29 @@ Please ensure package "lit-html": "^2.0.0" or newer is added to your project for This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -860,10 +862,10 @@ This release introduces a few improvements and simplifications to visual design - `DataGrid`: - Added `EditOnKeyPress` aka Excel-style Editing, instantly begin editing when typing. - - Added `EditModeClickAction` property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. - - Added `EnterKeyBehaviors` property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) - - Added `EnterKeyBehaviorAfterEdit` property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) - - Added `SelectAllRows` - method. + - Added property - By default double-clicking is required to enter edit mode. This can be set to to allow for edit mode to occur when selecting a new cell. + - Added property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) + - Added property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) + - Added - method. - Added Row Range Selection - With `GridSelectionMode` property set to MultipleRow the following new functionality is now included: - Click and drag to select rows - SHIFT and click to select multiple rows. @@ -874,15 +876,15 @@ This release introduces a few improvements and simplifications to visual design ### {PackageCharts} - Date Picker: - - `ShowTodayButton` - Toggles Today button visibility - - `Label` - Adds a label above the date value - - `Placeholder` property - adds custom text when no value is selected - - `FormatString` - Customize input date string e.g. (`yyyy-MM-dd`) - - `DateFormat` - Specifies whether to display selected dates as LongDate or ShortDate - - `FirstDayOfWeek` - Specifies first day of week - - `FirstWeekOfYear` - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) - - `ShowWeekNumbers` - Toggles Week number visibility - - `MinDate` & `MaxDate` - Date limits, specifying a range of available selectable dates. + - - Toggles Today button visibility + - - Adds a label above the date value + - property - adds custom text when no value is selected + - - Customize input date string e.g. (`yyyy-MM-dd`) + - - Specifies whether to display selected dates as LongDate or ShortDate + - - Specifies first day of week + - - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) + - - Toggles Week number visibility + - & - Date limits, specifying a range of available selectable dates. - Added Accessibility @@ -900,30 +902,30 @@ These features are CTP ### {PackageCharts} -This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. `DataChart`, `CategoryChart`, and `FinancialChart`. +This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. , , and . - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners - Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000 - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -946,8 +948,8 @@ for example: #### Chart Legend -- Added horizontal `Orientation` property to ItemLegend that can be used with Bubble, Donut, and Pie Chart -- Added `LegendHighlightingMode` property - Enables series highlighting when hovering over legend items +- Added horizontal property to ItemLegend that can be used with Bubble, Donut, and Pie Chart +- Added property - Enables series highlighting when hovering over legend items ## **{PackageVerChangedFields}** @@ -1113,44 +1115,44 @@ import { IgcLiveGridComponent } from 'igniteui-webcomponents-data-grids/ES5/igc- ### **{PackageCommonVerChanges-5.0.0}** -- `Icon` +- - Added `setIconRef` method. This allows to register and replace icons by SVG files. - All components now use icons by reference internally so that it's easy to replace them without explicitly providing custom templates. -- `RadioGroup` +- - Added `name` and `value` properties. **Breaking Changes** -- Removed `Form` component. Use native form instead. +- Removed component. Use native form instead. - Removed `size` property in favor of the `--ig-size` CSS custom property for the following components: - - `Avatar`, `Button`,`IconButton`, `Calendar`, `Chip`, `Dropdown`, `Icon`, `Input`, `List`, `Rating`, `Snackbar`, `Tabs`, `Tree` + - , ,, , , , , , , , , , - Removed custom `igcFocus` and `igcBlur` events. Use the native `focus` and `blur` events instead for the following components: - - `Button`, `IconButton`, `Checkbox`, `Switch`, `Combo`, `DateTimeInput`, `Input`, `MaskInput`, `Radio`, **IgcSelectComponent**, `Textarea` -- `Checkbox`, `Switch` ,`Radio` + - , , , , , , , , , **IgcSelectComponent**, +- , , - Changed `igcChange` event arguments from `CustomEvent` to `CustomEvent<{ checked: boolean; value: string | undefined }>` -- `Combo`, **IgcSelectComponent** +- , **IgcSelectComponent** - Removed `positionStrategy`, `flip`, `sameWidth` properties. -- `Dialog` +- - Renamed The `closeOnEscape` property to `keepOpenOnEscape`. -- `Dropdown` +- - Removed `positionStrategy` property. -- `Input` +- - Removed `maxlength` and `minlength` properties. Use the native `maxLength` and `minLength` properties or `max` and `min` instead. - Renamed `readonly` and `inputmode` properties to `readOnly` and `inputMode`. -- `RangeSlider` +- - Renamed `ariaThumbLower`/`ariaThumbUpper` properties to `thumbLabelLower`/`thumbLabelUpper`. -- `Rating` +- - Renamed `readonly` property to `readOnly`. ### **{PackageCommonVerChanges-4.11.1}** #### Changed -- `Stepper` - Design changes in vertical mode. +- - Design changes in vertical mode. ### **{PackageCommonVerChanges-4.11.0}** #### Changed -- `Toast`, `Rating`, `Stepper` - Styling changes in Indigo Theme. +- , , - Styling changes in Indigo Theme. ### **{PackageCommonVerChanges-4.10.0}** @@ -1158,117 +1160,117 @@ import { IgcLiveGridComponent } from 'igniteui-webcomponents-data-grids/ES5/igc- - New [Banner](notifications/banner.md) component - New [Divider](layouts/divider.md) component - New [DatePicker](scheduling/date-picker.md) component -- `RadioGroup` - Bind underlying radio components name and checked state through the radio group. +- - Bind underlying radio components name and checked state through the radio group. #### Deprecated -- `Input` `Inputmode` property. Aligned with the native `inputMode` DOM property instead. +- `Inputmode` property. Aligned with the native `inputMode` DOM property instead. #### Fixed -- `Input`, `Textarea` - passing `undefined` to value sets the underlying input value to undefined. -- `MaskInput` - after a form `reset` call correctly update underlying input value and placeholder state. -- `Tree` - setting `--ig-size` on the item `indicator` CSS Part will now change the size of the icon. -- `DateTimeInput` - double emit of `igcChange` in certain scenarios. -- `NavDrawer` - mini variant is not initially rendered when not in an open state. -- `Combo`: +- , - passing `undefined` to value sets the underlying input value to undefined. +- - after a form `reset` call correctly update underlying input value and placeholder state. +- - setting `--ig-size` on the item `indicator` CSS Part will now change the size of the icon. +- - double emit of `igcChange` in certain scenarios. +- - mini variant is not initially rendered when not in an open state. +- : - Selecting an entry using the ENTER key now correctly works in single selection mode. - - Turning on the `DisableFiltering` option now clears any previously entered search term. + - Turning on the option now clears any previously entered search term. - Entering a search term in single selection mode that already matches the selected item now works correctly. ### **{PackageCommonVerChanges-4.9.0}** #### Added -- `ButtonGroup` - now allows resetting the selection state via the `SelectedItems` property. -- `Input`, `Textarea` - exposed `ValidateOnly` to enable validation rules being enforced without restricting user input. +- - now allows resetting the selection state via the property. +- , - exposed to enable validation rules being enforced without restricting user input. #### Changed -- `Combo`, `Select` and `Dropdown` - now use the native `Popover` API. +- , and - now use the native `Popover` API. #### Deprecated -- `Dropdown` - `PositionStrategy` property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. +- - property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. #### Fixed -- `DateTimeInput` - Label in Material theme is broken when component is in read-only mode. +- - Label in Material theme is broken when component is in read-only mode. ### **{PackageCommonVerChanges-4.8.2}** #### Fixed -- `Textarea` - resize handle position for non-suffixed textarea. -- `Tabs` - error when dynamically creating and adding a tab group and tabs in a single call stack. -- `Checkbox`/`Switch` - participate in form submission when initially checked. -- `Dialog` - `igcClosed` fired before the component was actually closed/hidden. +- - resize handle position for non-suffixed textarea. +- - error when dynamically creating and adding a tab group and tabs in a single call stack. +- / - participate in form submission when initially checked. +- - `igcClosed` fired before the component was actually closed/hidden. ### **{PackageCommonVerChanges-4.8.1}** #### Fixed -- `DateTimeInput` - `InputFormat` is not applied to an already set value. -- `Checkbox`, `Radio`, `Switch` - apply form validation synchronously. -- `Select`, `Dropdown` - Unable to select item when clicking on a wrapping element inside the dropdown/select item slot. -- `Tree` - active state is correctly applied to the correct tree node on click. +- - is not applied to an already set value. +- , , - apply form validation synchronously. +- , - Unable to select item when clicking on a wrapping element inside the dropdown/select item slot. +- - active state is correctly applied to the correct tree node on click. ### **{PackageCommonVerChanges-4.8.0}** #### Added -- `Combo` can now set `GroupSorting` to none which shows the groups in the order of the provided data. -- `Button`/`IconButton` - updated visual looks across themes, new states. +- can now set to none which shows the groups in the order of the provided data. +- / - updated visual looks across themes, new states. - `NavBar` - added border in Bootstrap theme. #### Changed -- Grouping in `Combo` no longer sorts the data. `GroupSorting` property now affects the sorting direction only of the groups. **Behavioral change**: In previous release the sorting directions of the groups sorted the items as well. If you want to achieve this behavior you can pass already sorted data to the `Combo`. +- Grouping in no longer sorts the data. property now affects the sorting direction only of the groups. **Behavioral change**: In previous release the sorting directions of the groups sorted the items as well. If you want to achieve this behavior you can pass already sorted data to the . #### Deprecated -- `Slider` - `aria-label-upper` and `aria-label-lower` are deprecated and will be removed in the next major release. Use `thumb-label-upper` and `thumb-label-lower` instead. +- - `aria-label-upper` and `aria-label-lower` are deprecated and will be removed in the next major release. Use `thumb-label-upper` and `thumb-label-lower` instead. #### Fixed -- `Button` - Slotted icon size. -- `ButtonGroup` +- - Slotted icon size. +- - Updated Fluent theme look. - Disabled state in Safari. -- `Combo`/`Select` - Style issues. -- `Slider` +- / - Style issues. +- - Clicks on the slider track now use the track element width as a basis for the calculation. - Input events are no longer emitted while continuously dragging the slider thumb and exceeding upper/lower bounds. - When setting `upper-bound`/`lower-bound` before `min`/`max`, the slider will no longer overwrite the bound properties with the previous values of `min`/`max`. - The `aria-label` bound to the slider thumb is no longer reset on consequent renders. -- `Input` +- - Default validators are run synchronously. - Style issues. -- `DateTimeInput` - `setRangeText()` updates underlying value. +- - `setRangeText()` updates underlying value. ### **{PackageCommonVerChanges-4.7.0}** #### Added -- `Tree` - Added `ToggleNodeOnClick` property that determines whether clicking over a node will change its expanded state or not. Defaults to `false`. +- - Added property that determines whether clicking over a node will change its expanded state or not. Defaults to `false`. -- `Rating` - `AllowReset` added. When enabled selecting the same value will reset the component. **Behavioral change**: In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. +- - added. When enabled selecting the same value will reset the component. **Behavioral change**: In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. #### Changed -- Improved WAI-ARIA compliance for `Avatar`, `Badge` and `Combo`. +- Improved WAI-ARIA compliance for , and . #### Fixed -- Active item visual styles for `Dropdown`, `Select` and `Combo`. -- `NavDrawer` - mini variant broken visual style. +- Active item visual styles for , and . +- - mini variant broken visual style. ### **{PackageCommonVerChanges-4.6.0}** #### Added -- `action` slot added to `Snackbar`. -- `indicator-expanded` slot added to `ExpansionPanel`. -- `toggle-icon-expanded` slot added to `Select`. -- `Select`, `Dropdown` - exposed `selectedItem`, `items` and `groups` getters. +- `action` slot added to . +- `indicator-expanded` slot added to . +- `toggle-icon-expanded` slot added to . +- , - exposed `selectedItem`, `items` and `groups` getters. #### Changed - Updated the package to Lit v3. - Components dark variants are now bound to their shadow root. - Components implement default sizes based on current theme. -- `ButtonGroup` - changed events to non-cancellable. +- - changed events to non-cancellable. - Optimized components CSS and reduced bundle size. -- WAI-ARIA improvements for `Icon`, `Select`, `Dropdown` and `List`. +- WAI-ARIA improvements for , , and . #### Fixed -- `Textarea` missing styling parts. -- `TreeItem` disabled styles. -- `Snackbar` removed unnecessary styles. -- `TreeItem` hover state visual design. -- `Calendar` not keeping focus state when switching views. +- missing styling parts. +- disabled styles. +- removed unnecessary styles. +- hover state visual design. +- not keeping focus state when switching views. ### **{PackageCommonVerChanges-4.5.0}** @@ -1276,13 +1278,13 @@ import { IgcLiveGridComponent } from 'igniteui-webcomponents-data-grids/ES5/igc- - New [Text Area](inputs/text-area.md) component. - New [Button Group](inputs/button-group.md) component. -- New `ToggleButton`. -- `NavDrawer` now supports CSS transitions. -- Position attribute for `Toast` and `Snackbar`. +- New . +- now supports CSS transitions. +- Position attribute for and . #### Deprecated -The `size` property and attribute have been deprecated for all components. Use the `--ig-size` CSS custom property instead. The following example sets the size of the `Avatar` component to small: +The `size` property and attribute have been deprecated for all components. Use the `--ig-size` CSS custom property instead. The following example sets the size of the component to small: ```css igc-avatar { @@ -1302,83 +1304,83 @@ igc-avatar { #### Added - The following components are now Form Associated Custom Elements. They are automatically associated with a parent `
` and behave like a browser-provided control: - - `Button` & `IconButton` - - `Checkbox` - - `Combo` - - `DateTimeInput` - - `Input` - - `MaskInput` - - `Radio` - - `Rating` - - Single `Slider` - - `Select` - - `Switch` -- `Stepper` now supports animations. + - & + - + - + - + - + - + - + - + - Single + - + - +- now supports animations. #### Changed -- `Rating` fluent theme colors. -- `Stepper` indicator styles and color schemas. +- fluent theme colors. +- indicator styles and color schemas. #### Deprecated - `IgcForm` component is deprecated. -- `Input`: +- : - `minlength` property is deprecated and will be removed in the next major version. Use `minLength` instead. - `maxlength` property is deprecated and will be removed in the next major version. Use `maxLength` instead. - `readonly` property is deprecated and will be removed in the next major version. Use `readOnly` instead. -- `MaskInput`: +- : - `readonly` property is deprecated and will be removed in the next major version. Use `readOnly` instead. -- `DateTimeInput`: +- : - `readonly` property is deprecated and will be removed in the next major version. Use `readOnly` instead. - `minValue` property is deprecated and will be removed in the next major version. Use `min` instead. - `maxValue` property is deprecated and will be removed in the next major version. Use `max` instead. -- `Rating`: +- : - `readonly` property is deprecated and will be removed in the next major version. Use `readOnly` instead. #### Removed - Removed our own `dir` attribute which shadowed the default one. This is a **non-breaking change**. -- `Slider` - `ariaLabel` shadowed property. This is a **non-breaking change**. -- `Checkbox` - `ariaLabelledBy` shadowed attribute. This is a **non-breaking change**. -- `Switch` - `ariaLabelledBy` shadowed attribute. This is a **non-breaking change**. -- `Radio` - `ariaLabelledBy` shadowed attribute. This is a **non-breaking change**. +- - `ariaLabel` shadowed property. This is a **non-breaking change**. +- - `ariaLabelledBy` shadowed attribute. This is a **non-breaking change**. +- - `ariaLabelledBy` shadowed attribute. This is a **non-breaking change**. +- - `ariaLabelledBy` shadowed attribute. This is a **non-breaking change**. #### Fixed -- `Input` - outlined variant styling issues and indigo theme issues. -- `Select` - outlined variant styling issues -- `DateTimeInput` - `spinUp/spinDown` calls moving the caret when the input is focused. +- - outlined variant styling issues and indigo theme issues. +- - outlined variant styling issues +- - `spinUp/spinDown` calls moving the caret when the input is focused. ### **{PackageCommonVerChanges-4.3.1}** #### Added -- `Tree` - component animations. +- - component animations. - Components border radius is consumed from their schemas. #### Changed -- `Combo`, `Input`, `Select` - schema colors. -- `Dropdown` - schema colors. -- `Icon` - updated theming styles and size. +- , , - schema colors. +- - schema colors. +- - updated theming styles and size. #### Fixed -- `Combo` - single selection not working in certain scenarios. -- `Dropdown` - various styling fixes. -- `IconButton` - border radius with ripple. -- `IconButton` - fixed wrong color in Fluent theme. -- `Input` - various styling fixes. -- `TreeItem` - assign closest **igc-tree-item** ancestor as a parent. -- `Tabs` - internal **hidden** styles and custom display property. +- - single selection not working in certain scenarios. +- - various styling fixes. +- - border radius with ripple. +- - fixed wrong color in Fluent theme. +- - various styling fixes. +- - assign closest **igc-tree-item** ancestor as a parent. +- - internal **hidden** styles and custom display property. ### **{PackageCommonVerChanges-4.3.0}** #### Added -- `Combo`: +- : - `matchDiacritics` to the filtering options property. Defaults to **false**. If set to **true** the filter distinguishes between accented letters and their base letters. Otherwise strings are normalized and then matched. - `selection` property which returns the current selection as an array of data objects. -- `Card`: Support explicit height -- `Dialog`: Added animations -- `Snackbar`: Added animations -- `Toast`: Added animations +- : Support explicit height +- : Added animations +- : Added animations +- : Added animations #### Changed -- `Combo`: +- : - `value` is no longer readonly and can be explicitly set. The value attribute also supports declarative binding, accepting a valid JSON stringified array. - `value` type changed from `string[]` to `ComboValue[]` where @@ -1400,65 +1402,65 @@ interface IgcComboChangeEventArgs { #### Deprecated -- `Select`: Deprecated `sameWidth`, `positionStrategy` and `flip`. They will be removed in the next major release. +- : Deprecated `sameWidth`, `positionStrategy` and `flip`. They will be removed in the next major release. #### Fixed -- `Select`: `prefix`/`suffix`/`helper-text` slots not being rendered. -- `Tabs`: Nested tabs selection. -- `Dialog`: Backdrop doesn't overlay elements. -- `Dropdown`: Listbox position on initial open state. -- `Stepper`: Stretch vertically in parent container. -- `Navbar`: Wrong colors in fluent theme. +- : `prefix`/`suffix`/`helper-text` slots not being rendered. +- : Nested tabs selection. +- : Backdrop doesn't overlay elements. +- : Listbox position on initial open state. +- : Stretch vertically in parent container. +- : Wrong colors in fluent theme. - Animation player throws errors when height is unspecified. -- `DateTimeInput`: Intl.DateTimeFormat issues in Chromium based browsers. +- : Intl.DateTimeFormat issues in Chromium based browsers. ### **{PackageCommonVerChanges-4.2.3}** #### Deprecated -- `Dialog` - Property `closeOnEscape` is deprecated in favor of new property `keepOpenOnEscape`. +- - Property `closeOnEscape` is deprecated in favor of new property `keepOpenOnEscape`. #### Fixed -- `Radio`- colors in selected focus state. -- `IconButton` - set icon size to match other design system products. -- `Chip` - removed outline styles for Fluent and Material themes. -- `Calendar` - navigation to date on set value. -- `Tabs` - not taking the full height of their parents. +- - colors in selected focus state. +- - set icon size to match other design system products. +- - removed outline styles for Fluent and Material themes. +- - navigation to date on set value. +- - not taking the full height of their parents. ### **{PackageCommonVerChanges-4.2.2}** #### Deprecated -- `Button` - The `prefix`/`suffix` slots are no longer needed and will be removed in the next major release. +- - The `prefix`/`suffix` slots are no longer needed and will be removed in the next major release. #### Fixed -- `Button` - UI inconsistencies. -- `Calendar` - Fluent theme inconsistencies. -- `Combo` - Selection via API doesn't work on a searched list. -- `Dialog` - Fluent theme inconsistency. -- `Input` - UI inconsistencies. -- `Toast` - Fluent theme inconsistency. +- - UI inconsistencies. +- - Fluent theme inconsistencies. +- - Selection via API doesn't work on a searched list. +- - Fluent theme inconsistency. +- - UI inconsistencies. +- - Fluent theme inconsistency. - Components missing in defineAllComponents. -- Wrong host sizes for `Avatar`, `Badge`, `Button` and `IconButton`. +- Wrong host sizes for , , and . ### **{PackageCommonVerChanges-4.2.1}** #### Fixed -- `Combo` - Matching item not activated on filtering in single selection mode. +- - Matching item not activated on filtering in single selection mode. ### **{PackageCommonVerChanges-4.2.0}** #### Added -- `Combo` - Single Selection mode via the `single-select` attribute. +- - Single Selection mode via the `single-select` attribute. #### Fixed -- `Input` - UI inconsistencies. -- `Badge` - Doesn't correctly render `igc-icon` and font icons. -- `Radio` - UI inconsistencies. -- `NavDrawer` - Can't override item margin. +- - UI inconsistencies. +- - Doesn't correctly render `igc-icon` and font icons. +- - UI inconsistencies. +- - Can't override item margin. ### **{PackageCommonVerChanges-4.1.1}** #### Fixed -- `Input` +- - position label based on component size. - material themes don't match design. - do not cache the underlying input. @@ -1471,10 +1473,10 @@ interface IgcComboChangeEventArgs { #### Added - New [Stepper](layouts/stepper.md) component. - New [Combo](inputs/combo/overview.md) component. -- `MaskInput` - Skip literal positions when deleting symbols in the component +- - Skip literal positions when deleting symbols in the component #### Fixed -- `MaskInput` - Validation state on user input. +- - Validation state on user input. ### **{PackageCommonVerChanges-4.0.0}** @@ -1493,11 +1495,11 @@ interface IgcComboChangeEventArgs { ### **{PackageCommonVerChanges-3.4.1}** #### Changed -- `Slider` - updated theme with the latest fluent spec. -- `Calendar` - updated weekend days color. +- - updated theme with the latest fluent spec. +- - updated weekend days color. #### Fixed -- `Tabs` `selected` attribute breaks content visibility on init. +- `selected` attribute breaks content visibility on init. ### **{PackageCommonVerChanges-3.4.0}** @@ -1506,22 +1508,22 @@ interface IgcComboChangeEventArgs { - New [Select](inputs/select.md) component. #### Fixed -- `Calendar` - range selection a11y improvements. -- `RangeSlider` - a11y improvements for choosing range values. -- `Rating` - improved a11y with assistive software now reading the total number of items. -- `Toast` - added `role="alert"` to the message container for assistive software to read it without the need of focusing. -- `Chip` - made remove button accessible with the keyboard. -- `Button` `prefix`/`suffix` does not align icons to the button text. +- - range selection a11y improvements. +- - a11y improvements for choosing range values. +- - improved a11y with assistive software now reading the total number of items. +- - added `role="alert"` to the message container for assistive software to read it without the need of focusing. +- - made remove button accessible with the keyboard. +- `prefix`/`suffix` does not align icons to the button text. ### **{PackageCommonVerChanges-3.3.1}** #### Changed -- `Tree` - Removed theme-specified height. +- - Removed theme-specified height. #### Fixed -- `Dropdown` - Dispose of top-level event listeners. -- `LinearProgress` - Indeterminate animation in Safari. -- `RadioGroup` - Child radio components auto-registration. +- - Dispose of top-level event listeners. +- - Indeterminate animation in Safari. +- - Child radio components auto-registration. ### **{PackageCommonVerChanges-3.3.0}** @@ -1532,8 +1534,8 @@ interface IgcComboChangeEventArgs { - Typography styles in themes. #### Changed -- `Rating` - Added support for single selection and empty symbols. -- `Slider` - Improved slider steps rendering. +- - Added support for single selection and empty symbols. +- - Improved slider steps rendering. - Components will now auto register their dependencies when they are registered in `defineComponents` @@ -1551,11 +1553,11 @@ Check the official [documentation](https://www.infragistics.com/products/ignite- #### Fixed - Remove input helper text container when it is empty. -- `Icon` not showing in Safari. -- `Checkbox` not showing in Safari. -- `Button` stretches correctly in flex containers. +- not showing in Safari. +- not showing in Safari. +- stretches correctly in flex containers. - Various theming issues. -- `Dropdown` - bug fixes and improvements. +- - bug fixes and improvements. ### **{PackageCommonVerChanges-3.2.0}** @@ -1563,27 +1565,27 @@ Check the official [documentation](https://www.infragistics.com/products/ignite- - New [MaskInput](inputs/mask-input.md) component. - New [ExpansionPanel](layouts/expansion-panel.md) component. - New [Tree](grids/tree.md) component. -- `Rating` - Added `selected` CSS part and exposed CSS variable to control symbol sizes. -- `IconButton` - Allow slotted content. +- - Added `selected` CSS part and exposed CSS variable to control symbol sizes. +- - Allow slotted content. #### Fixed -- `NavDrawer` - Various styles fixes. +- - Various styles fixes. - Buttons - Vertical align and focus management. -- `Input` - Overflow for `suffix`/`prefix`. -- `Switch` - Collapse with small sizes. -- `List` - Overflow behavior. +- - Overflow for `suffix`/`prefix`. +- - Collapse with small sizes. +- - Overflow behavior. ### **{PackageCommonVerChanges-3.1.0}** #### Added -- `Chip`: Added `prefix` and `suffix` slots. -- `Snackbar`: Added `toggle` method. +- : Added `prefix` and `suffix` slots. +- : Added `toggle` method. #### Deprecated -- `Chip`: Previously exposed `start` and `end` slots are replaced by `prefix` and `suffix`. They remain active, but are now deprecated and will be removed in a future version. +- : Previously exposed `start` and `end` slots are replaced by `prefix` and `suffix`. They remain active, but are now deprecated and will be removed in a future version. #### Fixed -- `Chip`: +- : - Auto load internal icons. - Selected chip is misaligned. - Package: ESM internal import paths. @@ -1597,7 +1599,7 @@ Check the official [documentation](https://www.infragistics.com/products/ignite- #### Added - New [DropDown](inputs/dropdown.md) component. -- `Calendar`: Active date can be set via an attribute. +- : Active date can be set via an attribute. ### **{PackageCommonVerChanges-2.1.1}** @@ -1631,16 +1633,16 @@ Example: - Dark Themes - New [Slider](inputs/slider.md) component. - New [RangeSlider](inputs/slider.md) component. -- Support `required` property in `Radio` component. +- Support `required` property in component. #### Changed - Fix checkbox/switch validity status -- Split `Calendar`'s `value: Date | Date[]` property into two properties - `value: Date` and `values: Date[]` -- Replaced `Calendar`'s `hasHeader` property & `has-header` attribute with `hideHeader` & `hide-header` respectively. -- Replaced `Card`'s `outlined` property with `elevated`. +- Split 's `value: Date | Date[]` property into two properties - `value: Date` and `values: Date[]` +- Replaced 's `hasHeader` property & `has-header` attribute with `hideHeader` & `hide-header` respectively. +- Replaced 's `outlined` property with `elevated`. #### Removed -- Removed `igcOpening`, `igcOpened`, `igcClosing` and `igcClosed` events from `NavDrawer` component. +- Removed `igcOpening`, `igcOpened`, `igcClosing` and `igcClosed` events from component. ### **{PackageCommonVerChanges-1.0.0}** @@ -1673,7 +1675,7 @@ Initial release of Ignite UI Web Components ### **{PackageDockManagerVerChanges-1.14.4}** #### Deprecated -- `SplitPane` `IsMaximized` is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the `IsMaximized` property of `TabGroupPane` and/or `ContentPane` instead. +- is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the property of and/or instead. ### **{PackageDockManagerVerChanges-1.14.3}** @@ -1704,13 +1706,13 @@ Initial release of Ignite UI Web Components #### Fixed - Maximizing and unpinning panes leads to unclickable panes. -- Center dock is possible in a pane that has `AcceptsInnerDock` set to **true** if the `AllowInnerDock` of `DockManager` is set to **false**. +- Center dock is possible in a pane that has set to **true** if the of is set to **false**. ### **{PackageDockManagerVerChanges-1.13.0}** #### New features -- Add `FocusPane` method. -- Add `AllowInnerDock` and `AcceptsInnerDock` properties. +- Add method. +- Add and properties. #### Enhancements - Save pane maximized state in layout. @@ -1752,7 +1754,7 @@ Initial release of Ignite UI Web Components #### Enhancements - Include pane information in `splitterResizeStart` and `splitterResizeEnd` events. -- `DockManager` is now exported as class. +- is now exported as class. #### Fixed - Contents in slots with `unpinnedHeaderId` are not updated correctly. @@ -1786,7 +1788,7 @@ Initial release of Ignite UI Web Components ### **{PackageDockManagerVerChanges-1.11.0}** #### New features -- Add options for `ShowHeaderIconOnHover` property for different buttons +- Add options for property for different buttons - Add `horizontal` and `vertical` options for `splitter-handle` CSS part - Add `header-title` CSS part - Add `hover` option for `tab-header-close-button` CSS part in active/inactive states @@ -1795,7 +1797,7 @@ Initial release of Ignite UI Web Components ### **{PackageDockManagerVerChanges-1.10.0}** #### New features -- Add `ShowHeaderIconOnHover` property. +- Add property. #### Fixed - Active pane is not retained on float/dock. @@ -1819,10 +1821,10 @@ Initial release of Ignite UI Web Components #### New features - Customizable floating pane header. -- `Disabled` property per pane. -- `DocumentOnly` property which allows content pane to be docked only inside a document host. -- `AllowEmpty` property for split and tab group panes which allows displaying empty areas. -- `DisableKeyboardNavigation` property on the dock manager. +- property per pane. +- property which allows content pane to be docked only inside a document host. +- property for split and tab group panes which allows displaying empty areas. +- property on the dock manager. #### Fixed - Docking indicators appear over the currently dragged floating pane. @@ -1838,7 +1840,7 @@ Initial release of Ignite UI Web Components ### **{PackageDockManagerVerChanges-1.5.0}** #### New features -- `AllowMaximize` property per pane. +- property per pane. #### Fixed - Unpinned pane is closing automatically upon clicking on its content. diff --git a/docs/xplat/src/content/en/components/general-changelog-dv.mdx b/docs/xplat/src/content/en/components/general-changelog-dv.mdx index d337bbfa38..ebd5da3abc 100644 --- a/docs/xplat/src/content/en/components/general-changelog-dv.mdx +++ b/docs/xplat/src/content/en/components/general-changelog-dv.mdx @@ -16,6 +16,8 @@ import chartdefaults3 from '@xplat-images/chartDefaults3.png'; import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} Changelog All notable changes for each version of {ProductName} are documented on this page. @@ -77,9 +79,9 @@ Added OthersCategoryBrush and OthersCategoryOutline to DataPieChart and Proporti #### User Annotations -In {ProductName}, you can now annotate the `DataChart` with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. +In {ProductName}, you can now annotate the with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. +This is directly integrated with the available tools of the . {Platform} user-annotation-create @@ -87,8 +89,8 @@ This is directly integrated with the available tools of the `Toolbar`. Ability for axis annotations to automatically detect collisions and truncate to fit better. To enable this feature you must set the following properties: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### {PackageMaps} (Geographic Map) @@ -130,37 +132,37 @@ The following events have been added to the `IgxDataChart` to allow you to detec #### Companion Axis -Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the `CompanionAxisEnabled` property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. +Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. #### RadialPieSeries Inset Outlines -There is a new property called `UseInsetOutlines` to control how outlines on the `RadialPieSeries` are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. +There is a new property called to control how outlines on the are rendered. Setting this value to **true** will inset the outlines within the slice shape, whereas a **false** (default) value will place the outlines half-in half-out along the edge of the slice shape. **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### Enhancements #### IgxBulletGraph -- Added new `LabelsVisible` property +- Added new property #### Charts - New properties added to the DataToolTipLayer, ItemToolTipLayer, and CategoryToolTipLayer to aid in styling: `ToolTipBackground`, `ToolTipBorderBrush`, and `ToolTipBorderThickness` -- New properties added to the DataLegend to aid in styling: `ContentBackground`, `ContentBorderBrush`, and `ContentBorderThickness`. The `ContentBorderBrush` and `ContentBorderThickness` default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. +- New properties added to the DataLegend to aid in styling: , , and . The and default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. -- Added a new property to `ChartMouseEventArgs` called `WorldPosition` that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. +- Added a new property to called that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. -- Added `HighlightingFadeOpacity` to `SeriesViewer` and `DomainChart`. This allows you to configure the opacity applied to highlighted series. +- Added to and . This allows you to configure the opacity applied to highlighted series. - Expose `CalloutLabelUpdating` event for domain charts. #### IgxLinearGauge -- Added new `LabelsVisible` property +- Added new property ### Bug Fixes @@ -210,11 +212,11 @@ For more details please visit: - Data Annotation Slice Layer - Data Annotation Strip Layer -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. -- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. +- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. - [Trendline Layer](charts/features/chart-trendlines.md) series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple [TrendlineLayer](charts/features/chart-overlays.md) series types in the chart. @@ -251,9 +253,9 @@ For more details please visit: #### Toolbar -- Added new `GroupHeaderTextStyle` property to `Toolbar` and `ToolPanel`. If set, it will apply to all `ToolActionGroupHeader` actions. -- Added new property on `ToolAction` called `TitleHorizontalAlignment` which controls the horizontal alignment of the title text. -- Added new property on `ToolActionSubPanel` called `ItemSpacing` which controls the spacing between items inside the panel. +- Added new `GroupHeaderTextStyle` property to and . If set, it will apply to all actions. +- Added new property on called which controls the horizontal alignment of the title text. +- Added new property on called which controls the spacing between items inside the panel. ### Bug Fixes @@ -291,11 +293,11 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ## **{PackageVerChanges-24-1-SEP}** -- [Data Pie Chart](charts/types/data-pie-chart.md) - The `DataPieChart` is a new component that renders a pie chart. This component works similarly to the `CategoryChart`, 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. +- [Data Pie Chart](charts/types/data-pie-chart.md) - The is a new component that renders a pie chart. This component works similarly to the , 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. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -314,67 +316,67 @@ The following table lists the bug fixes made for the {ProductName} toolset for t ### {PackageCharts} (Charts) -- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property `GroupRowVisible` toggles grouping with each series opting in can assign group text via the `DataLegendGroup` property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. +- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property toggles grouping with each series opting in can assign group text via the property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via `FillBrushes`. -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### {PackageGauges} (Gauges) -- `RadialGauge` - - New label for the highlight needle. `HighlightLabelText` and `HighlightLabelSnapsToNeedlePivot` and many other styling related properties for the HighlightLabel were added. +- + - New label for the highlight needle. and and many other styling related properties for the HighlightLabel were added. ## **{PackageVerChanges-23-2-MAR}** ### {PackageCharts} -- New Data Filtering via the `InitialFilter` property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. +- New Data Filtering via the property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### {PackageGauges} -- `RadialGauge` - - New title/subtitle properties. `TitleText`, `SubtitleText` will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and `TitleExtent`. Finally, the new `TitleDisplaysValue` will allow the value to correspond with the needle's position. - - New `OpticalScalingEnabled` and `OpticalScalingSize` properties for the `RadialGauge`. This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `LinearGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `BulletGraph` - - The Performance bar will now reflect a difference between the value and new `HighlightValue` when the `HighlightValueDisplayMode` is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. +- + - New title/subtitle properties. , will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and . Finally, the new will allow the value to correspond with the needle's position. + - New and properties for the . This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - The Performance bar will now reflect a difference between the value and new when the is applied to the 'Overlay' setting. The highlight value will show a filtered/subset completed measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. ## **{PackageVerChanges-23-2-JAN}** ### {PackageCharts} (Charts) -- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The `CategoryChart` and `DataChart` now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. +- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The and now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. ## **{PackageVerChanges-23-2}** ### {PackageGrids} - Toolbar - - Save tool action has been added to save the chart to an image via the clipboard. -- Vertical orientation has been added via the toolbar's `Orientation` property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. +- Vertical orientation has been added via the toolbar's property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's `renderImageFromText` method, further enhancing custom tool creation. ## **{PackageVerChanges-23-1}** ### New Components -- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our `DataChart` or `CategoryChart` components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. +- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our or components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. ### {PackageCharts} (Charts) -- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the `ValueLayer` is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the `CategoryChart` and `FinancialChart` by adding to the new `ValueLines` collection. +- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the and by adding to the new collection. -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **{PackageVerChanges-22-2.2}** - Angular 16 support. @@ -389,7 +391,7 @@ Added significant improvements to default behaviors, and refined the Category Ch - Responsive layouts for horizontal label rotation based on browser / screen size. - Enhanced rendering for rounded labels on all platforms. - Added marker properties to StackedFragmentSeries. -- Added `ShouldPanOnMaximumZoom` property. +- Added property. - New Category Axis Properties: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -410,25 +412,25 @@ Added significant improvements to default behaviors, and refined the Category Ch - GroupSortDescriptions -The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties` because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using | because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ## **{PackageVerChanges-22-1}** ### {PackageCharts} (Charts) -- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the `Legend`, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. +- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the , but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable [DataToolTip](charts/features/chart-data-tooltip.md) which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types. -- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the `IsTransitionInEnabled` property to true. From there, you can set the `TransitionInDuration` property to determine how long your animation should take to complete and the `TransitionInMode` to determine the type of animation that takes place. -- Added `AssigningCategoryStyle` event, is now available to all series in `DataChart`. This event is handled when you want to conditionally configure aspects of the series items such as `Fill` background-color and highlighting. -- New `AllowedPositions` enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. +- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the property to true. From there, you can set the property to determine how long your animation should take to complete and the to determine the type of animation that takes place. +- Added `AssigningCategoryStyle` event, is now available to all series in . This event is handled when you want to conditionally configure aspects of the series items such as background-color and highlighting. +- New enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default. - - `CalloutCornerRadius` for CalloutLayer - - `AxisAnnotationBackgroundCornerRadius` for FinalValueLayer - - `XAxisAnnotationBackgroundCornerRadius` and `YAxisAnnotationBackgroundCornerRadius` for CrosshairLayer -- New `HorizontalViewScrollbarMode` and `VerticalViewScrollbarMode` enumeration to enable scrollbars in various ways. When paired with `IsVerticalZoomEnabled` or `IsHorizontalZoomEnabled`, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. -- New `FavorLabellingScaleEnd`, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. `NumericXAxis`, `NumericYAxis`, `PercentChangeAxis`). -- New `IsSplineShapePartOfRange` determines whether to include the spline shape in the axis range requested of the axis. -- New `XAxisMaximumGap`, determines the maximum allowed value for the plotted series when using `XAxisGap`. The gap determines the amount of space between columns or bars of plotted series. -- New `XAxisMinimumGapSize`, determines the minimum allowed pixel-based value for the plotted series when using `XAxisGap` to ensure there is always some spacing between each category. + - for CalloutLayer + - for FinalValueLayer + - and for CrosshairLayer +- New and enumeration to enable scrollbars in various ways. When paired with or , you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. +- New , determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. , , `PercentChangeAxis`). +- New determines whether to include the spline shape in the axis range requested of the axis. +- New , determines the maximum allowed value for the plotted series when using . The gap determines the amount of space between columns or bars of plotted series. +- New , determines the minimum allowed pixel-based value for the plotted series when using to ensure there is always some spacing between each category.
@@ -442,29 +444,29 @@ Please ensure package "lit-html": "^2.0.0" or newer is added to your project for This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -476,30 +478,30 @@ This release introduces a few improvements and simplifications to visual design ## **{PackageVerChanges-21-1}** ### {PackageCharts} (Charts) -This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. `DataChart`, `CategoryChart`, and `FinancialChart`. +This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. , , and . - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners - Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000 - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -522,8 +524,8 @@ for example: #### Chart Legend -- Added horizontal `Orientation` property to ItemLegend that can be used with Bubble, Donut, and Pie Chart -- Added `LegendHighlightingMode` property - Enables series highlighting when hovering over legend items +- Added horizontal property to ItemLegend that can be used with Bubble, Donut, and Pie Chart +- Added property - Enables series highlighting when hovering over legend items ### {PackageMaps} (GeoMap) diff --git a/docs/xplat/src/content/en/components/general-cli-overview.mdx b/docs/xplat/src/content/en/components/general-cli-overview.mdx index bafd0b86db..1f14544815 100644 --- a/docs/xplat/src/content/en/components/general-cli-overview.mdx +++ b/docs/xplat/src/content/en/components/general-cli-overview.mdx @@ -183,7 +183,7 @@ ig list For a guided walkthrough of the component addition wizard, see [Step-by-Step Guide Using Ignite UI CLI](general-step-by-step-guide-using-cli.md#add-view). - + Your routing file will be updated with the path to the newly generated page. For example, a component named `MyGrid` will be navigable at `/my-grid`. @@ -290,7 +290,7 @@ If you have the CLI installed globally: ig ai-config ``` - + Without a version pin, `npx` may pull an older CLI version that does not recognize the `ai-config` subcommand and will instead launch an interactive project-creation prompt, scaffolding a new project inside your existing one. Make sure that you have installed CLI version 16.x. diff --git a/docs/xplat/src/content/en/components/general-step-by-step-guide-using-cli.mdx b/docs/xplat/src/content/en/components/general-step-by-step-guide-using-cli.mdx index 0625f3d77c..e776dd304f 100644 --- a/docs/xplat/src/content/en/components/general-step-by-step-guide-using-cli.mdx +++ b/docs/xplat/src/content/en/components/general-step-by-step-guide-using-cli.mdx @@ -153,7 +153,7 @@ For example: ig add grid MyGrid ``` - + Your routing file will be updated with the path to the newly generated page. For example, a component named `MyGrid` will be navigable at `/my-grid`. diff --git a/docs/xplat/src/content/en/components/geo-map-binding-data-model.mdx b/docs/xplat/src/content/en/components/geo-map-binding-data-model.mdx index 59539933bd..1ca006a241 100644 --- a/docs/xplat/src/content/en/components/geo-map-binding-data-model.mdx +++ b/docs/xplat/src/content/en/components/geo-map-binding-data-model.mdx @@ -28,13 +28,13 @@ The following table summarized data structures required for each type of geograp | Geographic Series | Properties | Description | |--------------|---------------| ---------------| -| | `LongitudeMemberPath`, `LatitudeMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates | -| | `LongitudeMemberPath`, `LatitudeMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates | -| | `LongitudeMemberPath`, `LatitudeMemberPath`, `RadiusMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for size/radius of symbols | -| | `LongitudeMemberPath`, `LatitudeMemberPath`, `ColorMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | -| | `LongitudeMemberPath`, `LatitudeMemberPath`, `ValueMemberPath` | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | -||`ShapeMemberPath`|Specifies the name of data column of items that contains the geographic points of shapes. This property must be mapped to an array of arrays of objects with x and y properties. | -||`ShapeMemberPath`|Specifies the name of data column of items that contains the geographic coordinates of lines. This property must be mapped to an array of arrays of objects with x and y properties. | +| | , | Specifies names of 2 numeric longitude and latitude coordinates | +| | , | Specifies names of 2 numeric longitude and latitude coordinates | +| | , , | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for size/radius of symbols | +| | , , | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | +| | , , | Specifies names of 2 numeric longitude and latitude coordinates and 1 numeric column for triangulation of values | +|||Specifies the name of data column of items that contains the geographic points of shapes. This property must be mapped to an array of arrays of objects with x and y properties. | +|||Specifies the name of data column of items that contains the geographic coordinates of lines. This property must be mapped to an array of arrays of objects with x and y properties. | ## Code Snippet The following code shows how to bind the to a custom data model that contains geographic locations of some cities of the world stored using longitude and latitude coordinates. Also, we use the to plot shortest geographic path between these locations using the [WorldUtility](geo-map-resources-world-util.md) diff --git a/docs/xplat/src/content/en/components/geo-map-display-imagery-types.mdx b/docs/xplat/src/content/en/components/geo-map-display-imagery-types.mdx index 0f7616b608..3659ec3d09 100644 --- a/docs/xplat/src/content/en/components/geo-map-display-imagery-types.mdx +++ b/docs/xplat/src/content/en/components/geo-map-display-imagery-types.mdx @@ -33,7 +33,7 @@ The following table summarizes imagery classes provided by the map component. ||Represents the base control for all imagery classes that display all types of supported geographic imagery tiles. This class can be extended for the purpose of implementing support for geographic imagery tiles from other geographic imagery sources such as Map Quest mapping service.| ||Represents the multi-scale imagery control for displaying geographic imagery tiles from the Open Street Maps service.| -{/* |`BingMapsMapImagery`|Represents the multi-scale imagery control for displaying geographic imagery tiles from the Bing Maps service.| */} +{/* ||Represents the multi-scale imagery control for displaying geographic imagery tiles from the Bing Maps service.| */} By default, the property is set to object and the map component displays geographic imagery tiles from the Open Street Maps service. In order to display different types of geographic imagery tiles, the map component must be re-configured. @@ -52,6 +52,6 @@ This code example explicitly sets +


diff --git a/docs/xplat/src/content/en/components/geo-map-type-scatter-bubble-series.mdx b/docs/xplat/src/content/en/components/geo-map-type-scatter-bubble-series.mdx index 2172a031cf..71c5315991 100644 --- a/docs/xplat/src/content/en/components/geo-map-type-scatter-bubble-series.mdx +++ b/docs/xplat/src/content/en/components/geo-map-type-scatter-bubble-series.mdx @@ -26,19 +26,19 @@ In {Platform} map component, you can use the series and how to specify data binding options of the series. Automatic marker selection is configured along with marker collision avoidance logic, and marker outline and fill colors are specified too. ## Configuration Summary -Similar to other types of scatter series in the map control, the series has the `ItemsSource` property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the `LongitudeMemberPath` and `LatitudeMemberPath` properties to map these data columns. The `RadiusScale` and `RadiusMemberPath` will settings configures the radius for the bubbles. +Similar to other types of scatter series in the map control, the series has the property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the and properties to map these data columns. The and will settings configures the radius for the bubbles. The following table summarizes the GeographicHighDensityScatterSeries series properties used for data binding. | Property|Type|Description | | ---|---|--- | -| `ItemsSource`|any|Gets or sets the items source | -| `LongitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | -| `LatitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | -| `RadiusMemberPath`|string|Sets the path to use to get the radius values for the series. | -| `RadiusScale`|`SizeScale`|Gets or sets the radius scale property for the current bubble series. | -| `MinimumValue`|any|Configure the minimum value for calculating value sub ranges. | -| `MaximumValue`|any|Configure the maximum value for calculating value sub ranges. | +| |any|Gets or sets the items source | +| |string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | +| |string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | +| |string|Sets the path to use to get the radius values for the series. | +| ||Gets or sets the radius scale property for the current bubble series. | +| |any|Configure the minimum value for calculating value sub ranges. | +| |any|Configure the maximum value for calculating value sub ranges. | ## Code Snippet @@ -341,4 +341,4 @@ addSeriesWith(locations: any[]) ## API References
-`RadiusScale`
+
diff --git a/docs/xplat/src/content/en/components/geo-map-type-scatter-contour-series.mdx b/docs/xplat/src/content/en/components/geo-map-type-scatter-contour-series.mdx index 7cdda26b7e..7a506b529b 100644 --- a/docs/xplat/src/content/en/components/geo-map-type-scatter-contour-series.mdx +++ b/docs/xplat/src/content/en/components/geo-map-type-scatter-contour-series.mdx @@ -26,33 +26,33 @@ In {Platform} map component, you can use the works a lot like the except that it represents data as contour lines, colored using a fill scale and the geographic scatter area series, represents data as a surface interpolated using a color scale. ## Data Requirements -Similar to other types of geographic series in the map component, the has the `ItemsSource` property which can be bound to an array of objects. In addition, each item in the items source must have three data columns, two that store geographic location (longitude and latitude coordinates) and one data column that stores a value associated with the geographic location. These data column, are identified by `LongitudeMemberPath`, `LatitudeMemberPath`, and `ValueMemberPath` properties of the geographic series. -The `GeographicContourLineSeries` automatically performs built-in data triangulation on items in the ItemsSource if no triangulation is set to the `TrianglesSource` property. However, computing triangulation can be a very time-consuming process, so the runtime performance will be better when specifying a `TriangulationSource` for this property, especially when a large number of data items are present. +Similar to other types of geographic series in the map component, the has the property which can be bound to an array of objects. In addition, each item in the items source must have three data columns, two that store geographic location (longitude and latitude coordinates) and one data column that stores a value associated with the geographic location. These data column, are identified by , , and properties of the geographic series. +The automatically performs built-in data triangulation on items in the ItemsSource if no triangulation is set to the property. However, computing triangulation can be a very time-consuming process, so the runtime performance will be better when specifying a `TriangulationSource` for this property, especially when a large number of data items are present. ## Data Binding -The following table summarizes properties of `GeographicContourLineSeries` used for data binding. +The following table summarizes properties of used for data binding. | Property Name | Property Type | Description | |--------------|---------------| ---------------| -|`ItemsSource`|any|The source of data items to perform triangulation on if the `TrianglesSource` property provides no triangulation data.| -|`LongitudeMemberPath`|string|The name of the property containing the Longitude for all items bound to the `ItemsSource`.| -|`LatitudeMemberPath`|string|The name of the property containing the Latitude for all items bound to to the `ItemsSource`.| -|`ValueMemberPath`|string|The name of the property containing a value at Latitude and Longitude coordinates of each data item. This numeric value will be be converted to a color when the `FillScale` property is set.| -|`TrianglesSource`|any|Gets or sets the source of triangulation data. Setting Triangles of the TriangulationSource object to this property improves both runtime performance and geographic series rendering.| -|`TriangleVertexMemberPath1`|string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| -|`TriangleVertexMemberPath2`|string| The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| -|`TriangleVertexMemberPath3`|string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| +||any|The source of data items to perform triangulation on if the property provides no triangulation data.| +||string|The name of the property containing the Longitude for all items bound to the .| +||string|The name of the property containing the Latitude for all items bound to to the .| +||string|The name of the property containing a value at Latitude and Longitude coordinates of each data item. This numeric value will be be converted to a color when the property is set.| +||any|Gets or sets the source of triangulation data. Setting Triangles of the TriangulationSource object to this property improves both runtime performance and geographic series rendering.| +||string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| +||string| The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| +||string|The name of the property of the TrianglesSource items which, for each triangle, contains the index of the first vertex point in the ItemsSource. It is not mandatory to set this property. It is taken by default unless custom triangulation logic is provided.| ## Contour Fill Scale -Use the `FillScale` property of the to resolve fill brushes of the contour lines of the geographic series. +Use the property of the to resolve fill brushes of the contour lines of the geographic series. The provided `ValueBrushScale class should satisfy most of your coloring needs, but the application for custom coloring logic can inherit the ValueBrushScale class. The following table list properties of the CustomPaletteColorScale affecting the surface coloring of the GeographicContourLineSeries. | Property Name | Property Type | Description | |--------------|---------------| ---------------| -|`Brushes`|BrushCollection|Gets or sets the collection of brushes for filling contours of the `GeographicContourLineSeries`| -|`MaximumValue`|double|The highest value to assign a brush in a fill scale.| -|`MinimumValue`|double|The lowest value to assign a brush in a fill scale.| +||BrushCollection|Gets or sets the collection of brushes for filling contours of the | +||double|The highest value to assign a brush in a fill scale.| +||double|The lowest value to assign a brush in a fill scale.| ## Code Snippet @@ -376,7 +376,7 @@ createContourSeries(data: any[]) ## API References -`FillScale`
+



diff --git a/docs/xplat/src/content/en/components/geo-map-type-scatter-density-series.mdx b/docs/xplat/src/content/en/components/geo-map-type-scatter-density-series.mdx index 48be9c23ae..3bbfcc1178 100644 --- a/docs/xplat/src/content/en/components/geo-map-type-scatter-density-series.mdx +++ b/docs/xplat/src/content/en/components/geo-map-type-scatter-density-series.mdx @@ -28,30 +28,30 @@ The demo above shows the series has the `ItemsSource` property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the `LongitudeMemberPath` and `LatitudeMemberPath` properties to map these data columns. +Similar to other types of scatter series in the map control, the series has the property which can be bound to an array of objects. In addition, each data item in the items source must have two data columns that store geographic longitude and latitude coordinates and uses the and properties to map these data columns. ### Data Binding The following table summarizes the GeographicHighDensityScatterSeries series properties used for data binding. | Property|Type|Description | | ---|---|--- | -| `ItemsSource`|any|Gets or sets the items source | -| `LongitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | -| `LatitudeMemberPath`|string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | +| |any|Gets or sets the items source | +| |string|Uses the ItemsSource property to determine the location of the longitude values on the assigned items | +| |string|Uses the ItemsSource property to determine the location of the latitude values on the assigned items | ## Heat Color Scale The Heat Color Scale, an optional feature, determines the color pattern within the series. The following table summarizes the properties used for determining the color scale. | Property |Type|Description | | ---|---|--- | -| `HeatMinimum`|Double|Defines the double value representing the minimum end of the color scale | -| `HeatMaximum`|Double|Defines the double value representing the maximum end of the color scale | -| `HeatMinimumColor`|Color|Defines the point density color used at the bottom end of the color scale | -| `HeatMaximumColor`|Color|Defines the point density color used at the top end of the color scale | +| |Double|Defines the double value representing the minimum end of the color scale | +| |Double|Defines the double value representing the maximum end of the color scale | +| |Color|Defines the point density color used at the bottom end of the color scale | +| |Color|Defines the point density color used at the top end of the color scale | ## Code Example -The following code demonstrates how set the `HeatMinimumColor` and `HeatMaximumColor` properties of the +The following code demonstrates how set the and properties of the diff --git a/docs/xplat/src/content/en/components/grid-lite/column-configuration.mdx b/docs/xplat/src/content/en/components/grid-lite/column-configuration.mdx index fc00704188..ad8100137a 100644 --- a/docs/xplat/src/content/en/components/grid-lite/column-configuration.mdx +++ b/docs/xplat/src/content/en/components/grid-lite/column-configuration.mdx @@ -64,7 +64,7 @@ return ( -Columns are defined declaratively using `` child elements within the grid. The `Field` property is the only required for a column, as it serves as the column identifier. It is also the property that is used to map and render the relevant data in the grid rows. +Columns are defined declaratively using `` child elements within the grid. The property is the only required for a column, as it serves as the column identifier. It is also the property that is used to map and render the relevant data in the grid rows. ```razor @@ -78,7 +78,7 @@ Columns are defined declaratively using `` child elements wit ## Configuration Based on the Data Source -The grid supports inferring the column configuration based on the provided data source when `AutoGenerate` is set to true. It tries to infer the appropriate `Field` and `DataType` properties based on records in the data. +The grid supports inferring the column configuration based on the provided data source when `AutoGenerate` is set to true. It tries to infer the appropriate and properties based on records in the data. ```razor @@ -240,7 +240,7 @@ return ( -To change the width of column, use the `Width` parameter of the `IgbGridLiteColumn` component. +To change the width of column, use the parameter of the `IgbGridLiteColumn` component. ```razor @@ -290,7 +290,7 @@ return ( -Columns can be hidden/shown by setting the `Hidden` parameter on the `IgbGridLiteColumn` component. +Columns can be hidden/shown by setting the parameter on the `IgbGridLiteColumn` component. ```razor ## ワークシートの編集を設定 -デフォルトで保存する オブジェクトが有効です。 オブジェクトの `Protect` メソッドを使用してワークシートを保護することにより、ワークシートの編集を禁止できます。このメソッドは、保護する部分を決定する null 許容型 `bool` 引数が多くあり、オプションの 1 つは編集オブジェクトを許容し、**false** に設定した場合はワークシートの編集を防止します。 +デフォルトで保存する オブジェクトが有効です。 オブジェクトの メソッドを使用してワークシートを保護することにより、ワークシートの編集を禁止できます。このメソッドは、保護する部分を決定する null 許容型 `bool` 引数が多くあり、オプションの 1 つは編集オブジェクトを許容し、**false** に設定した場合はワークシートの編集を防止します。 以下のコードは、ワークシートで編集を無効にする方法を示します。 @@ -139,9 +139,9 @@ worksheet.Protect(); - オブジェクトの `Protect` メソッドを使用して構造変更からワークシートを保護できます。 + オブジェクトの メソッドを使用して構造変更からワークシートを保護できます。 -保護が設定されると、Worksheet オブジェクトの保護をこれらのオブジェクトでオーバーライドするために、 オブジェクトの `Locked` プロパティを各セル、行、マージされたセル領域、または列で設定することができます。たとえば、1 つの列のセルを除き、ワークシートのすべてのセルを読み取り専用にする必要がある場合、特定の オブジェクトで プロパティの `Locked` を **false** に設定します。これにより、その列内のセルの編集をユーザーに許可し、ワークシートの他のセルの編集は禁止できます。 +保護が設定されると、Worksheet オブジェクトの保護をこれらのオブジェクトでオーバーライドするために、 オブジェクトの プロパティを各セル、行、マージされたセル領域、または列で設定することができます。たとえば、1 つの列のセルを除き、ワークシートのすべてのセルを読み取り専用にする必要がある場合、特定の オブジェクトで プロパティの を **false** に設定します。これにより、その列内のセルの編集をユーザーに許可し、ワークシートの他のセルの編集は禁止できます。 以下のコードはその方法を示します。 @@ -166,24 +166,24 @@ worksheet.Columns[0].CellFormat.Locked = ExcelDefaultableBoolean.False; ## ワークシート領域のフィルタリング -フィルタリングは、 オブジェクトの `filterSettings` プロパティから取得できるワークシートの でフィルター条件を設定できます。フィルター条件は、フィルター条件追加、削除、変更される時に、または `ReapplyFilters` メソッドがワークシートで呼び出されるときに限り再適用されます。フィルターは、領域内で常にデータを評価するわけではありません。 +フィルタリングは、 オブジェクトの `filterSettings` プロパティから取得できるワークシートの でフィルター条件を設定できます。フィルター条件は、フィルター条件追加、削除、変更される時に、または メソッドがワークシートで呼び出されるときに限り再適用されます。フィルターは、領域内で常にデータを評価するわけではありません。 - オブジェクトの `SetRegion` メソッドでフィルターを適用する領域を指定できます。 + オブジェクトの メソッドでフィルターを適用する領域を指定できます。 以下は、フィルターをワークシートに追加するためのメソッド一覧と概要です。 | メソッド | 説明 | | -------------|:-------------:| -|`ApplyAverageFilter`|データ範囲全体の平均を下回るデータであるか上回るデータであるかという条件に基づいてデータを絞り込むことのできるフィルターです。| -|`ApplyDatePeriodFilter`|月または四半期の日付をフィルターできるフィルターを表します。| -|`ApplyFillFilter`|背景の塗りつぶしに基づいてセルを絞り込むフィルターを表します。このフィルターには CellFill を 1 つ指定します。この塗りつぶしのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| +||データ範囲全体の平均を下回るデータであるか上回るデータであるかという条件に基づいてデータを絞り込むことのできるフィルターです。| +||月または四半期の日付をフィルターできるフィルターを表します。| +||背景の塗りつぶしに基づいてセルを絞り込むフィルターを表します。このフィルターには CellFill を 1 つ指定します。この塗りつぶしのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| |`ApplyFixedValuesFilter`|具体的な指定値に基づいて表示セルを絞り込むことのできるフィルターです。| -|`ApplyFontColorFilter`|フォントの色に基づいてセルを絞り込むフィルターを表します。このフィルターには 1 つの色を指定します。この色のフォントのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| -|`ApplyIconFilter`|条件付き書式アイコンに基づいてセルを絞り込むフィルターを表します。| -|`ApplyRelativeDateRangeFilter`|フィルターの適用日を基点とした相対日付によって日付セルの範囲を絞り込むことのできるフィルターです。| -|`ApplyTopOrBottomFilter`|ソートされた値リストの上位または下位にあるセルを表示できるフィルターです。| -|`ApplyYearToDateFilter`|日付セルの範囲を現在の年の開始日からフィルターの評価実施日までの期間に絞り込むことのできるフィルターです。| -|`ApplyCustomFilter`|1 つ、ないし 2 つのカスタム条件に基づいてデータを絞り込むことのできるフィルターです。この 2 つの絞り込み条件は論理積 (and) または論理和 (or) 演算子と組み合わせて使用できます。| +||フォントの色に基づいてセルを絞り込むフィルターを表します。このフィルターには 1 つの色を指定します。この色のフォントのセルがデータ範囲に表示されることになります。他のセルはすべて非表示になります。| +||条件付き書式アイコンに基づいてセルを絞り込むフィルターを表します。| +||フィルターの適用日を基点とした相対日付によって日付セルの範囲を絞り込むことのできるフィルターです。| +||ソートされた値リストの上位または下位にあるセルを表示できるフィルターです。| +||日付セルの範囲を現在の年の開始日からフィルターの評価実施日までの期間に絞り込むことのできるフィルターです。| +||1 つ、ないし 2 つのカスタム条件に基づいてデータを絞り込むことのできるフィルターです。この 2 つの絞り込み条件は論理積 (and) または論理和 (or) 演算子と組み合わせて使用できます。| 以下のコード スニペットを使用してフィルターをワークシート領域に追加します。 @@ -210,7 +210,7 @@ worksheet.FilterSettings.ApplyAverageFilter(0, Documents.Excel.Filtering.Average ## ペインの固定と分割 ペイン固定機能は、行をワークシートの上または列を左にで固定できます。ユーザーがスクロールしている間、固定した行や列は表示されたままになります。固定された行列は、削除できない実線によってワークシートの残りの部分と区切られます。 -ペイン固定を有効にするために オブジェクトの プロパティを **true** に設定する必要があります。表示オプション `FrozenPaneSettings` の `FrozenRows` と `FrozenColumns` プロパティを使用して固定する行列を指定できます。 +ペイン固定を有効にするために オブジェクトの プロパティを **true** に設定する必要があります。表示オプション の `FrozenRows` と `FrozenColumns` プロパティを使用して固定する行列を指定できます。 また `FirstRowInBottomPane` と `FirstColumnInRightPane` を個々に使用して下ペインの最初の行または右ペインの最初の列を指定できます。 @@ -275,7 +275,7 @@ worksheet.DisplayOptions.MagnificationInNormalView = 300; これには、シートの プロパティを使用して取得できる オブジェクトの に領域とソートタイプを指定します。 -シートのソート条件は、ソート条件が追加、削除、変更される時に、または `ReapplySortConditions` メソッドがワークシートで呼び出されるときに限り再適用されます。列または行を領域でソートします。'Rows' はデフォルトのソートタイプです。 +シートのソート条件は、ソート条件が追加、削除、変更される時に、または メソッドがワークシートで呼び出されるときに限り再適用されます。列または行を領域でソートします。'Rows' はデフォルトのソートタイプです。 以下のコード スニペットは、ワークシートのセル領域を適用する方法を示します。 @@ -298,7 +298,7 @@ worksheet.SortSettings.SortConditions.Add(new RelativeIndex(0), new Infragistics
## ワークシートの保護 - オブジェクトで `Protect` メソッドを呼び出してワークシートを保護できます。このメソッドは、以下のユーザー操作を制限または許容する null 許容型 `bool` パラメーターを公開します。 + オブジェクトで メソッドを呼び出してワークシートを保護できます。このメソッドは、以下のユーザー操作を制限または許容する null 許容型 `bool` パラメーターを公開します。 - セルの編集 - 図形、コメント、チャートなどのオブジェクトやコントロールを編集します。 @@ -311,7 +311,7 @@ worksheet.SortSettings.SortConditions.Add(new RelativeIndex(0), new Infragistics - データのソート。 - ピボット テーブルの使用 - オブジェクトで `Unprotect` メソッドを呼び出してワークシートの保護を削除できます。 + オブジェクトで メソッドを呼び出してワークシートの保護を削除できます。 以下のコード スニペットは、上記にリストされたすべてのユーザー操作を保護を有効にします。 @@ -335,11 +335,11 @@ worksheet.Protect(); ## ワークシートの条件付き書式設定 - の条件付き書式を設定するには、ワークシートの `ConditionalFormats` コレクションで公開される多数の Add メソッドを使用できます。この Add メソッドの最初のパラメーターは条件付き書式に適用する Worksheet の `string` 領域です。 + の条件付き書式を設定するには、ワークシートの コレクションで公開される多数の Add メソッドを使用できます。この Add メソッドの最初のパラメーターは条件付き書式に適用する Worksheet の `string` 領域です。 -Worksheet に追加可能な条件付き書式にその条件が true の場合に 要素の外観を決定する プロパティがあります。たとえば、`Fill` や `Font` などのこの プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 +Worksheet に追加可能な条件付き書式にその条件が true の場合に 要素の外観を決定する プロパティがあります。たとえば、 などのこの プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 -ワークシート セルの可視化の動作が異なるため、 プロパティがない条件付き書式もあります。この条件付き書式は 、`IconSetConditionalFormat` です。 +ワークシート セルの可視化の動作が異なるため、 プロパティがない条件付き書式もあります。この条件付き書式は です。 既存の を Excel から読み込む際に、その が読み込まれた場合も書式設定は保持されます。 を Excel ファイルに保存する場合も保持されます。 diff --git a/docs/xplat/src/content/jp/components/excel-library.mdx b/docs/xplat/src/content/jp/components/excel-library.mdx index b1a3a0eea9..a2b00caefc 100644 --- a/docs/xplat/src/content/jp/components/excel-library.mdx +++ b/docs/xplat/src/content/jp/components/excel-library.mdx @@ -158,11 +158,11 @@ Excel ライブラリ は Excel Binary Workbook (.xlsb) フォーマットを現 -次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して `Workbook` を保存およびロードしています。 +次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して を保存およびロードしています。 -`Workbook` オブジェクトを読み込んで保存するために、実際の `Workbook` の保存メソッドや static な `Load` メソッドを使用できます。 + オブジェクトを読み込んで保存するために、実際の の保存メソッドや static な `Load` メソッドを使用できます。 ```ts diff --git a/docs/xplat/src/content/jp/components/general-changelog-dv-blazor.mdx b/docs/xplat/src/content/jp/components/general-changelog-dv-blazor.mdx index 1cd6b377a6..06372fb1ab 100644 --- a/docs/xplat/src/content/jp/components/general-changelog-dv-blazor.mdx +++ b/docs/xplat/src/content/jp/components/general-changelog-dv-blazor.mdx @@ -19,6 +19,8 @@ import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} 変更ログ @@ -158,7 +160,7 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と - New dot type, improved outline implementation following WCAG AA accessibility standards and theme based sizing. [#1889](https://github.com/IgniteUI/igniteui-webcomponents/pull/1889) #### ユーザー注釈 -{ProductName} では、ユーザー注釈機能により、実行時に `DataChart` にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 +{ProductName} では、ユーザー注釈機能により、実行時に にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 #### 軸注釈の衝突検出 軸注釈が自動で衝突を検出し、適切に収まるよう切り詰めます。この機能を有効にするには、次のプロパティを設定します: #### {PackageMaps} (地理マップ) @@ -184,14 +186,14 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と ### 変更 - すべてのテーマにわたってフォームに関連付けられたほとんどのコンポーネントの読み取り専用スタイルを更新し、コンポーネントが読み取り専用状態にあることをより適切に示せるようになりました。 -- `Tooltip` - - 動作変更: `Tooltip` のデフォルトの placement は 「bottom」 になりました。 - - 動作変更: with-arrow が設定されていない限り、`Tooltip` はデフォルトでは矢印インジケーターをレンダリングしません。 - - 重大な変更: `Tooltip` イベントは、detail プロパティに anchor ターゲットを返さなくなりました。引き続き event.target.anchor でアクセスできます。 +- + - 動作変更: のデフォルトの placement は 「bottom」 になりました。 + - 動作変更: with-arrow が設定されていない限り、 はデフォルトでは矢印インジケーターをレンダリングしません。 + - 重大な変更: イベントは、detail プロパティに anchor ターゲットを返さなくなりました。引き続き event.target.anchor でアクセスできます。 ### 非推奨 -- `Tooltip` - `DisableArrow` は非推奨です。矢印インジケーターをレンダリングするには、`WithArrow` を使用してください。 +- - は非推奨です。矢印インジケーターをレンダリングするには、 を使用してください。 ### バグ修正 @@ -205,21 +207,21 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と **重大な変更** -- `AzureMapsMapImagery` は `AzureMapsImagery` に名前が変更されました。 -- `AzureMapsImagery` は `AzureMapsImageryStyle.Satellite` に名前が変更されました。 -- 次の `AzureMapsImageryStyle` 列挙値は、Overlay サフィックスを含むように名前が変更されました。 - - `TerraOverlay` - - `LabelsRoadOverlay` - - `LabelsDarkGreyOverlay` - - `HybridRoadOverlay` - - `HybridDarkGreyOverlay` - - `WeatherRadarOverlay` - - `WeatherInfraredOverlay` - - `TrafficAbsoluteOverlay` - - `TrafficRelativeOverlay` - - `TrafficRelativeDarkOverlay` - - `TrafficDelayOverlay` - - `TrafficReducedOverlay` +- `AzureMapsMapImagery` は に名前が変更されました。 +- は `AzureMapsImageryStyle.Satellite` に名前が変更されました。 +- 次の 列挙値は、Overlay サフィックスを含むように名前が変更されました。 + - + - + - + - + - + - + - + - + - + - + - + - ### {PackageCharts} (チャート) @@ -238,20 +240,20 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と #### 対応軸 -X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。`CompanionAxisEnabled` プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 +X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。 プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### RadialPieSeries インセット アウトライン -`RadialPieSeries` のアウトライン レンダリング方法を制御するために `UseInsetOutlines` プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 + のアウトライン レンダリング方法を制御するために プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 ### {PackageGrids} (グリッド) #### セル サフィックス コンテンツ -セル内のサフィックス コンテンツのサポートが追加されました。これにより、セル値の末尾にテキストやアイコンを追加してスタイルを設定できるようになりました。セル サフィックス コンテンツに追加されたプロパティの完全なリストは以下に示されており、`DataGridColumn` および `CellInfo` クラスで使用できます。 +セル内のサフィックス コンテンツのサポートが追加されました。これにより、セル値の末尾にテキストやアイコンを追加してスタイルを設定できるようになりました。セル サフィックス コンテンツに追加されたプロパティの完全なリストは以下に示されており、 および クラスで使用できます。 @@ -261,18 +263,18 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 -- `SuffixText` -- `SuffixTextColor` +- +- - `SuffixTextFont` -- `SuffixIconName` -- `SuffixIconCollectionName` -- `SuffixIconStroke` -- `SuffixIconFill` -- `SuffixIconViewBoxLeft` -- `SuffixIconViewBoxTop` -- `SuffixIconViewBoxWidth` -- `SuffixIconViewBoxHeight` -- `TextDecoration` +- +- +- +- +- +- +- +- +- ```razor @@ -312,16 +314,16 @@ col.Pinned = true; - Optimized grouping operations. - **Other Improvements** - - A column's `MinWidth` and `MaxWidth` constrain the user-specified width so that it cannot go outside their bounds. + - A column's and `MaxWidth` constrain the user-specified width so that it cannot go outside their bounds. - The `PagingMode` property can now be set as simple strings "local" and "remote" and does not require importing the `GridPagingMode` enum. ### バグ修正 #### 機能拡張 -- `DateRangePicker` +- #### IgbBulletGraph -- 新しい `LabelsVisible` プロパティが追加されました。 +- 新しい プロパティが追加されました。 #### チャート - DataToolTipLayer、ItemToolTipLayer、CategoryToolTipLayer にスタイル設定用の新しいプロパティが追加されました: `ToolTipBackground`、`ToolTipBorderBrush`、および `ToolTipBorderThickness`。 @@ -336,21 +338,21 @@ col.Pinned = true; **Breaking Changes** -- `AzureMapsMapImagery` was renamed to `AzureMapsImagery` +- `AzureMapsMapImagery` was renamed to - `AzureMapsImageryStyle.Imagery` was renamed to `AzureMapsImageryStyle.Satellite` -- The following `AzureMapsImageryStyle` enum values were renamed to include the Overlay suffix: - - `TerraOverlay`, - - `LabelsRoadOverlay` - - `LabelsDarkGreyOverlay` - - `HybridRoadOverlay` - - `HybridDarkGreyOverlay` - - `WeatherRadarOverlay` - - `WeatherInfraredOverlay` - - `TrafficAbsoluteOverlay` - - `TrafficRelativeOverlay` - - `TrafficRelativeDarkOverlay` - - `TrafficDelayOverlay` - - `TrafficReducedOverlay` +- The following enum values were renamed to include the Overlay suffix: + - , + - + - + - + - + - + - + - + - + - + - + - ### {PackageMaps} 地理マップ @@ -374,20 +376,20 @@ col.Pinned = true; #### 一般 以下のコンポーネントのプロパティが null 許容になりました。 -- `Button`: `Form` -- `Calendar`: `SpecialDates`、`DisabledDates` -- `Combo`: `ValueKey`、`DisplayKey`、`GroupKey` -- `DatePicker`: `Value`、`Min`、`Max` -- `DateTimePicker`: `Value`、`Min`、`Max` -- `Dropdown`: `SelectedItem` -- `Input`: `Pattern`、`MinLength`、`MaxLength`、`Min`、`Max`、`Step` -- `Select`: `Value`、`SelectedItem` -- `Tile`: `ColStart`、`RowStart` -- `TileManager`: `MinColumnWidth`、`MinRowHeight`、`Gap` +- : +- : +- : +- : +- `DateTimePicker`: +- : +- : +- : +- : +- : **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### **{PackageVerChanges-25-1-JULY}** @@ -399,18 +401,18 @@ col.Pinned = true; |37718 | `IgbTab` | タブ パネル内のグリッドに新しい行を追加した際に、予期しないスクロールが発生する。| |37855 | `IgbGrid` | グリッドに HeaderTemplate が含まれており、ページが安全でない (http) プロトコルを使用してアクセスされた場合、Crypto.randomUID が見つからないというエラーがスローされる。| -- `SuffixText` -- `SuffixTextColor` +- +- - `SuffixTextFont` -- `SuffixIconName` -- `SuffixIconCollectionName` -- `SuffixIconStroke` -- `SuffixIconFill` -- `SuffixIconViewBoxLeft` -- `SuffixIconViewBoxTop` -- `SuffixIconViewBoxWidth` -- `SuffixIconViewBoxHeight` -- `TextDecoration` +- +- +- +- +- +- +- +- +- Please note that the maximum size available for the icons is 24x24. You can provide an icon that is larger or smaller than this, but you will need to configure the viewbox settings in order to properly scale it to fit in the 24x24 space so it is fully visible. @@ -436,31 +438,31 @@ Please note that the maximum size available for the icons is 24x24. You can prov - データ注釈スライス レイヤー - データ注釈ストリップ レイヤー -- [データ ツールチップ](charts/features/chart-data-tooltip.md)と[データ 凡例](charts/features/chart-data-legend.md)では、ツールチップまたは凡例のコンテンツをテーブルまたは垂直レイアウト構造でレイアウトするために使用できる `LayoutMode` プロパティが公開されています。 +- [データ ツールチップ](charts/features/chart-data-tooltip.md)と[データ 凡例](charts/features/chart-data-legend.md)では、ツールチップまたは凡例のコンテンツをテーブルまたは垂直レイアウト構造でレイアウトするために使用できる プロパティが公開されています。 -- チャートの `DefaultInteraction` プロパティが更新され、新しい列挙体 `DragSelect` が含まれるようになりました。これにより、ドラッグされたプレビュー Rect は、その中に含まれるポイントを選択します。 (ベータ版) +- チャートの プロパティが更新され、新しい列挙体 `DragSelect` が含まれるようになりました。これにより、ドラッグされたプレビュー Rect は、その中に含まれるポイントを選択します。 (ベータ版) -- [ValueOverlay と ValueLayer](charts/features/chart-overlays.md) は、上記にリストした [チャート データ注釈](charts/features/chart-data-annotations.md)に加えて、プロット領域に追加の注釈テキストをオーバーレイするために使用できる `OverlayText` プロパティを公開するようになりました。これらの注釈の外観は、OverlayText プレフィックスが付いた多くのプロパティを使用して構成できます。たとえば、`OverlayTextBrush` プロパティはオーバーレイ テキストの色を構成します。 (ベータ版) +- [ValueOverlay と ValueLayer](charts/features/chart-overlays.md) は、上記にリストした [チャート データ注釈](charts/features/chart-data-annotations.md)に加えて、プロット領域に追加の注釈テキストをオーバーレイするために使用できる プロパティを公開するようになりました。これらの注釈の外観は、OverlayText プレフィックスが付いた多くのプロパティを使用して構成できます。たとえば、`OverlayTextBrush` プロパティはオーバーレイ テキストの色を構成します。 (ベータ版) #### 一般 -- `Tooltip` は、特定の要素のツールチップを表示する方法を提供します。使用するには、必要に応じてコンテンツを設定し、`Anchor` プロパティを介してターゲット要素の ID にリンクします。 +- は、特定の要素のツールチップを表示する方法を提供します。使用するには、必要に応じてコンテンツを設定し、 プロパティを介してターゲット要素の ID にリンクします。 #### 変更内容 - いくつかの列挙は名前が変更され、他の列挙と統合されました。名前の変更 (影響を受けるコンポーネントを含む): - - `BaseAlertLikePosition` (`Snackbar` と `Toast`) は `AbsolutePosition` に名前が変更されました。 - - `ButtonGroupAlignment` (`ButtonGroup`)、`CalendarOrientation` (`Calendar`)、`CardActionsOrientation` (`CardActions`)、`DatePickerOrientation` (`DatePicker`)、`RadioGroupAlignment` (`RadioGroup`) が統合され、`ContentOrientation` に名前が変更されました。 - - `CalendarBaseSelection` (`Calendar`) は `CalendarSelection` に名前が変更されました。 - - `CarouselAnimationType` (`Carousel`) と `StepperHorizontalAnimation` (`Stepper`) が統合され、`HorizontalTransitionAnimation` に名前が変更されました。 - - `CheckboxBaseLabelPosition` (`Checkbox` と `Switch`) と `RadioLabelPosition` (`Radio`) が統合され、`ToggleLabelPosition` に名前が変更されました。 - - `DatePickerMode` (`DatePicker`) は `PickerMode` に名前が変更されました。 - - `DatePickerHeaderOrientation` (`DatePicker`) は `CalendarHeaderOrientation` に名前変更/統合されました。 - - `DropdownPlacement` (`Dropdown` と `Select`) は `PopoverPlacement` に名前が変更されました。 - - `DropdownScrollStrategy` (`Dropdown`) と `SelectScrollStrategy` (`Select`) が統合され、`PopoverScrollStrategy` に名前が変更されました。 - - `SliderBaseTickOrientation` (`Slider` および `RangeSlider`) の名前が `SliderTickOrientation` に変更されました。 - - `TickLabelRotation` (`Slider` と `RangeSlider`) の名前が `SliderTickLabelRotation` に変更されました。 -- `Tabs` + - `BaseAlertLikePosition` () は `AbsolutePosition` に名前が変更されました。 + - `ButtonGroupAlignment` ()、`CalendarOrientation` ()、`CardActionsOrientation` ()、`DatePickerOrientation` ()、`RadioGroupAlignment` () が統合され、`ContentOrientation` に名前が変更されました。 + - `CalendarBaseSelection` () は `CalendarSelection` に名前が変更されました。 + - `CarouselAnimationType` () と `StepperHorizontalAnimation` () が統合され、`HorizontalTransitionAnimation` に名前が変更されました。 + - `CheckboxBaseLabelPosition` () と `RadioLabelPosition` () が統合され、`ToggleLabelPosition` に名前が変更されました。 + - `DatePickerMode` () は `PickerMode` に名前が変更されました。 + - `DatePickerHeaderOrientation` () は `CalendarHeaderOrientation` に名前変更/統合されました。 + - `DropdownPlacement` () は `PopoverPlacement` に名前が変更されました。 + - `DropdownScrollStrategy` () と `SelectScrollStrategy` () が統合され、`PopoverScrollStrategy` に名前が変更されました。 + - `SliderBaseTickOrientation` ( および ) の名前が `SliderTickOrientation` に変更されました。 + - () の名前が `SliderTickLabelRotation` に変更されました。 +- ## {PackageGrids} (グリッド) @@ -519,16 +521,16 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft - Data Annotation Slice Layer - Data Annotation Strip Layer -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. -- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. +- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. - [Trendline Layer](charts/features/chart-trendlines.md) series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple [TrendlineLayer](charts/features/chart-overlays.md) series types in the chart. ### List -- `ListItem` に新しいプロパティ `Selected` を追加しました。 +- に新しいプロパティ を追加しました。 @@ -541,13 +543,13 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft - The tooltip can be further customized with `Show/HideDelay`, `Placement` around the target and customizable `Show/HideTriggers` events. + The tooltip can be further customized with `Show/HideDelay`, around the target and customizable `Show/HideTriggers` events. ### Accordion -- 新しいイベント `Open` および `Close` を追加しました。 +- 新しいイベント および `Close` を追加しました。 - Simplified configuration by removing the need to define separate panel and linking the panel and tab header. The `Panel` property and the `IgbTabPanel` itself have been removed. Content can be now assigned directly to the `Tab` and header text can be set conveniently via the new `Label` property or by projecting an element to `slot="label"` for more involved customization. + Simplified configuration by removing the need to define separate panel and linking the panel and tab header. The `Panel` property and the `IgbTabPanel` itself have been removed. Content can be now assigned directly to the and header text can be set conveniently via the new property or by projecting an element to `slot="label"` for more involved customization. Before: @@ -592,21 +594,21 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ``` -- `Input` - - `Min` & `Max` are now `double` instead of `string` -- `Stepper` - - `ActiveStepChangingArgsEventArgs` has been renamed to `ActiveStepChangingEventArgs` - - `ActiveStepChangedArgsEventArgs` has been renamed to `ActiveStepChangedEventArgs` +- + - & are now `double` instead of `string` +- + - `ActiveStepChangingArgsEventArgs` has been renamed to + - `ActiveStepChangedArgsEventArgs` has been renamed to - `StepperTitlePosition` now defaults to `Auto` to correctly reflect the default behavior -- `Tree` - - `TreeSelectionChangeEventArgs` has been renamed to `TreeSelectionEventArgs` -- `Textarea` - - `Autocapitalize` & `InputMode` are now `string` properties instead of explicit enums +- + - `TreeSelectionChangeEventArgs` has been renamed to +- + - & are now `string` properties instead of explicit enums ### {PackageGrids} - **すべてのグリッド** - - `FilteringExpressionsTree` プロパティを使用して初期フィルタリングの適用が可能になりました。 + - プロパティを使用して初期フィルタリングの適用が可能になりました。 ### バグ修正 @@ -642,9 +644,9 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ### Toolbar -- `Toolbar` と `ToolPanel` に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての `ToolActionGroupHeader` アクションに適用されます。 -- タイトル テキストの水平方向の配置を制御する `TitleHorizontalAlignment` という新しいプロパティを `ToolAction` に追加しました。 -- `ToolActionSubPanel` に、パネル内の項目間の間隔を制御する `ItemSpacing` という新しいプロパティを追加しました。 +- に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての アクションに適用されます。 +- タイトル テキストの水平方向の配置を制御する という新しいプロパティを に追加しました。 +- に、パネル内の項目間の間隔を制御する という新しいプロパティを追加しました。 ## バグ修正 @@ -655,7 +657,7 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ### {PackageGrids} #### **{PackageVerChanges-24-2-DEC}** -- Added new property on `ListItem` called `Selected` +- Added new property on called #### {PackageCharts} (チャート) - [Dashboard Tile](dashboard-tile.md) コンポーネントは、バインドされた ItemsSource コレクションまたは単一のポイントを分析および視覚化し、データのスキーマとカウントに基づいて適切なデータ視覚化を返すコンテナー コントロールです。このコントロールは、組み込みの [Toolbar](menus/toolbar.md) コンポーネントを利用して、実行時に視覚化を変更できるようにし、最小限のコードでデータのさまざまな視覚化を表示できるようにします。 @@ -684,7 +686,7 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ### {PackageCharts} (チャート) -- 新しい[データ円チャート](charts/types/data-pie-chart.md) - `DataPieChart` は円ャートを表示する新しいコンポーネントです。このコンポーネントは、`CategoryChart` と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、強調表示、アニメーション、凡例のサポートを可能にします。 +- 新しい[データ円チャート](charts/types/data-pie-chart.md) - は円ャートを表示する新しいコンポーネントです。このコンポーネントは、 と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、強調表示、アニメーション、凡例のサポートを可能にします。 ## 一般 @@ -692,15 +694,15 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft #### **{PackageVerChanges-24-1-JUN}** -- Added new `GroupHeaderTextStyle` property to `Toolbar` and `ToolPanel`. If set, it will apply to all `ToolActionGroupHeader` actions. -- Added new property on `ToolAction` called `TitleHorizontalAlignment` which controls the horizontal alignment of the title text. -- Added new property on `ToolActionSubPanel` called `ItemSpacing` which controls the spacing between items inside the panel. +- Added new `GroupHeaderTextStyle` property to and . If set, it will apply to all actions. +- Added new property on called which controls the horizontal alignment of the title text. +- Added new property on called which controls the spacing between items inside the panel. ### 一般 -- `Input`、`Textarea` - ユーザー入力を制限することなく検証ルールを適用できるように `ValidateOnly` を公開しました。 -- `Dropdown` - `PositionStrategy` プロパティは非推奨です。ドロップダウンは、ブラウザー ビューポートの最上位レイヤーにコンテナーをレンダリングするために `Popover` API を使用するようになったため、このプロパティは廃止されました。 -- `DockManager` - `SplitPane` の `IsMaximized` は非推奨です。分割ペイン レベルで isMaximized を true に設定しても、分割ペインはコンテナーとしてのみ機能し、最大化されて表示される実際のコンテンツがないため、実際の効果はありません。代わりに、`TabGroupPane` および/または `ContentPane` の `IsMaximized` プロパティを使用してください。 +- - ユーザー入力を制限することなく検証ルールを適用できるように を公開しました。 +- - プロパティは非推奨です。ドロップダウンは、ブラウザー ビューポートの最上位レイヤーにコンテナーをレンダリングするために `Popover` API を使用するようになったため、このプロパティは廃止されました。 +- - は非推奨です。分割ペイン レベルで isMaximized を true に設定しても、分割ペインはコンテナーとしてのみ機能し、最大化されて表示される実際のコンテンツがないため、実際の効果はありません。代わりに、 および/または プロパティを使用してください。 | Bug Number | Control | Description | |------------|---------|------------------| @@ -730,7 +732,7 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ### {PackageCharts} (チャート) -- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。`GroupRowVisible` プロパティは、各シリーズのグループ化を切り替え、オプトインすると `DataLegendGroup` プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 +- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。 プロパティは、各シリーズのグループ化を切り替え、オプトインすると プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 ## {PackageGauges} (ゲージ) @@ -740,53 +742,53 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ### {PackageCharts} (チャート) -`InitialFilter` プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 + プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 -- `BulletGraph` - - `HighlightValueDisplayMode` が 'Overlay' 設定に適用されたとき、パフォーマンス バーには値と新しい `HighlightValue` の差が反映されるようになりました。ハイライト値には、フィルタリング/サブセットの測定パーセンテージが塗りつぶされた色で表示され、残りのバーの外観は割り当てられた値に対して薄く表示され、リアルタイムでパフォーマンスを示します。 -- `LinearGauge` - - 新しいハイライト針が追加されました。`HighlightValue` と `HighlightValueDisplayMode` の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 -- `RadialGauge` - - 新しいハイライト針が追加されました。`HighlightValue` と `HighlightValueDisplayMode` の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 +- + - が 'Overlay' 設定に適用されたとき、パフォーマンス バーには値と新しい の差が反映されるようになりました。ハイライト値には、フィルタリング/サブセットの測定パーセンテージが塗りつぶされた色で表示され、残りのバーの外観は割り当てられた値に対して薄く表示され、リアルタイムでパフォーマンスを示します。 +- + - 新しいハイライト針が追加されました。 の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 +- + - 新しいハイライト針が追加されました。 の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 - With the release of version 2024.2 and per the [Microsoft .NET lifecycle](https://dotnet.microsoft.com/en-us/platform/support/policy/dotnet-core), we no longer support .NET 3.1, .NET 5, or .NET 7. ## **{PackageVerChanges-23-2-APR}** ### **{PackageVerChanges-23-2-MAR}** - New [Carousel](layouts/carousel.md) component. -- `Input` - - Changed `change` event argument type from `ComponentDataValueChangedEventArgs` to `ComponentValueChangedEventArgs` +- + - Changed `change` event argument type from to ## 新しいコンポーネント ### 新機能 -- `DockManager` - - 新しい `ProximityDock` プロパティ。有効にすると、ドッキング インジケーターは表示されなくなり、エンド ユーザーは、ドラッグしたペインをターゲット ペインの端に近づけてドラッグすることでドッキングできます。 - - 新しい `ContainedInBoundaries` プロパティ。フローティング ペインを Dock Manager の境界内に保持するかどうかを決定します。デフォルトは **false** です。 - - 新しい `ShowPaneHeaders` プロパティ。ペインのヘッダーをホバー時にのみ表示するか、常に表示するかを決定します。デフォルトは `always` です。 -- `Tree` +- + - 新しい プロパティ。有効にすると、ドッキング インジケーターは表示されなくなり、エンド ユーザーは、ドラッグしたペインをターゲット ペインの端に近づけてドラッグすることでドッキングできます。 + - 新しい プロパティ。フローティング ペインを Dock Manager の境界内に保持するかどうかを決定します。デフォルトは **false** です。 + - 新しい プロパティ。ペインのヘッダーをホバー時にのみ表示するか、常に表示するかを決定します。デフォルトは `always` です。 +- - ノードをクリックすると展開状態が変更されるかどうかを決定する `toggleNodeOnClick` プロパティが追加されました。デフォルトは **false** です。 -- `Rating` +- - `allowReset` が追加されました。有効にすると、同じ値を選択するとコンポーネントがリセットされます。**動作の変更** - 以前のリリースでは、これが Rating コンポーネントのデフォルトの動作でした。アプリケーションでこの動作を維持する必要がある場合は、必ず `allowReset` を設定してください。 -- `Select`、`Dropdown` +- - `selectedItem`、`items`、および `groups` ゲッターが公開されました。 -- `RadialGauge` - - 新しいタイトル/サブタイトルのプロパティ。`TitleText`、`SubtitleText` はゲージの下部近くに表示されます。さらに、`TitleFontSize`、`TitleFontFamily`、`TitleFontStyle`、`TitleFontWeight`、`TitleExtent` など、さまざまなタイトルとサブタイトルのフォント プロパティが追加されました。最後に、新しい `TitleDisplaysValue` により、値を針の位置に対応させることができます。 - - `RadialGauge` の新しい `OpticalScalingEnabled` プロパティと `OpticalScalingSize` プロパティ。この新機能は、ゲージのラベル、タイトル、サブタイトルが 100% のオプティカル スケーリングを持つサイズを管理します。この新機能の詳細については、[こちら](radial-gauge.md#オプティカル-スケーリング)を参照してください。 - - 新しいハイライト針が追加されました。`HighlightValue` と `HighlightValueDisplayMode` の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 +- + - 新しいタイトル/サブタイトルのプロパティ。 はゲージの下部近くに表示されます。さらに、`TitleFontSize`、`TitleFontFamily`、`TitleFontStyle`、`TitleFontWeight`、 など、さまざまなタイトルとサブタイトルのフォント プロパティが追加されました。最後に、新しい により、値を針の位置に対応させることができます。 + - の新しい プロパティと プロパティ。この新機能は、ゲージのラベル、タイトル、サブタイトルが 100% のオプティカル スケーリングを持つサイズを管理します。この新機能の詳細については、[こちら](radial-gauge.md#オプティカル-スケーリング)を参照してください。 + - 新しいハイライト針が追加されました。 の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 - `RadialChart` - 新しいラベル モード - - 新しいタイトル/サブタイトルのプロパティ。`TitleText`、`SubtitleText` はゲージの下部近くに表示されます。さらに、`TitleFontSize`、`TitleFontFamily`、`TitleFontStyle`、`TitleFontWeight`、`TitleExtent` など、さまざまなタイトルとサブタイトルのフォント プロパティが追加されました。最後に、新しい `TitleDisplaysValue` により、値を針の位置に対応させることができます。 - - `RadialGauge` の新しい `OpticalScalingEnabled` プロパティと `OpticalScalingSize` プロパティ。この新機能は、ゲージのラベル、タイトル、サブタイトルが 100% のオプティカル スケーリングを持つサイズを管理します。この新機能の詳細については、[このトピック](radial-gauge.md#オプティカル-スケーリング)を参照してください。 - - 新しいハイライト針が追加されました。`HighlightValue` と `HighlightValueDisplayMode` の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 + - 新しいタイトル/サブタイトルのプロパティ。 はゲージの下部近くに表示されます。さらに、`TitleFontSize`、`TitleFontFamily`、`TitleFontStyle`、`TitleFontWeight`、 など、さまざまなタイトルとサブタイトルのフォント プロパティが追加されました。最後に、新しい により、値を針の位置に対応させることができます。 + - の新しい プロパティと プロパティ。この新機能は、ゲージのラベル、タイトル、サブタイトルが 100% のオプティカル スケーリングを持つサイズを管理します。この新機能の詳細については、[このトピック](radial-gauge.md#オプティカル-スケーリング)を参照してください。 + - 新しいハイライト針が追加されました。 の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 - `RadialChart` - 新しいラベル モード - `CategoryAngleAxis` は、ラベルの位置をさらに構成できる `LabelMode` プロパティを公開するようになりました。これにより、`Center` 列挙型を選択してデフォルト モードを切り替えることも、ラベルを円形のプロット領域に近づける新しいモード `ClosestPoint` を使用することもできます。 + は、ラベルの位置をさらに構成できる プロパティを公開するようになりました。これにより、`Center` 列挙型を選択してデフォルト モードを切り替えることも、ラベルを円形のプロット領域に近づける新しいモード `ClosestPoint` を使用することもできます。 -- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. +- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -801,43 +803,43 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ### 一般 -- `Input`、`MaskInput`、`DateTimeInput`、`Rating` - - `Readonly` は `ReadOnly` に名前が変更されました。 -- `Input` - - `Maxlength` は `MaxLength` に名前が変更されました。 - - `Minlength` は `MinLength` に名前が変更されました。 +- + - `Readonly` は に名前が変更されました。 +- + - `Maxlength` は に名前が変更されました。 + - `Minlength` は に名前が変更されました。 **Breaking Changes** - Renamed old **IgbDatePicker** to **IgbXDatePicker**. -- Removed `Form` component. Use native form instead. +- Removed component. Use native form instead. - Removed `size` property in favor of the `--ig-size` CSS custom property for the following components: - - `Avatar`, `Button`,`IconButton`, `Calendar`, `Chip`, `Dropdown`, `Icon`, `Input`, `List`, `Rating`, `Snackbar`, `Tabs`, `Tree` -- `Badge`, `Chip`, `LinearProgress`, `CircularProgress` - - Renamed `Variant` property type to `StyleVariant`. -- `Calendar` - - Renamed `WeekStart` property type to `WeekDays`. -- `Checkbox`, `Switch` - - Changed `Change` event argument type from `ComponentBoolValueChangedEventArgs` to `CheckboxChangeEventArgs`. -- `Combo` - - The `IgbCombo` is now of generic type and the `Value` type is now of type `T[]`. This means that either you need to specify `T` or it will be inferred by the assigned `Value` type. - - Removed `PositionStrategy`, `Flip`, `SameWidth` properties. + - , ,, , , , , , , , , , +- , , , + - Renamed property type to `StyleVariant`. +- + - Renamed property type to `WeekDays`. +- , + - Changed `Change` event argument type from to . +- + - The `IgbCombo` is now of generic type and the type is now of type `T[]`. This means that either you need to specify `T` or it will be inferred by the assigned type. + - Removed , , properties. - **IgbSelectComponent** - - Removed `PositionStrategy`, `Flip`, `SameWidth` properties. -- `DateTimeInput` - - Removed `MaxValue` and `MinValue` properties. Use `Max` and `Min` instead. -- `Dropdown` - - Removed `PositionStrategy` property. -- `Input` - - Removed old named `Maxlength` and `Minlength` properties. Use `MaxLength` and `MinLength`. - - Removed old named `Readonly` and `Inputmode` properties. Use `ReadOnly` and `InputMode`. - - Changed `InputMode` type also to `string`. -- `Radio` - - Changed `Change` event argument type from `ComponentBoolValueChangedEventArgs` to `RadioChangeEventArgs`. -- `RangeSlider` - - Removed `AriaThumbLower` and `AriaThumbUpper` properties. Use `ThumbLabelLower` and `ThumbLabelUpper` instead. -- `Rating` - - Renamed `Readonly` property to `ReadOnly`. + - Removed , , properties. +- + - Removed `MaxValue` and `MinValue` properties. Use and instead. +- + - Removed property. +- + - Removed old named `Maxlength` and `Minlength` properties. Use and . + - Removed old named `Readonly` and `Inputmode` properties. Use and . + - Changed type also to `string`. +- + - Changed `Change` event argument type from to . +- + - Removed `AriaThumbLower` and `AriaThumbUpper` properties. Use and instead. +- + - Renamed `Readonly` property to . ### 非推奨 @@ -852,34 +854,34 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft ## 削除済 ### **{PackageVerChanges-23-2-JAN}** -- `Input`, `Textarea` - exposed `ValidateOnly` to enable validation rules being enforced without restricting user input. -- `Dropdown` - `PositionStrategy` property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. -- `DockManager` - `SplitPane` `IsMaximized` is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the `IsMaximized` property of `TabGroupPane` and/or `ContentPane` instead. +- , - exposed to enable validation rules being enforced without restricting user input. +- - property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. +- - is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the property of and/or instead. ### .NET 8.0 のサポート - 2023.2 リリースでは .NET 8 がサポートされます。.NET 8 の詳細については、[Microsoft サイト](https://learn.microsoft.com/ja-jp/dotnet/core/whats-new/dotnet-8)をご確認ください。 -The type of Values from `PivotConfiguration` option is now array of IgbPivotValue - `IgbPivotValue[]`, it was `IgbPivotValueCollection` previously. +The type of Values from option is now array of IgbPivotValue - `IgbPivotValue[]`, it was `IgbPivotValueCollection` previously. ### {PackageCharts} (チャート) -- [チャートのハイライト表示フィルター](charts/features/chart-highlight-filter.md) - `CategoryChart` と `DataChart` は、データのサブセットの内外でハイライト表示およびアニメーション化する方法を公開するようになりました。このハイライト表示の表示はシリーズのタイプによって異なります。列およびエリア シリーズの場合、サブセットはデータの合計セットの上に表示され、サブセットはシリーズの実際のブラシによって色付けされ、合計セットは不透明度を下げます。折れ線シリーズの場合、サブセットは点線で表示されます。 +- [チャートのハイライト表示フィルター](charts/features/chart-highlight-filter.md) - は、データのサブセットの内外でハイライト表示およびアニメーション化する方法を公開するようになりました。このハイライト表示の表示はシリーズのタイプによって異なります。列およびエリア シリーズの場合、サブセットはデータの合計セットの上に表示され、サブセットはシリーズの実際のブラシによって色付けされ、合計セットは不透明度を下げます。折れ線シリーズの場合、サブセットは点線で表示されます。 -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. -- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via . -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### **{PackageVerChanges-23-2}** -- `RadialGauge` - - New label for the highlight needle. `HighlightLabelText` and `HighlightLabelSnapsToNeedlePivot` and many other styling related properties for the HighlightLabel were added. +- + - New label for the highlight needle. and and many other styling related properties for the HighlightLabel were added. ## {PackageGrids} - Toolbar - @@ -888,12 +890,12 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu - 新規機能: - [状態保持](grids/grid/state-persistence.md) -- `BulletGraph` - - The Performance bar will now reflect a difference between the value and new `HighlightValue` when the `HighlightValueDisplayMode` is applied to the 'Overlay' setting. The highlight value will show a filtered/subset measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. -- `LinearGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. -- `RadialGauge` - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - The Performance bar will now reflect a difference between the value and new when the is applied to the 'Overlay' setting. The highlight value will show a filtered/subset measured percentage as a filled in color while the remaining bar's appearance will appear faded to the assigned value, illustrating the performance in real-time. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. ## **{PackageVerChanges-23-1}** @@ -903,27 +905,27 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu ### {PackageCharts} (チャート) -- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - `ValueLayer` という名前の新しいシリーズ タイプが公開されました。これにより、Maximum、Minimum、Average など、プロットされたデータのさまざまな焦点のオーバーレイを描画できます。これは、新しい `ValueLines` コレクションに追加することで、`CategoryChart` と `FinancialChart` に適用されます。 +- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - という名前の新しいシリーズ タイプが公開されました。これにより、Maximum、Minimum、Average など、プロットされたデータのさまざまな焦点のオーバーレイを描画できます。これは、新しい コレクションに追加することで、 に適用されます。 ### **{PackageVerChanges-22-2.65}** -- `DockManager` - - New `ProximityDock` property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. - - New `ContainedInBoundaries` property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. - - New `ShowPaneHeaders` property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. -- `Tree` +- + - New property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. + - New property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. + - New property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. +- - Added `toggleNodeOnClick` property that determines whether clicking over a node will change its expanded state or not. Defaults to `false`. -- `Rating` +- - `allowReset` added. When enabled selecting the same value will reset the component. **Behavioral change** - In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. -- `Select`, `Dropdown` +- , - exposed `selectedItem`, `items` and `groups` getters -- `RadialGauge` - - New title/subtitle properties. `TitleText`, `SubtitleText` will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and `TitleExtent`. Finally, the new `TitleDisplaysValue` will allow the value to correspond with the needle's position. - - New `OpticalScalingEnabled` and `OpticalScalingSize` properties for the `RadialGauge`. This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) - - New highlight needle was added. `HighlightValue` and `HighlightValueDisplayMode` when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. +- + - New title/subtitle properties. , will appear near the bottom the gauge. In addition, the various title/subtitle font properties were added such as `TitleFontSize`, `TitleFontFamily`, `TitleFontStyle`, `TitleFontWeight` and . Finally, the new will allow the value to correspond with the needle's position. + - New and properties for the . This new feature will manage the size at which labels, titles, and subtitles of the gauge have 100% optical scaling. You can read more about this new feature in this [topic](radial-gauge.md#optical-scaling) + - New highlight needle was added. and when both are provided a value and 'Overlay' setting, this will make the main needle to appear faded and a new needle will appear. - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### 新しいコンポーネント @@ -936,7 +938,7 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu ### {PackageGrids} (データ グリッド) -- 新しい引数 `PrimaryKey` が `Detail` から `IgbRowDataEventArgs` に導入されました。これは、`RowAdded` および `RowDeleted` イベントによって発行されるイベント引数の一部です。グリッドに主キー属性が追加されている場合、発行された primaryKey イベント引数は行 ID を表し、それ以外の場合はデフォルトで null 値になります。 +- 新しい引数 `PrimaryKey` が から `IgbRowDataEventArgs` に導入されました。これは、`RowAdded` および `RowDeleted` イベントによって発行されるイベント引数の一部です。グリッドに主キー属性が追加されている場合、発行された primaryKey イベント引数は行 ID を表し、それ以外の場合はデフォルトで null 値になります。 - `RowSelectionChanging` イベント引数が変更されました。現在、グリッドが primaryKey を設定した場合、`OldSelection`、`NewSelection`、`Added` および `Removed` コレクションは、選択された要素の行キーで構成されなくなりましたが、いずれにしても行データが出力されるようになりました。 - グリッドがリモート データを操作していて、主キーが設定されている場合、現在グリッド ビューに含まれていない選択された行に対して、部分的な行データ オブジェクトが発行されます。 - 選択された行がグリッド コンポーネントから削除されると、`RowSelectionChanging` イベントは発生しなくなります。 @@ -950,8 +952,8 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu - `IgbDateTimeInput`、StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date) は、DateTimeInputDatePart ではなく DatePart に切り詰められるようになりました。 - `IgbRadio` および `IgbRadioGroup` は、無効な状態のスタイルとともにコンポーネントの検証が追加されました。 - `IgbMask` は、マスク パターン リテラルをエスケープする機能が追加されました。 -- `IgbBadge` は、バッジの形状を制御する `Shape` プロパティを追加し、`Square` または `Rounded` のいずれかになります。デフォルトでは、バッジの形状は rounded です。 -- `IgbAvatar`、`RoundShape` プロパティは廃止され、将来のバージョンで削除される予定です。ユーザーは、新しく追加された `Shape` 属性によってアバターの形状を制御できます。これは、`Square`、`Rounded`、または `Circle` にすることができます。アバターのデフォルトの形状は `Square`です。 +- `IgbBadge` は、バッジの形状を制御する プロパティを追加し、 または `Rounded` のいずれかになります。デフォルトでは、バッジの形状は rounded です。 +- `IgbAvatar`、`RoundShape` プロパティは廃止され、将来のバージョンで削除される予定です。ユーザーは、新しく追加された 属性によってアバターの形状を制御できます。これは、、`Rounded`、または にすることができます。アバターのデフォルトの形状は です。 ### {PackageDockManager} (DockManager) @@ -977,30 +979,30 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu ### {PackageGrids} (データ グリッド) -- **{IgPrefix}Column** を `DataGridColumn` に変更しました。 -- **GridCellEventArgs** を `DataGridCellEventArgs` に変更しました。 -- **GridSelectionMode** を `DataGridSelectionMode` に変更しました。 +- **{IgPrefix}Column** を に変更しました。 +- **GridCellEventArgs** を に変更しました。 +- **GridSelectionMode** を に変更しました。 - **SummaryOperand** を `DataSourceSummaryOperand` に変更しました。 -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **{PackageVerChanges-22-1}** ### {PackageCharts} (チャート) -- 高度に構成可能な [DataLegend](charts/features/chart-data-legend.md) コンポーネントが追加されました。これは、`Legend` とよく似たコンポーネントですが、シリーズの値を表示し、シリーズの行と値の列をフィルタリングし、値のスタイルとフォーマットを行うための多くの構成プロパティを提供します。 +- 高度に構成可能な [DataLegend](charts/features/chart-data-legend.md) コンポーネントが追加されました。これは、 とよく似たコンポーネントですが、シリーズの値を表示し、シリーズの行と値の列をフィルタリングし、値のスタイルとフォーマットを行うための多くの構成プロパティを提供します。 - 高度に構成可能な [DataToolTip](charts/features/chart-data-tooltip.md) が追加されました。これは、シリーズの値とタイトル、およびシリーズの凡例バッジをツールチップに表示します。これは、すべてのチャート タイプのデフォルトのツールチップになりました。 -- 積層シリーズのアニメーションとトランジションインのサポートが追加されました。`IsTransitionInEnabled` プロパティを true に設定すると、アニメーションを有効にできます。そこから、`TransitionInDuration` プロパティを設定してアニメーションが完了するまでの時間を決定し、`TransitionInMode` でアニメーションのタイプを決定できます。 -- 追加された `AssigningCategoryStyle` イベントは、`DataChart` のすべてのシリーズで利用できるようになりました。このイベントは、背景色の `Fill` やハイライト表示など、シリーズ項目の外観を条件付きで構成する場合に処理されます。 -- CalloutLayer の新しい `AllowedPositions` 列挙体。チャート内のどこにコールアウトを配置するかを制限するために使用されます。デフォルトでは、コールアウトは最適な場所に配置されますが、これは `TopLeft`、`TopRight`、`BottomLeft`、または `BottomRight` を強制するために使用されます。 +- 積層シリーズのアニメーションとトランジションインのサポートが追加されました。 プロパティを true に設定すると、アニメーションを有効にできます。そこから、 プロパティを設定してアニメーションが完了するまでの時間を決定し、 でアニメーションのタイプを決定できます。 +- 追加された `AssigningCategoryStyle` イベントは、 のすべてのシリーズで利用できるようになりました。このイベントは、背景色の やハイライト表示など、シリーズ項目の外観を条件付きで構成する場合に処理されます。 +- CalloutLayer の新しい 列挙体。チャート内のどこにコールアウトを配置するかを制限するために使用されます。デフォルトでは、コールアウトは最適な場所に配置されますが、これは `TopLeft`、`TopRight`、`BottomLeft`、または `BottomRight` を強制するために使用されます。 - 注釈レイヤーに追加された新しいコーナー半径プロパティ。各コールアウトのコーナーを丸めるために使用されます。コーナー半径がデフォルトで追加されていることに注意してください。 - - CalloutLayer の `CalloutCornerRadius` - - FinalValueLayer の `AxisAnnotationBackgroundCornerRadius` - - CrosshairLayer の `XAxisAnnotationBackgroundCornerRadius` と `YAxisAnnotationBackgroundCornerRadius` -- さまざまな方法でスクロールバーを有効にするための新しい `HorizontalViewScrollbarMode` および `VerticalViewScrollbarMode` 列挙体。`IsVerticalZoomEnabled` または `IsHorizontalZoomEnabled` と組み合わせると、チャートをナビゲートするための軸に沿ったスクロールバーを、常設またはフェードインおよびフェードアウトすることができます。 -- 新しい `FavorLabellingScaleEnd` は、軸がスケールの最後にラベルを表示することを優先するかどうかを決定します。数値軸 (`NumericXAxis`、`NumericYAxis`、`PercentChangeAxis` など) とのみ互換性があります。 -- 新しい `IsSplineShapePartOfRange` は、軸に要求された軸範囲にスプライン形状を含めるかどうかを決定します。 -- 新しい `XAxisMaximumGap` は、`XAxisGap` を使用するときにプロットされたシリーズの最大許容値を決定します。ギャップは、プロットされたシリーズの列またはバー間のスペースの量を決定します。 -- 新しい `XAxisMinimumGapSize` は、`XAxisGap` を使用するときに、プロットされたシリーズの最小許容ピクセルベース値を決定し、各カテゴリ間に常にある程度の間隔があることを保証します。 + - CalloutLayer の + - FinalValueLayer の + - CrosshairLayer の +- さまざまな方法でスクロールバーを有効にするための新しい および 列挙体。 または と組み合わせると、チャートをナビゲートするための軸に沿ったスクロールバーを、常設またはフェードインおよびフェードアウトすることができます。 +- 新しい は、軸がスケールの最後にラベルを表示することを優先するかどうかを決定します。数値軸 (、`PercentChangeAxis` など) とのみ互換性があります。 +- 新しい は、軸に要求された軸範囲にスプライン形状を含めるかどうかを決定します。 +- 新しい は、 を使用するときにプロットされたシリーズの最大許容値を決定します。ギャップは、プロットされたシリーズの列またはバー間のスペースの量を決定します。 +- 新しい は、 を使用するときに、プロットされたシリーズの最小許容ピクセルベース値を決定し、各カテゴリ間に常にある程度の間隔があることを保証します。 ### {PackageGrids} (データ グリッド) @@ -1028,7 +1030,7 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu ### {PackageGrids} (データ グリッド) -- `ValueField` プロパティを string[] 型から string に変更しました。 +- プロパティを string[] 型から string に変更しました。 ## {PackageInputs} (入力) @@ -1062,7 +1064,7 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu - Responsive layouts for horizontal label rotation based on browser / screen size. - Enhanced rendering for rounded labels on all platforms. - Added marker properties to StackedFragmentSeries. -- Added `ShouldPanOnMaximumZoom` property. +- Added property. - New Category Axis Properties: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -1083,7 +1085,7 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu - GroupSortDescriptions -[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties`. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using | . These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ### チャートとマップの改善 @@ -1093,20 +1095,20 @@ The type of Values from `PivotConfiguration` option is now array of IgbPivotValu ### **{PackageVerChanges-21-1}** -- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the `Legend`, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. +- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the , but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable [DataToolTip](charts/features/chart-data-tooltip.md) which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types. -- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the `IsTransitionInEnabled` property to true. From there, you can set the `TransitionInDuration` property to determine how long your animation should take to complete and the `TransitionInMode` to determine the type of animation that takes place. -- Added `AssigningCategoryStyle` event, is now available to all series in `DataChart`. This event is handled when you want to conditionally configure aspects of the series items such as `Fill` background-color and highlighting. -- New `AllowedPositions` enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. +- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the property to true. From there, you can set the property to determine how long your animation should take to complete and the to determine the type of animation that takes place. +- Added `AssigningCategoryStyle` event, is now available to all series in . This event is handled when you want to conditionally configure aspects of the series items such as background-color and highlighting. +- New enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default. - - `CalloutCornerRadius` for CalloutLayer - - `AxisAnnotationBackgroundCornerRadius` for FinalValueLayer - - `XAxisAnnotationBackgroundCornerRadius` and `YAxisAnnotationBackgroundCornerRadius` for CrosshairLayer -- New `HorizontalViewScrollbarMode` and `VerticalViewScrollbarMode` enumeration to enable scrollbars in various ways. When paired with `IsVerticalZoomEnabled` or `IsHorizontalZoomEnabled`, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. -- New `FavorLabellingScaleEnd`, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. `NumericXAxis`, `NumericYAxis`, `PercentChangeAxis`). -- New `IsSplineShapePartOfRange` determines whether to include the spline shape in the axis range requested of the axis. -- New `XAxisMaximumGap`, determines the maximum allowed value for the plotted series when using `XAxisGap`. The gap determines the amount of space between columns or bars of plotted series. -- New `XAxisMinimumGapSize`, determines the minimum allowed pixel-based value for the plotted series when using `XAxisGap` to ensure there is always some spacing between each category. + - for CalloutLayer + - for FinalValueLayer + - and for CrosshairLayer +- New and enumeration to enable scrollbars in various ways. When paired with or , you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. +- New , determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. , , `PercentChangeAxis`). +- New determines whether to include the spline shape in the axis range requested of the axis. +- New , determines the maximum allowed value for the plotted series when using . The gap determines the amount of space between columns or bars of plotted series. +- New , determines the minimum allowed pixel-based value for the plotted series when using to ensure there is always some spacing between each category. ### 新しいビジュアル デザイン @@ -1114,12 +1116,12 @@ Added New Feature - [Row Paging](grids/data-grid/row-paging.md) which is used to ### チャートとマップ -このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、`DataChart`、`CategoryChart`、および `FinancialChart`。 +このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、、および 。 ### チャート凡例 -- バブル、ドーナツ、および円チャートで使用できる水平方向の `Orientation` プロパティを ItemLegend に追加しました。 -- `LegendHighlightingMode` プロパティの追加 - 凡例項目にホバーした時にシリーズのハイライト表示を有効にします。 +- バブル、ドーナツ、および円チャートで使用できる水平方向の プロパティを ItemLegend に追加しました。 +- プロパティの追加 - 凡例項目にホバーした時にシリーズのハイライト表示を有効にします。 ## 地理マップ @@ -1130,9 +1132,9 @@ Added New Feature - [Row Paging](grids/data-grid/row-paging.md) which is used to ### {PackageGrids} (データ グリッド) - `EditOnKeyPress`、(別名: Excel スタイルの編集) を追加し、入力するとすぐに編集を開始します。 -- `EditModeClickAction` プロパティを追加しました - デフォルトでは、編集モードに入るにはダブル クリックが必要です。これを `SingleClick` に設定して、新しいセルを選択するときに編集モードを実行できるようにすることができます。 -- `EnterKeyBehaviors` プロパティの追加 - 別名 Excel スタイル ナビゲーション (Enter 動作) - Enter キーの動作を制御します。たとえば、オプションは none、edit、move up、down、left、right です。 -- `EnterKeyBehaviorAfterEdit` プロパティの追加 - 編集モードでは、このプロパティは Enter キーが押されたときを制御します。例えば、オプションは (下、上、右、左のセルに移動) です。 +- プロパティを追加しました - デフォルトでは、編集モードに入るにはダブル クリックが必要です。これを に設定して、新しいセルを選択するときに編集モードを実行できるようにすることができます。 +- プロパティの追加 - 別名 Excel スタイル ナビゲーション (Enter 動作) - Enter キーの動作を制御します。たとえば、オプションは none、edit、move up、down、left、right です。 +- プロパティの追加 - 編集モードでは、このプロパティは Enter キーが押されたときを制御します。例えば、オプションは (下、上、右、左のセルに移動) です。 - `SelectAllRows` メソッドを追加しました。 - 行範囲の選択を追加しました - `GridSelectionMode` プロパティを MultipleRow に設定すると、次の新しい機能が含まれるようになりました: - クリックしてドラッグし、行を選択します。 @@ -1143,18 +1145,18 @@ Added New Feature - [Row Paging](grids/data-grid/row-paging.md) which is used to ### {PackageInputs} (入力) -- A new `ValueChanged` event supports 2-way binding and should only be handled if you have not bound the `Value` property. In order to read the Value field from the control without data binding the `ValueChanged` event should be handled, otherwise if your data is not bound you should use GetCurrentValueAsync to read the controls Value. +- A new `ValueChanged` event supports 2-way binding and should only be handled if you have not bound the property. In order to read the Value field from the control without data binding the `ValueChanged` event should be handled, otherwise if your data is not bound you should use GetCurrentValueAsync to read the controls Value. #### 日付ピッカー -- `ShowTodayButton` - 現在の日付のボタンの表示を切り替えます。 -- `Label` - 日付値の上にラベルを追加します。 -- `Placeholder` プロパティ - 値が選択されていない場合にカスタム テキストを追加します。 -- `FormatString` - 入力日付文字列をカスタマイズします。(例: `yyyy-MM-dd`) -- `DateFormat` - 選択した日付を LongDate または ShortDate のどちらとして表示するかを指定します。 -- `FirstDayOfWeek` - 週の最初の曜日を指定します。 -- `FirstWeekOfYear` - 年の最初の週をいつ表示するかを指定します。例えば、最初の 1 週間、最初の 4 日間の週です。 -- `ShowWeekNumbers` - 週番号の表示を切り替えます。 -- `MinDate` & `MaxDate` - 使用可能の選択できる日付の範囲を指定する日付制限。 +- - 現在の日付のボタンの表示を切り替えます。 +- - 日付値の上にラベルを追加します。 +- プロパティ - 値が選択されていない場合にカスタム テキストを追加します。 +- - 入力日付文字列をカスタマイズします。(例: `yyyy-MM-dd`) +- - 選択した日付を LongDate または ShortDate のどちらとして表示するかを指定します。 +- - 週の最初の曜日を指定します。 +- - 年の最初の週をいつ表示するかを指定します。例えば、最初の 1 週間、最初の 4 日間の週です。 +- - 週番号の表示を切り替えます。 +- & - 使用可能の選択できる日付の範囲を指定する日付制限。 - アクセシビリティの追加 #### Multi-Column ComboBox @@ -1189,29 +1191,29 @@ For example, ``` ``` instead of ``` ``` This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -1237,30 +1239,30 @@ This release introduces a few improvements and simplifications to visual design #### Charts & Maps -This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. `DataChart`, `CategoryChart`, and `FinancialChart`. +This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. , , and . - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners - Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000 - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -1283,8 +1285,8 @@ for example: #### Chart Legend -- Added horizontal `Orientation` property to ItemLegend that can be used with Bubble, Donut, and Pie Chart -- Added `LegendHighlightingMode` property - Enables series highlighting when hovering over legend items +- Added horizontal property to ItemLegend that can be used with Bubble, Donut, and Pie Chart +- Added property - Enables series highlighting when hovering over legend items #### Geographic Map @@ -1300,9 +1302,9 @@ These features are CTP ### {PackageGrids} (Data Grid) - Added `EditOnKeyPress` aka Excel-style Editing, instantly begin editing when typing. -- Added `EditModeClickAction` property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. -- Added `EnterKeyBehaviors` property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) -- Added `EnterKeyBehaviorAfterEdit` property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) +- Added property - By default double-clicking is required to enter edit mode. This can be set to to allow for edit mode to occur when selecting a new cell. +- Added property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) +- Added property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) - Added `SelectAllRows` - method. - Added Row Range Selection - With `GridSelectionMode` property set to MultipleRow the following new functionality is now included: - Click and drag to select rows @@ -1315,13 +1317,13 @@ These features are CTP #### Date Picker -- `ShowTodayButton` - Toggles Today button visibility -- `Label` - Adds a label above the date value -- `Placeholder` property - adds custom text when no value is selected -- `FormatString` - Customize input date string e.g. (`yyyy-MM-dd`) -- `DateFormat` - Specifies whether to display selected dates as LongDate or ShortDate -- `FirstDayOfWeek` - Specifies first day of week -- `FirstWeekOfYear` - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) -- `ShowWeekNumbers` - Toggles Week number visibility -- `MinDate` & `MaxDate` - Date limits, specifying a range of available selectable dates. +- - Toggles Today button visibility +- - Adds a label above the date value +- property - adds custom text when no value is selected +- - Customize input date string e.g. (`yyyy-MM-dd`) +- - Specifies whether to display selected dates as LongDate or ShortDate +- - Specifies first day of week +- - Specifies when to display first week of the year, e.g. (First Full Week, First Four day Week) +- - Toggles Week number visibility +- & - Date limits, specifying a range of available selectable dates. - Added Accessibility diff --git a/docs/xplat/src/content/jp/components/general-changelog-dv-react.mdx b/docs/xplat/src/content/jp/components/general-changelog-dv-react.mdx index 6159bde3c5..9fcdfce1c7 100644 --- a/docs/xplat/src/content/jp/components/general-changelog-dv-react.mdx +++ b/docs/xplat/src/content/jp/components/general-changelog-dv-react.mdx @@ -18,6 +18,8 @@ import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} 変更ログ @@ -75,18 +77,18 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; ### {PackageGrids} (グリッド) -- `IgrGrid`、`IgrTreeGrid`、`IgrHierarchicalGrid`、`IgrPivotGrid` +- - グリッドに表示されるデータに基づいてスクロール スロットルを動的に調整することでパフォーマンスを改善しました。 **重大な変更** -- `IgrGrid`、`IgrTreeGrid`、`IgrHierarchicalGrid`、`IgrPivotGrid` +- - 元の `data` 配列の変更 (元の配列へのレコードの追加/削除/移動など) は自動的に検出されなくなりました。変更を検出するには、コンポーネントに配列参照の変更が必要です。 **ローカライゼーション (i18n)** -- `IgrGrid`、`IgrTreeGrid`、`IgrHierarchicalGrid`、`IgrPivotGrid`、`IgrCombo`、`IgrDatePicker`、`IgrDateRangePicker`、`IgrCalendar`、`IgrCarousel`、`IgrChip`、`IgrInput`、`IgrTree` - - グリッド コンポーネントで日付や数値などのデータをフォーマットおよびレンダリングするための新しい `Intl` 実装。`IgrCalendar`、`IgrDatePicker`、`IgrDateRangePicker` の `Intl` 実装を更新しました。 +- + - グリッド コンポーネントで日付や数値などのデータをフォーマットおよびレンダリングするための新しい `Intl` 実装。 の `Intl` 実装を更新しました。 - 現在サポートされているすべての言語のリソース文字列を持つすべてのコンポーネントに対する新しいローカライゼーション実装。 - 新しいパブリック ローカライゼーション API と、新しいリソースを含む `igniteui-i18n-resources` という名前のパッケージ。 @@ -138,18 +140,18 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と ### **{PackageVerChanges-25-2-DEC}** -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid`, `IgrPivotGrid` +- , , , - Improved performance by dynamically adjusting the scroll throttle based on the data displayed in grid. **Breaking Changes** -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid`, `IgrPivotGrid` +- , , , - Original `data` array mutations (like adding/removing/moving records in the original array) are no longer detected automatically. Components need an array reference change for the change to be detected. **Localization(i18n)** -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid`, `IgrPivotGrid`, `IgrCombo`, `IgrDatePicker`, `IgrDateRangePicker`, `IgrCalendar`, `IgrCarousel`, `IgrChip`, `IgrInput`, `IgrTree` - - New `Intl` implementation for the grid components that format and render data like dates and numbers. Updated `Intl` implementation for `IgrCalendar`, `IgrDatePicker`, and `IgrDateRangePicker`. +- , , , , , , , , , , , + - New `Intl` implementation for the grid components that format and render data like dates and numbers. Updated `Intl` implementation for , , and . - New localization implementation for the currently supported languages for all components that have resource strings in the currently supported languages. - New public localization API and package named `igniteui-i18n-resources` containing the new resources that are used in conjunction. @@ -185,7 +187,7 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と ### ユーザー注釈 -{ProductName} では、ユーザー注釈機能により、実行時に `DataChart` にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 +{ProductName} では、ユーザー注釈機能により、実行時に にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 ### 軸注釈の衝突検出 @@ -201,15 +203,15 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と #### 新しいコンポーネント -- `IgrChat` コンポーネントを追加しました。 +- `Chat` コンポーネントを追加しました。 -This is directly integrated with the available tools of the `Toolbar`. +This is directly integrated with the available tools of the . {Platform} user-annotation-create #### {PackageGrids} (グリッド) -- `IgrGrid`、`IgrTreeGrid`、`IgrHierarchicalGrid` +- - 同じデータまたはその他のカスタム条件に基づいて列内のセルを 1 つのセルに構成および結合できる新しいセル結合機能を追加しました。 個々の列で有効化できます: @@ -238,10 +240,10 @@ This is directly integrated with the available tools of the `Toolbar`. ### Azure マップ画像のサポート -`IgrGeographicMap` は、 Azure ベースのマップ画像をサポートし、開発者は複数のアプリケーション タイプにわたって詳細かつ動的なマップを表示できるようになりました。複数のマップ レイヤーを組み合わせて地理データを視覚化し、インタラクティブなマッピング エクスペリエンスを簡単に作成できます。 + は、 Azure ベースのマップ画像をサポートし、開発者は複数のアプリケーション タイプにわたって詳細かつ動的なマップを表示できるようになりました。複数のマップ レイヤーを組み合わせて地理データを視覚化し、インタラクティブなマッピング エクスペリエンスを簡単に作成できます。 ### {PackageCharts} (チャート) -- `IgrGrid`, `IgrTreeGrid`, `IgrHierarchicalGrid` +- , , - Introduced a new cell merging feature that allows you to configure and merge cells in a column based on same data or other custom condition, into a single cell. It can be enabled on the individual columns: @@ -308,7 +310,7 @@ This is directly integrated with the available tools of the `Toolbar`. ### 新しい軸ラベル イベント -軸ラベルに対するさまざまな操作を検出できるように、次のイベントが `IgrDataChart` に追加されました。 +軸ラベルに対するさまざまな操作を検出できるように、次のイベントが に追加されました。 ## 対応軸 @@ -329,11 +331,11 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft | バグ番号 | コントロール | 説明 | |------------|---------|-------------| -|31624 | `IgrCategoryChart` | `IgrCategoryChart` を含むウィンドウをリサイズすると、チャートがシリーズをレンダリングできなくなる。| -|27304 | `IgrDataChart` | ズーム長方形が背景長方形と同じ位置に配置されない。| -|38231 | `IgrGrid` | 非ピン固定列は、非表示が存在する場合に元の位置に戻らない。| -|30600 | `IgrDoughnutChart` | チャートやシリーズに textStyle プロパティが存在しない (円チャートにはある)。| -|37930 | `IgrDataChart` | Data Annotation Overlay のテキスト色が機能しない。| +|31624 | | を含むウィンドウをリサイズすると、チャートがシリーズをレンダリングできなくなる。| +|27304 | | ズーム長方形が背景長方形と同じ位置に配置されない。| +|38231 | | 非ピン固定列は、非表示が存在する場合に元の位置に戻らない。| +|30600 | | チャートやシリーズに textStyle プロパティが存在しない (円チャートにはある)。| +|37930 | | Data Annotation Overlay のテキスト色が機能しない。| |33861 | Excel Library | 折れ線チャートを追加すると、ドイツ語カルチャで Excel ファイルが破損する。| - `LabelMouseDown` @@ -345,15 +347,15 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft #### 機能拡張 -Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the `CompanionAxisEnabled` property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. +Added `CompanionAxis` properties to the X and Y axis that allow you to quickly create a clone of an existing axis. When enabled using the property, this will default the cloned axis to the opposite position of the chart and you can then configure that axes' properties. #### IgrBulletGraph -- 新しい `LabelsVisible` プロパティが追加されました。 +- 新しい プロパティが追加されました。 **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### チャート @@ -361,24 +363,24 @@ Added `CompanionAxis` properties to the X and Y axis that allow you to quickly c - DataGrid に新しいプロパティ `stopPropagation` が追加されました。これにより、マウス イベントが親要素へバブリングするのを防止できます。 -- `SuffixText` -- `SuffixTextColor` +- +- - `SuffixTextFont` -- `SuffixIconName` -- `SuffixIconCollectionName` -- `SuffixIconStroke` -- `SuffixIconFill` -- `SuffixIconViewBoxLeft` -- `SuffixIconViewBoxTop` -- `SuffixIconViewBoxWidth` -- `SuffixIconViewBoxHeight` -- `TextDecoration` +- +- +- +- +- +- +- +- +- Please note that the maximum size available for the icons is 24x24. You can provide an icon that is larger or smaller than this, but you will need to configure the viewbox settings in order to properly scale it to fit in the 24x24 space so it is fully visible. ### IgrLinearGauge -- 新しい `LabelsVisible` プロパティが追加されました。 +- 新しい プロパティが追加されました。 ### **{PackageVerChanges-25-1-SEP}** @@ -402,11 +404,11 @@ Please note that the maximum size available for the icons is 24x24. You can prov |[1809](https://github.com/IgniteUI/igniteui-webcomponents/pull/1809)|Switch|新しい thumb hover プロパティを使用するよう修正。| |[1837](https://github.com/IgniteUI/igniteui-webcomponents/pull/1837)|TileManager|内部正規表現のエスケープ不備を修正。| -- New properties added to the DataLegend to aid in styling: `ContentBackground`, `ContentBorderBrush`, and `ContentBorderThickness`. The `ContentBorderBrush` and `ContentBorderThickness` default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. +- New properties added to the DataLegend to aid in styling: , , and . The and default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. -- Added a new property to `ChartMouseEventArgs` called `WorldPosition` that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. +- Added a new property to called that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. -- Added `HighlightingFadeOpacity` to `SeriesViewer` and `DomainChart`. This allows you to configure the opacity applied to highlighted series. +- Added to and . This allows you to configure the opacity applied to highlighted series. - Expose `CalloutLabelUpdating` event for domain charts. @@ -519,7 +521,7 @@ Please note that the maximum size available for the icons is 24x24. You can prov ### {PackageDashboards} (ダッシュボード) -- `IgrDashboardTile` では、ソート、グループ化、フィルタリング、選択などの集計を DataGrid ビューからチャート視覚化に伝播できるようになりました。これは現在、`IgrDashboardTile` の `DataSource` を `IgrLocalDataSource` のインスタンスにバインドすることによってサポートされています。 +- では、ソート、グループ化、フィルタリング、選択などの集計を DataGrid ビューからチャート視覚化に伝播できるようになりました。これは現在、 の `DataSource` を のインスタンスにバインドすることによってサポートされています。 ### {PackageGrids} @@ -538,9 +540,9 @@ Please note that the maximum size available for the icons is 24x24. You can prov - チャートは `GetOthersContext()` メソッドを公開するようになりました。これにより、Others (その他) スライスのコンテンツが返されます。 -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. - The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. @@ -550,10 +552,10 @@ Please note that the maximum size available for the icons is 24x24. You can prov | バグ番号 | コントロール | 説明 | |------------|---------|------------------| -|25997 | `IgrDataGrid` | 集計はグループ化された最初の子行にのみ表示される。| -|37023 | `IgrDataChart` | overflow: hidden が設定されている場合にツールチップが切り取られたり画面外に表示されたりする。 +|25997 | `DataGrid` | 集計はグループ化された最初の子行にのみ表示される。| +|37023 | | overflow: hidden が設定されている場合にツールチップが切り取られたり画面外に表示されたりする。 |37244 | Excel Library | カスタム データ検証が機能しない。. -|37685 | `IgrSpreadsheet` | Arial フォントで書式設定された数値が正しく描画されない。 +|37685 | `Spreadsheet` | Arial フォントで書式設定された数値が正しく描画されない。 ### **{PackageVerChanges-24-2-APR2}** @@ -590,10 +592,10 @@ With 19.0.0 the React product introduces many breaking changes done to improve a ### 機能拡張 #### List -- `ListItem` に新しいプロパティ `Selected` を追加しました。 +- に新しいプロパティ を追加しました。 #### Accordion -- 新しいイベント `Open` および `Close` を追加しました。 +- 新しいイベント および `Close` を追加しました。 igr-tab-panel component is removed. The igr-tab now encompasses both the tab header and the tab content in a single component. @@ -601,12 +603,12 @@ igr-tab-panel component is removed. The igr-tab now encompasses both the tab hea ### 非推奨 -- `Button` の `clicked` イベントは非推奨となりました。代わりにネイティブの `onClick` ハンドラーを使用してください。 +- の `clicked` イベントは非推奨となりました。代わりにネイティブの `onClick` ハンドラーを使用してください。 ### バグ修正 #### **{PackageVerChanges-24-2-MAR1}** -- Added new property on `ListItem` called `Selected` +- Added new property on called #### {PackageGrids} 次の表は、このリリースの {ProductName} ツールセットに対して行われたバグ修正を示しています。 @@ -614,7 +616,7 @@ igr-tab-panel component is removed. The igr-tab now encompasses both the tab hea ### **{PackageVerChanges-24-2-MAR}** - **All Grids** - - Allow applying initial filtering through `FilteringExpressionsTree` property + - Allow applying initial filtering through property ### {PackageGrids} @@ -625,14 +627,14 @@ igr-tab-panel component is removed. The igr-tab now encompasses both the tab hea ### {PackageCommon} - `Dockmanager` に、分割内で直接ドッキングできる新しい `allowSplitterDock` プロパティが追加されました。 -- `Dockmanager` の `SplitPane` に新しい `useFixedSize` プロパティが追加され、新しいサイズ変更動作が可能になりました。 +- `Dockmanager` の に新しい `useFixedSize` プロパティが追加され、新しいサイズ変更動作が可能になりました。 ## 機能拡張 ### Toolbar -- `Toolbar` と `ToolPanel` に新しい `groupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての `ToolActionGroupHeader` アクションに適用されます。 -- タイトル テキストの水平方向の配置を制御する `TitleHorizontalAlignment` という新しいプロパティを `ToolAction` に追加しました。 -- `ToolActionSubPanel` に、パネル内の項目間の間隔を制御する `itemSpacing` という新しいプロパティを追加しました。 +- に新しい `groupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての アクションに適用されます。 +- タイトル テキストの水平方向の配置を制御する という新しいプロパティを に追加しました。 +- に、パネル内の項目間の間隔を制御する `itemSpacing` という新しいプロパティを追加しました。 | Bug Number | Control | Description | |------------|---------|------------------| @@ -660,16 +662,16 @@ DashboardTile | Bug Number | Control | Description | |------------|---------|------------------| -|30286 | `IgrDataChart` | Bubble Series tooltip content is switched to that of nearby bubble data in clicking a bubble| -|32906 | `IgrDataChart` | `IgrDataChart` is showing two xAxis on the top| -|33605 | `IgrDataChart` | ScatterLineSeries is not showing the color of the line correctly in the legend| -|34776 | `IgrDataChart` | Repeatedly showing and hiding the `IgrDataChart` causes memory leakage in JS Heap| -|35498 | `IgrDataChart` | Tooltips for the series specified in IncludedSeries are not displayed| -|34324 | `IgrGrid` | Column hiding through condition in the grid template is not working| -|34678 | `IgrGrid` | Enum values coerced to strings, breaking expected numeric behavior in some grid properties| -|32093 | `IgrPivotGrid` | PivotDateDimensionOptions are not applied to the PivotDateDimension| -|34053 | `IgrRadialGauge` | The position of the scale label is shifted| -|35496 | `IgrSpreadsheet` | Error when setting styles in Excel with images| +|30286 | | Bubble Series tooltip content is switched to that of nearby bubble data in clicking a bubble| +|32906 | | is showing two xAxis on the top| +|33605 | | ScatterLineSeries is not showing the color of the line correctly in the legend| +|34776 | | Repeatedly showing and hiding the causes memory leakage in JS Heap| +|35498 | | Tooltips for the series specified in IncludedSeries are not displayed| +|34324 | | Column hiding through condition in the grid template is not working| +|34678 | | Enum values coerced to strings, breaking expected numeric behavior in some grid properties| +|32093 | | PivotDateDimensionOptions are not applied to the PivotDateDimension| +|34053 | | The position of the scale label is shifted| +|35496 | `Spreadsheet` | Error when setting styles in Excel with images| |36176 | Excel Library | Exception occurs when loading an Excel workbook that has a LET function| |36379 | Excel Library | Colors with any alpha channel in an excel workbook fail to load| |26218 | Excel Library | Chart's plot area right margin becomes narrower and fill pattern and fill foreground are gone just by loading an Excel file| @@ -683,39 +685,39 @@ DashboardTile ### 一般 - 新しい [Carousel](layouts/carousel.md) コンポーネント。 -- `Input` - - `change` イベント引数タイプを `ComponentDataValueChangedEventArgs` から `ComponentValueChangedEventArgs` に変更しました。 +- + - `change` イベント引数タイプを から に変更しました。 ## **{PackageVerChanges-24-1-SEP}** ### {PackageCharts} (チャート) -- 新しい[データ円チャート](charts/types/data-pie-chart.md) - `DataPieChart` は円ャートを表示する新しいコンポーネントです。このコンポーネントは、`CategoryChart` と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、強調表示、アニメーション、凡例のサポートを可能にします。 +- 新しい[データ円チャート](charts/types/data-pie-chart.md) - は円ャートを表示する新しいコンポーネントです。このコンポーネントは、 と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、強調表示、アニメーション、凡例のサポートを可能にします。 -- 新しい [比例カテゴリ角度軸](charts/types/radial-chart.md) - スライスをプロットするための、`DataChart` のラジアル円シリーズの新しい軸。円チャートに似ており、データ ポイントが円グラフ内のセグメントとして表されます。 +- 新しい [比例カテゴリ角度軸](charts/types/radial-chart.md) - スライスをプロットするための、 のラジアル円シリーズの新しい軸。円チャートに似ており、データ ポイントが円グラフ内のセグメントとして表されます。 ### {PackageCommon} - 新しい [Banner](notifications/banner.md) コンポーネント。 - 新しい [DatePicker](scheduling/date-picker.md) コンポーネント。 -- 新しい `Divider` コンポーネント。 +- 新しい コンポーネント。 - すべてのコンポーネントにネイティブ イベントのサポートが追加されました。 -- `Icon` +- - `setIconRef` メソッドが追加されました。これにより、アイコンを SVG ファイルで登録および置き換えることができます。 - すべてのコンポーネントが内部的な参照によるアイコンを使用するようになり、カスタム テンプレートを明示的に提供しなくても簡単に置き換えられるようになりました。 -- `Combo`、`DatePicker`、`Dialog`、`Dropdown`、`ExpansionPanel`、`NavDrawer`、`Toast`、`Snackbar`、**IgrSelectComponent** +- 、**IgrSelectComponent** - トグル メソッドの `show`、`hide`、`toggle` メソッドは、成功した場合に **true** を返すようになりました。そうでない場合は **false**。 -- **IgrButtonComponent**、`IconButton`、`Checkbox`、`Switch`、`Combo`、`DateTimeInput`、`Input`、`MaskInput`、`Radio`、**IgrSelectComponent**、`Textarea` +- **IgrButtonComponent**、、**IgrSelectComponent**、 - カスタムの `focus` および `blur` イベントは非推奨になりました。代わりにネイティブの `onFocus` および `onBlur` イベントを使用してください。 -- `RadioGroup` - - `Name` および `Value` プロパティを追加しました。 +- + - および プロパティを追加しました。 ## {PackageGrids} ### **{PackageVerChanges-24-1-JUN}** - New [Carousel](layouts/carousel.md) component. -- `Input` - - Changed `change` event argument type from `ComponentDataValueChangedEventArgs` to `ComponentValueChangedEventArgs` +- + - Changed `change` event argument type from to ## {PackageCommon} @@ -723,9 +725,9 @@ DashboardTile - `DisplayDensity` は非推奨となり、代わりに `--ig-size` CSS カスタム プロパティが使用されるようになりました。詳細については、[グリッド サイズ](grids/grid/size.md) トピックを参照してください。 -- `PivotGrid` - コンポーネントの構成が正しく適用できるようになりました。 +- - コンポーネントの構成が正しく適用できるようになりました。 -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -740,87 +742,87 @@ DashboardTile ### {PackageCharts} (チャート) -- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。`GroupRowVisible` プロパティは、各シリーズのグループ化を切り替え、オプトインすると `DataLegendGroup` プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 +- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。 プロパティは、各シリーズのグループ化を切り替え、オプトインすると プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 -- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、`CategoryChart` および `DataChart` のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 -複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと `SelectedSeriesItems` は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 +- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、 および のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 +複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 -- [比例カテゴリ角度軸](charts/types/radial-chart.md) - `DataChart` のラジアル円シリーズの新しい軸により、データ チャートのすべての追加機能を使用してロバスト可能な視覚化をする円チャートの作成が可能になります。 +- [比例カテゴリ角度軸](charts/types/radial-chart.md) - のラジアル円シリーズの新しい軸により、データ チャートのすべての追加機能を使用してロバスト可能な視覚化をする円チャートの作成が可能になります。 ### {PackageGauges} (ゲージ) -- `RadialGauge` - - ハイライト針の新しいラベル。`HighlightLabelText` と `HighlightLabelSnapsToNeedlePivot` および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 +- + - ハイライト針の新しいラベル。 および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 **Breaking Changes** - **All Grids** - - `RowIsland` + - - Removed `displayDensity` deprecated property. - Renamed `actualColumns`, `contentColumns` properties to `actualColumnList` and `contentColumnList`. Use `columns` or `columnList` property to get all columns now. - - Renamed `rowDelete` and `rowAdd` event argument type to `RowDataCancelableEventArgs`. - - Renamed `contextMenu` event argument type to `GridContextMenuEventArgs`. - - Removed `GridEditEventArgs`, `GridEditDoneEventArgs`, `PinRowEventArgs` events `rowID` and `primaryKey` properties. Use `rowKey` instead. -- `PivotGrid` + - Renamed `rowDelete` and `rowAdd` event argument type to . + - Renamed `contextMenu` event argument type to . + - Removed , , events `rowID` and `primaryKey` properties. Use `rowKey` instead. +- - removed `showPivotConfigurationUI` property. Use `pivotUI` and set inside it the new `showConfiguration` option. -- `Column` +- - Removed `movable` property. Use Grid's `moving` property now. - Removed `columnChildren` property. Use `childColumns` instead. -- `ColumnGroup` +- - Removed `children` property. Use `childColumns` instead. -- `Paginator` +- - Removed `isFirstPageDisabled` and `isLastPageDisabled` properties. Use `isFirstPage` and `isLastPage` instead. ## **{PackageVerChanges-23-2-MAR}** ### {PackageCharts} -- `InitialFilter` プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 +- プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 ### {PackageGrids} -- 新しい [`HierarchicalGrid`](grids/hierarchical-grid/overview.md) コンポーネント +- 新しい [](grids/hierarchical-grid/overview.md) コンポーネント -- `PivotGrid` - Configuration of the component can now be applied correctly. +- - Configuration of the component can now be applied correctly. ### {PackageGauges} -- `RadialGauge` - - 新しいタイトル/サブタイトルのプロパティ。`TitleText`、`SubtitleText` はゲージの下部近くに表示されます。さらに、`TitleFontSize`、`TitleFontFamily`、`TitleFontStyle`、`TitleFontWeight`、`TitleExtent` など、さまざまなタイトルとサブタイトルのフォント プロパティが追加されました。最後に、新しい `TitleDisplaysValue` により、値を針の位置に対応させることができます。 - - `RadialGauge` の新しい `OpticalScalingEnabled` プロパティと `OpticalScalingSize` プロパティ。この新機能は、ゲージのラベル、タイトル、サブタイトルが 100% のオプティカル スケーリングを持つサイズを管理します。この新機能の詳細については、[こちら](radial-gauge.md#オプティカル-スケーリング)を参照してください。 - - 新しいハイライト針が追加されました。`HighlightValue` と `HighlightValueDisplayMode` の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 -- `LinearGauge` - - 新しいハイライト針が追加されました。`HighlightValue` と `HighlightValueDisplayMode` の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 -- `BulletGraph` - - `HighlightValueDisplayMode` が 'Overlay' 設定に適用されたとき、パフォーマンス バーには値と新しい `HighlightValue` の差が反映されるようになりました。ハイライト値には、フィルタリング/サブセットが完了した測定パーセンテージが塗りつぶされた色で表示され、残りのバーの外観は割り当てられた値に対して薄く表示され、リアルタイムでパフォーマンスを示します。 +- + - 新しいタイトル/サブタイトルのプロパティ。 はゲージの下部近くに表示されます。さらに、`TitleFontSize`、`TitleFontFamily`、`TitleFontStyle`、`TitleFontWeight`、 など、さまざまなタイトルとサブタイトルのフォント プロパティが追加されました。最後に、新しい により、値を針の位置に対応させることができます。 + - の新しい プロパティと プロパティ。この新機能は、ゲージのラベル、タイトル、サブタイトルが 100% のオプティカル スケーリングを持つサイズを管理します。この新機能の詳細については、[こちら](radial-gauge.md#オプティカル-スケーリング)を参照してください。 + - 新しいハイライト針が追加されました。 の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 +- + - 新しいハイライト針が追加されました。 の両方に値と 'Overlay' 設定が指定されたとき、メインの針が薄く表示され、新しい針が表示されます。 +- + - が 'Overlay' 設定に適用されたとき、パフォーマンス バーには値と新しい の差が反映されるようになりました。ハイライト値には、フィルタリング/サブセットが完了した測定パーセンテージが塗りつぶされた色で表示され、残りのバーの外観は割り当てられた値に対して薄く表示され、リアルタイムでパフォーマンスを示します。 -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. -- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via `FillBrushes`. -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### {PackageCommon} -- 新しい `Textarea` コンポーネント -- 新しい `ButtonGroup` コンポーネント -- `DockManager` - - 新しい `ProximityDock` プロパティ。有効にすると、ドッキング インジケーターは表示されなくなり、エンド ユーザーは、ドラッグしたペインをターゲット ペインの端に近づけてドラッグすることでドッキングできます - - 新しい `ContainedInBoundaries` プロパティ。フローティング ペインを Dock Manager の境界内に保持するかどうかを決定します。デフォルトは **false** です。 - - 新しい `ShowPaneHeaders` プロパティ。ペインのヘッダーをホバー時にのみ表示するか、常に表示するかを決定します。デフォルトは `always` です。 -- `Input`、`MaskInput`、`DateTimeInput`、`Rating` - - `Readonly` は `ReadOnly` に名前が変更されました。 -- `Input` - - `Maxlength` は `MaxLength` に名前が変更されました。 - - `Minlength` は `MinLength` に名前が変更されました。 -- `Tree` +- 新しい コンポーネント +- 新しい コンポーネント +- + - 新しい プロパティ。有効にすると、ドッキング インジケーターは表示されなくなり、エンド ユーザーは、ドラッグしたペインをターゲット ペインの端に近づけてドラッグすることでドッキングできます + - 新しい プロパティ。フローティング ペインを Dock Manager の境界内に保持するかどうかを決定します。デフォルトは **false** です。 + - 新しい プロパティ。ペインのヘッダーをホバー時にのみ表示するか、常に表示するかを決定します。デフォルトは `always` です。 +- + - `Readonly` は に名前が変更されました。 +- + - `Maxlength` は に名前が変更されました。 + - `Minlength` は に名前が変更されました。 +- - ノードをクリックすると展開状態が変更されるかどうかを決定する `toggleNodeOnClick` プロパティが追加されました。デフォルトは **false** です。 -- `Rating` +- - `allowReset` が追加されました。有効にすると、同じ値を選択するとコンポーネントがリセットされます。**動作の変更** - 以前のリリースでは、これが Rating コンポーネントのデフォルトの動作でした。アプリケーションでこの動作を維持する必要がある場合は、必ず `allowReset` を設定してください。 -- `Select`、`Dropdown` +- - `selectedItem`、`items`、および `groups` ゲッターが公開されました。 ## 非推奨 @@ -828,41 +830,41 @@ DashboardTile ### 削除済 - デフォルトの属性を隠していた独自の `dir` 属性が削除されました。これは互換性のある変更です。 -- `Slider` - `ariaLabel` シャドウ プロパティ。これは互換性のある変更です。 -- `Checkbox` - `ariaLabelledBy` シャドウ属性。これは互換性のある変更です。 -- `Switch` - `ariaLabelledBy` シャドウ属性。これは互換性のある変更です。 -- `Radio` - `ariaLabelledBy` シャドウ属性。これは互換性のある変更です。 +- - `ariaLabel` シャドウ プロパティ。これは互換性のある変更です。 +- - `ariaLabelledBy` シャドウ属性。これは互換性のある変更です。 +- - `ariaLabelledBy` シャドウ属性。これは互換性のある変更です。 +- - `ariaLabelledBy` シャドウ属性。これは互換性のある変更です。 - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### **{PackageVerChanges-23-2-JAN}** -- New [`HierarchicalGrid`](grids/hierarchical-grid/overview.md) component +- New [](grids/hierarchical-grid/overview.md) component ### {PackageCharts} (チャート) -- [チャートのハイライト表示フィルター](charts/features/chart-highlight-filter.md) - `CategoryChart` と `DataChart` は、データのサブセットの内外でハイライト表示およびアニメーション化する方法を公開するようになりました。このハイライト表示の表示はシリーズのタイプによって異なります。列およびエリア シリーズの場合、サブセットはデータの合計セットの上に表示され、サブセットはシリーズの実際のブラシによって色付けされ、合計セットは不透明度を下げます。折れ線シリーズの場合、サブセットは点線で表示されます。 +- [チャートのハイライト表示フィルター](charts/features/chart-highlight-filter.md) - は、データのサブセットの内外でハイライト表示およびアニメーション化する方法を公開するようになりました。このハイライト表示の表示はシリーズのタイプによって異なります。列およびエリア シリーズの場合、サブセットはデータの合計セットの上に表示され、サブセットはシリーズの実際のブラシによって色付けされ、合計セットは不透明度を下げます。折れ線シリーズの場合、サブセットは点線で表示されます。 ### **{PackageVerChanges-23-2-DEC}** -- New `Textarea` component -- New `ButtonGroup` component -- `DockManager` - - New `ProximityDock` property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. - - New `ContainedInBoundaries` property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. - - New `ShowPaneHeaders` property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. -- `Input`, `MaskInput`, `DateTimeInput`, `Rating` - - `Readonly` has been renamed to `ReadOnly` -- `Input` - - `Maxlength` has been renamed to `MaxLength` - - `Minlength` has been renamed to `MinLength` -- `Tree` +- New component +- New component +- + - New property. If enabled, docking indicators are not visible and the end user can dock the dragged pane by dragging it close to the target pane edges. + - New property. Determines whether the floating panes are kept inside the Dock Manager boundaries. Defaults to `false`. + - New property. Determines whether pane headers are only shown on hover or always visible. Defaults to `always`. +- , , , + - `Readonly` has been renamed to +- + - `Maxlength` has been renamed to + - `Minlength` has been renamed to +- - Added `toggleNodeOnClick` property that determines whether clicking over a node will change its expanded state or not. Defaults to `false`. -- `Rating` +- - `allowReset` added. When enabled selecting the same value will reset the component. **Behavioral change** - In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. -- `Select`, `Dropdown` +- , - exposed `selectedItem`, `items` and `groups` getters @@ -874,10 +876,10 @@ DashboardTile #### **{PackageVerChanges-23-2}** - Removed our own `dir` attribute which shadowed the default one. This is a non-breaking change. -- `Slider` - `ariaLabel` shadowed property. This is a non-breaking change. -- `Checkbox` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. -- `Switch` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. -- `Radio` - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabel` shadowed property. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. +- - `ariaLabelledBy` shadowed attribute. This is a non-breaking change. ## {PackageGrids} - Toolbar - @@ -889,7 +891,7 @@ DashboardTile ### 新しいコンポーネント -- [Toolbar](menus/toolbar.md) コンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、`DataChart` または `CategoryChart` コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 +- [Toolbar](menus/toolbar.md) コンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、 または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 ## {PackageCharts} (チャート) @@ -900,7 +902,7 @@ DashboardTile - ブラウザー / 画面サイズに基づいた水平ラベル回転のレスポンシブ レイアウト。 - すべてのプラットフォームでの丸型ラベルの描画が強化されました。 - StackedFragmentSeries にマーカー プロパティを追加しました。 -- `ShouldPanOnMaximumZoom` プロパティを追加しました。 +- プロパティを追加しました。 - 新しいカテゴリ軸プロパティ: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -922,35 +924,35 @@ DashboardTile ### {PackageGrids} (データ グリッド) -- **{IgPrefix}Column** を `DataGridColumn` に変更しました。 -- **GridCellEventArgs** を `DataGridCellEventArgs` に変更しました。 -- **GridSelectionMode** を `DataGridSelectionMode` に変更しました。 -- **SummaryOperand** を `DataSourceSummaryOperand` に変更しました。 +- **{IgPrefix}Column** を に変更しました。 +- **GridCellEventArgs** を に変更しました。 +- **GridSelectionMode** を に変更しました。 +- **SummaryOperand** を に変更しました。 ## **{PackageVerChanges-22-1}** ### {PackageCharts} (チャート) -- 高度に構成可能な [DataLegend](charts/features/chart-data-legend.md) コンポーネントが追加されました。これは、`Legend` とよく似たコンポーネントですが、シリーズの値を表示し、シリーズの行と値の列をフィルタリングし、値のスタイルとフォーマットを行うための多くの構成プロパティを提供します。 +- 高度に構成可能な [DataLegend](charts/features/chart-data-legend.md) コンポーネントが追加されました。これは、 とよく似たコンポーネントですが、シリーズの値を表示し、シリーズの行と値の列をフィルタリングし、値のスタイルとフォーマットを行うための多くの構成プロパティを提供します。 - 高度に構成可能な [DataToolTip](charts/features/chart-data-tooltip.md) が追加されました。これは、シリーズの値とタイトル、およびシリーズの凡例バッジをツールチップに表示します。これは、すべてのチャート タイプのデフォルトのツールチップになりました。 -- 積層シリーズのアニメーションとトランジションインのサポートが追加されました。`IsTransitionInEnabled` プロパティを true に設定すると、アニメーションを有効にできます。そこから、`TransitionInDuration` プロパティを設定してアニメーションが完了するまでの時間を決定し、`TransitionInMode` でアニメーションのタイプを決定できます。 -- 追加された `AssigningCategoryStyle` イベントは、`DataChart` のすべてのシリーズで利用できるようになりました。このイベントは、背景色の `Fill` やハイライト表示など、シリーズ項目の外観を条件付きで構成する場合に処理されます。 -- CalloutLayer の新しい `AllowedPositions` 列挙体。チャート内のどこにコールアウトを配置するかを制限するために使用されます。デフォルトでは、コールアウトは最適な場所に配置されますが、これは `TopLeft`、`TopRight`、`BottomLeft`、または `BottomRight` を強制するために使用されます。 +- 積層シリーズのアニメーションとトランジションインのサポートが追加されました。 プロパティを true に設定すると、アニメーションを有効にできます。そこから、 プロパティを設定してアニメーションが完了するまでの時間を決定し、 でアニメーションのタイプを決定できます。 +- 追加された `AssigningCategoryStyle` イベントは、 のすべてのシリーズで利用できるようになりました。このイベントは、背景色の やハイライト表示など、シリーズ項目の外観を条件付きで構成する場合に処理されます。 +- CalloutLayer の新しい 列挙体。チャート内のどこにコールアウトを配置するかを制限するために使用されます。デフォルトでは、コールアウトは最適な場所に配置されますが、これは `TopLeft`、`TopRight`、`BottomLeft`、または `BottomRight` を強制するために使用されます。 - 注釈レイヤーに追加された新しいコーナー半径プロパティ。各コールアウトのコーナーを丸めるために使用されます。コーナー半径がデフォルトで追加されていることに注意してください。 - - CalloutLayer の `CalloutCornerRadius` - - FinalValueLayer の `AxisAnnotationBackgroundCornerRadius` - - CrosshairLayer の `XAxisAnnotationBackgroundCornerRadius` と `YAxisAnnotationBackgroundCornerRadius` -- さまざまな方法でスクロールバーを有効にするための新しい `HorizontalViewScrollbarMode` および `VerticalViewScrollbarMode` 列挙体。`IsVerticalZoomEnabled` または `IsHorizontalZoomEnabled` と組み合わせると、チャートをナビゲートするための軸に沿ったスクロールバーを、常設またはフェードインおよびフェードアウトすることができます。 -- 新しい `FavorLabellingScaleEnd` は、軸がスケールの最後にラベルを表示することを優先するかどうかを決定します。数値軸 (`NumericXAxis`、`NumericYAxis`、`PercentChangeAxis` など) とのみ互換性があります。 -- 新しい `IsSplineShapePartOfRange` は、軸に要求された軸範囲にスプライン形状を含めるかどうかを決定します。 -- 新しい `XAxisMaximumGap` は、`XAxisGap` を使用するときにプロットされたシリーズの最大許容値を決定します。ギャップは、プロットされたシリーズの列またはバー間のスペースの量を決定します。 -- 新しい `XAxisMinimumGapSize` は、`XAxisGap` を使用するときに、プロットされたシリーズの最小許容ピクセルベース値を決定し、各カテゴリ間に常にある程度の間隔があることを保証します。 + - CalloutLayer の + - FinalValueLayer の + - CrosshairLayer の +- さまざまな方法でスクロールバーを有効にするための新しい および 列挙体。 または と組み合わせると、チャートをナビゲートするための軸に沿ったスクロールバーを、常設またはフェードインおよびフェードアウトすることができます。 +- 新しい は、軸がスケールの最後にラベルを表示することを優先するかどうかを決定します。数値軸 (、`PercentChangeAxis` など) とのみ互換性があります。 +- 新しい は、軸に要求された軸範囲にスプライン形状を含めるかどうかを決定します。 +- 新しい は、 を使用するときにプロットされたシリーズの最大許容値を決定します。ギャップは、プロットされたシリーズの列またはバー間のスペースの量を決定します。 +- 新しい は、 を使用するときに、プロットされたシリーズの最小許容ピクセルベース値を決定し、各カテゴリ間に常にある程度の間隔があることを保証します。 ### {PackageGrids} (データ グリッド) 新機能 - [行ページング](grids/data-grid/row-paging.md)を追加しました。これは、大量のデータセットを類似したコンテンツを持つ一連のページに分割するために使用されます。ページネーションを使用すると、データを設定された行数で表示することができ、ユーザーはスクロール バーを使用せずにデータを順次閲覧することができます。テーブル ページネーションの UI には通常、現在のページ、合計ページ、ユーザーがページをめくるためのクリック可能な [前へ] と [次へ] の矢印 / ボタンなどが含まれます。 -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **{PackageVerChanges-21-2.1}** @@ -959,7 +961,7 @@ Added significant improvements to default behaviors, and refined the Category Ch - Responsive layouts for horizontal label rotation based on browser / screen size. - Enhanced rendering for rounded labels on all platforms. - Added marker properties to StackedFragmentSeries. -- Added `ShouldPanOnMaximumZoom` property. +- Added property. - New Category Axis Properties: - ZoomMaximumCategoryRange - ZoomMaximumItemSpan @@ -980,32 +982,32 @@ Added significant improvements to default behaviors, and refined the Category Ch - GroupSortDescriptions -[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties`. These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +[Chart Aggregation](charts/features/chart-data-aggregations.md) will not work when using | . These properties on the chart are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ### {PackageGrids} (データ グリッド) -- Changed **{IgPrefix}Column** to `DataGridColumn` -- Changed **GridCellEventArgs** to `DataGridCellEventArgs` -- Changed **GridSelectionMode** to `DataGridSelectionMode` -- Changed **SummaryOperand** to `DataSourceSummaryOperand` +- Changed **{IgPrefix}Column** to +- Changed **GridCellEventArgs** to +- Changed **GridSelectionMode** to +- Changed **SummaryOperand** to ## データ グリッド ### {PackageInputs} (入力) -- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the `Legend`, but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. +- Added the highly-configurable [DataLegend](charts/features/chart-data-legend.md) component, which works much like the , but it shows values of series and provides many configuration properties for filtering series rows and values columns, styling and formatting values. - Added the highly-configurable [DataToolTip](charts/features/chart-data-tooltip.md) which displays values and titles of series as well as legend badges of series in a tooltip. This is now the default tooltip for all chart types. -- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the `IsTransitionInEnabled` property to true. From there, you can set the `TransitionInDuration` property to determine how long your animation should take to complete and the `TransitionInMode` to determine the type of animation that takes place. -- Added `AssigningCategoryStyle` event, is now available to all series in `DataChart`. This event is handled when you want to conditionally configure aspects of the series items such as `Fill` background-color and highlighting. -- New `AllowedPositions` enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. +- Added animation and transition-in support for Stacked Series. Animations can be enabled by setting the property to true. From there, you can set the property to determine how long your animation should take to complete and the to determine the type of animation that takes place. +- Added `AssigningCategoryStyle` event, is now available to all series in . This event is handled when you want to conditionally configure aspects of the series items such as background-color and highlighting. +- New enumeration for CalloutLayer. Used to limit where the callouts are to be placed within the chart. By default, the callouts are intelligently placed in the best place but this used to force for example `TopLeft`, `TopRight`, `BottomLeft` or `BottomRight`. - New corner radius properties added for Annotation Layers; used to round-out the corners of each of the callouts. Note, a corner radius has now been added by default. - - `CalloutCornerRadius` for CalloutLayer - - `AxisAnnotationBackgroundCornerRadius` for FinalValueLayer - - `XAxisAnnotationBackgroundCornerRadius` and `YAxisAnnotationBackgroundCornerRadius` for CrosshairLayer -- New `HorizontalViewScrollbarMode` and `VerticalViewScrollbarMode` enumeration to enable scrollbars in various ways. When paired with `IsVerticalZoomEnabled` or `IsHorizontalZoomEnabled`, you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. -- New `FavorLabellingScaleEnd`, determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. `NumericXAxis`, `NumericYAxis`, `PercentChangeAxis`). -- New `IsSplineShapePartOfRange` determines whether to include the spline shape in the axis range requested of the axis. -- New `XAxisMaximumGap`, determines the maximum allowed value for the plotted series when using `XAxisGap`. The gap determines the amount of space between columns or bars of plotted series. -- New `XAxisMinimumGapSize`, determines the minimum allowed pixel-based value for the plotted series when using `XAxisGap` to ensure there is always some spacing between each category. + - for CalloutLayer + - for FinalValueLayer + - and for CrosshairLayer +- New and enumeration to enable scrollbars in various ways. When paired with or , you'll be able to persist or fade-in and out the scrollbars along the axes to navigate the chart. +- New , determines whether the axis should favor emitting a label at the end of the scale. Only compatible with numeric axes (e.g. , , `PercentChangeAxis`). +- New determines whether to include the spline shape in the axis range requested of the axis. +- New , determines the maximum allowed value for the plotted series when using . The gap determines the amount of space between columns or bars of plotted series. +- New , determines the minimum allowed pixel-based value for the plotted series when using to ensure there is always some spacing between each category. ### 日付ピッカー @@ -1018,29 +1020,29 @@ Added significant improvements to default behaviors, and refined the Category Ch #### {PackageCharts} (チャート) このリリースでは、地理マップとすべてのチャート コンポーネントのビジュアル デザインと構成オプションにいくつかの改善と簡素化が導入されています。 -- `FinancialChart` と `CategoryChart` の `YAxisLabelLocation` プロパティのタイプを **AxisLabelLocation** から **YAxisLabelLocation** に変更しました。 -- `FinancialChart` の **AxisLabelLocation** から **XAxisLabelLocation** に `XAxisLabelLocation` プロパティのタイプを変更しました。 -- `CategoryChart` に `XAxisLabelLocation` プロパティを追加しました。 -- 凡例で `GeographicMap` の地理的なシリーズを表すためのサポートが追加されました。 -- `FinancialChart` と`CategoryChart` にデフォルトの十字線を追加しました。 -- `FinancialChart` と`CategoryChart` にデフォルトの十字線の注釈を追加しました。 -- `FinancialChart` にデフォルトで最終値の注釈を追加しました。 +- プロパティのタイプを **AxisLabelLocation** から **YAxisLabelLocation** に変更しました。 +- の **AxisLabelLocation** から **XAxisLabelLocation** に プロパティのタイプを変更しました。 +- プロパティを追加しました。 +- 凡例で の地理的なシリーズを表すためのサポートが追加されました。 +- にデフォルトの十字線を追加しました。 +- にデフォルトの十字線の注釈を追加しました。 +- にデフォルトで最終値の注釈を追加しました。 - カテゴリ チャートとファイナンシャル チャートに新しいプロパティを追加しました: - - 十字線をカスタマイズするための `CrosshairsLineThickness` およびその他のプロパティ - - 十字線の注釈をカスタマイズするための `CrosshairsAnnotationXAxisBackground` およびその他のプロパティ - - 最終値の注釈をカスタマイズするための `FinalValueAnnotationsBackground` およびその他のプロパティ - - シリーズ塗りつぶしの不透明度を変更できる `AreaFillOpacity` (エリア チャートなど) - - マーカーの厚さを変更できる `MarkerThickness` + - 十字線をカスタマイズするための およびその他のプロパティ + - 十字線の注釈をカスタマイズするための およびその他のプロパティ + - 最終値の注釈をカスタマイズするための およびその他のプロパティ + - シリーズ塗りつぶしの不透明度を変更できる (エリア チャートなど) + - マーカーの厚さを変更できる - カテゴリ チャート、ファイナンシャル チャート、データ チャート、および地理マップに新しいプロパティを追加しました。 - - 同じチャート内の複数のシリーズにどのマーカー タイプを割り当てることができる `MarkerAutomaticBehavior` - - 凡例で表されるすべてのシリーズのバッジの形状を設定するための `LegendItemBadgeShape` - - 凡例のすべてのシリーズにバッジの複雑さを設定するための `LegendItemBadgeMode` + - 同じチャート内の複数のシリーズにどのマーカー タイプを割り当てることができる + - 凡例で表されるすべてのシリーズのバッジの形状を設定するための + - 凡例のすべてのシリーズにバッジの複雑さを設定するための - データ チャートと地理マップのシリーズに新しいプロパティを追加しました。 - - 凡例で表される特定のシリーズにバッジの形状を設定するための `LegendItemBadgeShape` - - 凡例の特定のシリーズにバッジの複雑さを設定するための `LegendItemBadgeMode` + - 凡例で表される特定のシリーズにバッジの形状を設定するための + - 凡例の特定のシリーズにバッジの複雑さを設定するための - カテゴリ チャートとシリーズで、デフォルトの垂直十字線ストロークを#000000 から #BBBBBB に変更しました。 -- 同じチャートにプロットされたすべてのシリーズのマーカーの図形を円に変更しました。これは、チャートの `MarkerAutomaticBehavior` プロパティを `SmartIndexed` 列挙値に設定することで元に戻すことができます。 -- チャートの凡例のシリーズの簡略化された図形で、円、線、または四角のみを表示します。これは、チャートの `LegendItemBadgeMode` プロパティを `MatchSeries` 列挙値に設定することで元に戻すことができます。 +- 同じチャートにプロットされたすべてのシリーズのマーカーの図形を円に変更しました。これは、チャートの プロパティを `SmartIndexed` 列挙値に設定することで元に戻すことができます。 +- チャートの凡例のシリーズの簡略化された図形で、円、線、または四角のみを表示します。これは、チャートの プロパティを `MatchSeries` 列挙値に設定することで元に戻すことができます。 - アクセシビリティを向上させるために、すべてのチャートに表示されるシリーズとマーカーのカラー パレットを変更しました | 古いのブラシ/アウトライン | 新のアウトライン/ブラシ | @@ -1053,14 +1055,14 @@ Added significant improvements to default behaviors, and refined the Category Ch - Changed ValueChanged event to `SelectedValueChanged`. #### {PackageCharts} (チャート) -このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、`DataChart`、`CategoryChart`、および `FinancialChart`。 +このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、、および
## チャート凡例 -- バブル、ドーナツ、および円チャートで使用できる水平方向の `Orientation` プロパティを ItemLegend に追加しました。 -- `LegendHighlightingMode` プロパティの追加 - 凡例項目にホバーした時にシリーズのハイライト表示を有効にします。 +- バブル、ドーナツ、および円チャートで使用できる水平方向の プロパティを ItemLegend に追加しました。 +- プロパティの追加 - 凡例項目にホバーした時にシリーズのハイライト表示を有効にします。 ### {PackageMaps} (GeoMap) @@ -1080,11 +1082,11 @@ Added significant improvements to default behaviors, and refined the Category Ch ### {PackageGrids} (データ グリッド) -- `EditOnKeyPress`、(別名: Excel スタイルの編集) を追加し、入力するとすぐに編集を開始します。 -- `EditModeClickAction` プロパティを追加しました - デフォルトでは、編集モードに入るにはダブル クリックが必要です。これを `SingleClick` に設定して、新しいセルを選択するときに編集モードを実行できるようにすることができます。 -- `EnterKeyBehaviors` プロパティの追加 - 別名 Excel スタイル ナビゲーション (Enter 動作) - Enter キーの動作を制御します。たとえば、オプションは none、edit、move up、down、left、right です。 -- `EnterKeyBehaviorAfterEdit` プロパティの追加 - 編集モードでは、このプロパティは Enter キーが押されたときを制御します。例えば、オプションは (下、上、右、左のセルに移動) です。 -- `SelectAllRows` メソッドを追加しました。 +- 、(別名: Excel スタイルの編集) を追加し、入力するとすぐに編集を開始します。 +- プロパティを追加しました - デフォルトでは、編集モードに入るにはダブル クリックが必要です。これを `SingleClick` に設定して、新しいセルを選択するときに編集モードを実行できるようにすることができます。 +- プロパティの追加 - 別名 Excel スタイル ナビゲーション (Enter 動作) - Enter キーの動作を制御します。たとえば、オプションは none、edit、move up、down、left、right です。 +- プロパティの追加 - 編集モードでは、このプロパティは Enter キーが押されたときを制御します。例えば、オプションは (下、上、右、左のセルに移動) です。 +- メソッドを追加しました。 - 行範囲の選択を追加しました - `GridSelectionMode` プロパティを MultipleRow に設定すると、次の新しい機能が含まれるようになりました: - クリックしてドラッグし、行を選択します。 - SHIFT キーを押しながらクリックして、複数の行を選択します。 @@ -1097,15 +1099,15 @@ Added significant improvements to default behaviors, and refined the Category Ch ## {PackageInputs} (入力) ### 日付ピッカー -- `ShowTodayButton` - 現在の日付のボタンの表示を切り替えます。 -- `Label` - 日付値の上にラベルを追加します。 -- `Placeholder` プロパティ - 値が選択されていない場合にカスタム テキストを追加します。 -- `FormatString` - 入力日付文字列をカスタマイズします。(例: `yyyy-MM-dd`) -- `DateFormat` - 選択した日付を LongDate または ShortDate のどちらとして表示するかを指定します。 -- `FirstDayOfWeek` - 週の最初の曜日を指定します。 -- `FirstWeekOfYear` - 年の最初の週をいつ表示するかを指定します。例えば、最初の 1 週間、最初の 4 日間の週です。 -- `ShowWeekNumbers` - 週番号の表示を切り替えます。 -- `MinDate` & `MaxDate` - 使用可能の選択できる日付の範囲を指定する日付制限。 +- - 現在の日付のボタンの表示を切り替えます。 +- - 日付値の上にラベルを追加します。 +- プロパティ - 値が選択されていない場合にカスタム テキストを追加します。 +- - 入力日付文字列をカスタマイズします。(例: `yyyy-MM-dd`) +- - 選択した日付を LongDate または ShortDate のどちらとして表示するかを指定します。 +- - 週の最初の曜日を指定します。 +- - 年の最初の週をいつ表示するかを指定します。例えば、最初の 1 週間、最初の 4 日間の週です。 +- - 週番号の表示を切り替えます。 +- & - 使用可能の選択できる日付の範囲を指定する日付制限。 - アクセシビリティの追加 - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners @@ -1113,23 +1115,23 @@ Added significant improvements to default behaviors, and refined the Category Ch - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -1152,8 +1154,8 @@ for example: #### **{PackageVerChangedFields}** -- Added horizontal `Orientation` property to ItemLegend that can be used with Bubble, Donut, and Pie Chart -- Added `LegendHighlightingMode` property - Enables series highlighting when hovering over legend items +- Added horizontal property to ItemLegend that can be used with Bubble, Donut, and Pie Chart +- Added property - Enables series highlighting when hovering over legend items ### {PackageGrids} (データ グリッド) @@ -1167,11 +1169,11 @@ for example: ### **{PackageVerRenamedGrid}** -- Added `EditOnKeyPress` aka Excel-style Editing, instantly begin editing when typing. -- Added `EditModeClickAction` property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. -- Added `EnterKeyBehaviors` property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) -- Added `EnterKeyBehaviorAfterEdit` property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) -- Added `SelectAllRows` - method. +- Added aka Excel-style Editing, instantly begin editing when typing. +- Added property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. +- Added property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) +- Added property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) +- Added - method. - Added Row Range Selection - With `GridSelectionMode` property set to MultipleRow the following new functionality is now included: - Click and drag to select rows - SHIFT and click to select multiple rows. diff --git a/docs/xplat/src/content/jp/components/general-changelog-dv-wc.mdx b/docs/xplat/src/content/jp/components/general-changelog-dv-wc.mdx index 215a09c306..e1899d4f10 100644 --- a/docs/xplat/src/content/jp/components/general-changelog-dv-wc.mdx +++ b/docs/xplat/src/content/jp/components/general-changelog-dv-wc.mdx @@ -19,6 +19,8 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} 変更ログ @@ -195,7 +197,7 @@ Dropdown menus and dialogs are now using HTML Popover API to provide better posi #### 新しいコンポーネント -- `IgrChat` コンポーネントを追加しました。 +- `Chat` コンポーネントを追加しました。 - Adjusted the schema generation to account for more items to make it more likely to find valid values for properties. @@ -205,9 +207,9 @@ Dropdown menus and dialogs are now using HTML Popover API to provide better posi #### **{PackageVerChanges-25-1-SEP}** -In {ProductName}, you can now annotate the `DataChart` with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. +In {ProductName}, you can now annotate the with slice, strip, and point annotations at runtime using the new user annotations feature. This allows the end user to add more details to the plot such as calling out single important events such as company quarter reports by using the slice annotation or events that have a duration by using the strip annotation. You can also call out individual points on the plotted series by using the point annotation or any combination of these three. -This is directly integrated with the available tools of the `Toolbar`. +This is directly integrated with the available tools of the . {Platform} user-annotation-create @@ -215,8 +217,8 @@ This is directly integrated with the available tools of the `Toolbar`. Ability for axis annotations to automatically detect collisions and truncate to fit better. To enable this feature you must set the following properties: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### Azure マップ画像のサポート @@ -238,10 +240,10 @@ Ability for axis annotations to automatically detect collisions and truncate to ### 対応軸 -X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。`CompanionAxisEnabled` プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 +X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。 プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 ### RadialPieSeries インセット アウトライン -`RadialPieSeries` のアウトライン レンダリング方法を制御するために `UseInsetOutlines` プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 + のアウトライン レンダリング方法を制御するために プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 **重大な変更** @@ -252,7 +254,7 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 ```
-- `ChartMouseEventArgs` クラスの `PlotAreaPosition` プロパティと `ChartPosition` プロパティが逆になっている問題が修正されました。これにより、`PlotAreaPosition` と `ChartPosition` が返す値が変更されます。 +- クラスの プロパティと プロパティが逆になっている問題が修正されました。これにより、 が返す値が変更されます。 @@ -336,7 +338,7 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft - DataToolTipLayer、ItemToolTipLayer、CategoryToolTipLayer にスタイル設定用の新しいプロパティが追加されました: `ToolTipBackground`、`ToolTipBorderBrush`、および `ToolTipBorderThickness`。 -- DataLegend にスタイル設定用の新しいプロパティが追加されました: `ContentBackground`、`ContentBorderBrush`、および `ContentBorderThickness`。`ContentBorderBrush` と `ContentBorderThickness` はそれぞれ既定で transparent と 0 に設定されているため、境界線を表示するにはこれらのプロパティを設定する必要があります。 +- DataLegend にスタイル設定用の新しいプロパティが追加されました: 、および はそれぞれ既定で transparent と 0 に設定されているため、境界線を表示するにはこれらのプロパティを設定する必要があります。 #### IgcDataGrid @@ -348,7 +350,7 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft **Breaking Changes** -- A fix was made due to an issue where the `PlotAreaPosition` and `ChartPosition` properties on `ChartMouseEventArgs` class were reversed. This will change the values that `PlotAreaPosition` and `ChartPosition` return. +- A fix was made due to an issue where the and properties on class were reversed. This will change the values that and return. ### **{PackageVerChanges-25-1-AUG}** @@ -358,18 +360,18 @@ Explore some of the publicly available [Azure maps here](https://azure.microsoft [詳細はこちらをご参照ください](https://developer.mozilla.org/ja/docs/Web/CSS/:state) - フォーム関連カスタム要素の有効性の動作: 要素は `:user-invalid` を模倣しようとし、UI またはフォームの `requestSubmit()/reset()` 呼び出しを介して操作されない限り、無効スタイルは適用されません。 -- `SuffixText` -- `SuffixTextColor` +- +- - `SuffixTextFont` -- `SuffixIconName` -- `SuffixIconCollectionName` -- `SuffixIconStroke` -- `SuffixIconFill` -- `SuffixIconViewBoxLeft` -- `SuffixIconViewBoxTop` -- `SuffixIconViewBoxWidth` -- `SuffixIconViewBoxHeight` -- `TextDecoration` +- +- +- +- +- +- +- +- +- Please note that the maximum size available for the icons is 24x24. You can provide an icon that is larger or smaller than this, but you will need to configure the viewbox settings in order to properly scale it to fit in the 24x24 space so it is fully visible. @@ -410,11 +412,11 @@ Please note that the maximum size available for the icons is 24x24. You can prov - `igcChange` および `igcCancel` イベントの詳細では、基になるコンポーネントの `files` プロパティが返されるようになりました。 -- New properties added to the DataLegend to aid in styling: `ContentBackground`, `ContentBorderBrush`, and `ContentBorderThickness`. The `ContentBorderBrush` and `ContentBorderThickness` default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. +- New properties added to the DataLegend to aid in styling: , , and . The and default to transparent and 0 respectively, so in order to see these borders, you will need to set these properties. -- Added a new property to `ChartMouseEventArgs` called `WorldPosition` that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. +- Added a new property to called that provides the world relative position of the mouse. This position will be a value between 0 and 1 for both the X and Y axis within the axis space. -- Added `HighlightingFadeOpacity` to `SeriesViewer` and `DomainChart`. This allows you to configure the opacity applied to highlighted series. +- Added to and . This allows you to configure the opacity applied to highlighted series. - Expose `CalloutLabelUpdating` event for domain charts. @@ -497,14 +499,14 @@ For more details please visit: ### {PackageGrids} - **すべてのグリッド** - - `FilteringExpressionsTree` プロパティを使用して初期フィルタリングの適用が可能になりました。 + - プロパティを使用して初期フィルタリングの適用が可能になりました。 -- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose `LayoutMode` property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. +- The [Data Tooltip](charts/features/chart-data-tooltip.md) and [Data Legend](charts/features/chart-data-legend.md) expose property that you can use to layout the contents of the tooltip or legend in a table or vertical layout structure. -- The `DefaultInteraction` property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. +- The property of the charts has been updated to include a new enumeration - `DragSelect` in which the dragged preview Rect will select the points contained within. -- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an `OverlayText` property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. +- The [ValueOverlay and ValueLayer](charts/features/chart-overlays.md), in addition to the [Chart Data Annotations](charts/features/chart-data-annotations.md) listed above now expose an property that can be used to overlay additional annotation text in the plot area. These appearance of these annotations can be configured by using the many OverlayText-prefixed properties. For example, the `OverlayTextBrush` property will configure the color of the overlay text. - [Trendline Layer](charts/features/chart-trendlines.md) series type that allows you to apply a single trend line per trend line layer to a particular series. This allows the usage of multiple trend lines on a single series since you can have multiple [TrendlineLayer](charts/features/chart-overlays.md) series types in the chart. @@ -527,9 +529,9 @@ For more details please visit: ### 機能拡張 #### Toolbar -- `Toolbar` と `ToolPanel` に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての `ToolActionGroupHeader` アクションに適用されます。 -- タイトル テキストの水平方向の配置を制御する `TitleHorizontalAlignment` という新しいプロパティを `ToolAction` に追加しました。 -- `ToolActionSubPanel` に、パネル内の項目間の間隔を制御する `ItemSpacing` という新しいプロパティを追加しました。 +- に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての アクションに適用されます。 +- タイトル テキストの水平方向の配置を制御する という新しいプロパティを に追加しました。 +- に、パネル内の項目間の間隔を制御する という新しいプロパティを追加しました。 #### バグ修正 次の表は、このリリースの {ProductName} ツールセットに対して行われたバグ修正を示しています。 @@ -543,7 +545,7 @@ For more details please visit: ### **{PackageVerChanges-24-2-DEC}** - **All Grids** - - Allow applying initial filtering through `FilteringExpressionsTree` property + - Allow applying initial filtering through property ### {PackageCharts} @@ -555,16 +557,16 @@ For more details please visit: #### {PackageCharts} -- 新しい[データ円チャート](charts/types/data-pie-chart.md) - `DataPieChart` は円ャートを表示する新しいコンポーネントです。このコンポーネントは、`CategoryChart` と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、強調表示、アニメーション、凡例のサポートを可能にします。 +- 新しい[データ円チャート](charts/types/data-pie-chart.md) - は円ャートを表示する新しいコンポーネントです。このコンポーネントは、 と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、強調表示、アニメーション、凡例のサポートを可能にします。 ### {PackageGrids} - **すべてのグリッド** - 新しい `RowClick` イベントが追加されました。 -- `PivotGrid` - - `PivotDimension` に `sortable` プロパティが追加されました。 +- + - に `sortable` プロパティが追加されました。 - 水平レイアウトが追加されました。新しい `pivotUI` プロパティ内で `rowLayout` `horizontal` として有効にできます。 - - 水平レイアウトのみの行ディメンション サマリーが追加されました。`horizontalSummary` を **true** に設定することで、各 `PivotDimension` に対して有効にできます。 + - 水平レイアウトのみの行ディメンション サマリーが追加されました。`horizontalSummary` を **true** に設定することで、各 に対して有効にできます。 - 水平集計の位置を設定するための `horizontalSummariesPosition` プロパティを `pivotUI` に追加しました。 - 行ディメンションの行ヘッダーが追加されました。新しい `pivotUI` プロパティ内で `showHeaders` **true** として有効にできます。 - キーボード ナビゲーションで行ディメンションヘッダーや列ヘッダーから行ヘッダーへ移動できるようになりました。 @@ -572,20 +574,20 @@ For more details please visit: **重大な変更**: - **すべてのグリッド** - - `RowIsland` + - - `displayDensity` の非推奨のプロパティが削除されました。 - `actualColumns`、`contentColumns` プロパティの名前を、`actualColumnList` および `contentColumnList` に変更しました。すべての列を取得するには、`column` または `columnList` プロパティを使用してください。 - - `rowDelete` および `rowAdd` イベント引数タイプの名前を `RowDataCancelableEventArgs` に変更しました。 - - `contextMenu` イベント引数タイプの名前を `GridContextMenuEventArgs` に変更しました。 - - `GridEditEventArgs`、`GridEditDoneEventArgs`、`PinRowEventArgs` イベントの `rowID` および `primaryKey` プロパティが削除されました。代わりに `rowKey` を使用してください。 -- `PivotGrid` + - `rowDelete` および `rowAdd` イベント引数タイプの名前を に変更しました。 + - `contextMenu` イベント引数タイプの名前を に変更しました。 + - イベントの `rowID` および `primaryKey` プロパティが削除されました。代わりに `rowKey` を使用してください。 +- - `showPivotConfigurationUI` プロパティが削除されました。`pivotUI` を使用して、その中に新しい `showConfiguration` オプションを設定してください。 -- `Column` +- - `movable` プロパティが削除されました。グリッドの `moving` プロパティを使用してください。 - `columnChildren` プロパティが削除されました。代わりに `childColumns` を使用してください。 -- `ColumnGroup` +- - `children` プロパティが削除されました。代わりに `childColumns` を使用してください。 -- `Paginator` +- - `isFirstPageDisabled` および `isLastPageDisabled` プロパティが削除されました。代わりに、`isFirstPage` および `isLastPage` を使用してください。 ## **{PackageVerChanges-24-1-JUN}** @@ -594,30 +596,30 @@ For more details please visit: ### {PackageCommon} -- `Input`、`Textarea` - ユーザー入力を制限することなく検証ルールを適用できるように `ValidateOnly` を公開しました。 -- `Dropdown` - `PositionStrategy` プロパティは非推奨です。ドロップダウンは、ブラウザー ビューポートの最上位レイヤーにコンテナーをレンダリングするために `Popover` API を使用するようになったため、このプロパティは廃止されました。 -- `DockManager` - `SplitPane` の `IsMaximized` は非推奨です。分割ペイン レベルで isMaximized を true に設定しても、分割ペインはコンテナーとしてのみ機能し、最大化されて表示される実際のコンテンツがないため、実際の効果はありません。代わりに、`TabGroupPane` および/または `ContentPane` の `IsMaximized` プロパティを使用してください。 +- - ユーザー入力を制限することなく検証ルールを適用できるように を公開しました。 +- - プロパティは非推奨です。ドロップダウンは、ブラウザー ビューポートの最上位レイヤーにコンテナーをレンダリングするために `Popover` API を使用するようになったため、このプロパティは廃止されました。 +- - は非推奨です。分割ペイン レベルで isMaximized を true に設定しても、分割ペインはコンテナーとしてのみ機能し、最大化されて表示される実際のコンテンツがないため、実際の効果はありません。代わりに、 および/または プロパティを使用してください。 ## {PackageGrids} ### {PackageCharts} -- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。`GroupRowVisible` プロパティは、各シリーズのグループ化を切り替え、オプトインすると `DataLegendGroup` プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 +- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。 プロパティは、各シリーズのグループ化を切り替え、オプトインすると プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 ### {PackageGauges} -- `RadialGauge` - - ハイライト針の新しいラベル。`HighlightLabelText` と `HighlightLabelSnapsToNeedlePivot` および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 +- + - ハイライト針の新しいラベル。 および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 ## **{PackageVerChanges-23-2-MAR}** ### {PackageGrids} -- 新しい [`HierarchicalGrid`](grids/hierarchical-grid/overview.md) ンポーネント +- 新しい [](grids/hierarchical-grid/overview.md) ンポーネント -- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. +- New [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to plot slices similar to a pie chart, a type of data visualization where data points are represented as segments within a circular graph. -- `Toolbar` +- - New ToolActionCheckboxList A new CheckboxList ToolAction that displays a collection of items with checkboxes for selecting. A grid inside ToolAction CheckboxList grows in height up to 5 items, then a scrollbar is displayed. @@ -632,35 +634,35 @@ For more details please visit: ### {PackageCharts} -- `InitialFilter` プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 +- プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 - `RadialChart` - 新しいラベル モード - `CategoryAngleAxis` は、ラベルの位置をさらに構成できる `LabelMode` プロパティを公開するようになりました。これにより、`Center` 列挙型を選択してデフォルト モードを切り替えることも、ラベルを円形のプロット領域に近づける新しいモード `ClosestPoint` を使用することもできます。 + は、ラベルの位置をさらに構成できる プロパティを公開するようになりました。これにより、`Center` 列挙型を選択してデフォルト モードを切り替えることも、ラベルを円形のプロット領域に近づける新しいモード `ClosestPoint` を使用することもできます。 ## {PackageGauges} ### **{PackageVerChanges-23-2-JAN}** -- `Input`, `Textarea` - exposed `ValidateOnly` to enable validation rules being enforced without restricting user input. -- `Dropdown` - `PositionStrategy` property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. -- `DockManager` - `SplitPane` `IsMaximized` is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the `IsMaximized` property of `TabGroupPane` and/or `ContentPane` instead. +- , - exposed to enable validation rules being enforced without restricting user input. +- - property is deprecated. The dropdown now uses the `Popover` API to render its container in the top layer of the browser viewport, making the property obsolete. +- - is deprecated. Having isMaximized set to true on a split pane level has no real effect as split panes serve as containers only, meaning they have no actual content to be shown maximized. Use the property of and/or instead. ### {PackageCharts} -- [チャートのハイライト表示フィルター](charts/features/chart-highlight-filter.md) - `CategoryChart` と `DataChart` は、データのサブセットの内外でハイライト表示およびアニメーション化する方法を公開するようになりました。このハイライトの表示はシリーズのタイプによって異なります。列およびエリア シリーズの場合、サブセットはデータの合計セットの上に表示され、サブセットはシリーズの実際のブラシによって色付けされ、合計セットは不透明度を下げます。折れ線シリーズの場合、サブセットは点線で表示されます。 +- [チャートのハイライト表示フィルター](charts/features/chart-highlight-filter.md) - は、データのサブセットの内外でハイライト表示およびアニメーション化する方法を公開するようになりました。このハイライトの表示はシリーズのタイプによって異なります。列およびエリア シリーズの場合、サブセットはデータの合計セットの上に表示され、サブセットはシリーズの実際のブラシによって色付けされ、合計セットは不透明度を下げます。折れ線シリーズの場合、サブセットは点線で表示されます。 ### **{PackageVerChanges-23-2-DEC}** -- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property `GroupRowVisible` toggles grouping with each series opting in can assign group text via the `DataLegendGroup` property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. +- [Data Legend Grouping](charts/features/chart-data-legend.md#{PlatformLower}-data-legend-grouping) & [Data Tooltip Grouping](charts/features/chart-data-tooltip.md#{PlatformLower}-data-tooltip-grouping-for-data-chart) - New grouping feature added. The property toggles grouping with each series opting in can assign group text via the property. If the same value is applied to more than one series then they will appear grouped. Useful for large datasets that need to be categorized and organized for all users. -- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for `CategoryChart` and `DataChart`. Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and `SelectedSeriesItems` are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. +- [Chart Selection](charts/features/chart-data-selection.md) - New series selection styling. This is adopted broadly across all category, financial and radial series for and . Series can be clicked and shown a different color, brightened or faded, and focus outlines. Manage which items are effected through individual series or entire data item. Multiple series and markers are supported. Useful for illustrating various differences or similarities between values of a particular data item. Also `SelectedSeriesItemsChanged` event and are available for additional help to build out robust business requirements surrounding other actions that can take place within an application such as a popup or other screen with data analysis based on the selection. -- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the `DataChart`, to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. +- [Proportional Category Angle Axis](charts/types/radial-chart.md) - New axes for the Radial Pie Series in the , to enable creating pie charts in the allowing robust visualizations using all the added power of the data chart. -- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a `HighlightingMode` property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the `HighlightingTransitionDuration` property. +- [Treemap Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-highlighting) - Now exposes a property that allows you to configure the mouse-over highlighting of the items in the tree map. This property takes two options: `Brighten` where the highlight will apply to the item that you hover the mouse over only, and `FadeOthers` where the highlight of the hovered item will remain the same, but everything else will fade out. This highlight is animated, and can be controlled using the property. -- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new `HighlightedItemsSource`. Can be toggled via `HighlightedValuesDisplayMode` and styled via `FillBrushes`. +- [Treemap Percent-based Highlighting](charts/types/treemap-chart.md#{PlatformLower}-treemap-percent-based-highlighting) - New percent-based highlighting, allowing nodes to represent progress or subset of a collection. The appearance is shown as a fill-in of its backcolor up to a specific value either by a member on your data item or by supplying a new . Can be toggled via and styled via `FillBrushes`. -- `Toolbar` - New `IsHighlighted` option for ToolAction for outlining a border around specific tools of choice. +- - New option for ToolAction for outlining a border around specific tools of choice. ### {PackageGrids} @@ -673,28 +675,28 @@ For more details please visit: - [Toolbar](menus/toolbar.md) - クリップボードを介してチャートを画像に保存するための保存ツール アクションが追加されました。 - - ツールバーの `Orientation` プロパティを介して垂直方向が追加されました。デフォルトでは、ツールバーは水平方向ですが、ツールバーを垂直方向に表示できるようになり、ツールが左右にポップアップ表示されます。 + - ツールバーの プロパティを介して垂直方向が追加されました。デフォルトでは、ツールバーは水平方向ですが、ツールバーを垂直方向に表示できるようになり、ツールが左右にポップアップ表示されます。 - ツールバーの `renderImageFromText` メソッドを介してカスタム SVG アイコンのサポートが追加され、カスタム ツールの作成がさらに強化されました。 ### **{PackageVerChanges-23-1}** -- New Data Filtering via the `InitialFilter` property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. +- New Data Filtering via the property. Apply filter expressions to filter the chart data to a subset of records. Can be used for drill down large data. - `RadialChart` - New Label Mode - The `CategoryAngleAxis` for the now exposes a `LabelMode` property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. + The for the now exposes a property that allows you to further configure the location of the labels. This allows you to toggle between the default mode by selecting the `Center` enum, or use the new mode, `ClosestPoint`, which will bring the labels closer to the circular plot area. ### {PackageLayouts} -- [Toolbar](menus/toolbar.md) - このコンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、`DataChart` または `CategoryChart` コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 +- [Toolbar](menus/toolbar.md) - このコンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、 または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 ## {PackageCharts} ### **{PackageVerChanges-22-2.2}** -- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The `CategoryChart` and `DataChart` now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. +- [Chart Highlight Filter](charts/features/chart-highlight-filter.md) - The and now expose a way to highlight and animate in and out of a subset of data. The display of this highlight depends on the series type. For column and area series, the subset will be shown on top of the total set of data where the subset will be colored by the actual brush of the series, and the total set will have a reduced opacity. For line series, the subset will be shown as a dotted line. ## {PackageGrids} @@ -703,8 +705,8 @@ For more details please visit: - `IgcDateTimeInput` で StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date)、DateTimeInputDatePart ではなく DatePart に切り詰められるようになりました。 - `IgcRadio` および `IgcRadioGroup` で、無効な状態のスタイルとともにコンポーネントの検証が追加されました。 - `IgcMask` - マスク パターン リテラルをエスケープする機能が追加されました。 -- `IgcBadge` - バッジの形状を制御する `Shape` プロパティが追加され、`Square` または `Rounded` のいずれかになります。デフォルトでは、バッジの形状は Rounded です。 -- `IgcAvatar` - `RoundShape` プロパティは非推奨になり、将来のバージョンで削除される予定です。ユーザーは、新しく追加された `Shape` 属性によってアバターの形状を制御できます。形状属性は、`Square`、`Rounded`、または `Circle` です。アバターの図形はデフォルトで `Square` です。 +- `IgcBadge` - バッジの形状を制御する プロパティが追加され、 または `Rounded` のいずれかになります。デフォルトでは、バッジの形状は Rounded です。 +- `IgcAvatar` - `RoundShape` プロパティは非推奨になり、将来のバージョンで削除される予定です。ユーザーは、新しく追加された 属性によってアバターの形状を制御できます。形状属性は、、`Rounded`、または です。アバターの図形はデフォルトで です。 ## **{PackageVerChanges-22-2.1}** @@ -721,16 +723,16 @@ For more details please visit: - 新しい [Grid](grids/data-grid.md) コンポーネント。 - 新しい [Tree Grid](grids/tree-grid/overview.md) コンポーネント。 - `DataGrid`: - - **{IgPrefix}Column** を `DataGridColumn` に変更しました。 - - **GridCellEventArgs** を `DataGridCellEventArgs` に変更しました。 - - **GridSelectionMode** を `DataGridSelectionMode` に変更しました。 + - **{IgPrefix}Column** を に変更しました。 + - **GridCellEventArgs** を に変更しました。 + - **GridSelectionMode** を に変更しました。 - **SummaryOperand** を `DataSourceSummaryOperand` に変更しました。 ### **{PackageVerChanges-22-1}** -- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the `ValueLayer` is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the `CategoryChart` and `FinancialChart` by adding to the new `ValueLines` collection. +- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - A new series type named the is now exposed which can allow you to render an overlay for different focal points of the plotted data such as Maximum, Minimum, and Average. This is applied to the and by adding to the new collection. -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## {PackageGrids} @@ -738,22 +740,22 @@ For more details please visit: ### {PackageCharts} -- 高度に構成可能な [DataLegend](charts/features/chart-data-legend.md) コンポーネントを追加しました。これは、`Legend` とよく似ていますが、シリーズの値を表示し、シリーズの行と値の列をフィルタリングし、値のスタイルとフォーマットを行うための多くの構成プロパティを提供します。 +- 高度に構成可能な [DataLegend](charts/features/chart-data-legend.md) コンポーネントを追加しました。これは、 とよく似ていますが、シリーズの値を表示し、シリーズの行と値の列をフィルタリングし、値のスタイルとフォーマットを行うための多くの構成プロパティを提供します。 - 高度に構成可能な [DataToolTip](charts/features/chart-data-tooltip.md) が追加されました。これは、シリーズの値とタイトル、およびシリーズの凡例バッジをツールチップに表示します。これは、すべてのチャート タイプのデフォルトのツールチップになりました。 -- 積層シリーズのアニメーションとトランジションインのサポートが追加されました。`IsTransitionInEnabled` プロパティを true に設定すると、アニメーションを有効にできます。そこから、`TransitionInDuration` プロパティを設定してアニメーションが完了するまでの時間を決定し、`TransitionInMode` でアニメーションのタイプを決定できます。 -- 追加された `AssigningCategoryStyle` イベントは、`DataChart` のすべてのシリーズで利用できるようになりました。このイベントは、背景色の `Fill` やハイライト表示など、シリーズ項目の外観を条件付きで構成する場合に処理されます。 -- CalloutLayer の新しい `AllowedPositions` 列挙体。チャート内のどこにコールアウトを配置するかを制限するために使用されます。デフォルトでは、コールアウトは最適な場所に配置されますが、これは `TopLeft`、`TopRight`、`BottomLeft`、または `BottomRight` を強制するために使用されます。 +- 積層シリーズのアニメーションとトランジションインのサポートが追加されました。 プロパティを true に設定すると、アニメーションを有効にできます。そこから、 プロパティを設定してアニメーションが完了するまでの時間を決定し、 でアニメーションのタイプを決定できます。 +- 追加された `AssigningCategoryStyle` イベントは、 のすべてのシリーズで利用できるようになりました。このイベントは、背景色の やハイライト表示など、シリーズ項目の外観を条件付きで構成する場合に処理されます。 +- CalloutLayer の新しい 列挙体。チャート内のどこにコールアウトを配置するかを制限するために使用されます。デフォルトでは、コールアウトは最適な場所に配置されますが、これは `TopLeft`、`TopRight`、`BottomLeft`、または `BottomRight` を強制するために使用されます。 - 注釈レイヤーに追加された新しいコーナー半径プロパティ。各コールアウトのコーナーを丸めるために使用されます。コーナー半径がデフォルトで追加されていることに注意してください。 - - CalloutLayer の `CalloutCornerRadius` - - FinalValueLayer の `AxisAnnotationBackgroundCornerRadius` - - CrosshairLayer の `XAxisAnnotationBackgroundCornerRadius` と `YAxisAnnotationBackgroundCornerRadius` -- さまざまな方法でスクロールバーを有効にするための新しい `HorizontalViewScrollbarMode` および `VerticalViewScrollbarMode` 列挙体。`IsVerticalZoomEnabled` または `IsHorizontalZoomEnabled` と組み合わせると、チャートをナビゲートするための軸に沿ったスクロールバーを、常設またはフェードインおよびフェードアウトすることができます。 -- 新しい `FavorLabellingScaleEnd` は、軸がスケールの最後にラベルを表示することを優先するかどうかを決定します。数値軸 (`NumericXAxis`、`NumericYAxis`、`PercentChangeAxis` など) とのみ互換性があります。 -- 新しい `IsSplineShapePartOfRange` は、軸に要求された軸範囲にスプライン形状を含めるかどうかを決定します。 -- 新しい `XAxisMaximumGap` は、`XAxisGap` を使用するときにプロットされたシリーズの最大許容値を決定します。ギャップは、プロットされたシリーズの列またはバー間のスペースの量を決定します。 -- 新しい `XAxisMinimumGapSize` は、`XAxisGap` を使用するときに、プロットされたシリーズの最小許容ピクセルベース値を決定し、各カテゴリ間に常にある程度の間隔があることを保証します。 + - CalloutLayer の + - FinalValueLayer の + - CrosshairLayer の +- さまざまな方法でスクロールバーを有効にするための新しい および 列挙体。 または と組み合わせると、チャートをナビゲートするための軸に沿ったスクロールバーを、常設またはフェードインおよびフェードアウトすることができます。 +- 新しい は、軸がスケールの最後にラベルを表示することを優先するかどうかを決定します。数値軸 (、`PercentChangeAxis` など) とのみ互換性があります。 +- 新しい は、軸に要求された軸範囲にスプライン形状を含めるかどうかを決定します。 +- 新しい は、 を使用するときにプロットされたシリーズの最大許容値を決定します。ギャップは、プロットされたシリーズの列またはバー間のスペースの量を決定します。 +- 新しい は、 を使用するときに、プロットされたシリーズの最小許容ピクセルベース値を決定し、各カテゴリ間に常にある程度の間隔があることを保証します。 -- `PivotGrid`: The `IgcPivotDateDimension` properties `InBaseDimension` and `InOption` have been deprecated and renamed to `BaseDimension` and `Options` respectively. +- : The `IgcPivotDateDimension` properties `InBaseDimension` and `InOption` have been deprecated and renamed to `BaseDimension` and `Options` respectively. ### **{PackageVerChanges-21-2.1}** @@ -761,8 +763,8 @@ For more details please visit: - `IgcDateTimeInput`, the StepDownAsync(DateTimeInputDatePart.Date, SpinDelta.Date) is now trimmed down to DatePart instead of DateTimeInputDatePart - `IgcRadio` and `IgcRadioGroup`, added component validation along with styles for invalid state - `IgcMask`, added the capability to escape mask pattern literals. -- `IgcBadge` added a `Shape` property that controls the shape of the badge and can be either `Square` or `Rounded`. The default shape of the badge is rounded. -- `IgcAvatar`, the `RoundShape` property has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly added `Shape` attribute that can be `Square`, `Rounded` or `Circle`. The default shape of the avatar is `Square`. +- `IgcBadge` added a property that controls the shape of the badge and can be either or `Rounded`. The default shape of the badge is rounded. +- `IgcAvatar`, the `RoundShape` property has been deprecated and will be removed in a future version. Users can control the shape of the avatar by the newly added attribute that can be , `Rounded` or . The default shape of the avatar is . ## {PackageGrids} @@ -795,29 +797,29 @@ For more details please visit: このリリースでは、地理マップとすべてのチャート コンポーネントのビジュアル デザインと構成オプションにいくつかの改善と簡素化が導入されています。 -- `FinancialChart` と `CategoryChart` の `YAxisLabelLocation` プロパティのタイプを **AxisLabelLocation** から **YAxisLabelLocation** に変更しました。 -- `FinancialChart` の `XAxisLabelLocation` プロパティのタイプを **AxisLabelLocation** から **XAxisLabelLocation** に変更しました。 -- `CategoryChart` に `XAxisLabelLocation` プロパティを追加しました。 -- 凡例で `GeographicMap` の地理的なシリーズを表すためのサポートが追加されました。 -- `FinancialChart` と `CategoryChart` にデフォルトの十字線を追加しました。 -- `FinancialChart` と `CategoryChart` にデフォルトの十字線の注釈を追加しました。 -- `FinancialChart` にデフォルトで最終値の注釈を追加しました +- プロパティのタイプを **AxisLabelLocation** から **YAxisLabelLocation** に変更しました。 +- プロパティのタイプを **AxisLabelLocation** から **XAxisLabelLocation** に変更しました。 +- プロパティを追加しました。 +- 凡例で の地理的なシリーズを表すためのサポートが追加されました。 +- にデフォルトの十字線を追加しました。 +- にデフォルトの十字線の注釈を追加しました。 +- にデフォルトで最終値の注釈を追加しました - カテゴリ チャートとファイナンシャル チャートに新しいプロパティを追加しました: - - 十字線をカスタマイズするための `CrosshairsLineThickness` およびその他のプロパティ。 - - 十字線の注釈をカスタマイズするための `CrosshairsAnnotationXAxisBackground` およびその他のプロパティ。 - - 最終値の注釈をカスタマイズするための `FinalValueAnnotationsBackground` およびその他のプロパティ。 - - シリーズ塗りつぶしの不透明度を変更できる `AreaFillOpacity` (エリア チャートなど) - - マーカーの厚さを変更できる `MarkerThickness` + - 十字線をカスタマイズするための およびその他のプロパティ。 + - 十字線の注釈をカスタマイズするための およびその他のプロパティ。 + - 最終値の注釈をカスタマイズするための およびその他のプロパティ。 + - シリーズ塗りつぶしの不透明度を変更できる (エリア チャートなど) + - マーカーの厚さを変更できる - カテゴリ チャート、ファイナンシャル チャート、データ チャート、および地理マップに新しいプロパティを追加しました。 - - 同じチャート内の複数のシリーズにどのマーカー タイプを割り当てることができる `MarkerAutomaticBehavior` - - 凡例で表されるすべてのシリーズのバッジの形状を設定するための `LegendItemBadgeShape` - - 凡例のすべてのシリーズにバッジの複雑さを設定するための `LegendItemBadgeMode` + - 同じチャート内の複数のシリーズにどのマーカー タイプを割り当てることができる + - 凡例で表されるすべてのシリーズのバッジの形状を設定するための + - 凡例のすべてのシリーズにバッジの複雑さを設定するための - データ チャートと地理マップのシリーズに新しいプロパティを追加しました。 - - 凡例で表される特定のシリーズにバッジの形状を設定するための `LegendItemBadgeShape` - - 凡例の特定のシリーズにバッジの複雑さを設定するための `LegendItemBadgeMode` + - 凡例で表される特定のシリーズにバッジの形状を設定するための + - 凡例の特定のシリーズにバッジの複雑さを設定するための - カテゴリ チャートとシリーズで、デフォルトの垂直十字線ストロークを #000000 から #BBBBBB に変更しました。 -- 同じチャートにプロットされたすべてのシリーズのマーカーの図形を円に変更しました。これは、チャートの `MarkerAutomaticBehavior` プロパティを `SmartIndexed` 列挙値に設定することで元に戻すことができます。 -- チャートの凡例のシリーズの簡略化された図形で、円、線、または四角のみを表示します。これは、チャートの `LegendItemBadgeMode` プロパティを `MatchSeries` 列挙値に設定することで元に戻すことができます。 +- 同じチャートにプロットされたすべてのシリーズのマーカーの図形を円に変更しました。これは、チャートの プロパティを `SmartIndexed` 列挙値に設定することで元に戻すことができます。 +- チャートの凡例のシリーズの簡略化された図形で、円、線、または四角のみを表示します。これは、チャートの プロパティを `MatchSeries` 列挙値に設定することで元に戻すことができます。 - アクセシビリティを向上させるために、すべてのチャートに表示されるシリーズとマーカーのカラー パレットを変更しました | 古いのブラシ/アウトライン | 新のアウトライン/ブラシ | @@ -831,10 +833,10 @@ For more details please visit: - `DataGrid`: - `EditOnKeyPress` を追加しました - 別名 Excel スタイルの編集。入力するとすぐに編集を開始します。 - - `EditModeClickAction` プロパティを追加しました - デフォルトでは、編集モードに入るにはダブル クリックが必要です。これを `SingleClick` に設定して、新しいセルを選択するときに編集モードを実行できるようにすることができます。 - - `EnterKeyBehaviors` プロパティ (別名 Excel スタイルのナビゲーション (Enter 動作)) を追加して、Enter キーの動作を制御します。例えば、オプションは (なし、編集、上、下、左、右に移動) です。 - - `EnterKeyBehaviorAfterEdit` プロパティを追加しました - 編集モードでは、このプロパティは Enter キーが押されたときを制御します。例えば、オプションは (下、上、右、左のセルに移動) です。 - - `SelectAllRows` メソッドを追加しました。 + - プロパティを追加しました - デフォルトでは、編集モードに入るにはダブル クリックが必要です。これを に設定して、新しいセルを選択するときに編集モードを実行できるようにすることができます。 + - プロパティ (別名 Excel スタイルのナビゲーション (Enter 動作)) を追加して、Enter キーの動作を制御します。例えば、オプションは (なし、編集、上、下、左、右に移動) です。 + - プロパティを追加しました - 編集モードでは、このプロパティは Enter キーが押されたときを制御します。例えば、オプションは (下、上、右、左のセルに移動) です。 + - メソッドを追加しました。 - 行範囲の選択を追加しました - `GridSelectionMode` プロパティを MultipleRow に設定すると、次の新しい機能が含まれるようになりました: - クリックしてドラッグし、行を選択します。 - SHIFT キーを押しながらクリックして、複数の行を選択します。 @@ -845,45 +847,45 @@ For more details please visit: ### {PackageCharts} - Date Picker: - - `ShowTodayButton` - 現在の日付のボタンの表示を切り替えます。 - - `Label` - 日付値の上にラベルを追加します。 - - `Placeholder` プロパティ - 値が選択されていない場合にカスタム テキストを追加します。 - - `FormatString` - 入力日付文字列をカスタマイズします。(例: `yyyy-MM-dd`) - - `DateFormat` - 選択した日付を LongDate または ShortDate のどちらとして表示するかを指定します。 - - `FirstDayOfWeek` - 週の最初の曜日を指定します。 - - `FirstWeekOfYear` - 年の最初の週をいつ表示するかを指定します。例えば、最初の 1 週間、最初の 4 日間の週です。 - - `ShowWeekNumbers` - 週番号の表示を切り替えます。 - - `MinDate` & `MaxDate` - 使用可能の選択できる日付の範囲を指定する日付制限。 + - - 現在の日付のボタンの表示を切り替えます。 + - - 日付値の上にラベルを追加します。 + - プロパティ - 値が選択されていない場合にカスタム テキストを追加します。 + - - 入力日付文字列をカスタマイズします。(例: `yyyy-MM-dd`) + - - 選択した日付を LongDate または ShortDate のどちらとして表示するかを指定します。 + - - 週の最初の曜日を指定します。 + - - 年の最初の週をいつ表示するかを指定します。例えば、最初の 1 週間、最初の 4 日間の週です。 + - - 週番号の表示を切り替えます。 + - & - 使用可能の選択できる日付の範囲を指定する日付制限。 - アクセシビリティの追加 ## {PackageMaps} ### {PackageCharts} -このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、`DataChart`、`CategoryChart`、および `FinancialChart`。 +このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、、および 。 - 棒/縦棒/ウォーターフォール シリーズを、角丸ではなく角が四角になるように変更しました。 - heat min プロパティの 散布高密度シリーズの色を #8a5bb1 から #000000 に変更しました。 - heat max プロパティの 散布高密度シリーズの色を #ee5879 から #ee5879 に変更しました。 - ファイナンシャル/ウォーターフォール シリーズの `NegativeBrush` および `NegativeOutline` プロパティを #C62828 から #ee5879 に変更しました。 - マーカーの厚さを 1 pxから 2 pxに変更しました。 -- `PointSeries`、`BubbleSeries`、`ScatterSeries`、`PolarScatterSeries` のマーカーのアウトラインに一致するようにマーカーの塗りつぶしを変更しました。`MarkerFillMode` プロパティを Normal に設定すると、この変更を元に戻すことができます。 -- `TimeXAxis` および `OrdinalTimeXAxis` のラベリングを圧縮しました。 +- のマーカーのアウトラインに一致するようにマーカーの塗りつぶしを変更しました。 プロパティを Normal に設定すると、この変更を元に戻すことができます。 +- および のラベリングを圧縮しました。 - 新しいマーカー プロパティ: - - series.`MarkerFillMode` - マーカーがアウトラインに依存するように、`MatchMarkerOutline` に設定できます。 - - series.`MarkerFillOpacity` - 0〜1 の値に設定できます。 - - series.`MarkerOutlineMode` - マーカーのアウトラインが塗りブラシの色に依存するように、`MatchMarkerBrush` に設定できます。 + - series. - マーカーがアウトラインに依存するように、`MatchMarkerOutline` に設定できます。 + - series. - 0〜1 の値に設定できます。 + - series. - マーカーのアウトラインが塗りブラシの色に依存するように、`MatchMarkerBrush` に設定できます。 - 新シリーズ プロパティ: - - series.`OutlineMode` - シリーズ アウトラインの表示を切り替えるように設定できます。データ チャートの場合、プロパティはシリーズ上にあることに注意してください。 -- チャートがデフォルトのズーム レベルにあるときにビューポートに導入されるブリード オーバー領域を定義する新しいチャート プロパティを追加しました。一般的な使用例では、軸と最初/最後のデータ ポイントの間にスペースを提供します。以下にリストされている `ComputedPlotAreaMarginMode` は、マーカーが有効になっているときに自動的にマージンを設定することに注意してください。その他は、厚さを表す `Double` を指定するように設計されており、PlotAreaMarginLeft などがチャートの 4 辺すべてにスペースを調整します。 - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - シリーズ アウトラインの表示を切り替えるように設定できます。データ チャートの場合、プロパティはシリーズ上にあることに注意してください。 +- チャートがデフォルトのズーム レベルにあるときにビューポートに導入されるブリード オーバー領域を定義する新しいチャート プロパティを追加しました。一般的な使用例では、軸と最初/最後のデータ ポイントの間にスペースを提供します。以下にリストされている は、マーカーが有効になっているときに自動的にマージンを設定することに注意してください。その他は、厚さを表す `Double` を指定するように設計されており、PlotAreaMarginLeft などがチャートの 4 辺すべてにスペースを調整します。 + - chart. + - chart. + - chart. + - chart. + - chart. - 新しいハイライト表示プロパティ: - - chart.`HighlightingMode` - ホバーされたシリーズとホバーされていないシリーズをフェードまたは明るくするかを設定します。 - - chart.`HighlightingBehavior` - 真上または最も近い項目など、マウスの位置に応じてシリーズをハイライト表示するかどうかを設定します。 + - chart. - ホバーされたシリーズとホバーされていないシリーズをフェードまたは明るくするかを設定します。 + - chart. - 真上または最も近い項目など、マウスの位置に応じてシリーズをハイライト表示するかどうかを設定します。 - 以前のリリースでは、ハイライト表示はホバー時にフェードするように制限されていたことに注意してください。 - 積層型、散布、極座標、ラジアル、およびシェイプ シリーズにハイライト表示を追加しました。 - 積層型、散布、極座標、ラジアル、およびシェイプ シリーズに注釈レイヤーを追加しました。 @@ -895,8 +897,8 @@ For more details please visit: ### チャート凡例 -- バブル、ドーナツ、および円チャートで使用できる水平方向の `Orientation` プロパティを ItemLegend に追加しました -- `LegendHighlightingMode` プロパティの追加 - 凡例項目にホバーした時にシリーズのハイライト表示を有効にします +- バブル、ドーナツ、および円チャートで使用できる水平方向の プロパティを ItemLegend に追加しました +- プロパティの追加 - 凡例項目にホバーした時にシリーズのハイライト表示を有効にします ## **{PackageVerChangedFields}** @@ -913,29 +915,29 @@ For more details please visit: This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -949,10 +951,10 @@ This release introduces a few improvements and simplifications to visual design - `DataGrid`: - Added `EditOnKeyPress` aka Excel-style Editing, instantly begin editing when typing. - - Added `EditModeClickAction` property - By default double-clicking is required to enter edit mode. This can be set to `SingleClick` to allow for edit mode to occur when selecting a new cell. - - Added `EnterKeyBehaviors` property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) - - Added `EnterKeyBehaviorAfterEdit` property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) - - Added `SelectAllRows` - method. + - Added property - By default double-clicking is required to enter edit mode. This can be set to to allow for edit mode to occur when selecting a new cell. + - Added property - aka Excel-style Navigation (Enter Behavior) – controls the behavior of the enter key, e.g. Options are (none, edit, move up, down, left, right) + - Added property - While in edit-mode, this property controls when enter is pressed, e.g. Options are (moves to the cell below, above, right, left) + - Added - method. - Added Row Range Selection - With `GridSelectionMode` property set to MultipleRow the following new functionality is now included: - Click and drag to select rows - SHIFT and click to select multiple rows. @@ -979,30 +981,30 @@ These features are CTP ### **{PackageCommonVerChanges-5.1.0}** -This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. `DataChart`, `CategoryChart`, and `FinancialChart`. +This release introduces several new and improved visual design and configuration options for all of the chart components, e.g. , , and . - Changed Bar/Column/Waterfall series to have square corners instead of rounded corners - Changed Scatter High Density series’ colors for heat min property from #8a5bb1 to #000000 - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -1187,159 +1189,159 @@ import { IgcLiveGridComponent } from 'igniteui-webcomponents-data-grids/ES5/igc- ### 非推奨 #### 修正 -- `Input`、`Textarea`- 値に `undefined` を渡すと、基になる入力値が undefined に設定されます。 -- `MaskInput` - フォームの `reset` の呼び出し後、基になる入力値とプレースホルダーの状態が正しく更新されます。 -- `Tree` - 項目 `indicator` CSS パーツに `--ig-size` を設定すると、アイコンのサイズが変更されるようになりました。 -- `DateTimeInput` - 特定のシナリオで `igcChange` が二重に発行されます。 -- `NavDrawer` - ミニ バリアントは、開いた状態でない場合、最初は描画されません。 -- `Combo`: +- - 値に `undefined` を渡すと、基になる入力値が undefined に設定されます。 +- - フォームの `reset` の呼び出し後、基になる入力値とプレースホルダーの状態が正しく更新されます。 +- - 項目 `indicator` CSS パーツに `--ig-size` を設定すると、アイコンのサイズが変更されるようになりました。 +- - 特定のシナリオで `igcChange` が二重に発行されます。 +- - ミニ バリアントは、開いた状態でない場合、最初は描画されません。 +- : - ENTER キーを使用してエントリを選択すると、単一選択モードで正しく機能するようになりました。 - - `DisableFiltering` オプションをオンにすると、以前に入力した検索語句がクリアされるようになりました。 + - オプションをオンにすると、以前に入力した検索語句がクリアされるようになりました。 - 単一選択モードで、選択した項目に既に一致する検索語を入力すると、正しく機能するようになりました。 ### **{PackageCommonVerChanges-4.9.0}** -- `Icon` +- - Added `setIconRef` method. This allows to register and replace icons by SVG files. - All components now use icons by reference internally so that it's easy to replace them without explicitly providing custom templates. -- `RadioGroup` +- - Added `name` and `value` properties. **Breaking Changes** -- Removed `Form` component. Use native form instead. +- Removed component. Use native form instead. - Removed `size` property in favor of the `--ig-size` CSS custom property for the following components: - - `Avatar`, `Button`,`IconButton`, `Calendar`, `Chip`, `Dropdown`, `Icon`, `Input`, `List`, `Rating`, `Snackbar`, `Tabs`, `Tree` + - , ,, , , , , , , , , , - Removed custom `igcFocus` and `igcBlur` events. Use the native `focus` and `blur` events instead for the following components: - - `Button`, `IconButton`, `Checkbox`, `Switch`, `Combo`, `DateTimeInput`, `Input`, `MaskInput`, `Radio`, **IgcSelectComponent**, `Textarea` -- `Checkbox`, `Switch` ,`Radio` + - , , , , , , , , , **IgcSelectComponent**, +- , , - Changed `igcChange` event arguments from `CustomEvent` to `CustomEvent<{ checked: boolean; value: string | undefined }>` -- `Combo`, **IgcSelectComponent** +- , **IgcSelectComponent** - Removed `positionStrategy`, `flip`, `sameWidth` properties. -- `Dialog` +- - Renamed The `closeOnEscape` property to `keepOpenOnEscape`. -- `Dropdown` +- - Removed `positionStrategy` property. -- `Input` +- - Removed `maxlength` and `minlength` properties. Use the native `maxLength` and `minLength` properties or `max` and `min` instead. - Renamed `readonly` and `inputmode` properties to `readOnly` and `inputMode`. -- `RangeSlider` +- - Renamed `ariaThumbLower`/`ariaThumbUpper` properties to `thumbLabelLower`/`thumbLabelUpper`. -- `Rating` +- - Renamed `readonly` property to `readOnly`. ### 追加 #### 変更 -- `Combo`、`Select`、`Dropdown` - ネイティブの `Popover` API を使用するようになりました。 +- - ネイティブの `Popover` API を使用するようになりました。 ### 非推奨 #### 修正 -- `DateTimeInput` - コンポーネントが読み取り専用モードの場合、Material テーマのラベルが壊れます。 +- - コンポーネントが読み取り専用モードの場合、Material テーマのラベルが壊れます。 ### **{PackageCommonVerChanges-4.8.2}** #### 修正 -- `Textarea` - サフィックスのないテキスト領域のサイズ変更ハンドルの位置。 -- `Tabs` - 単一の呼び出しスタックでタブ グループとタブを動的に作成および追加するときにエラーが発生します。 -- `Checkbox`/`Switch` - 最初にチェックしたときにフォームの送信に参加します。 -- `Dialog` - コンポーネントが実際に閉じられる/非表示になる前に `igcClosed` が発生します。 +- - サフィックスのないテキスト領域のサイズ変更ハンドルの位置。 +- - 単一の呼び出しスタックでタブ グループとタブを動的に作成および追加するときにエラーが発生します。 +- / - 最初にチェックしたときにフォームの送信に参加します。 +- - コンポーネントが実際に閉じられる/非表示になる前に `igcClosed` が発生します。 #### **{PackageCommonVerChanges-4.8.1}** -- `Input` `Inputmode` property. Aligned with the native `inputMode` DOM property instead. +- `Inputmode` property. Aligned with the native `inputMode` DOM property instead. #### 修正 -- `DateTimeInput` - `InputFormat` は、既に設定されている値には適用されません。 -- `Checkbox`、`Radio`、`Switch` - フォーム検証を同期的に適用します。 -- `Select`、`Dropdown` - ドロップダウン/選択項目スロット内のラップ要素をクリックしても項目を選択できません。 -- `Tree` - アクティブ状態は、クリック時に正しいツリー ノードに正しく適用されます。 +- - は、既に設定されている値には適用されません。 +- - フォーム検証を同期的に適用します。 +- - ドロップダウン/選択項目スロット内のラップ要素をクリックしても項目を選択できません。 +- - アクティブ状態は、クリック時に正しいツリー ノードに正しく適用されます。 ### **{PackageCommonVerChanges-4.8.0}** #### 追加 -- `Combo` では、`GroupSorting` を none に設定できるようになりました。これにより、提供されたデータの順序でグループが表示されます。 -- `Button`/`IconButton` - テーマ間でビジュアルの外観が更新され、新しい状態が追加されました。 +- では、 を none に設定できるようになりました。これにより、提供されたデータの順序でグループが表示されます。 +- / - テーマ間でビジュアルの外観が更新され、新しい状態が追加されました。 - `NavBar` - Bootstrap テーマに境界線が追加されました。 #### 変更 -- `Combo` でのグループ化ではデータがソートされなくなりました。`GroupSorting` プロパティは、グループのソート方向にのみ影響するようになりました。**動作変更**: 以前のリリースでは、グループのソート方向によって項目もソートされていました。この動作を実現したい場合は、既にソートされたデータを `Combo` に渡すことができます。 +- でのグループ化ではデータがソートされなくなりました。 プロパティは、グループのソート方向にのみ影響するようになりました。**動作変更**: 以前のリリースでは、グループのソート方向によって項目もソートされていました。この動作を実現したい場合は、既にソートされたデータを に渡すことができます。 #### 非推奨 -- `Slider` - `aria-label-upper` と `aria-label-lower` は非推奨であり、次のメジャー リリースで削除されます。代わりに、`thumb-label-upper` と `thumb-label-lower` を使用してください。 +- - `aria-label-upper` と `aria-label-lower` は非推奨であり、次のメジャー リリースで削除されます。代わりに、`thumb-label-upper` と `thumb-label-lower` を使用してください。 #### 修正 -- `Button` - スロットアイコンのサイズ。 -- `ButtonGroup` +- - スロットアイコンのサイズ。 +- - Fluent テーマの外観を更新しました。 - Safari での無効状態。 -- `Combo`/`Select` - スタイルの問題。 -- `Slider` +- / - スタイルの問題。 +- - スライダー トラックのクリックは、トラック要素の幅を計算の基準として使用します。 - スライダーのつまみを連続的にドラッグし、上限/下限を超えても、入力イベントは発生されません。 - `min`/`max` の前に `upper-bound`/`lower-bound` を設定する場合、スライダーはバインドされたプロパティを `min`/`max` の以前の値で上書きしません。 - スライダーのつまみにバインドされた `aria-label` は結果のレンダリングでリセットされなくなりました。 -- `Input` +- - デフォルトの検証は同期的に実行されます。 - スタイルの問題。 -- `DateTimeInput` - `setRangeText()` は基になる値を更新します。 +- - `setRangeText()` は基になる値を更新します。 ### **{PackageCommonVerChanges-4.7.0}** #### 追加 -- `Tree` - ノードをクリックすると展開状態が変更されるかどうかを決定する `ToggleNodeOnClick` プロパティが追加されました。デフォルトは **false** です。 +- - ノードをクリックすると展開状態が変更されるかどうかを決定する プロパティが追加されました。デフォルトは **false** です。 ### 変更 #### 修正 -- `Dropdown`、`Select`、および `Combo` のアクティブ項目のビジュアル スタイル。 -- `NavDrawer` - ミニ バリアントの壊れたビジュアル スタイル。 +- 、および のアクティブ項目のビジュアル スタイル。 +- - ミニ バリアントの壊れたビジュアル スタイル。 ### **{PackageCommonVerChanges-4.6.0}** #### 追加 -- `Snackbar` に `action` スロットが追加されました。 -- `indicator-expanded` スロットが `ExpansionPanel` に追加されました。 -- `toggle-icon-expanded` スロットが `Select` に追加されました。 -- `Select`、`Dropdown` - `selectedItem`、`items`、`groups` ゲッターを公開しました。 +- に `action` スロットが追加されました。 +- `indicator-expanded` スロットが に追加されました。 +- `toggle-icon-expanded` スロットが に追加されました。 +- - `selectedItem`、`items`、`groups` ゲッターを公開しました。 #### 変更 - パッケージを Lit v3 に更新しました。 - コンポーネントのダーク バリアントはシャドウ ルートにバインドされるようになりました。 - コンポーネントは現在のテーマに基づいてデフォルトのサイズを実装します。 -- `ButtonGroup` - イベントをキャンセル不可に変更しました。 +- - イベントをキャンセル不可に変更しました。 - コンポーネント CSS を最適化し、バンドル サイズを縮小しました。 -- `Icon`、`Select`、`Dropdown`、`List` の WAI-ARIA が改善されました。 +- の WAI-ARIA が改善されました。 #### 修正 -- `Textarea` にスタイル設定パーツがありません。 -- `TreeItem` の無効なスタイル。 -- `Snackbar` の不要なスタイルを削除しました。 -- `TreeItem` ホバー状態のビジュアル デザイン。 -- ビューを切り替えても `Calendar` のフォーカス状態が維持されません。 +- にスタイル設定パーツがありません。 +- の無効なスタイル。 +- の不要なスタイルを削除しました。 +- ホバー状態のビジュアル デザイン。 +- ビューを切り替えても のフォーカス状態が維持されません。 #### **{PackageCommonVerChanges-4.5.0}** -- `Button` - Slotted icon size. -- `ButtonGroup` +- - Slotted icon size. +- - Updated Fluent theme look. - Disabled state in Safari. -- `Combo`/`Select` - Style issues. -- `Slider` +- / - Style issues. +- - Clicks on the slider track now use the track element width as a basis for the calculation. - Input events are no longer emitted while continuously dragging the slider thumb and exceeding upper/lower bounds. - When setting `upper-bound`/`lower-bound` before `min`/`max`, the slider will no longer overwrite the bound properties with the previous values of `min`/`max`. - The `aria-label` bound to the slider thumb is no longer reset on consequent renders. -- `Input` +- - Default validators are run synchronously. - Style issues. -- `DateTimeInput` - `setRangeText()` updates underlying value. +- - `setRangeText()` updates underlying value. ### 追加 #### 非推奨 -`size` プロパティと属性は、すべてのコンポーネントで非推奨になりました。代わりに `--ig-size` CSS カスタム プロパティを使用してください。次の例では、`Avatar` コンポーネントのサイズを小さく設定します: +`size` プロパティと属性は、すべてのコンポーネントで非推奨になりました。代わりに `--ig-size` CSS カスタム プロパティを使用してください。次の例では、 コンポーネントのサイズを小さく設定します: -- `Rating` - `AllowReset` added. When enabled selecting the same value will reset the component. **Behavioral change**: In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. +- - added. When enabled selecting the same value will reset the component. **Behavioral change**: In previous releases this was the default behavior of the rating component. Make sure to set `allowReset` if you need to keep this behavior in your application. #### 修正 - Safari でのコンボ項目の位置。 @@ -1348,36 +1350,36 @@ import { IgcLiveGridComponent } from 'igniteui-webcomponents-data-grids/ES5/igc- - 遅延データ バインディングを使用したコンボ値と選択状態。 - さまざまなスタイルとテーマの修正と調整 #### **{PackageCommonVerChanges-4.4.0}** -- Active item visual styles for `Dropdown`, `Select` and `Combo`. -- `NavDrawer` - mini variant broken visual style. +- Active item visual styles for , and . +- - mini variant broken visual style. ### 追加 #### 変更 -- `Rating` - Fluent テーマのカラー。 -- `Stepper` - インジケーターのスタイルとカラー スキーマ。 +- - Fluent テーマのカラー。 +- - インジケーターのスタイルとカラー スキーマ。 #### 非推奨 - `IgcForm` コンポーネントは非推奨です。 -- `Input`: +- : - `minlength` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `minLength` を使用してください。 - `maxlength` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `maxLength` を使用してください。 - `readonly` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `readOnly` を使用してください。 -- `MaskInput`: +- : - `readonly` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `readOnly` を使用してください。 -- `DateTimeInput`: +- : - `readonly` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `readOnly` を使用してください。 - `minValue` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `min` を使用してください。 - `maxValue` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `max` を使用してください。 -- `Rating`: +- : - `readonly` プロパティは非推奨になり、次のメジャー バージョンで削除される予定です。代わりに `readOnly` を使用してください。 #### 削除済 - デフォルトの属性を隠していた独自の `dir` 属性が削除されました。これは**互換性のある変更**です。 -- `Slider` - `ariaLabel` シャドウ プロパティ。これは**互換性のある変更**です。 -- `Checkbox` - `ariaLabelledBy` シャドウ属性。これは**互換性のある変更**です。 -- `Switch` - `ariaLabelledBy` シャドウ属性。これは**互換性のある変更**です。 -- `Radio` - `ariaLabelledBy` シャドウ属性。これは**互換性のある変更**です。 +- - `ariaLabel` シャドウ プロパティ。これは**互換性のある変更**です。 +- - `ariaLabelledBy` シャドウ属性。これは**互換性のある変更**です。 +- - `ariaLabelledBy` シャドウ属性。これは**互換性のある変更**です。 +- - `ariaLabelledBy` シャドウ属性。これは**互換性のある変更**です。 ### 修正 @@ -1385,13 +1387,13 @@ import { IgcLiveGridComponent } from 'igniteui-webcomponents-data-grids/ES5/igc- - New [Text Area](inputs/text-area.md) component. - New [Button Group](inputs/button-group.md) component. -- New `ToggleButton`. -- `NavDrawer` now supports CSS transitions. -- Position attribute for `Toast` and `Snackbar`. +- New . +- now supports CSS transitions. +- Position attribute for and . #### 追加 -- `Tree` - コンポーネントアニメーション。 +- - コンポーネントアニメーション。 - コンポーネントの境界半径は、そのスキーマから使用されます。 ```css @@ -1401,87 +1403,87 @@ igc-avatar { ``` #### 変更 -- `Combo`、`Input`、`Select` - スキーマのカラー。 -- `Dropdown` - スキーマのカラー。 -- `Icon` - テーマのスタイルとサイズが更新されました。 +- - スキーマのカラー。 +- - スキーマのカラー。 +- - テーマのスタイルとサイズが更新されました。 ### 修正 #### **{PackageCommonVerChanges-4.3.0}** - The following components are now Form Associated Custom Elements. They are automatically associated with a parent `` and behave like a browser-provided control: - - `Button` & `IconButton` - - `Checkbox` - - `Combo` - - `DateTimeInput` - - `Input` - - `MaskInput` - - `Radio` - - `Rating` - - Single `Slider` - - `Select` - - `Switch` -- `Stepper` now supports animations. + - & + - + - + - + - + - + - + - + - Single + - + - +- now supports animations. #### 追加 -- `Combo`: +- : - `matchDiacritics` をフィルタリング オプション プロパティに追加しました。デフォルトは **false** です。**true** に設定すると、フィルターはアクセント付き文字とその基本文字を区別します。それ以外の場合、文字列は正規化されてから照合されます。 - 現在の選択内容をデータ オブジェクトの配列として返す `selection` プロパティ。 -- `Card`: 明示的な高さのサポート -- `Dialog`: アニメーションの追加 +- : 明示的な高さのサポート +- : アニメーションの追加 #### 変更 -- `Combo`: +- : - `value` は読み取り専用ではなくなり、明示的に設定できるようになりました。value 属性は宣言型のバインディングもサポートしており、有効な JSON 文字列化配列を受け入れます。 #### 非推奨 -- `Select`: `sameWidth`、`positionStrategy`、`flip` は非推奨になりました。これらは次のメジャー リリースで削除される予定です。 +- : `sameWidth`、`positionStrategy`、`flip` は非推奨になりました。これらは次のメジャー リリースで削除される予定です。 #### 修正 -- `Select`: `prefix`/`suffix`/`helper-text` スロットが描画されません。 -- `Tabs`: ネストされたタブの選択。 -- `Dialog`: 背景は要素をオーバーレイしません。 -- `Dropdown`: 最初に開いた状態でのリストボックスの位置。 -- `Stepper`: 親コンテナ内で垂直方向に引き伸ばします。 -- `Navbar`: Fluent テーマの間違ったカラー。 +- : `prefix`/`suffix`/`helper-text` スロットが描画されません。 +- : ネストされたタブの選択。 +- : 背景は要素をオーバーレイしません。 +- : 最初に開いた状態でのリストボックスの位置。 +- : 親コンテナ内で垂直方向に引き伸ばします。 +- : Fluent テーマの間違ったカラー。 - 高さが指定されていない場合、アニメーション プレーヤーはエラーを発生します。 -- `DateTimeInput`: Chromium ベースのブラウザーでの Intl.DateTimeFormat の問題。 +- : Chromium ベースのブラウザーでの Intl.DateTimeFormat の問題。 ### **{PackageCommonVerChanges-4.2.3}** #### 非推奨 -- `Dialog` - `closeOnEscape` プロパティは非推奨となり、代わりに新しい `keepOpenOnEscape` プロパティが使用されます。 +- - `closeOnEscape` プロパティは非推奨となり、代わりに新しい `keepOpenOnEscape` プロパティが使用されます。 #### 修正 -- `Radio`- 選択されたフォーカス状態のカラー。 -- `IconButton` - 他のデザイン システム製品に合わせてアイコンのサイズを設定します。 -- `Chip` - Fluent および Material テーマのアウトライン スタイルが削除されました。 -- `Calendar` - 設定された値の日付へのナビゲーション。 -- `Tabs` - 親の高さを完全には取得しません。 +- - 選択されたフォーカス状態のカラー。 +- - 他のデザイン システム製品に合わせてアイコンのサイズを設定します。 +- - Fluent および Material テーマのアウトライン スタイルが削除されました。 +- - 設定された値の日付へのナビゲーション。 +- - 親の高さを完全には取得しません。 #### **{PackageCommonVerChanges-4.2.2}** -- `Combo` - single selection not working in certain scenarios. -- `Dropdown` - various styling fixes. -- `IconButton` - border radius with ripple. -- `IconButton` - fixed wrong color in Fluent theme. -- `Input` - various styling fixes. -- `TreeItem` - assign closest **igc-tree-item** ancestor as a parent. -- `Tabs` - internal **hidden** styles and custom display property. +- - single selection not working in certain scenarios. +- - various styling fixes. +- - border radius with ripple. +- - fixed wrong color in Fluent theme. +- - various styling fixes. +- - assign closest **igc-tree-item** ancestor as a parent. +- - internal **hidden** styles and custom display property. ### 非推奨 #### 修正 -- `Button` - UI の不一致。 -- `Calendar` - Fluent テーマの不一致。 -- `Combo` - API 経由の選択は検索リストでは機能しません。 -- `Dialog` - Fluent テーマの不一致。 -- `Input` - UI の不一致。 -- `Toast` - Fluent テーマの不一致。 +- - UI の不一致。 +- - Fluent テーマの不一致。 +- - API 経由の選択は検索リストでは機能しません。 +- - Fluent テーマの不一致。 +- - UI の不一致。 +- - Fluent テーマの不一致。 - defineAllComponents にコンポーネントがありません。 -- `Avatar`、`Badge`、`Button`、`IconButton` のホスト サイズが間違っています。 +- のホスト サイズが間違っています。 #### **{PackageCommonVerChanges-4.2.1}** -- `Combo`: +- : - `value` is no longer readonly and can be explicitly set. The value attribute also supports declarative binding, accepting a valid JSON stringified array. - `value` type changed from `string[]` to `ComboValue[]` where @@ -1503,52 +1505,52 @@ interface IgcComboChangeEventArgs { #### 修正 -- `Combo` - 単一選択モードでのフィルタリングでは一致する項目がアクティブ化されません。 +- - 単一選択モードでのフィルタリングでは一致する項目がアクティブ化されません。 #### **{PackageCommonVerChanges-4.2.0}** -- `Select`: `prefix`/`suffix`/`helper-text` slots not being rendered. -- `Tabs`: Nested tabs selection. -- `Dialog`: Backdrop doesn't overlay elements. -- `Dropdown`: Listbox position on initial open state. -- `Stepper`: Stretch vertically in parent container. -- `Navbar`: Wrong colors in fluent theme. +- : `prefix`/`suffix`/`helper-text` slots not being rendered. +- : Nested tabs selection. +- : Backdrop doesn't overlay elements. +- : Listbox position on initial open state. +- : Stretch vertically in parent container. +- : Wrong colors in fluent theme. - Animation player throws errors when height is unspecified. -- `DateTimeInput`: Intl.DateTimeFormat issues in Chromium based browsers. +- : Intl.DateTimeFormat issues in Chromium based browsers. ### 追加 #### 修正 -- `Input` - UI の不一致。 -- `Badge` - `igc-icon` とフォント アイコンが正しく描画されません。 -- `Radio` - UI の不一致。 -- `NavDrawer` - 項目のマージンをオーバーライドできません。 +- - UI の不一致。 +- - `igc-icon` とフォント アイコンが正しく描画されません。 +- - UI の不一致。 +- - 項目のマージンをオーバーライドできません。 #### **{PackageCommonVerChanges-4.1.1}** -- `Radio`- colors in selected focus state. -- `IconButton` - set icon size to match other design system products. -- `Chip` - removed outline styles for Fluent and Material themes. -- `Calendar` - navigation to date on set value. -- `Tabs` - not taking the full height of their parents. +- - colors in selected focus state. +- - set icon size to match other design system products. +- - removed outline styles for Fluent and Material themes. +- - navigation to date on set value. +- - not taking the full height of their parents. ### 修正 #### **{PackageCommonVerChanges-4.1.0}** -- `Button` - The `prefix`/`suffix` slots are no longer needed and will be removed in the next major release. +- - The `prefix`/`suffix` slots are no longer needed and will be removed in the next major release. #### 追加 - 新しい [Stepper](layouts/stepper.md) コンポーネント。 - 新しい [Combo](inputs/combo/overview.md) コンポーネント。 -- `MaskInput` - コンポーネント内のシンボルを削除するときにリテラル位置をスキップします。 +- - コンポーネント内のシンボルを削除するときにリテラル位置をスキップします。 ### 修正 #### **{PackageCommonVerChanges-4.0.0}** -- `Combo` - Matching item not activated on filtering in single selection mode. +- - Matching item not activated on filtering in single selection mode. ### 変更 #### **{PackageCommonVerChanges-3.4.2}** -- `Combo` - Single Selection mode via the `single-select` attribute. +- - Single Selection mode via the `single-select` attribute. #### 修正 - `DateRangeType` のインポート エラーを解決しました。 @@ -1556,15 +1558,15 @@ interface IgcComboChangeEventArgs { ### **{PackageCommonVerChanges-3.4.1}** #### 変更 -- `Slider` - 最新の Fluent 仕様に合わせてテーマを更新しました。 -- `Calendar` - 週末の色を更新しました。 +- - 最新の Fluent 仕様に合わせてテーマを更新しました。 +- - 週末の色を更新しました。 ### 修正 #### **{PackageCommonVerChanges-3.4.0}** - New [Stepper](layouts/stepper.md) component. - New [Combo](inputs/combo/overview.md) component. -- `MaskInput` - Skip literal positions when deleting symbols in the component +- - Skip literal positions when deleting symbols in the component #### 追加 - 新しい [Dialog](notifications/dialog.md) コンポーネント。 @@ -1582,9 +1584,9 @@ interface IgcComboChangeEventArgs { ### 変更 #### 修正 -- `Dropdown` - トップレベルのイベント リスナーを破棄します。 -- `LinearProgress` - Safari での不確定なアニメーション。 -- `RadioGroup` - 子ラジオ コンポーネントの自動登録。 +- - トップレベルのイベント リスナーを破棄します。 +- - Safari での不確定なアニメーション。 +- - 子ラジオ コンポーネントの自動登録。 ### **{PackageCommonVerChanges-3.3.0}** @@ -1595,8 +1597,8 @@ interface IgcComboChangeEventArgs { - テーマのタイポグラフィ スタイル。 #### 変更 -- `Rating` - 単一選択と空のシンボルのサポートが追加されました。 -- `Slider` - スライダー ステップの描画を改善しました。 +- - 単一選択と空のシンボルのサポートが追加されました。 +- - スライダー ステップの描画を改善しました。 - コンポーネントは、`defineComponents` で登録されると、その依存関係を自動登録するようになりました。 ### 修正 @@ -1609,29 +1611,29 @@ interface IgcComboChangeEventArgs { - 新しい [MaskInput](inputs/mask-input.md) コンポーネント。 - 新しい [ExpansionPanel](layouts/expansion-panel.md) コンポーネント。 - 新しい [Tree](grids/tree.md) コンポーネント。 -- `Rating` - シンボルのサイズを制御するために、`selected` CSS パーツと公開された CSS 変数を追加しました。 -- `IconButton` - スロット化されたコンテンツを許可します。 +- - シンボルのサイズを制御するために、`selected` CSS パーツと公開された CSS 変数を追加しました。 +- - スロット化されたコンテンツを許可します。 ### 修正 #### **{PackageCommonVerChanges-3.1.0}** -- `Tree` - Removed theme-specified height. +- - Removed theme-specified height. #### 追加 -- `Chip`: `prefix` と `suffix` のスロットを追加しました。 -- `Snackbar`: `toggle` メソッドを追加しました。 +- : `prefix` と `suffix` のスロットを追加しました。 +- : `toggle` メソッドを追加しました。 ### 非推奨 #### 修正 -- `Chip`: +- : - 内部アイコンを自動読み込みます。 - 選択したチップの位置がずれています。 - パッケージ: ESM 内部インポート パス。 #### **{PackageCommonVerChanges-3.0.0}** -- `Rating` - Added support for single selection and empty symbols. -- `Slider` - Improved slider steps rendering. +- - Added support for single selection and empty symbols. +- - Improved slider steps rendering. - Components will now auto register their dependencies when they are registered in `defineComponents` @@ -1654,20 +1656,20 @@ Check the official [documentation](https://www.infragistics.com/products/ignite- #### 追加 - 新しい [DropDown](inputs/dropdown.md) コンポーネント。 -- `Calendar`: アクティブ日付は属性を介して設定できます。 +- : アクティブ日付は属性を介して設定できます。 #### **{PackageCommonVerChanges-2.1.1}** -- `NavDrawer` - Various styles fixes. +- - Various styles fixes. - Buttons - Vertical align and focus management. -- `Input` - Overflow for `suffix`/`prefix`. -- `Switch` - Collapse with small sizes. -- `List` - Overflow behavior. +- - Overflow for `suffix`/`prefix`. +- - Collapse with small sizes. +- - Overflow behavior. ### 追加 #### **{PackageCommonVerChanges-2.1.0}** -- `Chip`: Added `prefix` and `suffix` slots. -- `Snackbar`: Added `toggle` method. +- : Added `prefix` and `suffix` slots. +- : Added `toggle` method. #### 追加 - 新しい [LinearProgress](inputs/linear-progress.md) コンポーネント。 @@ -1679,7 +1681,7 @@ Check the official [documentation](https://www.infragistics.com/products/ignite- - コンポーネントテーマは、`configureTheme(theme: Theme)` 関数を呼び出すことで実行時に変更できます。 #### **{PackageCommonVerChanges-2.0.0}** -- `Chip`: +- : - Auto load internal icons. - Selected chip is misaligned. - Package: ESM internal import paths. @@ -1688,9 +1690,9 @@ Check the official [documentation](https://www.infragistics.com/products/ignite- #### 変更 - チェックボックス/スイッチの検証状態を修正しました。 -- `Calendar` の `value: Date | Date[]` プロパティを 2 つのプロパティに分割しました: `value: Date` おとび `values: Date[]`。`` -- `Calendar` の `hasHeader` プロパティと `has-header` 属性をそれぞれ `hideHeader` と `hide-header` に置き換えました。 -- `Card` の `outlined` プロパティを `elevated` に置き換えました。 +- の `value: Date | Date[]` プロパティを 2 つのプロパティに分割しました: `value: Date` おとび `values: Date[]`。`` +- の `hasHeader` プロパティと `has-header` 属性をそれぞれ `hideHeader` と `hide-header` に置き換えました。 +- の `outlined` プロパティを `elevated` に置き換えました。 ### 削除済 @@ -1715,7 +1717,7 @@ Example: ### **{PackageDockManagerVerChanges-1.14.4}** #### 非推奨 -- `SplitPane` の `IsMaximized` は非推奨です。分割ペイン レベルで isMaximized を true に設定しても、分割ペインはコンテナーとしてのみ機能し、最大化されて表示される実際のコンテンツがないため、実際の効果はありません。代わりに、`TabGroupPane` および/または `ContentPane` の `IsMaximized` プロパティを使用してください。 +- は非推奨です。分割ペイン レベルで isMaximized を true に設定しても、分割ペインはコンテナーとしてのみ機能し、最大化されて表示される実際のコンテンツがないため、実際の効果はありません。代わりに、 および/または プロパティを使用してください。 ### **{PackageDockManagerVerChanges-1.14.3}** @@ -1725,9 +1727,9 @@ Example: #### **{PackageDockManagerVerChanges-1.14.2}** - Fix checkbox/switch validity status -- Split `Calendar`'s `value: Date | Date[]` property into two properties - `value: Date` and `values: Date[]` -- Replaced `Calendar`'s `hasHeader` property & `has-header` attribute with `hideHeader` & `hide-header` respectively. -- Replaced `Card`'s `outlined` property with `elevated`. +- Split 's `value: Date | Date[]` property into two properties - `value: Date` and `values: Date[]` +- Replaced 's `hasHeader` property & `has-header` attribute with `hideHeader` & `hide-header` respectively. +- Replaced 's `outlined` property with `elevated`. #### 修正 - すばやくドラッグして、パネルをドック マネージャーの境界内に制限します。 @@ -1797,7 +1799,7 @@ Initial release of Ignite UI Web Components #### 機能拡張 - `splitterResizeStart` イベントと `splitterResizeEnd` イベントにペイン情報を含めます。 -- `DockManager` がクラスとしてエクスポートされるようになりました。 +- がクラスとしてエクスポートされるようになりました。 ### 修正 @@ -1859,15 +1861,15 @@ Initial release of Ignite UI Web Components #### 新機能 - カスタマイズ可能なフローティング ペイン ヘッダー。 -- ペインごとの `Disabled` プロパティ。 -- `DocumentOnly` プロパティは、コンテンツ ペインをドキュメント ホスト内にのみドッキングできるようにします。 -- 分割ペインとタブ グループ ペインの空の領域を表示できるようにする `AllowEmpty` プロパティ。 -- ドック マネージャーの `DisableKeyboardNavigation` プロパティ。 +- ペインごとの プロパティ。 +- プロパティは、コンテンツ ペインをドキュメント ホスト内にのみドッキングできるようにします。 +- 分割ペインとタブ グループ ペインの空の領域を表示できるようにする プロパティ。 +- ドック マネージャーの プロパティ。 ### 修正 #### **{PackageDockManagerVerChanges-1.6.0}** -- Add `ShowHeaderIconOnHover` property. +- Add property. #### 新機能 - ドック マネージャーのペインとタブをカスタマイズします。 @@ -1909,7 +1911,7 @@ Initial release of Ignite UI Web Components ### 新機能 #### **{PackageDockManagerVerChanges-1.2.0}** -- `AllowMaximize` property per pane. +- property per pane. #### 新機能 - アクティブ ペイン。 diff --git a/docs/xplat/src/content/jp/components/general-changelog-dv.mdx b/docs/xplat/src/content/jp/components/general-changelog-dv.mdx index c56437cd3e..fa3ed64aee 100644 --- a/docs/xplat/src/content/jp/components/general-changelog-dv.mdx +++ b/docs/xplat/src/content/jp/components/general-changelog-dv.mdx @@ -18,6 +18,8 @@ import chartdefaults4 from '@xplat-images/chartDefaults4.png'; import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {ProductName} 変更ログ {ProductName} の各バージョンのすべての重要な変更は、このページに記載されています。 @@ -79,9 +81,9 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と #### ユーザー注釈 -{ProductName} では、ユーザー注釈機能により、実行時に `DataChart` にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 +{ProductName} では、ユーザー注釈機能により、実行時に にスライス注釈、ストリップ注釈、ポイント注釈を追加できるようになりました。これにより、エンドユーザーは、スライス注釈を使用して会社の四半期レポートなどの単一の重要イベントを強調したり、ストリップ注釈を使用して期間を持つイベントを示したりすることで、プロットに詳細を追加できます。ポイント注釈またはこれら 3 つの任意の組み合わせを使用して、プロットされたシリーズ上の個々のポイントを呼び出すこともできます。 -これは、`Toolbar` のデフォルトのツールと統合されています。 +これは、 のデフォルトのツールと統合されています。 {Platform} user-annotation-create @@ -89,8 +91,8 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と 軸注釈が自動で衝突を検出し、適切に収まるよう切り詰めます。この機能を有効にするには、次のプロパティを設定します: -- `ShouldAvoidAnnotationCollisions` -- `ShouldAutoTruncateAnnotations` +- +- ### {PackageMaps} (地理マップ) @@ -132,15 +134,15 @@ DataPieChart および ProportionalCategoryAngleAxis に OthersCategoryBrush と #### 対応軸 -X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。`CompanionAxisEnabled` プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 +X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸を簡単に複製できるようになりました。 プロパティを有効にすると、複製された軸はチャートの反対側に配置され、そこから各軸プロパティを設定できます。 #### RadialPieSeries インセット アウトライン -`RadialPieSeries` のアウトライン レンダリング方法を制御するために `UseInsetOutlines` プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 + のアウトライン レンダリング方法を制御するために プロパティが追加されました。**true** に設定すると、アウトラインがスライス形状の内側に描画され、**false** (既定値) に設定すると、アウトラインはスライス形状の端に半分内側・半分外側で描画されます。 **重大な変更** -- `ChartMouseEventArgs` クラスの `PlotAreaPosition` プロパティと `ChartPosition` プロパティが逆になっている問題が修正されました。これにより、`PlotAreaPosition` と `ChartPosition` が返す値が変更されます。 +- クラスの プロパティと プロパティが逆になっている問題が修正されました。これにより、 が返す値が変更されます。 ### 機能拡張 @@ -152,11 +154,11 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 - DataToolTipLayer、ItemToolTipLayer、CategoryToolTipLayer にスタイル設定用の新しいプロパティが追加されました: `ToolTipBackground`、`ToolTipBorderBrush`、および `ToolTipBorderThickness`。 -- DataLegend にスタイル設定用の新しいプロパティが追加されました: `ContentBackground`、`ContentBorderBrush`、および `ContentBorderThickness`。`ContentBorderBrush` と `ContentBorderThickness` はそれぞれ既定で transparent と 0 に設定されているため、境界線を表示するにはこれらのプロパティを設定する必要があります。 +- DataLegend にスタイル設定用の新しいプロパティが追加されました: 、および はそれぞれ既定で transparent と 0 に設定されているため、境界線を表示するにはこれらのプロパティを設定する必要があります。 -- マウスのワールド相対位置を提供する `WorldPosition` という新しいプロパティが `ChartMouseEventArgs` に追加されました。この位置は、軸空間内の X 軸と Y 軸の両方に対して 0 から 1 の間の値になります。 +- マウスのワールド相対位置を提供する という新しいプロパティが に追加されました。この位置は、軸空間内の X 軸と Y 軸の両方に対して 0 から 1 の間の値になります。 -- `SeriesViewer` と `DomainChart` に `HighlightingFadeOpacity` が追加されました。ハイライト表示されたシリーズに適用される不透明度を設定できます。 +- が追加されました。ハイライト表示されたシリーズに適用される不透明度を設定できます。 - ドメイン チャートの `CalloutLabelUpdating` イベントを公開しました。 @@ -212,11 +214,11 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 - データ注釈スライス レイヤー - データ注釈ストリップ レイヤー -- [データ ツールチップ](charts/features/chart-data-tooltip.md)と[データ 凡例](charts/features/chart-data-legend.md)では、ツールチップまたは凡例のコンテンツをテーブルまたは垂直レイアウト構造でレイアウトするために使用できる `LayoutMode` プロパティが公開されています。 +- [データ ツールチップ](charts/features/chart-data-tooltip.md)と[データ 凡例](charts/features/chart-data-legend.md)では、ツールチップまたは凡例のコンテンツをテーブルまたは垂直レイアウト構造でレイアウトするために使用できる プロパティが公開されています。 -- チャートの `DefaultInteraction` プロパティが更新され、新しい列挙体 `DragSelect` が含まれるようになりました。これにより、ドラッグされたプレビュー Rect は、その中に含まれるポイントを選択します。 (ベータ版) +- チャートの プロパティが更新され、新しい列挙体 `DragSelect` が含まれるようになりました。これにより、ドラッグされたプレビュー Rect は、その中に含まれるポイントを選択します。 (ベータ版) -- [ValueOverlay と ValueLayer](charts/features/chart-overlays.md) は、上記にリストした [チャート データ注釈](charts/features/chart-data-annotations.md)に加えて、プロット領域に追加の注釈テキストをオーバーレイするために使用できる `OverlayText` プロパティを公開するようになりました。これらの注釈の外観は、OverlayText プレフィックスが付いた多くのプロパティを使用して構成できます。たとえば、`OverlayTextBrush` プロパティはオーバーレイ テキストの色を構成します。 (ベータ版) +- [ValueOverlay と ValueLayer](charts/features/chart-overlays.md) は、上記にリストした [チャート データ注釈](charts/features/chart-data-annotations.md)に加えて、プロット領域に追加の注釈テキストをオーバーレイするために使用できる プロパティを公開するようになりました。これらの注釈の外観は、OverlayText プレフィックスが付いた多くのプロパティを使用して構成できます。たとえば、`OverlayTextBrush` プロパティはオーバーレイ テキストの色を構成します。 (ベータ版) - [トレンドライン レイヤー](charts/features/chart-trendlines.md) シリーズ タイプを使用すると、トレンド ライン レイヤーごとに 1 つのトレンド ラインを特定のシリーズに適用できます。これにより、チャートに複数の [TrendlineLayer](charts/features/chart-overlays.md) シリーズ タイプを使用できるため、単一のシリーズで複数のトレンド ラインを使用できるようになります。 @@ -253,9 +255,9 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 #### Toolbar -- `Toolbar` と `ToolPanel` に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての `ToolActionGroupHeader` アクションに適用されます。 -- タイトル テキストの水平方向の配置を制御する `TitleHorizontalAlignment` という新しいプロパティを `ToolAction` に追加しました。 -- `ToolActionSubPanel` に、パネル内の項目間の間隔を制御する `ItemSpacing` という新しいプロパティを追加しました。 +- に新しい `GroupHeaderTextStyle` プロパティを追加しました。設定されている場合、すべての アクションに適用されます。 +- タイトル テキストの水平方向の配置を制御する という新しいプロパティを に追加しました。 +- に、パネル内の項目間の間隔を制御する という新しいプロパティを追加しました。 ### バグ修正 @@ -293,11 +295,11 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 ## **{PackageVerChanges-24-1-SEP}** -- [データ円チャート](charts/types/data-pie-chart.md) - `DataPieChart` は円ャートを表示する新しいコンポーネントです。このコンポーネントは、`CategoryChart` と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、ハイライト表示、アニメーション、凡例のサポートを可能にします。 +- [データ円チャート](charts/types/data-pie-chart.md) - は円ャートを表示する新しいコンポーネントです。このコンポーネントは、 と同様に動作し、基になるデータ モデルのプロパティを自動的に検出しながら、ItemLegend コンポーネントを介して選択、ハイライト表示、アニメーション、凡例のサポートを可能にします。 -- [比例カテゴリ角度軸](charts/types/radial-chart.md) - スライスをプロットするための、`DataChart` のラジアル円シリーズの新しい軸。円チャートに似ており、データ ポイントが円グラフ内のセグメントとして表されます。 +- [比例カテゴリ角度軸](charts/types/radial-chart.md) - スライスをプロットするための、 のラジアル円シリーズの新しい軸。円チャートに似ており、データ ポイントが円グラフ内のセグメントとして表されます。 -- `Toolbar` +- - 新しい ToolActionCheckboxList 選択用のチェックボックスを備えた項目のコレクションを表示する新しい CheckboxList ToolAction。ToolAction CheckboxList 内のグリッドの高さは 5 項目まで大きくなり、その後スクロールバーが表示されます。 @@ -316,78 +318,78 @@ X 軸と Y 軸に `CompanionAxis` プロパティが追加され、既存の軸 ### {PackageCharts} (チャート) -- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。`GroupRowVisible` プロパティは、各シリーズのグループ化を切り替え、オプトインすると `DataLegendGroup` プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 +- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。 プロパティは、各シリーズのグループ化を切り替え、オプトインすると プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 -- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、`CategoryChart` および `DataChart` のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 -複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと `SelectedSeriesItems` は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 +- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、 および のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 +複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 -- [ツリーマップのハイライト表示](charts/types/treemap-chart.md#{PlatformLower}-リーマップのハイライト表示) - ツリー マップの項目のマウスオーバーによるハイライト表示を構成できる `HighlightingMode` プロパティが公開されました。このプロパティには 2 つのオプションがあります: `Brighten` では、マウスを置いた項目にのみハイライト表示が適用され、`FadeOthers` では、マウスホバーした項目のハイライト表示はそのままで、それ以外はすべてフェードアウトします。このハイライト表示はアニメーション化されており、`HighlightingTransitionDuration` プロパティを使用して制御できます。 +- [ツリーマップのハイライト表示](charts/types/treemap-chart.md#{PlatformLower}-リーマップのハイライト表示) - ツリー マップの項目のマウスオーバーによるハイライト表示を構成できる プロパティが公開されました。このプロパティには 2 つのオプションがあります: `Brighten` では、マウスを置いた項目にのみハイライト表示が適用され、`FadeOthers` では、マウスホバーした項目のハイライト表示はそのままで、それ以外はすべてフェードアウトします。このハイライト表示はアニメーション化されており、 プロパティを使用して制御できます。 -- [ツリーマップのパーセントベースのハイライト表示](charts/types/treemap-chart.md#{PlatformLower}-ツリーマップのパーセントベースのハイライト表示) - 新しいパーセントベースのハイライト表示により、ノードはコレクションの進行状況またはサブセットを表すことができます。外観は、データ項目のメンバーによって、または新しい `HighlightedItemsSource` を指定することによって、特定の値までの背景色の塗りつぶしとして表示されます。`HighlightedValuesDisplayMode` で切り替えることができ、`FillBrushes` でスタイルを設定できます。 +- [ツリーマップのパーセントベースのハイライト表示](charts/types/treemap-chart.md#{PlatformLower}-ツリーマップのパーセントベースのハイライト表示) - 新しいパーセントベースのハイライト表示により、ノードはコレクションの進行状況またはサブセットを表すことができます。外観は、データ項目のメンバーによって、または新しい を指定することによって、特定の値までの背景色の塗りつぶしとして表示されます。 で切り替えることができ、`FillBrushes` でスタイルを設定できます。 -- `Toolbar` - 選択した特定のツールの周囲に境界線を描くための ToolAction の新しい `IsHighlighted` オプション。 +- - 選択した特定のツールの周囲に境界線を描くための ToolAction の新しい オプション。 ### {PackageGauges} (ゲージ) -- `RadialGauge` - - ハイライト針の新しいラベル。`HighlightLabelText` と `HighlightLabelSnapsToNeedlePivot` および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 +- + - ハイライト針の新しいラベル。 および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 ## **{PackageVerChanges-24-1-JUN}** ### {PackageCharts} (チャート) -- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。`GroupRowVisible` プロパティは、各シリーズのグループ化を切り替え、オプトインすると `DataLegendGroup` プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 +- [データ凡例のグループ化](charts/features/chart-data-legend.md#{PlatformLower}-データ凡例のグループ化) と [データ ツールチップのグループ化](charts/features/chart-data-tooltip.md#{PlatformLower}-データ-チャートのデータ-ツールチップのグループ化) - 新しいグループ化機能が追加されました。 プロパティは、各シリーズのグループ化を切り替え、オプトインすると プロパティを介してグループ テキストを割り当てることができます 同じ値が複数のシリーズに適用されている場合、それらはグループ化されて表示されます。すべてのユーザー向けに分類および整理する必要がある大規模なデータセットに役立ちます。 -- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、`CategoryChart` および `DataChart` のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 -複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと `SelectedSeriesItems` は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 +- [チャートの選択](charts/features/chart-data-selection.md) - 新しいシリーズ選択のスタイル設定。これは、 および のすべてのカテゴリ、財務、およびラジアル シリーズに広く採用されています。シリーズはクリックして異なる色で表示したり、明るくしたり、薄くしたり、フォーカスのアウトラインを表示したりできます。個々のシリーズまたはデータ項目全体を通じて影響を受ける項目を管理します。 +複数のシリーズとマーカーがサポートされています。特定のデータ項目の値間のさまざまな相違点や類似点を示すのに役立ちます。また、`SelectedSeriesItemsChanged` イベントと は、選択内容に基づいたデータ分析を行うポップアップやその他の画面など、アプリケーション内で実行できるその他のアクションを取り巻く堅牢なビジネス要件を構築するための追加の支援として利用できます。 ### {PackageGauges} (ゲージ) -- `RadialGauge` - - ハイライト針の新しいラベル。`HighlightLabelText` と `HighlightLabelSnapsToNeedlePivot` および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 +- + - ハイライト針の新しいラベル。 および、その他の HighlightLabel の多くのスタイル関連プロパティが追加されました。 ## **{PackageVerChanges-23-2-MAR}** ### {PackageCharts} -- `InitialFilter` プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 +- プロパティによる新しいデータ フィルタリング。フィルター式を適用して、チャート データをレコードのサブセットにフィルターします。大規模なデータのドリルダウンに使用できます。 ## {PackageGauges} ### **{PackageVerChanges-23-2-JAN}** - Save tool action has been added to save the chart to an image via the clipboard. -- Vertical orientation has been added via the toolbar's `Orientation` property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. +- Vertical orientation has been added via the toolbar's property. By default the toolbar is horizontal, now the toolbar can be shown in vertical orientation where the tools will popup to the left/right respectfully. - Custom SVG icons support was added via the toolbar's `renderImageFromText` method, further enhancing custom tool creation. ## {PackageCharts} (チャート) ### **{PackageVerChanges-23-2}** -- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our `DataChart` or `CategoryChart` components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. +- [Toolbar](menus/toolbar.md) - This component is a companion container for UI operations to be used primarily with our charting components. The toolbar will dynamically update with a preset of properties and tool items when linked to our or components. You'll be able to create custom tools for your project allowing end users to provide changes, offering an endless amount of customization. ### {PackageGrids} - Toolbar - - クリップボードを介してチャートを画像に保存するための保存ツール アクションが追加されました。 -- ツールバーの `Orientation` プロパティを介して垂直方向が追加されました。デフォルトでは、ツールバーは水平方向ですが、ツールバーを垂直方向に表示できるようになり、ツールが左右にポップアップ表示されます。 +- ツールバーの プロパティを介して垂直方向が追加されました。デフォルトでは、ツールバーは水平方向ですが、ツールバーを垂直方向に表示できるようになり、ツールが左右にポップアップ表示されます。 - ツールバーの `renderImageFromText` メソッドを介してカスタム SVG アイコンのサポートが追加され、カスタム ツールの作成がさらに強化されました。 -- It is now possible to apply a **dash array** to the different parts of the series of the `DataChart`. You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. +- It is now possible to apply a **dash array** to the different parts of the series of the . You can apply this to the [series](charts/types/line-chart.md#{PlatformLower}-styling-line-chart) plotted in the chart, the [gridlines](charts/features/chart-axis-gridlines.md#{PlatformLower}-axis-gridlines-properties) of the chart, and the [trendlines](charts/features/chart-trendlines.md#{PlatformLower}-chart-trendlines-dash-array-example) of the series plotted in the chart. ## **{PackageVerChanges-23-1}** - Angular 16 support. ## 新しいコンポーネント -- [Toolbar](menus/toolbar.md) - このコンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、`DataChart` または `CategoryChart` コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 +- [Toolbar](menus/toolbar.md) - このコンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、 または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 ## {PackageCharts} (チャート) -- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - `ValueLayer` という名前の新しいシリーズ タイプが公開されました。これにより、Maximum、Minimum、Average など、プロットされたデータのさまざまな焦点のオーバーレイを描画できます。これは、新しい `ValueLines` コレクションに追加することで、`CategoryChart` と `FinancialChart` に適用されます。 +- [ValueLayer](charts/features/chart-overlays.md#{PlatformLower}-value-layer) - という名前の新しいシリーズ タイプが公開されました。これにより、Maximum、Minimum、Average など、プロットされたデータのさまざまな焦点のオーバーレイを描画できます。これは、新しい コレクションに追加することで、 に適用されます。 -- **ダッシュ配列**を `DataChart` のシリーズのさまざまな部分に適用できるようになりました。これは、チャートにプロットされた[シリーズ](charts/types/line-chart.md#{PlatformLower}-折れ線チャートのスタイル設定)、チャートの[グリッド線](charts/features/chart-axis-gridlines.md#{PlatformLower}-軸グリッド線のプロパティ)、およびチャートにプロットされたシリーズの[トレンドライン](charts/features/chart-trendlines.md#{PlatformLower}-チャート-トレンドラインのダッシュ配列の例)に適用できます。 +- **ダッシュ配列**を のシリーズのさまざまな部分に適用できるようになりました。これは、チャートにプロットされた[シリーズ](charts/types/line-chart.md#{PlatformLower}-折れ線チャートのスタイル設定)、チャートの[グリッド線](charts/features/chart-axis-gridlines.md#{PlatformLower}-軸グリッド線のプロパティ)、およびチャートにプロットされたシリーズの[トレンドライン](charts/features/chart-trendlines.md#{PlatformLower}-チャート-トレンドラインのダッシュ配列の例)に適用できます。 -The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using `IncludedProperties` | `ExcludedProperties` because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. +The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not work when using | because these properties are meant for non-aggregated data. Once you attempt to aggregate data these properties should no longer be used. The reason it does not work is because aggregation replaces the collection that is passed to the chart for render. The include/exclude properties are designed to filter in/out properties of that data and those properties no longer exist in the new aggregated collection. ## **{PackageVerChanges-22-2.2}** ### **{PackageVerChanges-22-2.1}** @@ -404,29 +406,29 @@ The Chart's [Aggregation](charts/features/chart-data-aggregations.md) will not w This release introduces a few improvements and simplifications to visual design and configuration options for the geographic map and all chart components. -- Changed `YAxisLabelLocation` property's type to **YAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` and `CategoryChart` -- Changed `XAxisLabelLocation` property's type to **XAxisLabelLocation** from **AxisLabelLocation** in `FinancialChart` -- Added `XAxisLabelLocation` property to `CategoryChart` -- Added support for representing geographic series of `GeographicMap` in a legend -- Added crosshair lines by default in `FinancialChart` and `CategoryChart` -- Added crosshair annotations by default in `FinancialChart` and `CategoryChart` -- Added final value annotation by default in `FinancialChart` +- Changed property's type to **YAxisLabelLocation** from **AxisLabelLocation** in and +- Changed property's type to **XAxisLabelLocation** from **AxisLabelLocation** in +- Added property to +- Added support for representing geographic series of in a legend +- Added crosshair lines by default in and +- Added crosshair annotations by default in and +- Added final value annotation by default in - Added new properties in Category Chart and Financial Chart: - - `CrosshairsLineThickness` and other properties for customizing crosshairs lines - - `CrosshairsAnnotationXAxisBackground` and other properties for customizing crosshairs annotations - - `FinalValueAnnotationsBackground` and other properties for customizing final value annotations - - `AreaFillOpacity` that allow changing opacity of series fill (e.g. Area chart) - - `MarkerThickness` that allows changing thickness of markers + - and other properties for customizing crosshairs lines + - and other properties for customizing crosshairs annotations + - and other properties for customizing final value annotations + - that allow changing opacity of series fill (e.g. Area chart) + - that allows changing thickness of markers - Added new properties in Category Chart, Financial Chart, Data Chart, and Geographic Map: - - `MarkerAutomaticBehavior` that allows which marker type is assigned to multiple series in the same chart - - `LegendItemBadgeShape` for setting badge shape of all series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on all series in a legend + - that allows which marker type is assigned to multiple series in the same chart + - for setting badge shape of all series represented in a legend + - for setting badge complexity on all series in a legend - Added new properties in Series in Data Chart and Geographic Map: - - `LegendItemBadgeShape` for setting badge shape on specific series represented in a legend - - `LegendItemBadgeMode` for setting badge complexity on specific series in a legend + - for setting badge shape on specific series represented in a legend + - for setting badge complexity on specific series in a legend - Changed default vertical crosshair line stroke from #000000 to #BBBBBB in category chart and series -- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's `MarkerAutomaticBehavior` property to `SmartIndexed` enum value -- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's `LegendItemBadgeMode` property to `MatchSeries` enum value +- Changed shape of markers to circle for all series plotted in the same chart. This can be reverted by setting chart's property to `SmartIndexed` enum value +- Simplified shapes of series in chart's legend to display only circle, line, or square. This can be reverted by setting chart's property to `MatchSeries` enum value - Changed color palette of series and markers displayed in all charts to improve accessibility | Old brushes/outlines | New outline/brushes | @@ -447,23 +449,23 @@ This release introduces a few improvements and simplifications to visual design - Changed Scatter High Density series’ colors for heat max property from #ee5879 to #ee5879 - Changed Financial/Waterfall series’ `NegativeBrush` and `NegativeOutline` properties from #C62828 to #ee5879 - Changed marker's thickness to 2px from 1px -- Changed marker's fill to match the marker's outline for `PointSeries`, `BubbleSeries`, `ScatterSeries`, `PolarScatterSeries`. You can use set `MarkerFillMode` property to Normal to undo this change -- Compressed labelling for the `TimeXAxis` and `OrdinalTimeXAxis` +- Changed marker's fill to match the marker's outline for , , , . You can use set property to Normal to undo this change +- Compressed labelling for the and - New Marker Properties: - - series.`MarkerFillMode` - Can be set to `MatchMarkerOutline` so the marker depends on the outline - - series.`MarkerFillOpacity` - Can be set to a value 0 to 1 - - series.`MarkerOutlineMode` - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color + - series. - Can be set to `MatchMarkerOutline` so the marker depends on the outline + - series. - Can be set to a value 0 to 1 + - series. - Can be set to `MatchMarkerBrush` so the marker's outline depends on the fill brush color - New Series Property: - - series.`OutlineMode` - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series -- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the `ComputedPlotAreaMarginMode`, listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - Can be set to toggle the series outline visibility. Note, for Data Chart, the property is on the series +- New chart properties that define bleed over area introduced into the viewport when the chart is at the default zoom level. A common use case is to provide space between the axes and first/last data points. Note, the , listed below, will automatically set the margin when markers are enabled. The others are designed to specify a `Double` to represent the thickness, where PlotAreaMarginLeft etc. adjusts the space to all four sides of the chart: + - chart. + - chart. + - chart. + - chart. + - chart. - New Highlighting Properties - - chart.`HighlightingMode` - Sets whether hovered or non-hovered series to fade, brighten - - chart.`HighlightingBehavior` - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item + - chart. - Sets whether hovered or non-hovered series to fade, brighten + - chart. - Sets whether the series highlights depending on mouse position e.g. directly over or nearest item - Note, in previous releases the highlighting was limited to fade on hover. - Added Highlighting Stacked, Scatter, Polar, Radial, and Shape series: - Added Annotation layers to Stacked, Scatter, Polar, Radial, and Shape series: @@ -503,30 +505,30 @@ These features are CTP ## {PackageCharts} (チャート) -このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、`DataChart`、`CategoryChart`、および `FinancialChart`。 +このリリースでは、すべてのチャート コンポーネントに、いくつかの新しく改善されたビジュアル デザインと構成オプションが導入されています。例えば、、および 。 - 棒/縦棒/ウォーターフォール シリーズを、角丸ではなく角が四角になるように変更しました。 - heat min プロパティの 散布高密度シリーズの色を #8a5bb1 から #000000 に変更しました。 - heat max プロパティの 散布高密度シリーズの色を #ee5879 から #ee5879 に変更しました。 - ファイナンシャル/ウォーターフォール シリーズの `NegativeBrush` および `NegativeOutline` プロパティを #C62828 から #ee5879 に変更しました。 - マーカーの厚さを 1px から 2px に変更しました。 -- `PointSeries`、`BubbleSeries`、`ScatterSeries`、`PolarScatterSeries` のマーカーのアウトラインに一致するようにマーカーの塗りつぶしを変更しました。`MarkerFillMode` プロパティを Normal に設定すると、この変更を元に戻すことができます。 -- `TimeXAxis` および `OrdinalTimeXAxis` のラベリングを圧縮しました。 +- のマーカーのアウトラインに一致するようにマーカーの塗りつぶしを変更しました。 プロパティを Normal に設定すると、この変更を元に戻すことができます。 +- および のラベリングを圧縮しました。 - 新しいマーカー プロパティ: - - series.`MarkerFillMode` - マーカーがアウトラインに依存するように、`MatchMarkerOutline` に設定できます。 - - series.`MarkerFillOpacity` - 0〜1 の値に設定できます。 - - series.`MarkerOutlineMode` - マーカーのアウトラインが塗りブラシの色に依存するように、`MatchMarkerBrush` に設定できます。 + - series. - マーカーがアウトラインに依存するように、`MatchMarkerOutline` に設定できます。 + - series. - 0〜1 の値に設定できます。 + - series. - マーカーのアウトラインが塗りブラシの色に依存するように、`MatchMarkerBrush` に設定できます。 - 新シリーズプロパティ: - - series.`OutlineMode` - シリーズ アウトラインの表示を切り替えるように設定できます。データ チャートの場合、プロパティはシリーズ上にあることに注意してください。 - - チャートがデフォルトのズーム レベルにあるときにビューポートに導入されるブリード オーバー領域を定義する新しいチャート プロパティを追加しました。一般的な使用例では、軸と最初/最後のデータ ポイントの間にスペースを提供します。以下にリストされている `ComputedPlotAreaMarginMode` は、マーカーが有効になっているときに自動的にマージンを設定することに注意してください。その他は、厚さを表す `Double` を指定するように設計されており、PlotAreaMarginLeft などがチャートの 4 辺すべてにスペースを調整します: - - chart.`PlotAreaMarginLeft` - - chart.`PlotAreaMarginTop` - - chart.`PlotAreaMarginRight` - - chart.`PlotAreaMarginBottom` - - chart.`ComputedPlotAreaMarginMode` + - series. - シリーズ アウトラインの表示を切り替えるように設定できます。データ チャートの場合、プロパティはシリーズ上にあることに注意してください。 + - チャートがデフォルトのズーム レベルにあるときにビューポートに導入されるブリード オーバー領域を定義する新しいチャート プロパティを追加しました。一般的な使用例では、軸と最初/最後のデータ ポイントの間にスペースを提供します。以下にリストされている は、マーカーが有効になっているときに自動的にマージンを設定することに注意してください。その他は、厚さを表す `Double` を指定するように設計されており、PlotAreaMarginLeft などがチャートの 4 辺すべてにスペースを調整します: + - chart. + - chart. + - chart. + - chart. + - chart. - 新しいハイライト表示プロパティ: - - chart.`HighlightingMode` - ホバーされたシリーズとホバーされていないシリーズをフェードまたは明るくするかを設定します。 - - chart.`HighlightingBehavior` - 真上または最も近い項目など、マウスの位置に応じてシリーズをハイライト表示するかどうかを設定します。 + - chart. - ホバーされたシリーズとホバーされていないシリーズをフェードまたは明るくするかを設定します。 + - chart. - 真上または最も近い項目など、マウスの位置に応じてシリーズをハイライト表示するかどうかを設定します。 - 以前のリリースでは、ハイライト表示はホバー時にフェードするように制限されていたことに注意してください。 - 積層型、散布図、極座標、ラジアル、図形シリーズにハイライト表示を追加しました。 - 積層型、散布図、極座標、ラジアル、図形注釈レイヤーを追加しました。 diff --git a/docs/xplat/src/content/jp/components/general-cli-overview.mdx b/docs/xplat/src/content/jp/components/general-cli-overview.mdx index ff43f6aa96..f36315be1c 100644 --- a/docs/xplat/src/content/jp/components/general-cli-overview.mdx +++ b/docs/xplat/src/content/jp/components/general-cli-overview.mdx @@ -97,7 +97,7 @@ ig add [component_template] [component_name] ig add grid MyGridComponent ``` - + ルーティング ファイルは、新しいコンポーネントを含むページへのパス (この場合は `/my-grid-component`) で更新されます。これを使用して、新しく生成されたページに手動で移動できます。 diff --git a/docs/xplat/src/content/jp/components/geo-map-binding-data-model.mdx b/docs/xplat/src/content/jp/components/geo-map-binding-data-model.mdx index ebb947a067..13a3296d84 100644 --- a/docs/xplat/src/content/jp/components/geo-map-binding-data-model.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-binding-data-model.mdx @@ -30,13 +30,13 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; | Geographic シリーズ | プロパティ | 概要 | |--------------|---------------| ---------------| -| | `LongitudeMemberPath`、`LatitudeMemberPath` | 2 つの数値の経度と緯度座標の名前を指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath` | 2 つの数値の経度と緯度座標の名前を指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath`、`RadiusMemberPath` | 2 つの経度座標と緯度座標の名前と、シンボルのサイズ/半径の数字列を 1 列指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath`、`ColorMemberPath` | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | -| | `LongitudeMemberPath`、`LatitudeMemberPath`、`ValueMemberPath` | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | -||`ShapeMemberPath`|図形の地理的ポイントを含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | -||`ShapeMemberPath`|線の地理的座標を含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | +| | | 2 つの数値の経度と緯度座標の名前を指定します。 | +| | | 2 つの数値の経度と緯度座標の名前を指定します。 | +| | | 2 つの経度座標と緯度座標の名前と、シンボルのサイズ/半径の数字列を 1 列指定します。 | +| | | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | +| | | 数値の三角測量のために、2 つの経度と緯度座標および数値列を 1 列指定します。 | +|||図形の地理的ポイントを含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | +|||線の地理的座標を含む 項目のデータ列の名前を指定します。このプロパティは、x プロパティと y プロパティを持つオブジェクトの配列の配列にマップする必要があります。 | ## コード スニペット 以下のコードは、 を、経度と緯度の座標を使用して格納された世界の一部の都市の地理的位置を含むカスタム データ モデルにバインドする方法を示します。また、[WorldUtility](geo-map-resources-world-util.md) を使用してこれらの場所間の最短の地理的経路をプロットするために を使用します。 diff --git a/docs/xplat/src/content/jp/components/geo-map-binding-shp-file.mdx b/docs/xplat/src/content/jp/components/geo-map-binding-shp-file.mdx index c75c7ad833..8669209454 100644 --- a/docs/xplat/src/content/jp/components/geo-map-binding-shp-file.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-binding-shp-file.mdx @@ -12,7 +12,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} シェープ ファイルを地理的データにバインディング -{ProductName} Map コンポーネントの クラスは、形状ファイルから地理空間データ (ポイント/位置、ポリライン、ポリゴン) を読み込み、それを オブジェクトのコレクションに変換します。 +{ProductName} Map コンポーネントの クラスは、形状ファイルから地理空間データ (ポイント/位置、ポリライン、ポリゴン) を読み込み、それを オブジェクトのコレクションに変換します。 ## {Platform} シェープ ファイルを地理的データにバインディングの例 @@ -20,20 +20,20 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro';
-以下の表は、シェイプ ファイルを読み込むための クラスのプロパティを説明します。 +以下の表は、シェイプ ファイルを読み込むための クラスのプロパティを説明します。 | プロパティ | 型 | 概要 | |----------|------|---------------| -| `ShapefileSource` | string |シェイプ ファイル(.shp) から読み込まれた 1 つの地理空間シェープにすべてのポイントが含まれます。| -|`DatabaseSource` | string |たとえば、シェープファイルで日本は、以下でポイント オブジェクト リストのリストとして表されます。| +| | string |シェイプ ファイル(.shp) から読み込まれた 1 つの地理空間シェープにすべてのポイントが含まれます。| +| | string |たとえば、シェープファイルで日本は、以下でポイント オブジェクト リストのリストとして表されます。| -両方のソース プロパティが null 以外の値に設定されると、 オブジェクトの ImportAsync メソッドが起動し、シェイプ ファイルを取得して読み込み、最終的に変換を実行します。この操作が完了すると、 オブジェクトで生成され、シェイプ ファイルから地理空間データを読み込んで変換するプロセスが完了したことを通知するために、`ImportCompleted` イベントが起動されます。 +両方のソース プロパティが null 以外の値に設定されると、 オブジェクトの ImportAsync メソッドが起動し、シェイプ ファイルを取得して読み込み、最終的に変換を実行します。この操作が完了すると、 オブジェクトで生成され、シェイプ ファイルから地理空間データを読み込んで変換するプロセスが完了したことを通知するために、`ImportCompleted` イベントが起動されます。 ## シェープファイルの読み込み -以下のコードは、世界の主要都市の場所を含むシェイプ ファイルを読み込むための オブジェクトのインスタンスを作成します。また、xamGeographicMap コントロールにデータをバインドするための前提条件として `ImportCompleted` イベントを処理する方法も示します。 +以下のコードは、世界の主要都市の場所を含むシェイプ ファイルを読み込むための オブジェクトのインスタンスを作成します。また、xamGeographicMap コントロールにデータをバインドするための前提条件として `ImportCompleted` イベントを処理する方法も示します。 ```html @@ -57,9 +57,9 @@ sds.dataBind(); ## シェープファイルをバインド -Map コンポーネントでは、Geographic Series は、シェイプ ファイルから読み込まれる地理的データを表示するために使用されます。すべてのタイプの地理的シリーズには、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。 オブジェクトのリストを含むため、このような配列の例です。 +Map コンポーネントでは、Geographic Series は、シェイプ ファイルから読み込まれる地理的データを表示するために使用されます。すべてのタイプの地理的シリーズには、オブジェクトの配列にバインドできる プロパティがあります。 オブジェクトのリストを含むため、このような配列の例です。 -`ShapefileRecord` クラスは、以下の表にリストする地理的データを保存するためのプロパティを提供します。 + クラスは、以下の表にリストする地理的データを保存するためのプロパティを提供します。 | プロパティ | 概要 | |--------------|---------------| @@ -69,8 +69,8 @@ Map コンポーネントでは、Geographic Series は、シェイプ ファイ このデータ構造は、適切なデータ列がマップされている限り、ほとんどの地理的シリーズでの使用に適しています。 ## コード スニペット -このコード例は、シェープ ファイルが を使用して読み込まれたことを前提としています。 -以下のコードは、マップ コンポーネント内の にバインドし、すべての オブジェクトの `Points` プロパティをマップします。 +このコード例は、シェープ ファイルが を使用して読み込まれたことを前提としています。 +以下のコードは、マップ コンポーネント内の にバインドし、すべての オブジェクトの `Points` プロパティをマップします。 @@ -286,4 +286,4 @@ onDataLoaded(sds: IgcShapeDataSource, e: any) { ## API リファレンス
-
+
diff --git a/docs/xplat/src/content/jp/components/geo-map-display-azure-imagery.mdx b/docs/xplat/src/content/jp/components/geo-map-display-azure-imagery.mdx index 70c5361d9e..556a8b0648 100644 --- a/docs/xplat/src/content/jp/components/geo-map-display-azure-imagery.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-display-azure-imagery.mdx @@ -29,7 +29,7 @@ import Badge from 'igniteui-astro-components/components/mdx/Badge.astro'; ## {Platform} Azure Maps からの画像の表示 - コード例 -以下のコード スニペットは、 クラスを使用して {Platform} `GeographicMap` で Azure Maps からの地理的画像タイルを表示する方法を示します。 +以下のコード スニペットは、 クラスを使用して {Platform} で Azure Maps からの地理的画像タイルを表示する方法を示します。 @@ -130,8 +130,8 @@ map.backgroundContent = tileSource; を使用する際には、**ベース マップ スタイル** (例: **Satellite**, **Road**, **DarkGrey**) の上に**オーバーレイ** (交通情報、天気、ラベル) を重ね合わせることができます。例えば **Satellite** と **TerraOverlay** を組み合わせることで、地形を視覚化できます。 - **ベース スタイル**: Satellite、Road、Terra、DarkGrey がコアとなる背景タイルを提供します。 -- **オーバーレイ スタイル**: 交通情報や天気の画像 (`TrafficRelativeOverlay`、`WeatherRadarOverlay` など) は、タイル シリーズに割り当てることでベース スタイル上に重ねられるよう設計されています。 -- **ハイブリッド スタイル**: `HybridRoadOverlay` や `HybridDarkGreyOverlay` などのバリエーションは、ベース スタイルにラベルや道路などのオーバーレイをあらかじめ組み合わせているため、複数のレイヤーを手動で管理する必要はありません。 +- **オーバーレイ スタイル**: 交通情報や天気の画像 ( など) は、タイル シリーズに割り当てることでベース スタイル上に重ねられるよう設計されています。 +- **ハイブリッド スタイル**: などのバリエーションは、ベース スタイルにラベルや道路などのオーバーレイをあらかじめ組み合わせているため、複数のレイヤーを手動で管理する必要はありません。 この設計により、より豊かなマップ表現が可能になります。例えば: - **Satellite** 画像に **TrafficOverlay** を重ねて、実際の地図上に渋滞状況をハイライト表示。 @@ -143,7 +143,7 @@ map.backgroundContent = tileSource;
## Azure Maps からの画像オーバーレイ - コード例 -次のコード スニペットは、 クラスと クラスを使用して、{Platform} `GeographicMap` の交通情報と濃い灰色のマップを結合した背景画像の上に地理画像タイルを表示する方法を示しています。 +次のコード スニペットは、 クラスと クラスを使用して、{Platform} の交通情報と濃い灰色のマップを結合した背景画像の上に地理画像タイルを表示する方法を示しています。 @@ -337,7 +337,7 @@ window.addEventListener("load", () => { | プロパティ名 | プロパティ タイプ | 説明 | |----------------|-----------------|---------------| ||string|Azure Maps 画像サービスで必要となる API キーを設定するためのプロパティを表します。このキーは
azure.microsoft.com ウェブサイトから取得してください。| -||`AzureMapsImageryStyle`|Azure Maps 画像タイルのマップ スタイルを設定するプロパティを表します。このプロパティは、以下の `AzureMapsImageryStyle` 列挙値に設定できます。
  • Satellite - 道路またはラベルのオーバーレイなしの衛星地図スタイルを指定します。
  • Road - 道路およびラベル付きの衛星地図スタイルを指定します。
  • DarkGrey - コントラストやオーバーレイのハイライト表示に適したダーク グレーのベース マップ スタイルを指定します。
  • TerraOverlay - 標高や地形の特徴をハイライト表示する陰影起伏付きの地形マップ スタイルを指定します。
  • LabelsRoadOverlay - 航空写真オーバーレイなしで都市ラベルを表示する複数のオーバーレイの 1 つです。
  • HybridRoadOverlay - 衛星画像の背景に道路とラベルのオーバーレイを組み合わせます。
  • HybridDarkGreyOverlay - 衛星画像の背景にダーク グレーのラベル オーバーレイを組み合わせます。
  • LabelsDarkGreyOverlay - ダーク グレーのベース マップ上に都市ラベルを表示する複数のオーバーレイの 1 つです。
  • TrafficDelayOverlay - 交通遅延や渋滞エリアをリアルタイムで表示します。
  • TrafficAbsoluteOverlay - 現在の交通速度を絶対値で表示します。
  • TrafficReducedOverlay - 減少した交通流を光ベースの視覚化で表示します。
  • TrafficRelativeOverlay - 通常の状況に対する相対的な交通速度を表示します。
  • TrafficRelativeDarkOverlay - 通常時と比較した交通速度をダーク ベースマップ上に表示し、コントラストを強調します。
  • WeatherRadarOverlay - 降水のほぼリアルタイムのレーダー画像を表示します。
  • WeatherInfraredOverlay - 雲量の赤外線衛星画像を表示します。
| +|||Azure Maps 画像タイルのマップ スタイルを設定するプロパティを表します。このプロパティは、以下の 列挙値に設定できます。
  • Satellite - 道路またはラベルのオーバーレイなしの衛星地図スタイルを指定します。
  • Road - 道路およびラベル付きの衛星地図スタイルを指定します。
  • DarkGrey - コントラストやオーバーレイのハイライト表示に適したダーク グレーのベース マップ スタイルを指定します。
  • TerraOverlay - 標高や地形の特徴をハイライト表示する陰影起伏付きの地形マップ スタイルを指定します。
  • LabelsRoadOverlay - 航空写真オーバーレイなしで都市ラベルを表示する複数のオーバーレイの 1 つです。
  • HybridRoadOverlay - 衛星画像の背景に道路とラベルのオーバーレイを組み合わせます。
  • HybridDarkGreyOverlay - 衛星画像の背景にダーク グレーのラベル オーバーレイを組み合わせます。
  • LabelsDarkGreyOverlay - ダーク グレーのベース マップ上に都市ラベルを表示する複数のオーバーレイの 1 つです。
  • TrafficDelayOverlay - 交通遅延や渋滞エリアをリアルタイムで表示します。
  • TrafficAbsoluteOverlay - 現在の交通速度を絶対値で表示します。
  • TrafficReducedOverlay - 減少した交通流を光ベースの視覚化で表示します。
  • TrafficRelativeOverlay - 通常の状況に対する相対的な交通速度を表示します。
  • TrafficRelativeDarkOverlay - 通常時と比較した交通速度をダーク ベースマップ上に表示し、コントラストを強調します。
  • WeatherRadarOverlay - 降水のほぼリアルタイムのレーダー画像を表示します。
  • WeatherInfraredOverlay - 雲量の赤外線衛星画像を表示します。
| ## API リファレンス diff --git a/docs/xplat/src/content/jp/components/geo-map-display-bing-imagery.mdx b/docs/xplat/src/content/jp/components/geo-map-display-bing-imagery.mdx index e2dd8182e6..65aac68de4 100644 --- a/docs/xplat/src/content/jp/components/geo-map-display-bing-imagery.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-display-bing-imagery.mdx @@ -34,7 +34,7 @@ import bingmapsimagery from '@xplat-images/general/BingMapsImagery.png';
## コード スニペット -以下のコード スニペットは、 を使用して {Platform} `GeographicMap` で Bing Maps からの地理的画像を表示する方法を示します。 +以下のコード スニペットは、 を使用して {Platform} で Bing Maps からの地理的画像を表示する方法を示します。 diff --git a/docs/xplat/src/content/jp/components/geo-map-display-esri-imagery.mdx b/docs/xplat/src/content/jp/components/geo-map-display-esri-imagery.mdx index f39854d3a9..d58fb1909a 100644 --- a/docs/xplat/src/content/jp/components/geo-map-display-esri-imagery.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-display-esri-imagery.mdx @@ -26,7 +26,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro';
## コード スニペット -以下のコード スニペットは、 クラスを使用して `GeographicMap` で Esri 画像サーバーからの {Platform} 地理的画像タイルを表示する方法を示します。 +以下のコード スニペットは、 クラスを使用して で Esri 画像サーバーからの {Platform} 地理的画像タイルを表示する方法を示します。 diff --git a/docs/xplat/src/content/jp/components/geo-map-display-heat-imagery.mdx b/docs/xplat/src/content/jp/components/geo-map-display-heat-imagery.mdx index d32405ac8f..42de167e0a 100644 --- a/docs/xplat/src/content/jp/components/geo-map-display-heat-imagery.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-display-heat-imagery.mdx @@ -26,18 +26,18 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro';
- がそのシェイプ ファイルを読み込むと、そのデータを オブジェクトに変換します。これらのオブジェクトは、 の `GetPointData()` メソッドから取得でき、`TileGenerator` プロパティに割り当てられた オブジェクトを使用してヒートマップを作成するために使用できます。この は、`TileImagery` ソースとして で使用できます。 + がそのシェイプ ファイルを読み込むと、そのデータを オブジェクトに変換します。これらのオブジェクトは、 の `GetPointData()` メソッドから取得でき、 プロパティに割り当てられた オブジェクトを使用してヒートマップを作成するために使用できます。この は、 ソースとして で使用できます。 - オブジェクトは、`XValues`、`YValues`、`Values` の 3 つの値パスを持つように機能します。これらの使用方法の例として、人口に関する情報を持つ形状ファイルの場合、`XValues` を経度、`YValues` を緯度、`Values` を人口データとみなすことができます。これらの各プロパティは、`number[]` を取得します。 + オブジェクトは、 の 3 つの値パスを持つように機能します。これらの使用方法の例として、人口に関する情報を持つ形状ファイルの場合、 を経度、 を緯度、 を人口データとみなすことができます。これらの各プロパティは、`number[]` を取得します。 -ヒートマップ機能を使用する際の地理的タイルシリーズの表示は、`MinimumColor` プロパティと `MaximumColor` プロパティを の `Values` プロパティに割り当てるコレクションの最小値と最大値に対応する色を記述する「rgba」文字列に設定することでカスタマイズできます。これをさらにカスタマイズするには、ジェネレーターの `ScaleColors` プロパティを設定して、色を説明する文字列のコレクションを含めます。これにより、 に、マップに表示される値に使用する色がわかります。`BlurRadius`、`MaxBlurRadius`、`UseBlurRadiusAdjustedForZoom` プロパティを使用して、`ScaleColors` コレクション内の色が一緒にぼやける方法をカスタマイズすることもできます。 +ヒートマップ機能を使用する際の地理的タイルシリーズの表示は、 プロパティと プロパティを プロパティに割り当てるコレクションの最小値と最大値に対応する色を記述する「rgba」文字列に設定することでカスタマイズできます。これをさらにカスタマイズするには、ジェネレーターの プロパティを設定して、色を説明する文字列のコレクションを含めます。これにより、 に、マップに表示される値に使用する色がわかります。 プロパティを使用して、 コレクション内の色が一緒にぼやける方法をカスタマイズすることもできます。 - は対数スケールも使用できます。これを使用する場合は、`UseLogarithmicScale` プロパティを **true** に設定できます。 + は対数スケールも使用できます。これを使用する場合は、 プロパティを **true** に設定できます。 ## Web Worker -また、`HeatTileGenerator` は、Web Worker が、別のスレッドでシェイプ ファイルからタイル イメージをロードする際の重いリフティングをサポートしています。これにより、ヒートマップ機能を使用する際に地理マップのパフォーマンスが大幅に向上します。ジェネレーターでWebワーカーを使用するには、`UseWebWorkers` プロパティを **true** に設定し、`WebWorkerInstance` プロパティを Web Worker のインスタンスに設定できます。 +また、 は、Web Worker が、別のスレッドでシェイプ ファイルからタイル イメージをロードする際の重いリフティングをサポートしています。これにより、ヒートマップ機能を使用する際に地理マップのパフォーマンスが大幅に向上します。ジェネレーターでWebワーカーを使用するには、 プロパティを **true** に設定し、 プロパティを Web Worker のインスタンスに設定できます。 ```ts @@ -409,7 +409,7 @@ public onDataLoaded(csvData: string) { ## API リファレンス
-
+



diff --git a/docs/xplat/src/content/jp/components/geo-map-display-imagery-types.mdx b/docs/xplat/src/content/jp/components/geo-map-display-imagery-types.mdx index e58374d2d7..ee41392a04 100644 --- a/docs/xplat/src/content/jp/components/geo-map-display-imagery-types.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-display-imagery-types.mdx @@ -53,6 +53,6 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## API リファレンス -`BackgroundContent`
+


diff --git a/docs/xplat/src/content/jp/components/geo-map-navigation.mdx b/docs/xplat/src/content/jp/components/geo-map-navigation.mdx index a36dcd6841..735ef5946d 100644 --- a/docs/xplat/src/content/jp/components/geo-map-navigation.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-navigation.mdx @@ -17,7 +17,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} コンテンツのナビゲーション -`GeographicMap` コントロールのナビゲーションは、既定では有効にされており、マップ コンテンツのズームとパンが可能です。ただし、この動作は プロパティを使用して変更できます。マップでは同期ズームのみが許可されていること、つまり、アスペクト比を維持したままマップコンテンツをスケーリングすることを知っておくことが重要です。結果として、マップコンテンツを水平方向にスケーリングせずに垂直方向にスケーリングすることはできません。 + コントロールのナビゲーションは、既定では有効にされており、マップ コンテンツのズームとパンが可能です。ただし、この動作は プロパティを使用して変更できます。マップでは同期ズームのみが許可されていること、つまり、アスペクト比を維持したままマップコンテンツをスケーリングすることを知っておくことが重要です。結果として、マップコンテンツを水平方向にスケーリングせずに垂直方向にスケーリングすることはできません。 ## {Platform} コンテンツのナビゲーションの例 @@ -90,7 +90,7 @@ this.GeoMap.WindowScale = 0.5;
## プロパティ -以下の表は `GeographicMap` コントロールのナビゲーションで使用できるプロパティをまとめたものです。 +以下の表は コントロールのナビゲーションで使用できるプロパティをまとめたものです。 | プロパティ名 | プロパティ型 | 概要 | |----------------|-----------------|---------------| diff --git a/docs/xplat/src/content/jp/components/geo-map-resources-esri.mdx b/docs/xplat/src/content/jp/components/geo-map-resources-esri.mdx index 2df67d4f0f..ee43b56d7c 100644 --- a/docs/xplat/src/content/jp/components/geo-map-resources-esri.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-resources-esri.mdx @@ -12,7 +12,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} Esri ユーティリティ -リソース トピックは、Esri Maps が `GeographicMap` で提供する の使用に役立つユーティリティの実装を提供します。 +リソース トピックは、Esri Maps が で提供する の使用に役立つユーティリティの実装を提供します。 ## コード スニペット diff --git a/docs/xplat/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx b/docs/xplat/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx index 16ade1e1f6..d8636983ad 100644 --- a/docs/xplat/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-resources-shape-styling-utility.mdx @@ -12,7 +12,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} シェイプ スタイリング ユーティリティ -リソース トピックは、{Platform} `GeographicMap` コンポーネントで の UI 要素のスタイリングに役立つユーティリティの実装を提供します。 +リソース トピックは、{Platform} コンポーネントで の UI 要素のスタイリングに役立つユーティリティの実装を提供します。 ## 必要なインポート diff --git a/docs/xplat/src/content/jp/components/geo-map-shape-styling.mdx b/docs/xplat/src/content/jp/components/geo-map-shape-styling.mdx index 3db91977b8..d9010d720f 100644 --- a/docs/xplat/src/content/jp/components/geo-map-shape-styling.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-shape-styling.mdx @@ -13,7 +13,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} 地理シェイプ シリーズのスタイル設定 -このトピックでは、{Platform} `GeographicMap` で にカスタム スタイリングを適用する方法を説明します。 +このトピックでは、{Platform} にカスタム スタイリングを適用する方法を説明します。 ## {Platform} 地理シェイプ シリーズのスタイル設定の例 diff --git a/docs/xplat/src/content/jp/components/geo-map-type-scatter-area-series.mdx b/docs/xplat/src/content/jp/components/geo-map-type-scatter-area-series.mdx index ffd2f06acb..850d80b808 100644 --- a/docs/xplat/src/content/jp/components/geo-map-type-scatter-area-series.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-type-scatter-area-series.mdx @@ -28,35 +28,35 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; と同様ですが、同じ値を持つデータポイントを接続する等線の置換に補完で色つきサーフェス エリアとしてデータを表します。 ## データ要件 -マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的な経度および緯度座標を保管し、1 つのデータ列は地理的位置に関連した値を保管します。地理的シリーズの `LongitudeMemberPath`、`LatitudeMemberPath` および `ColorMemberPath` プロパティはこれらのデータ列を識別します。 - は、三角測量が `TrianglesSource` プロパティに設定されていない場合、ItemsSource の項目で組み込みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために TriangulationSource を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 +マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的な経度および緯度座標を保管し、1 つのデータ列は地理的位置に関連した値を保管します。地理的シリーズの および プロパティはこれらのデータ列を識別します。 + は、三角測量が プロパティに設定されていない場合、ItemsSource の項目で組み込みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために TriangulationSource を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 ## データ バインディング 以下の表に、データ バインドに使用される GeographicScatterAreaSeries のプロパティをまとめています。 | プロパティ名 | プロパティ型 | 説明 | |--------------|---------------| ---------------| -|`ItemsSource`|任意|`TrianglesSource` プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| -|`LongitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の経度を含むプロパティの名前。| -|`LatitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の Latitude を含むプロパティの名前。| -|`ColorMemberPath`|文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。`ColorScale` プロパティが設定されている場合、この数値は色に変換されます。| -|`TrianglesSource`|任意|三角測量データのソース。`TriangulationSource` オブジェクトの Triangles をこのプロパティに設定すると、ランタイム パフォーマンスと地理的シリーズの描画の両方が改善します。| -|`TriangleVertexMemberPath1`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、`TrianglesSource` 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath2`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、`TrianglesSource` 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath3`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、`TrianglesSource` 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||任意| プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| +||文字列| にバインドされているすべての項目の経度を含むプロパティの名前。| +||文字列| にバインドされているすべての項目の Latitude を含むプロパティの名前。| +||文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。 プロパティが設定されている場合、この数値は色に変換されます。| +||任意|三角測量データのソース。`TriangulationSource` オブジェクトの Triangles をこのプロパティに設定すると、ランタイム パフォーマンスと地理的シリーズの描画の両方が改善します。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| ## カラー スケール の ColorScale プロパティを使用して、ポイントの色の値を解決し、地理的シリーズの面を塗りつぶします。色は、ピクセル単位の三角ラスタライザーを三角測量データに適用することによって、サーフェスの図形の周りをなめらかに補間します。サーフェスの描画がピクセル単位であるため、カラー スケールはブラシではなく色を使用します。 提供される クラスはほとんどのカラーリングのニーズを満たすはずですが、ColorScale ベースのクラスはカスタムのカラリング ロジックのアプリケーションによって継承できます。 -以下の表は GeographicScatterAreaSeries の面のカラリングに影響する `CustomPaletteColorScale` プロパティをリストします。 +以下の表は GeographicScatterAreaSeries の面のカラリングに影響する プロパティをリストします。 | Property Name | Property Type | Description | |--------------|---------------| ---------------| -|`Palette`| `ObservableCollection` |Gets or sets the collection of colors to select from or to interpolate between.| -|`InterpolationMode`|`ColorScaleInterpolationMode`|Gets or sets the method getting a color from the Palette.| -|`MaximumValue`|double|The highest value to assign a color. Any given value greater than this value will be Transparent.| -|`MinimumValue`|double|The lowest value to assign a color. Any given value less than this value will be Transparent.| +|| `ObservableCollection` |Gets or sets the collection of colors to select from or to interpolate between.| +|||Gets or sets the method getting a color from the Palette.| +||double|The highest value to assign a color. Any given value greater than this value will be Transparent.| +||double|The lowest value to assign a color. Any given value less than this value will be Transparent.| ## コード スニペット 以下のコードは、 を世界の表面温度を表す三角測量データにバインドする方法を示しています。 diff --git a/docs/xplat/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx b/docs/xplat/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx index a13078ee0c..fc2aae71c5 100644 --- a/docs/xplat/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-type-scatter-bubble-series.mdx @@ -28,19 +28,19 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; 上記のデモは、 シリーズと、シリーズのデータ​​バインディングオプションを指定する方法を示しています。予定表連動マーカー選択は、マーカー競合回避ロジックと合わせて構成され、マーカー アウトラインと塗りつぶしの色も指定されます。 ## 構成の概要 - マップコントロールの他のタイプの散布シリーズと同様に、 シリーズには、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。`LongitudeMemberPath` と `LatitudeMemberPath` プロパティを使用してこのデータ列をマップします。`RadiusScale` と `RadiusMemberPath` は、バブルの半径を設定します。 + マップコントロールの他のタイプの散布シリーズと同様に、 シリーズには、オブジェクトの配列にバインドできる プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。 プロパティを使用してこのデータ列をマップします。 は、バブルの半径を設定します。 以下の表に、データ バインドに使用される GeographicHighDensityScatterSeries シリーズのプロパティをまとめています。 | プロパティ|タイプ|概要 | | ---|---|--- | -| `ItemsSource`|any|項目のソースを取得または設定します | -| `LongitudeMemberPath`|string|ItemsSource プロパティを使用して、割り当てられた商品の経度の値の場所を特定します。 | -| `LatitudeMemberPath`|string|ItemsSource プロパティを使用して、割り当てられた商品の緯度値の場所を決定します。 | -| `RadiusMemberPath`|string|シリーズの半径値を取得するために使用するパスを設定します。 | -| `RadiusScale`|`SizeScale`|現在のバブル シリーズの半径スケール プロパティを取得または設定します。 | -| `MinimumValue`|any|値のサブ範囲を計算するための最小値を設定します。 | -| `MaximumValue`|any|値のサブ範囲を計算するための最大値を設定します。 | +| |any|項目のソースを取得または設定します | +| |string|ItemsSource プロパティを使用して、割り当てられた商品の経度の値の場所を特定します。 | +| |string|ItemsSource プロパティを使用して、割り当てられた商品の緯度値の場所を決定します。 | +| |string|シリーズの半径値を取得するために使用するパスを設定します。 | +| ||現在のバブル シリーズの半径スケール プロパティを取得または設定します。 | +| |any|値のサブ範囲を計算するための最小値を設定します。 | +| |any|値のサブ範囲を計算するための最大値を設定します。 | ## コード スニペット @@ -343,4 +343,4 @@ addSeriesWith(locations: any[]) ## API リファレンス
-`RadiusScale`
+
diff --git a/docs/xplat/src/content/jp/components/geo-map-type-scatter-contour-series.mdx b/docs/xplat/src/content/jp/components/geo-map-type-scatter-contour-series.mdx index a9165e9bc7..ebd0adfbd2 100644 --- a/docs/xplat/src/content/jp/components/geo-map-type-scatter-contour-series.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-type-scatter-contour-series.mdx @@ -28,33 +28,33 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; とよく似ていますが、塗りつぶしスケールを使用して色付けされた等高線としてデータを表し、地理散布エリア シリーズはカラースケールを使用して補間された面としてデータを表します。 ## データ要件 -マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的位置 (経度および緯度座標) を保管し、1 つのデータ列は地理的位置に関連した値を保管します。これらのデータ列は、地理的シリーズの `LongitudeMemberPath`、`LatitudeMemberPath` および `ValueMemberPath` プロパティによって識別されます。 - は、三角測量が `TrianglesSource` プロパティに設定されていない場合、ItemsSource の項目で定義済みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために `TriangulationSource` を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 +マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、項目ソースの各項目にはデータ列が 3 つあり、2 つは地理的位置 (経度および緯度座標) を保管し、1 つのデータ列は地理的位置に関連した値を保管します。これらのデータ列は、地理的シリーズの および プロパティによって識別されます。 + は、三角測量が プロパティに設定されていない場合、ItemsSource の項目で定義済みのデータ三角測量を自動的に実行します。ただし、三角測量の計算は非常に時間のかかるプロセスであるため、このプロパティのために `TriangulationSource` を指定すると、ランタイム パフォーマンスがよくなります。特にデータ項目が多数ある場合には顕著です。 ## データ バインディング -以下の表は、データ バインドに使用される `GeographicContourLineSeries` プロパティの概要です。 +以下の表は、データ バインドに使用される プロパティの概要です。 | プロパティ名 | プロパティ型 | 概要 | |--------------|---------------| ---------------| -|`ItemsSource`|任意|`TrianglesSource` プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| -|`LongitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の経度を含むプロパティの名前。| -|`LatitudeMemberPath`|文字列|`ItemsSource` にバインドされているすべての項目の Latitude を含むプロパティの名前。| -|`ValueMemberPath`|文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。`FillScale` プロパティが設定されている場合、この数値は色に変換されます。| -|`TrianglesSource`|任意|三角測量データのソースを取得または設定します。TriangulationSource オブジェクトの Triangles をこのプロパティに設定すると、ランタイムパフォーマンスと地理的シリーズレンダリングの両方が向上します。| -|`TriangleVertexMemberPath1`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath2`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| -|`TriangleVertexMemberPath3`|文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||任意| プロパティが三角測量データを提供しない場合に三角測量を実行するデータ項目のソースです。| +||文字列| にバインドされているすべての項目の経度を含むプロパティの名前。| +||文字列| にバインドされているすべての項目の Latitude を含むプロパティの名前。| +||文字列|各データ項目の緯度および経度座標の値を含むプロパティの名前。 プロパティが設定されている場合、この数値は色に変換されます。| +||任意|三角測量データのソースを取得または設定します。TriangulationSource オブジェクトの Triangles をこのプロパティに設定すると、ランタイムパフォーマンスと地理的シリーズレンダリングの両方が向上します。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| +||文字列|各三角形に対して ItemsSource の最初の頂点のインデックスを含む、TrianglesSource 項目のプロパティ名。このプロパティを設定することは義務ではありません。カスタムの三角測量ロジックが提供されない場合はデフォルトで取得されます。| ## 等高線の塗りつぶしスケール - の `FillScale` を使用して地理的シリーズの等高線の塗りブラシを解決します。 + を使用して地理的シリーズの等高線の塗りブラシを解決します。 ValueBrushScale クラスは、ユーザーの色分けのニーズもほとんどを満たすはずですが、カスタムの色分けロジックのアプリケーションで ValueBrushScale クラスを継承できます。 以下の表は、GeographicContourLineSeries のサーフェス カラーリングに影響を与える CustomPaletteColorScale のプロパティの一覧です。 | プロパティ名 | プロパティ型 | 概要 | |--------------|---------------| ---------------| -|`Brushes`|BrushCollection|`GeographicContourLineSeries` の輪郭を塗りつぶすためのブラシのコレクションを取得または設定します。| -|`MaximumValue`|double|塗りつぶしスケールでブラシを割り当てるための最高値。| -|`MinimumValue`|double|塗りつぶしスケールでブラシを割り当てるための最低値。| +||BrushCollection| の輪郭を塗りつぶすためのブラシのコレクションを取得または設定します。| +||double|塗りつぶしスケールでブラシを割り当てるための最高値。| +||double|塗りつぶしスケールでブラシを割り当てるための最低値。| ## コード スニペット @@ -378,7 +378,7 @@ createContourSeries(data: any[]) ## API リファレンス -`FillScale`
+



diff --git a/docs/xplat/src/content/jp/components/geo-map-type-scatter-density-series.mdx b/docs/xplat/src/content/jp/components/geo-map-type-scatter-density-series.mdx index 1e4189bd82..8397d3b635 100644 --- a/docs/xplat/src/content/jp/components/geo-map-type-scatter-density-series.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-type-scatter-density-series.mdx @@ -30,30 +30,30 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; 相当数のデータ ポイントがあるため、シリーズではフルサイズのマーカーに対して散布データを小さな点として表示し、領域にはデータ ポイントの集合を表す高い色密度を使用した大半のデータを表示します。 ## データ要件 -マップ コントロールの他のタイプの散布図シリーズと同様に、 シリーズには、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。`LongitudeMemberPath` と `LatitudeMemberPath` プロパティを使用してこのデータ列をマップします。 +マップ コントロールの他のタイプの散布図シリーズと同様に、 シリーズには、オブジェクトの配列にバインドできる プロパティがあります。また、項目ソースの各項目は、地理経度および緯度を表す 2 つのデータ列があります。 プロパティを使用してこのデータ列をマップします。 ### データ バインディング 以下の表に、データ バインドに使用される GeographicHighDensityScatterSeries シリーズのプロパティをまとめています。 | プロパティ|タイプ|概要 | | ---|---|--- | -| `ItemsSource`|any|項目ソースを取得または設定します。 | -| `LongitudeMemberPath`|経度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | -| `LatitudeMemberPath`|string|緯度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | +| |any|項目ソースを取得または設定します。 | +| |経度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | +| |string|緯度値が割り当てられた項目上の位置を決定するには ItemsSource プロパティを使用します。 | ## 熱色スケール 熱色スケールは、シリーズ内のカラー パターンを決定するオプションの機能です。以下の表は、カラー スケールを決定するために使用するプロパティをまとめたものです。 | プロパティ|タイプ|概要 | | ---|---|--- | -| `HeatMinimum`|カラー スケールの最小端を表す double 値を定義します。 | -| `HeatMaximum`|カラー スケールの最大端を表す double 値を定義します。 | -| `HeatMinimumColor`|Color|カラー スケールの下端で使用するポイント密度カラーを定義します。 | -| `HeatMaximumColor`|Color|カラー スケールの上端で使用するポイント密度カラーを定義します。 | +| |カラー スケールの最小端を表す double 値を定義します。 | +| |カラー スケールの最大端を表す double 値を定義します。 | +| |Color|カラー スケールの下端で使用するポイント密度カラーを定義します。 | +| |Color|カラー スケールの上端で使用するポイント密度カラーを定義します。 | ## コード例 -以下のコードは、 の `HeatMinimumColor` と `HeatMaximumColor` プロパティを設定する方法を示します。 +以下のコードは、 プロパティを設定する方法を示します。 diff --git a/docs/xplat/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx b/docs/xplat/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx index 69e07885c9..52902f97df 100644 --- a/docs/xplat/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-type-scatter-symbol-series.mdx @@ -26,7 +26,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro';
## データ要件 -マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、このオブジェクトの各データ項目は、地理的位置 (経度と緯度) を保存する 2 つの数値データ列を持つ必要があります。これらのデータ列は、`LatitudeMemberPath` および `LongitudeMemberPath` プロパティにマップされます。 は、これらのマップされたデータ列の値を使用して、地理マップコンポーネントにシンボル要素をプロットします。 +マップコンポーネントの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、このオブジェクトの各データ項目は、地理的位置 (経度と緯度) を保存する 2 つの数値データ列を持つ必要があります。これらのデータ列は、 および プロパティにマップされます。 は、これらのマップされたデータ列の値を使用して、地理マップコンポーネントにシンボル要素をプロットします。 ## コード スニペット 以下のコードは、 を使用してシェイプ ファイルからロードした都市の場所に をバインドする方法を示します。 diff --git a/docs/xplat/src/content/jp/components/geo-map-type-shape-polygon-series.mdx b/docs/xplat/src/content/jp/components/geo-map-type-shape-polygon-series.mdx index 2fe857b5ad..4d56a86a2b 100644 --- a/docs/xplat/src/content/jp/components/geo-map-type-shape-polygon-series.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-type-shape-polygon-series.mdx @@ -28,7 +28,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; は、地理空間データがポリラインではなくポリゴンでレンダリングされる以外、 とほとんど同じです。 ## データ要件 -マップコントロールの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、`ShapeMemberPath` プロパティにマップされます。 は、マップされたデータ列の点を使用してマップコントロールにポリゴンをプロットします。 +マップコントロールの他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、 プロパティにマップされます。 は、マップされたデータ列の点を使用してマップコントロールにポリゴンをプロットします。 ## コード スニペット 以下のコードは、 を使用してシェイプ ファイルからロードした世界の国々の図形に をバインドする方法を示します。 diff --git a/docs/xplat/src/content/jp/components/geo-map-type-shape-polyline-series.mdx b/docs/xplat/src/content/jp/components/geo-map-type-shape-polyline-series.mdx index 8241386ac5..a95571ad44 100644 --- a/docs/xplat/src/content/jp/components/geo-map-type-shape-polyline-series.mdx +++ b/docs/xplat/src/content/jp/components/geo-map-type-shape-polyline-series.mdx @@ -28,7 +28,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; は、 とよく似ていますが、地理空間データがポリゴンではなくポリラインでレンダリングされる点が異なります。 ## データ要件 -コントロール内の他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる `ItemsSource` プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、ShapeMemberPath プロパティにマップされます。 は、コントロールで多角形をプロットするために、このマップされたデータ列のポイントを使用します。 +コントロール内の他の種類の地理的シリーズと同様に、 には、オブジェクトの配列にバインドできる プロパティがあります。さらに、このオブジェクトの各データ項目には、地理的位置を表す x 値と y 値を持つオブジェクトの配列の配列を使用して単一または複数の形状を格納する 1 つのデータ列が必要です。このデータ列は、ShapeMemberPath プロパティにマップされます。 は、コントロールで多角形をプロットするために、このマップされたデータ列のポイントを使用します。 ## コード スニペット 以下のコードは、 を使用してシェイプ ファイルからロードした都市の場所に をバインドする方法を示します。 diff --git a/docs/xplat/src/content/jp/components/geo-map.mdx b/docs/xplat/src/content/jp/components/geo-map.mdx index 405ac9f1e4..a170a514d4 100644 --- a/docs/xplat/src/content/jp/components/geo-map.mdx +++ b/docs/xplat/src/content/jp/components/geo-map.mdx @@ -16,7 +16,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## {Platform} マップの例 -以下のサンプルは、Bubble Series (バブル シリーズ) とも呼ばれる を使用して `GeographicMap` にデータを表示する方法を示しています。 +以下のサンプルは、Bubble Series (バブル シリーズ) とも呼ばれる を使用して にデータを表示する方法を示しています。 @@ -50,7 +50,7 @@ npm install --save {PackageMaps} ## モジュールの要件 -`GeographicMap` には以下のモジュールが必要ですが、DataChartInteractivityModule は、マップ コンテンツのパンやズームなどのマウス操作にのみ必要です。 + には以下のモジュールが必要ですが、DataChartInteractivityModule は、マップ コンテンツのパンやズームなどのマウス操作にのみ必要です。 diff --git a/docs/xplat/src/content/jp/components/grid-lite/column-configuration.mdx b/docs/xplat/src/content/jp/components/grid-lite/column-configuration.mdx index b9932180b5..183397f043 100644 --- a/docs/xplat/src/content/jp/components/grid-lite/column-configuration.mdx +++ b/docs/xplat/src/content/jp/components/grid-lite/column-configuration.mdx @@ -55,7 +55,7 @@ return ( -Columns are defined declaratively using `` child elements within the grid. The `Field` property is the only required for a column, as it serves as the column identifier. It is also the property that is used to map and render the relevant data in the grid rows. +Columns are defined declaratively using `` child elements within the grid. The property is the only required for a column, as it serves as the column identifier. It is also the property that is used to map and render the relevant data in the grid rows. ```razor @@ -69,7 +69,7 @@ Columns are defined declaratively using `` child elements wit ## データ ソースに基づく設定 -グリッドは、`AutoGenerate` が true に設定されている場合、提供されたデータ ソースに基づいて列の構成を推測することをサポートします。データ内のレコードに基づいて、適切な `Field` および `DataType` プロパティを推測しようとします。 +グリッドは、`AutoGenerate` が true に設定されている場合、提供されたデータ ソースに基づいて列の構成を推測することをサポートします。データ内のレコードに基づいて、適切な および プロパティを推測しようとします。 ```razor @@ -211,7 +211,7 @@ return ( -列の幅を変更するには、`IgbGridLiteColumn` コンポーネントの `Width` パラメーターを使用します。 +列の幅を変更するには、`IgbGridLiteColumn` コンポーネントの パラメーターを使用します。 ```razor @@ -253,7 +253,7 @@ return ( -`IgbGridLiteColumn` コンポーネントの `Hidden` パラメーターを設定することで、列を非表示/表示できます。 +`IgbGridLiteColumn` コンポーネントの パラメーターを設定することで、列を非表示/表示できます。 ```razor -高度なフィルタリングは、`AdvancedFilteringExpressionsTree` 入力プロパティに保存される `FilteringExpressionsTree` を生成します。`AdvancedFilteringExpressionsTree` プロパティを使用して、高度なフィルタリングの初期状態を設定できます。 +高度なフィルタリングは、`AdvancedFilteringExpressionsTree` 入力プロパティに保存される を生成します。`AdvancedFilteringExpressionsTree` プロパティを使用して、高度なフィルタリングの初期状態を設定できます。 ```html diff --git a/docs/xplat/src/content/jp/components/grids/_shared/cascading-combos.mdx b/docs/xplat/src/content/jp/components/grids/_shared/cascading-combos.mdx index bcab09f384..125f27eb8e 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/cascading-combos.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/cascading-combos.mdx @@ -30,9 +30,9 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 設定 -列の編集を有効にするには、`Editable` プロパティが **true** に設定されていることを確認してください。 +列の編集を有効にするには、 プロパティが **true** に設定されていることを確認してください。 -列の編集が有効になったら、 を追加することから始めることができます。ここで、単一選択を 1 つだけ使用できるようにするには、`SingleSelect` プロパティを設定する必要があることに注意してください。 +列の編集が有効になったら、 を追加することから始めることができます。ここで、単一選択を 1 つだけ使用できるようにするには、 プロパティを設定する必要があることに注意してください。 @@ -124,7 +124,7 @@ public webGridCountryDropDownTemplate: IgcRenderFunction ``` -- `displayKey` - オブジェクト配列に必要 - 項目のテキストに使用されるプロパティを指定します。`displayKey` に値が指定されていない場合、コンボは指定された `ValueKey` (存在する場合) を使用します。 +- `displayKey` - オブジェクト配列に必要 - 項目のテキストに使用されるプロパティを指定します。`displayKey` に値が指定されていない場合、コンボは指定された (存在する場合) を使用します。 選択の変更を処理するには、`onChange` イベントが必要です。発行されたイベント引数には、変更前の選択、現在の選択、追加または削除された項目に関する情報が含まれています。したがって、前のコンボの選択に基づいて値をフィルタリングします。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/cell-merging.mdx b/docs/xplat/src/content/jp/components/grids/_shared/cell-merging.mdx index 07dbf62fe4..9d9a01165f 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/cell-merging.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/cell-merging.mdx @@ -44,7 +44,7 @@ Ignite UI for {Platform} {ComponentTitle} には、同じ値を持つ隣接セ ### グリッド結合モード -グリッドは、 列挙型の値を受け入れる `cellMergeMode` プロパティを公開します。 +グリッドは、 列挙型の値を受け入れる `cellMergeMode` プロパティを公開します。 - `always` - ソート状態に関係なく、結合条件を満たすすべての隣接セルを結合。 - `onSort` - 列がソートされているときのみ隣接セルを結合 **(デフォルト値)**。 @@ -229,11 +229,11 @@ export class MyCustomStrategy extends IgcDefaultMergeStrategy { -The `IgxTreeGrid` provides two built-in strategies that implement the `IGridMergeStrategy` interface: `DefaultTreeGridMergeStrategy` and `ByLevelTreeGridMergeStrategy`. `DefaultTreeGridMergeStrategy` merges all cells with the same value, regardless of their hierarchical level. In contrast, `ByLevelTreeGridMergeStrategy` only merges cells if they have the same value and are located at the same level, making level a required condition for merging. +The `IgxTreeGrid` provides two built-in strategies that implement the `IGridMergeStrategy` interface: and . merges all cells with the same value, regardless of their hierarchical level. In contrast, only merges cells if they have the same value and are located at the same level, making level a required condition for merging. ### Extending the Default Strategy -If you only want to customize part of the behavior (for example, the comparer logic), you can extend one of the built-in strategies, either `DefaultTreeGridMergeStrategy` or `ByLevelTreeGridMergeStrategy`, and override the relevant methods. +If you only want to customize part of the behavior (for example, the comparer logic), you can extend one of the built-in strategies, either or , and override the relevant methods. ```ts @@ -267,7 +267,7 @@ export class MyCustomStrategy extends IgcDefaultTreeGridMergeStrategy { ### デフォルトのストラテジを拡張 -一部の動作 (例: comparer ロジック) のみをカスタマイズしたい場合は、組み込みの `DefaultMergeStrategy` を拡張し、必要なメソッドのみをオーバーライドできます。 +一部の動作 (例: comparer ロジック) のみをカスタマイズしたい場合は、組み込みの を拡張し、必要なメソッドのみをオーバーライドできます。 ```tsx <{ComponentSelector} data={data} mergeStrategy={customStrategy}> @@ -306,7 +306,7 @@ constructor() { ## デフォルトのストラテジを拡張 -一部の動作 (例: comparer ロジック) のみをカスタマイズしたい場合は、組み込みの `DefaultTreeGridMergeStrategy` または `ByLevelTreeGridMergeStrategy` のいずれかを拡張し、必要なメソッドのみをオーバーライドできます。 +一部の動作 (例: comparer ロジック) のみをカスタマイズしたい場合は、組み込みの または のいずれかを拡張し、必要なメソッドのみをオーバーライドできます。 - **Expand/Collapse**: if a feature (such as master-detail, grouping, etc.) generates a non-data row, then the cell merging is interrupted and the group will be split. diff --git a/docs/xplat/src/content/jp/components/grids/_shared/cell-selection.mdx b/docs/xplat/src/content/jp/components/grids/_shared/cell-selection.mdx index 979e721c55..f779809bf9 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/cell-selection.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/cell-selection.mdx @@ -69,7 +69,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; `CellSelection` を **single** (単一) に設定すると、一度にグリッド内で選択されたセルを1つだけ持つことができます。また、**マウス ドラッグ** モードは機能せず、セルを選択する代わりに、デフォルトのテキスト選択が行われます。 -> **選択モード**が **single** (単一) であるか **multiple** (複数) であるかに関係なく、単一セルが `Selected` イベントが発生したときに発生します。複数セル選択モードでは、セル範囲を選択すると `RangeSelected` イベントが発生します。 +> **選択モード**が **single** (単一) であるか **multiple** (複数) であるかに関係なく、単一セルが イベントが発生したときに発生します。複数セル選択モードでは、セル範囲を選択すると `RangeSelected` イベントが発生します。 ### {ComponentTitle} 選択なし diff --git a/docs/xplat/src/content/jp/components/grids/_shared/clipboard-interactions.mdx b/docs/xplat/src/content/jp/components/grids/_shared/clipboard-interactions.mdx index 395a390f0e..c9be061f67 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/clipboard-interactions.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/clipboard-interactions.mdx @@ -42,7 +42,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 制限 -- カットとコピーの両方のイベントは、Internet Explorer では本来サポートされていません。**paste** イベント (IE 11) は発生されますが、イベントの プロパティを公開しません。 +- カットとコピーの両方のイベントは、Internet Explorer では本来サポートされていません。**paste** イベント (IE 11) は発生されますが、イベントの プロパティを公開しません。 IE 11のセルを**コピー**するためには、キーボード選択を使用できます。複数セルを選択するには SHIFT キー を押しながらコピーするには CTRL + C を押します。 @@ -59,23 +59,23 @@ You can use a custom paste handler in order to configure **paste** behavior, hav ## API の使用 -次のオプションを処理する プロパティを公開します。 -- `Enabled` は選択したセルのコピーを有効または無効にします。 -- `CopyHeaders` は、コピー時に関連付けられているヘッダーを含めます。 -- `CopyFormatters` は、既存の列フォーマッタをコピーしたデータに適用します。 -- `Separator` は、クリップボードのデータのフォーマットに使用する文字列の区切り文字。デフォルトは `/t` です。 +次のオプションを処理する プロパティを公開します。 +- は選択したセルのコピーを有効または無効にします。 +- は、コピー時に関連付けられているヘッダーを含めます。 +- は、既存の列フォーマッタをコピーしたデータに適用します。 +- は、クリップボードのデータのフォーマットに使用する文字列の区切り文字。デフォルトは `/t` です。 Excel は、タブで区切られたテキスト (タブ区切り `/t`) を自動的に検出し、データを別々の列に正しく貼り付けることができます。貼り付け形式が機能せず、貼り付けたものがすべて 1 列に表示される場合は、Excel の区切り文字が別の文字に設定されている、またはテキストがタブではなくスペースを使用しています。 -- `GridCopy` は、コピー操作が実行されたときに発生します。`ClipboardOptions` を使用してコピー動作が有効になっている場合のみ発生します。 +- `GridCopy` は、コピー操作が実行されたときに発生します。 を使用してコピー動作が有効になっている場合のみ発生します。 ## API リファレンス
-
+
## Additional Resources diff --git a/docs/xplat/src/content/jp/components/grids/_shared/collapsible-column-groups.mdx b/docs/xplat/src/content/jp/components/grids/_shared/collapsible-column-groups.mdx index 5555bdf4c6..412fbe930e 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/collapsible-column-groups.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/collapsible-column-groups.mdx @@ -64,9 +64,9 @@ npm install igniteui-react-grids 縮小可能な列グループは複数列ヘッダー機能の一部で、列グループをより小さいデータ セットに縮小/展開する方法を提供します。列グループが折りたたまれると、列のサブセットがエンドユーザーに表示され、グループの他の子列が非表示になります。縮小/展開された各列は、グリッド データソースにバインドすることも、非バインドにして計算することもできます。 -列グループを縮小可能なに定義するには、 の `Collapsible` プロパティを **true** に設定する必要があります。 +列グループを縮小可能なに定義するには、 プロパティを **true** に設定する必要があります。 -`VisibleWhenCollapsed` プロパティを少なくとも 2 つの子列に定義する必要があることに注意してください。グループが縮小されたときに少なくとも 1 列が表示され (`VisibleWhenCollapsed` の設定が **true**)、グループが展開されたときは少なくとも 1 列が非表示になります (`VisibleWhenCollapsed` の設定が `false`)。**それ以外は、縮小機能は無効になります。**子列の一部に `VisibleWhenCollapsed` が指定されていない場合、この列は、親の状態が展開または縮小されているかに関係なく常に表示されます。 + プロパティを少なくとも 2 つの子列に定義する必要があることに注意してください。グループが縮小されたときに少なくとも 1 列が表示され ( の設定が **true**)、グループが展開されたときは少なくとも 1 列が非表示になります ( の設定が `false`)。**それ以外は、縮小機能は無効になります。**子列の一部に が指定されていない場合、この列は、親の状態が展開または縮小されているかに関係なく常に表示されます。 それでは、以下のマークアップを見てみましょう。 @@ -161,7 +161,7 @@ npm install igniteui-react-grids - 親が縮小されているときに表示できます。 - 親が縮小されているときに非表示にできます。 -縮小可能として指定された列グループの初期状態は `Expanded` が **true** に設定されていますが、**false** に設定することでこの動作を簡単に変更できます。 +縮小可能として指定された列グループの初期状態は が **true** に設定されていますが、**false** に設定することでこの動作を簡単に変更できます。 ## 展開/縮小インジケーター テンプレート @@ -261,7 +261,7 @@ const collapsibleIndicatorTemplate = (ctx: IgrColumnTemplateContext) => { ### プロパティの使用 -`CollapsibleIndicatorTemplate` プロパティを使用して、カスタムの展開/折りたたみテンプレートを定義し、それを各折りたたみ可能な列グループに提供できます。以下のマークアップを確認してください。 + プロパティを使用して、カスタムの展開/折りたたみテンプレートを定義し、それを各折りたたみ可能な列グループに提供できます。以下のマークアップを確認してください。 ```html diff --git a/docs/xplat/src/content/jp/components/grids/_shared/column-hiding.mdx b/docs/xplat/src/content/jp/components/grids/_shared/column-hiding.mdx index 7888be81d9..5ee3690dd3 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/column-hiding.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/column-hiding.mdx @@ -684,7 +684,7 @@ export class AppModule {} ### タイトルおよびフィルター プロンプトの追加 -列非表示コンポーネント機能を拡張するために `Title` および `FilterColumnsPrompt` プロパティを設定します。`Title` は一番上に表示され、`FilterColumnsPrompt` は列非表示 UI のフィルター入力に表示されるプロンプト テキストです。 +列非表示コンポーネント機能を拡張するために および `FilterColumnsPrompt` プロパティを設定します。 は一番上に表示され、`FilterColumnsPrompt` は列非表示 UI のフィルター入力に表示されるプロンプト テキストです。 ```html
@@ -734,7 +734,7 @@ export class AppModule {} ### 列の非表示の無効化 -列の `DisableHiding` プロパティを true に設定すると、ユーザーが列非表示 UI によって列を非表示にできません。 +列の プロパティを true に設定すると、ユーザーが列非表示 UI によって列を非表示にできません。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/column-moving.mdx b/docs/xplat/src/content/jp/components/grids/_shared/column-moving.mdx index 31c8b0674a..418cdcb0da 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/column-moving.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/column-moving.mdx @@ -79,7 +79,7 @@ const headerTemplate = (ctx: IgrCellTemplateContext) => { ## 概要 -**列移動**機能は各列レベルで有効にできます。つまり、 に移動可能な列または移動不可の列の両方を含むことができます。 の `Moving` 入力によって制御されます。 +**列移動**機能は各列レベルで有効にできます。つまり、 に移動可能な列または移動不可の列の両方を含むことができます。 入力によって制御されます。 ```html @@ -149,7 +149,7 @@ const headerTemplate = (ctx: IgrCellTemplateContext) => { ドラッグアンドドロップ機能に加えて、列の移動機能には、プログラムで列を移動/並べ替えできる API メソッドも用意されています。 - - Moves a column before or after another column (a target). The first parameter is the column to be moved, and the second parameter is the target column. Also accepts an optional third parameter `Position` (representing a value), which determines whether to place the column before or after the target column. + - Moves a column before or after another column (a target). The first parameter is the column to be moved, and the second parameter is the target column. Also accepts an optional third parameter `Position` (representing a value), which determines whether to place the column before or after the target column. ```typescript @@ -172,7 +172,7 @@ grid.moveColumn(idColumn, nameColumn, DropPosition.AfterDropTarget); ``` -`MoveColumn` - 列を別の列 (ターゲット) の前または後に移動します。最初のパラメーターは移動する列で、2 番目のパラメーターはターゲット列です。オプションの 3 番目のパラメーター `Position` (`DropPosition` 値を表す) でターゲット列の前または後に列を配置するかどうかを決定します。 + - 列を別の列 (ターゲット) の前または後に移動します。最初のパラメーターは移動する列で、2 番目のパラメーターはターゲット列です。オプションの 3 番目のパラメーター `Position` (`DropPosition` 値を表す) でターゲット列の前または後に列を配置するかどうかを決定します。 ```typescript @@ -192,7 +192,7 @@ idColumn.move(3); ``` -`Move` - 列を指定した表示インデックスに移動します。渡されたインデックス パラメーターが無効である場合 (負である/列数を超える場合)、または列がこのインデックスに移動できない場合 (別のグループ内にある場合)、操作は実行されません。 + - 列を指定した表示インデックスに移動します。渡されたインデックス パラメーターが無効である場合 (負である/列数を超える場合)、または列がこのインデックスに移動できない場合 (別のグループ内にある場合)、操作は実行されません。 ## イベント diff --git a/docs/xplat/src/content/jp/components/grids/_shared/column-pinning.mdx b/docs/xplat/src/content/jp/components/grids/_shared/column-pinning.mdx index 243ca6196e..e957ae1afe 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/column-pinning.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/column-pinning.mdx @@ -31,7 +31,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 列ピン固定の API -列のピン固定は の `Pinned` プロパティによって制御されます。デフォルトでピン固定列は の左側に固定して描画され、 本体のピン固定されていない列は水平スクロールされます。 +列のピン固定は プロパティによって制御されます。デフォルトでピン固定列は の左側に固定して描画され、 本体のピン固定されていない列は水平スクロールされます。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/column-resizing.mdx b/docs/xplat/src/content/jp/components/grids/_shared/column-resizing.mdx index d798af86ac..788fe92511 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/column-resizing.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/column-resizing.mdx @@ -26,7 +26,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -**列のサイズ変更**は列レベルで有効化にできます。つまり、 にサイズ変更可能な列およびサイズ変更不可の列の両方を含むことが可能です。 の `Resizable` 入力によって制御されます。 +**列のサイズ変更**は列レベルで有効化にできます。つまり、 にサイズ変更可能な列およびサイズ変更不可の列の両方を含むことが可能です。 入力によって制御されます。 @@ -82,7 +82,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - の `ColumnResized` イベントを処理し、列がサイズ変更されたときにカスタム ロジックを実装できます。以前の列幅、新しい列幅、および `Column` オブジェクトがイベント引数で公開されます。 + の `ColumnResized` イベントを処理し、列がサイズ変更されたときにカスタム ロジックを実装できます。以前の列幅、新しい列幅、および オブジェクトがイベント引数で公開されます。 @@ -435,7 +435,7 @@ const onResize = (event: IgrColumnResizeEventArgs) => { ## 列のサイズ変更の制限 -列の最小幅および最大幅の構成も可能です。 の `MinWidth` および `MaxWidth`入力によって制御されます。この場合、サイズ変更インジケーターのドラッグ操作が制限されます。列が `MinWidth` および `MaxWidth` によって定義される範囲以外にサイズ変更できないことをユーザーに通知します。 +列の最小幅および最大幅の構成も可能です。 および 入力によって制御されます。この場合、サイズ変更インジケーターのドラッグ操作が制限されます。列が および によって定義される範囲以外にサイズ変更できないことをユーザーに通知します。 @@ -622,9 +622,9 @@ const onResize = (event: IgrColumnResizeEventArgs) => { ## ダブルクリックで列の自動サイズ調整 -各列ヘッダーの右側をダブルクリックして列を**自動サイズ**調整することができます。列は、現在表示されているヘッダーを含む一番長いセル値にサイズ設定されます。この動作はデフォルトで有効なため、追加で構成する必要はありません。ただし、`MaxWidth` がその列に設定され、新しい幅が `MaxWidth` 値より大きい場合、列は自動サイズ調整されません。この場合、列が `MaxWidth` 値に設定されます。 +各列ヘッダーの右側をダブルクリックして列を**自動サイズ**調整することができます。列は、現在表示されているヘッダーを含む一番長いセル値にサイズ設定されます。この動作はデフォルトで有効なため、追加で構成する必要はありません。ただし、 がその列に設定され、新しい幅が 値より大きい場合、列は自動サイズ調整されません。この場合、列が 値に設定されます。 -また、 の `Autosize` メソッドで列を動的に自動でサイズ変更できます。 +また、 メソッドで列を動的に自動でサイズ変更できます。 @@ -711,7 +711,7 @@ column.autosize(); ## 初期化時に列を自動サイズ調整 -`Width` を 'auto' に設定することで、初期化時に各列を自動サイズに設定できます。 + を 'auto' に設定することで、初期化時に各列を自動サイズに設定できます。 ```html diff --git a/docs/xplat/src/content/jp/components/grids/_shared/column-selection.mdx b/docs/xplat/src/content/jp/components/grids/_shared/column-selection.mdx index c50f6380ad..7e760c8613 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/column-selection.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/column-selection.mdx @@ -41,14 +41,14 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 基本的な使用方法 -列選択機能は、 値を受け取る `ColumnSelection` 入力によって有効にすることができます。 +列選択機能は、 値を受け取る `ColumnSelection` 入力によって有効にすることができます。 ## インタラクション -デフォルトの選択モードは `None` です。`Single` または `Multiple` に設定されると、すべての列は `Selectable` になります。列を選択するには、列をクリックして `Selected` としてマークします。列が選択不可な場合、ホバー時に選択スタイルはヘッダーに適用されません。 +デフォルトの選択モードは `None` です。`Single` または `Multiple` に設定されると、すべての列は になります。列を選択するには、列をクリックして としてマークします。列が選択不可な場合、ホバー時に選択スタイルはヘッダーに適用されません。 -[複数列ヘッダー](multi-column-headers.md)機能は `Selectable` 入力に反映されません。その子の 1 つ以上で選択動作が有効な場合、`ColumnGroupComponent` は `Selectable` です。さらに、すべての `Selectable` 子孫が `Selected` である場合、コンポーネントは `Selected` としてマークされます。 +[複数列ヘッダー](multi-column-headers.md)機能は 入力に反映されません。その子の 1 つ以上で選択動作が有効な場合、`ColumnGroupComponent` は です。さらに、すべての 子孫が である場合、コンポーネントは としてマークされます。 @@ -78,10 +78,10 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## API 操作 -**API** は、**非表示**列に関していくつかの追加機能を提供し、対応する **setter** を設定することにより、すべての**非表示**列を `Selected` としてマークできます。 +**API** は、**非表示**列に関していくつかの追加機能を提供し、対応する **setter** を設定することにより、すべての**非表示**列を としてマークできます。 -上記は `ColumnGroupComponent` にも適用されますが、`Selected` プロパティを変更する場合、その子孫の状態を変更します。 +上記は `ColumnGroupComponent` にも適用されますが、 プロパティを変更する場合、その子孫の状態を変更します。 API 操作の詳細については、[API リファレンス](#api-リファレンス) セクションを参照してください。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/column-types.mdx b/docs/xplat/src/content/jp/components/grids/_shared/column-types.mdx index b285817b25..2cab1e6bdb 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/column-types.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/column-types.mdx @@ -30,17 +30,17 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## {Platform} {ComponentTitle} デフォルト テンプレート -データ型固有のテンプレートを有効にする場合、列の `DataType` 入力を設定する必要があります。設定しない場合、列は文字列の列として処理されます (これは列 `DataType` のデフォルト値であるためです)。 +データ型固有のテンプレートを有効にする場合、列の 入力を設定する必要があります。設定しない場合、列は文字列の列として処理されます (これは列 のデフォルト値であるためです)。 -次に、各 `DataType` のデフォルト テンプレートについて説明します。 +次に、各 のデフォルト テンプレートについて説明します。 ### String (文字列) -この列 `DataType` はセル値の外観または書式を変更しません。 +この列 はセル値の外観または書式を変更しません。 ### Number (数値) -`DataType` が **number** に設定されている場合、セル値はアプリケーションまたはグリッドの `Locale` 設定に基づいて書式設定され、`PipeArgs` プロパティが指定されている場合にも同じように設定されます。数値書式はそれらに基づいて変更されます。たとえば、以下を変更します: + が **number** に設定されている場合、セル値はアプリケーションまたはグリッドの 設定に基づいて書式設定され、 プロパティが指定されている場合にも同じように設定されます。数値書式はそれらに基づいて変更されます。たとえば、以下を変更します: - 小数点後の桁数。 - `,` または `.` の少数桁の区切り文字 @@ -106,7 +106,7 @@ const formatOptions : IgrColumnPipeArgs = { ### DateTime、Date and Time (日付と時刻) -日付部分の外観は、`Locale` の形式または `PipeArgs` 入力に基づいて設定されます (例: 日、月、年)。Pipe 引数はカスタム日付書式またはタイムゾーンを指定するために使用できます。 +日付部分の外観は、 の形式または 入力に基づいて設定されます (例: 日、月、年)。Pipe 引数はカスタム日付書式またはタイムゾーンを指定するために使用できます。 - **format** - 日付の書式設定のデフォルト値は `'mediumDate'` です。その他の利用可能なオプション `'short'`、`'long'`、`'shortDate'`、`'fullDate'`、`'longTime'`、`'fullTime'` などです。 - **timezone** - ユーザーのローカル システム タイムゾーンがデフォルト値です。タイムゾーン オフセットまたは標準の UTC/GMT または米国本土のタイムゾーンの略語も渡すことができます。世界の任意の場所の対応する時間を表示するさまざまなタイムゾーンの例: @@ -332,7 +332,7 @@ const timeFormats = [ #### デフォルトのテンプレート -デフォルトのテンプレートには、接頭辞または接尾辞が付いた通貨記号を含む数値を表示します。通貨記号の位置と数値の書式設定は、提供された Application [LOCALE_ID](https://angular.io/api/core/LOCALE_ID) または {ComponentTitle} の `Locale` に基づいています。 +デフォルトのテンプレートには、接頭辞または接尾辞が付いた通貨記号を含む数値を表示します。通貨記号の位置と数値の書式設定は、提供された Application [LOCALE_ID](https://angular.io/api/core/LOCALE_ID) または {ComponentTitle} の に基づいています。 *LOCALE_ID を使用する場合:* @@ -361,7 +361,7 @@ import { LOCALE_ID } from '@angular/core'; -`PipeArgs` 入力を使用することにより、エンドユーザーは**小数点**、*currencyCode* および *display* によって数値書式をカスタマイズできます。 + 入力を使用することにより、エンドユーザーは**小数点**、*currencyCode* および *display* によって数値書式をカスタマイズできます。 ```ts @@ -443,7 +443,7 @@ const formatOptions : IgrColumnPipeArgs = { セルの値を編集すると、**通貨記号**がサフィックスまたはプレフィックスとして表示されます。詳細については、公式の[セル編集トピック](cell-editing.md#セル編集と編集テンプレートの例)を参照してください。 - + + 矢印キーを使用する場合、値は digitsInfo - minFractionDigits (小数点以下の最小桁数。デフォルトは 0 です。) に基づいてステップで増減します。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/conditional-cell-styling.mdx b/docs/xplat/src/content/jp/components/grids/_shared/conditional-cell-styling.mdx index 44bd2b8dfc..04554e205a 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/conditional-cell-styling.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/conditional-cell-styling.mdx @@ -450,10 +450,10 @@ constructor() { {ProductName} の コンポーネントは、カスタム ルールに基づいて**セルの条件付きスタイル設定**を作成する次の 2 つの方法を提供します: -- 入力 `CellClasses` をキーと値のペアを含むオブジェクト リテラルに設定します。キーは CSS クラスの名前です。値はブール値を返すコールバック関数またはブール値です。その結果、セルのマテリアル スタイル設定が簡単にできます。 +- 入力 をキーと値のペアを含むオブジェクト リテラルに設定します。キーは CSS クラスの名前です。値はブール値を返すコールバック関数またはブール値です。その結果、セルのマテリアル スタイル設定が簡単にできます。 ### CellClasses の使用 - `CellClasses` 入力を設定してカスタム条件を定義することにより、 の条件付きセルのスタイルを設定できます。 + 入力を設定してカスタム条件を定義することにより、 の条件付きセルのスタイルを設定できます。 @@ -561,7 +561,7 @@ constructor() { -`CellClasses` 入力は、キーと値のペアを含むオブジェクト リテラルを受け取ります。キーは CSS クラスの名前です。値はブール値を返すコールバック関数またはブール値です。 + 入力は、キーと値のペアを含むオブジェクト リテラルを受け取ります。キーは CSS クラスの名前です。値はブール値を返すコールバック関数またはブール値です。 @@ -744,7 +744,7 @@ constructor() { -- `Column` 入力を使用して、キーがスタイル プロパティであり、値が評価用の式であるオブジェクト リテラルを受け取る `CellStyles`。 +- 入力を使用して、キーがスタイル プロパティであり、値が評価用の式であるオブジェクト リテラルを受け取る 。 > `cellStyles` と `cellClasses` の両方のコールバック シグネチャが次のように変更されました。 @@ -762,7 +762,7 @@ constructor() { ### CellStyles の使用 -列の `CellStyles` プロパティを公開。列セルの条件付きスタイリングが可能になりました。`CellClasses` と同様、キーがスタイル プロパティであり、値が評価用の式であるオブジェクト リテラルを受け取ります。また、通常のスタイリングを簡単に適用できます (条件なし)。 +列の プロパティを公開。列セルの条件付きスタイリングが可能になりました。 と同様、キーがスタイル プロパティであり、値が評価用の式であるオブジェクト リテラルを受け取ります。また、通常のスタイリングを簡単に適用できます (条件なし)。 次にスタイルを定義します。 @@ -838,7 +838,7 @@ const webGridCellStyles = { -On `ngOnInit` we will add the `CellStyles` configuration for each column of the predefined `Columns` collection, which is used to create the columns dynamically. +On `ngOnInit` we will add the configuration for each column of the predefined `Columns` collection, which is used to create the columns dynamically. ```ts public ngOnInit() { @@ -1053,7 +1053,7 @@ const cellStylesHandler = { -On `ngOnInit` we will add the `CellStyles` configuration for each column of the predefined `Columns` collection, which is used to create the columns dynamically. +On `ngOnInit` we will add the configuration for each column of the predefined `Columns` collection, which is used to create the columns dynamically. ```ts public ngOnInit() { diff --git a/docs/xplat/src/content/jp/components/grids/_shared/editing.mdx b/docs/xplat/src/content/jp/components/grids/_shared/editing.mdx index 6acec377f6..0f2c6bd219 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/editing.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/editing.mdx @@ -27,9 +27,9 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 設定 -有効にする編集モードを指定するために、 は `Editable` および `RowEditable` ブール値プロパティを公開します。 +有効にする編集モードを指定するために、 および `RowEditable` ブール値プロパティを公開します。 -以下のオプションは、プロパティ `Editable` で指定できます。 +以下のオプションは、プロパティ で指定できます。 - **false** - 対応する列の編集が無効になります 。これがデフォルト値です。 - **true** - 対応する列の編集が有効になります。 @@ -41,7 +41,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - **false** - 対応するグリッドの行編集は無効になります。これがデフォルト値です。 - **true** - 対応するグリッドで行編集が有効になります。 - で `RowEditable` プロパティを true に設定し、`Editable` プロパティがどの列にも明示的に定義されていない場合、編集は*主キー*以外のすべての列で有効になります。 + で `RowEditable` プロパティを true に設定し、 プロパティがどの列にも明示的に定義されていない場合、編集は*主キー*以外のすべての列で有効になります。 @@ -50,7 +50,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ### テンプレートの編集 - データ型固有の**編集テンプレート**を使用する場合、列 `DataType` プロパティを指定する必要があります。次に各型のデフォルト テンプレートについて説明します。 + データ型固有の**編集テンプレート**を使用する場合、列 プロパティを指定する必要があります。次に各型のデフォルト テンプレートについて説明します。 - `string` データ型の場合、デフォルトのテンプレートは を使用します。 - `number` データ型のデフォルト テンプレートは type="number" を使用します。数値に解析できない値にセルを更新した場合、変更は無視されてセルの値が 0 に設定されます。 @@ -78,14 +78,14 @@ All available column data types could be found in the official [Column types top | イベント | 説明 | 引数 | キャンセル可能 | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | ----------- | - | `RowEditEnter` | `RowEditing` が有効な場合、行が編集モードに入るときに発生します。 | | **true** | - | `CellEditEnter` |セルが**編集モードに入る**ときに発生します。 (`RowEditEnter` の後) | | **true** | - | `CellEdit` | 値が変更された場合、セルの値が**コミットされた前に**発生します。 (ENTER の押下など) | | **true** | - | `CellEditDone` | 値が変更された場合、セルが編集され、セルの値が**コミットされた後に**発生します。 | | **false** | - | `CellEditExit` | セルが**編集モードを終了した**ときに発生します。| | **false** | - | `RowEdit` | が有効な場合、編集モードの値の行が**コミットされた前に**発生します (行編集オーバーレイの [完了] ボタンをクリックなど)。 | | **true** | - | `RowEditDone` | が有効な場合、行が編集され、新しい行の値が**コミットされた後に**発生します。 | | **false** | - | `RowEditExit` | が有効な場合、行が**編集モードを終了した**ときに発生します。 | | **false** | + | `RowEditEnter` | `RowEditing` が有効な場合、行が編集モードに入るときに発生します。 | | **true** | + | `CellEditEnter` |セルが**編集モードに入る**ときに発生します。 (`RowEditEnter` の後) | | **true** | + | `CellEdit` | 値が変更された場合、セルの値が**コミットされた前に**発生します。 (ENTER の押下など) | | **true** | + | `CellEditDone` | 値が変更された場合、セルが編集され、セルの値が**コミットされた後に**発生します。 | | **false** | + | `CellEditExit` | セルが**編集モードを終了した**ときに発生します。| | **false** | + | `RowEdit` | が有効な場合、編集モードの値の行が**コミットされた前に**発生します (行編集オーバーレイの [完了] ボタンをクリックなど)。 | | **true** | + | `RowEditDone` | が有効な場合、行が編集され、新しい行の値が**コミットされた後に**発生します。 | | **false** | + | `RowEditExit` | が有効な場合、行が**編集モードを終了した**ときに発生します。 | | **false** | ### イベントのキャンセル diff --git a/docs/xplat/src/content/jp/components/grids/_shared/excel-style-filtering.mdx b/docs/xplat/src/content/jp/components/grids/_shared/excel-style-filtering.mdx index 329edd1277..91abfc6edd 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/excel-style-filtering.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/excel-style-filtering.mdx @@ -67,7 +67,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## メニュー機能の構成 -ソート、ピン固定、および非表示機能は、対応する入力を使用してフィルター メニューから削除できます: `Sortable`、`Selected`、`DisablePinning`、`DisableHiding`。 +ソート、ピン固定、および非表示機能は、対応する入力を使用してフィルター メニューから削除できます: @@ -133,7 +133,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ``` -以下のサンプルの **Product Name** と **Discontinued** 列で 4 つすべての機能が有効です。**Quantity Per Unit** で 4 機能すべてが無効、**Unit Price** でソートのみが有効、**Order Date** でピン固定と非表示のみ有効です。すべてが `Selectable` です。 +以下のサンプルの **Product Name** と **Discontinued** 列で 4 つすべての機能が有効です。**Quantity Per Unit** で 4 機能すべてが無効、**Unit Price** でソートのみが有効、**Order Date** でピン固定と非表示のみ有効です。すべてが です。 @@ -626,7 +626,7 @@ By default, the Excel Style Filtering dialog displays the items in a list view. ### デモ -In order to configure the Excel style filtering component, you should set its `Column` property to one of the {ComponentTitle}'s columns. In the sample above, we have bound the `Column` property to the value of an SelectComponent that displays the {ComponentTitle}'s columns. +In order to configure the Excel style filtering component, you should set its property to one of the {ComponentTitle}'s columns. In the sample above, we have bound the property to the value of an SelectComponent that displays the {ComponentTitle}'s columns. ```html @@ -707,7 +707,7 @@ Add snippet for blazor ## 使用方法 -Excel スタイル フィルタリング コンポーネントを設定するには、その `Column` プロパティを {ComponentTitle} の列の 1 つに設定する必要があります。上記のサンプルでは、{ComponentTitle} の列を表示する SelectComponent の値に `Column` プロパティをバインドしています。 +Excel スタイル フィルタリング コンポーネントを設定するには、その プロパティを {ComponentTitle} の列の 1 つに設定する必要があります。上記のサンプルでは、{ComponentTitle} の列を表示する SelectComponent の値に プロパティをバインドしています。 ### 表示要素が重なる場合のアウトレット設定 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/export-excel.mdx b/docs/xplat/src/content/jp/components/grids/_shared/export-excel.mdx index 5650fcff81..94022c6cfa 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/export-excel.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/export-excel.mdx @@ -122,7 +122,7 @@ PDF エクスポートには、ドキュメントの上部に列ヘッダー行 is also configured to demonstrate how you can control which export formats are available to end users. Use the toolbar exporter options to toggle Excel, CSV, or PDF buttons: - `export-excel`, `export-csv`, `export-pdf` - `exportExcel`, `exportCsv`, `exportPdf` -- `ExportExcel`, `ExportCsv`, `ExportPdf` +- , `ExportCsv`, `ExportPdf` diff --git a/docs/xplat/src/content/jp/components/grids/_shared/filtering.mdx b/docs/xplat/src/content/jp/components/grids/_shared/filtering.mdx index eb6bbf4b16..ea5f032eed 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/filtering.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/filtering.mdx @@ -30,7 +30,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 設定 -フィルタリングが有効かどうか、およびどのフィルタリング モードを使用するかを指定するために、{ComponentName} は次のブール プロパティを公開します - `AllowFiltering`、`AllowAdvancedFiltering`、`FilterMode` と `Filterable`。 +フィルタリングが有効かどうか、およびどのフィルタリング モードを使用するかを指定するために、{ComponentName} は次のブール プロパティを公開します - `AllowFiltering`、`AllowAdvancedFiltering`、`FilterMode` と 。 以下のオプションは、プロパティ `AllowFiltering` で指定できます。 - **false** - 対応するグリッドのフィルタリングが無効になります。これがデフォルト値です。 @@ -44,7 +44,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - **QuickFilter** - 簡易なフィルタリング UI。これがデフォルト値です。 - **ExcelStyleFilter** - Excel のようなフィルタリング UI。 -以下のオプションは、プロパティ `Filterable` で指定できます。 +以下のオプションは、プロパティ で指定できます。 - **true** - 対応する列のフィルタリングが有効になります。これがデフォルト値です。 - **false** - 対応する列のフィルタリングが無効になります。 @@ -127,9 +127,9 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 使用方法 -デフォルトの定義済みフィルタリングおよび標準のフィルタリング条件があり、カスタム実装で置き換えることも可能です。また、カスタム フィルタリング条件を追加することもできます。 には、簡易なフィルター UI と詳細なフィルター オプションがあります。列で設定された `DataType` に基づいて、適切な**フィルタリング処理**のセットがフィルター UI ドロップダウンに読み込まれます。また、`IgnoreCase` と最初の `Condition` プロパティを設定できます。 +デフォルトの定義済みフィルタリングおよび標準のフィルタリング条件があり、カスタム実装で置き換えることも可能です。また、カスタム フィルタリング条件を追加することもできます。 には、簡易なフィルター UI と詳細なフィルター オプションがあります。列で設定された に基づいて、適切な**フィルタリング処理**のセットがフィルター UI ドロップダウンに読み込まれます。また、 と最初の プロパティを設定できます。 -フィルタリング機能は、`AllowFiltering` 入力を **true** に設定すると コンポーネントで有効になります。デフォルトの `FilterMode` は `QuickFilter` でランタイムでは**変更できません**。特定の列でこの機能を無効にするには、`Filterable` 入力を **false** に設定します。 +フィルタリング機能は、`AllowFiltering` 入力を **true** に設定すると コンポーネントで有効になります。デフォルトの `FilterMode` は `QuickFilter` でランタイムでは**変更できません**。特定の列でこの機能を無効にするには、 入力を **false** に設定します。 @@ -203,11 +203,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - `Filter` - 単一の列または複数の列をフィルターします。 以下の 5 つのフィルタリング オペランド クラスが公開されます。 - - `FilteringOperand`: カスタムフィルタリング条件の定義時に継承できるベース フィルタリング オペランドです。 - - `BooleanFilteringOperand` は、*boolean* 型のすべてのデフォルト フィルタリング条件を定義します。 - - `NumberFilteringOperand` は、*numeric* 型のすべてのデフォルト フィルタリング条件を定義します。 - - `StringFilteringOperand` は、*string* 型のすべてのデフォルト フィルタリング条件を定義します。 - - `DateFilteringOperand` は、*date* 型のすべてのデフォルト フィルタリング条件を定義します。 + - : カスタムフィルタリング条件の定義時に継承できるベース フィルタリング オペランドです。 + - は、*boolean* 型のすべてのデフォルト フィルタリング条件を定義します。 + - は、*numeric* 型のすべてのデフォルト フィルタリング条件を定義します。 + - は、*string* 型のすべてのデフォルト フィルタリング条件を定義します。 + - は、*date* 型のすべてのデフォルト フィルタリング条件を定義します。 必要なパラメーターは列フィールド キーとフィルター用語のみです。条件および大文字と小文字の区別を設定しない場合、列プロパティで推測されます。フィルターが複数ある場合、このメソッドはフィルター式の配列を受け取ります。 @@ -682,7 +682,7 @@ constructor() { ## カスタム フィルタリング オペランド -フィルタリング メニューは、フィルタリング オペランド削除または変更してカスタマイズします。デフォルトでフィルタリング メニューは列のデータ型 (`BooleanFilteringOperand`、`DateFilteringOperand`、`NumberFilteringOperand`、`StringFilteringOperand`) に基づいて特定のオペランドを含みます。これらのクラスまたは基本クラス `FilteringOperand` を拡張してフィルタリング メニュー項目の動作を変更できます。 +フィルタリング メニューは、フィルタリング オペランド削除または変更してカスタマイズします。デフォルトでフィルタリング メニューは列のデータ型 () に基づいて特定のオペランドを含みます。これらのクラスまたは基本クラス を拡張してフィルタリング メニュー項目の動作を変更できます。 @@ -712,7 +712,7 @@ public matchingRecordsOnlyStrategy = new TreeGridMatchingRecordsOnlyFilteringStr ## フィルター セルの再テンプレート化 -フィルター セルを再テンプレート化するために、`FilterCellTemplate` とマークされたテンプレートを追加することができます。以下のサンプルでは、​​文字列カラムへの入力と日付列に `DatePicker` が追加されています。ユーザーが値を入力または選択すると、文字列カラムには contains 演算子、日付列には equals 演算子を使用したフィルターが、グリッドのパブリック API を使用して適用されます。 +フィルター セルを再テンプレート化するために、 とマークされたテンプレートを追加することができます。以下のサンプルでは、​​文字列カラムへの入力と日付列に `DatePicker` が追加されています。ユーザーが値を入力または選択すると、文字列カラムには contains 演算子、日付列には equals 演算子を使用したフィルターが、グリッドのパブリック API を使用して適用されます。 ```html @@ -894,14 +894,14 @@ $custom-grid: grid-theme( - `filteringExpressions` property is removed. Use instead. - `filter_multiple` method is removed. Use `Filter` method and property instead. - The `Filter` method has new signature. It now accepts the following parameters: - - `Name` - the name of the column to be filtered. + - - the name of the column to be filtered. - `Value` - the value to be used for filtering. - - `ConditionOrExpressionTree` (optional) - this parameter accepts object of type `FilteringOperation` or . If only simple filtering is needed, a filtering operation could be passed as an argument. In case of advanced filtering, an expressions tree containing complex filtering logic could be passed as an argument. - - `IgnoreCase` (optional) - whether the filtering is case sensitive or not. + - `ConditionOrExpressionTree` (optional) - this parameter accepts object of type or . If only simple filtering is needed, a filtering operation could be passed as an argument. In case of advanced filtering, an expressions tree containing complex filtering logic could be passed as an argument. + - (optional) - whether the filtering is case sensitive or not. - `FilteringDone` event now have only one parameter of type which contains the filtering state of the filtered column. -- filtering operands: `FilteringExpression` condition property is no longer a direct reference to a filtering condition method, instead it's a reference to an `FilteringOperation`. -- `ColumnComponent` now exposes a `Filters` property, which takes an `FilteringOperand` class reference. -- Custom filters can be provided to the {ComponentTitle} columns by populating the `Operations` property of the `FilteringOperand` with operations of `FilteringOperation` type. +- filtering operands: condition property is no longer a direct reference to a filtering condition method, instead it's a reference to an . +- `ColumnComponent` now exposes a property, which takes an class reference. +- Custom filters can be provided to the {ComponentTitle} columns by populating the property of the with operations of type. diff --git a/docs/xplat/src/content/jp/components/grids/_shared/keyboard-navigation.mdx b/docs/xplat/src/content/jp/components/grids/_shared/keyboard-navigation.mdx index ed764e319a..52983313c9 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/keyboard-navigation.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/keyboard-navigation.mdx @@ -128,7 +128,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - ALT + または ALT + - マスター/詳細行で詳細ビューを縮小します。 - ALT + または ALT + - マスター/詳細行で詳細ビューを展開します。 -- SPACE - グループ行上 - `RowSelection` プロパティが複数に設定されている場合、グループ内のすべての行を選択します。 +- SPACE - グループ行上 - プロパティが複数に設定されている場合、グループ内のすべての行を選択します。 以下のデモサンプルで上記のすべての操作を実行できます。ナビゲーション可能なグリッド要素をフォーカスすると、利用可能な操作のリストが表示されます。 @@ -178,15 +178,15 @@ Practice all of the above mentioned actions in the demo sample below. Focus any |---------|-------------|-----------| | `GridKeydown` | 上記のキー押下やキー押下の組み合わせのいずれかが実行されたときに発生されるイベント。キャンセルできます。その他のキーの押下/組み合わせには、デフォルトの `onkeydown` イベントを使用します。 | | | `ActiveNodeChange` | アクティブ ノードが変更されたときに発行されるイベント。これを使用して、アクティブ フォーカス位置 (ヘッダー、tbody など)、列インデックス、行インデックス、またはネストされたレベルを決定できます。 | | -| `NavigateTo` | 提供された `Rowindex` と `VisibleColumnIndex` に基づいてグリッド内の位置に移動します。```{ targetType: GridKeydownTargetType, target: Object }``` タイプのパラメーターを受け入れるコールバック関数を通してターゲット要素上でカスタム ロジックを実行することもできます。使用方法:
```grid.navigateTo(10, 3, (args) => { args.target.nativeElement.focus(); });``` | ```RowIndex: number, VisibleColumnIndex: number, callback: ({ targetType: GridKeydownTargetType, target: Object }```) => {} | -| `GetNextCell`| `RowIndex` と `VisibleColumnIndex` で次のセルを定義する `ICellPosition` オブジェクトを返します。コールバック関数は、`GetNextCell` メソッドの 3 番目のパラメーターとして渡すことができます。コールバック関数は、パラメーターとして `Column` を受け取り、指定された条件が満たされた場合に `boolean` 値を返します:
```const nextEditableCell = grid.getNextCell(0, 4, (col) => col.editable);``` | ```currentRowIndex: number, currentVisibleColumnIndex: number, callback: (Column) => boolean``` | -| `GetPreviousCell` | `RowIndex` と `VisibleColumnIndex` で前のセルを定義する `ICellPosition` オブジェクトを返します。コールバック関数は、`GetPreviousCell` メソッドの 3 番目のパラメーターとして渡すことができます。コールバック関数は、パラメーターとして `Column` を受け取り、指定された条件が満たされた場合に `boolean` 値を返します:
```const prevEditableCell = grid.getPreviousCell(0, 4, (col) => col.editable);``` | ``` CurrentRowIndex: number, CurrentVisibleColumnIndex: number, callback: (Column) => boolean ``` | +| | 提供された `Rowindex` と `VisibleColumnIndex` に基づいてグリッド内の位置に移動します。```{ targetType: GridKeydownTargetType, target: Object }``` タイプのパラメーターを受け入れるコールバック関数を通してターゲット要素上でカスタム ロジックを実行することもできます。使用方法:
```grid.navigateTo(10, 3, (args) => { args.target.nativeElement.focus(); });``` | ```RowIndex: number, VisibleColumnIndex: number, callback: ({ targetType: GridKeydownTargetType, target: Object }```) => {} | +| | `RowIndex` と `VisibleColumnIndex` で次のセルを定義する `ICellPosition` オブジェクトを返します。コールバック関数は、 メソッドの 3 番目のパラメーターとして渡すことができます。コールバック関数は、パラメーターとして を受け取り、指定された条件が満たされた場合に `boolean` 値を返します:
```const nextEditableCell = grid.getNextCell(0, 4, (col) => col.editable);``` | ```currentRowIndex: number, currentVisibleColumnIndex: number, callback: (Column) => boolean``` | +| | `RowIndex` と `VisibleColumnIndex` で前のセルを定義する `ICellPosition` オブジェクトを返します。コールバック関数は、 メソッドの 3 番目のパラメーターとして渡すことができます。コールバック関数は、パラメーターとして を受け取り、指定された条件が満たされた場合に `boolean` 値を返します:
```const prevEditableCell = grid.getPreviousCell(0, 4, (col) => col.editable);``` | ``` CurrentRowIndex: number, CurrentVisibleColumnIndex: number, callback: (Column) => boolean ``` |

-`GetNextCell` および `GetPreviousCell` は現在のレベルで使用し、上位または下位レベルのセルにアクセスできません。 + および は現在のレベルで使用し、上位または下位レベルのセルにアクセスできません。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/multi-column-headers.mdx b/docs/xplat/src/content/jp/components/grids/_shared/multi-column-headers.mdx index 9e0a03ff67..e0149bdc4b 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/multi-column-headers.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/multi-column-headers.mdx @@ -22,7 +22,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -複数列ヘッダーの宣言は、一連の列を コンポーネントにラップし、`Header` タイトル情報を渡すことによって実現されます。 +複数列ヘッダーの宣言は、一連の列を コンポーネントにラップし、 タイトル情報を渡すことによって実現されます。 @@ -600,7 +600,7 @@ columns と column groups 間の移動は、それらが階層内の同じレベ -グリッドの各列グループは個別のテンプレートを持つことができます。列グループは、`HeaderTemplate` プロパティの `RenderFragment` を想定しています。 +グリッドの各列グループは個別のテンプレートを持つことができます。列グループは、 プロパティの `RenderFragment` を想定しています。 式は、列グループ オブジェクトと共にコンテキストとして提供されています。 ```razor diff --git a/docs/xplat/src/content/jp/components/grids/_shared/multi-row-layout.mdx b/docs/xplat/src/content/jp/components/grids/_shared/multi-row-layout.mdx index 69a52c9419..a531671bc1 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/multi-row-layout.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/multi-row-layout.mdx @@ -28,13 +28,13 @@ import multiRowLayout1 from '@xplat-images/multi-row-layout-1.png'; -複数行レイアウトの宣言は、 コンポーネントによって実現されます。各 コンポーネントは、単一または複数の `Column` コンポーネントを含むブロックと見なします。一部のグリッド機能はブロック レベルで機能します (下記の「機能の統合」セクション参照)。たとえば、仮想化ではブロックを使用して仮想チャンクを決定します。そのため、レイアウトで許容される場合は、パフォーマンスを向上させるために列を更に ブロックに分割します。複数行のレイアウトを設定するときは、これらのブロックの外側に列がなく、 を使用しないでください。複数行のレイアウトは、[グリッド レイアウト](https://www.w3.org/TR/css-grid-1/)仕様上に実装されており、その要件に準拠する必要があります。 +複数行レイアウトの宣言は、 コンポーネントによって実現されます。各 コンポーネントは、単一または複数の コンポーネントを含むブロックと見なします。一部のグリッド機能はブロック レベルで機能します (下記の「機能の統合」セクション参照)。たとえば、仮想化ではブロックを使用して仮想チャンクを決定します。そのため、レイアウトで許容される場合は、パフォーマンスを向上させるために列を更に ブロックに分割します。複数行のレイアウトを設定するときは、これらのブロックの外側に列がなく、 を使用しないでください。複数行のレイアウトは、[グリッド レイアウト](https://www.w3.org/TR/css-grid-1/)仕様上に実装されており、その要件に準拠する必要があります。 は各セルの位置と範囲を決めるために 4 つの `Input` プロパティを公開します。 -- `ColStart` - フィールドの開始位置となる列インデックス。このプロパティは**必須**です。 -- `RowStart` - フィールドの開始位置となる行インデックス。このプロパティは**必須**です。 -- `ColEnd` - 現在のフィールドが終了する位置の列インデックス。colStart と colEnd の間の列数によって、そのフィールドまでの列の幅が決まります。このプロパティは**オプション**です。設定されていない場合、デフォルトは **colStart + 1** になります。 -- `RowEnd` - 現在のフィールドが終了する行インデックス。rowStart と rowEnd の間の行数によって、そのフィールドにまたがる行数が決まります。このプロパティは**オプション**です。設定されていない場合は、デフォルトで **rowStart + 1** に設定されます。 +- - フィールドの開始位置となる列インデックス。このプロパティは**必須**です。 +- - フィールドの開始位置となる行インデックス。このプロパティは**必須**です。 +- - 現在のフィールドが終了する位置の列インデックス。colStart と colEnd の間の列数によって、そのフィールドまでの列の幅が決まります。このプロパティは**オプション**です。設定されていない場合、デフォルトは **colStart + 1** になります。 +- - 現在のフィールドが終了する行インデックス。rowStart と rowEnd の間の行数によって、そのフィールドにまたがる行数が決まります。このプロパティは**オプション**です。設定されていない場合は、デフォルトで **rowStart + 1** に設定されます。 @@ -138,12 +138,12 @@ import multiRowLayout1 from '@xplat-images/multi-row-layout-1.png'; multi-row-layout -`RowStart` と `ColStart` プロパティは、 内の各 に設定する必要があります。 コンポーネントはレイアウトが正しいかどうかを検証しておらず、それについてエラーや警告をスローしません。開発者は、レイアウトの宣言が正しく、完全であることを確認し、誤った配置、オーバーラップ、ブラウザーでの不整合、レイアウトの崩れなどを回避する必要があります。 + プロパティは、 内の各 に設定する必要があります。 コンポーネントはレイアウトが正しいかどうかを検証しておらず、それについてエラーや警告をスローしません。開発者は、レイアウトの宣言が正しく、完全であることを確認し、誤った配置、オーバーラップ、ブラウザーでの不整合、レイアウトの崩れなどを回避する必要があります。 ## 機能の統合 -複数行レイアウトのレンダリング方法は全く異なるため、列ピン固定や列非表示など一部の列機能は コンポーネントでのみ機能します。その他の機能ソートとグループ化などは、`Column` コンポーネントで同じように機能します。 +複数行レイアウトのレンダリング方法は全く異なるため、列ピン固定や列非表示など一部の列機能は コンポーネントでのみ機能します。その他の機能ソートとグループ化などは、 コンポーネントで同じように機能します。 - フィルタリング - Excel スタイルのフィルタリングのみがサポートされています。`FilterMode` を `FilterMode.quickFilter` に明示的に設定しても効果はありません。 - ページング - 表示行ではなくレコードで機能します。 @@ -200,7 +200,7 @@ import multiRowLayout1 from '@xplat-images/multi-row-layout-1.png'; ### レイアウトの構成 -列レイアウトを構成するときに、適切な `ColStart` および `ColEnd`、または `RowStart` および `RowEnd` を計算して設定するのが難しい場合があります。特に 1 つのレイアウトに多数の列がある場合などですが、適用時のプレビューを簡単に確認するためにコンフィギュレーターを使用できます。以下の操作が可能です。 +列レイアウトを構成するときに、適切な および 、または および を計算して設定するのが難しい場合があります。特に 1 つのレイアウトに多数の列がある場合などですが、適用時のプレビューを簡単に確認するためにコンフィギュレーターを使用できます。以下の操作が可能です。 - 設定全体の行数を設定します。すべてのレイアウトは同じ行数である必要があります。 - **[レイアウトの追加]** チップをクリックするか、レイアウトチップを左右にドラッグしてソートします。 @@ -232,7 +232,7 @@ import multiRowLayout1 from '@xplat-images/multi-row-layout-1.png'; ### グローバル テーマのインポート -複数行レイアウト機能のカスタマイズは、すべてのスタイリング機能とミックスインが配置されている `Index` ファイルをインポートする必要があります。 +複数行レイアウト機能のカスタマイズは、すべてのスタイリング機能とミックスインが配置されている ファイルをインポートする必要があります。 ```scss @use "igniteui-angular/theming" as *; diff --git a/docs/xplat/src/content/jp/components/grids/_shared/paging.mdx b/docs/xplat/src/content/jp/components/grids/_shared/paging.mdx index 6651d0858d..9d5198b568 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/paging.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/paging.mdx @@ -184,7 +184,7 @@ TO-DO H-GRID CODE SNIPPET ### 子グリッド内のページネーター設定 -Due to certain limitations in how the child grids of an are implemented and how DI scope works, when defining a paginator component inside the `RowIsland` tags, always make sure to use the directive on the paginator itself. This will make sure that the child grid have the correct paginator instance as a reference: +Due to certain limitations in how the child grids of an are implemented and how DI scope works, when defining a paginator component inside the tags, always make sure to use the directive on the paginator itself. This will make sure that the child grid have the correct paginator instance as a reference: diff --git a/docs/xplat/src/content/jp/components/grids/_shared/remote-data-operations.mdx b/docs/xplat/src/content/jp/components/grids/_shared/remote-data-operations.mdx index 8987a475ba..26ae289d95 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/remote-data-operations.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/remote-data-operations.mdx @@ -72,7 +72,7 @@ BLAZOR CODE SNIPPET HERE ``` -When requesting data, you need to utilize the interface, which provides the and properties. +When requesting data, you need to utilize the interface, which provides the and properties. The first will always be 0 and should be determined by you based on the specific application scenario. @@ -98,7 +98,7 @@ The first および プロパティを提供する `IForOfState` インターフェイスを使用できます。 ```html @@ -138,7 +138,7 @@ public processData(reset) { -最初の `ChunkSize` は常に 0 で、特定のアプリケーション シナリオに基づいて設定する必要があります。 +最初の は常に 0 で、特定のアプリケーション シナリオに基づいて設定する必要があります。 @@ -235,7 +235,7 @@ BLAZOR CODE SNIPPET HERE エンドポイントからデータを分割して取得するシナリオの一般的なデザインは、無限スクロールです。データ グリッドの場合、エンドユーザーが一番下までスクロールすることによってトリガーされたロードデータが連続的に増加します。次の段落では、使用可能な API を使用して で無限スクロールを簡単に実現する方法について説明します。 -無限スクロールを実装するには、データを分割してフェッチする必要があります。すでにフェッチされたデータはローカルに保存し、チャンクの長さおよび数を決定する必要があります。また、グリッドで最後に表示されるデータ行インデックスを追跡する必要があります。このように、`StartIndex` と `ChunkSize` プロパティを使用して、ユーザーが上にスクロールして既にフェッチしたデータを表示するか、下にスクロールしてエンドポイントからさらにデータをフェッチする必要があるかを決定できます。 +無限スクロールを実装するには、データを分割してフェッチする必要があります。すでにフェッチされたデータはローカルに保存し、チャンクの長さおよび数を決定する必要があります。また、グリッドで最後に表示されるデータ行インデックスを追跡する必要があります。このように、 プロパティを使用して、ユーザーが上にスクロールして既にフェッチしたデータを表示するか、下にスクロールしてエンドポイントからさらにデータをフェッチする必要があるかを決定できます。 ```typescript public ngAfterViewInit() { @@ -361,7 +361,7 @@ BLAZOR CODE SNIPPET HERE ``` -リモート ソートとフィルタリングが提供される場合、グリッドの組み込みのソートとフィルタリングは必要ありません。グリッドの `SortStrategy` および `FilterStrategy` 入力をそれぞれのインスタンスの `NoopSortingStrategy` および に設定して、無効にできます。 +リモート ソートとフィルタリングが提供される場合、グリッドの組み込みのソートとフィルタリングは必要ありません。グリッドの および 入力をそれぞれのインスタンスの `NoopSortingStrategy` および に設定して、無効にできます。 ```html @@ -403,11 +403,11 @@ When remote data is requested, the filtering operation is case-sensitive. ## リモート フィルタリング -リモート フィルタリングを提供するには、受け取った引数に基づいて適切な要求を行うように `FilteringExpressionsTreeChange` 出力にサブスクライブする必要があります。`PrimaryKey` と `ForeignKey` を提供して、Tree Grid のデータソースとしてフラット コレクションを使用します。 +リモート フィルタリングを提供するには、受け取った引数に基づいて適切な要求を行うように `FilteringExpressionsTreeChange` 出力にサブスクライブする必要があります。 と `ForeignKey` を提供して、Tree Grid のデータソースとしてフラット コレクションを使用します。 また、**rxjs** `debounceTime` 関数を使用します。この関数は、特定の期間の経過後、別のソースが出力されない場合にのみ、Observable のソースから値を出力します。この方法では、ユーザーが中断することなく指定された時間が経過した場合にのみ、リモート操作がトリガーされます。 -リモート フィルタリングが提供される場合、ツリー グリッドの組み込みのフィルタリングは必要ありません。ツリー グリッドの `FilterStrategy` 入力を `NoopFilteringStrategy` インスタンスに設定して、無効にできます。 +リモート フィルタリングが提供される場合、ツリー グリッドの組み込みのフィルタリングは必要ありません。ツリー グリッドの 入力を `NoopFilteringStrategy` インスタンスに設定して、無効にできます。 リモート フィルタリングは、フラット コレクションで直接実行する必要があります。また、親がフィルターに一致するかどうかにかかわらず、フィルター条件に一致するすべてのレコードにすべての親を含める必要があります (階層をそのままにするためにこれを行います)。結果は以下で確認できます。 @@ -785,8 +785,8 @@ export class RemoteService { -- `Column` - それぞれの列インスタンス。 -- `FilteringExpressionsTree` - フィルタリング式ツリー。各列に基づいて削減されます。 +- - それぞれの列インスタンス。 +- - フィルタリング式ツリー。各列に基づいて削減されます。 - `Done` - サーバーから取得されたときに、新しく生成された列値で呼び出されるコールバック。 @@ -1297,7 +1297,7 @@ next set up the method for loading the data: -開発者は、`Column` と `FilteringExpressionsTree` 引数によって提供される情報に基づいて、必要な一意の列値を手動で生成し、`Done` コールバックを呼び出すことができます。 +開発者は、 引数によって提供される情報に基づいて、必要な一意の列値を手動で生成し、`Done` コールバックを呼び出すことができます。 ```tsx function gridCreated(event: IgrGridCreatedEventArgs, parentKey: string) { @@ -1342,7 +1342,7 @@ For further reference please check the full sample bellow: -In this sample we will demonstrate how to display a certain number of root records per page no matter how many child records they have. In order to cancel the built-in Tree Grid paging algorithm, which displays a certain number of records no matter their level (root or child), we have to set the `PerPage` property to `Number.MAX_SAFE_INTEGER`. +In this sample we will demonstrate how to display a certain number of root records per page no matter how many child records they have. In order to cancel the built-in Tree Grid paging algorithm, which displays a certain number of records no matter their level (root or child), we have to set the property to `Number.MAX_SAFE_INTEGER`. ```html @@ -1834,7 +1834,7 @@ BLAZOR CODE SNIPPET HERE ``` -As you can see in the `Paginate` method, custom pagination logic is performed, based on the `TotalPagesOnServer` value. +As you can see in the method, custom pagination logic is performed, based on the `TotalPagesOnServer` value. #### Remote Paging with Batch Editing Demo diff --git a/docs/xplat/src/content/jp/components/grids/_shared/row-actions.mdx b/docs/xplat/src/content/jp/components/grids/_shared/row-actions.mdx index ede62dbcdc..9bb0d935b2 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/row-actions.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/row-actions.mdx @@ -317,7 +317,7 @@ import { IgxActionStripModule } from 'igniteui-angular'; -事前定義された操作は `GridActionsBaseDirective` を継承します。カスタム グリッド アクション コンポーネントを作成する場合、`GridActionsBaseDirective` も継承する必要があります。 +事前定義された操作は を継承します。カスタム グリッド アクション コンポーネントを作成する場合、 も継承する必要があります。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/row-adding.mdx b/docs/xplat/src/content/jp/components/grids/_shared/row-adding.mdx index c190150d99..be6fc72ff4 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/row-adding.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/row-adding.mdx @@ -47,7 +47,7 @@ export class AppModule {} ``` -次に、バインドしたデータ ソースに を定義をして `RowEditable` を true に設定し、編集アクションを有効にした コンポーネントを定義します。`AddRow` 入力は、行追加 UI を生成するボタンの表示状態を制御します。 +次に、バインドしたデータ ソースに を定義をして `RowEditable` を true に設定し、編集アクションを有効にした コンポーネントを定義します。 入力は、行追加 UI を生成するボタンの表示状態を制御します。 @@ -382,13 +382,13 @@ export class AppModule {} > **注**: -> [行の追加] のボタンの表示状態を制御する 入力は、アクション ストリップ コンテキスト (タイプ を使用して、ボタンが表示するレコードを調整できます。 +> [行の追加] のボタンの表示状態を制御する 入力は、アクション ストリップ コンテキスト (タイプ を使用して、ボタンが表示するレコードを調整できます。 > **注**: -> [行の追加] のボタンの表示状態を制御する 入力は、アクション ストリップ コンテキスト (タイプ ) を使用して、ボタンが表示するレコードを調整できます。 +> [行の追加] のボタンの表示状態を制御する 入力は、アクション ストリップ コンテキスト (タイプ ) を使用して、ボタンが表示するレコードを調整できます。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/row-pinning.mdx b/docs/xplat/src/content/jp/components/grids/_shared/row-pinning.mdx index fa147aa89e..1e7f7d5e15 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/row-pinning.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/row-pinning.mdx @@ -95,7 +95,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 行のピン固定 API -行のピン固定は `Row` の `Pinned` 入力によって制御されます。デフォルトでピン固定行は の上側に固定して描画され、 本体のピン固定されていない行は垂直スクロールされます。 +行のピン固定は `Row` の 入力によって制御されます。デフォルトでピン固定行は の上側に固定して描画され、 本体のピン固定されていない行は垂直スクロールされます。 ```typescript @@ -689,8 +689,8 @@ $custom-grid-theme: grid-theme( ## API リファレンス
-
-
+
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/grids/_shared/row-selection.mdx b/docs/xplat/src/content/jp/components/grids/_shared/row-selection.mdx index 122307f2a9..aecb5d29ae 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/row-selection.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/row-selection.mdx @@ -39,9 +39,9 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 設定 -で項目の選択を設定するには、その `RowSelection` プロパティを設定する必要があります。このプロパティは、 列挙を受け取ります。 +で項目の選択を設定するには、その プロパティを設定する必要があります。このプロパティは、 列挙を受け取ります。 - exposes the following modes: + exposes the following modes: `GridSelectionMode` は以下のモードを公開します。 @@ -56,11 +56,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ### None 選択 - では、デフォルトで行選択が無効になります。(`RowSelection` は None です。)したがって、UI とのインタラクションを通じて行を選択または選択解除することは**できません**が、選択/選択解除する唯一の方法は、提供された API メソッドを使用することです。 + では、デフォルトで行選択が無効になります。( は None です。)したがって、UI とのインタラクションを通じて行を選択または選択解除することは**できません**が、選択/選択解除する唯一の方法は、提供された API メソッドを使用することです。 ### 単一選択 -単一行の選択は、`RowSelection` プロパティ を `Single` に設定することのみで簡単に設定できるようになりました。これにより、**グリッド内の 1 行のみを選択できます**。行のセルにフォーカスするときにセルをクリックするか SPACE キーを押すと行を選択できます。もちろん、行セレクターフィールドをクリックして行を選択できます。行が選択または選択解除されると、`RowSelectionChanging` イベントが生成されます。 +単一行の選択は、 プロパティ を `Single` に設定することのみで簡単に設定できるようになりました。これにより、**グリッド内の 1 行のみを選択できます**。行のセルにフォーカスするときにセルをクリックするか SPACE キーを押すと行を選択できます。もちろん、行セレクターフィールドをクリックして行を選択できます。行が選択または選択解除されると、`RowSelectionChanging` イベントが生成されます。 ```html @@ -130,7 +130,7 @@ const handleRowSelection = (args: IgrRowSelectionEventArgs) => { ### 複数選択 - で複数の項目を選択できるようにするには、`RowSelection` プロパティを `Multiple` に設定するだけです。これにより、各行および ヘッダーで行セレクター フィールドが有効になります。行セレクターを使用して複数行を選択できます。選択はスクロール、ページング、およびソートとフィルター、などのデータ操作で保持されます。行を選択するには、セルをクリックするか、セルにフォーカスがあるときに SPACE キーを押します。1 つの行を選択し、SHIFT キーを押しながら別の行をクリックすると、行の範囲全体が選択されます。この選択モードでは、単一の行をクリックすると、前に選択した行が選択解除されます。CTRL キーを押しながらクリックすると、行が切り替わり、前の選択が保持されます。 + で複数の項目を選択できるようにするには、 プロパティを `Multiple` に設定するだけです。これにより、各行および ヘッダーで行セレクター フィールドが有効になります。行セレクターを使用して複数行を選択できます。選択はスクロール、ページング、およびソートとフィルター、などのデータ操作で保持されます。行を選択するには、セルをクリックするか、セルにフォーカスがあるときに SPACE キーを押します。1 つの行を選択し、SHIFT キーを押しながら別の行をクリックすると、行の範囲全体が選択されます。この選択モードでは、単一の行をクリックすると、前に選択した行が選択解除されます。CTRL キーを押しながらクリックすると、行が切り替わり、前の選択が保持されます。 ```html @@ -173,7 +173,7 @@ const handleRowSelection = (args: IgrRowSelectionEventArgs) => { ### カスケード選択 - で複数の項目を選択できるようにするには、`RowSelection` プロパティを `MultipleCascade` に設定するだけです。これにより、各行および ヘッダーで行セレクター フィールドが有効になります。行セレクターを使用すると、ユーザーは複数の行を選択して、下のツリーのすべての子を選択できます。選択は、スクロール、ページング、およびソートやフィルタリングなどのデータ操作を通じて保持されます。行は、セルをクリックするか、セルがフォーカスされているときに SPACE キーを押すことによっても選択できます。1 つの行を選択し、SHIFT キーを押しながら別の行をクリックすると、親レコードの選択を通じて選択した範囲内にない場合でも、そのすべての子が選択されます。この選択モードでは、単一の行をクリックすると、前に選択した行が選択解除されます。CTRL キーを押しながらクリックすると、行とその子が切り替えられ、前の選択が保持されます。 + で複数の項目を選択できるようにするには、 プロパティを `MultipleCascade` に設定するだけです。これにより、各行および ヘッダーで行セレクター フィールドが有効になります。行セレクターを使用すると、ユーザーは複数の行を選択して、下のツリーのすべての子を選択できます。選択は、スクロール、ページング、およびソートやフィルタリングなどのデータ操作を通じて保持されます。行は、セルをクリックするか、セルがフォーカスされているときに SPACE キーを押すことによっても選択できます。1 つの行を選択し、SHIFT キーを押しながら別の行をクリックすると、親レコードの選択を通じて選択した範囲内にない場合でも、そのすべての子が選択されます。この選択モードでは、単一の行をクリックすると、前に選択した行が選択解除されます。CTRL キーを押しながらクリックすると、行とその子が切り替えられ、前の選択が保持されます。 ```html @@ -227,7 +227,7 @@ const handleRowSelection = (args: IgrRowSelectionEventArgs) => { -- 行選択およびセル選択を正しく実行するには、 にリモート仮想化がある場合、`PrimaryKey` を設定します。 +- 行選択およびセル選択を正しく実行するには、 にリモート仮想化がある場合、 を設定します。 - でリモート仮想化を使用した場合、ヘッダーのチェックボックスをクリックすると、現在グリッドにあるすべてのレコードが選択/選択解除されます。新しいデータがオンデマンドで にロードされると、新、しく追加された行は選択されない制限があるため、これらの行を選択するには API メソッドを使用して動作を処理する必要があります。 @@ -235,7 +235,7 @@ const handleRowSelection = (args: IgrRowSelectionEventArgs) => { ### コードで行を選択 -以下は、単一または複数の行を同時に選択できるコード例です (`PrimaryKey` を介して)。さらに、このメソッドの 2 番目のパラメーターは boolean プロパティです。それを使用して、前の行の選択をクリアするかどうかを選択できます。以前の選択はデフォルトで保存されます。 +以下は、単一または複数の行を同時に選択できるコード例です ( を介して)。さらに、このメソッドの 2 番目のパラメーターは boolean プロパティです。それを使用して、前の行の選択をクリアするかどうかを選択できます。以前の選択はデフォルトで保存されます。 ```html @@ -310,7 +310,7 @@ function onClickSelect() { ### 行選択の解除 -プログラムで行を選択解除する必要がある場合は、`DeselectRows` メソッドを使用できます。 +プログラムで行を選択解除する必要がある場合は、 メソッドを使用できます。 ```html @@ -458,7 +458,7 @@ const handleRowSelectionChange = (args: IgrRowSelectionEventArgs) => { が提供するもう 1 つの便利な API メソッドが です。このメソッドはデフォルトですべてのデータ行を選択しますが、フィルタリングが適用される場合、フィルター条件に一致する行のみが選択されます。ただし、*false* パラメーターを指定してメソッドを呼び出すと、`SelectAllRows(false)` は、フィルターが適用されているかどうかに関係なく、常にグリッド内のすべてのデータを選択します。 -> **注:** `SelectAllRows` は削除された行を選択しないことに注意してください。 +> **注:** は削除された行を選択しないことに注意してください。 ### 全行の選択解除 @@ -466,7 +466,7 @@ const handleRowSelectionChange = (args: IgrRowSelectionEventArgs) => { ### 選択した行を取得する方法 -現在選択されている行を確認する必要がある場合は、`SelectedRows` ゲッターを使用して行 ID を取得できます。 +現在選択されている行を確認する必要がある場合は、 ゲッターを使用して行 ID を取得できます。 ```ts @@ -508,7 +508,7 @@ function getSelectedRows() { ``` -さらに、`SelectedRows` に行 ID を割り当てると、グリッドの選択状態を変更できます。 +さらに、 に行 ID を割り当てると、グリッドの選択状態を変更できます。 @@ -566,14 +566,14 @@ const mySelectedRows = [1,2,3]; でヘッダーおよび行セレクターをテンプレート化し、さまざまなシナリオに役立つ機能を提供するコンテキストにアクセスすることもできます。 -デフォルトでは、 は、行セレクターの親コンテナまたは行自体の**すべての行選択操作を処理し**、テンプレートの状態の可視化のみになります。基本機能のオーバーライドは通常、[RowSelectionChanging イベント](#行選択イベント)を使用して実行する必要があります。基本機能をオーバーライドする `Click` ハンドラーを使用してカスタムテンプレートを実装する場合、イベントの伝播を停止して、正しい行の状態を保持する必要があります。 +デフォルトでは、 は、行セレクターの親コンテナまたは行自体の**すべての行選択操作を処理し**、テンプレートの状態の可視化のみになります。基本機能のオーバーライドは通常、[RowSelectionChanging イベント](#行選択イベント)を使用して実行する必要があります。基本機能をオーバーライドする ハンドラーを使用してカスタムテンプレートを実装する場合、イベントの伝播を停止して、正しい行の状態を保持する必要があります。 #### 行テンプレート -カスタム行セレクター テンプレートを作成するには、`{ComponentSelector}` 内で `RowSelectorTemplate` プロパティを使用できます。テンプレートから、行の状態に関する情報を提供するプロパティを使用して、暗黙的に提供されたコンテキスト変数にアクセスできます。 +カスタム行セレクター テンプレートを作成するには、`{ComponentSelector}` 内で プロパティを使用できます。テンプレートから、行の状態に関する情報を提供するプロパティを使用して、暗黙的に提供されたコンテキスト変数にアクセスできます。 -`Selected` プロパティは現在の行が選択されているかどうかを示し、`Index` プロパティは行インデックスにアクセスするために使用できます。 + プロパティは現在の行が選択されているかどうかを示し、 プロパティは行インデックスにアクセスするために使用できます。 ```html @@ -653,7 +653,7 @@ const rowSelectorTemplate = (ctx: IgrRowSelectorTemplateContext) => { ``` -`RowID` プロパティを使用して、`{ComponentSelector}` 行の参照を取得できます。行セレクター要素に `click` ハンドラーを実装する場合に便利です。 + プロパティを使用して、`{ComponentSelector}` 行の参照を取得できます。行セレクター要素に `click` ハンドラーを実装する場合に便利です。 ```html @@ -690,7 +690,7 @@ const rowSelectorTemplate = (ctx: IgrRowSelectorTemplateContext) => { ``` -上の例では、`Checkbox` を使用しており、`rowContext.selected` をその `Checked` プロパティにバインドしています。[行番号のデモ](#行の番号付けデモ)で実際にこれをご覧ください。 +上の例では、 を使用しており、`rowContext.selected` をその プロパティにバインドしています。[行番号のデモ](#行の番号付けデモ)で実際にこれをご覧ください。 @@ -700,9 +700,9 @@ const rowSelectorTemplate = (ctx: IgrRowSelectorTemplateContext) => { ### ヘッダー テンプレート -カスタム行ヘッダー セレクター テンプレートを作成するには、 内で `HeadSelectorTemplate` プロパティを使用します。テンプレートから、ヘッダーの状態に関する情報を提供するプロパティを使用して、暗黙的に提供されたコンテキスト変数にアクセスできます。 +カスタム行ヘッダー セレクター テンプレートを作成するには、 内で プロパティを使用します。テンプレートから、ヘッダーの状態に関する情報を提供するプロパティを使用して、暗黙的に提供されたコンテキスト変数にアクセスできます。 -`SelectedCount` プロパティは現在選択されている行数を示し、`TotalCount` は に合計の行数を示します。 + プロパティは現在選択されている行数を示し、 に合計の行数を示します。 ```html @@ -742,7 +742,7 @@ public RenderFragment Template = (context) => ``` -`SelectedCount` および `TotalCount` プロパティを使用して、ヘッド セレクターをチェックするか、不確定にする(部分的に選択する)かを決定できます。 + および プロパティを使用して、ヘッド セレクターをチェックするか、不確定にする(部分的に選択する)かを決定できます。 @@ -828,7 +828,7 @@ const headSelectorTemplate = (ctx: IgrHeadSelectorTemplateContext) => { ### 行の番号付けデモ -このデモでは、カスタム ヘッダーと行セレクターの使用方法を示します。後者は、`RowContext.Index` を使用して行番号と、`RowContext.Selected` にバインドされた `Checkbox` を表示します。 +このデモでは、カスタム ヘッダーと行セレクターの使用方法を示します。後者は、`RowContext.Index` を使用して行番号と、`RowContext.Selected` にバインドされた を表示します。 @@ -856,9 +856,9 @@ const headSelectorTemplate = (ctx: IgrHeadSelectorTemplateContext) => {

-
-
-
+
+
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/grids/_shared/search.mdx b/docs/xplat/src/content/jp/components/grids/_shared/search.mdx index 07cebbe2c7..d3ae157b21 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/search.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/search.mdx @@ -1335,7 +1335,7 @@ public updateSearch() { |制限|説明| |--- |--- | -|テンプレートを使用したセル内の検索|検索機能のハイライト表示が、デフォルトのセルテンプレートに対してのみ機能する問題。カスタム セル テンプレートを含む列がある場合、ハイライト表示が機能しないため、列フォーマッタなどの代替アプローチを使用するか、`Searchable` (検索可能な) プロパティを false に設定します。| +|テンプレートを使用したセル内の検索|検索機能のハイライト表示が、デフォルトのセルテンプレートに対してのみ機能する問題。カスタム セル テンプレートを含む列がある場合、ハイライト表示が機能しないため、列フォーマッタなどの代替アプローチを使用するか、 (検索可能な) プロパティを false に設定します。| |リモート仮想化| リモート仮想化の使用時に検索が正しく動作しません。| |セル テキストが切れる問題| セル内のテキストが長すぎるために検索テキストが省略記号によって切れている場合も、セルまでスクロールして一致カウントに含まれますが、ハイライト表示はされません。 | diff --git a/docs/xplat/src/content/jp/components/grids/_shared/selection.mdx b/docs/xplat/src/content/jp/components/grids/_shared/selection.mdx index 649a62d1b5..7d0f99ad8f 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/selection.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/selection.mdx @@ -41,7 +41,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## {Platform} {ComponentTitle} 選択のオプション -{ProductName} コンポーネントは、[行選択](row-selection.md)、[セル選択](cell-selection.md)、[列選択](column-selection.md)の 3 つの選択モードを提供します。デフォルトでは、 で**複数セル選択**モードのみが有効になっています。選択モードの変更または有効化は、`RowSelection`、`CellSelection` または `Selectable` プロパティを使用します。 +{ProductName} コンポーネントは、[行選択](row-selection.md)、[セル選択](cell-selection.md)、[列選択](column-selection.md)の 3 つの選択モードを提供します。デフォルトでは、 で**複数セル選択**モードのみが有効になっています。選択モードの変更または有効化は、`RowSelection`、`CellSelection` または プロパティを使用します。 @@ -75,7 +75,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ### {Platform} {ComponentTitle} 列選択 -`Selectable` プロパティを使用して、 ごとに以下のオプションを指定できます。このプロパティが true または false に設定されている場合、対応する列の選択がそれぞれ有効または無効になります。 + プロパティを使用して、 ごとに以下のオプションを指定できます。このプロパティが true または false に設定されている場合、対応する列の選択がそれぞれ有効または無効になります。 以下の 3 つのバリエーションがあります。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/size.mdx b/docs/xplat/src/content/jp/components/grids/_shared/size.mdx index c0155310f4..bff1d07cd7 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/size.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/size.mdx @@ -62,10 +62,10 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ```
-各オプションを に反映する方法を紹介します。サイズ オプション間で切り替える際に各 要素の高さとそのパディングが変更されます。カスタムの列 `Width` を適用する場合、左右のパディングより大きくする必要があることに注意してください。 -- **large** - これはデフォルトの サイズです。サイズが最も低く、行の高さが `50px` です。左と右のパディングが `24px` で最小列 `Width` は `80px` です。 -- **medium** - 中サイズで、行の高さは `40px` です。左と右のパディングが `16px` で最小列 `Width` は `64px` です。 -- **small** - 強度が最も高く、行の高さは `32px` です。左と右のパディングが `12px` で最小列 `Width` は `56px` です。 +各オプションを に反映する方法を紹介します。サイズ オプション間で切り替える際に各 要素の高さとそのパディングが変更されます。カスタムの列 を適用する場合、左右のパディングより大きくする必要があることに注意してください。 +- **large** - これはデフォルトの サイズです。サイズが最も低く、行の高さが `50px` です。左と右のパディングが `24px` で最小列 は `80px` です。 +- **medium** - 中サイズで、行の高さは `40px` です。左と右のパディングが `16px` で最小列 は `64px` です。 +- **small** - 強度が最も高く、行の高さは `32px` です。左と右のパディングが `12px` で最小列 は `56px` です。 現在サイズは**オーバーライドできません**。 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/sorting.mdx b/docs/xplat/src/content/jp/components/grids/_shared/sorting.mdx index da7f76184f..eddd2aa31b 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/sorting.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/sorting.mdx @@ -37,7 +37,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -以下のように `Sortable` 入力を使用します。 のソートで、`SortingIgnoreCase` プロパティを設定して大文字と小文字を区別するソートができます。 +以下のように 入力を使用します。 のソートで、 プロパティを設定して大文字と小文字を区別するソートができます。 ```html @@ -286,7 +286,7 @@ hierarchicalGridRef.current.sort([
-Sorting は、 アルゴリズムを使用して実行されます。 または `ISortingExpression` は、代替アルゴリズムとして `ISortingStrategy` のカスタム実装を使用できます。たとえば複雑なテンプレート列や画像列にユーザー定義のソートを定義する必要がある場合に便利です。 +Sorting は、 アルゴリズムを使用して実行されます。 または `ISortingExpression` は、代替アルゴリズムとして `ISortingStrategy` のカスタム実装を使用できます。たとえば複雑なテンプレート列や画像列にユーザー定義のソートを定義する必要がある場合に便利です。 フィルター動作と同様に、ソート状態をクリアするには `ClearSort` メソッドを使用します。 @@ -394,7 +394,7 @@ hierarchicalGridRef.current.clearSort();
- の `SortStrategy` は の `SortStrategy` と比較して異なるタイプです。異なるスコープで機能し、異なるパラメーターを公開するためです。 + と比較して異なるタイプです。異なるスコープで機能し、異なるパラメーターを公開するためです。 @@ -578,7 +578,7 @@ const sortingExpressions: IgrSortingExpression[] = [
-`string` 型の値が `DataType` `Date` の列で使用される場合、 が値を `Date` オブジェクトに解析しないため が正しく動作しません。`string` オブジェクトを使用する場合、値を `Date` オブジェクトに解析するためのロジックをアプリケーション レベルで実装する必要があります。 +`string` 型の値が `Date` の列で使用される場合、 が値を `Date` オブジェクトに解析しないため が正しく動作しません。`string` オブジェクトを使用する場合、値を `Date` オブジェクトに解析するためのロジックをアプリケーション レベルで実装する必要があります。 @@ -928,7 +928,7 @@ const sortAscendingHeaderIconTemplate = (ctx: IgrGridHeaderTemplateContext) => { ## API リファレンス
-
+
Our community is active and always welcoming to new ideas. diff --git a/docs/xplat/src/content/jp/components/grids/_shared/state-persistence.mdx b/docs/xplat/src/content/jp/components/grids/_shared/state-persistence.mdx index 3373bee611..c2ced2af3d 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/state-persistence.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/state-persistence.mdx @@ -16,11 +16,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} {ComponentTitle} 状態保持 -{Platform} {ComponentTitle} の {ProductName} 状態保持機能を使用すると、開発者はグリッドの状態を簡単に保存および復元できます。 が {Platform} に適用されると、`GetState` および `SetState` メソッドが公開され、開発者はこれを使用して、あらゆるシナリオで状態の永続化を実現できます。 +{Platform} {ComponentTitle} の {ProductName} 状態保持機能を使用すると、開発者はグリッドの状態を簡単に保存および復元できます。 が {Platform} に適用されると、 および `SetState` メソッドが公開され、開発者はこれを使用して、あらゆるシナリオで状態の永続化を実現できます。 -{Platform} {ComponentTitle} の {ProductName} 状態保持を使用すると、開発者はグリッドの状態を簡単に保存および復元できます。 が {Platform} に適用されると、`GetState`、`GetStateAsString`、`ApplyState` および `ApplyStateFromString` メソッドが公開され、開発者はこれを使用して、あらゆるシナリオで状態の永続化を実現できます。 +{Platform} {ComponentTitle} の {ProductName} 状態保持を使用すると、開発者はグリッドの状態を簡単に保存および復元できます。 が {Platform} に適用されると、 および メソッドが公開され、開発者はこれを使用して、あらゆるシナリオで状態の永続化を実現できます。 @@ -32,7 +32,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; supports saving and restoring the state of the following features: -`GridState` は、以下の機能の状態の保存および復元をサポートします。 + は、以下の機能の状態の保存および復元をサポートします。 @@ -57,25 +57,25 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -- `Sorting` -- `Filtering` +- +- - - -- `Expansion` -- - - Pivot Configuration properties defined by the interface. +- +- + - Pivot Configuration properties defined by the interface. - Pivot Dimension and Value functions are restored using application level code, see [Restoring Pivot Configuration](state-persistence.md#restoring-pivot-configuration) section. - Pivot Row and Column strategies are also restored using application level code, see [Restoring Pivot Strategies](state-persistence.md#restoring-pivot-strategies) section. -- `Sorting` -- `Filtering` +- +- - - -- `Expansion` -- - - Pivot Configuration properties defined by the interface. +- +- + - Pivot Configuration properties defined by the interface. - Pivot Dimension and Value functions are restored using application level code, see [Restoring Pivot Configuration](state-persistence.md#restoring-pivot-configuration) section. @@ -91,17 +91,17 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 使用方法 -`GetState` - このメソッドは、シリアル化された JSON 文字列でグリッド状態を返します。これは、開発者がそれを取得して任意のデータストレージ (データベース、クラウド、ブラウザーの localStorage など) に保存できます。このメソッドは最初のオプションのパラメーター `Serialize` を受け取り、`GetState` が オブジェクトを返すか、シリアル化された JSON 文字列を返すかを決定します。 + - このメソッドは、シリアル化された JSON 文字列でグリッド状態を返します。これは、開発者がそれを取得して任意のデータストレージ (データベース、クラウド、ブラウザーの localStorage など) に保存できます。このメソッドは最初のオプションのパラメーター `Serialize` を受け取り、 オブジェクトを返すか、シリアル化された JSON 文字列を返すかを決定します。 開発者は、機能名、または機能名を 2 番目の引数として持つ配列を渡すことにより、特定の機能の状態のみを取得することを選択できます。 -`GetState` メソッドは、すべての状態情報を含むグリッドの状態を オブジェクトで返します。保存するには追加の手順が必要になる場合があります。 + メソッドは、すべての状態情報を含むグリッドの状態を オブジェクトで返します。保存するには追加の手順が必要になる場合があります。 -`GetStateAsString` は、シリアル化された JSON 文字列を返します。これは、開発者がそれを取得して任意のデータストレージ (データベース、クラウド、ブラウザーの localStorage など) に保存できます。 + は、シリアル化された JSON 文字列を返します。これは、開発者がそれを取得して任意のデータストレージ (データベース、クラウド、ブラウザーの localStorage など) に保存できます。 開発者は、引数として機能名を含む配列を渡すことにより、特定の機能の状態のみを取得することを選択できます。空の配列では、デフォルトの状態オプションが使用されます。 @@ -161,7 +161,7 @@ const sortingFilteringStates: IgcGridStateInfo = gridState.getState(['sorting', ```tsx -// get an `IgrGridStateInfo` object, containing all features original state objects, as returned by the grid public API +// get an `GridStateInfo` object, containing all features original state objects, as returned by the grid public API const state: IgrGridStateInfo = gridStateRef.current.getState([]); // get all features` state in a serialized JSON string @@ -222,7 +222,7 @@ const sortingFilteringStates: IgcGridStateInfo = gridState.getState(['sorting', ```tsx -// get an `IgrGridStateInfo` object, containing all features original state objects, as returned by the grid public API +// get an `GridStateInfo` object, containing all features original state objects, as returned by the grid public API const state: IgrGridStateInfo = gridStateRef.current.getState([]); // get all features` state in a serialized JSON string @@ -250,11 +250,11 @@ const sortingFilteringStates: IgrGridStateInfo = gridStateRef.current.getState([ -`ApplyState` - このメソッドは引数として `GridStateInfo` オブジェクトを受け取り、オブジェクト内で見つかった各フィーチャまたは 2 番目の引数として指定されたフィーチャの状態を復元します。 + - このメソッドは引数として オブジェクトを受け取り、オブジェクト内で見つかった各フィーチャまたは 2 番目の引数として指定されたフィーチャの状態を復元します。 -`ApplyStateFromString` - このメソッドはシリアル化された JSON 文字列を引数として受け取り、JSON 文字列内で見つかった各機能の状態、または 2 番目の引数として指定された機能を復元します。 + - このメソッドはシリアル化された JSON 文字列を引数として受け取り、JSON 文字列内で見つかった各機能の状態、または 2 番目の引数として指定された機能を復元します。 @@ -297,7 +297,7 @@ gridState.ApplyStateFromStringAsync(sortingFilteringStates, new string[0]) ``` -`Options` オブジェクトは、`IGridStateOptions` インターフェースを実装します。特定の機能の名前であるキーには、この機能の状態を追跡するかどうかを示すブール値があります。`GetState` メソッドはこれらの機能の状態を戻り値に入れず、`SetState` メソッドはその状態を復元しません。 + オブジェクトは、`IGridStateOptions` インターフェースを実装します。特定の機能の名前であるキーには、この機能の状態を追跡するかどうかを示すブール値があります。 メソッドはこれらの機能の状態を戻り値に入れず、`SetState` メソッドはその状態を復元しません。 ```typescript @@ -372,7 +372,7 @@ gridState.options = { cellSelection: false, sorting: false }; will not persist columns templates, column formatters, etc. by default (see [limitations](state-persistence.md#limitations)). Restoring any of these can be achieved with code on application level. Let's show how to do this for templated columns: -`GridState` はデフォルトで列テンプレート、列フォーマッタなどを保持しません ([制限](state-persistence.md#制限)を参照)。これらの復元は、アプリケーション レベルのコードで実現できます。テンプレート化された列でこれを行う方法を示します。 + はデフォルトで列テンプレート、列フォーマッタなどを保持しません ([制限](state-persistence.md#制限)を参照)。これらの復元は、アプリケーション レベルのコードで実現できます。テンプレート化された列でこれを行う方法を示します。 ```html @@ -554,7 +554,7 @@ public activeTemplate = (ctx: IgcCellTemplateContext) => { -2 - Query the template view in the component using @ViewChild or @ViewChildren decorator. In the `ColumnInit` event handler, assign the template to the column `BodyTemplate` property: +2 - Query the template view in the component using @ViewChild or @ViewChildren decorator. In the `ColumnInit` event handler, assign the template to the column property: ```typescript @ViewChild('activeTemplate', { static: true }) public activeTemplate: TemplateRef; @@ -567,7 +567,7 @@ public onColumnInit(column: IgxColumnComponent) { -2 - In the `ColumnInit` event handler, assign the template to the column `BodyTemplate` property: +2 - In the `ColumnInit` event handler, assign the template to the column property: @@ -613,7 +613,7 @@ public void OnColumnInit(IgbColumnComponentEventArgs args) will not persist pivot dimension functions, value formatters, etc. by default (see [limitations](state-persistence.md#limitations)). Restoring any of these can be achieved with code on application level. The exposes two events which can be used to set back any custom functions you have in the configuration: `DimensionInit` and `ValueInit`. Let's show how to do this: -`GridState` は、デフォルトではピボット ディメンション関数、値フォーマッタなどを保持しません ([制限](state-persistence.md#制限)を参照)。これらの復元は、アプリケーション レベルのコードで実現できます。`{ComponentName}` は、構成に含まれるカスタム関数を戻すために使用できる 2 つのイベント (`DimensionInit` と `ValueInit`) を公開します。以下はその方法です。 + は、デフォルトではピボット ディメンション関数、値フォーマッタなどを保持しません ([制限](state-persistence.md#制限)を参照)。これらの復元は、アプリケーション レベルのコードで実現できます。`{ComponentName}` は、構成に含まれるカスタム関数を戻すために使用できる 2 つのイベント (`DimensionInit` と `ValueInit`) を公開します。以下はその方法です。 ```html @@ -669,7 +669,7 @@ public void OnColumnInit(IgbColumnComponentEventArgs args) - `DimensionInit` および `ValueInit` イベントのイベント ハンドラーを割り当てます。 -> `DimensionInit` および `ValueInit` イベントは、`PivotConfiguration` プロパティで定義された値とディメンションごとに発行されます。 +> `DimensionInit` および `ValueInit` イベントは、 プロパティで定義された値とディメンションごとに発行されます。 ```typescript @@ -857,7 +857,7 @@ public onDimensionInit(event: any) { ## 子グリッドの復元 -子グリッドの状態の保存/復元は、`RowIslands` プロパティによって制御され、デフォルトで有効に設定されています。 は、ルート グリッドと階層のすべての子グリッドの両方の機能を保存/復元するために同じオプションを使用します。たとえば、以下のオプションを渡す場合: +子グリッドの状態の保存/復元は、 プロパティによって制御され、デフォルトで有効に設定されています。 は、ルート グリッドと階層のすべての子グリッドの両方の機能を保存/復元するために同じオプションを使用します。たとえば、以下のオプションを渡す場合: ``` html @@ -905,7 +905,7 @@ gridState.options = { cellSelection: false, sorting: false, rowIslands: true }; -`GetState` API は、`Selection` と `Sorting` を除くすべてのグリッド (ルート グリッドと子グリッド) 機能の状態を返します。開発者が後ですべてのグリッドの `Filtering` 状態のみを復元するには、以下を使用します。 + API は、`Selection` と を除くすべてのグリッド (ルート グリッドと子グリッド) 機能の状態を返します。開発者が後ですべてのグリッドの 状態のみを復元するには、以下を使用します。 ```typescript @@ -920,7 +920,7 @@ state.applyState(state, ['filtering', 'rowIslands']); -Then the API will return the state for all grids (root grid and child grids) features excluding `Selection` and `Sorting`. If later on the developer wants to restore only the `Filtering` state for all grids, use: +Then the API will return the state for all grids (root grid and child grids) features excluding `Selection` and . If later on the developer wants to restore only the state for all grids, use: ```razor gridState.ApplyStateFromStringAsync(gridStateString, new string[] { "filtering", "rowIslands" }); @@ -1055,9 +1055,9 @@ Add snippet for blazor for restore state ## ピボット ストラテジの復元 -`GridState` は、リモート ピボット操作もカスタム ディメンション ストラテジも保持しません。 + は、リモート ピボット操作もカスタム ディメンション ストラテジも保持しません。 -これらの復元は、アプリケーション レベルのコードで実現できます。`GridState` は、`StateParsed` と呼ばれるイベントを公開します。このイベントはグリッド状態が適用される前に追加で変更するために使用できます。以下はその方法です。 +これらの復元は、アプリケーション レベルのコードで実現できます。 は、`StateParsed` と呼ばれるイベントを公開します。このイベントはグリッド状態が適用される前に追加で変更するために使用できます。以下はその方法です。 ```html -- method uses JSON.stringify() method to convert the original objects to a JSON string. JSON.stringify() does not support Functions, thats why the directive will ignore the columns `Formatter`, `Filters`, `Summaries`, , , `CellStyles`, `HeaderTemplate` and `BodyTemplate` properties. +- method uses JSON.stringify() method to convert the original objects to a JSON string. JSON.stringify() does not support Functions, thats why the directive will ignore the columns , , , , , , and properties. -- method uses JSON.stringify() method to convert the original objects to a JSON string. JSON.stringify() does not support Functions, thats why the component will ignore the columns `Formatter`, `Filters`, `Summaries`, , , `CellStyles`, `HeaderTemplate` and `BodyTemplate` properties. +- method uses JSON.stringify() method to convert the original objects to a JSON string. JSON.stringify() does not support Functions, thats why the component will ignore the columns , , , , , , and properties. -- method uses JSON.stringify() method to convert the original objects to a JSON string. JSON.stringify() does not support Functions, thats why the component will ignore the columns `Formatter`, `Filters`, `Summaries`, , , `CellStyles`, `HeaderTemplate` and `BodyTemplate` properties. +- method uses JSON.stringify() method to convert the original objects to a JSON string. JSON.stringify() does not support Functions, thats why the component will ignore the columns , , , , , , and properties. @@ -1092,9 +1092,9 @@ Add snippet for blazor for restore state

-
-
-
+
+
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/grids/_shared/summaries.mdx b/docs/xplat/src/content/jp/components/grids/_shared/summaries.mdx index 800a93ed40..3bcab2a6d9 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/summaries.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/summaries.mdx @@ -30,7 +30,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; `{ComponentName}` 集計を列ごとに有効にして必要な列のみアクティブ化できます。`{ComponentName}` 集計は、列のデータ型に基づいてデフォルト集計の定義済みセットを提供します。 -`string` および `boolean` `DataType`の場合、以下の関数が利用できます: +`string` および `boolean` の場合、以下の関数が利用できます: - Count `number`、`currency`、および `percent` データ型の場合、以下の関数を使用できます。 @@ -46,7 +46,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - Earliest - Latest - summaries are enabled per-column by setting property to **true**. It is also important to keep in mind that the summaries for each column are resolved according to the column data type. In the the default column data type is `string`, so if you want `number` or `date` specific summaries you should specify the property as `number` or `date`. Note that the summary values will be displayed localized, according to the grid `Locale` and column . + summaries are enabled per-column by setting property to **true**. It is also important to keep in mind that the summaries for each column are resolved according to the column data type. In the the default column data type is `string`, so if you want `number` or `date` specific summaries you should specify the property as `number` or `date`. Note that the summary values will be displayed localized, according to the grid and column . @@ -506,7 +506,7 @@ const disableSummary = () => { これらの機能が要件を満たさない場合は、カスタム集計を提供できます。 -In order to achieve this you have to override one of the base classes , or according to the column data type and your needs. This way you can redefine the existing function or you can add new functions. class provides the default implementation only for the `Count` method. extends and provides implementation for the `Min`, `Max`, `Sum` and `Average`. extends and additionally gives you `Earliest` and `Latest`. +In order to achieve this you have to override one of the base classes , or according to the column data type and your needs. This way you can redefine the existing function or you can add new functions. class provides the default implementation only for the method. extends and provides implementation for the , , and . extends and additionally gives you and . @@ -630,9 +630,9 @@ class PtoSummary { -これを実現するには、列のデータ型とニーズに応じて、基本クラス `SummaryOperand`、`NumberSummaryOperand`、または `DateSummaryOperand` のいずれかをオーバーライドする必要があります。このように既存の関数を再定義、または新しい関数を追加できます。`SummaryOperand` クラスは、`Count` メソッドに対してのみデフォルトの実装を提供します。`NumberSummaryOperand` は `SummaryOperand` を拡張し、`Min`、`Max`、`Sum`、および `Average` の実装を提供します。`DateSummaryOperand` は `SummaryOperand` を拡張し、さらに特定の列の `Earliest` と `Latest` を提供します。 +これを実現するには、列のデータ型とニーズに応じて、基本クラス 、または のいずれかをオーバーライドする必要があります。このように既存の関数を再定義、または新しい関数を追加できます。 クラスは、 メソッドに対してのみデフォルトの実装を提供します。 を拡張し、、および の実装を提供します。 を拡張し、さらに特定の列の を提供します。 -例で見られるように、基本クラスは `Operate` メソッドを公開しているため、すべてのデフォルトの集計を取得して結果を変更するか、まったく新しい集計結果を計算するかを選択できます。 +例で見られるように、基本クラスは メソッドを公開しているため、すべてのデフォルトの集計を取得して結果を変更するか、まったく新しい集計結果を計算するかを選択できます。 ```typescript @@ -654,7 +654,7 @@ interface IgcSummaryResult { ``` -このメソッドは `SummaryResult` のリストを返します。 +このメソッドは のリストを返します。 そして、集計を計算するためのオプションのパラメーターを受け取ります。 以下の[すべてのデータにアクセスするカスタム集計](#すべてのデータにアクセスするカスタム集計)セクションを参照してください。 @@ -795,7 +795,7 @@ igRegisterScript("WebHierarchicalGridCustomSummary", (event) => {
-And now let's add our custom summary to the column `Title`. We will achieve that by setting the Summaries` property to the class we create below. +And now let's add our custom summary to the column . We will achieve that by setting the Summaries` property to the class we create below. ```html <{ComponentSelector} #treeGrid [data]="data" [autoGenerate]="false" height="800px" width="800px"> @@ -855,7 +855,7 @@ igRegisterScript("WebTreeGridCustomSummary", (event) => { ### すべてのデータにアクセスするカスタム集計 -カスタム列集計内のすべての {ComponentTitle} データにアクセスできます。SummaryOperand `SummaryOperand` `Operate` メソッドには、2 つの追加のオプション パラメーターが導入されています。 +カスタム列集計内のすべての {ComponentTitle} データにアクセスできます。SummaryOperand メソッドには、2 つの追加のオプション パラメーターが導入されています。 以下のコード スニペットで示されるように operate メソッドには以下の 3 つのパラメーターがあります。 - columnData - 現在の列の値のみを含む配列を提供します。 - allGridData - グリッド データソース全体を提供します。 @@ -1046,10 +1046,10 @@ igRegisterScript("SummaryTemplate", (ctx) => { ```
-`SummaryTemplate` は、列の集計の結果をコンテキストとして提供する列の集計を対象としています。 + は、列の集計の結果をコンテキストとして提供する列の集計を対象としています。 -デフォルトの集計が定義されている場合、集計領域の高さは、集計の数が最も多い列とグリッドの `--ig-size` に応じてデザインにより計算されます。`SummaryRowHeight` 入力プロパティを使用して、デフォルト値をオーバーライドします。引数として数値が必要であり、falsy の値を設定すると、グリッド フッターのデフォルトのサイズ設定動作がトリガーされます。 +デフォルトの集計が定義されている場合、集計領域の高さは、集計の数が最も多い列とグリッドの `--ig-size` に応じてデザインにより計算されます。 入力プロパティを使用して、デフォルト値をオーバーライドします。引数として数値が必要であり、falsy の値を設定すると、グリッド フッターのデフォルトのサイズ設定動作がトリガーされます。 @@ -1179,7 +1179,7 @@ igRegisterScript("SummaryTemplate", (ctx) => { ## 集計のフォーマット -デフォルトでは、組み込みの集計オペランドによって生成される集計結果は、グリッド `Locale` および列 `PipeArgs` に従ってローカライズおよびフォーマットされます。カスタム オペランドを使用する場合、`Locale` と `PipeArgs` は適用されません。集計結果のデフォルトの外観を変更する場合は、 プロパティを使用してフォーマットできます。 +デフォルトでは、組み込みの集計オペランドによって生成される集計結果は、グリッド および列 に従ってローカライズおよびフォーマットされます。カスタム オペランドを使用する場合、 は適用されません。集計結果のデフォルトの外観を変更する場合は、 プロパティを使用してフォーマットできます。 ```typescript public dateSummaryFormat(summary: IgxSummaryResult, summaryOperand: IgxSummaryOperand): string { @@ -1261,14 +1261,14 @@ const summaryFormatter = (summary: IgrSummaryResult, summaryOperand: IgrSummaryO 以下は使用できる プロパティの値です: -- - ルート レベルのみ集計が計算されます。 -- - 子レベルのみ集計が計算されます。 -- - ルートと子レベルの両方の集計が計算されます。これがデフォルト値です。 +- - ルート レベルのみ集計が計算されます。 +- - 子レベルのみ集計が計算されます。 +- - ルートと子レベルの両方の集計が計算されます。これがデフォルト値です。 以下は使用できる プロパティの値です。 -- - 集計行はグループ列の子の前に表示されます。 -- - 集計行はグループ列の子の後に表示されます。これがデフォルト値です。 +- - 集計行はグループ列の子の前に表示されます。 +- - 集計行はグループ列の子の後に表示されます。これがデフォルト値です。 プロパティはブール値です。デフォルト値は **false** に設定されています。これは、親行が縮小されたときに集計行が非表示になることを意味します。プロパティが **true** に設定されている場合、グループ行が縮小されたときに、集計行は表示されたままになります。 @@ -1289,14 +1289,14 @@ const summaryFormatter = (summary: IgrSummaryResult, summaryOperand: IgrSummaryO 以下は使用できる プロパティの値です: -- - ルート レベルのノードのみ集計が計算されます。 -- - 子レベルのみ集計が計算されます。 -- - ルートと子レベルの両方の集計が計算されます。これがデフォルト値です。 +- - ルート レベルのノードのみ集計が計算されます。 +- - 子レベルのみ集計が計算されます。 +- - ルートと子レベルの両方の集計が計算されます。これがデフォルト値です。 以下は使用できる プロパティの値です。 -- - 集計行は子行のリストの前に表示されます。 -- - 集計行は子行のリストの後に表示されます。これがデフォルト値です。 +- - 集計行は子行のリストの前に表示されます。 +- - 集計行は子行のリストの後に表示されます。これがデフォルト値です。 プロパティはブール値です。デフォルト値は **false** に設定されています。これは、親行が縮小されたときに集計行が非表示になることを意味します。プロパティが **true** に設定されている場合、親行が縮小されたときに、集計行は表示されたままになります。 @@ -1520,9 +1520,9 @@ Don't forget to include the themes in the same way as it was demonstrated above.

-
-
-
+
+
+
## スタイル設定 diff --git a/docs/xplat/src/content/jp/components/grids/_shared/toolbar.mdx b/docs/xplat/src/content/jp/components/grids/_shared/toolbar.mdx index a10daa009c..79b5ef8a1d 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/toolbar.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/toolbar.mdx @@ -264,7 +264,7 @@ The predefined and -As seen in the code snippet above, the predefined `Actions` UI components are wrapped in the container. This way, the toolbar title is aligned to the left of the toolbar and the actions are aligned to the right of the toolbar. +As seen in the code snippet above, the predefined UI components are wrapped in the container. This way, the toolbar title is aligned to the left of the toolbar and the actions are aligned to the right of the toolbar. Of course, each of these UIs can be added independently of each other, or may not be added at all. This way the toolbar container will be rendered empty: @@ -512,10 +512,10 @@ const rowIslandToolbarTemplate = (ctx: IgrGridToolbarTemplateContext) => { ## {Platform} Toolbar Grid Example -事前定義された `GridToolbarActions` および `GridToolbarTitle` UI コンポーネントが `GridToolbar` 内に追加されます。これはすべて、対応するグリッド機能とのデフォルトのインタラクションを提供するツールバーを持つために必要です。 +事前定義された および UI コンポーネントが 内に追加されます。これはすべて、対応するグリッド機能とのデフォルトのインタラクションを提供するツールバーを持つために必要です。 -上記のコード スニペットに示されているように、事前定義された `Actions` UI コンポーネントは `GridToolbarActions` にラップされています。このように、ツールバーのタイトルはツールバーの左側に配置され、アクションはツールバーの右側に配置されます。 +上記のコード スニペットに示されているように、事前定義された UI コンポーネントは にラップされています。このように、ツールバーのタイトルはツールバーの左側に配置され、アクションはツールバーの右側に配置されます。 これらの UI はそれぞれ独立して追加することも、まったく追加しないこともできます。このようにして、ツールバー コンテナは空になります。 @@ -699,7 +699,7 @@ constructor() { ### Title (タイトル) -グリッドのツールバーのタイトルを設定するには、`GridToolbarTitle` を使用します。 +グリッドのツールバーのタイトルを設定するには、 を使用します。 ユーザーは、単純なテキストからより複雑なテンプレートまで、どんなものでも提供できます。 @@ -762,7 +762,7 @@ constructor() { ### 操作 -`GridToolbarActions` は、ユーザーが親グリッドに関連して操作 / インタラクションを配置できる特定のコンテナを公開します。 + は、ユーザーが親グリッドに関連して操作 / インタラクションを配置できる特定のコンテナを公開します。 ツールバーのタイトル部分と同様に、ユーザーは、デフォルトのツールバー インタラクション コンポーネントを含め、そのテンプレート部分内にどんなものでも提供できます。 @@ -824,7 +824,7 @@ constructor() { ### 列のピン固定 -`GridToolbarPinning` は、グリッド内の列のピン固定を操作するためのデフォルトの UI を提供します。 + は、グリッド内の列のピン固定を操作するためのデフォルトの UI を提供します。 @@ -877,7 +877,7 @@ constructor() { ### 列の非表示 -`GridToolbarHiding` は、列非表示を操作するためのデフォルトの UI を提供します。コンポーネントのタイトル、コンポーネント入力のプレースホルダー、ドロップダウン自体の高さなど、UI をカスタマイズするための同じ入力プロパティを公開します。 + は、列非表示を操作するためのデフォルトの UI を提供します。コンポーネントのタイトル、コンポーネント入力のプレースホルダー、ドロップダウン自体の高さなど、UI をカスタマイズするための同じ入力プロパティを公開します。 @@ -1209,7 +1209,7 @@ The following sample demonstrates how to customize the exported files: ツールバーの高度なフィルタリング コンポーネントは、高度なフィルタリング機能のデフォルトの UI を提供します。コンポーネントは、ボタンのデフォルトのテキストを変更する方法を公開します。 -Moreover, users can set the toolbar `ShowProgress` property and use for their own long running operations or just as another way to signify an action taking place in the grid. +Moreover, users can set the toolbar property and use for their own long running operations or just as another way to signify an action taking place in the grid. The sample belows uses has significant amount of data, in order to increase the time needed for data export so the progressbar can be seen. Additionally it has another button that simulates a long running operation in the grid: @@ -1229,7 +1229,7 @@ This replaces the old toolbar template directive. If you are migrating from a ve `{ComponentName}` または階層下の子グリッドのいずれかをエクスポートすると、エクスポートされるデータは、それぞれのグリッドに属する行のフラット コレクションになります (子グリッドはエクスポートされたデータに含まれません)。 -残りのツールバー操作と同様に、エクスポートは、すぐに使用できる `GridToolbarExporter` を介して提供されます。 +残りのツールバー操作と同様に、エクスポートは、すぐに使用できる を介して提供されます。 @@ -1339,7 +1339,7 @@ This replaces the old toolbar template directive. If you are migrating from a ve ``` -さらに、ユーザーはツールバーの `ShowProgress` プロパティを設定して、自分の長時間実行操作に使用するか、グリッドで実行されている操作を示す別の方法として使用できます。 +さらに、ユーザーはツールバーの プロパティを設定して、自分の長時間実行操作に使用するか、グリッドで実行されている操作を示す別の方法として使用できます。 ```css .grid { diff --git a/docs/xplat/src/content/jp/components/grids/_shared/validation.mdx b/docs/xplat/src/content/jp/components/grids/_shared/validation.mdx index ecf92ee6e6..64a8e75d64 100644 --- a/docs/xplat/src/content/jp/components/grids/_shared/validation.mdx +++ b/docs/xplat/src/content/jp/components/grids/_shared/validation.mdx @@ -20,7 +20,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ### テンプレート駆動で構成する -{Platform} Forms 検証は、`Column` で直接動作するよう拡張されています。同じ検証が `Column` で宣言的に設定される属性として利用できます。以下の検証は追加設定なしでサポートされます。 +{Platform} Forms 検証は、 で直接動作するよう拡張されています。同じ検証が で宣言的に設定される属性として利用できます。以下の検証は追加設定なしでサポートされます。 - Required - Min @@ -51,7 +51,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ### リアクティブ フォームで構成する -`formGroupCreated` イベントを介して行/セルで編集を開始するときに検証に使用する を公開します。関連するフィールドに独自の検証を追加して変更できます。 +`formGroupCreated` イベントを介して行/セルで編集を開始するときに検証に使用する を公開します。関連するフィールドに独自の検証を追加して変更できます。 ```html @@ -117,7 +117,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; 検証は以下のシナリオでトリガーされます。 -- グリッドの に基づくセルエディターでの編集中。エディター入力中の変更時 (`Change`)、またはエディターがフォーカスを失うか (`Blur`) 閉じた場合。 +- グリッドの に基づくセルエディターでの編集中。エディター入力中の変更時 (`Change`)、またはエディターがフォーカスを失うか (`Blur`) 閉じた場合。 - `UpdateRow`、`UpdateCell` などの API を使用してセル / 行を更新する場合 。 - トランザクション サービスの一括編集および `Undo`/`Redo` API を使用する場合。 @@ -130,7 +130,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ### カスタム検証を設定する -テンプレート内の `Column` で使用する独自の検証ディレクティブを定義することができます。 +テンプレート内の で使用する独自の検証ディレクティブを定義することができます。 ```ts @Directive({ @@ -196,7 +196,7 @@ export class PhoneFormatDirective extends Validators { 場合によっては、1 つのフィールドの検証がレコード内の別のフィールドの値に依存することがあります。 -その場合、カスタム検証を使用して共有 を介してレコード内の値を比較できます。 +その場合、カスタム検証を使用して共有 を介してレコード内の値を比較できます。 The below sample demonstrates a cross-field validation between different field of the same record. It checks the dates validity compared to the current date and between the active and created on date of the record as well as the deals won/lost ration for each employee. All errors are collected in a separate pinned column that shows that the record is invalid and displays the related errors. @@ -251,7 +251,7 @@ public calculateDealsRatio(dealsWon, dealsLost) { ``` -The cross-field validator can be added to the of the row from `FormGroupCreated` event, which returns the new for each row when entering edit mode: +The cross-field validator can be added to the of the row from `FormGroupCreated` event, which returns the new for each row when entering edit mode: ```html @@ -451,7 +451,7 @@ private rowValidator(): ValidatorFn { } ``` -The cross-field validator can be added to the of the row from `FormGroupCreated` event, which returns the new for each row when entering edit mode: +The cross-field validator can be added to the of the row from `FormGroupCreated` event, which returns the new for each row when entering edit mode: ```html は、ビューポートに表示されているデータのみを描画し、ユーザーがスクロール時に表示データを切り替えた際に、DOM 描画およびメモリ使用を最適化します。 の `Width` および `Height` のデフォルト値は `100%` です。コンテンツが利用可能なスペースにフィットせず、垂直方向または水平方向にスクロールバーが必要な場合に仮想化が有効になります。 + は、ビューポートに表示されているデータのみを描画し、ユーザーがスクロール時に表示データを切り替えた際に、DOM 描画およびメモリ使用を最適化します。 および `Height` のデフォルト値は `100%` です。コンテンツが利用可能なスペースにフィットせず、垂直方向または水平方向にスクロールバーが必要な場合に仮想化が有効になります。 -ただし、 の `Width` または `Height` を明示的に `null` 値に設定できます。つまり、関連するディメンションが項目の合計サイズに基づいて決定されます。スクロールバーが表示されず、すべての項目が相対するディメンション (`Width` が `null` 値の場合は列で、`Height` が `null` 値の場合は行) に描画されます。 +ただし、 または `Height` を明示的に `null` 値に設定できます。つまり、関連するディメンションが項目の合計サイズに基づいて決定されます。スクロールバーが表示されず、すべての項目が相対するディメンション ( が `null` 値の場合は列で、`Height` が `null` 値の場合は行) に描画されます。 データのサイズは以下によって決定されます。 - 垂直 (行) 仮想化の行の高さ。`RowHeight` オプションで決定されますがデフォルトは 50(px) です。 -- 水平 (列) 仮想化の列幅 (ピクセル単位)。各列コンポーネントで明示的に幅を設定、または明示的に幅が設定されないすべての列に適用する の `ColumnWidth` オプションを設定できます。 +- 水平 (列) 仮想化の列幅 (ピクセル単位)。各列コンポーネントで明示的に幅を設定、または明示的に幅が設定されないすべての列に適用する オプションを設定できます。 ディメンションを設定せずにグリッドでデフォルト動作を適用する場合、ほとんどの場合は望ましいレイアウトになります。列幅は列カウント、幅が設定された列、および コンテナの計算幅に基づいて決定されます。グリッドは、割り当てる幅が 136px 未満になる以外はすべての列を利用可能なスペースに合わせようとします。その場合、割り当てられない幅を持つ列は 136px の最小幅に設定され、水平方向スクロールバーが表示されます。グリッドは水平方向に仮想化されます。 @@ -54,7 +54,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; グリッド内の既存テンプレートをカスタマイズする場合、Blazor では次の 2 つの方法でテンプレートを定義できます。 -- サーバー側テンプレート: 関連するコンポーネント プロパティ (例: `BodyTemplate` プロパティ) を使用、またはテンプレート名を宣言的に指定。例: +- サーバー側テンプレート: 関連するコンポーネント プロパティ (例: プロパティ) を使用、またはテンプレート名を宣言的に指定。例: ```razor diff --git a/docs/xplat/src/content/jp/components/grids/data-grid.mdx b/docs/xplat/src/content/jp/components/grids/data-grid.mdx index 0dc752b6e0..5b8398d79d 100644 --- a/docs/xplat/src/content/jp/components/grids/data-grid.mdx +++ b/docs/xplat/src/content/jp/components/grids/data-grid.mdx @@ -383,7 +383,7 @@ constructor() { グリッドの各列は別のテンプレートを持つことができます。列に `ng-template` Angular グリッド モジュール ディレクティブが必要です。 -また、カスタム プロパティや列自体に渡す任意のタイプのデータ コンテキストに使用できる `AdditionalTemplateContext` 入力も公開します。 +また、カスタム プロパティや列自体に渡す任意のタイプのデータ コンテキストに使用できる 入力も公開します。 ```html @@ -576,7 +576,7 @@ function nameCellTemplate(ctx: IgrCellTemplateContext) { -上記のスニペットで暗示的に提供されたセル値への参照を取得します。データを表示し、セルの値にカスタム スタイル設定およびパイプ変換を適用する場合に使用します。ただし、`Cell` インスタンスを以下のように使用するとより効果的です。 +上記のスニペットで暗示的に提供されたセル値への参照を取得します。データを表示し、セルの値にカスタム スタイル設定およびパイプ変換を適用する場合に使用します。ただし、 インスタンスを以下のように使用するとより効果的です。 @@ -755,7 +755,7 @@ function formatTitleCase(value) { -適切に実装されると、セル編集テンプレートは、セルの `EditValue` がグリッド[編集イベント サイクル](grid/editing.md#イベントの引数とシーケンス)を正しく渡します。 +適切に実装されると、セル編集テンプレートは、セルの がグリッド[編集イベント サイクル](grid/editing.md#イベントの引数とシーケンス)を正しく渡します。 ### セル編集テンプレート @@ -855,7 +855,7 @@ function updateValue(event, value) { -テンプレートで使用可能なプロパティの詳細については、 の API を参照してください。 +テンプレートで使用可能なプロパティの詳細については、 の API を参照してください。 ### 列テンプレート API @@ -1075,9 +1075,9 @@ function initColumns(event: CustomEvent) { 書式設定のためのオプションのパラメーターがあります: -- `Format` - 表示される日付 / 時間部分を決定します。デフォルト `'mediumDate'` です (**'MMM d, y'**)。 -- `Timezone` - 日付のタイムゾーン オフセット。デフォルトでは、エンドユーザーのローカル システムのタイムゾーンを使用します。 -- `DigitsInfo` - 10 進表現オブジェクト。デフォルトの設定は **1.0-3** です。 +- - 表示される日付 / 時間部分を決定します。デフォルト `'mediumDate'` です (**'MMM d, y'**)。 +- - 日付のタイムゾーン オフセット。デフォルトでは、エンドユーザーのローカル システムのタイムゾーンを使用します。 +- - 10 進表現オブジェクト。デフォルトの設定は **1.0-3** です。 これらのパラメーターによって表示形式をカスタマイズできるようにするには、 入力公開します。 が設定されている場合、列はそのデータ型の対応するプロパティのみに遵守します。例: @@ -1164,7 +1164,7 @@ const columnPipeArgs: IgrColumnPipeArgs = {
-`OrderDate` 列は `Format` および `Timezone` プロパティのみに遵守しますが、`UnitPrice` は `DigitsInfo` のみに遵守します。 +`OrderDate` 列は および プロパティのみに遵守しますが、`UnitPrice` は のみに遵守します。 すべての利用可能な列データ型は、公式の[列タイプ トピック](grid/column-types.md#デフォルトのテンプレート)にあります。 @@ -1205,7 +1205,7 @@ const POJO = [{ >**警告**: >**キー値に配列を含まないでください。** ->`AutoGenerate` 列を使用する場合、**データ キーが同一である必要があります**。 +> 列を使用する場合、**データ キーが同一である必要があります**。
@@ -1488,7 +1488,7 @@ public class AminoWeight つまり、追加の構成を行わなくても、すべてのソートおよびフィルタリング操作がそのまま使用できます。トランザクションの有無に関係なく、グループ化と編集の操作、およびバインドされた列のセルをテンプレート化する機能についても同様です。 >**警告**: ->グリッドは、`PrimaryKey`、`ForeignKey`、および `ChildKey` プロパティのこの種のバインディングをサポート**していません**。 +>グリッドは、、`ForeignKey`、および `ChildKey` プロパティのこの種のバインディングをサポート**していません**。 @@ -1931,7 +1931,7 @@ igRegisterScript("WebGridNestedDataCellTemplate", (ctx) => { ### フラット データの操作の概要 -フラット データ バインディングのアプローチは既に説明したものと似ていますが、**セル値**の代わりに、`GridRow` の プロパティを使用します。 +フラット データ バインディングのアプローチは既に説明したものと似ていますが、**セル値**の代わりに、 プロパティを使用します。 {Platform} グリッドはデータ レコードを**レンダリング**、**操作**、**保存する**ためのコンポーネントのため、**すべてのデータ レコード**へアクセスすることで、それを処理する方法をカスタマイズすることができます。それには、`data` プロパティを使用します。 @@ -2336,7 +2336,7 @@ igRegisterScript("AddressEditCellTemplate", (ctx) => { ## パフォーマンス (試験中) -`Grid` のデザインでは、Angular で導入されたイベント結合機能を利用できます。この機能は、インタラクションとレスポンシブの点で **20%** のパフォーマンスを向上します。この機能は、`bootstrapModule` メソッドで `ngZoneEventCoalescing` と `ngZoneRunCoalescing` プロパティを **true** に設定するだけでアプリケーション レベルで有効にできます。 + のデザインでは、Angular で導入されたイベント結合機能を利用できます。この機能は、インタラクションとレスポンシブの点で **20%** のパフォーマンスを向上します。この機能は、`bootstrapModule` メソッドで `ngZoneEventCoalescing` と `ngZoneRunCoalescing` プロパティを **true** に設定するだけでアプリケーション レベルで有効にできます。 ```typescript platformBrowserDynamic() @@ -2424,14 +2424,14 @@ platformBrowserDynamic()

-
+


-
-
-
-
+
+
+
+
## テーマの依存関係 @@ -2450,7 +2450,7 @@ platformBrowserDynamic() ## チュートリアル ビデオ -{Platform} `Grid` の作成について詳しくは、このビデオ チュートリアルをご覧ください: +{Platform} の作成について詳しくは、このビデオ チュートリアルをご覧ください: diff --git a/docs/xplat/src/content/jp/components/grids/grid/groupby.mdx b/docs/xplat/src/content/jp/components/grids/grid/groupby.mdx index c2de4e3a2e..f1e0043064 100644 --- a/docs/xplat/src/content/jp/components/grids/grid/groupby.mdx +++ b/docs/xplat/src/content/jp/components/grids/grid/groupby.mdx @@ -237,9 +237,9 @@ gridRef.current.groupBy([{ fieldName: 'ProductName', dir: SortingDirection.Desc, ### 展開 / 縮小 API -グループ式の他にグループ行の展開も制御できます。これらは、 のコレクションである、 コンポーネントの別のプロパティ に保存されます。各展開状態は、作成されたフィールド名とグループ化の各レベルで表す値によって一意に定義されます。つまり、識別子は の階層配列です。 +グループ式の他にグループ行の展開も制御できます。これらは、 のコレクションである、 コンポーネントの別のプロパティ に保存されます。各展開状態は、作成されたフィールド名とグループ化の各レベルで表す値によって一意に定義されます。つまり、識別子は の階層配列です。 - で `IGroupByExpandState` のリストを直接 に設定すると展開が変更されます。また、 は、グループ レコード インスタンスまたは行の プロパティによってグループを切り替えるメソッド を公開します。 + で `IGroupByExpandState` のリストを直接 に設定すると展開が変更されます。また、 は、グループ レコード インスタンスまたは行の プロパティによってグループを切り替えるメソッド を公開します。 @@ -364,7 +364,7 @@ this.grid.DeselectRowsInGroup(row.GroupRow); ### グループ行テンプレート -展開/縮小 UI を除くグループ行は完全にテンプレート化可能です。デフォルトでグループ アイコンを描画し、フィールド名と値を表示します。テンプレートを描画するコンテキストのタイプは です。 +展開/縮小 UI を除くグループ行は完全にテンプレート化可能です。デフォルトでグループ アイコンを描画し、フィールド名と値を表示します。テンプレートを描画するコンテキストのタイプは です。 たとえば、以下のテンプレートはグループ行集計でより詳細な情報を表示します。 @@ -418,9 +418,9 @@ igRegisterScript("WebGridGroupByRowTemplate", (ctx) => { ### グループ行セレクター テンプレート -上記のように、展開/縮小 UI を除くグループ行は完全にテンプレート化可能です。カスタムの GroupBy 行セレクター テンプレートを作成するには、`GroupByRowSelectorTemplate` ディレクティブを使用します。テンプレートから、Group By 行の状態に関する情報を提供するプロパティを使用して、暗黙的に提供されたコンテキスト変数にアクセスできます。 +上記のように、展開/縮小 UI を除くグループ行は完全にテンプレート化可能です。カスタムの GroupBy 行セレクター テンプレートを作成するには、 ディレクティブを使用します。テンプレートから、Group By 行の状態に関する情報を提供するプロパティを使用して、暗黙的に提供されたコンテキスト変数にアクセスできます。 - プロパティは、現在選択されているグループ レコードの数を示し、 はグループに属するレコードの数を示します。 + プロパティは、現在選択されているグループ レコードの数を示し、 はグループに属するレコードの数を示します。 ```html @@ -467,7 +467,7 @@ igRegisterScript("GroupByRowSelectorTemplate", (ctx) => { - プロパティは、グループ行への参照を返します。 + プロパティは、グループ行への参照を返します。 ```html @@ -515,7 +515,7 @@ igRegisterScript("GroupByRowSelectorTemplate", (ctx) => { - プロパティを使用して、Group By 行セレクターをチェックするか不確定にする (部分的に選択する) かを決定できます。 + プロパティを使用して、Group By 行セレクターをチェックするか不確定にする (部分的に選択する) かを決定できます。 @@ -571,13 +571,13 @@ igRegisterScript("GroupByRowSelectorTemplate", (ctx) => { -In order to implement custom grouping the data first needs to be sorted appropriately. Due to this you may also need to apply a custom sorting strategy that extends the base . After the data is sorted the custom groups can be determined by specifying a for the column or for the specific grouping expression. +In order to implement custom grouping the data first needs to be sorted appropriately. Due to this you may also need to apply a custom sorting strategy that extends the base . After the data is sorted the custom groups can be determined by specifying a for the column or for the specific grouping expression. -カスタム グループ化を実装するには、まずデータを適切にソートする必要があります。このため、ベース `DefaultSortingStrategy` を拡張するカスタムのソート ストラテジを適用する必要がある場合もあります。データがソートされた後、列または特定のグループ化式に `GroupingComparer` を指定することにより、カスタム グループを決定できます。 +カスタム グループ化を実装するには、まずデータを適切にソートする必要があります。このため、ベース `DefaultSortingStrategy` を拡張するカスタムのソート ストラテジを適用する必要がある場合もあります。データがソートされた後、列または特定のグループ化式に を指定することにより、カスタム グループを決定できます。 ### {Platform} カスタム グループ化の例 @@ -585,7 +585,7 @@ In order to implement custom grouping the data first needs to be sorted appropri このサンプルでは、さまざまな日付条件のカスタム ソートストラテジを定義しています。 -各カスタム ストラテジは メソッドを定義します。値をソートするときに使用されるカスタム比較関数です。さらに、比較に必要な日付から値を抽出します。 +各カスタム ストラテジは メソッドを定義します。値をソートするときに使用されるカスタム比較関数です。さらに、比較に必要な日付から値を抽出します。 @@ -619,7 +619,7 @@ function getParsedDate(date: any) { - 関数がグループ化式に対して定義され、選択されたグループ化モードに基づいて同じグループに属するアイテムを決定します。この関数が 0 を返すソートされた値は、同じグループの一部としてマークされます。 + 関数がグループ化式に対して定義され、選択されたグループ化モードに基づいて同じグループに属するアイテムを決定します。この関数が 0 を返すソートされた値は、同じグループの一部としてマークされます。 ```typescript public groupByMode = "Month"; diff --git a/docs/xplat/src/content/jp/components/grids/grid/master-detail.mdx b/docs/xplat/src/content/jp/components/grids/grid/master-detail.mdx index 7bb026ec71..70f518aca3 100644 --- a/docs/xplat/src/content/jp/components/grids/grid/master-detail.mdx +++ b/docs/xplat/src/content/jp/components/grids/grid/master-detail.mdx @@ -175,4 +175,4 @@ const masterDetailTemplate = (args: IgrGridMasterDetailContext) => {

-
+
diff --git a/docs/xplat/src/content/jp/components/grids/grid/selection-based-aggregates.mdx b/docs/xplat/src/content/jp/components/grids/grid/selection-based-aggregates.mdx index c7c73f68d4..04d41f2459 100644 --- a/docs/xplat/src/content/jp/components/grids/grid/selection-based-aggregates.mdx +++ b/docs/xplat/src/content/jp/components/grids/grid/selection-based-aggregates.mdx @@ -18,7 +18,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## トピックの概要 選択に基づいた集計機能を実現するには、`グリッド選択`機能と`グリッド集計`を使用できます。 -集計では、列のデータ タイプとニーズに応じて、`SummaryOperand`、`NumberSummaryOperand`.html、`DateSummaryOperand` のいずれかの基本クラスを拡張することにより、基本的な集計機能をカスタマイズできます。 +集計では、列のデータ タイプとニーズに応じて、.html、 のいずれかの基本クラスを拡張することにより、基本的な集計機能をカスタマイズできます。 ## 選択 選択したグリッド範囲のデータの操作を開始するには、グリッド選択の変更を通知するイベントにサブスクライブする必要があります。これは、`selected` イベントと `rangeSelected` イベントにサブスクライブすることで実行できます。選択機能では、単一のセル選択とセル範囲の選択が区別されるため、両方にバインドする必要があります。 @@ -27,7 +27,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 集計 カスタム集計クラス内では、グリッドのデータ タイプを差別化する必要があります。たとえば、以下のシナリオでは、4 つの異なる列があり、それぞれのデータ タイプがカスタム集計に適しています。それらは、Unit Price、Units in Stock、Discontinued status、Order Date です。 -`SummaryOperand` の派生クラスの `operate` メソッドでデータを処理します。データ タイプに基づいて、さまざまなカテゴリにデータを入れていきます。 + の派生クラスの `operate` メソッドでデータを処理します。データ タイプに基づいて、さまざまなカテゴリにデータを入れていきます。 ```typescript const numberData = data.filter(rec => typeof rec === "number"); @@ -39,7 +39,7 @@ const dates = data.filter(rec => isDate(rec)); `isDate` はカスタム関数であることに注意してください。 -データ タイプをグループ化した後、集計を開始できます。そのため、`NumberSummaryOperand` および `DateSummaryOperand` の既に公開されているメソッドを使用できます。 +データ タイプをグループ化した後、集計を開始できます。そのため、 および の既に公開されているメソッドを使用できます。 その後、集計データを同じ配列に配置する必要があり、テンプレートに返されます。 データを可視化には、グリッド フッターを使用することができ、`custom-summaries` クラスと組み合わせて集計を表示します。 diff --git a/docs/xplat/src/content/jp/components/grids/hierarchical-grid/load-on-demand.mdx b/docs/xplat/src/content/jp/components/grids/hierarchical-grid/load-on-demand.mdx index 0bb3c22e77..afe58f18d3 100644 --- a/docs/xplat/src/content/jp/components/grids/hierarchical-grid/load-on-demand.mdx +++ b/docs/xplat/src/content/jp/components/grids/hierarchical-grid/load-on-demand.mdx @@ -18,7 +18,7 @@ import hgridDatabase from '@xplat-images/hgrid-database.jpg'; # Hierarchical Grid ロードオンデマンド -Ignite UI for {Platform} `HierarchicalGrid` は、要求するサーバーからのデータを最低限にすることによりすばやく描画できます。このため、ユーザーがビューで結果を確認でき、表示データをインタラクティブに操作できます。初期時にグリッドのデータのみが取得されて描画され、ユーザーが子グリッドを含む行を拡張した後のみ、特定の子グリッドのデータを取得します。このメカニズムは、ロードオンデマンドであらゆるリモートデータとの設定が簡単にできます。 +Ignite UI for {Platform} は、要求するサーバーからのデータを最低限にすることによりすばやく描画できます。このため、ユーザーがビューで結果を確認でき、表示データをインタラクティブに操作できます。初期時にグリッドのデータのみが取得されて描画され、ユーザーが子グリッドを含む行を拡張した後のみ、特定の子グリッドのデータを取得します。このメカニズムは、ロードオンデマンドであらゆるリモートデータとの設定が簡単にできます。 このトピックは、既に利用可能なリモート サービスと通信してリモート サービス プロバイダーを作成し、ロードオンデマンドを設定する方法を説明します。以下は、デモと作成手順を示します。 @@ -310,7 +310,7 @@ function buildUrl(dataState) { ### テンプレートの地祇 -最初に階層グリッド テンプレートを必要な階層レベルで定義します。customers のルート グリッド `PrimaryKey` は最初のレベルの orders の `customerId` です。`orderId` と各 order 詳細の `productId` です。各データベース テーブルとキーで初期テンプレートを定義します。 +最初に階層グリッド テンプレートを必要な階層レベルで定義します。customers のルート グリッド は最初のレベルの orders の `customerId` です。`orderId` と各 order 詳細の `productId` です。各データベース テーブルとキーで初期テンプレートを定義します。 @@ -474,7 +474,7 @@ function buildUrl(dataState) { -展開されている子にデータを設定する方法は異なります。行がはじめて展開されたときに新し子 `HierarchicalGrid` が描画がされるため、データを設定するために新しく作成されたグリッドの参照を取得する必要があります。各 `RowIsland` コンポーネントに `GridCreated` イベントがあり、特定の子アイランドに新しい子グリッドが作成されたときに発生します。新しいグリッドの参照を取得するために使用でき、サービスからデータを要求して適用します。 +展開されている子にデータを設定する方法は異なります。行がはじめて展開されたときに新し子 が描画がされるため、データを設定するために新しく作成されたグリッドの参照を取得する必要があります。各 コンポーネントに `GridCreated` イベントがあり、特定の子アイランドに新しい子グリッドが作成されたときに発生します。新しいグリッドの参照を取得するために使用でき、サービスからデータを要求して適用します。 サービスをビルドしているためルートレベルの場合に情報のみが必要なため、すべてのアイランドに 1 メソッドを使用できます。このすべての情報には、イベント引数から直接またはイベントをトリガーする行アイランドからアクセスできます。 @@ -518,7 +518,7 @@ function buildUrl(dataState) { -`GridCreated` イベントは `parentID` プロパティ、`owner` として行アイランドへの参照、新しい子 `grid` プロパティを提供するため、最初の引数として渡されます。親行の `primaryKey` についての情報しかありませんが、行アイランドの `ChildDataKey` に基づいてそれを簡単に判断できます。 +`GridCreated` イベントは `parentID` プロパティ、`owner` として行アイランドへの参照、新しい子 `grid` プロパティを提供するため、最初の引数として渡されます。親行の `primaryKey` についての情報しかありませんが、行アイランドの に基づいてそれを簡単に判断できます。 @@ -888,11 +888,11 @@ igRegisterScript("OnGridCreated", (args) => {
-これにより、アプリケーションの設定はほぼ完了です。最後の手順は、空グリッドを表示する代わりにユーザーにデータがまだ読み込み中であることを通知してユーザー エクスペリエンスを向上します。`HierarchicalGrid` は、グリッドが空のときに表示できるインジケーターの読み込みサポートします。新しいデータが取得されると読み込みインジケーターが非表示となりデータが描画されます。 +これにより、アプリケーションの設定はほぼ完了です。最後の手順は、空グリッドを表示する代わりにユーザーにデータがまだ読み込み中であることを通知してユーザー エクスペリエンスを向上します。 は、グリッドが空のときに表示できるインジケーターの読み込みサポートします。新しいデータが取得されると読み込みインジケーターが非表示となりデータが描画されます。 ### 読み込み通知の設定 -`HierarchicalGrid` は、`IsLoading` プロパティを **true** に設定して読み込みインジケーターを表示できます。データが読み込まれるまでルートグリッドにあらかじめ設定しますが、新しい子グリッドを作成する際にも必要です。テンプレートで常に **true** に設定できますが、**false** に設定してサービスが空配列を返した場合は非表示にしてデータのないグリッドを表示できます。 + は、 プロパティを **true** に設定して読み込みインジケーターを表示できます。データが読み込まれるまでルートグリッドにあらかじめ設定しますが、新しい子グリッドを作成する際にも必要です。テンプレートで常に **true** に設定できますが、**false** に設定してサービスが空配列を返した場合は非表示にしてデータのないグリッドを表示できます。 以下は構成の最終バージョンです。 diff --git a/docs/xplat/src/content/jp/components/grids/hierarchical-grid/overview.mdx b/docs/xplat/src/content/jp/components/grids/hierarchical-grid/overview.mdx index 22dae6be70..87925b1a3f 100644 --- a/docs/xplat/src/content/jp/components/grids/hierarchical-grid/overview.mdx +++ b/docs/xplat/src/content/jp/components/grids/hierarchical-grid/overview.mdx @@ -609,7 +609,7 @@ function buildUrl(dataState) { ## 行展開インジケーターの表示/非表示 -行がその展開前に子を持つかどうかについての情報を提供する方法がある場合は、`HasChildrenKey` 入力プロパティを使用できます。このようにして、展開インジケータを表示するかどうかを示すデータオブジェクトからブール値プロパティを提供できます。 +行がその展開前に子を持つかどうかについての情報を提供する方法がある場合は、 入力プロパティを使用できます。このようにして、展開インジケータを表示するかどうかを示すデータオブジェクトからブール値プロパティを提供できます。 @@ -647,9 +647,9 @@ function buildUrl(dataState) { -`HasChildrenKey` プロパティを設定する必要はありません。指定しなかった場合は、各行に展開インジケーターが表示されます。 + プロパティを設定する必要はありません。指定しなかった場合は、各行に展開インジケーターが表示されます。 -さらに、ヘッダーのすべて展開/縮小インジケーターを表示/非表示にする場合は、`ShowExpandAll` プロパティを使用できます。 +さらに、ヘッダーのすべて展開/縮小インジケーターを表示/非表示にする場合は、 プロパティを使用できます。 この UI は、パフォーマンス上の理由からデフォルトで無効になっているため、データが大きいグリッドやロードオンデマンドのグリッドで有効にすることはお勧めしません。 ## 機能 @@ -975,4 +975,4 @@ $custom-theme: grid-theme(


-
+
diff --git a/docs/xplat/src/content/jp/components/grids/list.mdx b/docs/xplat/src/content/jp/components/grids/list.mdx index 2edd0e4713..379120e6bc 100644 --- a/docs/xplat/src/content/jp/components/grids/list.mdx +++ b/docs/xplat/src/content/jp/components/grids/list.mdx @@ -14,11 +14,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} List (リスト) の概要 -{ProductName} List 要素は、項目のグループを番号の付いた形式または黒丸の付いた形式のいずれかで提示する時に非常に役に立ちます。さまざまなレイアウト要素の配列を含むテキスト アイテムの単純なリスト、またはより複雑なリストを作成できます。`List` コンポーネントは項目の行を表示し、1 つ以上のヘッダーもサポートします。各リスト項目は完全にテンプレート化可能であり、有効な HTML またはその他のコンポーネントをサポートします。 +{ProductName} List 要素は、項目のグループを番号の付いた形式または黒丸の付いた形式のいずれかで提示する時に非常に役に立ちます。さまざまなレイアウト要素の配列を含むテキスト アイテムの単純なリスト、またはより複雑なリストを作成できます。 コンポーネントは項目の行を表示し、1 つ以上のヘッダーもサポートします。各リスト項目は完全にテンプレート化可能であり、有効な HTML またはその他のコンポーネントをサポートします。 ## {Platform} List の例 -次の例は、名前と電話番号のプロパティを持つ連絡先が入力されたリストを表しています。以下に示す `List` コンポーネントは、`Avatar` 要素と `Button` 要素を使用して、ユーザー エクスペリエンスを強化し、テキストと呼び出しアクションのアバター画像とボタンを設定する機能を公開します。 +次の例は、名前と電話番号のプロパティを持つ連絡先が入力されたリストを表しています。以下に示す コンポーネントは、 要素と 要素を使用して、ユーザー エクスペリエンスを強化し、テキストと呼び出しアクションのアバター画像とボタンを設定する機能を公開します。 @@ -55,7 +55,7 @@ npm install {PackageWebComponents} npm install igniteui-react ``` -次に、以下のように、`List` と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrList, IgrListHeader, IgrListItem } from 'igniteui-react'; @@ -66,7 +66,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css';
-`List` を使用する前に、次のように登録する必要があります。 + を使用する前に、次のように登録する必要があります。 @@ -83,7 +83,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbListModule)); -また、追加の CSS ファイルをリンクして、スタイルを `List` コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -258,7 +258,7 @@ defineComponents(IgcListComponent); ### アバターおよびボタンの追加 -他のコンポーネントのいくつかを `List` コンポーネントと組み合わせて使用して、エクスペリエンスを充実させ、いくつかの機能を追加することができます。名前や電話番号の値の左に画像のアバターを表示できます。さらに、右側にいくつかのボタンを追加して、ユーザーが連絡先にテキスト メッセージを送信したり電話をかけたりできるようにすることができるので、連絡先リスト コンポーネントを更新して、アバターとボタンを表示します。リスト項目のスロットのいくつかを使用することでそれを行うことができます。 +他のコンポーネントのいくつかを コンポーネントと組み合わせて使用して、エクスペリエンスを充実させ、いくつかの機能を追加することができます。名前や電話番号の値の左に画像のアバターを表示できます。さらに、右側にいくつかのボタンを追加して、ユーザーが連絡先にテキスト メッセージを送信したり電話をかけたりできるようにすることができるので、連絡先リスト コンポーネントを更新して、アバターとボタンを表示します。リスト項目のスロットのいくつかを使用することでそれを行うことができます。 @@ -407,9 +407,9 @@ defineComponents(IgcListComponent); -`start` スロットは、リスト項目の他のすべてのコンテンツの前に、ある種のメディアを追加するために使用することを目的としています。ターゲット要素 (この場合は `Avatar` コンポーネント) にも、デフォルトの位置と間隔が提供されます。 +`start` スロットは、リスト項目の他のすべてのコンテンツの前に、ある種のメディアを追加するために使用することを目的としています。ターゲット要素 (この場合は コンポーネント) にも、デフォルトの位置と間隔が提供されます。 -`end` スロットは、switch、button、checkbox などで表される、ある種のアクションまたはメタデータを持つリスト項目に使用することを目的としています。`Button` コンポーネントを使用します。 +`end` スロットは、switch、button、checkbox などで表される、ある種のアクションまたはメタデータを持つリスト項目に使用することを目的としています。 コンポーネントを使用します。 また、ユーザーが `--ig-size` CSS 変数を使用してリストのサイズを変更できるようにしましょう。すべてのサイズ値を表示するために、いくつかのラジオ ボタンを追加します。このようにして、選択されるたびに、リストのサイズを変更します。 @@ -512,7 +512,7 @@ public onRadioChange(e: any) { ## スタイル設定 -`List` はいくつかの CSS パーツを公開し、スタイルを完全に制御できるようにします。 + はいくつかの CSS パーツを公開し、スタイルを完全に制御できるようにします。 |名前|説明| |--|--| @@ -543,20 +543,20 @@ igc-list-item::part(subtitle) { -この記事では、`List` コンポーネントで多くのことを取り上げました。最初に、テキスト項目を含む簡単なリストを作成しました。次に、連絡先項目のリストを作成し、`Avatar` や `Button` などの追加の {ProductName} コンポーネントを使用してそれらに機能を追加しました。最後に、公開された CSS パーツを使用してコンポーネントの外観を変更しました。 +この記事では、 コンポーネントで多くのことを取り上げました。最初に、テキスト項目を含む簡単なリストを作成しました。次に、連絡先項目のリストを作成し、 などの追加の {ProductName} コンポーネントを使用してそれらに機能を追加しました。最後に、公開された CSS パーツを使用してコンポーネントの外観を変更しました。
## API リファレンス -
-
+
+




-
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/grids/pivot-grid/features.mdx b/docs/xplat/src/content/jp/components/grids/pivot-grid/features.mdx index d62ac73f6a..c46533d398 100644 --- a/docs/xplat/src/content/jp/components/grids/pivot-grid/features.mdx +++ b/docs/xplat/src/content/jp/components/grids/pivot-grid/features.mdx @@ -19,7 +19,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ピボットおよびフラット グリッド コンポーネントは、共通ベースを継承しているため、いくつかの機能を共有しています。 -一部の機能は、ピボット テーブルのコンテキストで意味のある動作をしないため `PivotGrid` で有効にできません。以下が含まれます。 +一部の機能は、ピボット テーブルのコンテキストで意味のある動作をしないため で有効にできません。以下が含まれます。 - CRUD 操作 - グループ化 - 行 / 列のピン固定 @@ -52,8 +52,8 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; すべてのフィルタリング チップに十分なスペースがない場合、{PivotGridTitle} には、ドロップダウンに切り取られたものが表示されます。エンドユーザーはそこでアクセスして操作できます。 -ディメンションは、ディメンションの `filter` プロパティを使用して `PivotConfiguration` のディメンション構成を介して最初にフィルター処理することもできます。 -これは、関連するフィルター条件を使用して新しい `FilteringExpressionsTree` に設定できます。例えば: +ディメンションは、ディメンションの `filter` プロパティを使用して のディメンション構成を介して最初にフィルター処理することもできます。 +これは、関連するフィルター条件を使用して新しい に設定できます。例えば: ```typescript public filterExpTree = new FilteringExpressionsTree(FilteringLogic.And); @@ -139,9 +139,9 @@ const dimension: IgrPivotDimension = { ## ディメンションのサイズ変更 行のサイズは、列のサイズ変更と同様に、セルの右端にあるサイズ変更インジケーターを介してサイズ変更できます。 -サイズ変更インジケーターをダブル クリックするか、関連する API (`AutoSizeRowDimension`) を使用して、自動サイズ設定することもできます。 +サイズ変更インジケーターをダブル クリックするか、関連する API () を使用して、自動サイズ設定することもできます。 -ディメンション定義で使用可能な `Width` プロパティを使用して、最初に別のサイズを設定することもできます。 +ディメンション定義で使用可能な プロパティを使用して、最初に別のサイズを設定することもできます。 @@ -238,7 +238,7 @@ const igrPivotDimension2: IgrPivotDimension = { 複数の行 / 列にまたがるグループを作成する複数の行または列のディメンションがある場合、選択は、選択されたグループに属するすべてのセルに適用されます。 ## スーパー コンパクト モード -`PivotGrid` コンポーネントは、`SuperCompactMode` 入力を提供します。一度にたくさんのセルが画面に表示させる必要がある場合に適しています。有効にすると、このオプションは {PivotGridTitle} の `--ig-size` CSS 変数を無視します。`SuperCompactMode` を有効にすると、`SuperCompactMode` オプションがない子コンポーネント (`Chip` など) ごとに `--ig-size` が `small` に設定されます。 + コンポーネントは、 入力を提供します。一度にたくさんのセルが画面に表示させる必要がある場合に適しています。有効にすると、このオプションは {PivotGridTitle} の `--ig-size` CSS 変数を無視します。 を有効にすると、 オプションがない子コンポーネント (`Chip` など) ごとに `--ig-size` が `small` に設定されます。 diff --git a/docs/xplat/src/content/jp/components/grids/pivot-grid/overview.mdx b/docs/xplat/src/content/jp/components/grids/pivot-grid/overview.mdx index 7581b686b3..0cd3192c7a 100644 --- a/docs/xplat/src/content/jp/components/grids/pivot-grid/overview.mdx +++ b/docs/xplat/src/content/jp/components/grids/pivot-grid/overview.mdx @@ -20,8 +20,8 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; {Platform} ピボット グリッドは、ピボット テーブルにデータを表示し、提供されたデータ セットで複雑な分析を実行するのに役立ちます。この洗練されたピボット グリッド コントロールは、後でクロス集計形式で表示される大量のデータを整理、集計、およびフィルタリングするために使用されます。{Platform} ピボット グリッドの主な機能は、行のディメンション、列のディメンション、集計、およびフィルターです。 -`PivotGrid` を使用すると、ユーザーはデータを多次元のピボット テーブル構造で構成および表示できます。 -行と列は個別のデータ グループを表し、データ セルの値は集計を表します。これにより、単純なフラット データセットに基づく複雑なデータ分析が可能になります。`PivotGrid` は機能豊富なピボット テーブルで、さまざまなディメンションと値を簡単に構成できるだけでなく、フィルタリングやソートなどの追加のデータ操作も提供します。 + を使用すると、ユーザーはデータを多次元のピボット テーブル構造で構成および表示できます。 +行と列は個別のデータ グループを表し、データ セルの値は集計を表します。これにより、単純なフラット データセットに基づく複雑なデータ分析が可能になります。 は機能豊富なピボット テーブルで、さまざまなディメンションと値を簡単に構成できるだけでなく、フィルタリングやソートなどの追加のデータ操作も提供します。 ## {Platform} ピボット グリッドの例 @@ -34,7 +34,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## {Platform} ピボット グリッドを使用した作業の開始 -{Platform} {PivotGridName} は、`PivotConfiguration` プロパティを介して構成できます。 +{Platform} {PivotGridName} は、 プロパティを介して構成できます。 @@ -78,14 +78,14 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ### ディメンション構成 -各基本ディメンション構成には、提供された**データ**のフィールドに一致する `MemberName` が必要です。 +各基本ディメンション構成には、提供された**データ**のフィールドに一致する が必要です。 複数の兄弟ディメンションを定義できます。これにより、関連する行または列のディメンション領域に、より複雑なネストされたグループが作成されます。 ディメンションは、ドラッグアンドドロップを使用して、対応するチップを介して、ある領域から別の領域に並べ替えたり移動したりできます。 -ディメンションは、`ChildLevel` プロパティを介して拡張可能な階層を記述することもできます。例えば: +ディメンションは、 プロパティを介して拡張可能な階層を記述することもできます。例えば: @@ -148,12 +148,12 @@ const dimension: IgrPivotDimension = { -この場合、ディメンションはグリッドの関連セクション (行または列) にエキスパンダーを描画し、階層の一部として子を展開または縮小ことができます。デフォルトでは、行のディメンションは最初に展開されます。この動作は、ピボット グリッドの `DefaultExpandState` プロパティで制御できます。 +この場合、ディメンションはグリッドの関連セクション (行または列) にエキスパンダーを描画し、階層の一部として子を展開または縮小ことができます。デフォルトでは、行のディメンションは最初に展開されます。この動作は、ピボット グリッドの プロパティで制御できます。 ### 事前定義されたディメンション ピボット グリッドの一部として、構成を容易にするために、いくつかの追加の事前定義されたディメンションが公開されています: -- `PivotDateDimension` +- 日付フィールドに使用できます。デフォルトで次の階層を記述します: - すべての期間 - 年 @@ -322,7 +322,7 @@ public pivotConfigHierarchy: IgcPivotConfiguration = { - `PivotAggregate` - その他のデータ型用。これが基本集計です。 次の集計関数が含まれています: `COUNT`。 -現在の集計関数は、バリューチップのドロップダウンを使用して実行時に変更できます。デフォルトでは、フィールドのデータ型に基づいて使用可能な集計のリストが表示されます。集計のカスタム リストは、`AggregateList` プロパティを介して設定することもできます。例えば: +現在の集計関数は、バリューチップのドロップダウンを使用して実行時に変更できます。デフォルトでは、フィールドのデータ型に基づいて使用可能な集計のリストが表示されます。集計のカスタム リストは、 プロパティを介して設定することもできます。例えば: @@ -486,12 +486,12 @@ public static totalMax: PivotAggregation = (members, data: any) => { -ピボット値は `DisplayName` プロパティも提供します。この値のカスタム名を列ヘッダーに表示するために使用できます。 +ピボット値は プロパティも提供します。この値のカスタム名を列ヘッダーに表示するために使用できます。 ### プロパティを有効にする -`PivotConfiguration` は、`PivotGrid` コンポーネントの現在の状態を記述するインターフェースです。これを使用すると、開発者はデータのフィールドを **rows**、**columns**、**filters** または **values** (行、列、フィルター、値) として宣言できます。この構成では、これらの各要素を個別に有効または無効にすることができます。ピボット グリッドの現在の状態には、有効な要素のみが含まれます。`PivotDataSelector` コンポーネントは同じ構成を利用し、すべての有効と無効の要素のリストを表示します。それぞれについて、適切な状態のチェックボックスがあります。エンドユーザーは、これらのチェックボックスを使用してさまざまな要素を切り替えることにより、ピボット状態を簡単に調整できます。 -`Enable` プロパティは、特定の `PivotDimension` または `PivotValue` がアクティブであり、ピボット グリッドによって描画されるピボット ビューに参加するかどうかを制御します。 + は、 コンポーネントの現在の状態を記述するインターフェースです。これを使用すると、開発者はデータのフィールドを **rows**、**columns**、**filters** または **values** (行、列、フィルター、値) として宣言できます。この構成では、これらの各要素を個別に有効または無効にすることができます。ピボット グリッドの現在の状態には、有効な要素のみが含まれます。 コンポーネントは同じ構成を利用し、すべての有効と無効の要素のリストを表示します。それぞれについて、適切な状態のチェックボックスがあります。エンドユーザーは、これらのチェックボックスを使用してさまざまな要素を切り替えることにより、ピボット状態を簡単に調整できます。 +`Enable` プロパティは、特定の または がアクティブであり、ピボット グリッドによって描画されるピボット ビューに参加するかどうかを制御します。 ### 完全な構成のコード @@ -715,19 +715,19 @@ public PivotDataFlat() ### 設定の自動生成 -`AutoGenerateConfig` プロパティは、データ ソース フィールドに基づいてディメンションと値を自動的に生成します。 + プロパティは、データ ソース フィールドに基づいてディメンションと値を自動的に生成します。 - 数値フィールド: - - `PivotNumericAggregate.sum` アグリゲーターを使用して `PivotValue` として作成されます。 + - `PivotNumericAggregate.sum` アグリゲーターを使用して として作成されます。 - 値のコレクションに追加され、デフォルトで有効になります。 - 数値以外のフィールド: - - `PivotDimension` として作成されます。 + - として作成されます。 - デフォルトで無効です。 - 列コレクションに追加されます。 - 日付フィールド (最初の `date` フィールドのみが有効になり、他の `date` フィールドには非数値フィールドのルールが適用されます): - - `PivotDateDimension` として作成されます。 + - として作成されます。 - デフォルトで有効です。 - 行コレクションに追加されます。 @@ -800,7 +800,7 @@ public PivotDataFlat() -Blazor で `PivotKeys` をオーバーライドする場合、新しい PivotKeys オブジェクトを割り当てるとデフォルトのキーが完全に置き換えられるため、現在は他のすべてのキーを定義する必要があります。 +Blazor で をオーバーライドする場合、新しい PivotKeys オブジェクトを割り当てるとデフォルトのキーが完全に置き換えられるため、現在は他のすべてのキーを定義する必要があります。 ```razor @code { @@ -824,8 +824,8 @@ Blazor で `PivotKeys` をオーバーライドする場合、新しい PivotKey |制限|説明| |--- |--- | -| 列を宣言的に設定することはサポートされていません。 | ピボット グリッドは `Columns` (列) の構成に基づいて列を生成するため、ベース グリッドのように宣言的に設定することはサポートされていません。このような列は無視されます。 | -| ディメンション / 値に重複した `MemberName` または `Member` プロパティ値を設定します。 | これらのプロパティは、各ディメンション / 値に対して一意である必要があります。複製すると、最終結果からデータが失われる可能性があります。 | +| 列を宣言的に設定することはサポートされていません。 | ピボット グリッドは (列) の構成に基づいて列を生成するため、ベース グリッドのように宣言的に設定することはサポートされていません。このような列は無視されます。 | +| ディメンション / 値に重複した または プロパティ値を設定します。 | これらのプロパティは、各ディメンション / 値に対して一意である必要があります。複製すると、最終結果からデータが失われる可能性があります。 | | 行選択は、**Single** (単一) モードでのみサポートされます。 | 現在、複数選択はサポートされていません。 | | ディメンション メンバーのマージでは大文字と小文字が区別されます。| ピボット グリッドはグループを作成し、同じ (大文字と小文字を区別する) 値をマージします。ただし、ディメンションは `MemberFunction` を提供し、これはそこで変更できます。`MemberFunction` の結果が比較され、表示値として使用されます。| @@ -834,10 +834,10 @@ Blazor で `PivotKeys` をオーバーライドする場合、新しい PivotKey ## API リファレンス -
+


-
+

## その他のリソース diff --git a/docs/xplat/src/content/jp/components/grids/pivot-grid/remote-operations.mdx b/docs/xplat/src/content/jp/components/grids/pivot-grid/remote-operations.mdx index 2e3a8f176c..59b542af8f 100644 --- a/docs/xplat/src/content/jp/components/grids/pivot-grid/remote-operations.mdx +++ b/docs/xplat/src/content/jp/components/grids/pivot-grid/remote-operations.mdx @@ -59,12 +59,12 @@ rows: [ ``` ピボット グリッドは、ピボット計算を行うために使用するオブジェクト キー フィールドを提供します。 -- `Children` - 階層構築のために子を格納するフィールド。これは、グループ化された値と、その値に基づくすべての pivotGridRecords からのマップを表します。これは、階層の作成中に何かを行う必要がある非常に特殊なシナリオで利用できます。一般的な使用法のためにこれを変更する必要はありません。 -- `Records` - 元のデータ レコードへの参照を格納するフィールド。上記の例で見ることができます - **AllProducts_records**。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データ レコードに **records** プロパティがある場合は、`PivotKeys` を使用して異なる一意の値を指定できます。 -- `Aggregations` - 集計値を格納するフィールド。階層の作成中に適用され 、一般的なシナリオでは変更する必要はありません。 -- `Level` - 階層に基づいてディメンション レベルを格納するフィールド。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データ レコードに **level** プロパティがある場合は、`PivotKeys` を使用して異なる一意の値を指定できます。 -- `ColumnDimensionSeparator` - 一意の列フィールド値を生成するときに使用されるセパレーター。上からの例のダッシュ (**-**) - **All-Bulgaria** です。 -- `RowDimensionSeparator` - 一意の行フィールド値を生成するときに使用されるセパレーター。上記の例のアンダースコア (**_**) - **AllProducts_records** です。`Records` (レコード) と `Level` (レベル) フィールド を作成するときに使用されます。 +- - 階層構築のために子を格納するフィールド。これは、グループ化された値と、その値に基づくすべての pivotGridRecords からのマップを表します。これは、階層の作成中に何かを行う必要がある非常に特殊なシナリオで利用できます。一般的な使用法のためにこれを変更する必要はありません。 +- - 元のデータ レコードへの参照を格納するフィールド。上記の例で見ることができます - **AllProducts_records**。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データ レコードに **records** プロパティがある場合は、 を使用して異なる一意の値を指定できます。 +- - 集計値を格納するフィールド。階層の作成中に適用され 、一般的なシナリオでは変更する必要はありません。 +- - 階層に基づいてディメンション レベルを格納するフィールド。このプロパティと同じ名前でデータにフィールドを設定することは避けてください。データ レコードに **level** プロパティがある場合は、 を使用して異なる一意の値を指定できます。 +- - 一意の列フィールド値を生成するときに使用されるセパレーター。上からの例のダッシュ (**-**) - **All-Bulgaria** です。 +- - 一意の行フィールド値を生成するときに使用されるセパレーター。上記の例のアンダースコア (**_**) - **AllProducts_records** です。 (レコード) と (レベル) フィールド を作成するときに使用されます。 ```typescript public aggregatedData = [ @@ -79,9 +79,9 @@ public aggregatedData = [ ]; ``` -これらはすべて、`Pivo​​tConfiguration` の一部である `PivotKeys` プロパティに格納され、デフォルトのピボット キーを変更するために使用できます。これらのデフォルトは次のとおりです: +これらはすべて、`Pivo​​tConfiguration` の一部である プロパティに格納され、デフォルトのピボット キーを変更するために使用できます。これらのデフォルトは次のとおりです: -`ColumnStrategy` と `RowStrategy` に `NoopPivotDimensionsStrategy` を設定すると、データ パイプによって行われるデータのグループ化と集計がスキップされますが、ピボット ビューを期待どおりに描画するには、ピボット グリッドで行、列、値、フィルターの宣言が必要です: + に `NoopPivotDimensionsStrategy` を設定すると、データ パイプによって行われるデータのグループ化と集計がスキップされますが、ピボット ビューを期待どおりに描画するには、ピボット グリッドで行、列、値、フィルターの宣言が必要です: ```typescript export const = { @@ -90,7 +90,7 @@ export const = { }; ``` -データが構成と一致することが重要です。最良の結果を得るには、集計データに追加のフィールドを含めたり、提供されたデータのフィールドを行または列として宣言せずに残したりしないでください。`PivotGrid` コンポーネントは、`PivotConfiguration` に基づいてデータを構築し、それに応じて構成と集約データが一致することが期待されます。 +データが構成と一致することが重要です。最良の結果を得るには、集計データに追加のフィールドを含めたり、提供されたデータのフィールドを行または列として宣言せずに残したりしないでください。 コンポーネントは、 に基づいてデータを構築し、それに応じて構成と集約データが一致することが期待されます。 @@ -176,9 +176,9 @@ public pivotConfig: IgcPivotConfiguration = { -同様に、並べ替えやフィルタリングなどの他のリモート データ操作の場合、関連する空のストラテジ (`FilterStrategy`、`SortStrategy`) を設定することで、データ処理をスキップできます。 +同様に、並べ替えやフィルタリングなどの他のリモート データ操作の場合、関連する空のストラテジ () を設定することで、データ処理をスキップできます。 -Similarly for other remote data operations like sorting and filtering, data processing can be skipped by setting the related empty strategies - `FilterStrategy`, `SortStrategy`: +Similarly for other remote data operations like sorting and filtering, data processing can be skipped by setting the related empty strategies - , : diff --git a/docs/xplat/src/content/jp/components/grids/tree-grid/load-on-demand.mdx b/docs/xplat/src/content/jp/components/grids/tree-grid/load-on-demand.mdx index f6212adf11..4b452cfceb 100644 --- a/docs/xplat/src/content/jp/components/grids/tree-grid/load-on-demand.mdx +++ b/docs/xplat/src/content/jp/components/grids/tree-grid/load-on-demand.mdx @@ -79,7 +79,7 @@ public loadChildren = (parentID: any, done: (children: any[]) => void) => { ### 展開インジケーターの表示 -行がその展開前に子を持つかどうかについての情報を提供する方法がある場合は、`HasChildrenKey` 入力プロパティを使用できます。このようにして、展開インジケータを表示するかどうかを示すデータオブジェクトからブール値プロパティを提供できます。 +行がその展開前に子を持つかどうかについての情報を提供する方法がある場合は、 入力プロパティを使用できます。このようにして、展開インジケータを表示するかどうかを示すデータオブジェクトからブール値プロパティを提供できます。 @@ -105,7 +105,7 @@ public loadChildren = (parentID: any, done: (children: any[]) => void) => { -`HasChildrenKey` プロパティを設定する必要はありません。指定しなかった場合は、各行に展開インジケーターが表示されます。子を持たない行を展開した後も、未定義または空の配列で done コールバックを呼び出す必要があります。この場合、ロード インジケーターが消えた後に展開ンジケータは表示されません。 + プロパティを設定する必要はありません。指定しなかった場合は、各行に展開インジケーターが表示されます。子を持たない行を展開した後も、未定義または空の配列で done コールバックを呼び出す必要があります。この場合、ロード インジケーターが消えた後に展開ンジケータは表示されません。 ### カスタム ロード インジケーター @@ -113,7 +113,7 @@ public loadChildren = (parentID: any, done: (children: any[]) => void) => { -独自のカスタム ロード インジケーターを提供する場合は、`RowLoadingIndicatorTemplate` オプションを使用してカスタム テンプレートを設定できます。以下のコードは設定方法を示します: +独自のカスタム ロード インジケーターを提供する場合は、 オプションを使用してカスタム テンプレートを設定できます。以下のコードは設定方法を示します: ```ts constructor() { diff --git a/docs/xplat/src/content/jp/components/grids/tree-grid/overview.mdx b/docs/xplat/src/content/jp/components/grids/tree-grid/overview.mdx index 7a812fbd0c..af2cfc9def 100644 --- a/docs/xplat/src/content/jp/components/grids/tree-grid/overview.mdx +++ b/docs/xplat/src/content/jp/components/grids/tree-grid/overview.mdx @@ -163,7 +163,7 @@ export class AppModule {} ### 初期展開時の深さ -初期時のツリー グリッドは、すべてのノード レベルを展開して表示します。この動作は `ExpansionDepth` プロパティを使用して構成できます。デフォルトの値は **Infinity** ですべてのノードが展開されます。初期時の展開の深さは、このプロパティを数値に設定して制御できます。たとえば、**0** はルート レベルのノードのみを表示し、**1** はルートレベルと子ノードを表示します。 +初期時のツリー グリッドは、すべてのノード レベルを展開して表示します。この動作は プロパティを使用して構成できます。デフォルトの値は **Infinity** ですべてのノードが展開されます。初期時の展開の深さは、このプロパティを数値に設定して制御できます。たとえば、**0** はルート レベルのノードのみを表示し、**1** はルートレベルと子ノードを表示します。 ### 子コレクション @@ -236,7 +236,7 @@ public class EmployeesItem -それでは、`Data` コレクションをインポートし、それをツリー グリッドにバインドすることから始めましょう。 +それでは、 コレクションをインポートし、それをツリー グリッドにバインドすることから始めましょう。 @@ -282,7 +282,7 @@ public class EmployeesItem ツリー グリッドで階層を構築するには、その `childDataKey` プロパティに、各データ オブジェクトで使用される子コレクションの名前を設定する必要があります。このサンプルでは **Employees** コレクションです。 更に自動列生成を無効にしてデータ オブジェクトの実際のプロパティとの一致を手動で定義できます。**Employees** コレクションが階層で自動的に使用されるため、列定義に含める必要はありません。 -ツリーグリッドにおいて、`RowSelection` を使用し、`Paginator` 要素を追加することで、行選択機能とページング機能を有効にできるようになりました。 +ツリーグリッドにおいて、 を使用し、 要素を追加することで、行選択機能とページング機能を有効にできるようになりました。 最初の列に集計機能、各列にはフィルタリング、ソート、編集、サイズ変更機能を有効にします。 @@ -318,7 +318,7 @@ public class EmployeesItem -最後に、`GridToolbar`、`GridToolbarHiding`、`GridToolbarPinning`、`GridToolbarExporter` をそれぞれ使用して、列の非表示、列のピン固定、エクスポート機能、およびツリー グリッドのツールバーを有効にできます。 +最後に、 をそれぞれ使用して、列の非表示、列のピン固定、エクスポート機能、およびツリー グリッドのツールバーを有効にできます。 @@ -409,9 +409,9 @@ const data = [ ``` -上記のサンプル データでは、すべてのレコードに ID、ParentID、および Name、JobTitle、Age などの追加プロパティがあります。前述のように、レコードの ID は一意である必要があります。これが `PrimaryKey` になります。ParentID には親ノードの ID が含まれており、`ForeignKey` として設定できます。行にツリー グリッドのいずれの行にも一致しない ParentID がある場合、行がルート行であることを意味します。 +上記のサンプル データでは、すべてのレコードに ID、ParentID、および Name、JobTitle、Age などの追加プロパティがあります。前述のように、レコードの ID は一意である必要があります。これが になります。ParentID には親ノードの ID が含まれており、 として設定できます。行にツリー グリッドのいずれの行にも一致しない ParentID がある場合、行がルート行であることを意味します。 -親子関係は、ツリー グリッドの `PrimaryKey` プロパティと `ForeignKey` プロパティを使用して構成されます。 +親子関係は、ツリー グリッドの プロパティと プロパティを使用して構成されます。 上記フラット コレクションで定義されたデータを表示するツリー グリッドを設定する方法を示すコンポーネントのテンプレートです。 @@ -486,8 +486,8 @@ const data = [ ツリー グリッド セルのインデントは、フィルタリング、ソート、ページングなど他のツリー グリッド全体の機能で永続化されます。 - `Sorting` が列に適用された際にデータ行がレベルごとにソートされます。ルートレベルの行はそれぞれの子に関係なく個々に並べ替えられます。各子コレクションは個々に並べ替えられます。 -- 最初の列 (`VisibleIndex` が 0 の列) は常にツリー列です。 -- 列のピン固定、列の非表示、列の移動などの処理後に `VisibleIndex` が 0 になる列はツリー列になります。 +- 最初の列 ( が 0 の列) は常にツリー列です。 +- 列のピン固定、列の非表示、列の移動などの処理後に が 0 になる列はツリー列になります。 - エクスポートした Excel ワークシートは、ツリー グリッドでグループ化されるときにレコードをグループ化して階層に反映できます。すべてのレコードを展開した状態が保持および反映されます。 - CSV レベルにエクスポートする際に展開した状態は無視されてすべてのデータがフラットでエクスポートされます。 @@ -525,7 +525,7 @@ const data = [


-
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/grids/tree.mdx b/docs/xplat/src/content/jp/components/grids/tree.mdx index a3ba2f890c..190603eae0 100644 --- a/docs/xplat/src/content/jp/components/grids/tree.mdx +++ b/docs/xplat/src/content/jp/components/grids/tree.mdx @@ -19,7 +19,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; エンドユーザーにとって、これは、さまざまなアプリ ページ間を簡単にナビゲートし、選択、チェックボックスを使用し、テキスト、アイコン、画像などを追加できることを意味します。 -{ProductName} ツリー コンポーネントを使用すると、ユーザーはツリービュー構造で階層データを表現し、親子関係を維持したり、対応するデータ モデルなしで静的ツリービュー構造を定義したりできます。その主な目的は、エンドユーザーが階層データ構造内を視覚化してナビゲートできるようにすることです。`Tree` コンポーネントは、ロードオンデマンド機能、項目のアクティブ化、組み込みのチェックボックス、組み込みのキーボード ナビゲーションなどによる項目の複数のカスケード選択も提供します。 +{ProductName} ツリー コンポーネントを使用すると、ユーザーはツリービュー構造で階層データを表現し、親子関係を維持したり、対応するデータ モデルなしで静的ツリービュー構造を定義したりできます。その主な目的は、エンドユーザーが階層データ構造内を視覚化してナビゲートできるようにすることです。 コンポーネントは、ロードオンデマンド機能、項目のアクティブ化、組み込みのチェックボックス、組み込みのキーボード ナビゲーションなどによる項目の複数のカスケード選択も提供します。 ## {Platform} ツリーの例 @@ -46,7 +46,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -`Tree` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```ts import { defineComponents, IgcTreeComponent } from 'igniteui-webcomponents'; @@ -70,7 +70,7 @@ defineComponents(IgcTreeComponent); npm install igniteui-react ``` -次に、以下のように、`Tree` と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrTree, IgrTreeItem } from 'igniteui-react'; @@ -86,7 +86,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -また、追加の CSS ファイルをリンクして、スタイルを `Tree` コンポーネントに適用する必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **BlazorServer** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **BlazorServer** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -108,11 +108,11 @@ builder.Services.AddIgniteUIBlazor(
-`Tree` の使用を開始する最も簡単な方法は次のとおりです: + の使用を開始する最も簡単な方法は次のとおりです: ### ツリーの宣言 -`TreeItem` は、`Tree` に属するすべての項の表現です。 -項目は、`Disabled`、`Active`、`Selected`、および `Expanded` プロパティを提供します。これにより、要件に応じて項目の状態を構成できます。 + は、 に属するすべての項の表現です。 +項目は、、および プロパティを提供します。これにより、要件に応じて項目の状態を構成できます。 `value` プロパティを使用して、項目が表すデータ エントリへの参照を追加できます。 @@ -160,7 +160,7 @@ builder.Services.AddIgniteUIBlazor( - 静的な非バインド項目を作成してツリーを宣言します。 -ツリーを描画するために、必ずしもデータ セットは必要ありません。公開された `Label` プロパティを使用して、基になるデータ モデルなしで個々の項目を作成したり、`TreeItem` ラベルのカスタム スロット コンテンツを提供したりできます。 +ツリーを描画するために、必ずしもデータ セットは必要ありません。公開された プロパティを使用して、基になるデータ モデルなしで個々の項目を作成したり、 ラベルのカスタム スロット コンテンツを提供したりできます。 @@ -221,14 +221,14 @@ builder.Services.AddIgniteUIBlazor( -提供されている `indentation`、`indicator`、および `label` スロットを使用して、`TreeItem` のインデント、拡張、およびラベル領域ごとにカスタム スロット コンテンツを提供できます。 +提供されている `indentation`、`indicator`、および `label` スロットを使用して、 のインデント、拡張、およびラベル領域ごとにカスタム スロット コンテンツを提供できます。 ### 項目のインタラクション -`TreeItem` は展開または折り畳むことができます。 + は展開または折り畳むことができます。 - 項目の展開インジケーター *(デフォルトの動作)* をクリックします。 -- `Tree` の `ToggleNodeOnClick` プロパティが **true** に設定されている場合、項目をクリックします。 +- プロパティが **true** に設定されている場合、項目をクリックします。 @@ -247,7 +247,7 @@ builder.Services.AddIgniteUIBlazor( -デフォルトでは、複数の項目を同時に展開できます。この動作を変更し、一度に 1 つのブランチのみを展開できるようにするには、`SingleBranchExpand` プロパティを有効にします。このようにして、項目が展開されると、同じレベル内ですでに展開されている他のすべてのブランチが縮小されます。 +デフォルトでは、複数の項目を同時に展開できます。この動作を変更し、一度に 1 つのブランチのみを展開できるようにするには、 プロパティを有効にします。このようにして、項目が展開されると、同じレベル内ですでに展開されている他のすべてのブランチが縮小されます。 @@ -269,7 +269,7 @@ builder.Services.AddIgniteUIBlazor( -`Tree` は、項目のインタラクションのために次の API メソッドを提供します: + は、項目のインタラクションのために次の API メソッドを提供します: - `Tree.Expand` - すべての項目を展開します。項目配列が渡されると、指定された項目のみが展開されます。 - `Tree.Collapse` - すべての項目を縮小します。項目配列が渡されると、指定された項目のみが縮小されます。 @@ -281,15 +281,15 @@ builder.Services.AddIgniteUIBlazor( ## {Platform} ツリーの選択 -{ProductName} ツリー コンポーネントで項目の選択を設定するには、その `Selection` プロパティを設定する必要があります。このプロパティは、次の 3 つのモードを受け入れます: **None**、**Multiple** および **Cascade**。以下で、それぞれについて詳しく説明します。 +{ProductName} ツリー コンポーネントで項目の選択を設定するには、その プロパティを設定する必要があります。このプロパティは、次の 3 つのモードを受け入れます: **None**、**Multiple** および **Cascade**。以下で、それぞれについて詳しく説明します。 ### None -`Tree` では、デフォルトで項目の選択が無効になっています。ユーザーは UI インタラクションを介して項目を選択または選択解除することはできませんが、これらのアクションは提供された API メソッドを介して実行できます。 + では、デフォルトで項目の選択が無効になっています。ユーザーは UI インタラクションを介して項目を選択または選択解除することはできませんが、これらのアクションは提供された API メソッドを介して実行できます。 ### Multiple -`Tree` で複数の項目を選択できるようにするには、`Selection` プロパティを **multiple** に設定するだけです。これにより、すべての項目のチェックボックスが表示されます。各項目には、選択されているまたは選択されていないの 2 つの状態があります。このモードは複数選択をサポートします。 + で複数の項目を選択できるようにするには、 プロパティを **multiple** に設定するだけです。これにより、すべての項目のチェックボックスが表示されます。各項目には、選択されているまたは選択されていないの 2 つの状態があります。このモードは複数選択をサポートします。 @@ -318,7 +318,7 @@ builder.Services.AddIgniteUIBlazor( ### Cascade -`Tree` カスケード項目の選択を有効にするには、selection プロパティを **cascade** に設定するだけです。これにより、すべての項目のチェックボックスが表示されます。 + カスケード項目の選択を有効にするには、selection プロパティを **cascade** に設定するだけです。これにより、すべての項目のチェックボックスが表示されます。 @@ -349,9 +349,9 @@ builder.Services.AddIgniteUIBlazor( このモードでは、親の選択状態はその子の選択状態に完全に依存します。親に選択された子と選択解除された子がある場合、そのチェックボックスは不確定な状態になります。 ## キーボード ナビゲーション -`Tree` のキーボード ナビゲーションは、ユーザーにさまざまなキーボード インタラクションを提供します。この機能はデフォルトで有効になっており、ユーザーは項目間を移動できます。 + のキーボード ナビゲーションは、ユーザーにさまざまなキーボード インタラクションを提供します。この機能はデフォルトで有効になっており、ユーザーは項目間を移動できます。 -`Tree` ナビゲーションは、W3C アクセシビリティ標準に準拠しており、使いやすいです。 + ナビゲーションは、W3C アクセシビリティ標準に準拠しており、使いやすいです。 **キーの組み合わせ** @@ -391,7 +391,7 @@ builder.Services.AddIgniteUIBlazor( ユーザーが展開アイコンをクリックすると、ロード アイコンに変わります。Loading プロパティが false に解決されると、読み込みインジケーターが消え、子が読み込まれます。 -`loadingIndicator` スロットを使用して、読み込み領域にカスタム スロット コンテンツを提供できます。そのようなスロットが定義されていない場合、`CircularProgress` が使用されます。 +`loadingIndicator` スロットを使用して、読み込み領域にカスタム スロット コンテンツを提供できます。そのようなスロットが定義されていない場合、 が使用されます。 ### 仮想化によるロード オン デマンド @@ -405,7 +405,7 @@ builder.Services.AddIgniteUIBlazor( ## スタイル設定 -以下にリストされている公開された CSS パーツのいくつかを使用して、`TreeItem` の外観を変更できます: +以下にリストされている公開された CSS パーツのいくつかを使用して、 の外観を変更できます: | パーツ名 | 説明 | | ---------|------------ | @@ -418,7 +418,7 @@ builder.Services.AddIgniteUIBlazor( | `text` | ツリー項目の表示テキスト。 | | `select` | 選択が有効になっている場合のツリー項目のチェックボックス。 | -これらの CSS パーツを使用して、次のように `Tree` コンポーネントの外観をカスタマイズできます: +これらの CSS パーツを使用して、次のように コンポーネントの外観をカスタマイズできます: ```css igc-tree-item { @@ -435,10 +435,10 @@ igc-tree-item { ## API リファレンス -
-
+
+

-
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/chip.mdx b/docs/xplat/src/content/jp/components/inputs/chip.mdx index 95672aec0a..e4456ee1b9 100644 --- a/docs/xplat/src/content/jp/components/inputs/chip.mdx +++ b/docs/xplat/src/content/jp/components/inputs/chip.mdx @@ -239,7 +239,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbChipModule)); ### Prefix / Suffix (プレフィックス / サフィックス) - コンポーネントの `Prefix` と `Suffix` の部分とそれらのスロットを使用して、Chip のメイン コンテンツの前後に異なるコンテンツを追加できます。デフォルトの選択アイコンと削除アイコンが用意されていますが、`Select` スロットと `Remove` スロットを使用してカスタマイズできます。`Start` スロットと `End` スロットを使用して、メイン コンテンツの前後にコンテンツを追加できます。 + コンポーネントの `Prefix` と `Suffix` の部分とそれらのスロットを使用して、Chip のメイン コンテンツの前後に異なるコンテンツを追加できます。デフォルトの選択アイコンと削除アイコンが用意されていますが、 スロットと `Remove` スロットを使用してカスタマイズできます。`Start` スロットと `End` スロットを使用して、メイン コンテンツの前後にコンテンツを追加できます。 diff --git a/docs/xplat/src/content/jp/components/inputs/circular-progress.mdx b/docs/xplat/src/content/jp/components/inputs/circular-progress.mdx index 913d8f29b3..c8861293e1 100644 --- a/docs/xplat/src/content/jp/components/inputs/circular-progress.mdx +++ b/docs/xplat/src/content/jp/components/inputs/circular-progress.mdx @@ -86,7 +86,7 @@ IgrCircularProgressModule.register(); builder.Services.AddIgniteUIBlazor(typeof(IgbCircularProgressModule)); ``` -また、追加の CSS ファイルをリンクして、スタイルを `Calendar` コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -149,7 +149,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbCircularProgressModule)); ### 不確定のプログレス -正確に決定されていないプロセスをトラックしたい場合、`Indeterminate` プロパティを設定できます。また、`HideLabel` プロパティを設定することで、{ProductName} `CircularProgress` のデフォルトのラベルを非表示にし、公開された `LabelFormat` プロパティを介して進行状況インジケーターのデフォルトのラベルをカスタマイズできます。 +正確に決定されていないプロセスをトラックしたい場合、 プロパティを設定できます。また、 プロパティを設定することで、{ProductName} のデフォルトのラベルを非表示にし、公開された プロパティを介して進行状況インジケーターのデフォルトのラベルをカスタマイズできます。 ```tsx diff --git a/docs/xplat/src/content/jp/components/inputs/color-editor.mdx b/docs/xplat/src/content/jp/components/inputs/color-editor.mdx index 726a169da1..8fcad7522e 100644 --- a/docs/xplat/src/content/jp/components/inputs/color-editor.mdx +++ b/docs/xplat/src/content/jp/components/inputs/color-editor.mdx @@ -34,7 +34,7 @@ npm install {PackageCore} npm install {PackageInputs} ``` - を使用する前に、次のモジュールを登録する必要があります: +`ColorEditor` を使用する前に、次のモジュールを登録する必要があります: @@ -110,7 +110,7 @@ ModuleManager.register( ## 使用方法 - の使用を開始する最も簡単な方法は次のとおりです: +`ColorEditor` の使用を開始する最も簡単な方法は次のとおりです: @@ -219,7 +219,7 @@ public onValueChanged(calendar: IgrColorEditor, e: IgrColorEditorPanelSelectedVa ## API リファレンス -
+`ColorEditor`
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/combo/features.mdx b/docs/xplat/src/content/jp/components/inputs/combo/features.mdx index 46d4a907ff..919ab94b01 100644 --- a/docs/xplat/src/content/jp/components/inputs/combo/features.mdx +++ b/docs/xplat/src/content/jp/components/inputs/combo/features.mdx @@ -18,14 +18,14 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; {ProductName} コンボボックス コンポーネントは、フィルタリングやグループ化などのいくつかの機能を公開しています。 ## コンボボックス機能の例 -以下のデモは、ランタイムで有効または無効にできるいくつかの `Combo` 機能を示しています。 +以下のデモは、ランタイムで有効または無効にできるいくつかの 機能を示しています。 -このサンプルでは、`Switch` コンポーネントを使用するため、コンボと一緒にインポートする必要があります。 +このサンプルでは、 コンポーネントを使用するため、コンボと一緒にインポートする必要があります。 @@ -52,7 +52,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbComboModule)); builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule)); ``` -また、追加の CSS ファイルをリンクして、スタイルを `Switch` コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -184,7 +184,7 @@ switchDisable.addEventListener("igcChange", () => { -グループ化は、`GroupKey` プロパティを対応するデータ ソース フィールドに設定することで有効/無効になることに注意してください。 +グループ化は、 プロパティを対応するデータ ソース フィールドに設定することで有効/無効になることに注意してください。 @@ -255,7 +255,7 @@ groupKey={groupingEnabled ? "country" : undefined} #### フィルタリング オプション -{ProductName} は、`FilterKey` オプションと `CaseSensitive` オプションの両方の構成を渡すことができるフィルター プロパティをもう 1 つ公開しています。`FilterKey` は、オプションのリストをフィルタリングするためにどのデータ ソース フィールドを使用する必要があるかを示します。`CaseSensitive` オプションは、フィルタリングで大文字と小文字を区別するかどうかを示します。 +{ProductName} は、`FilterKey` オプションと `CaseSensitive` オプションの両方の構成を渡すことができるフィルター プロパティをもう 1 つ公開しています。`FilterKey` は、オプションのリストをフィルタリングするためにどのデータ ソース フィールドを使用する必要があるかを示します。`CaseSensitive` オプションは、フィルタリングで大文字と小文字を区別するかどうかを示します。 次のコード スニペットは、名前ではなく国でデータ ソースから都市をフィルター処理する方法を示しています。また、デフォルトで大文字と小文字を区別するフィルタリングを行います。 @@ -293,7 +293,7 @@ const options = { ### グループ化 - オプションを定義すると、キーに基づいて項目をグループ化します。 + オプションを定義すると、キーに基づいて項目をグループ化します。 @@ -320,7 +320,7 @@ const options = { -`GroupKey` プロパティは、データ ソースが複雑なオブジェクトで構成されている場合にのみ有効です。 + プロパティは、データ ソースが複雑なオブジェクトで構成されている場合にのみ有効です。 #### ソートの方向 @@ -353,7 +353,7 @@ const options = { ### ラベル - ラベルは、 プロパティを使用して簡単に設定できます。 + ラベルは、 プロパティを使用して簡単に設定できます。 @@ -523,7 +523,7 @@ required プロパティを設定することで、コンボボックスを必 ## API リファレンス -
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/combo/overview.mdx b/docs/xplat/src/content/jp/components/inputs/combo/overview.mdx index b9cd36a76a..1bdebcc438 100644 --- a/docs/xplat/src/content/jp/components/inputs/combo/overview.mdx +++ b/docs/xplat/src/content/jp/components/inputs/combo/overview.mdx @@ -38,7 +38,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -`Combo` コンポーネントを使用する前に、追加のコンポーネントおよび必要な CSS とともに登録する必要があります: + コンポーネントを使用する前に、追加のコンポーネントおよび必要な CSS とともに登録する必要があります: ```ts import { defineComponents, IgcComboComponent } @@ -59,7 +59,7 @@ defineComponents(IgcComboComponent); -`Combo` コンポーネントの使用を開始するには、最初にそのモジュールを登録する必要があります。 + コンポーネントの使用を開始するには、最初にそのモジュールを登録する必要があります。 ```razor @@ -68,7 +68,7 @@ defineComponents(IgcComboComponent); builder.Services.AddIgniteUIBlazor(typeof(IgbComboModule)); ``` -スタイルを `Combo` コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります。 +スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります。 ```razor @@ -88,7 +88,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbComboModule)); npm install igniteui-react ``` -次に、以下のように、{Platform} `Combo` と必要な CSS をインポートする必要があります: +次に、以下のように、{Platform} と必要な CSS をインポートする必要があります: ```tsx import { IgrCombo } from 'igniteui-react'; @@ -100,7 +100,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Combo` コンポーネントは標準の `` 要素では機能しません。代わりに `Form` を使用してください。 + コンポーネントは標準の `` 要素では機能しません。代わりに `Form` を使用してください。 次に、オプションのリストを構築するコンボ データ ソースに、オブジェクトの配列をバインドします。 @@ -201,20 +201,20 @@ const cities: City[] = [ コンボは複雑なデータ (オブジェクト) の配列にバインドされている場合、コントロールが項目の選択を処理するために使用するプロパティを指定する必要があります。コンポーネントは以下のプロパティを公開します: -- `T` - *必須。 が省略されている場合は、これを 「object」 に設定する必要があります。それ以外の場合は、 のプロパティ タイプと一致する必要があります。 -- - オプション、複雑なデータ オブジェクトに**必須** - データ ソースのどのフィールドを選択に使用するかを決定します。 が省略された場合、選択 API はオブジェクト参照を使用して項目を選択します。 -- - オプション、複雑なデータ オブジェクトに**推奨** - データ ソース内のどのフィールドが表示値として使用されるかを決定します。 に値が指定されていない場合、コンボは指定された (存在する場合) を使用します。 -この例では、コンボで各都市の `name` を表示し、項目の選択と各項目の基礎となる値として `id` フィールドを使用するようにします。したがって、これらのプロパティをコンボの にそれぞれ提供します。 +- `T` - *必須。 が省略されている場合は、これを 「object」 に設定する必要があります。それ以外の場合は、 のプロパティ タイプと一致する必要があります。 +- - オプション、複雑なデータ オブジェクトに**必須** - データ ソースのどのフィールドを選択に使用するかを決定します。 が省略された場合、選択 API はオブジェクト参照を使用して項目を選択します。 +- - オプション、複雑なデータ オブジェクトに**推奨** - データ ソース内のどのフィールドが表示値として使用されるかを決定します。 に値が指定されていない場合、コンボは指定された (存在する場合) を使用します。 +この例では、コンボで各都市の `name` を表示し、項目の選択と各項目の基礎となる値として `id` フィールドを使用するようにします。したがって、これらのプロパティをコンボの にそれぞれ提供します。 -データ ソースがプリミティブ型 (例: `strings`、`numbers` など) で構成されている場合、`ValueKey` や `DisplayKey` を**指定しないでください**。 +データ ソースがプリミティブ型 (例: `strings`、`numbers` など) で構成されている場合、 を**指定しないでください**。 ### 値の設定 ComboBox コンポーネントは、属性 (値とも呼ばれます) に加えて、 ゲッターとセッターを公開します。value 属性を使用して、コンポーネントの初期化時に選択した項目を設定できます。 -値 (現在選択されている項目のリスト) を読み取る場合、または値を更新する場合は、それぞれ値ゲッターとセッターを使用します。値ゲッターは、`ValueKey` で表される選択されたすべての項目のリストを返します。同様に、値セッターを使用して選択した項目のリストを更新する場合は、`ValueKey` によって項目のリストを提供する必要があります。 +値 (現在選択されている項目のリスト) を読み取る場合、または値を更新する場合は、それぞれ値ゲッターとセッターを使用します。値ゲッターは、 で表される選択されたすべての項目のリストを返します。同様に、値セッターを使用して選択した項目のリストを更新する場合は、 によって項目のリストを提供する必要があります。 例: @@ -250,7 +250,7 @@ comboRef.current.value = ['NY01', 'UK01']; コンボ コンポーネントは、現在選択されている項目を変更できる API を公開します。 -ユーザーの操作によってオプションのリストから項目を選択する以外に、プログラムで項目を選択することもできます。これは、 および メソッドを介して行われます。項目の配列をこれらのメソッドに渡すことができます。メソッドが引数なしで呼び出された場合、呼び出されたメソッドに応じて、すべての項目が選択 / 選択解除されます。コンボ コンポーネントに を指定した場合は、選択 / 選択解除する項目の値キーを渡す必要があります。 +ユーザーの操作によってオプションのリストから項目を選択する以外に、プログラムで項目を選択することもできます。これは、 および メソッドを介して行われます。項目の配列をこれらのメソッドに渡すことができます。メソッドが引数なしで呼び出された場合、呼び出されたメソッドに応じて、すべての項目が選択 / 選択解除されます。コンボ コンポーネントに を指定した場合は、選択 / 選択解除する項目の値キーを渡す必要があります。 #### 一部の項目を選択 / 選択解除: @@ -356,7 +356,7 @@ comboRef.current.deselect([]);
-`ValueKey` プロパティを省略した場合は、オブジェクト参照として選択 / 選択解除する項目を列挙する必要があります。 + プロパティを省略した場合は、オブジェクト参照として選択 / 選択解除する項目を列挙する必要があります。 @@ -393,8 +393,8 @@ comboRef.current.deselect([cities[1], cities[5]]); {ProductName} Combo コンポーネントは、 など、ほとんどの プロパティをサポートしています。このコンポーネントは、その検証にバインドされた 2 つのメソッドも公開しています。 -- `ReportValidity` - 有効性をチェックし、コンポーネントが検証の制約を満たしている場合は true を返します。 -- `CheckValidity` - ネイティブ入力 API に準拠するための reportValidity のラッパー。 +- - 有効性をチェックし、コンポーネントが検証の制約を満たしている場合は true を返します。 +- - ネイティブ入力 API に準拠するための reportValidity のラッパー。 ## キーボード ナビゲーション @@ -413,7 +413,7 @@ comboRef.current.deselect([cities[1], cities[5]]); ## スタイル設定 - コンポーネントとその項目の外観は、以下に示す公開 CSS パーツを使用して変更できます。 + コンポーネントとその項目の外観は、以下に示す公開 CSS パーツを使用して変更できます。 | パーツ名 | 説明 | | -------------------- | ------------------------------------------------------------------------------- | @@ -469,7 +469,7 @@ igc-combo::part(toggle-icon) { ## API リファレンス -
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/date-time-input.mdx b/docs/xplat/src/content/jp/components/inputs/date-time-input.mdx index 3b5f8a7baf..ed779e31c0 100644 --- a/docs/xplat/src/content/jp/components/inputs/date-time-input.mdx +++ b/docs/xplat/src/content/jp/components/inputs/date-time-input.mdx @@ -134,7 +134,7 @@ input.value = date; 文字列は、`YYYY-MM-DDTHH:mm:ss.sssZ` の形式の完全な `ISO` 文字列にすることも、日付のみと時間のみのパーツに分割することもできます。 #### 日付のみ -日付のみの文字列がコンポーネントの プロパティにバインドされている場合は、`YYYY-MM-DD` の形式である必要があります。 は、入力に値を入力するときに引き続き使用され、同じ形式である必要はありません。さらに、日付のみの文字列をバインドする場合、ディレクティブは時刻を `T00:00:00` に強制することにより、時刻のずれを防ぎます。 +日付のみの文字列がコンポーネントの プロパティにバインドされている場合は、`YYYY-MM-DD` の形式である必要があります。 は、入力に値を入力するときに引き続き使用され、同じ形式である必要はありません。さらに、日付のみの文字列をバインドする場合、ディレクティブは時刻を `T00:00:00` に強制することにより、時刻のずれを防ぎます。 #### 時刻のみ 時刻のみの文字列は通常、`ECMA` 仕様では定義されていませんが、時刻のみのソリューションを必要とするシナリオにディレクティブを統合できるようにするために、24 時間形式 (`HH:mm:ss`) をサポートしています。12 時間形式はサポートされていません。 @@ -168,10 +168,10 @@ input.value = date; は、さまざまな表示形式と入力形式をサポートしています。 -[Intl.DateTimeFormat](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) を使用して、`long` と `short`、`medium` と `full` などの事前定義された書式オプションをサポートできるようにします。さらに、`dd-MM-yy` などのサポートされている文字から構築されたカスタム文字列を受け入れることもできます。また、 が指定されていない場合、コンポーネントは をそのまま使用します。 +[Intl.DateTimeFormat](https://developer.mozilla.org/ja/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat) を使用して、`long` と `short`、`medium` と `full` などの事前定義された書式オプションをサポートできるようにします。さらに、`dd-MM-yy` などのサポートされている文字から構築されたカスタム文字列を受け入れることもできます。また、 が指定されていない場合、コンポーネントは をそのまま使用します。 ### 入力書式 -次の表は、コンポーネントの でサポートされている形式を示しています。 +次の表は、コンポーネントの でサポートされている形式を示しています。 |書式|説明| |-------|----------| @@ -189,7 +189,7 @@ input.value = date; | `mm` | 先行ゼロが明示的に設定された分。 | | `tt` | 12 時間形式の AM/PM セクション。 | -特定の入力形式を設定するには、それを文字列として に渡します。これにより、予想されるユーザー入力形式と `mask` の両方が設定されます。さらに、 はロケール ベースであるため、何も指定されていない場合、エディターはデフォルトで `dd/MM/yyyy` になります。 +特定の入力形式を設定するには、それを文字列として に渡します。これにより、予想されるユーザー入力形式と `mask` の両方が設定されます。さらに、 はロケール ベースであるため、何も指定されていない場合、エディターはデフォルトで `dd/MM/yyyy` になります。 @@ -325,7 +325,7 @@ input.min = new Date(2021, 0, 1); は、公開な メソッドと メソッドを公開します。現在設定されている日付と時刻の特定の `DatePart` を増減し、いくつかの方法で使用できます。 -最初のシナリオでは、特定の DatePart がメソッドに渡されない場合、指定した `InputFormat` および内部コンポーネントの実装に基づいてデフォルトの DatePart が増減します。2 番目のシナリオでは、さまざまな要件を満たすために操作する DatePart を明示的に指定できます。また、どちらのメソッドも、stepUp/stepDown ステップを設定するために使用できるタイプ番号のオプションの `delta` パラメーターを受け入れます。 +最初のシナリオでは、特定の DatePart がメソッドに渡されない場合、指定した および内部コンポーネントの実装に基づいてデフォルトの DatePart が増減します。2 番目のシナリオでは、さまざまな要件を満たすために操作する DatePart を明示的に指定できます。また、どちらのメソッドも、stepUp/stepDown ステップを設定するために使用できるタイプ番号のオプションの `delta` パラメーターを受け入れます。 diff --git a/docs/xplat/src/content/jp/components/inputs/dropdown.mdx b/docs/xplat/src/content/jp/components/inputs/dropdown.mdx index 25cae33b8a..700b23c6ed 100644 --- a/docs/xplat/src/content/jp/components/inputs/dropdown.mdx +++ b/docs/xplat/src/content/jp/components/inputs/dropdown.mdx @@ -127,7 +127,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDropdownModule)); ### Target (ターゲット) -{Platform} ドロップダウン リストは、ターゲットに対して相対的に配置されます。`target` スロットを使用すると、クリック時に `open` プロパティを切り替える組み込みコンポーネントを提供できます。場合によっては、外部ターゲットを使用するか、別のイベントを使用してドロップダウンの開始を切り替えることができます。これは、ターゲットをパラメーターとして提供できる `Show`、`Hide`、および `Toggle` メソッドを使用して実現できます。デフォルトでは、ドロップダウン リストは CSS の `absolute` 位置を使用します。ターゲット要素が固定コンテナー内にあるが、ドロップダウンがそうではない場合、{Platform} ドロップダウンの を `fixed` に設定する必要があります。ドロップダウン リストは、その内容に基づいて自動的にサイズ変更されます。リストの幅をターゲットと同じにする場合は、 プロパティを **true** に設定する必要があります。 +{Platform} ドロップダウン リストは、ターゲットに対して相対的に配置されます。`target` スロットを使用すると、クリック時に `open` プロパティを切り替える組み込みコンポーネントを提供できます。場合によっては、外部ターゲットを使用するか、別のイベントを使用してドロップダウンの開始を切り替えることができます。これは、ターゲットをパラメーターとして提供できる 、および メソッドを使用して実現できます。デフォルトでは、ドロップダウン リストは CSS の `absolute` 位置を使用します。ターゲット要素が固定コンテナー内にあるが、ドロップダウンがそうではない場合、{Platform} ドロップダウンの を `fixed` に設定する必要があります。ドロップダウン リストは、その内容に基づいて自動的にサイズ変更されます。リストの幅をターゲットと同じにする場合は、 プロパティを **true** に設定する必要があります。 @@ -136,7 +136,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDropdownModule)); ### 位置 -{Platform} ドロップダウンの優先配置は、 プロパティを使用して設定できます。ドロップダウンのデフォルトの配置は `bottom-start` です。`Flip` プロパティは、指定された配置でドロップダウンを表示するのに十分なスペースがない場合に配置を反転するかどうかを決定します。{Platform} ドロップダウン リストからそのターゲットまでの距離は、 プロパティを使用して指定できます。 +{Platform} ドロップダウンの優先配置は、 プロパティを使用して設定できます。ドロップダウンのデフォルトの配置は `bottom-start` です。 プロパティは、指定された配置でドロップダウンを表示するのに十分なスペースがない場合に配置を反転するかどうかを決定します。{Platform} ドロップダウン リストからそのターゲットまでの距離は、 プロパティを使用して指定できます。 @@ -145,7 +145,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDropdownModule)); ### 選択 -ユーザーが項目を選択すると、 は `Change` イベントを発行します。ドロップダウンの `Select` メソッドを使用すると、インデックスまたは値で項目を選択できます。 +ユーザーが項目を選択すると、 は `Change` イベントを発行します。ドロップダウンの メソッドを使用すると、インデックスまたは値で項目を選択できます。 ### Item (項目) @@ -176,7 +176,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDropdownModule)); ### Scroll Strategy (スクロール方法) -`ScrollStrategy` プロパティは、ターゲット要素のコンテナーをスクロールする際のコンポーネントの動作を決定します。デフォルト値は `scroll` です。これは、ドロップダウンがターゲットとともにスクロールされることを意味します。プロパティを `block` に設定すると、ドロップダウンが開いている場合にスクロールがブロックされます。プロパティを `close` ように設定することもできます。これは、スクロール時にドロップダウンが自動的に閉じられることを意味します。 + プロパティは、ターゲット要素のコンテナーをスクロールする際のコンポーネントの動作を決定します。デフォルト値は `scroll` です。これは、ドロップダウンがターゲットとともにスクロールされることを意味します。プロパティを `block` に設定すると、ドロップダウンが開いている場合にスクロールがブロックされます。プロパティを `close` ように設定することもできます。これは、スクロール時にドロップダウンが自動的に閉じられることを意味します。 ### Keep Open (開いたままにする) diff --git a/docs/xplat/src/content/jp/components/inputs/file-input.mdx b/docs/xplat/src/content/jp/components/inputs/file-input.mdx index a239f012d8..a90dce4a3a 100644 --- a/docs/xplat/src/content/jp/components/inputs/file-input.mdx +++ b/docs/xplat/src/content/jp/components/inputs/file-input.mdx @@ -24,7 +24,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 使用方法 - コンポーネントを使用すると、ユーザーはデバイスからファイルを選択し、Web アプリケーションにアップロードできます。選択されたファイルの名前が表示され、「Browse」 ボタンと 「No file chosen」 というテキストのカスタマイズ オプションが提供されます。このコンポーネントには、ニーズに合わせて動作をさらに構成するために使用できるプロパティ、メソッド、スロットも用意されています。 + コンポーネントを使用すると、ユーザーはデバイスからファイルを選択し、Web アプリケーションにアップロードできます。選択されたファイルの名前が表示され、「Browse」 ボタンと 「No file chosen」 というテキストのカスタマイズ オプションが提供されます。このコンポーネントには、ニーズに合わせて動作をさらに構成するために使用できるプロパティ、メソッド、スロットも用意されています。 ### 作業の開始 @@ -33,13 +33,13 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - コンポーネントの使用を開始するには、最初に次のコマンドを実行して Ignite UI for Web Components をインストールする必要があります。 + コンポーネントの使用を開始するには、最初に次のコマンドを実行して Ignite UI for Web Components をインストールする必要があります。 ```cmd npm install {PackageWebComponents} ``` -その後、次のように をインポートする必要があります。 +その後、次のように をインポートする必要があります。 ```ts import { defineComponents, IgcFileInputComponent } from 'igniteui-webcomponents'; @@ -51,7 +51,7 @@ defineComponents(IgcFileInputComponent); -これで、{Platform} の基本構成から始めることができます。 +これで、{Platform} の基本構成から始めることができます。 @@ -67,17 +67,17 @@ defineComponents(IgcFileInputComponent); ### プロパティ - コンポーネントには、特定の要件に基づいて動作を構成できるさまざまなプロパティが用意されています。これらのプロパティを使用すると、入力の機能、外観、検証を制御できます。 + コンポーネントには、特定の要件に基づいて動作を構成できるさまざまなプロパティが用意されています。これらのプロパティを使用すると、入力の機能、外観、検証を制御できます。 -- `Value` - ファイル入力フィールドの現在の値を設定します。 -- `Disabled` - ファイル入力を無効にして、ユーザーによる操作を防止します。 -- `Required` - 入力を必須としてマークします。ファイルが選択されない限り、フォームの送信はブロックされます。 -- `Invalid` - 入力値が無効であることを示し、視覚的なエラー状態をトリガーするために使用されます。 +- - ファイル入力フィールドの現在の値を設定します。 +- - ファイル入力を無効にして、ユーザーによる操作を防止します。 +- - 入力を必須としてマークします。ファイルが選択されない限り、フォームの送信はブロックされます。 +- - 入力値が無効であることを示し、視覚的なエラー状態をトリガーするために使用されます。 - `Multiple` - 複数のファイルを選択できます。 - `Accept` - 選択できるファイル タイプを定義します。このプロパティの値は、ファイル形式のコンマ区切りのリストである必要があります (例: .jpg, .png, .gif)。 -- `Autofocus` - ページが読み込まれると、ファイル入力フィールドに自動的にフォーカスを当てます。 -- `Label` - ファイル入力要素に関連付けられたラベル テキストを設定します。 -- `Placeholder` - ファイルが選択されていない場合に表示されるプレースホルダー テキストを提供します。 +- - ページが読み込まれると、ファイル入力フィールドに自動的にフォーカスを当てます。 +- - ファイル入力要素に関連付けられたラベル テキストを設定します。 +- - ファイルが選択されていない場合に表示されるプレースホルダー テキストを提供します。 @@ -95,16 +95,16 @@ defineComponents(IgcFileInputComponent); ### メソッド -構成可能なプロパティに加えて、 コンポーネントから継承された コンポーネントで使用できる 4 つの便利なメソッドがあります。 +構成可能なプロパティに加えて、 コンポーネントから継承された コンポーネントで使用できる 4 つの便利なメソッドがあります。 - `Focus` - ファイル入力要素にフォーカスを設定します。 - `Blur` - ファイル入力要素からフォーカスを削除します。 -- `ReportValidity` - 入力の有効性をチェックし、入力が無効な場合は検証メッセージを表示します。 -- `SetCustomValidity` - カスタム検証メッセージを設定します。提供されたメッセージが空でない場合、入力は無効 (invalid) としてマークされます。 +- - 入力の有効性をチェックし、入力が無効な場合は検証メッセージを表示します。 +- - カスタム検証メッセージを設定します。提供されたメッセージが空でない場合、入力は無効 (invalid) としてマークされます。 ### スロット - コンポーネントは、外観と動作をカスタマイズするために使用できるいくつかのスロットも公開します。 + コンポーネントは、外観と動作をカスタマイズするために使用できるいくつかのスロットも公開します。 - `prefix` と `suffix` - メイン入力エリアの前後にコンテンツを挿入できます。 - `helper-text` - 入力の下にヒントまたは説明メッセージを表示します。書式設定のヒントやフィールドの要件など、追加のガイダンスを提供するのに役立ちます。 @@ -119,20 +119,20 @@ defineComponents(IgcFileInputComponent); ## 統合 - コンポーネントは、HTML フォーム要素とシームレスに統合されます。上記のメソッドとプロパティを使用すると、標準の HTML フォーム内での動作と検証を効果的に管理できます。 + コンポーネントは、HTML フォーム要素とシームレスに統合されます。上記のメソッドとプロパティを使用すると、標準の HTML フォーム内での動作と検証を効果的に管理できます。 ## 制限 - コンポーネントには現在次の制限があります。 + コンポーネントには現在次の制限があります。 - 「Browse」 ボタンと 「No file chosen」 メッセージのデフォルトの文字列は、自動的にローカライズされません。これらの文字列はすべてのロケールで同じままですが、適切なスロットまたはプレースホルダー バインディングを使用して手動でカスタマイズできます。 - ファイルは、`value` プロパティを通じて手動で設定することはできません。ファイルの選択はファイル ピッカー経由でのみ行うことができます。ただし、空の文字列 `''` を渡してフィールドをリセットすることはできます。 ## アクセシビリティと ARIA サポート - コンポーネントはフォーカス可能かつインタラクティブであり、キーボードとスクリーン リーダーの完全なアクセシビリティを保証します。コンポーネントには `label` 属性を使用してラベルを付けることができます。この属性はネイティブの ` - の使用を開始する最も簡単な方法は次のとおりです: + の使用を開始する最も簡単な方法は次のとおりです: @@ -142,14 +142,14 @@ builder.Services.AddIgniteUIBlazor( - コンポーネントは標準の `` 要素では機能しません。代わりに `Form` を使用してください。 + コンポーネントは標準の `` 要素では機能しません。代わりに `Form` を使用してください。 ## 例 ### ラベル - に意味のあるラベルを付けるには、開始タグと終了タグの間にテキストを配置するだけです。 + に意味のあるラベルを付けるには、開始タグと終了タグの間にテキストを配置するだけです。 @@ -175,7 +175,7 @@ builder.Services.AddIgniteUIBlazor( -`label-position` 属性を設定することにより、 ボタンの前または後にラベルを配置するかどうかを指定できます。許可される値は、`before` と `after` (デフォルト) です。 +`label-position` 属性を設定することにより、 ボタンの前または後にラベルを配置するかどうかを指定できます。許可される値は、`before` と `after` (デフォルト) です。 @@ -201,7 +201,7 @@ builder.Services.AddIgniteUIBlazor( - には、ラジオの外部の要素でラベルを付けることもできます。この場合、ユーザーはニーズに応じてラベルの位置とスタイルを完全に制御できます。 + には、ラジオの外部の要素でラベルを付けることもできます。この場合、ユーザーはニーズに応じてラベルの位置とスタイルを完全に制御できます。 @@ -458,7 +458,7 @@ builder.Services.AddIgniteUIBlazor( ## スタイル設定 -`Radio` コンポーネントは、いくつかの CSS パーツ (`base`、`control`、および `label`) を公開して、スタイルを完全に制御できるようにします。 + コンポーネントは、いくつかの CSS パーツ (`base`、`control`、および `label`) を公開して、スタイルを完全に制御できるようにします。 ```css igc-radio::part(control) { @@ -488,7 +488,7 @@ igc-radio::part(label) {
-
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/rating.mdx b/docs/xplat/src/content/jp/components/inputs/rating.mdx index 4e7382c07e..9965eb13b3 100644 --- a/docs/xplat/src/content/jp/components/inputs/rating.mdx +++ b/docs/xplat/src/content/jp/components/inputs/rating.mdx @@ -50,7 +50,7 @@ npm install igniteui-react
-`Rating` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: @@ -62,7 +62,7 @@ npm install igniteui-react builder.Services.AddIgniteUIBlazor(typeof(IgbRatingModule)); ``` -また、`Rating` コンポーネントにスタイルを適用するために、追加の CSS ファイルをリンクする必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、 コンポーネントにスタイルを適用するために、追加の CSS ファイルをリンクする必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -100,7 +100,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Rating` の使用を開始する最も簡単な方法は次のとおりです: + の使用を開始する最も簡単な方法は次のとおりです: @@ -139,7 +139,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; ## カスタム シンボルの使用 - コンポーネントを使用すると、デフォルトの星シンボルの代わりにカスタム シンボルを使用できます。SVG、アイコン、または別の Unicode シンボルなどの別のシンボルを使用する場合は、 の開く括弧と閉じる括弧の間に コンポーネントを配置する必要があります。 + コンポーネントを使用すると、デフォルトの星シンボルの代わりにカスタム シンボルを使用できます。SVG、アイコン、または別の Unicode シンボルなどの別のシンボルを使用する場合は、 の開く括弧と閉じる括弧の間に コンポーネントを配置する必要があります。 @@ -371,7 +371,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`HoverPreview` 属性により、ホバー時にユーザー選択の可能な結果がコンポーネントに表示されます。選択した値が何であるかについて即座にフィードバックしたい場合に便利です。 + 属性により、ホバー時にユーザー選択の可能な結果がコンポーネントに表示されます。選択した値が何であるかについて即座にフィードバックしたい場合に便利です。 @@ -387,7 +387,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; ### Read-Only (読み取り専用) - 属性を使用すると、ユーザーは を読み取り専用モードで設定できます。この属性は、コンポーネントを情報提供のみを目的として使用する場合に役立ちます。 + 属性を使用すると、ユーザーは を読み取り専用モードで設定できます。この属性は、コンポーネントを情報提供のみを目的として使用する場合に役立ちます。 ### Disabled (無効) @@ -409,7 +409,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Rating` コンポーネントは、`igcHover` と `igcChange` の 2 つの個別のイベントを発行します。 + コンポーネントは、`igcHover` と `igcChange` の 2 つの個別のイベントを発行します。 @@ -418,7 +418,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Rating` コンポーネントは、`Hover` と `Change` の 2 つの個別のイベントを発行します。 + コンポーネントは、`Hover` と `Change` の 2 つの個別のイベントを発行します。 @@ -427,7 +427,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Rating` コンポーネントは、`hover` と `change` の 2 つの個別のイベントを発行します。 + コンポーネントは、`hover` と `change` の 2 つの個別のイベントを発行します。 @@ -492,7 +492,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; ## スタイル設定 - コンポーネントは、その内部要素のほとんどすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します。 + コンポーネントは、その内部要素のほとんどすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します。 |名前|説明| |--|--| @@ -520,7 +520,7 @@ igc-rating::part(empty) { ## API リファレンス -
+

## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/ripple.mdx b/docs/xplat/src/content/jp/components/inputs/ripple.mdx index 8488492b75..2449147d8f 100644 --- a/docs/xplat/src/content/jp/components/inputs/ripple.mdx +++ b/docs/xplat/src/content/jp/components/inputs/ripple.mdx @@ -34,7 +34,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -`Ripple` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```ts import { defineComponents, IgcRippleComponent } from "igniteui-webcomponents"; @@ -58,7 +58,7 @@ defineComponents(IgcRippleComponent); npm install igniteui-react ``` -次に、以下のように、`Ripple` と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrRipple } from 'igniteui-react'; @@ -73,7 +73,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Ripple` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```razor @@ -82,7 +82,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; builder.Services.AddIgniteUIBlazor(typeof(IgbRippleModule)); ``` -また、追加の CSS ファイルをリンクして、スタイルを `Ripple` コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -92,7 +92,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbRippleModule));
- の使用を開始する最も簡単な方法は次のとおりです: + の使用を開始する最も簡単な方法は次のとおりです: @@ -127,7 +127,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbRippleModule)); -CSS `position` プロパティが `static` 以外の値に設定されている限り、任意の Web 要素に を追加できます。 +CSS `position` プロパティが `static` 以外の値に設定されている限り、任意の Web 要素に を追加できます。 ## 例 @@ -148,7 +148,7 @@ igc-ripple {
-
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/select.mdx b/docs/xplat/src/content/jp/components/inputs/select.mdx index 0d8d045539..1219bb837d 100644 --- a/docs/xplat/src/content/jp/components/inputs/select.mdx +++ b/docs/xplat/src/content/jp/components/inputs/select.mdx @@ -38,7 +38,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -`Select` コンポーネントを使用する前に、追加のコンポーネントとともに登録する必要があります: + コンポーネントを使用する前に、追加のコンポーネントとともに登録する必要があります: ```ts import { @@ -62,7 +62,7 @@ defineComponents(IgcSelectComponent); -`Select` コンポーネントを使用する前に、追加のコンポーネントとともに登録する必要があります: + コンポーネントを使用する前に、追加のコンポーネントとともに登録する必要があります: ```razor // in Program.cs file @@ -70,7 +70,7 @@ defineComponents(IgcSelectComponent); builder.Services.AddIgniteUIBlazor(typeof(IgbSelectModule)); ``` -スタイルを `Select` コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -91,7 +91,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbSelectModule)); npm install igniteui-react ``` -次に、以下のように、`Select` および `SelectItem` と必要な CSS をインポートする必要があります: +次に、以下のように、 および と必要な CSS をインポートする必要があります: ```tsx import { IgrSelect, IgrSelectItem } from 'igniteui-react'; @@ -346,8 +346,8 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; 選択がフォーカスされ、オプションのリストが**表示されていない**場合: -- ALT + の組み合わせを使用するか、SPACE または ENTER キーをクリックして、`Select` を開きます。 -- ALT + または の組み合わせ、または ENTERSPACEESC、`Tab` キーのいずれかを使用して、`Select` を閉じます。 +- ALT + の組み合わせを使用するか、SPACE または ENTER キーをクリックして、 を開きます。 +- ALT + または の組み合わせ、または ENTERSPACEESC キーのいずれかを使用して、 を閉じます。 - キーを使用すると、リスト内の前の項目が選択されます。 - キーを使用すると、リスト内の次の項目が選択されます。 - HOME キーまたは END キーを使用すると、リストの最初または最後の項目が選択されます。 @@ -361,7 +361,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; - HOME キーまたは END キーを使用すると、リストの最初または最後の項目がアクティブになります。 -`Select` コンポーネントは、項目の**単一**選択のみをサポートします。 + コンポーネントは、項目の**単一**選択のみをサポートします。 diff --git a/docs/xplat/src/content/jp/components/inputs/slider.mdx b/docs/xplat/src/content/jp/components/inputs/slider.mdx index b0df67fd49..414f8587cb 100644 --- a/docs/xplat/src/content/jp/components/inputs/slider.mdx +++ b/docs/xplat/src/content/jp/components/inputs/slider.mdx @@ -35,7 +35,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -`Slider` と `RangeSlider` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```ts import { defineComponents, IgcSliderComponent, IgcRangeSliderComponent } from "igniteui-webcomponents"; @@ -60,7 +60,7 @@ defineComponents(IgcSliderComponent, IgcRangeSliderComponent); npm install igniteui-react ``` -次に、以下のように、`Slider` および `RangeSlider` と必要な CSS をインポートする必要があります: +次に、以下のように、 および と必要な CSS をインポートする必要があります: ```tsx import { IgrSlider, IgrRangeSlider } from 'igniteui-react'; @@ -74,7 +74,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Slider` と `RangeSlider` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```razor @@ -90,7 +90,7 @@ builder.Services.AddIgniteUIBlazor( -`Slider` と `RangeSlider` の使用を開始する最も簡単な方法は次のとおりです: + の使用を開始する最も簡単な方法は次のとおりです: @@ -124,7 +124,7 @@ builder.Services.AddIgniteUIBlazor( スライダーと範囲スライダー コンポーネントの主な違いは、スライダー コンポーネントには単一のつまみがあり、範囲スライダー コンポーネントには 2 つのつまみがあることです。スライダー コンポーネントの単一のつまみで、その プロパティが表示されます。範囲スライダー コンポーネントの 2 つのつまみは、 値と 値のプロパティを表示します。 -いずれかの値が変更されると、両方のスライダーが 2 つのイベントを発行します。`Input` イベントは、キーボードまたはドラッグ操作を使用して値が変更されるたびに発行され、`Change` イベントは、値の変更がドラッグエンドまたはキーボード操作でコミットされたときに発行されます。 +いずれかの値が変更されると、両方のスライダーが 2 つのイベントを発行します。 イベントは、キーボードまたはドラッグ操作を使用して値が変更されるたびに発行され、`Change` イベントは、値の変更がドラッグエンドまたはキーボード操作でコミットされたときに発行されます。 @@ -145,7 +145,7 @@ builder.Services.AddIgniteUIBlazor( ### 制約 -スライダーのトラックには、最小値と最大値があり、 プロパティを使用して構成されます。さらに、 プロパティと プロパティを使用して、つまみのドラッグを制限できます。 +スライダーのトラックには、最小値と最大値があり、 プロパティを使用して構成されます。さらに、 プロパティと プロパティを使用して、つまみのドラッグを制限できます。 @@ -154,14 +154,14 @@ builder.Services.AddIgniteUIBlazor( ### Step (ステップ) - プロパティは、値が順守するスライダーの精度を指定します。デフォルトでは、スライダー トラックは連続して見えます。スライダーの プロパティを **true** に設定すると、トラックのステップが表示されます。 + プロパティは、値が順守するスライダーの精度を指定します。デフォルトでは、スライダー トラックは連続して見えます。スライダーの プロパティを **true** に設定すると、トラックのステップが表示されます。 -`Step` プロパティが `0` に設定されている場合、ステッピングは暗黙指定されず、スライダー範囲内の任意の値が許可されます。この場合、`DiscreteTrack` が **true** に設定されていても、スライダーは連続して見えます。 + プロパティが `0` に設定されている場合、ステッピングは暗黙指定されず、スライダー範囲内の任意の値が許可されます。この場合、 が **true** に設定されていても、スライダーは連続して見えます。 ### Tick Marks (目盛り) @@ -183,7 +183,7 @@ builder.Services.AddIgniteUIBlazor( ### Value Format (値の形式) -つまみと目盛りのラベル値をを書式設定する場合、スライダーは `ValueFormat`、`ValueFormatOptions`、および `Locale` プロパティを提供します。`ValueFormatOptions` を使用すると、指定された `Locale` を考慮して、小数部と有効桁数、スタイル (10 進数、通貨、パーセント、単位)、表記などを指定できます。`ValueFormat` は、書式設定オプションが適用された値に置き換えられる `{0}` 識別子を含む可能性のある文字列です。 +つまみと目盛りのラベル値をを書式設定する場合、スライダーは 、および プロパティを提供します。 を使用すると、指定された を考慮して、小数部と有効桁数、スタイル (10 進数、通貨、パーセント、単位)、表記などを指定できます。 は、書式設定オプションが適用された値に置き換えられる `{0}` 識別子を含む可能性のある文字列です。 @@ -192,7 +192,7 @@ builder.Services.AddIgniteUIBlazor( ### ラベル -場合によっては、スライダーの値を文字列値として書式設定する必要があります。つまり、値 **[0, 1, 2]** を **['Low', 'Medium', 'High']** にマップします。このシナリオでは、スライダーを使用して、スライダー内に `SliderLabel` 要素を定義できます。スライダー ラベルのテキスト コンテンツは、つまみラベルと目盛りラベルに使用されます。スライダー ラベルが提供されている場合、`Min`、`Max`、および `Step` プロパティが自動的に計算されるため、提供されたラベルにマップされない値は許可されないことに注意してください。'Low'、'Medium'、および 'High' ラベルの場合、`Min` は `0` に設定され、`Max` は `2` に設定され、`Step` は `1` に設定されます。 +場合によっては、スライダーの値を文字列値として書式設定する必要があります。つまり、値 **[0, 1, 2]** を **['Low', 'Medium', 'High']** にマップします。このシナリオでは、スライダーを使用して、スライダー内に 要素を定義できます。スライダー ラベルのテキスト コンテンツは、つまみラベルと目盛りラベルに使用されます。スライダー ラベルが提供されている場合、、および プロパティが自動的に計算されるため、提供されたラベルにマップされない値は許可されないことに注意してください。'Low'、'Medium'、および 'High' ラベルの場合、 は `0` に設定され、 は `2` に設定され、 は `1` に設定されます。 @@ -201,7 +201,7 @@ builder.Services.AddIgniteUIBlazor( ## スタイル設定 - コンポーネントは、その内部要素のほとんどすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します。 + コンポーネントは、その内部要素のほとんどすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します。 |名|説明| |--|--| @@ -228,9 +228,9 @@ builder.Services.AddIgniteUIBlazor( ## API リファレンス -
-
-
+
+
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/switch.mdx b/docs/xplat/src/content/jp/components/inputs/switch.mdx index 081602519a..503cf23468 100644 --- a/docs/xplat/src/content/jp/components/inputs/switch.mdx +++ b/docs/xplat/src/content/jp/components/inputs/switch.mdx @@ -27,7 +27,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 使用方法 - コンポーネントにより、オン/オフ状態を切り替えることができます。デフォルトのスタイル設定はマテリアル デザイン ガイドラインの選択コントロールの仕様に基づきます。 + コンポーネントにより、オン/オフ状態を切り替えることができます。デフォルトのスタイル設定はマテリアル デザイン ガイドラインの選択コントロールの仕様に基づきます。 @@ -39,7 +39,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -次に、以下のように、`Switch` と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```ts import { defineComponents, IgcSwitchComponent } from "igniteui-webcomponents"; @@ -64,7 +64,7 @@ defineComponents(IgcSwitchComponent); npm install igniteui-react ``` -次に、以下のように、`Switch` と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrSwitch } from 'igniteui-react'; @@ -88,7 +88,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule)); ``` -また、追加の CSS ファイルをリンクして、スタイルを `Switch` コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -98,7 +98,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule)); -`Switch` の使用を開始する最も簡単な方法は次のとおりです: + の使用を開始する最も簡単な方法は次のとおりです: @@ -125,7 +125,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule)); -`Switch` コンポーネントは標準の `` 要素では機能しません。代わりに `Form` を使用してください。 + コンポーネントは標準の `` 要素では機能しません。代わりに `Form` を使用してください。 ## 例 @@ -362,7 +362,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule)); ## スタイル設定 - コンポーネントは、いくつかの CSS パーツを公開して、スタイルを完全に制御できるようにします。 + コンポーネントは、いくつかの CSS パーツを公開して、スタイルを完全に制御できるようにします。 |名前|説明| |--|--| @@ -390,7 +390,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbSwitchModule)); ## API リファレンス -
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/inputs/tooltip.mdx b/docs/xplat/src/content/jp/components/inputs/tooltip.mdx index a3fb984699..228090789b 100644 --- a/docs/xplat/src/content/jp/components/inputs/tooltip.mdx +++ b/docs/xplat/src/content/jp/components/inputs/tooltip.mdx @@ -29,13 +29,13 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; -`Tooltip` の使用を開始するには、最初に次のコマンドを実行して Ignite UI for Web Components をインストールする必要があります。 + の使用を開始するには、最初に次のコマンドを実行して Ignite UI for Web Components をインストールする必要があります。 ```cmd npm install {PackageWebComponents} ``` -次に、以下のように、`Tooltip` とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: +次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: ```ts import { defineComponents, IgcTooltipComponent } from 'igniteui-webcomponents'; @@ -53,13 +53,13 @@ defineComponents(IgcTooltipComponent); -`Tooltip` の使用を開始するには、最初に次のコマンドを実行して Ignite UI for React をインストールする必要があります。 + の使用を開始するには、最初に次のコマンドを実行して Ignite UI for React をインストールする必要があります。 ```cmd npm install igniteui-react ``` -次に、以下のように、`Tooltip` とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: +次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: ```tsx import { IgrTooltip } from 'igniteui-react'; @@ -75,7 +75,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Tooltip` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```razor // in Program.cs file @@ -83,7 +83,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; builder.Services.AddIgniteUIBlazor(typeof(IgbTooltipModule)); ``` -また、`Tooltip` コンポーネントにスタイルを適用するために、追加の CSS ファイルをリンクする必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、 コンポーネントにスタイルを適用するために、追加の CSS ファイルをリンクする必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -95,7 +95,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbTooltipModule)); {ProductName} の完全な概要については、[「作業の開始」](../general-getting-started.md)トピックを参照してください。 -これで、{Platform} `Tooltip` の基本構成から始めることができます。 +これで、{Platform} の基本構成から始めることができます。 @@ -137,7 +137,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbTooltipModule)); ### ツールチップ ターゲット -目的の要素にツールチップを添付するには、 プロパティを使用し、それをターゲット要素の ID に設定します。 +目的の要素にツールチップを添付するには、 プロパティを使用し、それをターゲット要素の ID に設定します。 @@ -227,7 +227,7 @@ tooltip.anchor = anchor; ### ツールチップのコンテンツ -ツールチップのコンテンツは、 の開始タグと終了タグの間にカスタム コンテンツを配置することによって定義されます。 +ツールチップのコンテンツは、 の開始タグと終了タグの間にカスタム コンテンツを配置することによって定義されます。 @@ -263,7 +263,7 @@ tooltip.anchor = anchor; -あるいは、単純なテキストを設定するには、 プロパティを使用できます。 +あるいは、単純なテキストを設定するには、 プロパティを使用できます。 @@ -288,7 +288,7 @@ tooltip.anchor = anchor; -両方の方法 (スロット化されたコンテンツと プロパティ) を使用する場合、スロット化されたコンテンツが優先され、 値は無視されます。 +両方の方法 (スロット化されたコンテンツと プロパティ) を使用する場合、スロット化されたコンテンツが優先され、 値は無視されます。 @@ -319,19 +319,19 @@ tooltip.anchor = anchor; -この例では、スロット化されたコンテンツ「I will be shown!」が `Message` プロパティ値の代わりに表示されます。 +この例では、スロット化されたコンテンツ「I will be shown!」が プロパティ値の代わりに表示されます。 -`Tooltip` のコンテンツは単なるテキスト以上のものになります。ツールチップはマークアップ内の通常の要素であるため、必要な要素を追加し、それに応じてスタイルを設定することで、そのコンテンツを強化できます。 + のコンテンツは単なるテキスト以上のものになります。ツールチップはマークアップ内の通常の要素であるため、必要な要素を追加し、それに応じてスタイルを設定することで、そのコンテンツを強化できます。 ### 設定の表示/非表示 - を表示および非表示にする前の遅延を制御する場合は、 プロパティと プロパティを使用できます。どちらのプロパティも、時間をミリ秒単位で表す数値を受け入れます。 + を表示および非表示にする前の遅延を制御する場合は、 プロパティと プロパティを使用できます。どちらのプロパティも、時間をミリ秒単位で表す数値を受け入れます。 @@ -364,18 +364,18 @@ tooltip.anchor = anchor; -Tooltip API メソッド () では、 プロパティと プロパティが考慮されないことに注意することが重要です。呼び出されるとすぐに動作します。 +Tooltip API メソッド () では、 プロパティと プロパティが考慮されないことに注意することが重要です。呼び出されるとすぐに動作します。 ### 配置 - は、ターゲット要素を基準にして簡単に配置することもできます。必要なのは、 プロパティと PopoverPlacement のいずれかの配置オプションとともに使用するだけです。 + は、ターゲット要素を基準にして簡単に配置することもできます。必要なのは、 プロパティと PopoverPlacement のいずれかの配置オプションとともに使用するだけです。 - プロパティが設定されていない場合、デフォルト値は `Bottom` となり、 はターゲット要素の下に配置されます。 + プロパティが設定されていない場合、デフォルト値は `Bottom` となり、 はターゲット要素の下に配置されます。 -さらに、 プロパティを使用して を固定することができます。これにより、閉じるボタンが追加され、ユーザーが閉じるボタンをクリックするか、`Esc` キーを押して手動で閉じるまで、 が表示されたままになります。この動作はデフォルトのホバー動作をオーバーライドし、ユーザーがターゲット要素上でホバーを停止したときに が消えないようにします。 +さらに、 プロパティを使用して を固定することができます。これにより、閉じるボタンが追加され、ユーザーが閉じるボタンをクリックするか、`Esc` キーを押して手動で閉じるまで、 が表示されたままになります。この動作はデフォルトのホバー動作をオーバーライドし、ユーザーがターゲット要素上でホバーを停止したときに が消えないようにします。 - には、 プロパティを介して構成できるオプションの矢印インジケータも含まれています。矢印はツールチップをその anchor 要素に視覚的に接続し、その配置はツールチップの に基づいて自動的に調整されます。 + には、 プロパティを介して構成できるオプションの矢印インジケータも含まれています。矢印はツールチップをその anchor 要素に視覚的に接続し、その配置はツールチップの に基づいて自動的に調整されます。 @@ -410,58 +410,58 @@ Tooltip API メソッド ( -次の例では、すべてのツールチップの配置オプション、矢印の配置動作、および `Sticky` プロパティの動作のデモを見ることができます。 +次の例では、すべてのツールチップの配置オプション、矢印の配置動作、および プロパティの動作のデモを見ることができます。 ### トリガー -デフォルトでは、 はターゲット要素の上にマウスを移動したときにのみトリガーされます。ただし、 プロパティと プロパティを使用してこの動作を変更し、 が表示されるタイミングと消えるタイミングを制御できます。これらのプロパティは、`click`、`focus`、`keypress` などのイベント名を値として受け入れ、さまざまなシナリオで をトリガーできるようにします。 +デフォルトでは、 はターゲット要素の上にマウスを移動したときにのみトリガーされます。ただし、 プロパティと プロパティを使用してこの動作を変更し、 が表示されるタイミングと消えるタイミングを制御できます。これらのプロパティは、`click`、`focus`、`keypress` などのイベント名を値として受け入れ、さまざまなシナリオで をトリガーできるようにします。 ### 高度な例 -`Tooltip` は他のコンポーネントとシームレスに統合され、内部にコンポーネントを含む高度なツールチップを作成できます。 -次の例では、`List`、`Avatar`、`Icon`、`Badge`、`Button`、`Card`、および `CategoryChart` コンポーネントを使用して説明的なツールチップを作成する方法を示しています。 + は他のコンポーネントとシームレスに統合され、内部にコンポーネントを含む高度なツールチップを作成できます。 +次の例では、、および コンポーネントを使用して説明的なツールチップを作成する方法を示しています。 ### 追加のプロパティ -これまでに説明したプロパティの他に、 コンポーネントには、動作、配置、外観をさらに構成できるさまざまな追加プロパティが用意されています。 +これまでに説明したプロパティの他に、 コンポーネントには、動作、配置、外観をさらに構成できるさまざまな追加プロパティが用意されています。 |名前|タイプ|説明| |--|--|--| -| `Open` | boolean | ツールチップの表示/非表示を決定します。 | -| `WithArrow` | boolean | ツールチップの矢印インジケーターをレンダリングするかどうかを決定します。 | -| `Offset` | number | ツールチップとその `Anchor` 間のピクセル距離を設定します。 | +| | boolean | ツールチップの表示/非表示を決定します。 | +| | boolean | ツールチップの矢印インジケーターをレンダリングするかどうかを決定します。 | +| | number | ツールチップとその 間のピクセル距離を設定します。 | ### メソッド -構成可能なプロパティに加えて、 では次の 3 つのメソッドも使用できます。 +構成可能なプロパティに加えて、 では次の 3 つのメソッドも使用できます。 |名前|説明| |--|--| -| `Show` | ツールチップが表示されていない場合は表示します。ターゲットが指定されている場合は、ターゲットを一時的な `Anchor` として設定します。 | -| `Hide` | ツールチップがまだ非表示になっていない場合は非表示にします。 | -| `Toggle` | ツールチップの表示状態と非表示状態を切り替えます。 | +| | ツールチップが表示されていない場合は表示します。ターゲットが指定されている場合は、ターゲットを一時的な として設定します。 | +| | ツールチップがまだ非表示になっていない場合は非表示にします。 | +| | ツールチップの表示状態と非表示状態を切り替えます。 | ## アクセシビリティと ARIA サポート - はアクセシビリティを考慮して構築されており、次の ARIA 属性が含まれています。 + はアクセシビリティを考慮して構築されており、次の ARIA 属性が含まれています。 -- `role` - ツールチップがデフォルトの動作になっている場合、`role="tooltip"` が適用されます。 プロパティが有効な場合、ロールは `status` に変更されます。 +- `role` - ツールチップがデフォルトの動作になっている場合、`role="tooltip"` が適用されます。 プロパティが有効な場合、ロールは `status` に変更されます。 - `inert` - 可視性に基づいて動的に切り替えられます。ツールチップが非表示になると、ツールチップは非アクティブになります。 - `aria-atomic` - true に設定すると、ツールチップのコンテンツ全体が変更時に通知されるようになります。 - `aria-live` - polite に設定して、ユーザーがアイドル状態のときにのみ更新を通知することをスクリーン リーダーに示します。 ## スタイル設定 - コンポーネントは、スタイル設定に使用できる 2 つの CSS パーツを公開します。 + コンポーネントは、スタイル設定に使用できる 2 つの CSS パーツを公開します。 |名前|説明| |--|--| @@ -488,14 +488,14 @@ igc-tooltip::part(bottom) { ## API リファレンス -
-
-
-
-
+
+
+
+
+

-
-
+
+

## その他のリソース diff --git a/docs/xplat/src/content/jp/components/layouts/card.mdx b/docs/xplat/src/content/jp/components/layouts/card.mdx index 86b253ca62..3ab78434d6 100644 --- a/docs/xplat/src/content/jp/components/layouts/card.mdx +++ b/docs/xplat/src/content/jp/components/layouts/card.mdx @@ -219,18 +219,18 @@ defineComponents(IgcCardComponent );
-上記を確認することができます。まず、`h3` 見出しのように、要素をヘッダー タイトルとしてタグ付けする場合は、要素を `CardHeader` タグの間に配置し、そのスロット名を `title` に設定します。逆に、別の見出し要素を `subtitle` にしたい場合は、そのスロットに `subtitle` という名前を付けます。 +上記を確認することができます。まず、`h3` 見出しのように、要素をヘッダー タイトルとしてタグ付けする場合は、要素を タグの間に配置し、そのスロット名を `title` に設定します。逆に、別の見出し要素を `subtitle` にしたい場合は、そのスロットに `subtitle` という名前を付けます。 -カードに表示する画像や動画は、`CardMedia` タグで囲みます。`CardMedia` を使用すると、内部に配置されたコンテンツのサイズを変更して、要素のコンテンツ ボックス全体を埋めながらアスペクト比を維持できます。オブジェクトのアスペクト比がボックスのアスペクト比と一致しない場合、オブジェクトは収まるようにクリップされます。 +カードに表示する画像や動画は、 タグで囲みます。 を使用すると、内部に配置されたコンテンツのサイズを変更して、要素のコンテンツ ボックス全体を埋めながらアスペクト比を維持できます。オブジェクトのアスペクト比がボックスのアスペクト比と一致しない場合、オブジェクトは収まるようにクリップされます。 -`CardContent` タグ内には何でも配置できます。通常テキストが配置されます。 + タグ内には何でも配置できます。通常テキストが配置されます。 -最後に、`CardActions` は、ボタンなどのアクション可能な項目を配置する場所です。 +最後に、 は、ボタンなどのアクション可能な項目を配置する場所です。 ### メディア、サムネイル、アバター タイトルとサブタイトルの横のカード ヘッダーに画像またはアイコンを表示する場合は、要素のスロット プロパティを `thumbnail` に割り当てることで実行できます。 -上記のカードを例にとると、 の内容を編集し、`slot="thumbnail"` でアバターを追加できます。 +上記のカードを例にとると、 の内容を編集し、`slot="thumbnail"` でアバターを追加できます。 @@ -369,7 +369,7 @@ defineComponents(IgcCardComponent ); -追加の `div` 要素を使用して をバンドルし、それらを垂直方向に整列させ、`.card-horizontal` クラスをラッピング `div` 要素に適用して、カードの 2 つのセクションを水平方向に整列させます。 +追加の `div` 要素を使用して をバンドルし、それらを垂直方向に整列させ、`.card-horizontal` クラスをラッピング `div` 要素に適用して、カードの 2 つのセクションを水平方向に整列させます。 `.card-horizontal` クラスが適用されるスタイルは次のとおりです。 @@ -401,7 +401,7 @@ defineComponents(IgcCardComponent ); のレイアウトを使用すると、創造をさらに発展させることもできます。 -以下は、半水平カードを作成する方法を示す例です。このカードでは、カードのすべてのセクションが垂直に配置され、 が垂直セクションの横に表示されます。 +以下は、半水平カードを作成する方法を示す例です。このカードでは、カードのすべてのセクションが垂直に配置され、 が垂直セクションの横に表示されます。 @@ -582,7 +582,7 @@ defineComponents(IgcCardComponent ); ## スタイル設定 -カードはさまざまな要素をラップするコンテナであるため、スタイル設定は、その基本要素 (、および のサブコンポーネント) をスタイル設定することによって行われます。 +カードはさまざまな要素をラップするコンテナであるため、スタイル設定は、その基本要素 (、および のサブコンポーネント) をスタイル設定することによって行われます。 ```css igc-card { @@ -619,10 +619,10 @@ igc-icon-button::part(base) {

-
-
-
-
+
+
+
+



diff --git a/docs/xplat/src/content/jp/components/layouts/carousel.mdx b/docs/xplat/src/content/jp/components/layouts/carousel.mdx index 7a2bf51c80..9d01fa0fb0 100644 --- a/docs/xplat/src/content/jp/components/layouts/carousel.mdx +++ b/docs/xplat/src/content/jp/components/layouts/carousel.mdx @@ -150,7 +150,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbCarouselModule));
-スライドをデフォルトでアクティブにしたい場合は、`Active` 属性を使用します。 +スライドをデフォルトでアクティブにしたい場合は、 属性を使用します。 @@ -648,7 +648,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbCarouselModule)); ### 自動的なトランジション - は、ユーザーの操作なしでスライドを自動的に変更するように簡単に構成できます。この方法では、トランジション間隔 を プロパティに設定するだけで、スライドショーを作成できます。このプロパティは、スライド トランジション間の間隔 (ミリ秒)を決定します。 + は、ユーザーの操作なしでスライドを自動的に変更するように簡単に構成できます。この方法では、トランジション間隔 を プロパティに設定するだけで、スライドショーを作成できます。このプロパティは、スライド トランジション間の間隔 (ミリ秒)を決定します。 カルーセル コンテンツの上にマウスを移動するか、キーボード フォーカスをいずれかのカルーセル コンテンツに移動すると、自動トランジションが一時停止されます。マウスがカルーセルから離れるか、キーボード フォーカスがカルーセル コンテンツから移動すると、自動トランジションが再開されます。 @@ -694,7 +694,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbCarouselModule)); - プロパティを有効にします。 - プロパティを有効にします。 - プロパティを有効にします。 -- トランジション を追加します。 +- トランジション を追加します。 - 各スライドにカスタム を追加します。 カルーセル テンプレートは以下のようになります。 @@ -883,7 +883,7 @@ const images = [ - **属性** - [aria-roledescription](https://www.w3.org/TR/wai-aria-1.1/#aria-roledescription) を 「carousel」 に設定します。 - - [aria-live](https://www.w3.org/TR/wai-aria-1.1/#aria-live) - スクリーン リーダーがライブ リージョンの更新を処理する優先度を設定するために使用されます。可能な設定は **off** おとび **polite** です。デフォルト設定は **polite** であり、スライド セットのコンテナーとして機能する要素に設定されています。`Interval` オプションが設定され、カルーセルが再生状態の場合、**aria-live** 属性は **off** に設定されます。 + - [aria-live](https://www.w3.org/TR/wai-aria-1.1/#aria-live) - スクリーン リーダーがライブ リージョンの更新を処理する優先度を設定するために使用されます。可能な設定は **off** おとび **polite** です。デフォルト設定は **polite** であり、スライド セットのコンテナーとして機能する要素に設定されています。 オプションが設定され、カルーセルが再生状態の場合、**aria-live** 属性は **off** に設定されます。 - [aria-label](https://www.w3.org/TR/wai-aria/states_and_properties#aria-label) (ナビゲーション ボタン) - 「前のスライド」/「次のスライド」。 #### Slide コンポーネント diff --git a/docs/xplat/src/content/jp/components/layouts/dock-manager-customization.mdx b/docs/xplat/src/content/jp/components/layouts/dock-manager-customization.mdx index e67ece5bda..66fca20cb3 100644 --- a/docs/xplat/src/content/jp/components/layouts/dock-manager-customization.mdx +++ b/docs/xplat/src/content/jp/components/layouts/dock-manager-customization.mdx @@ -203,5 +203,5 @@ const splitPaneFixedSize: IgcSplitPane = { ## API リファレンス -
-
+
+
diff --git a/docs/xplat/src/content/jp/components/layouts/dock-manager-electron.mdx b/docs/xplat/src/content/jp/components/layouts/dock-manager-electron.mdx index 5347746c9b..c6b28dd9bc 100644 --- a/docs/xplat/src/content/jp/components/layouts/dock-manager-electron.mdx +++ b/docs/xplat/src/content/jp/components/layouts/dock-manager-electron.mdx @@ -39,7 +39,7 @@ import dockmanagerElectronApp from '@xplat-images/dockmanager-electron-app.gif'; ### ドラッグ アンド ドロップ -ブラウザー/アプリケーション ウィンドウの外側でのペインのドラッグをサポートするために、ブラウザー内のフローティング ペインを作成する組み込みのドラッグアンドドロップを、[HTML ドラッグアンドドロップ API](https://developer.mozilla.org/ja/docs/Web/API/HTML_Drag_and_Drop_API) に基づくカスタム実装に置き換えました。ヘッダー要素が DOM に接続されたときに発生する イベントと イベントにサブスクライブしました。ヘッダー要素が接続されると、組み込みの `DragService` をリセットし、`DragStart` および `DragEnd` イベント リスナーをアタッチします。 +ブラウザー/アプリケーション ウィンドウの外側でのペインのドラッグをサポートするために、ブラウザー内のフローティング ペインを作成する組み込みのドラッグアンドドロップを、[HTML ドラッグアンドドロップ API](https://developer.mozilla.org/ja/docs/Web/API/HTML_Drag_and_Drop_API) に基づくカスタム実装に置き換えました。ヘッダー要素が DOM に接続されたときに発生する `PaneHeaderConnected` イベントと `TabHeaderConnected` イベントにサブスクライブしました。ヘッダー要素が接続されると、組み込みの をリセットし、`DragStart` および `DragEnd` イベント リスナーをアタッチします。 @@ -62,7 +62,7 @@ dockManager.addEventListener('paneHeaderConnected', paneHeaderConnected); -`PaneHeaderDragStart` 関数で、ドック マネージャー コンポーネントの プロパティを設定し、ドラッグ操作が開始されたことを通知します。 +`PaneHeaderDragStart` 関数で、ドック マネージャー コンポーネントの プロパティを設定し、ドラッグ操作が開始されたことを通知します。 @@ -76,7 +76,7 @@ const paneHeaderDragStart = async (pane: IgcContentPane, event: DragEvent) => { -`document` 要素の `DragOver` と `drop` イベントにサブスクライブしました。`DragOver` リスナーでは、) プロパティを設定することにより、マウスがその上にドラッグされたことをドック マネージャーに通知します。これにより、ドック マネージャーはドッキング インジケーターを表示します。 +`document` 要素の `DragOver` と `drop` イベントにサブスクライブしました。`DragOver` リスナーでは、) プロパティを設定することにより、マウスがその上にドラッグされたことをドック マネージャーに通知します。これにより、ドック マネージャーはドッキング インジケーターを表示します。 ```ts const handleDocumentDragOver = (event: DragEvent) => { @@ -107,7 +107,7 @@ const paneHeaderDragEnd = async (event: DragEvent) => { } ``` -ペイン ヘッダーがドキュメント内にドロップされると、 メソッドが呼び出され、ドラッグされたペインがドロップされたことをドック マネージャーに通知します。ペインがドッキング インジケーターにドロップされた場合、メソッドは **true** を返します。ペインがドラッグ元と同じウィンドウにドロップされた場合、ペインは自動的に新しい位置にドッキングされます。ただし、別のウィンドウにドロップされた場合は、`droppedInAnotherWindow` 関数を呼び出します。この関数は、最初にソースのドック マネージャーからペインを削除してから、新しいペインに追加します。 +ペイン ヘッダーがドキュメント内にドロップされると、`DropPane` メソッドが呼び出され、ドラッグされたペインがドロップされたことをドック マネージャーに通知します。ペインがドッキング インジケーターにドロップされた場合、メソッドは **true** を返します。ペインがドラッグ元と同じウィンドウにドロップされた場合、ペインは自動的に新しい位置にドッキングされます。ただし、別のウィンドウにドロップされた場合は、`droppedInAnotherWindow` 関数を呼び出します。この関数は、最初にソースのドック マネージャーからペインを削除してから、新しいペインに追加します。 @@ -130,7 +130,7 @@ const handleDocumentDrop = async (event: DragEvent) => { -ペインが現在のウィンドウから削除されたら、 をドック マネージャー コンポーネントから削除し、レイアウトを更新する必要があります。 +ペインが現在のウィンドウから削除されたら、 をドック マネージャー コンポーネントから削除し、レイアウトを更新する必要があります。 @@ -176,7 +176,7 @@ mainWindow = new BrowserWindow({ ## API リファレンス -
-
-
-
+
+
+
+
diff --git a/docs/xplat/src/content/jp/components/layouts/dock-manager-embedding-frames.mdx b/docs/xplat/src/content/jp/components/layouts/dock-manager-embedding-frames.mdx index da641c2a8d..36a3b56a54 100644 --- a/docs/xplat/src/content/jp/components/layouts/dock-manager-embedding-frames.mdx +++ b/docs/xplat/src/content/jp/components/layouts/dock-manager-embedding-frames.mdx @@ -74,4 +74,4 @@ this.dockManager.layout = { ## API リファレンス -
+
diff --git a/docs/xplat/src/content/jp/components/layouts/dock-manager-updating-panes.mdx b/docs/xplat/src/content/jp/components/layouts/dock-manager-updating-panes.mdx index 779e776a74..3ed634be10 100644 --- a/docs/xplat/src/content/jp/components/layouts/dock-manager-updating-panes.mdx +++ b/docs/xplat/src/content/jp/components/layouts/dock-manager-updating-panes.mdx @@ -73,4 +73,4 @@ this.dockManager.layout = { ## API リファレンス -
+
diff --git a/docs/xplat/src/content/jp/components/layouts/dock-manager.mdx b/docs/xplat/src/content/jp/components/layouts/dock-manager.mdx index 880bb5108b..1aa57adfd2 100644 --- a/docs/xplat/src/content/jp/components/layouts/dock-manager.mdx +++ b/docs/xplat/src/content/jp/components/layouts/dock-manager.mdx @@ -24,7 +24,7 @@ Infragistics {Platform} Dock Manager は、ペインでアプリケーション ## {Platform} ドック マネージャーの例 -この例は、アプリケーションで使用できる のほとんどの機能とドッキング オプションを示しています。 +この例は、アプリケーションで使用できる のほとんどの機能とドッキング オプションを示しています。 @@ -79,7 +79,7 @@ defineComponents(IgcDockManagerComponent); ドック マネージャー コンポーネントは ShadowDOM とスロットを使用するため、Internet Explorer 11 および Edge 18 以前 (Chromium 以外のバージョン) などの古いブラウザーではサポートされません。
-ドック マネージャーにはペインのレイアウトを説明する プロパティがあります。レイアウトの定義するには、 プロパティを設定し、子ペインを追加します。以下は、単一のコンテンツ ペインでレイアウトを定義する方法です。 +ドック マネージャーにはペインのレイアウトを説明する プロパティがあります。レイアウトの定義するには、 プロパティを設定し、子ペインを追加します。以下は、単一のコンテンツ ペインでレイアウトを定義する方法です。 ```ts @@ -127,7 +127,7 @@ this.dockManager.layout = { ``` -ペインのコンテンツをロードするために、ドック マネージャーは[スロット](https://developer.mozilla.org/ja-JP/docs/Web/HTML/Element/slot)を使用します。コンテンツ要素の [slot](https://developer.mozilla.org/ja-JP/docs/Web/HTML/Global_attributes/slot) 属性はレイアウト構成のコンテンツ ペインの `ContentId` と一致する必要があります。エンドユーザーがペインのサイズを変更する場合は、予測可能な応答のために、コンテンツ要素の幅と高さを **100%** に設定することを強くお勧めします。 +ペインのコンテンツをロードするために、ドック マネージャーは[スロット](https://developer.mozilla.org/ja-JP/docs/Web/HTML/Element/slot)を使用します。コンテンツ要素の [slot](https://developer.mozilla.org/ja-JP/docs/Web/HTML/Global_attributes/slot) 属性はレイアウト構成のコンテンツ ペインの と一致する必要があります。エンドユーザーがペインのサイズを変更する場合は、予測可能な応答のために、コンテンツ要素の幅と高さを **100%** に設定することを強くお勧めします。 ```html @@ -146,12 +146,12 @@ this.dockManager.layout = { ドック マネージャーは複数の pane types を定義します。 -- -- -- -- +- +- +- +- -各タイプのペインには `Size` プロパティがあります。親の方向に応じて、サイズはペインの幅または高さに影響します。ペインのサイズはその兄弟ペインのサイズに相対し、デフォルトは 100 です。2 つの兄弟ペインがあり、最初のペインのサイズが 200 に設定され、2 番目のペインのサイズが 100 に設定されている場合、最初のペインは 2 番目のペインの 2 倍のサイズになり、これら 2 つのペインが使用可能なスペースをすべて埋めてしまいます。親の絶対サイズが 900px の場合、それぞれ 600px と 300px にサイズ設定されます。特定のペインのサイズをピクセル単位で指定する場合は、使用可能なすべてのスペースの相対的な配分に依存するのではなく、親の分割ペインの `useFixedSize` を設定する必要があります。 +各タイプのペインには プロパティがあります。親の方向に応じて、サイズはペインの幅または高さに影響します。ペインのサイズはその兄弟ペインのサイズに相対し、デフォルトは 100 です。2 つの兄弟ペインがあり、最初のペインのサイズが 200 に設定され、2 番目のペインのサイズが 100 に設定されている場合、最初のペインは 2 番目のペインの 2 倍のサイズになり、これら 2 つのペインが使用可能なスペースをすべて埋めてしまいます。親の絶対サイズが 900px の場合、それぞれ 600px と 300px にサイズ設定されます。特定のペインのサイズをピクセル単位で指定する場合は、使用可能なすべてのスペースの相対的な配分に依存するのではなく、親の分割ペインの `useFixedSize` を設定する必要があります。 For more information on this refer to [Split Panes Fixed Size Mode](dock-manager-customization.md#split-panes-fixed-size-mode) topic. @@ -170,7 +170,7 @@ this.dockManager.layout = { ### コンテンツ ペイン - ヘッダーとコンテンツを含むペインを表します。スプリットされたペインまたはタブ グループ ペイン内でホストできます。以下はコンテンツ ペインの定義方法です。 + ヘッダーとコンテンツを含むペインを表します。スプリットされたペインまたはタブ グループ ペイン内でホストできます。以下はコンテンツ ペインの定義方法です。 ```ts @@ -192,7 +192,7 @@ const contentPane: IgrContentPane = { ``` -`Header` プロパティはコンテンツ ペインのテキスト ヘッダーを提供するために使用されます。このテキストは複数の場所で描画されます。トップコンテンツペインヘッダー、ペインがタブグループにある場合はタブヘッダー、ペインが固定解除されている場合は固定解除ヘッダーです。`HeaderId`、`TabHeaderId` および `UnpinnedHeaderId` プロパティを使用してそれぞれこれらの場所にカスタム スロット コンテンツを提供できます。これらのプロパティのいずれかが設定されていない場合、`Header` テキストが使用されます。以下は、タブ ヘッダー スロット コンテンツを提供する方法です。 + プロパティはコンテンツ ペインのテキスト ヘッダーを提供するために使用されます。このテキストは複数の場所で描画されます。トップコンテンツペインヘッダー、ペインがタブグループにある場合はタブヘッダー、ペインが固定解除されている場合は固定解除ヘッダーです。 および プロパティを使用してそれぞれこれらの場所にカスタム スロット コンテンツを提供できます。これらのプロパティのいずれかが設定されていない場合、 テキストが使用されます。以下は、タブ ヘッダー スロット コンテンツを提供する方法です。 ```html @@ -234,7 +234,7 @@ const contentPane: IgrContentPane = { ``` -ペインのピン固定が解除されると、ドック マネージャーのいずれかの端にタブ ヘッダーとして表示されます。エンドユーザーに選択されると、そのコンテンツはドッキングされたピン固定ペインの上に表示されます。コンテンツ ペインのピン固定を解除するには、 プロパティを **false** に設定します。 +ペインのピン固定が解除されると、ドック マネージャーのいずれかの端にタブ ヘッダーとして表示されます。エンドユーザーに選択されると、そのコンテンツはドッキングされたピン固定ペインの上に表示されます。コンテンツ ペインのピン固定を解除するには、 プロパティを **false** に設定します。 ```ts @@ -258,17 +258,17 @@ const contentPane = { ``` -`IsPinned` プロパティはドキュメント ホストの外部にドッキングされているコンテンツ ペインのみに影響します。また、フローティング ペインでホストされているコンテンツ ペインのピン固定を解除することはできません。 + プロパティはドキュメント ホストの外部にドッキングされているコンテンツ ペインのみに影響します。また、フローティング ペインでホストされているコンテンツ ペインのピン固定を解除することはできません。 -デフォルトでは、コンテンツ ペインのピン固定解除先は、ドキュメント ホストに対するペインの相対的な位置に基づいて自動的に計算されます。複数のドキュメント ホストが定義されている場合、ピン固定されていないコンテンツ ペインの親階層で最も近いホストが使用されます。ドキュメント ホストが定義されていない場合、デフォルトの場所 `Left` が使用されます。 プロパティを使用してピン固定が解除されたペインの行き先を設定することも可能です。 +デフォルトでは、コンテンツ ペインのピン固定解除先は、ドキュメント ホストに対するペインの相対的な位置に基づいて自動的に計算されます。複数のドキュメント ホストが定義されている場合、ピン固定されていないコンテンツ ペインの親階層で最も近いホストが使用されます。ドキュメント ホストが定義されていない場合、デフォルトの場所 `Left` が使用されます。 プロパティを使用してピン固定が解除されたペインの行き先を設定することも可能です。 -`AllowClose`、`AllowPinning`、`AllowDocking` および `AllowFloating` プロパティを使用して、コンテンツ ペインで許可されるエンドユーザー操作を設定できます。 + および プロパティを使用して、コンテンツ ペインで許可されるエンドユーザー操作を設定できます。 -コンテンツ ペインを定義するときに、`DocumentOnly` プロパティを true に設定して、ペインをドキュメント ホストにのみドッキングできるようにすることができます。 +コンテンツ ペインを定義するときに、 プロパティを true に設定して、ペインをドキュメント ホストにのみドッキングできるようにすることができます。 -コンテンツ ペインとそのコンテンツに対するユーザーの操作を制限するには、`Disabled` プロパティを true に設定します。これにより、単一のフローティング ペインでない限り、すべてのユーザーがペインを操作できなくなります。後者は移動、最大化、または閉じることができるため (最大化および閉じるためのペインの設定に従って)、ユーザーはその下の要素を見ることができますが、そのコンテンツを操作することはできません。 +コンテンツ ペインとそのコンテンツに対するユーザーの操作を制限するには、 プロパティを true に設定します。これにより、単一のフローティング ペインでない限り、すべてのユーザーがペインを操作できなくなります。後者は移動、最大化、または閉じることができるため (最大化および閉じるためのペインの設定に従って)、ユーザーはその下の要素を見ることができますが、そのコンテンツを操作することはできません。 -デフォルトでは、ペインを閉じると、 オブジェクトから削除されます。ただし、場合によってはペインを一時的に非表示にして後で表示することもできます。 オブジェクトを変更せずにそれを行うには、コンテンツペインの プロパティを使用できます。プロパティを **true** に設定すると UI から非表示になりますが、 オブジェクトに残ります。デフォルトの閉じる動作をオーバーライドするには、このように `PaneClose` イベントにサブスクライブできます。 +デフォルトでは、ペインを閉じると、 オブジェクトから削除されます。ただし、場合によってはペインを一時的に非表示にして後で表示することもできます。 オブジェクトを変更せずにそれを行うには、コンテンツペインの プロパティを使用できます。プロパティを **true** に設定すると UI から非表示になりますが、 オブジェクトに残ります。デフォルトの閉じる動作をオーバーライドするには、このように `PaneClose` イベントにサブスクライブできます。 ```ts @@ -294,7 +294,7 @@ this.dockManager.addEventListener('paneClose', ev => { ### 分割ペイン - は、 プロパティに基づいてすべての子 `Panes` を水平または垂直に積み重ねるコンテナー ペインです。以下は、2 つの子コンテンツ ペインを持つ水平の分割ペインの定義方法です。 + は、 プロパティに基づいてすべての子 を水平または垂直に積み重ねるコンテナー ペインです。以下は、2 つの子コンテンツ ペインを持つ水平の分割ペインの定義方法です。 ```ts @@ -340,11 +340,11 @@ const splitPane: IgrSplitPane = { 分割ペインは、他のスプリットされたペインを含むすべてのペイン タイプの子ペインを含むことができます。 -デフォルトでは、分割ペインが空の場合は表示されません。ただし、その動作を変更したい場合は、`AllowEmpty` プロパティを true に設定すると、内部にペインがない場合でも、分割ペインが UI に表示されます。 +デフォルトでは、分割ペインが空の場合は表示されません。ただし、その動作を変更したい場合は、 プロパティを true に設定すると、内部にペインがない場合でも、分割ペインが UI に表示されます。 ### タブ グループ ペイン - は、その子コンテンツ `Panes` をタブ コンポーネントのタブとして表示します。以下は、2 つのタブそれぞれにコンテンツ ペインを持つタブ グループ ペインの定義方法です。 + は、その子コンテンツ をタブ コンポーネントのタブとして表示します。以下は、2 つのタブそれぞれにコンテンツ ペインを持つタブ グループ ペインの定義方法です。 ```ts @@ -390,11 +390,11 @@ const tabGroupPane: IgrTabGroupPane = { タブは、それらが配置されているタブ グループから切り離さずに並べ替えることもできます。タブをクリックして、希望の位置まで左または右にドラッグできます。選択したタブをタブ領域の外にドラッグすると、フローティング ペインにデタッチされます。 -タブがないときにタブ グループ ペインを UI に表示する場合は、`AllowEmpty` プロパティを true に設定します。 +タブがないときにタブ グループ ペインを UI に表示する場合は、 プロパティを true に設定します。 ### ドキュメント ホスト - コード編集やデザイン ビュー用の Visual Studio のタブと同様のドキュメント タブ領域です。以下は、2 つのドキュメント タブを持つドキュメント ホストを定義する方法です。 + コード編集やデザイン ビュー用の Visual Studio のタブと同様のドキュメント タブ領域です。以下は、2 つのドキュメント タブを持つドキュメント ホストを定義する方法です。 ```ts @@ -456,7 +456,7 @@ const docHost: IgrDocumentHost = { ### フローティング ペイン -フローティング ペインは、フローティング ウィンドウで他のペインの上に描画される分割ペインです。フローティング ペインの定義は、 プロパティに保存されます。以下は、単一のコンテンツ ペインを含むフローティング ペインを追加する方法です。 +フローティング ペインは、フローティング ウィンドウで他のペインの上に描画される分割ペインです。フローティング ペインの定義は、 プロパティに保存されます。以下は、単一のコンテンツ ペインを含むフローティング ペインを追加する方法です。 ```ts @@ -512,13 +512,13 @@ const layout: IgrDockManagerLayout = { ``` -`FloatingLocation`、`FloatingWidth` と `FloatingHeight` プロパティは絶対寸法をピクセル単位で表します。これらのプロパティは、`FloatingPanes` 配列の分割ペインにのみ適用されることに注意してください。 + プロパティは絶対寸法をピクセル単位で表します。これらのプロパティは、 配列の分割ペインにのみ適用されることに注意してください。 -`FloatingResizable` と `AllowFloatingPanesResize` を使用して、フローティング ペインのサイズ変更を許可するかどうかを設定できます。`allowFloatingPanesResize` は **IgcDockManagerComponent** プロパティであるため、値が **false** に設定されている場合、フローティング ペインのサイズを変更することはできません。`floatingResizable` プロパティは、`floatPanes` 配列の各分割ペインに個別に適用できます。プロパティ値が設定されていない場合、デフォルトで `allowFloatingPanesResize` プロパティの値になります。`floatingResizable` プロパティが特定のペインに設定されている場合、その値は `allowFloatingPanesResize` プロパティ値に優先されます。 + を使用して、フローティング ペインのサイズ変更を許可するかどうかを設定できます。`allowFloatingPanesResize` は **IgcDockManagerComponent** プロパティであるため、値が **false** に設定されている場合、フローティング ペインのサイズを変更することはできません。`floatingResizable` プロパティは、`floatPanes` 配列の各分割ペインに個別に適用できます。プロパティ値が設定されていない場合、デフォルトで `allowFloatingPanesResize` プロパティの値になります。`floatingResizable` プロパティが特定のペインに設定されている場合、その値は `allowFloatingPanesResize` プロパティ値に優先されます。 ### アクティブ ペイン -ドック マネージャー コンポーネントは、フォーカスを含むコンテンツ ペインをハイライト表示し、 プロパティで公開します。プロパティを設定することによってアクティブ ペインをプログラムで変更できます。`ActivePaneChanged` イベントにサブスクライブして、 プロパティの変更をリッスンすることもできます。 +ドック マネージャー コンポーネントは、フォーカスを含むコンテンツ ペインをハイライト表示し、 プロパティで公開します。プロパティを設定することによってアクティブ ペインをプログラムで変更できます。`ActivePaneChanged` イベントにサブスクライブして、 プロパティの変更をリッスンすることもできます。 ```ts @@ -544,7 +544,7 @@ this.dockManager.addEventListener('activePaneChanged', ev => { #### ルート ドッキング -このタイプのドッキングでは、ペインをドラッグしているときに、ドックマネージャーの四隅付近に 4 つの矢印ドッキングインジケーターが表示されます。ペインをドロップすると、Dock Manager の の直接の子要素になります。視覚的には、新しくドッキングされたペインはそれぞれの端にスナップされ、ドック マネージャーの幅または高さの最大半分を占め、他のすべてのコンテンツは残りの半分に移動します。 +このタイプのドッキングでは、ペインをドラッグしているときに、ドックマネージャーの四隅付近に 4 つの矢印ドッキングインジケーターが表示されます。ペインをドロップすると、Dock Manager の の直接の子要素になります。視覚的には、新しくドッキングされたペインはそれぞれの端にスナップされ、ドック マネージャーの幅または高さの最大半分を占め、他のすべてのコンテンツは残りの半分に移動します。 dockmanager-root-docking @@ -619,7 +619,7 @@ this.dockManager.layout = { ...this.dockManager.layout }; ### レイアウトの保存/読み込み -レイアウトを復元または永続化するには、 プロパティの値を取得または設定します。以下は、文字列化された JSON としてレイアウトを保存する方法です。 +レイアウトを復元または永続化するには、 プロパティの値を取得または設定します。以下は、文字列化された JSON としてレイアウトを保存する方法です。 ```ts @@ -652,7 +652,7 @@ private loadLayout() { ### Adding Panes At Runtime -Contents and panes can be added to the at runtime. In the example below, you can see how you can add content, document and floating panes. +Contents and panes can be added to the at runtime. In the example below, you can see how you can add content, document and floating panes. @@ -664,7 +664,7 @@ Contents and panes can be added to the に追加できます。以下の例では、コンテンツ、ドキュメント、およびフローティング ペインを追加する方法を確認できます。
@@ -786,16 +786,16 @@ Below you can find a list containing the slot names for all of the buttons as we | Slot name | Description | | ----------|------------ | -| | The close buttons. | -| | The close buttons of the pane headers. | -| | The close buttons of the tab headers. | -| | The more tabs buttons. | -| | The more options buttons. | -| | The maximize buttons. | -| | The minimize buttons. | -| | The pin buttons. | -| | The unpin buttons. | -| | The splitter handle. | +| `closeButton` | The close buttons. | +| `paneHeaderCloseButton` | The close buttons of the pane headers. | +| `tabHeaderCloseButton` | The close buttons of the tab headers. | +| `moreTabsButton` | The more tabs buttons. | +| `moreOptionsButton` | The more options buttons. | +| `maximizeButton` | The maximize buttons. | +| `minimizeButton` | The minimize buttons. | +| `pinButton` | The pin buttons. | +| `unpinButton` | The unpin buttons. | +| `splitterHandle` | The splitter handle. | You can find each slot's corresponding part in the **CSS Parts** under **Styling** section of this page. @@ -1007,13 +1007,13 @@ addResourceStrings('fr', dockManagerStringsFr); ```
-ドック マネージャーは、個々の文字列を直接変更するために使用できる `ResourceStrings` プロパティも公開します。`ResourceStrings` プロパティを設定すると、ドック マネージャーはページの [lang](https://developer.mozilla.org/ja/docs/Web/HTML/Global_attributes/lang) 属性に関係なく、指定された文字列を使用します。 +ドック マネージャーは、個々の文字列を直接変更するために使用できる プロパティも公開します。 プロパティを設定すると、ドック マネージャーはページの [lang](https://developer.mozilla.org/ja/docs/Web/HTML/Global_attributes/lang) 属性に関係なく、指定された文字列を使用します。 ## API リファレンス -
-
-
-
-
-
+
+
+
+
+
+
diff --git a/docs/xplat/src/content/jp/components/layouts/splitter.mdx b/docs/xplat/src/content/jp/components/layouts/splitter.mdx index cfb993d872..be36139068 100644 --- a/docs/xplat/src/content/jp/components/layouts/splitter.mdx +++ b/docs/xplat/src/content/jp/components/layouts/splitter.mdx @@ -27,7 +27,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` - を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```ts import { defineComponents, IgcSplitterComponent } from 'igniteui-webcomponents'; @@ -140,7 +140,7 @@ splitter.addEventListener('igcResizeEnd', (event: CustomEvent) => { ## スタイル設定 - コンポーネントは、スタイル設定のための CSS パーツを公開しています: + コンポーネントは、スタイル設定のための CSS パーツを公開しています: | 名前 | 説明 | | ---- | ----------- | diff --git a/docs/xplat/src/content/jp/components/layouts/stepper.mdx b/docs/xplat/src/content/jp/components/layouts/stepper.mdx index 197f5447a6..149ecf013d 100644 --- a/docs/xplat/src/content/jp/components/layouts/stepper.mdx +++ b/docs/xplat/src/content/jp/components/layouts/stepper.mdx @@ -43,7 +43,7 @@ import stepperContenttop from '@xplat-images/stepper/stepper-contentTop.png'; npm install {PackageWebComponents} ``` - を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```ts import { defineComponents, IgcStepperComponent } from 'igniteui-webcomponents'; @@ -68,7 +68,7 @@ defineComponents(IgcStepperComponent); npm install igniteui-react ``` -次に、以下のように、 と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrStepper, IgrStep } from 'igniteui-react'; @@ -95,7 +95,7 @@ builder.Services.AddIgniteUIBlazor( -また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -105,10 +105,10 @@ builder.Services.AddIgniteUIBlazor(
-これで、{Platform} とそのパネルの基本構成から始めることができます。 +これで、{Platform} とそのパネルの基本構成から始めることができます。 ## {Platform} ステッパーの使用方法 - は、 に属するすべてのステップの表現です。ステップは `Step.Invalid`、`Step.Active`、`Step.Optional`、`Step.Disabled`、`Step.Complete` プロパティを提供し、ビジネス要件に応じてステップの状態を構成できます。 + は、 に属するすべてのステップの表現です。ステップは `Step.Invalid`、`Step.Active`、`Step.Optional`、`Step.Disabled`、`Step.Complete` プロパティを提供し、ビジネス要件に応じてステップの状態を構成できます。 ### {Platform} ステッパーの宣言 ステップは、以下の方法のいずれかを使用して宣言できます。 @@ -274,8 +274,8 @@ builder.Services.AddIgniteUIBlazor( **水平方向の {Platform} ステッパー** - の orientation プロパティのデフォルト値は **horizontal**です。 -{Platform} ステッパーが水平方向の場合、ステップのコンテンツをステップのヘッダーの上または下に表示するかどうかを決定できます。これは、 ブール型プロパティを設定することで実現できます。デフォルト値は **false** です。有効な場合、ステップのコンテンツはステップのヘッダーの上に表示されます。 + の orientation プロパティのデフォルト値は **horizontal**です。 +{Platform} ステッパーが水平方向の場合、ステップのコンテンツをステップのヘッダーの上または下に表示するかどうかを決定できます。これは、 ブール型プロパティを設定することで実現できます。デフォルト値は **false** です。有効な場合、ステップのコンテンツはステップのヘッダーの上に表示されます。 stepper-contentTop @@ -294,7 +294,7 @@ builder.Services.AddIgniteUIBlazor( ### ステップ状態 -{Platform} は 5 つのステップ状態をサポートし、それぞれがデフォルトで異なるスタイルを適用します。 +{Platform} は 5 つのステップ状態をサポートし、それぞれがデフォルトで異なるスタイルを適用します。 - **active** - ステップが現在表示されているかどうかを決定します。設計上、ユーザーが明示的にステップの active 属性を **true** に設定しない場合、最初の有効なステップがアクティブになります。 - **disabled** - ステップが操作可能かどうかを決定します。デフォルトでは、ステップの disabled 属性は **false** に設定されています。 - **invalid** - ステップが有効かどうかを決定します。その値に基づいて、ユーザーがリニア ステッパー モードで前に進むことができるかどうかが決定されます。デフォルト値は **false** です。 @@ -309,7 +309,7 @@ builder.Services.AddIgniteUIBlazor( ### リニア {Platform} ステッパー -{Platform} は、 プロパティを使用してステップ フローを設定できます。デフォルトで、linear は **false** に設定され、ユーザーは で無効にされていないステップを選択できます。 +{Platform} は、 プロパティを使用してステップ フローを設定できます。デフォルトで、linear は **false** に設定され、ユーザーは で無効にされていないステップを選択できます。 @@ -367,8 +367,8 @@ linear プロパティが **true** に設定されている場合、ステッパ ### ステップ操作 - provides the following API methods for step interactions: -`Stepper` は、ステップ操作に以下の API メソッドを提供します。 + provides the following API methods for step interactions: + は、ステップ操作に以下の API メソッドを提供します。 - **navigateTo** – 指定したインデックスでステップをアクティブ化します。 - **next** - 次の無効化されていないステップをアクティブ化します。 - **prev** – 前の無効化されていないステップをアクティブ化します。 @@ -382,7 +382,7 @@ reset メソッドは、ステッパーを初期状態にリセットします {ProductName} ステッパーでは、タイトル、インジケーターなどのさまざまなオプションを構成できます。 -これは、 プロパティで実現できます。プロパティは以下の値を含みます: +これは、 プロパティで実現できます。プロパティは以下の値を含みます: - Full (フル、デフォルト値) - Indicator (インジケーター) - Title (タイトル) @@ -399,7 +399,7 @@ reset メソッドは、ステッパーを初期状態にリセットします - bottom - top -{Platform} が水平方向で、タイトルの位置が**定義されていない**場合、タイトルはインジケーターの**下**に表示されます。 +{Platform} が水平方向で、タイトルの位置が**定義されていない**場合、タイトルはインジケーターの**下**に表示されます。 向きが垂直に設定され、タイトルの位置が**定義されていない**場合、タイトルはインジケーターの**後**に表示されます。 @@ -432,7 +432,7 @@ reset メソッドは、ステッパーを初期状態にリセットします ### Stepper のアニメーション -{Platform} の `Stepper` のアニメーションにより、エンドユーザーは、定義されたステップを操作しているときに美しいユーザー操作体験を得ることができます。使用可能なアニメーション オプションは、ステッパーの向きによって異なります。 +{Platform} の のアニメーションにより、エンドユーザーは、定義されたステップを操作しているときに美しいユーザー操作体験を得ることができます。使用可能なアニメーション オプションは、ステッパーの向きによって異なります。 ステッパーが水平方向の場合、デフォルトでは `slide` アニメーションを使用するように設定されています。その他に `fade` アニメーションもサポートされます。アニメーションは、 入力を介して構成されます。 @@ -440,7 +440,7 @@ reset メソッドは、ステッパーを初期状態にリセットします 両方のアニメーション タイプ入力に `none` を設定すると、ステッパー アニメーションが無効になります。 - コンポーネントを使用すると、ステップ間の遷移にかかる時間を設定することもできます。これは、数値を受け取る `animationDuration` プロパティで設定でき、いずれのレイアウト方向でも共通の設定です。デフォルト値は 320ms に設定されています。 + コンポーネントを使用すると、ステップ間の遷移にかかる時間を設定することもできます。これは、数値を受け取る `animationDuration` プロパティで設定でき、いずれのレイアウト方向でも共通の設定です。デフォルト値は 320ms に設定されています。 @@ -450,7 +450,7 @@ reset メソッドは、ステッパーを初期状態にリセットします ## キーボード ナビゲーション {ProductName} ステッパーは、さまざまなキーボード操作をエンドユーザーに提供します。この機能はデフォルトで有効になっており、エンドユーザーは簡単にステップを移動できます。 -{Platform} ナビゲーションは [W3 アクセシビリティ標準](https://www.w3.org/WAI/ARIA/apg/patterns/tabpanel/)に準拠しており、便利に使用できます。 +{Platform} ナビゲーションは [W3 アクセシビリティ標準](https://www.w3.org/WAI/ARIA/apg/patterns/tabpanel/)に準拠しており、便利に使用できます。 **キーの組み合わせ** @@ -489,7 +489,7 @@ reset メソッドは、ステッパーを初期状態にリセットします | `body` | ステップのコンテンツのラッパー。| | `content` | ステップのコンテンツ。| -これらの CSS パーツを使用して、次のように コンポーネントの外観をカスタマイズできます: +これらの CSS パーツを使用して、次のように コンポーネントの外観をカスタマイズできます: ```css igc-step::part(title) { @@ -530,7 +530,7 @@ igc-step::part(indicator) { ## API リファレンス -
+



diff --git a/docs/xplat/src/content/jp/components/layouts/tabs.mdx b/docs/xplat/src/content/jp/components/layouts/tabs.mdx index 614003b8cf..b4645a80e7 100644 --- a/docs/xplat/src/content/jp/components/layouts/tabs.mdx +++ b/docs/xplat/src/content/jp/components/layouts/tabs.mdx @@ -149,7 +149,7 @@ defineComponents(IgcTabsComponent);
-タブ テキストは、`Label` プロパティを使用して単純な文字列として設定することも、`label` スロットに子要素を割り当てることで設定することもできます。デフォルト スロットの残りの子要素は、タブ コンテンツとしてレンダリングされます。 +タブ テキストは、 プロパティを使用して単純な文字列として設定することも、`label` スロットに子要素を割り当てることで設定することもできます。デフォルト スロットの残りの子要素は、タブ コンテンツとしてレンダリングされます。 ### 選択 @@ -157,11 +157,11 @@ defineComponents(IgcTabsComponent); 選択したタブが初期の読み込み時に指定されていない場合、無効になっていない最初のタブが選択されます。 -ユーザーが矢印キーでナビゲートしているときにタブを選択するデフォルトの動作は、 プロパティによって変更できます。`Manual` に設定すると、矢印キーを押すと次 / 前のタブにフォーカスしますが、タブは SPACE または ENTER を押した後にのみ選択されます。 +ユーザーが矢印キーでナビゲートしているときにタブを選択するデフォルトの動作は、 プロパティによって変更できます。`Manual` に設定すると、矢印キーを押すと次 / 前のタブにフォーカスしますが、タブは SPACE または ENTER を押した後にのみ選択されます。 ### 無効化されたタブ -`Disabled` 属性を設定すると、タブが無効になります: + 属性を設定すると、タブが無効になります: @@ -189,7 +189,7 @@ defineComponents(IgcTabsComponent); ### 配置 -`Alignment` プロパティは、{Platform} タブの配置方法を制御します。プロパティは以下の値を含みます: + プロパティは、{Platform} タブの配置方法を制御します。プロパティは以下の値を含みます: - `Start` (デフォルト): タブの幅はコンテンツ (ラベル、アイコン、両方) に依存し、すべてのタブのパディングは等しくなります。最初のタブは、タブ コンテナーの左側に配置されます。 - `Center`: タブの幅はコンテンツによって異なり、タブ コンテナーの中心を占めます。 @@ -216,11 +216,11 @@ defineComponents(IgcTabsComponent); |キー|説明| |----|-----------| -| | 前 (右から左モードでは次) のタブを選択します。`Activation` が `Manual` に設定されている場合は、タブのみがフォーカスされます。最初のタブにある場合は最後までスクロールします。 | -| | 次へ (右から左モードでは前へ) タブを選択します。`Activation` が `Manual` に設定されている場合は、タブのみがフォーカスされます。最後のタブにある場合は、スクロールして開始します。 | +| | 前 (右から左モードでは次) のタブを選択します。 が `Manual` に設定されている場合は、タブのみがフォーカスされます。最初のタブにある場合は最後までスクロールします。 | +| | 次へ (右から左モードでは前へ) タブを選択します。 が `Manual` に設定されている場合は、タブのみがフォーカスされます。最後のタブにある場合は、スクロールして開始します。 | | HOME | 最初のタブを選択します。 | | END | 最後のタブを選択します。 | -| ENTER / SPACE | `Activation` が `Manual` の場合、フォーカスされたタブを選択します。 | +| ENTER / SPACE | が `Manual` の場合、フォーカスされたタブを選択します。 | ### Prefix / Suffix (プレフィックス / サフィックス) diff --git a/docs/xplat/src/content/jp/components/layouts/tile-manager.mdx b/docs/xplat/src/content/jp/components/layouts/tile-manager.mdx index 2af83c1051..560337089c 100644 --- a/docs/xplat/src/content/jp/components/layouts/tile-manager.mdx +++ b/docs/xplat/src/content/jp/components/layouts/tile-manager.mdx @@ -31,14 +31,14 @@ import tileManagerActions from '@xplat-images/tile-manager-actions.png'; ## 使用方法 -`TileManager` は、最大化状態または通常状態でのタイルの配置を管理する基本的なタイル レイアウト動作を提供します。タイルはそれぞれ独立してサイズを設定でき、複雑なレイアウトを構築できます。エンドユーザーはドラッグ アンド ドロップによる直感的な操作で柔軟にタイルを並べ替えることが可能です。 + は、最大化状態または通常状態でのタイルの配置を管理する基本的なタイル レイアウト動作を提供します。タイルはそれぞれ独立してサイズを設定でき、複雑なレイアウトを構築できます。エンドユーザーはドラッグ アンド ドロップによる直感的な操作で柔軟にタイルを並べ替えることが可能です。 タイル マネージャーでは、使用できる 2 つのコンポーネントが提供されます。 -- `Tile` - このコンポーネントは、タイル マネージャー内に表示される個々のタイルを表します。 -- `TileManager` - これはすべてのタイル コンポーネントを含むメイン コンポーネントであり、タイル レイアウト全体のコンテナーとして機能します。 +- - このコンポーネントは、タイル マネージャー内に表示される個々のタイルを表します。 +- - これはすべてのタイル コンポーネントを含むメイン コンポーネントであり、タイル レイアウト全体のコンテナーとして機能します。 -- - This component represents an individual tile displayed within the Tile Manager. -- - This is the main component that contains all of the tile components, serving as the container for the entire tile layout. +- - This component represents an individual tile displayed within the Tile Manager. +- - This is the main component that contains all of the tile components, serving as the container for the entire tile layout. ### 作業の開始 @@ -106,7 +106,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; builder.Services.AddIgniteUIBlazor(typeof(IgbTileManagerModule)); ``` -また、 コンポーネントにスタイルを適用するために、追加の CSS ファイルをリンクする必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、 コンポーネントにスタイルを適用するために、追加の CSS ファイルをリンクする必要があります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -726,9 +726,9 @@ Tile コンポーネントは、使用できるいくつかのスロットも公 ## スタイル設定 - の 2 つのコンポーネントの外観をカスタマイズすることもできます。 - は、Tile Manager のベース ラッパーのスタイル設定に使用できる CSS プロパティ `base` のみを公開します。 - は、使用できるいくつかの CSS プロパティを公開します。 + の 2 つのコンポーネントの外観をカスタマイズすることもできます。 + は、Tile Manager のベース ラッパーのスタイル設定に使用できる CSS プロパティ `base` のみを公開します。 + は、使用できるいくつかの CSS プロパティを公開します。 | パーツ名 | 説明 | | ---------|------------ | @@ -823,14 +823,14 @@ igc-tile:nth-child(n+2)::part(trigger) { ## API リファレンス -- `TileManager` -- `Tile` +- +- - [スタイル設定 & テーマ](../themes/overview.md) ## その他のリソース -
-
+
+
- [{ProductName} **フォーラム (英語)**]({ForumsLink}) - [{ProductName} **GitHub (英語)**]({GithubLink}) diff --git a/docs/xplat/src/content/jp/components/linear-gauge.mdx b/docs/xplat/src/content/jp/components/linear-gauge.mdx index 6e13dfff55..60b3cb00da 100644 --- a/docs/xplat/src/content/jp/components/linear-gauge.mdx +++ b/docs/xplat/src/content/jp/components/linear-gauge.mdx @@ -14,11 +14,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} リニア ゲージの概要 -{ProductName} リニア ゲージ コンポーネントを使用すると、リニア ゲージの形式でデータを視覚化できます。`LinearGauge` は、スケールおよび 1 つ以上の範囲と比較した値のシンプルで簡潔なビューを提供します。1 つのスケール、1 セットの目盛り、および 1 セットのラベルをサポートします。このコンポーネントには、アニメーション化されたトランジションのサポートも組み込まれており、アニメーションでは、 プロパティの設定で簡単にカスタマイズできます。また構成可能な向きや方向、視覚要素やツールチップなどがサポートされます。 +{ProductName} リニア ゲージ コンポーネントを使用すると、リニア ゲージの形式でデータを視覚化できます。 は、スケールおよび 1 つ以上の範囲と比較した値のシンプルで簡潔なビューを提供します。1 つのスケール、1 セットの目盛り、および 1 セットのラベルをサポートします。このコンポーネントには、アニメーション化されたトランジションのサポートも組み込まれており、アニメーションでは、 プロパティの設定で簡単にカスタマイズできます。また構成可能な向きや方向、視覚要素やツールチップなどがサポートされます。 ## {Platform} リニア ゲージの例 -以下のサンプルは、同じ `LinearGauge` でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 +以下のサンプルは、同じ でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 @@ -45,7 +45,7 @@ npm install --save {PackageGauges} ## モジュールの要件 -`LinearGauge` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 @@ -320,7 +320,7 @@ ModuleManager.register( ## 針のハイライト -リニア ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の `Value` の不透明度が低く表示されます。これを有効にするには、まず `HighlightValueDisplayMode` を Overlay に設定し、次に `HighlightValue` を適用します。 +リニア ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の の不透明度が低く表示されます。これを有効にするには、まず を Overlay に設定し、次に を適用します。 @@ -786,7 +786,7 @@ ModuleManager.register( ## スケール -スケールはゲージで値の全範囲をハイライト表示する視覚的な要素です。外観やスケールの図形のカスタマイズ、更にスケールを反転 (`IsScaleInverted` プロパティを使用) させて、すべてのラベルを左から右ではなく、右から左へ描画することもできます。 +スケールはゲージで値の全範囲をハイライト表示する視覚的な要素です。外観やスケールの図形のカスタマイズ、更にスケールを反転 ( プロパティを使用) させて、すべてのラベルを左から右ではなく、右から左へ描画することもできます。 diff --git a/docs/xplat/src/content/jp/components/maps/map-api.mdx b/docs/xplat/src/content/jp/components/maps/map-api.mdx index 3913d184b3..f7eabdb14f 100644 --- a/docs/xplat/src/content/jp/components/maps/map-api.mdx +++ b/docs/xplat/src/content/jp/components/maps/map-api.mdx @@ -7,89 +7,91 @@ mentionedTypes: ["GeographicMap", "Series", "SeriesViewer", "GeographicSymbolSer namespace: Infragistics.Controls.Maps _language: ja --- +import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; + # {Platform} 地理マップ API -{Platform} `GeographicMap` には次の API メンバーがあります: +{Platform} には次の API メンバーがあります: -- `Zoomable` -- `ZoomToGeographic` -- `WorldRect` -- `WindowRect` -- `WindowScale` -- `GetGeographicFromZoom` -- `GetGeographicPoint` -- `GetPixelPoint` +- +- +- +- +- +- +- +- ## {Platform} 地理的シリーズの種類 -{Platform} `GeographicMap` には 7 種類のシリーズがあり、データ バインディング用の `ItemsSource` プロパティがあります。 +{Platform} には 7 種類のシリーズがあり、データ バインディング用の プロパティがあります。 -- `GeographicHighDensityScatterSeries` -- `GeographicSymbolSeries` -- `GeographicProportionalSymbolSeries` -- `GeographicPolylineSeries` -- `GeographicShapeSeries` -- `GeographicScatterAreaSeries` -- `GeographicContourLineSeries` +- +- +- +- +- +- +- さらに、シリーズの各種類には、データ項目をマッピングし、その外観をスタイル設定するための特定のプロパティがあります。 ## {Platform} 地理記号シリーズ API -{Platform} `GeographicSymbolSeries` (地理マーカー シリーズ) には、次の API メンバーがあります。 +{Platform} (地理マーカー シリーズ) には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `MarkerType` -- `MarkerBrush` -- `MarkerOutline` +- +- +- +- +- ## {Platform} 地理バブル シリーズ API -{Platform} `GeographicProportionalSymbolSeries` (地理バブル シリーズ) には、次の API メンバーがあります。 +{Platform} (地理バブル シリーズ) には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `RadiusMemberPath` -- `RadiusScale` -- `FillScale` -- `FillMemberPath` +- +- +- +- +- +- ## {Platform} 地理シェイプ シリーズ API -{Platform} `GeographicShapeSeries` と `GeographicPolylineSeries` には同じ API メンバーがあります。 +{Platform} には同じ API メンバーがあります。 -- `ShapeMemberPath` -- `Thickness` -- `Brush` -- `Outline` +- +- +- +- ## {Platform} 地理エリア シリーズ API -{Platform} `GeographicScatterAreaSeries` には、次の API メンバーがあります。 +{Platform} には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `ColorMemberPath` -- `ColorScale` +- +- +- +- ## {Platform} 地理等高線シリーズ API -{Platform} `GeographicContourLineSeries` には、次の API メンバーがあります。 +{Platform} には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `ValueMemberPath` -- `FillScale` +- +- +- +- ## {Platform} 地理 HD シリーズ API -{Platform} `GeographicHighDensityScatterSeries` には、次の API メンバーがあります。 +{Platform} には、次の API メンバーがあります。 -- `LatitudeMemberPath` -- `LongitudeMemberPath` -- `HeatMaximumColor` -- `HeatMinimumColor` \ No newline at end of file +- +- +- +- \ No newline at end of file diff --git a/docs/xplat/src/content/jp/components/menus/navbar.mdx b/docs/xplat/src/content/jp/components/menus/navbar.mdx index 44772caff7..71310b42fc 100644 --- a/docs/xplat/src/content/jp/components/menus/navbar.mdx +++ b/docs/xplat/src/content/jp/components/menus/navbar.mdx @@ -14,12 +14,12 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} Navbar の概要 -{Platform} `Navbar` は、アプリ内の現在の位置をユーザーに通知します。ナビゲーション バーは、検索やお気に入りなどのクイック アクションへのリンクを提供することもでき、ユーザーが無効なルートや状態に移動しようとせずに、アプリケーション内をスムーズにナビゲートできるようにします。ナビゲーション バーは、それが配置されているコンテナの上部にあります。 +{Platform} は、アプリ内の現在の位置をユーザーに通知します。ナビゲーション バーは、検索やお気に入りなどのクイック アクションへのリンクを提供することもでき、ユーザーが無効なルートや状態に移動しようとせずに、アプリケーション内をスムーズにナビゲートできるようにします。ナビゲーション バーは、それが配置されているコンテナの上部にあります。 ## {Platform} Navbar の例 -次の例は、アイコンとテキスト ヘッダーのある を表しています: +次の例は、アイコンとテキスト ヘッダーのある を表しています: @@ -39,7 +39,7 @@ npm install {PackageWebComponents} - を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: @@ -69,7 +69,7 @@ defineComponents(IgcNavbarComponent); -また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -90,7 +90,7 @@ defineComponents(IgcNavbarComponent); npm install igniteui-react ``` -次に、以下のように、 と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrNavbar } from 'igniteui-react'; @@ -101,7 +101,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -次に、 のテンプレートに次のコードを追加して、タイトルのみの基本的な を表示できます。 +次に、 のテンプレートに次のコードを追加して、タイトルのみの基本的な を表示できます。 @@ -136,7 +136,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; ### コンテンツ - コンポーネントを強化するには、 またはその他のコンポーネントを start 位置または end 位置のコンテンツとして追加し、ユーザーがバーから直接主要な位置に移動できるようにします。 + コンポーネントを強化するには、 またはその他のコンポーネントを start 位置または end 位置のコンテンツとして追加し、ユーザーがバーから直接主要な位置に移動できるようにします。 @@ -220,7 +220,7 @@ igc-navbar::part(middle) {
-
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/menus/navigation-drawer.mdx b/docs/xplat/src/content/jp/components/menus/navigation-drawer.mdx index ed95a6bd90..12bc037f1d 100644 --- a/docs/xplat/src/content/jp/components/menus/navigation-drawer.mdx +++ b/docs/xplat/src/content/jp/components/menus/navigation-drawer.mdx @@ -19,7 +19,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## {Platform} Navigation Drawer の例 -このサンプルは、 コンポーネントを作成する方法を示しています。 +このサンプルは、 コンポーネントを作成する方法を示しています。 @@ -52,7 +52,7 @@ npm install {PackageWebComponents} npm install igniteui-react ``` -次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: +次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: ```tsx import { IgrNavDrawer, IgrNavDrawerHeaderItem, IgrNavDrawerItem } from 'igniteui-react'; @@ -63,7 +63,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css';
- を使用する前に、次のように登録する必要があります。 + を使用する前に、次のように登録する必要があります。 @@ -84,7 +84,7 @@ builder.Services.AddIgniteUIBlazor( -また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -108,7 +108,7 @@ defineComponents(IgcNavDrawerComponent); ## Navigation Drawer 項目の追加 -`NavDrawer` の使用を開始する最も簡単な方法は次のとおりです: + の使用を開始する最も簡単な方法は次のとおりです: @@ -572,7 +572,7 @@ igc-nav-drawer-header-item {


-
+



diff --git a/docs/xplat/src/content/jp/components/menus/toolbar.mdx b/docs/xplat/src/content/jp/components/menus/toolbar.mdx index fbdef518e8..d925bb1d88 100644 --- a/docs/xplat/src/content/jp/components/menus/toolbar.mdx +++ b/docs/xplat/src/content/jp/components/menus/toolbar.mdx @@ -14,7 +14,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} Toolbar (ツールバー) の概要 -{Platform} ツールバー コンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、`DataChart` または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 +{Platform} ツールバー コンポーネントは、主にチャート コンポーネントで使用される UI 操作のコンパニオン コンテナーです。ツールバーは、 または コンポーネントにリンクされると、プロパティとツール項目のプリセットで動的に更新されます。プロジェクト用のカスタム ツールを作成して、エンド ユーザーが変更を提供できるようになり、無限のカスタマイズが可能になります。 ## {Platform} ツールバーの例 @@ -33,7 +33,7 @@ npm install {PackageCharts} npm install {PackageCore} ``` -`DataChart` コンポーネントとその機能とともに を使用する場合、次のモジュールが必要です。 + コンポーネントとその機能とともに を使用する場合、次のモジュールが必要です。 @@ -59,13 +59,13 @@ export class AppModule {} - + -```ts -import { IgxToolbarModule } from 'igniteui-react-layouts'; +```tsx +import { IgrToolbarModule } from 'igniteui-react-layouts'; import { IgrDataChartToolbarModule, IgrDataChartCoreModule, IgrDataChartCategoryModule, IgrDataChartAnnotationModule, IgrDataChartInteractivityModule, IgrDataChartCategoryTrendLineModule } from 'igniteui-react-charts'; -IgxToolbarModule.register(); +IgrToolbarModule.register(); IgrDataChartToolbarModule.register(); IgrDataChartCoreModule.register(); IgrDataChartCategoryModule.register(); @@ -126,7 +126,7 @@ import { IgxDataChartToolbarModule, IgxDataChartCoreModule, IgxDataChartCategory export class AppModule {} ``` -`DataChart` コンポーネントとその機能とともに を使用する場合、次のモジュールが必要です。 + コンポーネントとその機能とともに を使用する場合、次のモジュールが必要です。 ```ts import { IgxToolbarModule } from 'igniteui-react-layouts'; @@ -141,7 +141,7 @@ IgrDataChartInteractivityModule.register(); IgrDataChartCategoryTrendLineModule.register(); ``` -スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります。 +スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります。 ```ts import { ModuleManager } from 'igniteui-webcomponents-core'; @@ -168,29 +168,29 @@ ModuleManager.register( ### ツール操作 -以下は、ツールバーに追加できるさまざまな 項目のリストです。 +以下は、ツールバーに追加できるさまざまな 項目のリストです。 -- -- -- -- -- -- -- -- +- +- +- +- +- +- +- +- -これらのツールはそれぞれ、マウスのクリックによってトリガーされる イベントを公開します。注: は、 内にラップすることもできる他のツールのラッパーです。 +これらのツールはそれぞれ、マウスのクリックによってトリガーされる `OnCommand` イベントを公開します。注: は、 内にラップすることもできる他のツールのラッパーです。 - オブジェクトの 、および プロパティを使用して、新規および既存のツールの位置を変更したり、非表示にマークしたりすることができます。ToolActions は プロパティも公開します。 + オブジェクトの 、および プロパティを使用して、新規および既存のツールの位置を変更したり、非表示にマークしたりすることができます。ToolActions は プロパティも公開します。 -次の例は、いくつかの機能を示しています。まず、**ZoomReset** や **AnalyzeMenu** メニュー ツール操作などの組み込みツールを非表示にするなど、`ToolActionSubPanel` でツールをグループ化できます。この例では、`AfterId` プロパティを使用して **ZoomMenu** 内に **ZoomReset** ツール操作の新しいインスタンスを作成し、それを **ZoomOut** に割り当てて配置を正確にします。また、ツールの プロパティによってもハイライト表示されます。 +次の例は、いくつかの機能を示しています。まず、**ZoomReset** や **AnalyzeMenu** メニュー ツール操作などの組み込みツールを非表示にするなど、 でツールをグループ化できます。この例では、 プロパティを使用して **ZoomMenu** 内に **ZoomReset** ツール操作の新しいインスタンスを作成し、それを **ZoomOut** に割り当てて配置を正確にします。また、ツールの プロパティによってもハイライト表示されます。 ### {Platform} データ チャートの統合 -{Platform} ツールバーには、 プロパティが含まれています。これは、以下のコードに示すように、`DataChart` などのコンポーネントをリンクするために使用されます。 +{Platform} ツールバーには、 プロパティが含まれています。これは、以下のコードに示すように、 などのコンポーネントをリンクするために使用されます。 @@ -299,47 +299,47 @@ ModuleManager.register( -`DataChart` が Toolbar にリンクされると、いくつかの既存の 項目とメニューが使用可能になります。以下は、組み込みの {Platform} `DataChart` ツール操作とそれに関連付けられた `OverlayId` のリストです。 + が Toolbar にリンクされると、いくつかの既存の 項目とメニューが使用可能になります。以下は、組み込みの {Platform} ツール操作とそれに関連付けられた のリストです。 ズーム操作 -- `ZoomMenu`: チャートのズーム レベルを増減するための `ZoomIn` および `ZoomOut` メソッドを呼び出す 3 つの `ToolActionLabel` 項目を公開する `ToolActionIconMenu` には、チャートの `ResetZoom` メソッドを呼び出してズーム レベルをデフォルトの位置にリセットする `ZoomReset` が含まれます。 +- `ZoomMenu`: チャートのズーム レベルを増減するための および メソッドを呼び出す 3 つの 項目を公開する には、チャートの メソッドを呼び出してズーム レベルをデフォルトの位置にリセットする `ZoomReset` が含まれます。 トレンド操作 -- `AnalyzeMenu`: チャートのさまざまなオプションを構成するためのいくつかのオプションを含む `ToolActionIconMenu`。 +- `AnalyzeMenu`: チャートのさまざまなオプションを構成するためのいくつかのオプションを含む 。 - `AnalyzeHeader`: サブ セクションのヘッダー。 - `LinesMenu`: チャート上で水平破線を表示するためのさまざまなツールが含まれるサブ メニュー。 - `LinesHeader`: 次の 3 つのツールのサブメニュー セクション ヘッダー: - - `MaxValue`: シリーズの最大値で yAxis に沿って水平破線を表示する `ToolActionCheckbox`。 - - `MinValue`: シリーズの最小値で yAxis に沿って水平破線を表示する `ToolActionCheckbox`。 - - `Average`: シリーズの平均値で yAxis に沿って水平破線を表示する `ToolActionCheckbox`。 - - `TrendsMenu`: さまざまな近似曲線を `DataChart` プロット領域に適用するためのツールを含むサブ メニュー。 + - `MaxValue`: シリーズの最大値で yAxis に沿って水平破線を表示する 。 + - `MinValue`: シリーズの最小値で yAxis に沿って水平破線を表示する 。 + - : シリーズの平均値で yAxis に沿って水平破線を表示する 。 + - `TrendsMenu`: さまざまな近似曲線を プロット領域に適用するためのツールを含むサブ メニュー。 - `TrendsHeader`: 次の 3 つのツールのサブメニュー セクション ヘッダー: - - **Exponential**: チャート内の各シリーズの `TrendLineType` を **ExponentialFit** に設定する `ToolActionRadio`。 - - **Linear**: チャート内の各シリーズの `TrendLineType` を **LinearFit** に設定する `ToolActionRadio`。 - - **Logarithmic**: チャート内の各シリーズの `TrendLineType` を **LogarithmicFit** に設定する `ToolActionRadio`。 + - **Exponential**: チャート内の各シリーズの を **ExponentialFit** に設定する 。 + - **Linear**: チャート内の各シリーズの を **LinearFit** に設定する 。 + - **Logarithmic**: チャート内の各シリーズの を **LogarithmicFit** に設定する 。 - `HelpersHeader`: サブ セクションのヘッダー。 - - `SeriesAvg`: `Average` タイプの `ValueLayerValueMode` を使用して、チャートのシリーズ コレクションに `ValueLayer` を追加または削除する `ToolActionCheckbox`。 - - `ValueLabelsMenu`: `DataChart` のプロット領域に注釈を表示するためのさまざまなツールを含むサブ メニュー。 + - `SeriesAvg`: タイプの を使用して、チャートのシリーズ コレクションに を追加または削除する 。 + - `ValueLabelsMenu`: のプロット領域に注釈を表示するためのさまざまなツールを含むサブ メニュー。 - `ValueLabelsHeader`: 次のツールのサブ メニュー セクション ヘッダー: - - `ShowValueLabels`: `CalloutLayer` を使用してデータ ポイント値を切り替える `ToolActionCheckbox`。 - - `ShowLastValueLabel`: `FinalValueLayer` を使用して最終値軸の注釈を切り替える `ToolActionCheckbox`。 -- `ShowCrosshairs`: チャートの `CrosshairsDisplayMode` プロパティを介してマウスオーバー十字線の注釈を切り替える `ToolActionCheckbox`。 -- `ShowGridlines`: X-Axis に `MajorStroke` を適用することで追加のグリッド線を切り替える `ToolActionCheckbox`。 + - `ShowValueLabels`: を使用してデータ ポイント値を切り替える 。 + - `ShowLastValueLabel`: を使用して最終値軸の注釈を切り替える 。 +- `ShowCrosshairs`: チャートの プロパティを介してマウスオーバー十字線の注釈を切り替える 。 +- `ShowGridlines`: X-Axis に `MajorStroke` を適用することで追加のグリッド線を切り替える 。 画像に保存アクション -- `CopyAsImage`: チャートをクリップボードにコピーするオプションを公開する `ToolActionLabel`。 +- `CopyAsImage`: チャートをクリップボードにコピーするオプションを公開する 。 - `CopyHeader`: サブ セクションのヘッダー。 ### SVG アイコン -ツールを手動で追加する場合、 メソッドを使用してアイコンを割り当てることができます。このメソッドには 3 つのパラメーターを渡す必要があります。1 つ目は、ツールで定義されたアイコン コレクション名です (例: `IconCollectionName`)。2 つ目は、ツールで定義されたアイコンの名前 (例: `IconName`) で、その後に SVG 文字列を追加します。 +ツールを手動で追加する場合、`RenderIconFromText` メソッドを使用してアイコンを割り当てることができます。このメソッドには 3 つのパラメーターを渡す必要があります。1 つ目は、ツールで定義されたアイコン コレクション名です (例: )。2 つ目は、ツールで定義されたアイコンの名前 (例: ) で、その後に SVG 文字列を追加します。 ### データ URL アイコン -svg を追加するのと同様に、 を介して URL からアイコン画像を追加することもできます。メソッドの 3 番目のパラメーターは、文字列 URL を入力するために使用されます。 +svg を追加するのと同様に、 を介して URL からアイコン画像を追加することもできます。メソッドの 3 番目のパラメーターは、文字列 URL を入力するために使用されます。 次のスニペットは、アイコンを追加する両方の方法を示しています。 @@ -451,7 +451,7 @@ public toolbarCustomIconOnViewInit(): void { ### Vertical Orientation -By default the {Platform} Toolbar is shown horizontally, but it also has the ability to shown vertically by setting the property. +By default the {Platform} Toolbar is shown horizontally, but it also has the ability to shown vertically by setting the property. @@ -562,7 +562,7 @@ The following example demonstrates styling the {Platform} Data Chart series brus {/* ## Styling/Theming -The icon component can be styled by using it's `BaseTheme` property directly to the `Toolbar`. +The icon component can be styled by using it's property directly to the . @@ -603,7 +603,7 @@ The icon component can be styled by using it's `BaseTheme` property directly to ## API References -
+

## Additional Resources diff --git a/docs/xplat/src/content/jp/components/notifications/banner.mdx b/docs/xplat/src/content/jp/components/notifications/banner.mdx index 9d3dfa6978..811e49dea7 100644 --- a/docs/xplat/src/content/jp/components/notifications/banner.mdx +++ b/docs/xplat/src/content/jp/components/notifications/banner.mdx @@ -34,7 +34,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -次に、以下のように、`Banner` とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: +次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: ```ts import { defineComponents, IgcBannerComponent } from "igniteui-webcomponents"; @@ -56,7 +56,7 @@ defineComponents(IgcBannerComponent); npm install igniteui-react ``` -次に、以下のように、`Banner` と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrBanner } from 'igniteui-react'; @@ -70,7 +70,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -`Banner` を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: ```razor // in Program.cs file @@ -78,7 +78,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; builder.Services.AddIgniteUIBlazor(typeof(IgbBannerModule)); ``` -スタイルを `Banner` コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -141,13 +141,13 @@ Banner コンポーネントを表示するには、ボタン クリックで - には、バナーを閉じるデフォルトの `OK` アクション ボタンが含まれています。 + には、バナーを閉じるデフォルトの `OK` アクション ボタンが含まれています。 ## 例 - コンポーネントは、マテリアル デザイン バナー ガイドラインにできるかぎり準拠しながらコンテンツをテンプレート化します。 + コンポーネントは、マテリアル デザイン バナー ガイドラインにできるかぎり準拠しながらコンテンツをテンプレート化します。 ### バナー メッセージの変更 @@ -263,7 +263,7 @@ Banner コンポーネントを表示するには、ボタン クリックで は、バナー ボタンをテンプレート化するための `actions` スロットを公開します。これにより、デフォルトのバナー ボタン (`OK`) をオーバーライドし、ユーザー定義のカスタム操作を追加します。 + は、バナー ボタンをテンプレート化するための `actions` スロットを公開します。これにより、デフォルトのバナー ボタン (`OK`) をオーバーライドし、ユーザー定義のカスタム操作を追加します。 @@ -481,7 +481,7 @@ function handleClosing() { -> Google の[マテリアル デザイン ガイドライン](https://material.io/design/components/banners.html#anatomy)では、バナーはに表示するボタンは 2 つまでです。 は、`actions` スロットの要素数を明示的に制限しませんが、マテリアル デザイン ガイドに従う場合は、最大 2 つの要素を使用することを強くお勧めします。 +> Google の[マテリアル デザイン ガイドライン](https://material.io/design/components/banners.html#anatomy)では、バナーはに表示するボタンは 2 つまでです。 は、`actions` スロットの要素数を明示的に制限しませんが、マテリアル デザイン ガイドに従う場合は、最大 2 つの要素を使用することを強くお勧めします。 閉じるオプション (**Continue Offline**) は詳細なロジックを必要としないため、 のみの呼び出しが可能です。しかし、確認アクション (**Turn On Wifi**) は追加のロジックを必要とするため、コンポーネントで定義する必要があります。次に、`click` イベントのイベント リスナーを追加します。最後に、変更するたびに `refreshBanner()` メソッドを呼び出します。これにより、`wifiState` に基づいてバナーを切り替えます。 @@ -636,7 +636,7 @@ return( ## スタイル設定 -`Banner` コンポーネントはいくつかの CSS パーツを公開し、スタイルを完全に制御できるようにします。 + コンポーネントはいくつかの CSS パーツを公開し、スタイルを完全に制御できるようにします。 |名前|説明| |--|--| @@ -667,7 +667,7 @@ igc-banner::part(content) { ## API リファレンス -
+



diff --git a/docs/xplat/src/content/jp/components/notifications/dialog.mdx b/docs/xplat/src/content/jp/components/notifications/dialog.mdx index 2d594eb3fd..ca975c68d4 100644 --- a/docs/xplat/src/content/jp/components/notifications/dialog.mdx +++ b/docs/xplat/src/content/jp/components/notifications/dialog.mdx @@ -79,7 +79,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; -{Platform} `Dialog` を使用する前に、次のように登録する必要があります: +{Platform} を使用する前に、次のように登録する必要があります: ```razor diff --git a/docs/xplat/src/content/jp/components/notifications/snackbar.mdx b/docs/xplat/src/content/jp/components/notifications/snackbar.mdx index 35e845a1ac..9f91a8a006 100644 --- a/docs/xplat/src/content/jp/components/notifications/snackbar.mdx +++ b/docs/xplat/src/content/jp/components/notifications/snackbar.mdx @@ -18,7 +18,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## {ProductName} Snackbar の例 -このサンプルは、`Snackbar` コンポーネントを作成する方法を示しています。 +このサンプルは、 コンポーネントを作成する方法を示しています。 @@ -52,7 +52,7 @@ npm install {PackageWebComponents} npm install igniteui-react ``` -次に、以下のように、 と必要な CSS をインポートする必要があります: +次に、以下のように、 と必要な CSS をインポートする必要があります: ```tsx import { IgrSnackbar } from 'igniteui-react'; @@ -63,7 +63,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; - を使用する前に、次のように登録する必要があります: + を使用する前に、次のように登録する必要があります: @@ -81,7 +81,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbSnackbarModule)); -また、追加の CSS ファイルをリンクして、スタイルを `Snackbar` コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -168,7 +168,7 @@ const onShowButtonClicked = () => { ## スタイル設定 - コンポーネントはいくつかの CSS パーツを公開し、スタイルを完全に制御できるようにします。 + コンポーネントはいくつかの CSS パーツを公開し、スタイルを完全に制御できるようにします。 |名前|説明| |--|--| @@ -194,7 +194,7 @@ igc-snackbar::part(base) { ## API リファレンス -
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/radial-gauge.mdx b/docs/xplat/src/content/jp/components/radial-gauge.mdx index 6acd8e67dd..4b81bdd3d8 100644 --- a/docs/xplat/src/content/jp/components/radial-gauge.mdx +++ b/docs/xplat/src/content/jp/components/radial-gauge.mdx @@ -14,11 +14,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} ラジアル ゲージの概要 -{Platform} Radial Gauge コンポーネントは、針、目盛り、範囲、ラベルなどの視覚要素をサポートし、定義済みの図形やスケールを表示できます。`RadialGauge` には、アニメーション化されたトランジションのサポートも組み込まれています。アニメーションは、 プロパティの設定で簡単にカスタマイズできます。 +{Platform} Radial Gauge コンポーネントは、針、目盛り、範囲、ラベルなどの視覚要素をサポートし、定義済みの図形やスケールを表示できます。 には、アニメーション化されたトランジションのサポートも組み込まれています。アニメーションは、 プロパティの設定で簡単にカスタマイズできます。 ## {Platform} ラジアル ゲージの例 -以下のサンプルは、同じ `RadialGauge` でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 +以下のサンプルは、同じ でいくつかのプロパティを設定して全く異なるゲージにする方法を示します。 @@ -65,7 +65,7 @@ Afterwards you may start implementing the control by adding the following namesp ## モジュールの要件 -`RadialGauge` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 @@ -241,7 +241,7 @@ IgrRadialGaugeModule.register(); バッキング要素はラジアル ゲージ コントロールの背景と境界線を表します。常に最初に描画される要素で針、ラベルやメモリなどの残りの要素はその上のオーバーレイです。 -バッキングは、円形またはフィットにできます。円形の場合は 360 度の円形のゲージが作成されますが、一方フィット図形の場合は `ScaleStartAngle` および `ScaleEndAngle` プロパティで円弧部分が塗りつぶされます。これには、`BackingShape` プロパティを設定します。 +バッキングは、円形またはフィットにできます。円形の場合は 360 度の円形のゲージが作成されますが、一方フィット図形の場合は および プロパティで円弧部分が塗りつぶされます。これには、 プロパティを設定します。 @@ -336,7 +336,7 @@ IgrRadialGaugeModule.register(); ## スケール -スケールは視覚要素で、`MinimumValue` と `MaximumValue` 値を設定してゲージの値範囲全体をハイライト表示できます。バッキングとともにゲージの全体的な図形を定義します。`ScaleStartAngle` と `ScaleEndAngle` プロパティは、スケールの円弧の境界線を定義します。`ScaleSweepDirection` プロパティが、スケールが時計回りまたは反時計回りのどちらの方向に動くかを指定します。`ScaleBrush`、`ScaleStartExtent`、`ScaleEndExtent` プロパティを設定してスケールの外観をカスタマイズできます。 +スケールは視覚要素で、 値を設定してゲージの値範囲全体をハイライト表示できます。バッキングとともにゲージの全体的な図形を定義します。 プロパティは、スケールの円弧の境界線を定義します。 プロパティが、スケールが時計回りまたは反時計回りのどちらの方向に動くかを指定します。 プロパティを設定してスケールの外観をカスタマイズできます。 @@ -425,9 +425,9 @@ IgrRadialGaugeModule.register(); ## ラベルとタイトル -ゲージ ラベルは `MinimumValue` と `MaximumValue` の値の間で指定された間隔で数値を表示する視覚要素です。0 はゲージ中央、1 はゲージ バッキングの外側範囲を表す `LabelExtent` プロパティで小数を使用してラベルの配置を設定できます。`FontBrush` や `Font` など、さまざまなスタイル プロパティを設定してラベルをカスタマイズできます。 +ゲージ ラベルは の値の間で指定された間隔で数値を表示する視覚要素です。0 はゲージ中央、1 はゲージ バッキングの外側範囲を表す プロパティで小数を使用してラベルの配置を設定できます。 など、さまざまなスタイル プロパティを設定してラベルをカスタマイズできます。 -これらの針のラベルにはそれぞれ、`TitleExtent`、`TitleAngle`、`SubtitleFontSize`、`HighlightLabelBrush` など、フォント、角度、ブラシ、ゲージの中心からの距離を変更するために適用できるさまざまなスタイル属性があります。 +これらの針のラベルにはそれぞれ、、`SubtitleFontSize`、 など、フォント、角度、ブラシ、ゲージの中心からの距離を変更するために適用できるさまざまなスタイル属性があります。 @@ -500,9 +500,9 @@ IgrRadialGaugeModule.register(); ## タイトルとサブタイトル -`TitleText` プロパティと `SubtitleText` プロパティが使用可能であり、どちらも針のカスタム テキストを表示するために使用できます。あるいは、`TitleDisplaysValue` と `SubtitleDisplaysValue` を true に設定すると、針の値が表示され、`TitleText` と `SubtitleText` がオーバーライドされます。したがって、タイトルにカスタム テキストを使用しながらサブタイトルで値を表示したり、その逆を行ったりすることができます。 + プロパティと プロパティが使用可能であり、どちらも針のカスタム テキストを表示するために使用できます。あるいは、 を true に設定すると、針の値が表示され、 がオーバーライドされます。したがって、タイトルにカスタム テキストを使用しながらサブタイトルで値を表示したり、その逆を行ったりすることができます。 -以下に説明するように針のハイライトが表示されている場合は、`HighlightLabelText` を介してカスタム テキストを表示できます。それ以外の場合は、`HighlightLabelDisplaysValue` を有効にしてその値を表示できます。 +以下に説明するように針のハイライトが表示されている場合は、 を介してカスタム テキストを表示できます。それ以外の場合は、 を有効にしてその値を表示できます。 @@ -550,14 +550,14 @@ IgrRadialGaugeModule.register(); ## オプティカル スケーリング -ラジアル ゲージのラベルとタイトルにより、スケーリングを変更できます。これを有効にするには、まず `OpticalScalingEnabled` を true に設定します。次に、ラベルが 100% のオプティカル スケーリングを持つサイズを管理する `OpticalScalingSize` を設定できます。ゲージのサイズが大きくなると、ラベルのフォントも大きくなります。たとえば、このプロパティが 500 に設定され、ゲージのピクセル単位のサイズが 2 倍の 1000 になると、ラベルのフォント サイズは 200% 大きくなります。 +ラジアル ゲージのラベルとタイトルにより、スケーリングを変更できます。これを有効にするには、まず を true に設定します。次に、ラベルが 100% のオプティカル スケーリングを持つサイズを管理する を設定できます。ゲージのサイズが大きくなると、ラベルのフォントも大きくなります。たとえば、このプロパティが 500 に設定され、ゲージのピクセル単位のサイズが 2 倍の 1000 になると、ラベルのフォント サイズは 200% 大きくなります。 ## 目盛 -目盛は、ラジアル ゲージの中央から放射状に表示される細い線です。目盛には、主目盛および副目盛の 2 種類があり、主目盛りは `MinimumValue` と `MaximumValue` の間の `Interval` に表示されます。また `MinorTickCount` プロパティは、隣接する 2 つの主目盛間の副目盛の数を指定します。目盛りの長さは、`TickStartExtent`、`TickEndExtent`、`MinorTickStartExtent`、`MinorTickEndExtent` に少数値 (0 から 1 の間) を設定して制御できます。 +目盛は、ラジアル ゲージの中央から放射状に表示される細い線です。目盛には、主目盛および副目盛の 2 種類があり、主目盛りは の間の に表示されます。また プロパティは、隣接する 2 つの主目盛間の副目盛の数を指定します。目盛りの長さは、 に少数値 (0 から 1 の間) を設定して制御できます。 @@ -650,7 +650,7 @@ IgrRadialGaugeModule.register(); ## 範囲 -範囲に `MinimumValue` や `MaximumValue` プロパティで指定した連続値の境界をハイライト表示します。開始値と終了値を指定してゲージに複数の範囲を追加でき、各範囲には、`Brush` や `Outline` などのカスタマイズ プロパティがあります。または、`RangeBrushes` や `RangeOutlines` プロパティを範囲の色リストに設定することもできます。 +範囲に プロパティで指定した連続値の境界をハイライト表示します。開始値と終了値を指定してゲージに複数の範囲を追加でき、各範囲には、 などのカスタマイズ プロパティがあります。または、 プロパティを範囲の色リストに設定することもできます。 @@ -756,9 +756,9 @@ IgrRadialGaugeModule.register(); ゲージ針は、ゲージの設定値を示す視覚要素です。針は、あらかじめ定義されたいくつかの図形の中から選択でき、ピボット図形をゲージの中心に配置できます。またピボット図形は、事前に定義された図形の 1 つを使用します。オーバーレイとアンダーレイを含むピボット図形には、図形に適用する別のピボット ブラシがあります。 -サポートされている針の形とキャップは、`NeedleShape` と `NeedlePivotShape` プロパティで設定します。 +サポートされている針の形とキャップは、 プロパティで設定します。 -ゲージのインタラクティブ モードを有効 (`IsNeedleDraggingEnabled` プロパティを使用) にするとユーザーは `MinimumValue` と `MaximumValue` の値間で針をドラッグして値を変更できるようになります。 +ゲージのインタラクティブ モードを有効 ( プロパティを使用) にするとユーザーは の値間で針をドラッグして値を変更できるようになります。 @@ -863,7 +863,7 @@ IgrRadialGaugeModule.register(); ## 針のハイライト -ラジアル ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の `Value` の不透明度が低く表示されます。これを有効にするには、まず `HighlightValueDisplayMode` を Overlay に設定し、次に `HighlightValue` を適用します。 +ラジアル ゲージを変更して、2 番目の針を表示できます。これにより、メイン針の の不透明度が低く表示されます。これを有効にするには、まず を Overlay に設定し、次に を適用します。 diff --git a/docs/xplat/src/content/jp/components/scheduling/calendar.mdx b/docs/xplat/src/content/jp/components/scheduling/calendar.mdx index 98b539cb1e..3435d7ebac 100644 --- a/docs/xplat/src/content/jp/components/scheduling/calendar.mdx +++ b/docs/xplat/src/content/jp/components/scheduling/calendar.mdx @@ -19,7 +19,7 @@ Ignite UI for {ProductName} Calendar は、日付情報を表示するための ## {Platform} Calendar の例 -次の {Platform} コンポーネントの例は、1 日選択モードの基本的なカレンダーを示しています。それがどのように機能するかを確認するか、コード ビハインドを調べます。 +次の {Platform} コンポーネントの例は、1 日選択モードの基本的なカレンダーを示しています。それがどのように機能するかを確認するか、コード ビハインドを調べます。
@@ -46,7 +46,7 @@ npm install {PackageWebComponents} npm install igniteui-react ``` -次に、以下のように、{ProductName} と必要な CSS をインポートする必要があります: +次に、以下のように、{ProductName} と必要な CSS をインポートする必要があります: ```tsx import { IgrCalendar } from 'igniteui-react'; @@ -56,7 +56,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css';
- を使用する前に、次のように登録する必要があります。 + を使用する前に、次のように登録する必要があります。 @@ -70,7 +70,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbCalendarModule)); -また、追加の CSS ファイルをリンクして、スタイルを {ProductName} コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +また、追加の CSS ファイルをリンクして、スタイルを {ProductName} コンポーネントに適用する必要があります。以下は、**Blazor Web Assembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -91,7 +91,7 @@ defineComponents(IgcCalendarComponent); {ProductName} の完全な概要については、[作業の開始](../general-getting-started.md)トピックを参照してください。 -{ProductName} の使用を開始する最も簡単な方法は次のとおりです。 +{ProductName} の使用を開始する最も簡単な方法は次のとおりです。 @@ -119,7 +119,7 @@ defineComponents(IgcCalendarComponent); ### 単一モード -ユーザーは、単一選択、複数選択、または範囲選択の 3 つの異なる選択モードから選択できます。デフォルトでは、{ProductName} は単一選択モードを使用していますが、この例に示すように `Selection` プロパティを設定することで変更できます。 +ユーザーは、単一選択、複数選択、または範囲選択の 3 つの異なる選択モードから選択できます。デフォルトでは、{ProductName} は単一選択モードを使用していますが、この例に示すように プロパティを設定することで変更できます。 @@ -149,7 +149,7 @@ defineComponents(IgcCalendarComponent); ### 範囲選択 -同じ方法に従って、`Selection` を範囲モードに切り替えることができます: +同じ方法に従って、 を範囲モードに切り替えることができます: @@ -180,18 +180,18 @@ defineComponents(IgcCalendarComponent); ### Active View と Date -{ProductName} Calendar コンポーネントを使用すると、日、月、年の 3 つの異なるビューを切り替えることができます。コンポーネントの `ActiveView` プロパティは、現在のビューを反映します。デフォルトでは、Calendar は最初に読み込まれたときに現在の日付を表示します。これは、`ActiveDate` プロパティを設定することで変更できます。`ActiveDate` プロパティは、エンド ユーザーが現在表示している日付の変更も反映します。 +{ProductName} Calendar コンポーネントを使用すると、日、月、年の 3 つの異なるビューを切り替えることができます。コンポーネントの プロパティは、現在のビューを反映します。デフォルトでは、Calendar は最初に読み込まれたときに現在の日付を表示します。これは、 プロパティを設定することで変更できます。 プロパティは、エンド ユーザーが現在表示している日付の変更も反映します。 ### ヘッダー オプション -デフォルトでは、{ProductName} Calendar コンポーネントは、選択された日付に関する情報を含むヘッダー領域を描画します。`HasHeader` プロパティを **false** に設定することで、ヘッダーを非表示にできます。`HeaderOrientation` プロパティを使用して、ヘッダーの `vertical` または `horizontal` を構成することもできます。 +デフォルトでは、{ProductName} Calendar コンポーネントは、選択された日付に関する情報を含むヘッダー領域を描画します。`HasHeader` プロパティを **false** に設定することで、ヘッダーを非表示にできます。 プロパティを使用して、ヘッダーの `vertical` または `horizontal` を構成することもできます。 -`Selection` が複数に設定されている場合、{ProductName} Calendar ヘッダーが描画されないことに注意してください。 + が複数に設定されている場合、{ProductName} Calendar ヘッダーが描画されないことに注意してください。 -{ProductName} Calendar の DOM プロパティは `camelCase` の命名を使用し、対応する HTML 属性は `kebab-case` を使用していることに注意してください。たとえば、`HeaderOrientation` プロパティは `header-orientation` 属性に対応します。 +{ProductName} Calendar の DOM プロパティは `camelCase` の命名を使用し、対応する HTML 属性は `kebab-case` を使用していることに注意してください。たとえば、 プロパティは `header-orientation` 属性に対応します。 {ProductName} Calendar コンポーネントは、ヘッダーのタイトルをカスタマイズできる `title` スロットを公開します。 @@ -234,9 +234,9 @@ defineComponents(IgcCalendarComponent); ### ローカライズおよび書式設定 -カレンダーにおいてローカライズおよび書式設定はとても重要な要素です。{ProductName} では、これらは `Locale`、`FormatOptions`、`WeekStart` のプロパティを介して制御およびカスタマイズされます。 +カレンダーにおいてローカライズおよび書式設定はとても重要な要素です。{ProductName} では、これらは のプロパティを介して制御およびカスタマイズされます。 -先に進んで、他のカスタマイズと一緒にそれらを試してみましょう。最初に設定する必要があるのは、週の開始日を制御する `WeekStart` です。デフォルトは `Sunday` なので、`Monday` に設定します。また、Calendar ビューで月と平日を書式設定するために使用されるオプションを指定する `FormatOptions` プロパティをカスタマイズします。最後に、ユーザーの場所の選択に基づいて、`Locale` プロパティを値に設定します: +先に進んで、他のカスタマイズと一緒にそれらを試してみましょう。最初に設定する必要があるのは、週の開始日を制御する です。デフォルトは `Sunday` なので、`Monday` に設定します。また、Calendar ビューで月と平日を書式設定するために使用されるオプションを指定する プロパティをカスタマイズします。最後に、ユーザーの場所の選択に基づいて、 プロパティを値に設定します: ```html @@ -326,14 +326,14 @@ public onRadioChange(e: any) { ### 日付の無効化 -場合によっては、エンド ユーザーが選択できない Calendar の日付を無効にしたいことがあります。この機能は、`DisabledDates` プロパティを使用して実現されます。`DisabledDates` プロパティは、`DateRangeDescriptor` オブジェクトの配列です。各記述子には `Type` があり、オプションで `Date` オブジェクトの配列である `DateRange` があります。 +場合によっては、エンド ユーザーが選択できない Calendar の日付を無効にしたいことがあります。この機能は、 プロパティを使用して実現されます。 プロパティは、 オブジェクトの配列です。各記述子には `Type` があり、オプションで `Date` オブジェクトの配列である があります。 `Type` プロパティで使用できるオプションは次のとおりです: -- `After` - `DateRange` の最初の日付以降の日付を無効にします。 -- `Before` - `DateRange` の最初の日付より前の日付を無効にします。 -- `Between` - `DateRange` の最初の日付と 2 番目の日付の間の日付を無効にします。 -- `Specific` - `DateRange` 配列で指定された日付を無効にします。 +- `After` - の最初の日付以降の日付を無効にします。 +- `Before` - の最初の日付より前の日付を無効にします。 +- `Between` - の最初の日付と 2 番目の日付の間の日付を無効にします。 +- `Specific` - 配列で指定された日付を無効にします。 - `Weekdays` - すべての平日を無効にします。 - `Weekends` - すべての週末を無効にします。 @@ -404,9 +404,9 @@ this.state = { disabledDates }; ### 特定の日付 -`SpecialDates` プロパティは、`DisabledDates` とほぼ同じ構成原則を使用しています。特別な日付はハイライト表示されたルック アンド フィールを持ち、無効な日付とは異なり、選択することができます。 + プロパティは、 とほぼ同じ構成原則を使用しています。特別な日付はハイライト表示されたルック アンド フィールを持ち、無効な日付とは異なり、選択することができます。 -Calendar に特別な日付を追加しましょう。これを行うために、`DateRangeDescriptor` を作成し、現在の月の 3 日から 8 日までの日付を渡します。 +Calendar に特別な日付を追加しましょう。これを行うために、 を作成し、現在の月の 3 日から 8 日までの日付を渡します。 ```ts const today = new Date(); @@ -476,7 +476,7 @@ this.state = { specialDates }; ### 週番号 -`ShowWeekNumbers` プロパティを使用して、Calendar コンポーネントの週番号を表示できます。これを行うには、対応するブール属性 `show-week-numbers` を次のように使用します: + プロパティを使用して、Calendar コンポーネントの週番号を表示できます。これを行うには、対応するブール属性 `show-week-numbers` を次のように使用します: @@ -508,9 +508,9 @@ this.state = { specialDates }; ### 複数の月 -`VisibleMonths` プロパティを使用すると、Calendar が `days` ビューのときに 1 か月以上表示できます。複数の月が表示されている場合は、`Orientation` プロパティを使用して、月を垂直方向にスタックするか水平方向にスタックするかを構成できます。デフォルトでは、`Orientation` プロパティは `horizontal` に設定されています。 + プロパティを使用すると、Calendar が `days` ビューのときに 1 か月以上表示できます。複数の月が表示されている場合は、 プロパティを使用して、月を垂直方向にスタックするか水平方向にスタックするかを構成できます。デフォルトでは、 プロパティは `horizontal` に設定されています。 -Calendar には、前月と翌月の前後の日付が表示されます。これらの日付を非表示にするには、`HideOutsideDays` プロパティを **true** に設定するか、対応するブール属性 `HideOutsideDays` を使用します。 +Calendar には、前月と翌月の前後の日付が表示されます。これらの日付を非表示にするには、 プロパティを **true** に設定するか、対応するブール属性 を使用します。 @@ -595,7 +595,7 @@ public onCalendarChange(e: IgrComponentDataValueChangedEventArgs) { - [次へ] ボタン - アクティブな日付要素 -`Calendar` コンポーネントの**日/月/年**がフォーカスされている場合は、次を使用します: + コンポーネントの**日/月/年**がフォーカスされている場合は、次を使用します: - PAGE UP キーを押すと、前の月/年のページに移動します。 - PAGE DOWN キーを押すと、次の月/年のページに移動します。 @@ -611,11 +611,11 @@ public onCalendarChange(e: IgrComponentDataValueChangedEventArgs) { `months` ビュー内の**月**がフォーカスされている場合は、次を使用します: -- SPACE または ENTER キーを押すと、`ActiveDate` が現在フォーカスされている月に変更され、`days` ビューに切り替わります。 +- SPACE または ENTER キーを押すと、 が現在フォーカスされている月に変更され、`days` ビューに切り替わります。 `years` ビュー内の**年**がフォーカスされている場合は、次を使用します: -- SPACE または ENTER キーを使用して、`ActiveDate` を現在フォーカスされている年に変更し、`months` ビューに切り替えます。 +- SPACE または ENTER キーを使用して、 を現在フォーカスされている年に変更し、`months` ビューに切り替えます。 サブヘッダー内の**前**または**次**のボタンにフォーカスがある場合は、次を使用します: @@ -633,7 +633,7 @@ public onCalendarChange(e: IgrComponentDataValueChangedEventArgs) { ## スタイル設定 -`Calendar` コンポーネントは、その内部要素のほぼすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します: + コンポーネントは、その内部要素のほぼすべての CSS パーツを公開します。次の表に、公開されているすべての CSS パーツを示します: |名前|説明| |--|--| @@ -674,7 +674,7 @@ public onCalendarChange(e: IgrComponentDataValueChangedEventArgs) { | `selected` | 選択された状態を示します。日付、月、年の要素に適用されます。 | | `current` | 現在の状態を示します。日付、月、年の要素に適用されます。 | -これらの CSS パーツを使用して、次のように コンポーネントの外観をカスタマイズできます: +これらの CSS パーツを使用して、次のように コンポーネントの外観をカスタマイズできます: ```css igc-calendar::part(date-inner selected), @@ -714,10 +714,10 @@ igc-calendar::part(navigation-button):focus { ## API リファレンス -
+


-`DateRangeDescriptor` + ## その他のリソース diff --git a/docs/xplat/src/content/jp/components/scheduling/date-picker.mdx b/docs/xplat/src/content/jp/components/scheduling/date-picker.mdx index 5678538b8a..5e6010f4d7 100644 --- a/docs/xplat/src/content/jp/components/scheduling/date-picker.mdx +++ b/docs/xplat/src/content/jp/components/scheduling/date-picker.mdx @@ -18,7 +18,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; {ProductName} Date Picker コンポーネントを使用すると、ユーザーは月表示のカレンダード ロップダウンまたは編集可能な入力フィールドから単一の日付を選択できます。{Platform} Date Picker は、カレンダーからのみ選択するための dialog モード、ロケール対応でカスタマイズ可能な日付の書式設定と検証の統合もサポートしています。 - コンポーネントは、{ProductName} のバージョン 5.0.018.7.0 以降の新しいコンポーネントです。このバージョンより前の古い は `XDatePicker` に名前が変更され、それぞれのドキュメント ページは「非推奨のコンポーネント」の下にあります。 + コンポーネントは、{ProductName} のバージョン 5.0.018.7.0 以降の新しいコンポーネントです。このバージョンより前の古い は `XDatePicker` に名前が変更され、それぞれのドキュメント ページは「非推奨のコンポーネント」の下にあります。 @@ -31,7 +31,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; 18.7.0 -. The old prior to this version has been renamed to `XDatePicker` and its respective documentation page can be found under "Deprecated Components" +. The old prior to this version has been renamed to `XDatePicker` and its respective documentation page can be found under "Deprecated Components" ## {Platform} Date Picker の例 @@ -49,7 +49,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; npm install {PackageWebComponents} ``` -次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: +次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: ```ts import { defineComponents, IgcDatePickerComponent } from 'igniteui-webcomponents'; @@ -68,7 +68,7 @@ defineComponents(IgcDatePickerComponent); npm install igniteui-react ``` -次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: +次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: ```tsx import { IgrDatePicker } from 'igniteui-react'; @@ -79,7 +79,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; - コンポーネントの使用を開始するには、最初にそのモジュールを登録する必要があります。 + コンポーネントの使用を開始するには、最初にそのモジュールを登録する必要があります。 ```razor // in Program.cs file @@ -87,7 +87,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; builder.Services.AddIgniteUIBlazor(typeof(IgbDatePickerModule)); ``` -スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -101,7 +101,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDatePickerModule)); ### 日付ピッカーの表示 -デフォルトの `dropdown` 状態の をインスタンス化するには、以下のコードを使用してください。 +デフォルトの `dropdown` 状態の をインスタンス化するには、以下のコードを使用してください。 @@ -133,13 +133,13 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDatePickerModule)); - は `date` または `string` にバインドできます。 + は `date` または `string` にバインドできます。 - は `date` にバインドできます。 + は `date` にバインドできます。 @@ -314,7 +314,7 @@ prefix スロットと suffix スロットを使用すると、入力のメイ ### キーボード ナビゲーション - には直感的なキーボード ナビゲーションがあり、マウスに触れることなく、さまざまな DatePart を簡単に増分、減分、またはジャンプできます。 + には直感的なキーボード ナビゲーションがあり、マウスに触れることなく、さまざまな DatePart を簡単に増分、減分、またはジャンプできます。 |キー|説明| |----|-----------| @@ -364,11 +364,11 @@ DatePicker は `dialog` モードもサポートしています。 ### 表示および入力形式 - and are properties which can be set to make the picker's editor follow a specified format. The is locale based, so if none is provided, the picker will default to the one used by the browser. + and are properties which can be set to make the picker's editor follow a specified format. The is locale based, so if none is provided, the picker will default to the one used by the browser. -`InputFormat` および `DisplayFormat` は、ピッカーのエディターが指定された形式に従うように設定できるプロパティです。`InputFormat` はロケール ベースであるため、何も指定されていない場合、ピッカーはデフォルトでブラウザーで使用されるものになります。 + および は、ピッカーのエディターが指定された形式に従うように設定できるプロパティです。 はロケール ベースであるため、何も指定されていない場合、ピッカーはデフォルトでブラウザーで使用されるものになります。 - is used to format the picker's input when it is not focused. If no is provided, the picker will use the as its . + is used to format the picker's input when it is not focused. If no is provided, the picker will use the as its . 注意すべき点は、Date Picker コンポーネントが `date` と `month` の部分がない形式で提供された場合、それらの部分に常に先行ゼロを追加することです。例えば、`d/M/yy` は `dd/MM/yy` になります。これは編集中にのみ適用されます。 @@ -376,7 +376,7 @@ DatePicker は `dialog` モードもサポートしています。 ### 増加および減少 - は、`StepUp` メソッドと `StepDown` メソッドを公開します。これらは両方とも `IgcDateTimeInput` から取得され、現在設定されている日付の特定の `DatePart` を増加および減少するために使用できます。 + は、 メソッドと メソッドを公開します。これらは両方とも `IgcDateTimeInput` から取得され、現在設定されている日付の特定の `DatePart` を増加および減少するために使用できます。 @@ -433,7 +433,7 @@ DatePicker は `dialog` モードもサポートしています。 ### フォーム - はフォーム要素で使用できます。コンポーネントの `Min` プロパティと `Max` プロパティはフォーム検証機能として機能します。 + はフォーム要素で使用できます。コンポーネントの プロパティと プロパティはフォーム検証機能として機能します。 @@ -457,13 +457,13 @@ DatePicker は `dialog` モードもサポートしています。 ### カレンダー固有の設定 - は、Date Picker が公開するプロパティを通じて、カレンダーの設定の一部を変更できます。これらの一部には、ピッカーが展開されたときに複数のカレンダーを表示できる `VisibleMonths`、週の開始日を決定する `WeekStart`、年の各週の番号を表示する `ShowWeekNumbers` などが含まれます。 + は、Date Picker が公開するプロパティを通じて、カレンダーの設定の一部を変更できます。これらの一部には、ピッカーが展開されたときに複数のカレンダーを表示できる 、週の開始日を決定する 、年の各週の番号を表示する などが含まれます。 ## インターナショナリゼーション - のローカライズは、`Locale` 入力で制御できます。 + のローカライズは、 入力で制御できます。 -以下は日本ロケール定義を持つ `DatePicker` です。 +以下は日本ロケール定義を持つ です。 @@ -492,7 +492,7 @@ DatePicker は `dialog` モードもサポートしています。 ## スタイル設定 - コンポーネントは コンポーネントおよび コンポーネントから派生するため、使用可能なすべての CSS パーツを公開します。詳細については、[Input のスタイル設定](../inputs/input.md#スタイル設定)と [Calendar のスタイル設定](calendar.md#スタイル設定)を参照してください。 + コンポーネントは コンポーネントおよび コンポーネントから派生するため、使用可能なすべての CSS パーツを公開します。詳細については、[Input のスタイル設定](../inputs/input.md#スタイル設定)と [Calendar のスタイル設定](calendar.md#スタイル設定)を参照してください。 ```css igc-date-picker::part(header) { @@ -532,7 +532,7 @@ igc-date-picker::part(year-inner selected) {

-
+
## その他のリソース diff --git a/docs/xplat/src/content/jp/components/scheduling/date-range-picker.mdx b/docs/xplat/src/content/jp/components/scheduling/date-range-picker.mdx index c09c5c0455..caed8d18b2 100644 --- a/docs/xplat/src/content/jp/components/scheduling/date-range-picker.mdx +++ b/docs/xplat/src/content/jp/components/scheduling/date-range-picker.mdx @@ -18,7 +18,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## Date Range Picker の例 -以下は、カレンダーのポップアップを使用して開始日と終了日を選択できる コンポーネントのサンプルです。 +以下は、カレンダーのポップアップを使用して開始日と終了日を選択できる コンポーネントのサンプルです。 @@ -30,13 +30,13 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; - の使用を開始するには、最初に次のコマンドを実行して Ignite UI for Web Components をインストールする必要があります。 + の使用を開始するには、最初に次のコマンドを実行して Ignite UI for Web Components をインストールする必要があります。 ```cmd npm install {PackageWebComponents} ``` -次に、以下のように、`DateRangePicker` とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: +次に、以下のように、 とそれに必要な CSS をインポートし、そのモジュールを登録する必要があります: ```ts import { defineComponents, IgcDateRangePickerComponent } from 'igniteui-webcomponents'; @@ -54,13 +54,13 @@ defineComponents(IgcDateRangePickerComponent); - の使用を開始するには、最初に次のコマンドを実行して Ignite UI for React をインストールする必要があります。 + の使用を開始するには、最初に次のコマンドを実行して Ignite UI for React をインストールする必要があります。 ```cmd npm install igniteui-react ``` -その後、次のように `DateRangePicker` をインポートする必要があります。 +その後、次のように をインポートする必要があります。 ```tsx import { IgrDateRangePicker } from 'igniteui-react'; @@ -74,7 +74,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; - コンポーネントの使用を開始するには、最初にそのモジュールを登録する必要があります。 + コンポーネントの使用を開始するには、最初にそのモジュールを登録する必要があります。 ```razor // in Program.cs file @@ -82,7 +82,7 @@ import 'igniteui-webcomponents/themes/light/bootstrap.css'; builder.Services.AddIgniteUIBlazor(typeof(IgbDateRangePickerModule)); ``` -スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: +スタイルを コンポーネントに適用するには、追加の CSS ファイルをリンクする必要もあります。以下は、**Blazor WebAssembly** プロジェクトの **wwwroot/index.html** ファイルまたは **Blazor Server** プロジェクトの **Pages/_Host.cshtml** ファイルに配置する必要があります: ```razor @@ -91,13 +91,13 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDateRangePickerModule)); -これで、{Platform} の基本構成から始めることができます。 +これで、{Platform} の基本構成から始めることができます。 {ProductName} の完全な概要については、[作業の開始](../general-getting-started.md)トピックを参照してください。 ## 使用方法 - では、ドロップダウンやカレンダーのポップアップから日付範囲を選択するか、開始日と終了日それぞれの入力フィールドに直接入力することで、日付範囲を指定できます。 + では、ドロップダウンやカレンダーのポップアップから日付範囲を選択するか、開始日と終了日それぞれの入力フィールドに直接入力することで、日付範囲を指定できます。 ピッカーは、日付を表示するために 「シングル インプット モード」 と 「2 インプット モード」 の 2 タイプのモードを提供します。シングル インプット モードでは、フィールドは編集不可で、日付範囲を入力して変更することはできません。一方で 2 インプット モードでは、開始日と終了日を別々の入力欄に入力して編集できます。 @@ -105,7 +105,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDateRangePickerModule)); ### Date Range Picker の表示 -デフォルトのシングル インプット モードで をインスタンス化するには、次のコードを使用します: +デフォルトのシングル インプット モードで をインスタンス化するには、次のコードを使用します: @@ -132,7 +132,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDateRangePickerModule)); - を 2 つの入力欄を使用するように切り替えるには、`UseTwoInputs` プロパティを **true** に設定します。 + を 2 つの入力欄を使用するように切り替えるには、 プロパティを **true** に設定します。 @@ -161,7 +161,7 @@ builder.Services.AddIgniteUIBlazor(typeof(IgbDateRangePickerModule)); ### Value (値) -ユーザーによる選択または入力に加えて、 の範囲値は `Value` プロパティを使用して設定することもできます。値は次の形式に従う必要があります: **`{ start: startDate, end: endDate }`**、ここで `startDate` と `endDate` は選択された範囲を表す `Date` オブジェクトです。 +ユーザーによる選択または入力に加えて、 の範囲値は プロパティを使用して設定することもできます。値は次の形式に従う必要があります: **`{ start: startDate, end: endDate }`**、ここで `startDate` と `endDate` は選択された範囲を表す `Date` オブジェクトです。 @@ -233,7 +233,7 @@ return ( ### Read-only (読み取り専用) および Non-editable (編集不可) - を読み取り専用に設定すると、入力やカレンダーでの範囲変更が無効になり、キーボード ナビゲーションも無効になります。また、カレンダーやクリア アイコンも視覚的に無効状態になります。これは、value 属性で範囲を設定し、それを表示専用にしたい場合に便利です。この動作を有効にするには、`ReadOnly` プロパティを設定するだけです。 + を読み取り専用に設定すると、入力やカレンダーでの範囲変更が無効になり、キーボード ナビゲーションも無効になります。また、カレンダーやクリア アイコンも視覚的に無効状態になります。これは、value 属性で範囲を設定し、それを表示専用にしたい場合に便利です。この動作を有効にするには、 プロパティを設定するだけです。 @@ -260,7 +260,7 @@ return ( -あるいは、`NonEditable` プロパティを使用することもできます。これは `ReadOnly` とは異なり、入力欄のタイピングによる編集のみを禁止し、カレンダーからの選択やクリア アイコンでのリセットは可能です。 +あるいは、 プロパティを使用することもできます。これは とは異なり、入力欄のタイピングによる編集のみを禁止し、カレンダーからの選択やクリア アイコンでのリセットは可能です。 @@ -289,7 +289,7 @@ return ( ### ポップアップ モード -デフォルトでは、 をクリックすると、カレンダーのポップアップが `dropdown` モードで表示されます。`Mode` プロパティを `dialog` に設定することで、カレンダーを `dialog` モードで開くこともできます。 +デフォルトでは、 をクリックすると、カレンダーのポップアップが `dropdown` モードで表示されます。 プロパティを `dialog` に設定することで、カレンダーを `dialog` モードで開くこともできます。 @@ -318,7 +318,7 @@ return ( ### キーボード ナビゲーション - は直感的なキーボード ナビゲーションに対応しており、マウスを使わずに値の増減や入力マスクのセクション間の移動が可能です。 + は直感的なキーボード ナビゲーションに対応しており、マウスを使わずに値の増減や入力マスクのセクション間の移動が可能です。 使用可能なキーボード ナビゲーション オプションは、コンポーネントがシングル インプット モードか 2 インプット モードかによって異なります。 @@ -361,7 +361,7 @@ return ( ### Label (ラベル) -シングル インプット モードの場合、`Label` プロパティを使用して コンポーネントにラベルを設定できます。2 インプット モードでは、`LabelStart` および `LabelEnd` プロパティを使用して、それぞれ開始日および終了日の入力フィールドにラベルを設定できます。 +シングル インプット モードの場合、 プロパティを使用して コンポーネントにラベルを設定できます。2 インプット モードでは、 および プロパティを使用して、それぞれ開始日および終了日の入力フィールドにラベルを設定できます。 @@ -415,9 +415,9 @@ return ( ### Format (形式) -入力フィールドに表示される日付形式をカスタマイズすることも可能です。この目的のために使用できるプロパティは、`Locale`、`InputFormat`、および `DisplayFormat` の 3 つです。 +入力フィールドに表示される日付形式をカスタマイズすることも可能です。この目的のために使用できるプロパティは、、および の 3 つです。 -`Locale` プロパティでは、使用するロケール識別子を指定でき、地域の慣習に基づいて日付の表示形式が決定されます。 + プロパティでは、使用するロケール識別子を指定でき、地域の慣習に基づいて日付の表示形式が決定されます。 たとえば、日付を日本形式で表示したい場合、locale プロパティを次のように設定します: @@ -445,7 +445,7 @@ return ( -日付形式を手動で定義したい場合は、カスタム形式の文字列を渡して `InputFormat` プロパティを使用できます。 +日付形式を手動で定義したい場合は、カスタム形式の文字列を渡して プロパティを使用できます。 @@ -472,7 +472,7 @@ return ( -`DisplayFormat` プロパティはカスタム形式文字列も受け入れますが、入力フィールドがアイドル状態 (つまり、フォーカスされていない状態) の場合にのみ適用されます。フィールドにフォーカスがある場合、形式はデフォルト、または `InputFormat` で定義された形式に戻ります (両方のプロパティが使用されている場合)。 + プロパティはカスタム形式文字列も受け入れますが、入力フィールドがアイドル状態 (つまり、フォーカスされていない状態) の場合にのみ適用されます。フィールドにフォーカスがある場合、形式はデフォルト、または で定義された形式に戻ります (両方のプロパティが使用されている場合)。 @@ -544,7 +544,7 @@ return ( ### Min (最小値) および Max (最大値) -`Min` および `Max` プロパティを使用して、定義した範囲外の日付を無効にすることで、ユーザーの入力を制限することもできます。これらのプロパティはバリデーターとして機能するため、範囲外の日付が手動で入力された場合でも、 は無効になります。 + および プロパティを使用して、定義した範囲外の日付を無効にすることで、ユーザーの入力を制限することもできます。これらのプロパティはバリデーターとして機能するため、範囲外の日付が手動で入力された場合でも、 は無効になります。 @@ -578,7 +578,7 @@ return ( ### カスタムおよび定義済みの日付範囲 -`CustomRanges` プロパティを使用して、範囲選択を高速化するために、カレンダー ポップアップにカスタム日付範囲チップを追加することもできます。たとえば、現在の日付を終了日とし、今後 7 日間の範囲をすぐに選択できるカスタム日付範囲チップを作成できます。さらに、`UsePredefinedRanges` プロパティを設定すると、カスタム チップに加えて定義済みの範囲チップも表示されます。 + プロパティを使用して、範囲選択を高速化するために、カレンダー ポップアップにカスタム日付範囲チップを追加することもできます。たとえば、現在の日付を終了日とし、今後 7 日間の範囲をすぐに選択できるカスタム日付範囲チップを作成できます。さらに、 プロパティを設定すると、カスタム チップに加えて定義済みの範囲チップも表示されます。 @@ -671,7 +671,7 @@ return ( ### 無効日と特別な日 -カレンダーで無効な日付を設定して、ユーザーが選択できる日付の範囲を絞り込むこともできます。無効にする日付を設定するには、`DisabledDates` プロパティを使用できます。 +カレンダーで無効な日付を設定して、ユーザーが選択できる日付の範囲を絞り込むこともできます。無効にする日付を設定するには、 プロパティを使用できます。 @@ -730,13 +730,13 @@ return ( -`DisabledDates` プロパティが提供するすべての可能性に関する詳細情報は、以下で確認できます: [無効日](./calendar.md#日付の無効化) + プロパティが提供するすべての可能性に関する詳細情報は、以下で確認できます: [無効日](./calendar.md#日付の無効化) -同様に、カレンダーに 1 日または複数の日付を特別な日として設定したい場合も可能です。この場合は `SpecialDates` プロパティを使用します。([特別な日](./calendar.md#特定の日付)) +同様に、カレンダーに 1 日または複数の日付を特別な日として設定したい場合も可能です。この場合は プロパティを使用します。([特別な日](./calendar.md#特定の日付)) ### フォーム - コンポーネントは、HTML フォーム要素とシームレスに使用することもできます。`Min`、`Max`、`Required` プロパティはフォーム検証子として機能します。 + コンポーネントは、HTML フォーム要素とシームレスに使用することもできます。 プロパティはフォーム検証子として機能します。 @@ -745,12 +745,12 @@ return ( ### プロパティ -すでに紹介したプロパティに加えて、 コンポーネントには動作をさらに細かく設定できるさまざまなプロパティが用意されています。 +すでに紹介したプロパティに加えて、 コンポーネントには動作をさらに細かく設定できるさまざまなプロパティが用意されています。 |名前|タイプ|説明| |--|--|--| | | boolean | コンポーネントを無効にします。 | -| | boolean | 入力フィールドでの入力を無効にします。 | +| | boolean | 入力フィールドでの入力を無効にします。 | | | string | シングル インプット モード時のプレースホルダー テキスト。 | | | string | 開始日入力 (2 インプット モード) のプレースホルダー テキスト。 | | | string | 終了日入力 (2 インプット モード) のプレースホルダー テキスト。 | @@ -760,7 +760,7 @@ return ( ### スロット -`DateRangePicker` コンポーネントでは、利用可能なスロットを使用して、カスタム コンテンツを追加したり、外観を変更したりすることも可能です。 + コンポーネントでは、利用可能なスロットを使用して、カスタム コンテンツを追加したり、外観を変更したりすることも可能です。 シングル インプット モードでは、`prefix` および `suffix` スロットを使って、入力フィールドの前後にカスタム コンテンツを挿入できます。 @@ -905,7 +905,7 @@ return ( -これまでに説明したスロットに加えて、`DateRangePicker` コンポーネントでは次のスロットも使用できます。 +これまでに説明したスロットに加えて、 コンポーネントでは次のスロットも使用できます。 |名前|説明| |--|--| @@ -925,7 +925,7 @@ return ( ### メソッド - は、プロパティやスロットに加えて、次のメソッドも公開しています: + は、プロパティやスロットに加えて、次のメソッドも公開しています: |名前|説明| |--|--| @@ -938,7 +938,7 @@ return ( ## スタイル設定 - コンポーネントは コンポーネントを使用しているため、Calendar の CSS パーツも継承されており、両コンポーネントをシームレスにスタイル設定できます。Calendar コンポーネントで使用可能なすべての CSS パーツの一覧はこちらをご覧ください: [カレンダーのスタイル設定](calendar.md#スタイル設定)。Calendar の CSS パーツに加えて、 は以下のような独自の CSS パーツも提供しており、外観をさらにカスタマイズできます: + コンポーネントは コンポーネントを使用しているため、Calendar の CSS パーツも継承されており、両コンポーネントをシームレスにスタイル設定できます。Calendar コンポーネントで使用可能なすべての CSS パーツの一覧はこちらをご覧ください: [カレンダーのスタイル設定](calendar.md#スタイル設定)。Calendar の CSS パーツに加えて、 は以下のような独自の CSS パーツも提供しており、外観をさらにカスタマイズできます: |名前|説明| |--|--| @@ -991,7 +991,7 @@ igc-date-range-picker::part(clear-icon-end) {

-
+


diff --git a/docs/xplat/src/content/jp/components/spreadsheet-activation.mdx b/docs/xplat/src/content/jp/components/spreadsheet-activation.mdx index 06bd999b8e..f5611d0c23 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-activation.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-activation.mdx @@ -31,15 +31,15 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## アクティベーションの概要 -{Platform} コントロールのアクティブ化は、スプレッドシートの現在の のセル、ペイン、およびワークシート間で分割されます。3 つの アクティブなプロパティは以下のとおりです。 +{Platform} コントロールのアクティブ化は、スプレッドシートの現在の のセル、ペイン、およびワークシート間で分割されます。3 つの アクティブなプロパティは以下のとおりです。 -- : スプレッドシートのアクティブ セルを設定します。設定するには、 の新しいインスタンスを作成し、そのセルに関する列と行、またはセルの文字列アドレスなどの情報を渡す必要があります。 -- : スプレッドシート コントロールの現在アクティブなワークシートのアクティブ ペインを返します。 -- : スプレッドシート コントロールの 内のアクティブ ワークシートを返すか、設定します。これは、スプレッドシートに添付されている 内の既存のワークシートに設定することで設定できます。 +- : スプレッドシートのアクティブ セルを設定します。設定するには、 の新しいインスタンスを作成し、そのセルに関する列と行、またはセルの文字列アドレスなどの情報を渡す必要があります。 +- : スプレッドシート コントロールの現在アクティブなワークシートのアクティブ ペインを返します。 +- : スプレッドシート コントロールの 内のアクティブ ワークシートを返すか、設定します。これは、スプレッドシートに添付されている 内の既存のワークシートに設定することで設定できます。 ## コード スニペット -次のコード スニペットは、 コントロールのセルとワークシートのアクティブ化の設定を示しています。 +次のコード スニペットは、 コントロールのセルとワークシートのアクティブ化の設定を示しています。 ```ts this.spreadsheet.activeWorksheet = this.spreadsheet.workbook.worksheets(1); @@ -50,6 +50,6 @@ this.spreadsheet.activeCell = new SpreadsheetCell("C5"); ## API リファレンス -
-
+
+

diff --git a/docs/xplat/src/content/jp/components/spreadsheet-chart-adapter.mdx b/docs/xplat/src/content/jp/components/spreadsheet-chart-adapter.mdx index 822523e56f..04d5b33483 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-chart-adapter.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-chart-adapter.mdx @@ -14,7 +14,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} Spreadsheet チャート アダプター -{Platform} Spreadsheet コンポーネントを使用して にチャートを表示できます。 +{Platform} Spreadsheet コンポーネントを使用して にチャートを表示できます。 ## {Platform} Spreadsheet チャート アダプターの例 @@ -25,9 +25,9 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## チャート アダプターの概要 -`ChartAdapter` を使用すると、スプレッドシートにチャートを表示できます。スプレッドシート チャート アダプターは、Infragistics.Documents.Excel.WorksheetChart インスタンスに基づいてスプレッド シートのチャート要素を作成し、初期化します。 + を使用すると、スプレッドシートにチャートを表示できます。スプレッドシート チャート アダプターは、Infragistics.Documents.Excel.WorksheetChart インスタンスに基づいてスプレッド シートのチャート要素を作成し、初期化します。 -WorksheetChart をワークシートに追加するには、ワークシートの Shapes コレクションの `AddChart` メソッドを使用する必要があります。チャートの追加の詳細については、下記をご覧ください。 +WorksheetChart をワークシートに追加するには、ワークシートの Shapes コレクションの メソッドを使用する必要があります。チャートの追加の詳細については、下記をご覧ください。 以下はその手順です。 @@ -87,10 +87,10 @@ Spreadsheet ChartAdapter は、折れ線、エリア、縦棒、ドーナツを -以下のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して `Workbook` を保存およびロードしています。 +以下のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して を保存およびロードしています。 -ハイパーリンクを使用するように {Platform} スプレッドシート コントロールを設定するときは、`SpreadsheetChartAdapter` クラスをインポートする必要があります。 +ハイパーリンクを使用するように {Platform} スプレッドシート コントロールを設定するときは、 クラスをインポートする必要があります。 @@ -164,7 +164,7 @@ ModuleManager.register( ## コード スニペット -以下のコード スニペットは、 コントロールで現在表示されているワークシートにハイパーリンクを追加する方法を示しています。 +以下のコード スニペットは、 コントロールで現在表示されているワークシートにハイパーリンクを追加する方法を示しています。 ```typescript this.spreadsheet.chartAdapter = new SpreadsheetChartAdapter(); @@ -221,6 +221,6 @@ ExcelUtility.loadFromUrl(process.env.PUBLIC_URL + "/ExcelFiles/ChartData.xlsx"). ## API リファレンス -
-
+
+

diff --git a/docs/xplat/src/content/jp/components/spreadsheet-clipboard.mdx b/docs/xplat/src/content/jp/components/spreadsheet-clipboard.mdx index 1dd9543a49..7876f4cadb 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-clipboard.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-clipboard.mdx @@ -27,7 +27,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 依存関係 -クリップボードを利用する前に、 列挙型をインポートします。 +クリップボードを利用する前に、`SpreadsheetAction` 列挙型をインポートします。 @@ -61,7 +61,7 @@ import { SpreadsheetAction } from 'igniteui-webcomponents-spreadsheet'; ## 使用方法 -次のコード スニペットは、{Platform} コントロールでクリップボードに関連するコマンドを実行する方法を示しています。 +次のコード スニペットは、{Platform} コントロールでクリップボードに関連するコマンドを実行する方法を示しています。 ```ts public cut(): void { @@ -80,5 +80,5 @@ public paste(): void { ## API リファレンス -
-
+`SpreadsheetAction`
+
diff --git a/docs/xplat/src/content/jp/components/spreadsheet-commands.mdx b/docs/xplat/src/content/jp/components/spreadsheet-commands.mdx index 67939a58fc..fcfa9cdd26 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-commands.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-commands.mdx @@ -27,7 +27,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 依存関係 -コマンドボードを利用する前に、 をインポートします。 +コマンドボードを利用する前に、`SpreadsheetAction` をインポートします。 @@ -121,4 +121,4 @@ function zoomOut(): void { ## API リファレンス -
+`SpreadsheetAction`
diff --git a/docs/xplat/src/content/jp/components/spreadsheet-conditional-formatting.mdx b/docs/xplat/src/content/jp/components/spreadsheet-conditional-formatting.mdx index d12ffbb959..58c027547a 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-conditional-formatting.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-conditional-formatting.mdx @@ -27,37 +27,37 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## 条件付き書式設定の概要 -特定のワークシートの条件付き書式を構成するには、ワークシートの `ConditionalFormats` コレクションに公開される `Add` メソッドを使用できます。この `Add` メソッドの最初のパラメーターは条件付き書式に適用するワークシートの string 領域です。 +特定のワークシートの条件付き書式を構成するには、ワークシートの コレクションに公開される `Add` メソッドを使用できます。この `Add` メソッドの最初のパラメーターは条件付き書式に適用するワークシートの string 領域です。 -ワークシートに追加できる条件付き書式の多くには、その条件付き書式の条件が満たされたときにセルを表示する方法を決定する `CellFormat` プロパティがあります。たとえば、`Fill` および `Font` などのこの `CellFormat` プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 +ワークシートに追加できる条件付き書式の多くには、その条件付き書式の条件が満たされたときにセルを表示する方法を決定する プロパティがあります。たとえば、 および などのこの プロパティにアタッチされるプロパティを使用してセルの背景およびフォント設定を決定できます。 -条件付き書式が作成され、`CellFormat` が適用される場合、ワークシートのセルにサポートされるプロパティのサブセットがあります。現在サポートされる `CellFormat` プロパティは `Fill`、`Border` プロパティ、`FormatString`、および strikethrough、underline、italic、bold、color などの `Font` プロパティです。以下のコード スニペットに複数のプロパティが設定されます。 +条件付き書式が作成され、 が適用される場合、ワークシートのセルにサポートされるプロパティのサブセットがあります。現在サポートされる プロパティは 、`Border` プロパティ、、および strikethrough、underline、italic、bold、color などの プロパティです。以下のコード スニペットに複数のプロパティが設定されます。 -ワーク セルの可視化の動作が異なるため、`CellFormat` プロパティがない条件付き書式もあります。この条件付き書式は `DataBarConditionalFormat`、`ColorScaleConditionalFormat`、`IconSetConditionalFormat` です。 +ワーク セルの可視化の動作が異なるため、 プロパティがない条件付き書式もあります。この条件付き書式は です。 既存の Workbook を Excel から読み込む際に、ワークブックが読み込まれた場合も書式設定は保持されます。ワークブックを Excel ファイルに保存する場合も保持されます。 -以下は、{Platform} コントロールでサポートされている条件付き書式の一覧です。 - -- `AverageConditionalFormat`: `AddAverageCondition` メソッドを使用して追加されたこの条件付きフォーマットは、セルの値が関連する範囲の平均または標準偏差より上か下かに基づいて、ワークシートセルの視覚属性を制御するプロパティを公開します。 -- `BlanksConditionalFormat`: `AddBlanksCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `ColorScaleConditionalFormat`: `AddColorScaleCondition` メソッドを使用して追加された条件付き書式は、最小値、中央値、最大値に対するセルの値に基づいてワークシート セルの色を制御するプロパティを公開します。 -- `DataBarConditionalFormat`: `AddDataBarCondition` メソッドを使用して追加されたこの条件付き書式は、関連付けられた値の範囲に対するセルの値に基づいてワークシートのセルにデータバーを表示するプロパティを公開します。 -- `DateTimeConditionalFormat`: `AddDateTimeCondition` メソッドを使用して追加されたこの条件付き書式は、セルの日付値が指定された時間範囲内にあるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `DuplicateConditionalFormat`: `AddDuplicateCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が一意であるか、関連付けられた範囲全体で複製されるかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `ErrorsConditionalFormat`: `AddErrorsCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `FormulaConditionalFormat`: `AddFormulaCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が式で定義された基準を満たすかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 -- `IconSetConditionalFormat`: `AddIconSetCondition` メソッドを使用して追加されたこの条件付き書式は、しきい値に対するセルの値に基づいてワークシートのセルにアイコンを表示するプロパティを公開します。 -- `NoBlanksConditionalFormat`: `AddNoBlanksCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `NoErrorsConditionalFormat`: `AddNoErrorsCondition` メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 -- `OperatorConditionalFormat`: `AddOperatorCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が論理演算子で定義された基準を満たすかどうかに基づいてワークシートセルの視覚属性を制御するプロパティを公開します。 -- `RankConditionalFormat`: `AddRankCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が関連する範囲全体の値の最下位ランクの上部にあるかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 -- `TextOperatorConditionalFormat`: `AddRankCondition` メソッドを使用して追加されたこの条件付き書式は、セルのテキスト値が `AddTextCondition` メソッドのパラメーターの文字列および `FormatConditionTextOperator` 値にで定義された基準を満たすかどうかに基づいてワークシート セルのビジュアル属性を制御するプロパティを公開します。 -- `UniqueConditionalFormat`: `AddUniqueCondition` メソッドを使用して追加されたこの条件付き書式は、セルの値が関連付けられた範囲全体で一意であるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +以下は、{Platform} コントロールでサポートされている条件付き書式の一覧です。 + +- : メソッドを使用して追加されたこの条件付きフォーマットは、セルの値が関連する範囲の平均または標準偏差より上か下かに基づいて、ワークシートセルの視覚属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加された条件付き書式は、最小値、中央値、最大値に対するセルの値に基づいてワークシート セルの色を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、関連付けられた値の範囲に対するセルの値に基づいてワークシートのセルにデータバーを表示するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの日付値が指定された時間範囲内にあるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が一意であるか、関連付けられた範囲全体で複製されるかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が式で定義された基準を満たすかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、しきい値に対するセルの値に基づいてワークシートのセルにアイコンを表示するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式では、セルの値が設定されていないかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が論理演算子で定義された基準を満たすかどうかに基づいてワークシートセルの視覚属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が関連する範囲全体の値の最下位ランクの上部にあるかどうかに基づいてワークシート セルの表示属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルのテキスト値が メソッドのパラメーターの文字列および 値にで定義された基準を満たすかどうかに基づいてワークシート セルのビジュアル属性を制御するプロパティを公開します。 +- : メソッドを使用して追加されたこの条件付き書式は、セルの値が関連付けられた範囲全体で一意であるかどうかに基づいてワークシートセルの表示属性を制御するプロパティを公開します。 ## 依存関係 -`Spreadsheet` コントロールに条件付き書式を追加するには、以下の依存関係をインポートする必要があります。 + コントロールに条件付き書式を追加するには、以下の依存関係をインポートする必要があります。 ```ts @@ -109,7 +109,7 @@ import { WorkbookColorInfo } from 'igniteui-webcomponents-excel'; ## コード スニペット -以下のコード スニペットは、`Spreadsheet` コントロールのスプレッドシートに各条件付き書式を追加する方法を示しています。 +以下のコード スニペットは、 コントロールのスプレッドシートに各条件付き書式を追加する方法を示しています。 ```ts let sheet = this.spreadsheet.activeWorksheet; @@ -176,23 +176,23 @@ uniqueFormat.cellFormat.font.colorInfo = new WorkbookColorInfo(blue); ## API リファレンス -`AverageConditionalFormat`
-`BlanksConditionalFormat`
-`ColorScaleConditionalFormat`
-`DataBarConditionalFormat`
-`DateTimeConditionalFormat`
-`DuplicateConditionalFormat`
-`ErrorsConditionalFormat`
-`FormulaConditionalFormat`
-`IconSetConditionalFormat`
-`NoBlanksConditionalFormat`
-`NoErrorsConditionalFormat`
-`OperatorConditionalFormat`
-`RankConditionalFormat`
-`TextOperatorConditionalFormat`
-`UniqueConditionalFormat`
-`FormatConditionTextOperator`
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/docs/xplat/src/content/jp/components/spreadsheet-configuring.mdx b/docs/xplat/src/content/jp/components/spreadsheet-configuring.mdx index e1282f83e8..7815dfa54e 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-configuring.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-configuring.mdx @@ -27,11 +27,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## セル編集の構成 -ユーザーがセルの値を編集して新しい入力を確認すると、スプレッドシートの構成に応じて、`Spreadsheet` コントロールに ENTER キーを押すと現在アクティブなセルに隣接するセルに移動できます。 +ユーザーがセルの値を編集して新しい入力を確認すると、スプレッドシートの構成に応じて、 コントロールに ENTER キーを押すと現在アクティブなセルに隣接するセルに移動できます。 -この ENTER キーナビゲーションを有効にするために、`IsEnterKeyNavigationEnabled` プロパティを **true** に設定できます。false に設定すると、ENTER キーを押してもアクティブ セルは変わりません。 +この ENTER キーナビゲーションを有効にするために、 プロパティを **true** に設定できます。false に設定すると、ENTER キーを押してもアクティブ セルは変わりません。 -Enter キーを押したときに移動する隣接セルの方向は、`EnterKeyNavigationDirection` プロパティを `Down`、`Up`、`Left`、`Right` に設定して構成することもできます。 +Enter キーを押したときに移動する隣接セルの方向は、 プロパティを `Down`、`Up`、`Left`、`Right` に設定して構成することもできます。 以下のコード スニペットは上記のデモです。 @@ -86,7 +86,7 @@ this.spreadsheet.enterKeyNavigationDirection = SpreadsheetEnterKeyNavigationDire ## 数式バーの構成 -{Platform} `Spreadsheet` は、コントロールの `IsFormulaBarVisible` プロパティを設定して数式バーの表示/非表示を設定できます。 +{Platform} は、コントロールの プロパティを設定して数式バーの表示/非表示を設定できます。 以下のコード スニペットは上記のデモです。 @@ -120,7 +120,7 @@ this.spreadsheet.isFormulaBarVisible = true; ## ガイドラインの設定 -`Spreadsheet` は、コントロールの `AreGridlinesVisible` プロパティを設定して数式バーの表示/非表示を設定できます。 + は、コントロールの プロパティを設定して数式バーの表示/非表示を設定できます。 以下のコード スニペットは上記のデモです。 @@ -154,7 +154,7 @@ this.spreadsheet.areGridlinesVisible = true; ## ヘッダーの構成 -`Spreadsheet` は、`AreHeadersVisible` プロパティを設定してへッダーの可視性を設定できます。 + は、 プロパティを設定してへッダーの可視性を設定できます。 以下のコード スニペットは上記のデモです。 @@ -188,13 +188,13 @@ this.spreadsheet.areHeadersVisible = false; ## ナビゲーションの構成 -`Spreadsheet` コントロールは、コントロールが「終了モード」にあるかどうかを構成することによって、ワークシートのセル間のナビゲーションを構成できます。終了モードは、矢印キーを押すと、アクティブなセルが、押された矢印キーの方向に応じて、現在のセルからデータが隣接するセルの行または列の末尾に移動する機能です。この機能は、大規模なデータ ブロックの最後まですばやく移動する際に役立ちます。 + コントロールは、コントロールが「終了モード」にあるかどうかを構成することによって、ワークシートのセル間のナビゲーションを構成できます。終了モードは、矢印キーを押すと、アクティブなセルが、押された矢印キーの方向に応じて、現在のセルからデータが隣接するセルの行または列の末尾に移動する機能です。この機能は、大規模なデータ ブロックの最後まですばやく移動する際に役立ちます。 -たとえば、終了モードになっているときに、100x100 の大きなデータブロックをクリックして 矢印キーを押すと、現在の行の右端に移動し、データのある一番右の列に移動します。この操作の後、`Spreadsheet` は終了モードから飛び出します。 +たとえば、終了モードになっているときに、100x100 の大きなデータブロックをクリックして 矢印キーを押すと、現在の行の右端に移動し、データのある一番右の列に移動します。この操作の後、 は終了モードから飛び出します。 -ユーザーが END キーを押すと、実行時に終了モードが有効になりますが、スプレッドシート コントロールの `IsInEndMode` プロパティを設定することでプログラムで設定できます。 +ユーザーが END キーを押すと、実行時に終了モードが有効になりますが、スプレッドシート コントロールの プロパティを設定することでプログラムで設定できます。 -以下のコード スニペットは、`Spreadsheet` を終了モードで開始させる方法を示しています。 +以下のコード スニペットは、 を終了モードで開始させる方法を示しています。 @@ -226,9 +226,9 @@ this.spreadsheet.isInEndMode = true; ## 保護の設定 -`Spreadsheet` は、ワークシートごとにブックを保護します。ワークシートの保護の設定は、ワークシートの `Protect()` メソッドを呼び出して保護し、`Unprotect()` メソッドを呼び出して保護解除することで設定できます。 + は、ワークシートごとにブックを保護します。ワークシートの保護の設定は、ワークシートの `Protect()` メソッドを呼び出して保護し、`Unprotect()` メソッドを呼び出して保護解除することで設定できます。 -以下のコードは、`Spreadsheet` コントロールの現在アクティブなワークシートの保護を有効または無効にすることができます。 +以下のコードは、 コントロールの現在アクティブなワークシートの保護を有効または無効にすることができます。 ```ts this.spreadsheet.activeWorksheet.protect(); @@ -237,13 +237,13 @@ this.spreadsheet.activeWorksheet.unprotect(); ## 選択の設定 -`Spreadsheet` コントロールは、コントロールで許可されている選択の種類を設定できます。その後、ユーザーが修飾キー (SHIFT または CTRL) を押します。これは、スプレッドシートの `SelectionMode` プロパティを次のいずれかの値に設定することによって行われます。 + コントロールは、コントロールで許可されている選択の種類を設定できます。その後、ユーザーが修飾キー (SHIFT または CTRL) を押します。これは、スプレッドシートの プロパティを次のいずれかの値に設定することによって行われます。 -- `AddToSelection`: マウスでドラッグするときに CTRL キーを押す必要はありません。新しいセル範囲が `SpreadsheetSelection` オブジェクトの `CellRanges` コレクションに追加され、モードに入った後に最初の矢印キーナビゲーションで範囲が追加されます。シフト+F8 を押すとモードに入ります。 -- `ExtendSelection`: `SpreadsheetSelection` オブジェクトの `CellRanges` コレクション内の選択範囲は、マウスを使用してセルを選択するかキーボードで移動すると更新されます。 +- `AddToSelection`: マウスでドラッグするときに CTRL キーを押す必要はありません。新しいセル範囲が オブジェクトの コレクションに追加され、モードに入った後に最初の矢印キーナビゲーションで範囲が追加されます。シフト+F8 を押すとモードに入ります。 +- `ExtendSelection`: オブジェクトの コレクション内の選択範囲は、マウスを使用してセルを選択するかキーボードで移動すると更新されます。 - `Normal`: セルまたはセルの範囲を選択するためにマウスをドラッグすると選択が置き換えられます。同様に、キーボードで移動すると新しい選択範囲が作成されます。CTRL キーを押したままマウスを使用することで新しい範囲を追加できます。また、SHIFT キーを押したままマウスでクリックする、あるいはキーボードで移動することでアクティブ セルを含む選択範囲を変更できます。 -上記の説明で述べた `SpreadsheetSelection` オブジェクトは、`Spreadsheet` コントロールの `ActiveSelection` プロパティを使用して取得できます。 +上記の説明で述べた オブジェクトは、 コントロールの プロパティを使用して取得できます。 次のコード スニペットは、選択モードの設定を示しています。 @@ -291,9 +291,9 @@ import { SpreadsheetCellSelectionMode } from 'igniteui-webcomponents-spreadsheet this.spreadsheet.selectionMode = SpreadsheetCellSelectionMode.ExtendSelection; ``` -`Spreadsheet` コントロールの選択は、プログラムで設定または取得することもできます。単一選択の場合は、`ActiveCell` プロパティを設定できます。複数選択は、`Spreadsheet` コントロールの `ActiveSelection` プロパティによって返される `SpreadsheetSelection` オブジェクトを介して行われます。 + コントロールの選択は、プログラムで設定または取得することもできます。単一選択の場合は、 プロパティを設定できます。複数選択は、 コントロールの プロパティによって返される オブジェクトを介して行われます。 -`SpreadsheetSelection` オブジェクトには、新しい `SpreadsheetCellRange` オブジェクトの形式でスプレッドシートの選択範囲にプログラムでセルの範囲を追加できる `AddCellRange()` メソッドがあります。 + オブジェクトには、新しい オブジェクトの形式でスプレッドシートの選択範囲にプログラムでセルの範囲を追加できる `AddCellRange()` メソッドがあります。 次のコード スニペットは、スプレッドシートの選択範囲にセル範囲を追加する方法を示しています。 @@ -303,7 +303,7 @@ this.spreadsheet.activeSelection.addCellRange(new SpreadsheetCellRange(2, 2, 5, ## タブバー領域の構成 -`Spreadsheet` コントロールは、`TabBarWidth` プロパティと `TabBarVisibility` プロパティを介して、現在アクティブな `Workbook` の `WindowOptions` からタブバー領域の表示設定と幅の設定を使用します。 + コントロールは、`TabBarWidth` プロパティと `TabBarVisibility` プロパティを介して、現在アクティブな からタブバー領域の表示設定と幅の設定を使用します。 タブバー領域は、ワークシート名をコントロール内のタブとして可視化する領域です。 @@ -317,9 +317,9 @@ this.spreadsheet.workbook.windowOptions.tabBarWidth = 200; ## ズーム レベルの設定 -{Platform} Spreadsheet コンポーネントは、`ZoomLevel` プロパティを設定してズームインとズームアウト機能を追加できます。ズーム レベルは最大 400%、最小 10% です。 +{Platform} Spreadsheet コンポーネントは、 プロパティを設定してズームインとズームアウト機能を追加できます。ズーム レベルは最大 400%、最小 10% です。 -このプロパティを数値に設定すると、整数としてのパーセンテージが表されるため、`ZoomLevel` を 100 に設定することは、100% に設定することと同じです。 +このプロパティを数値に設定すると、整数としてのパーセンテージが表されるため、 を 100 に設定することは、100% に設定することと同じです。 次のコード スニペットは、スプレッドシートのズームレベルを設定する方法を示しています。 @@ -354,7 +354,7 @@ this.spreadsheet.zoomLevel = 200; ## API リファレンス -
-
-
+
+
+

diff --git a/docs/xplat/src/content/jp/components/spreadsheet-hyperlinks.mdx b/docs/xplat/src/content/jp/components/spreadsheet-hyperlinks.mdx index e85f496670..a41c96ccd5 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-hyperlinks.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-hyperlinks.mdx @@ -27,11 +27,11 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## ハイパーリンク概要 -ハイパーリンクを配置するワークシートの `Hyperlinks` コレクションにアクセスすると、ハイパーリンクが表計算、`Spreadsheet` コントロールに追加されます。このコレクションには、`WorksheetHyperlink` オブジェクトを受け取る `Add` メソッドがあり、セル アドレス、移動先のハイパーリンク URL、表示テキスト、およびオプションでホバー時に表示するツールチップを定義できます。 +ハイパーリンクを配置するワークシートの `Hyperlinks` コレクションにアクセスすると、ハイパーリンクが表計算、 コントロールに追加されます。このコレクションには、 オブジェクトを受け取る `Add` メソッドがあり、セル アドレス、移動先のハイパーリンク URL、表示テキスト、およびオプションでホバー時に表示するツールチップを定義できます。 ## 依存関係 -ハイパーリンクを使用するように {Platform} スプレッドシート コントロールを設定するときは、`WorksheetHyperlink` クラスをインポートする必要があります。 +ハイパーリンクを使用するように {Platform} スプレッドシート コントロールを設定するときは、 クラスをインポートする必要があります。 ```ts @@ -56,7 +56,7 @@ import { WorksheetHyperlink } from 'igniteui-webcomponents-excel'; ## コード スニペット -以下のコード スニペットは、{Platform} `Spreadsheet` コントロールで現在表示されているワークシートにハイパーリンクを追加する方法を示しています。 +以下のコード スニペットは、{Platform} コントロールで現在表示されているワークシートにハイパーリンクを追加する方法を示しています。 ```ts this.spreadsheet.activeWorksheet.hyperlinks().add(new WorksheetHyperlink("A1", "http://www.infragistics.com", "Infragistics", "Infragistics Home Page")); @@ -65,7 +65,7 @@ this.spreadsheet.activeWorksheet.hyperlinks().add(new WorksheetHyperlink("A1", " ## API リファレンス -
+

diff --git a/docs/xplat/src/content/jp/components/spreadsheet-overview.mdx b/docs/xplat/src/content/jp/components/spreadsheet-overview.mdx index c0649190de..41669028da 100644 --- a/docs/xplat/src/content/jp/components/spreadsheet-overview.mdx +++ b/docs/xplat/src/content/jp/components/spreadsheet-overview.mdx @@ -14,7 +14,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; # {Platform} Spreadsheet の概要 -{Platform} Spreadsheet (Excel ビューア) コンポーネントは軽量で機能が豊富で、科学、ビジネス、財務など、あらゆる種類のスプレッドシート データを操作、視覚化、編集するために必要なすべてのオプションが用意されています。すべての情報は、セル、ペイン、およびワークシート間を直感的かつ簡単にナビゲートできる表形式で表示できます。`Spreadsheet` は、Excel のような柔軟なインターフェイス、詳細なチャート、およびアクティブ化、セル編集、条件付き書式設定、スタイル設定、選択、クリップボードなどの機能によって補完されます。 +{Platform} Spreadsheet (Excel ビューア) コンポーネントは軽量で機能が豊富で、科学、ビジネス、財務など、あらゆる種類のスプレッドシート データを操作、視覚化、編集するために必要なすべてのオプションが用意されています。すべての情報は、セル、ペイン、およびワークシート間を直感的かつ簡単にナビゲートできる表形式で表示できます。 は、Excel のような柔軟なインターフェイス、詳細なチャート、およびアクティブ化、セル編集、条件付き書式設定、スタイル設定、選択、クリップボードなどの機能によって補完されます。 ## {Platform} Spreadsheet の例 @@ -70,7 +70,7 @@ npm install --save {PackageSpreadsheet} ## モジュールの要件 -`Spreadsheet` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 @@ -161,7 +161,7 @@ ModuleManager.register( -次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して `Workbook` を保存およびロードしています。 +次のコード スニペットでは、外部の [ExcelUtility](excel-utility.md) クラスを使用して を保存およびロードしています。 以下は、ワークブックを {Platform} スプレッドシートにロードする方法を示しています。 @@ -229,5 +229,5 @@ ExcelUtility.loadFromUrl(excelFile).then((w: Workbook) => { ## API リファレンス -
+

diff --git a/docs/xplat/src/content/jp/components/themes/configuration.mdx b/docs/xplat/src/content/jp/components/themes/configuration.mdx index 3059a39605..063044d23e 100644 --- a/docs/xplat/src/content/jp/components/themes/configuration.mdx +++ b/docs/xplat/src/content/jp/components/themes/configuration.mdx @@ -103,4 +103,4 @@ igc-dropdown { ## API リファレンス -
+
diff --git a/docs/xplat/src/content/jp/components/themes/styles.mdx b/docs/xplat/src/content/jp/components/themes/styles.mdx index 71c6c0f2fa..a07aa56739 100644 --- a/docs/xplat/src/content/jp/components/themes/styles.mdx +++ b/docs/xplat/src/content/jp/components/themes/styles.mdx @@ -57,4 +57,4 @@ CSS パーツと CSS 変数について学び、ドキュメントに記載さ ## API リファレンス -
+
diff --git a/docs/xplat/src/content/jp/components/update-guide.mdx b/docs/xplat/src/content/jp/components/update-guide.mdx index ecab52f863..6353d509a1 100644 --- a/docs/xplat/src/content/jp/components/update-guide.mdx +++ b/docs/xplat/src/content/jp/components/update-guide.mdx @@ -86,7 +86,7 @@ Ignite UI for React バージョニング は、最初の数字がコードが
-- コンポーネントには、デフォルトで非機能的な `name` プロパティが付与されなくなりました。`name` プロパティは、主に `IgrInput` や `IgrCombo` などのフォーム入力コンポーネントにおいてネイティブの機能を持つため、**igniteui-react** のコンポーネントにのみ残されています。 +- コンポーネントには、デフォルトで非機能的な `name` プロパティが付与されなくなりました。`name` プロパティは、主に などのフォーム入力コンポーネントにおいてネイティブの機能を持つため、**igniteui-react** のコンポーネントにのみ残されています。 - Ignite UI for React コンポーネントでは、React の[ドキュメント](https://react.dev/learn/rendering-lists#keeping-list-items-in-order-with-key)に従って必要な場合を除き、`key` プロパティは不要になりました。 - [IgrDataGrid](./grids/data-grid/overview.md) は、**igniteui-react-grids** パッケージの一部ではなくなりました。より軽量な構成を実現するため、**igniteui-react-data-grids** パッケージに移動されました。 - バージョン **18.9.0** ではクラスとして公開されていたいくつかの型は、現在ではタイプとしてエクスポート されるようになりました。これらは以下のように使用できます: @@ -113,9 +113,9 @@ const pivotConfiguration: IgrPivotConfiguration = {
-- `IgrButton` +- - **重大な変更** - `clicked` イベントは削除されました。代わりにネイティブの を使用してください。 -- `IgrInput` +- - **重大な変更** - `inputOccurred` イベントの名前が に変更されました。 diff --git a/docs/xplat/src/content/jp/components/zoomslider-overview.mdx b/docs/xplat/src/content/jp/components/zoomslider-overview.mdx index 3c00201502..f4ab632ef0 100644 --- a/docs/xplat/src/content/jp/components/zoomslider-overview.mdx +++ b/docs/xplat/src/content/jp/components/zoomslider-overview.mdx @@ -18,7 +18,7 @@ import ApiLink from 'igniteui-astro-components/components/mdx/ApiLink.astro'; ## {Platform} ズーム スライダーの例 -以下のサンプルは、`ZoomSlider` を使用して `DataChart` のコンテンツをナビゲートする方法を示しています。 +以下のサンプルは、 を使用して のコンテンツをナビゲートする方法を示しています。 @@ -56,7 +56,7 @@ npm install --save {PackageCharts} ## モジュールの要件 -`ZoomSlider` を作成するには、以下のモジュールが必要です。 + を作成するには、以下のモジュールが必要です。 diff --git a/mdx-link-report-angular.md b/mdx-link-report-angular.md new file mode 100644 index 0000000000..774c69608e --- /dev/null +++ b/mdx-link-report-angular.md @@ -0,0 +1,12 @@ +# API Link Check Report + +_Generated: 2026-05-22 09:34:22 UTC_ + +## Summary + +| | | +|---|---| +| ✅ OK | 2088 | +| ❌ Not found (type/member missing) | 0 | +| ❌ HTTP error | 0 | +| ❌ **Total broken** | **0** | diff --git a/mdx-link-report-blazor.md b/mdx-link-report-blazor.md new file mode 100644 index 0000000000..bde516b903 --- /dev/null +++ b/mdx-link-report-blazor.md @@ -0,0 +1,12 @@ +# API Link Check Report + +_Generated: 2026-05-26 15:22:58 UTC_ + +## Summary + +| | | +|---|---| +| ✅ OK | 1688 | +| ❌ Not found (type/member missing) | 0 | +| ❌ HTTP error | 0 | +| ❌ **Total broken** | **0** | diff --git a/mdx-link-report-react.md b/mdx-link-report-react.md new file mode 100644 index 0000000000..90e9c85fc7 --- /dev/null +++ b/mdx-link-report-react.md @@ -0,0 +1,12 @@ +# API Link Check Report + +_Generated: 2026-05-26 15:20:31 UTC_ + +## Summary + +| | | +|---|---| +| ✅ OK | 1635 | +| ❌ Not found (type/member missing) | 0 | +| ❌ HTTP error | 0 | +| ❌ **Total broken** | **0** | diff --git a/mdx-link-report-wc.md b/mdx-link-report-wc.md new file mode 100644 index 0000000000..4d29f45074 --- /dev/null +++ b/mdx-link-report-wc.md @@ -0,0 +1,12 @@ +# API Link Check Report + +_Generated: 2026-05-26 15:22:18 UTC_ + +## Summary + +| | | +|---|---| +| ✅ OK | 1534 | +| ❌ Not found (type/member missing) | 0 | +| ❌ HTTP error | 0 | +| ❌ **Total broken** | **0** | diff --git a/package.json b/package.json index c405b7c45c..8c60279586 100644 --- a/package.json +++ b/package.json @@ -105,7 +105,17 @@ "check-api-links:report:angular": "node scripts/check-api-links.mjs --platform=angular --md=api-link-report-angular.md", "check-api-links:report:react": "node scripts/check-api-links.mjs --platform=react --md=api-link-report-react.md", "check-api-links:report:wc": "node scripts/check-api-links.mjs --platform=wc --md=api-link-report-wc.md", - "check-api-links:report:blazor": "node scripts/check-api-links.mjs --platform=blazor --md=api-link-report-blazor.md" + "check-api-links:report:blazor": "node scripts/check-api-links.mjs --platform=blazor --md=api-link-report-blazor.md", + "check-mdx-links": "node --experimental-strip-types scripts/check-mdx-links.mjs", + "check-mdx-links:angular": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=angular", + "check-mdx-links:react": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=react", + "check-mdx-links:wc": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=wc", + "check-mdx-links:blazor": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=blazor", + "check-mdx-links:report": "node --experimental-strip-types scripts/check-mdx-links.mjs --md=mdx-link-report.md", + "check-mdx-links:report:angular": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=angular --md=mdx-link-report-angular.md", + "check-mdx-links:report:react": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=react --md=mdx-link-report-react.md", + "check-mdx-links:report:wc": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=wc --md=mdx-link-report-wc.md", + "check-mdx-links:report:blazor": "node --experimental-strip-types scripts/check-mdx-links.mjs --platform=blazor --md=mdx-link-report-blazor.md" }, "dependencies": { "@astrojs/check": "^0.9.8", diff --git a/scripts/apply-excludes.mjs b/scripts/apply-excludes.mjs new file mode 100644 index 0000000000..4a5e4fc503 --- /dev/null +++ b/scripts/apply-excludes.mjs @@ -0,0 +1,155 @@ +#!/usr/bin/env node +/** + * apply-excludes.mjs + * + * Reads mdx-link-report-*.md files and applies exclude="Platform" to ApiLink + * tags where the fix suggestion is `exclude=` (symbol absent from that platform). + * + * For excludeSuffixFor/excludePrefixFor fixes use apply-mdx-report-fixes.mjs, + * which handles all three fix types in a single pass. + */ +import { readFileSync, writeFileSync } from 'node:fs'; + +const DRY = process.argv.includes('--dry-run'); +const PLATFORM_REPORTS = [ + ['Angular', 'mdx-link-report-angular.md'], + ['React', 'mdx-link-report-react.md'], + ['WebComponents','mdx-link-report-wc.md'], + ['Blazor', 'mdx-link-report-blazor.md'], +]; + +// Angular content (except grids/ and changelog/) is synced from xplat via +// sync-generated.mjs — redirect those paths to the xplat source. +function mapAngularPath(p) { + const m = p.match(/^docs\/angular\/src\/content\/(en|jp)\/components\/(.+)$/); + if (!m) return p; + const [, lang, rest] = m; + if (rest.startsWith('grids/') || rest.startsWith('changelog/')) return p; + return `docs/xplat/src/content/${lang}/components/${rest}`; +} + +const PREFIX_RE = /^(Igr|Igx|Igc|Igb)/; +const SUFFIX_RE = /(Component|Module|Directive|Element)$/; +const stripPrefix = (n) => n.replace(PREFIX_RE, ''); +const stripSuffix = (n) => n.replace(SUFFIX_RE, ''); +const baseVariants = (n) => { + const p = stripPrefix(n); + const ps = stripSuffix(p); + return ps !== p ? [p, ps] : [p]; +}; + +function parseReport(path) { + let text; + try { text = readFileSync(path, 'utf8'); } catch { return []; } + const lines = text.split(/\r?\n/); + const out = []; + let current = null; + let isExcludeFix = false; + for (const line of lines) { + const urlMatch = line.match(/^\s+- URL:\s+`([^`]+)`/); + if (urlMatch) { + current = null; + isExcludeFix = false; + const url = urlMatch[1]; + const m = url.match(/\/(classes|interfaces|enums|types|variables|functions)\/([^#?]+)(?:#(.+))?$/); + if (m) { + const segMap = { classes: 'class', interfaces: 'interface', enums: 'enum', types: 'type', variables: 'variable', functions: 'function' }; + current = { types: baseVariants(m[2]), member: (m[3] || '').toLowerCase(), kind: segMap[m[1]] }; + } + continue; + } + // Only collect entries where the report suggests exclude= (not excludeSuffixFor) + const fixMatch = line.match(/^\s+- \*\*FIX\*\*:\s+`([^`]+)`/); + if (fixMatch) { + isExcludeFix = fixMatch[1].startsWith('exclude='); + continue; + } + const inMatch = line.match(/^\s+- in:\s+`([^`]+)`/); + if (inMatch && current && isExcludeFix) { + const file = mapAngularPath(inMatch[1].replace(/\\/g, '/')); + out.push({ file, types: current.types, member: current.member, kind: current.kind }); + } + } + return out; +} + +function buildBrokenMap() { + const m = new Map(); + for (const [plat, path] of PLATFORM_REPORTS) { + for (const e of parseReport(path)) { + if (!m.has(e.file)) m.set(e.file, new Map()); + const fileMap = m.get(e.file); + for (const t of e.types) { + const key = `${t}|${e.member}|${e.kind}`; + if (!fileMap.has(key)) fileMap.set(key, new Set()); + fileMap.get(key).add(plat); + } + } + } + return m; +} + +const API_LINK_RE = /]*\/>/g; +const getAttr = (tag, name) => { + const m = tag.match(new RegExp(`\\s${name}=(["'])([^"']*)\\1`)); + return m ? m[2] : null; +}; +const setExcludeAttr = (tag, platforms) => { + const list = [...platforms].sort().join(','); + if (/\sexclude=(["'])[^"']*\1/.test(tag)) { + return tag.replace(/\sexclude=(["'])[^"']*\1/, ` exclude="${list}"`); + } + return tag.replace(/\s*\/>$/, ` exclude="${list}" />`); +}; + +function processFile(file, fileMap) { + let content; + try { content = readFileSync(file, 'utf8'); } catch { return 0; } + let changes = 0; + const out = []; + let last = 0; + API_LINK_RE.lastIndex = 0; + let m; + while ((m = API_LINK_RE.exec(content)) !== null) { + const tag = m[0]; + out.push(content.slice(last, m.index)); + last = m.index + tag.length; + const rawType = getAttr(tag, 'type'); + if (!rawType || /[{}]/.test(rawType)) { out.push(tag); continue; } + const base = stripPrefix(rawType); + const member = (getAttr(tag, 'member') || '').toLowerCase(); + const kind = getAttr(tag, 'kind') || 'class'; + const key = `${base}|${member}|${kind}`; + const brokenPlatforms = fileMap.get(key); + if (!brokenPlatforms || brokenPlatforms.size === 0) { out.push(tag); continue; } + + const existing = getAttr(tag, 'exclude'); + const merged = new Set(brokenPlatforms); + if (existing) for (const p of existing.split(',').map(s => s.trim()).filter(Boolean)) merged.add(p); + + if (existing) { + const existingSet = new Set(existing.split(',').map(s => s.trim())); + let same = existingSet.size === merged.size; + for (const p of merged) if (!existingSet.has(p)) { same = false; break; } + if (same) { out.push(tag); continue; } + } + out.push(setExcludeAttr(tag, merged)); + changes++; + } + out.push(content.slice(last)); + if (changes === 0) return 0; + if (!DRY) writeFileSync(file, out.join('')); + return changes; +} + +const brokenMap = buildBrokenMap(); +let totalFiles = 0, totalChanges = 0; +for (const [file, fileMap] of brokenMap) { + const c = processFile(file, fileMap); + if (c > 0) { + totalFiles++; + totalChanges += c; + console.log(`${DRY ? '[dry] ' : ''}${file} (+${c})`); + } +} +console.log(`\n${DRY ? '[dry-run] ' : ''}Files: ${totalFiles}, Tags updated: ${totalChanges}`); diff --git a/scripts/apply-mdx-report-fixes.mjs b/scripts/apply-mdx-report-fixes.mjs new file mode 100644 index 0000000000..0afcdebd02 --- /dev/null +++ b/scripts/apply-mdx-report-fixes.mjs @@ -0,0 +1,259 @@ +#!/usr/bin/env node +/** + * apply-mdx-report-fixes.mjs + * + * Reads all mdx-link-report-*.md files and applies the suggested fixes to + * the MDX source files. Handles three fix types: + * + * excludeSuffixFor="Platform" — suffix (e.g. "Component") is wrong for this + * platform; suppresses classSuffix for the given + * platforms without hiding the link entirely. + * exclude="Platform" — symbol absent from this platform's API; renders + * as plain inline code instead of a broken link. + * excludePrefixFor="Platform" — platform prefix (Igx/Igr/Igc/Igb) should not + * be prepended for the given platforms. + * + * Angular-report paths are remapped to xplat source because sync-generated.mjs + * overwrites docs/angular/src/content from docs/xplat/src/content (except grids/ + * and changelog/, which Angular owns directly). + * + * Usage: + * node scripts/apply-mdx-report-fixes.mjs + * node scripts/apply-mdx-report-fixes.mjs --dry-run + */ + +import { readFileSync, writeFileSync } from 'node:fs'; + +const DRY = process.argv.includes('--dry-run'); + +const PLATFORM_REPORTS = [ + ['Angular', 'mdx-link-report-angular.md'], + ['React', 'mdx-link-report-react.md'], + ['WebComponents', 'mdx-link-report-wc.md'], + ['Blazor', 'mdx-link-report-blazor.md'], +]; + +// ─── Path mapping ───────────────────────────────────────────────────────────── + +// Angular docs/angular/src/content/* is generated from docs/xplat/src/content/* +// via sync-generated.mjs, EXCEPT grids/ and changelog/ which Angular owns. +function mapAngularPath(p) { + const m = p.match(/^docs\/angular\/src\/content\/(en|jp)\/components\/(.+)$/); + if (!m) return p; + const [, lang, rest] = m; + if (rest.startsWith('grids/') || rest.startsWith('changelog/')) return p; + return `docs/xplat/src/content/${lang}/components/${rest}`; +} + +// ─── Type name helpers ──────────────────────────────────────────────────────── + +const PREFIX_RE = /^(Igr|Igx|Igc|Igb)/; +const SUFFIX_RE = /(Component|Module|Directive|Element)$/; +const stripPrefix = n => n.replace(PREFIX_RE, ''); +const stripSuffix = n => n.replace(SUFFIX_RE, ''); + +// Produce the variants of a URL type name that might appear as `type=` in MDX. +// e.g. "IgxChartSelectionComponent" → ["ChartSelectionComponent", "ChartSelection"] +// "IgxSpreadsheet" → ["Spreadsheet"] +// "SortSettings" → ["SortSettings"] +function baseVariants(name) { + const noPrefix = stripPrefix(name); + const noSuffix = stripSuffix(noPrefix); + return noSuffix !== noPrefix ? [noPrefix, noSuffix] : [noPrefix]; +} + +// ─── Report parsing ─────────────────────────────────────────────────────────── + +function parseReport(reportPath, platform) { + let text; + try { text = readFileSync(reportPath, 'utf8'); } catch { return []; } + + const entries = []; + const lines = text.split(/\r?\n/); + let cur = null; // {types[], member, kind, fixType} + let files = []; // files seen since last URL block + + function flush() { + if (cur?.fixType && files.length > 0) { + for (const file of [...new Set(files)]) { + for (const type of cur.types) { + entries.push({ + file, + type, + member: cur.member, + kind: cur.kind, + fixType: cur.fixType, + platform, + }); + } + } + } + cur = null; + files = []; + } + + const SEG_MAP = { + classes: 'class', interfaces: 'interface', enums: 'enum', + types: 'type', variables: 'variable', functions: 'function', + }; + + for (const line of lines) { + // New URL entry + const urlM = line.match(/^\s+- URL:\s+`([^`]+)`/); + if (urlM) { + flush(); + const url = urlM[1]; + const m = url.match(/\/(classes|interfaces|enums|types|variables|functions)\/([^#?/]+)(?:#(.+))?$/); + if (m) { + cur = { + types: baseVariants(m[2]), + member: (m[3] || '').toLowerCase(), + kind: SEG_MAP[m[1]] || 'class', + fixType: null, + }; + } + continue; + } + + // FIX suggestion + const fixM = line.match(/^\s+- \*\*FIX\*\*:\s+`([^`]+)`/); + if (fixM && cur) { + const s = fixM[1]; + if (s.startsWith('excludeSuffixFor=')) cur.fixType = 'excludeSuffixFor'; + else if (s.startsWith('exclude=')) cur.fixType = 'exclude'; + else if (s.startsWith('excludePrefixFor=')) cur.fixType = 'excludePrefixFor'; + continue; + } + + // File reference + const inM = line.match(/^\s+- in:\s+`([^`]+)`/); + if (inM && cur?.fixType) { + const raw = inM[1].replace(/\\/g, '/'); + files.push(mapAngularPath(raw)); + } + } + flush(); + return entries; +} + +// ─── Fix map builder ────────────────────────────────────────────────────────── + +// Returns: Map> +function buildFixMap() { + const result = new Map(); + + for (const [platform, reportPath] of PLATFORM_REPORTS) { + for (const e of parseReport(reportPath, platform)) { + if (!result.has(e.file)) result.set(e.file, new Map()); + const fileMap = result.get(e.file); + const key = `${e.type}|${e.member}|${e.kind}`; + if (!fileMap.has(key)) { + fileMap.set(key, { + excludeSuffixFor: new Set(), + exclude: new Set(), + excludePrefixFor: new Set(), + }); + } + fileMap.get(key)[e.fixType].add(e.platform); + } + } + return result; +} + +// ─── Tag patching ───────────────────────────────────────────────────────────── + +const API_LINK_RE = /]*\/>/g; + +function getAttr(tag, name) { + const m = tag.match(new RegExp(`\\b${name}=(?:"([^"]*)"|'([^']*)'|\\{([^}]*)\\})`)); + if (!m) return undefined; + if (m[1] !== undefined) return m[1]; + if (m[2] !== undefined) return m[2]; + if (m[3] === 'true') return true; + if (m[3] === 'false') return false; + return m[3]; +} + +function setStringAttr(tag, attrName, value) { + const re = new RegExp(`\\s+${attrName}=(?:"[^"]*"|'[^']*'|\\{[^}]*\\})`); + if (re.test(tag)) { + return tag.replace(re, ` ${attrName}="${value}"`); + } + return tag.replace(/\s*\/>$/, ` ${attrName}="${value}" />`); +} + +function mergeStringAttr(tag, attrName, newPlatforms) { + if (newPlatforms.size === 0) return { tag, changed: false }; + const existing = getAttr(tag, attrName); + const merged = new Set(newPlatforms); + if (typeof existing === 'string') { + for (const p of existing.split(',').map(s => s.trim()).filter(Boolean)) merged.add(p); + } + const mergedStr = [...merged].sort().join(','); + if (typeof existing === 'string' && existing === mergedStr) return { tag, changed: false }; + return { tag: setStringAttr(tag, attrName, mergedStr), changed: true }; +} + +function processFile(filePath, fileMap) { + let content; + try { content = readFileSync(filePath, 'utf8'); } catch { + console.warn(` ⚠ Cannot read: ${filePath}`); + return 0; + } + + const parts = []; + let last = 0; + let changes = 0; + API_LINK_RE.lastIndex = 0; + let m; + + while ((m = API_LINK_RE.exec(content)) !== null) { + const tag = m[0]; + parts.push(content.slice(last, m.index)); + last = m.index + tag.length; + + const rawType = getAttr(tag, 'type'); + if (!rawType || typeof rawType !== 'string' || /[{}]/.test(rawType)) { + parts.push(tag); + continue; + } + + const member = String(getAttr(tag, 'member') || '').toLowerCase(); + const kind = String(getAttr(tag, 'kind') || 'class'); + const key = `${rawType}|${member}|${kind}`; + + const fix = fileMap.get(key); + if (!fix) { parts.push(tag); continue; } + + let newTag = tag; + let tagChanged = false; + + for (const attr of ['excludeSuffixFor', 'exclude', 'excludePrefixFor']) { + const { tag: patched, changed } = mergeStringAttr(newTag, attr, fix[attr]); + if (changed) { newTag = patched; tagChanged = true; changes++; } + } + + parts.push(tagChanged ? newTag : tag); + } + + parts.push(content.slice(last)); + if (changes === 0) return 0; + if (!DRY) writeFileSync(filePath, parts.join('')); + return changes; +} + +// ─── Main ───────────────────────────────────────────────────────────────────── + +const fixMap = buildFixMap(); +let totalFiles = 0, totalChanges = 0; + +for (const [file, fileMap] of fixMap) { + const c = processFile(file, fileMap); + if (c > 0) { + totalFiles++; + totalChanges += c; + console.log(`${DRY ? '[dry] ' : ''}${file} (+${c})`); + } +} + +console.log(`\n${DRY ? '[dry-run] ' : ''}Files: ${totalFiles}, Tags updated: ${totalChanges}`); diff --git a/scripts/apply-react-platform-fixes.mjs b/scripts/apply-react-platform-fixes.mjs new file mode 100644 index 0000000000..fb03d1b468 --- /dev/null +++ b/scripts/apply-react-platform-fixes.mjs @@ -0,0 +1,202 @@ +#!/usr/bin/env node +/** + * apply-react-platform-fixes.mjs + * + * Report-driven fix: reads api-link-report-react.md, extracts (file, brokenUrl) + * pairs, and for each ApiLink tag in those files whose resolved URL matches a + * broken URL applies one of two transformations: + * + * 1) FORCE_REACT_INTERFACE (type is a "class" per apiMap but actually an + * "interface" in React TypeDoc): emit a 2-platform split where the React + * tag carries kind="interface" and the other platforms keep the original. + * + * 2) REACT_MISSING (type doesn't exist in React TypeDoc at all): wrap the + * original tag in . + * + * Idempotent: skips tags already inside a PlatformBlock that excludes React, + * or already carrying kind="interface" (for FORCE_REACT_INTERFACE). + * + * Usage: + * node scripts/apply-react-platform-fixes.mjs [--dry-run] [--report=PATH] + */ + +import { readFileSync, writeFileSync } from 'node:fs'; + +const DRY = process.argv.includes('--dry-run'); +const REPORT = (process.argv.find(a => a.startsWith('--report=')) || '--report=api-link-report-react.md').slice('--report='.length); + +const FORCE_REACT_INTERFACE = new Set([ + 'Column', 'ClipboardOptions', 'ForOfState', 'GroupingExpression', + 'PivotKeys', 'SummaryResult', 'GroupByRowSelectorTemplateDetails', +]); + +const PREFIX_RE = /^(Igr|Igx|Igc|Igb)/; +const stripPrefix = (n) => n.replace(PREFIX_RE, ''); + +// -------- Parse report -------- + +/** + * Returns Map> for broken React links. + * Both `type` and `member` are normalized (prefix stripped, member may be ''). + */ +function parseReport(path) { + const text = readFileSync(path, 'utf8'); + const lines = text.split(/\r?\n/); + const result = new Map(); + + let current = null; // { type, member } + for (let i = 0; i < lines.length; i++) { + const line = lines[i]; + const urlMatch = line.match(/^\s+- URL:\s+`([^`]+)`/); + if (urlMatch) { + const url = urlMatch[1]; + const m = url.match(/\/(?:classes|interfaces|enums)\/([^#?]+)(?:#(.+))?$/); + current = m ? { type: stripPrefix(m[1]), member: m[2] || '' } : null; + continue; + } + const inMatch = line.match(/^\s+- in:\s+`([^`]+)`/); + if (inMatch && current) { + const file = inMatch[1].replace(/\\/g, '/'); + if (!result.has(file)) result.set(file, []); + result.get(file).push({ ...current }); + } + } + return result; +} + +// -------- Tag transforms -------- + +const API_LINK_RE = /]*\/>/g; +const PB_OPEN_RE = //g; +const PB_CLOSE_TAG = ''; + +const platformsOf = (s) => new Set(s.split(',').map(x => x.trim())); + +function enclosingPlatformBlock(text, offset) { + PB_OPEN_RE.lastIndex = 0; + let m; + let result = null; + while ((m = PB_OPEN_RE.exec(text)) !== null) { + if (m.index > offset) break; + const openEnd = m.index + m[0].length; + const closeAt = text.indexOf(PB_CLOSE_TAG, openEnd); + if (closeAt < 0) continue; + if (offset >= openEnd && offset < closeAt) { + result = { platforms: platformsOf(m[1]), start: m.index, end: closeAt + PB_CLOSE_TAG.length }; + } + } + return result; +} + +const getAttr = (tag, name) => { + const m = tag.match(new RegExp(`\\s${name}="([^"]+)"`)); + return m ? m[1] : null; +}; + +const tagWithKind = (tag, kind) => { + if (/\skind=(["'])[^"']+\1/.test(tag)) { + return tag.replace(/\skind=(["'])[^"']+\1/, ` kind="${kind}"`); + } + return tag.replace(/(\stype=")/, ` kind="${kind}"$1`); +}; + +/** + * Returns the broken entry that matches this ApiLink tag, or null. + * Match requires: type matches (after prefix-strip) AND member matches + * (both empty or identical). + */ +function matchBroken(tag, brokenList) { + const rawType = getAttr(tag, 'type'); + if (!rawType) return null; + if (/[{}]/.test(rawType)) return null; + const base = stripPrefix(rawType); + const tagMember = getAttr(tag, 'member') || ''; + for (const b of brokenList) { + if (b.type === base && b.member === tagMember) return b; + } + return null; +} + +function transformTag(tag, brokenList, content, offset) { + const matched = matchBroken(tag, brokenList); + if (!matched) return null; + + const enclosing = enclosingPlatformBlock(content, offset); + if (enclosing && !enclosing.platforms.has('React')) return null; + if (enclosing && enclosing.platforms.size === 1 && enclosing.platforms.has('React')) return null; + + const base = matched.type; + const isInterface = FORCE_REACT_INTERFACE.has(base); + + const enclosingPlatforms = enclosing ? [...enclosing.platforms] : ['React', 'Angular', 'Blazor', 'WebComponents']; + const others = enclosingPlatforms.filter(p => p !== 'React'); + + if (isInterface) { + if (/\skind=(["'])interface\1/.test(tag)) return null; + const reactTag = tagWithKind(tag, 'interface'); + const reactBlock = `${reactTag}`; + if (others.length === 0) return reactBlock; + return `${reactBlock}${tag}`; + } + if (others.length === 0) return null; + return `${tag}`; +} + +function processFile(file, brokenList) { + let content; + try { + content = readFileSync(file, 'utf8'); + } catch { + console.warn(`!! skip missing: ${file}`); + return 0; + } + let changes = 0; + const out = []; + let last = 0; + API_LINK_RE.lastIndex = 0; + let m; + while ((m = API_LINK_RE.exec(content)) !== null) { + const tag = m[0]; + const replacement = transformTag(tag, brokenList, content, m.index); + out.push(content.slice(last, m.index)); + if (replacement) { + out.push(replacement); + changes++; + } else { + out.push(tag); + } + last = m.index + tag.length; + } + out.push(content.slice(last)); + if (changes === 0) return 0; + + let final = out.join(''); + if (!/import\s+PlatformBlock\s+from\s+['"]/.test(final)) { + const importLine = `import PlatformBlock from 'igniteui-astro-components/components/mdx/PlatformBlock.astro';\n`; + const startOfFm = final.startsWith('---') ? final.indexOf('\n---', 3) : -1; + if (startOfFm >= 0) { + final = final.slice(0, startOfFm + 4) + '\n' + importLine + final.slice(startOfFm + 4); + } else { + final = importLine + final; + } + } + if (!DRY) writeFileSync(file, final); + return changes; +} + +// -------- Run -------- + +const reportMap = parseReport(REPORT); +let totalChanges = 0; +let filesChanged = 0; +for (const [file, brokenList] of reportMap) { + const c = processFile(file, brokenList); + if (c > 0) { + filesChanged++; + totalChanges += c; + console.log(`${DRY ? '[dry] ' : ''}${file} (+${c})`); + } else { + console.log(` (no-change) ${file}`); + } +} +console.log(`\n${DRY ? '[dry-run] ' : ''}Files in report: ${reportMap.size}, Files changed: ${filesChanged}, Tags transformed: ${totalChanges}`); diff --git a/scripts/check-api-links.mjs b/scripts/check-api-links.mjs index 1106ef7c5d..6cd7f720db 100644 --- a/scripts/check-api-links.mjs +++ b/scripts/check-api-links.mjs @@ -115,59 +115,52 @@ function extractLinks(filePath) { * Returns a Map. */ async function discoverVersions(urls) { - // Collect unique package roots from /latest/ URLs - const roots = new Set(); + // Map each root → first sample URL for that root + const rootSamples = new Map(); for (const url of urls) { const m = url.match(PKG_ROOT_RE); - if (m) roots.add(m[1]); + if (m && !rootSamples.has(m[1])) rootSamples.set(m[1], url.split('#')[0]); } - if (roots.size === 0) return new Map(); - + if (rootSamples.size === 0) return new Map(); + const versionMap = new Map(); - - // Every /latest/ page embeds a `latestVersions` JS variable mapping - // package name → current version. One fetch resolves all packages at once. - const sampleUrl = [...urls].find(u => PKG_ROOT_RE.test(u))?.split('#')[0]; - if (!sampleUrl) return versionMap; - - const controller = new AbortController(); - const timer = setTimeout(() => controller.abort(), TIMEOUT_MS); - try { - const res = await fetch(sampleUrl, { - method: 'GET', - signal: controller.signal, - headers: { 'User-Agent': 'docs-api-link-checker/1.0' }, - redirect: 'follow', - }); - clearTimeout(timer); - - // Strategy 1: redirect happened — res.url has the versioned path - const finalUrl = res.url ?? ''; - const redirectMatch = finalUrl.match(/\/(\d+\.\d+\.\d+)\//); - if (redirectMatch) { - for (const root of roots) versionMap.set(root, redirectMatch[1]); - return versionMap; - } - - // Strategy 2: parse the embedded `latestVersions` JSON object. - // The page scripts contain: - // const latestVersions = "{\"igniteui-angular\":\"21.2.0\",..."}" - const body = await res.text(); - const lvMatch = body.match(/const latestVersions\s*=\s*"((?:[^"\\]|\\.)*)"/); - if (lvMatch) { - const latestVersions = JSON.parse(lvMatch[1].replace(/\\"/g, '"')); - for (const root of roots) { - // Package name is the last path segment of the root URL + + await Promise.all([...rootSamples.entries()].map(async ([root, sampleUrl]) => { + const controller = new AbortController(); + const timer = setTimeout(() => controller.abort(), TIMEOUT_MS); + try { + const res = await fetch(sampleUrl, { + method: 'GET', + signal: controller.signal, + headers: { 'User-Agent': 'docs-api-link-checker/1.0' }, + redirect: 'follow', + }); + clearTimeout(timer); + + // Primary: extract version from the redirect destination URL + const finalUrl = res.url ?? ''; + const redirectMatch = finalUrl.match(/\/(\d+\.\d+\.\d+)\//); + if (redirectMatch) { + versionMap.set(root, redirectMatch[1]); + await res.body?.cancel(); + return; + } + + // Fallback: parse latestVersions from the page body + const body = await res.text(); + const lvMatch = body.match(/const latestVersions\s*=\s*"((?:[^"\\]|\\.)*)"/); + if (lvMatch) { + const latestVersions = JSON.parse(lvMatch[1].replace(/\\"/g, '"')); const pkgName = root.replace(/\/$/, '').split('/').pop(); if (pkgName && latestVersions[pkgName]) { versionMap.set(root, latestVersions[pkgName]); } } + } catch { + clearTimeout(timer); } - } catch { - clearTimeout(timer); - } - + })); + return versionMap; } @@ -234,6 +227,48 @@ async function checkAll(urls, versionMap, concurrency, onProgress) { return results; } +// Known framework class suffixes that may produce wrong URLs when kind="class" is wrong +const COMMON_CLASS_SUFFIXES = ['Component', 'Module', 'Service', 'Directive', 'Pipe', 'Factory']; + +// Matches class-segment staging URLs +const DIST_CLASS_URL_RE = /^(https:\/\/staging\.infragistics\.com\/api\/[^/]+\/[^/]+\/[^/]+\/)classes\/([^#]+?)(#.*)?$/; + +/** + * For a broken class URL, derives up to 3 alternative URLs: + * noSuffix — same class segment, suffix stripped + * interfacesNoSuffix — interfaces segment, suffix stripped (kind was wrong) + * interfaces — interfaces segment, type name unchanged + */ +function resolveDistVariants(url) { + const variants = {}; + const base_url = url.split('#')[0]; + const m = base_url.match(DIST_CLASS_URL_RE); + if (!m) return variants; + const [, base, typeSlug] = m; + const frag = url.includes('#') ? url.slice(url.indexOf('#')) : ''; + const dotIdx = typeSlug.lastIndexOf('.'); + const typeName = dotIdx >= 0 ? typeSlug.slice(dotIdx + 1) : typeSlug; + const pkgPart = dotIdx >= 0 ? typeSlug.slice(0, dotIdx + 1) : ''; + for (const sfx of COMMON_CLASS_SUFFIXES) { + if (typeName.endsWith(sfx)) { + const stripped = typeName.slice(0, -sfx.length); + variants.noSuffix = base + 'classes/' + pkgPart + stripped + frag; + variants.interfacesNoSuffix = base + 'interfaces/' + pkgPart + stripped + frag; + variants.interfaces = base + 'interfaces/' + pkgPart + typeName + frag; + break; + } + } + return variants; +} + +/** Returns a prop-fix hint for the source ApiLink. */ +function suggestDistFix(variantOk) { + if (variantOk.interfacesNoSuffix) return 'In ApiLink: set kind="interface" (suffix removed automatically)'; + if (variantOk.noSuffix) return 'In ApiLink: add suffix={false} or excludeSuffixFor="Platform"'; + if (variantOk.interfaces) return 'In ApiLink: set kind="interface"'; + return 'In ApiLink: verify type/member — may need exclude="Platform"'; +} + // Main // 1. Discover platform folders @@ -303,6 +338,30 @@ process.stdout.write('\n'); const elapsed = ((Date.now() - startTime) / 1000).toFixed(1); console.log(` Completed in ${elapsed}s\n`); +// 4b. Variant checking — probe alternative URLs for each broken link +const distVariantSet = new Set(); +const distVariantMeta = []; +for (const result of checkResults) { + if (result.ok) continue; + const variants = resolveDistVariants(result.url); + for (const vUrl of Object.values(variants)) distVariantSet.add(vUrl.split('#')[0]); + distVariantMeta.push({ url: result.url, variants }); +} +const distVariantOkMap = new Map(); +if (distVariantSet.size > 0) { + process.stdout.write(' Probing ' + distVariantSet.size + ' variant URL(s) for fix hints...\n'); + const vRes = await checkAll([...distVariantSet], versionMap, CONCURRENCY, () => {}); + for (const r of vRes) distVariantOkMap.set(r.url.split('#')[0], r.ok); +} +const distSuggestionMap = new Map(); +for (const { url, variants } of distVariantMeta) { + const variantOk = {}; + for (const [name, vUrl] of Object.entries(variants)) { + variantOk[name] = distVariantOkMap.get(vUrl.split('#')[0]) ?? false; + } + distSuggestionMap.set(url, { variants, variantOk, hint: suggestDistFix(variantOk) }); +} + // 5. Organize results const okResults = checkResults.filter(r => r.ok); const brokenResults = checkResults.filter(r => !r.ok); @@ -352,6 +411,15 @@ if (brokenResults.length === 0) { if (item.fetchUrl !== item.url) { console.log(` checked as: ${item.fetchUrl}`); } + const sug = distSuggestionMap.get(item.url); + if (sug) { + for (const [name, vUrl] of Object.entries(sug.variants)) { + const ok = sug.variantOk[name]; + const lbl = name === 'noSuffix' ? 'no-suffix' : name === 'interfacesNoSuffix' ? 'interfaces+no-suffix' : 'interfaces'; + console.log(' ' + (ok ? '\u2713' : '\u2717') + ' ' + lbl + ': ' + vUrl); + } + console.log(' \u2192 FIX: ' + sug.hint); + } const pages = item.pages.filter(p => p.startsWith(platform.toLowerCase().split(' ')[0])); const display = pages.length ? pages : item.pages; for (const page of display.slice(0, 3)) { @@ -380,15 +448,19 @@ if (OUTPUT) { broken: brokenResults.length, brokenNotFound: softResults.length, brokenHttp: hardResults.length, - results: checkResults.map(r => ({ - url: r.url, - fetchUrl: r.fetchUrl, - status: r.status ?? null, - error: r.error ?? null, - ok: r.ok, - pages: [...(urlIndex.get(r.url)?.pages ?? [])], - platforms: [...(urlIndex.get(r.url)?.platforms ?? [])], - })), + results: checkResults.map(r => { + const sug = r.ok ? undefined : distSuggestionMap.get(r.url); + return { + url: r.url, + fetchUrl: r.fetchUrl, + status: r.status ?? null, + error: r.error ?? null, + ok: r.ok, + pages: [...(urlIndex.get(r.url)?.pages ?? [])], + platforms: [...(urlIndex.get(r.url)?.platforms ?? [])], + ...(sug ? { hint: sug.hint, variantOk: sug.variantOk } : {}), + }; + }), }; writeFileSync(OUTPUT, JSON.stringify(report, null, 2)); console.log(`\n JSON report written to: ${OUTPUT}\n`); @@ -434,6 +506,15 @@ if (MD_OUTPUT) { if (item.fetchUrl !== item.url) { lines.push(` - Checked as: \`${item.fetchUrl}\``); } + const mdSug = distSuggestionMap.get(item.url); + if (mdSug) { + for (const [name, vUrl] of Object.entries(mdSug.variants)) { + const ok = mdSug.variantOk[name]; + const lbl = name === 'noSuffix' ? 'no-suffix' : name === 'interfacesNoSuffix' ? 'interfaces+no-suffix' : 'interfaces'; + lines.push(' - ' + (ok ? '\u2705' : '\u274c') + ' ' + lbl + ': `' + vUrl + '`'); + } + lines.push(' - **FIX**: `' + mdSug.hint + '`'); + } const pages = item.pages.filter(p => p.startsWith(platformPrefix)); const display = pages.length ? pages : item.pages; for (const page of display) { diff --git a/scripts/check-mdx-links.mjs b/scripts/check-mdx-links.mjs new file mode 100644 index 0000000000..06cb44dc97 --- /dev/null +++ b/scripts/check-mdx-links.mjs @@ -0,0 +1,761 @@ +#!/usr/bin/env node +/** + * Crawls MDX source files and checks every component's resolved URL + * against the staging API server. + * + * Parses ApiLink props directly from MDX, resolves them into staging URLs using + * the same logic as ApiLink.astro, then validates each URL is reachable. + * + * When --platform=angular the script first runs docs/angular/scripts/sync-generated.mjs + * to pull in generated xplat content, then scans docs/angular/src/content. + * Pass --no-sync to skip the pre-sync step. + * + * Usage: + * node --experimental-strip-types scripts/check-mdx-links.mjs + * node --experimental-strip-types scripts/check-mdx-links.mjs --platform=react + * node --experimental-strip-types scripts/check-mdx-links.mjs --platform=angular + * node --experimental-strip-types scripts/check-mdx-links.mjs --platform=angular --no-sync + * node --experimental-strip-types scripts/check-mdx-links.mjs --platform=angular --md=report.md + * node --experimental-strip-types scripts/check-mdx-links.mjs --concurrency=20 + * node --experimental-strip-types scripts/check-mdx-links.mjs --timeout=15000 + * node --experimental-strip-types scripts/check-mdx-links.mjs --output=report.json + * + * Exit code: 0 = all OK, 1 = broken links found. + */ + +import { readFileSync, readdirSync, writeFileSync } from 'node:fs'; +import { join, relative, resolve } from 'node:path'; +import { spawnSync } from 'node:child_process'; + +// CLI args +const args = Object.fromEntries( + process.argv.slice(2) + .filter(a => a.startsWith('--')) + .map(a => { + const [k, ...rest] = a.slice(2).split('='); + return [k, rest.length ? rest.join('=') : true]; + }) +); + +const PLATFORM = args.platform ? String(args.platform) : null; +const CONCURRENCY = parseInt(String(args.concurrency ?? '20'), 10); +const TIMEOUT_MS = parseInt(String(args.timeout ?? '15000'), 10); +const OUTPUT = args.output ? String(args.output) : null; +const MD_OUTPUT = args.md ? String(args.md) : null; +const NO_SYNC = !!args['no-sync']; +const DEFAULT_SRC = (PLATFORM === 'angular') ? 'docs/angular/src/content' : 'docs/xplat/src/content'; +const SRC_DIR = String(args.src ?? DEFAULT_SRC); + +// Platform resolution +const PLATFORM_MAP = { + angular: 'Angular', + react: 'React', + wc: 'WebComponents', + blazor: 'Blazor', +}; + +function getPlatforms() { + if (PLATFORM) { + const name = PLATFORM_MAP[PLATFORM]; + if (!name) { + console.error(`Unknown platform "${PLATFORM}". Use: angular, react, wc, blazor`); + process.exit(1); + } + return [name]; + } + return Object.values(PLATFORM_MAP); +} + +// Parse PLATFORMS from platform-context.ts directly +function parsePlatformConfigs() { + const srcPath = resolve('src/lib/platform-context.ts'); + const src = readFileSync(srcPath, 'utf-8'); + + const match = src.match(/const PLATFORMS[^=]*=\s*\{/); + if (!match) throw new Error('Cannot find PLATFORMS in platform-context.ts'); + + const startIdx = src.indexOf(match[0]) + match[0].length - 1; + let depth = 1; + let i = startIdx + 1; + while (i < src.length && depth > 0) { + if (src[i] === '{') depth++; + else if (src[i] === '}') depth--; + i++; + } + let objStr = src.slice(startIdx, i); + + // Strip TypeScript syntax + objStr = objStr + .replace(/as\s+PlatformName(\s*\|[^,}\n]+)?/g, '') + .replace(/as\s+Record<[^>]+>/g, '') + .replace(/:\s*Record/g, ''); + + const fn = new Function(`return (${objStr});`); + return fn(); +} + +const PLATFORMS = parsePlatformConfigs(); + +// ApiLink URL resolution (mirrors ApiLink.astro logic) +const KIND_SEGMENT = { + class: 'classes', + interface: 'interfaces', + enum: 'enums', + type: 'types', + variable: 'variables', + function: 'functions', +}; + +function resolveApiLinkUrl(props, platformName) { + const config = PLATFORMS[platformName]; + if (!config) return null; + + const { + type, kind = 'class', member, pkg = 'core', + prefixed = true, suffix = true, + excludeSuffixFor, excludePrefixFor, + } = props; + const prefix = config.prefix; + const pkgConfig = config.apiPackages[pkg] ?? config.apiPackages['core']; + if (!pkgConfig) return null; + + const splitList = (v) => v ? String(v).split(',').map(s => s.trim()).filter(Boolean) : []; + const effectivePrefixed = prefixed && !splitList(excludePrefixFor).includes(platformName); + const effectiveSuffix = suffix && !splitList(excludeSuffixFor).includes(platformName); + + const baseType = effectivePrefixed ? `${prefix}${type}` : type; + const segment = KIND_SEGMENT[kind]; + if (!segment) return null; + + let url; + if (kind === 'class') { + const fullType = (effectiveSuffix && pkgConfig.classSuffix) ? `${baseType}${pkgConfig.classSuffix}` : baseType; + const cased = pkgConfig.preserveCase ? fullType : fullType.toLowerCase(); + const classSlug = pkgConfig.noPackagePrefix ? cased : `${pkgConfig.packageId}.${cased}`; + const memberAnchor = member + ? `#${pkgConfig.pascalCaseMembers ? member.charAt(0).toUpperCase() + member.slice(1) : member}` + : ''; + url = `${pkgConfig.docRoot}/classes/${classSlug}${memberAnchor}`; + } else { + const slug = pkgConfig.noPackagePrefix ? baseType : `${pkgConfig.packageId}.${baseType}`; + const memberAnchorNonClass = member + ? `#${ + kind === 'enum' + ? member + : pkgConfig.pascalCaseMembers + ? member.charAt(0).toUpperCase() + member.slice(1) + : member.toLowerCase() + }` + : ''; + url = `${pkgConfig.docRoot}/${segment}/${slug}${memberAnchorNonClass}`; + } + return url; +} + +/** + * Given a BROKEN primary URL and its source props, returns up to 3 alternative + * URLs to try (no-suffix, no-prefix, no-both). Only includes variants that differ + * from the primary URL (i.e. where there is something to strip). + * + * Used post-check to suggest the cheapest prop fix: + * noSuffix → excludeSuffixFor="Platform" + * noPrefix → excludePrefixFor="Platform" (or prefixed={false} when global) + * noBoth → both of the above + */ +function resolveVariantUrls(primaryUrl, props, platformName) { + const variants = {}; + // no-suffix: disable classSuffix for this platform + const noSuffixUrl = resolveApiLinkUrl( + { ...props, suffix: false, excludeSuffixFor: undefined }, platformName); + if (noSuffixUrl && noSuffixUrl !== primaryUrl) + variants.noSuffix = noSuffixUrl; + + // no-prefix: disable platform prefix for this platform + const noPrefixUrl = resolveApiLinkUrl( + { ...props, prefixed: false, excludePrefixFor: undefined }, platformName); + if (noPrefixUrl && noPrefixUrl !== primaryUrl) + variants.noPrefix = noPrefixUrl; + + // no-both: disable both + const noBothUrl = resolveApiLinkUrl( + { ...props, suffix: false, prefixed: false, excludeSuffixFor: undefined, excludePrefixFor: undefined }, + platformName); + if (noBothUrl && noBothUrl !== primaryUrl + && noBothUrl !== variants.noSuffix && noBothUrl !== variants.noPrefix) + variants.noBoth = noBothUrl; + + return variants; +} + +/** Given which variant URLs work, returns a short prop-fix hint string. */ +function suggestFix(variantOk, platformName) { + const { noSuffix, noPrefix, noBoth } = variantOk ?? {}; + if (noSuffix && !noPrefix) return `excludeSuffixFor="${platformName}"`; + if (!noSuffix && noPrefix) return `excludePrefixFor="${platformName}" (or prefixed={false} globally)`; + if (noSuffix && noPrefix) return `excludeSuffixFor="${platformName}" -or- excludePrefixFor="${platformName}"`; + if (noBoth) return `excludeSuffixFor="${platformName}" + excludePrefixFor="${platformName}"`; + return `exclude="${platformName}" (no variant resolves — symbol absent)`; +} + +// MDX parsing + +/** Regex to match or ... */ +const API_LINK_RE = /]*?)\/?>(?:<\/ApiLink>)?/g; + +/** Regex to match ... including nested content */ +const PLATFORM_BLOCK_RE = /([\s\S]*?)<\/PlatformBlock>/g; + +/** Parses JSX-style props from a string like `pkg="charts" type="CategoryChart" kind="enum" prefixed={false}` */ +function parseProps(propsStr) { + const props = {}; + const PROP_RE = /(\w+)\s*=\s*(?:"([^"]*)"|'([^']*)'|{([^}]*)})/g; + let m; + while ((m = PROP_RE.exec(propsStr)) !== null) { + const [, name, strVal, singleVal, exprVal] = m; + if (strVal !== undefined) { + props[name] = strVal; + } else if (singleVal !== undefined) { + props[name] = singleVal; + } else if (exprVal !== undefined) { + if (exprVal === 'true') props[name] = true; + else if (exprVal === 'false') props[name] = false; + else if (/^\d+$/.test(exprVal)) props[name] = parseInt(exprVal, 10); + else props[name] = exprVal; + } + } + return props; +} + +/** + * Extracts all ApiLink occurrences from an MDX file, respecting PlatformBlock scoping. + * Returns an array of { props, platforms } where platforms is null (all) or a Set of platform names. + */ +function extractApiLinks(content) { + const results = []; + + // Strip MDX/JSX comments ({/* ... */}) and HTML comments () by + // replacing them with same-length whitespace so byte positions stay aligned. + content = content.replace(/\{\/\*[\s\S]*?\*\/\}/g, m => ' '.repeat(m.length)); + content = content.replace(//g, m => ' '.repeat(m.length)); + + // Collect PlatformBlock open/close tokens; resolve nesting via a stack so + // an ApiLink's platform scope is the intersection of all enclosing blocks. + const PB_OPEN_TOKEN = //g; + const PB_CLOSE_TOKEN = /<\/PlatformBlock>/g; + const pbTokens = []; + let pbTok; + while ((pbTok = PB_OPEN_TOKEN.exec(content)) !== null) { + const platforms = new Set(pbTok[1].split(',').map(p => p.trim())); + pbTokens.push({ kind: 'open', pos: pbTok.index, end: pbTok.index + pbTok[0].length, platforms }); + } + while ((pbTok = PB_CLOSE_TOKEN.exec(content)) !== null) { + pbTokens.push({ kind: 'close', pos: pbTok.index, end: pbTok.index + pbTok[0].length }); + } + pbTokens.sort((a, b) => a.pos - b.pos); + + const blockRanges = []; // { start, end, platforms: Set } + const pbStack = []; + for (const tok of pbTokens) { + if (tok.kind === 'open') { + pbStack.push(tok); + } else { + const opened = pbStack.pop(); + if (opened) { + blockRanges.push({ start: opened.pos, end: tok.end, platforms: opened.platforms }); + } + } + } + + // Find all ApiLinks + API_LINK_RE.lastIndex = 0; + let alMatch; + while ((alMatch = API_LINK_RE.exec(content)) !== null) { + const pos = alMatch.index; + const props = parseProps(alMatch[1]); + if (!props.type) continue; + + // Skip template variables like {ComponentName} — resolved at build time + if (/\{.*\}/.test(props.type)) continue; + + // Intersection of ALL enclosing PlatformBlock scopes (handles nesting). + let scopedPlatforms = null; + for (const b of blockRanges) { + if (pos < b.start || pos >= b.end) continue; + if (scopedPlatforms === null) { + scopedPlatforms = new Set(b.platforms); + } else { + for (const p of [...scopedPlatforms]) { + if (!b.platforms.has(p)) scopedPlatforms.delete(p); + } + } + } + // Honor exclude="A,B" on the ApiLink itself: those platforms render a + // code-only fallback (no link) and must not be checked. + if (props.exclude) { + const excluded = new Set(props.exclude.split(',').map(s => s.trim()).filter(Boolean)); + if (scopedPlatforms === null) { + scopedPlatforms = new Set(['Angular', 'React', 'WebComponents', 'Blazor']); + } + for (const p of [...scopedPlatforms]) { + if (excluded.has(p)) scopedPlatforms.delete(p); + } + } + results.push({ + props, + platforms: scopedPlatforms, + }); + } + + return results; +} + +// File walking — MDX source files only (single file or directory) +function walkMdx(dir) { + const results = []; + let entries; + try { + entries = readdirSync(dir, { withFileTypes: true }); + } catch { + // dir might be a single file path + if (dir.endsWith('.mdx')) results.push(dir); + return results; + } + for (const entry of entries) { + const full = join(dir, entry.name); + if (entry.isDirectory()) { + results.push(...walkMdx(full)); + } else if (entry.isFile() && entry.name.endsWith('.mdx')) { + results.push(full); + } + } + return results; +} + +// Version discovery +const PKG_ROOT_RE = /^(https:\/\/staging\.infragistics\.com\/api\/[^/]+\/[^/]+\/)latest\//; + +/** + * Discovers the actual published version for each unique package root by + * following the /latest/ redirect independently per package. + * Each package (igniteui-react, igniteui-react-grids, igniteui-react-charts, …) + * may be at a different version, so we must NOT share a single resolved version + * across all packages. + */ +async function discoverVersions(urls) { + // Map each root → first sample URL for that root + const rootSamples = new Map(); + for (const url of urls) { + const m = url.match(PKG_ROOT_RE); + if (m && !rootSamples.has(m[1])) rootSamples.set(m[1], url.split('#')[0]); + } + if (rootSamples.size === 0) return new Map(); + + const versionMap = new Map(); + + await Promise.all([...rootSamples.entries()].map(async ([root, sampleUrl]) => { + const controller = new AbortController(); + const timer = setTimeout(() => controller.abort(), TIMEOUT_MS); + try { + const res = await fetch(sampleUrl, { + method: 'GET', + signal: controller.signal, + headers: { 'User-Agent': 'docs-api-link-checker/1.0' }, + redirect: 'follow', + }); + clearTimeout(timer); + + // Primary: extract version from the redirect destination URL + const finalUrl = res.url ?? ''; + const redirectMatch = finalUrl.match(/\/(\d+\.\d+\.\d+)\//); + if (redirectMatch) { + versionMap.set(root, redirectMatch[1]); + await res.body?.cancel(); + return; + } + + // Fallback: parse latestVersions from the page body + const body = await res.text(); + const lvMatch = body.match(/const latestVersions\s*=\s*"((?:[^"\\]|\\.)*)"/); + if (lvMatch) { + const latestVersions = JSON.parse(lvMatch[1].replace(/\\"/g, '"')); + const pkgName = root.replace(/\/$/, '').split('/').pop(); + if (pkgName && latestVersions[pkgName]) { + versionMap.set(root, latestVersions[pkgName]); + } + } + } catch { + clearTimeout(timer); + } + })); + + return versionMap; +} + +function resolveLatest(url, versionMap) { + const m = url.match(PKG_ROOT_RE); + if (!m) return url; + const version = versionMap.get(m[1]); + return version ? url.replace('/latest/', `/${version}/`) : url; +} + +// HTTP checking +const NOT_FOUND_MARKER = 'class="docs-breadcrumb-crumb" title="Page not found"'; + +async function checkUrl(url, versionMap) { + const baseUrl = url.split('#')[0]; + const fetchUrl = resolveLatest(baseUrl, versionMap); + const controller = new AbortController(); + const timer = setTimeout(() => controller.abort(), TIMEOUT_MS); + try { + const res = await fetch(fetchUrl, { + method: 'GET', + signal: controller.signal, + headers: { 'User-Agent': 'docs-api-link-checker/1.0' }, + redirect: 'follow', + }); + clearTimeout(timer); + + if (!res.ok) { + await res.body?.cancel(); + return { url, fetchUrl, status: res.status, ok: false }; + } + + const body = await res.text(); + if (body.includes(NOT_FOUND_MARKER)) { + return { url, fetchUrl, status: 'NOT_FOUND', ok: false }; + } + + return { url, fetchUrl, status: res.status, ok: true }; + } catch (err) { + clearTimeout(timer); + return { + url, + fetchUrl, + status: null, + ok: false, + error: err.name === 'AbortError' ? 'TIMEOUT' : String(err.message), + }; + } +} + +async function checkAll(urls, versionMap, concurrency, onProgress) { + const results = []; + let idx = 0; + async function worker() { + while (idx < urls.length) { + const url = urls[idx++]; + const result = await checkUrl(url, versionMap); + results.push(result); + onProgress(result, results.length, urls.length); + } + } + await Promise.all(Array.from({ length: Math.min(concurrency, urls.length) }, worker)); + return results; +} + +// --- Main --- + +const targetPlatforms = getPlatforms(); + +// For Angular: sync generated MDX content into docs/angular before scanning +if (PLATFORM === 'angular' && !NO_SYNC) { + const syncScript = resolve('docs/angular/scripts/sync-generated.mjs'); + console.log('\n Syncing Angular generated content (sync-generated.mjs)...'); + const r = spawnSync(process.execPath, [syncScript], { stdio: 'inherit' }); + if (r.status !== 0) { + console.error('\n sync-generated.mjs failed — aborting.'); + process.exit(1); + } + console.log(); +} + +console.log(`\nScanning sources in "${SRC_DIR}"`); +console.log(`Platforms: ${targetPlatforms.join(', ')}\n`); + +const mdxFiles = walkMdx(resolve(SRC_DIR)); +if (mdxFiles.length === 0) { + console.error(`No MDX files found in "${SRC_DIR}".`); + process.exit(1); +} + +// Build URL index: url -> { pages, platforms, propsByPlatform } +const urlIndex = new Map(); +let totalLinks = 0; + +for (const file of mdxFiles) { + const relPath = relative(process.cwd(), file).replace(/\\/g, '/'); + const content = readFileSync(file, 'utf-8'); + const apiLinks = extractApiLinks(content); + + for (const { props, platforms: scopedPlatforms } of apiLinks) { + const applicablePlatforms = scopedPlatforms + ? targetPlatforms.filter(p => scopedPlatforms.has(p)) + : targetPlatforms; + + for (const platformName of applicablePlatforms) { + const url = resolveApiLinkUrl(props, platformName); + if (!url) continue; + + totalLinks++; + if (!urlIndex.has(url)) { + urlIndex.set(url, { pages: new Set(), platforms: new Set(), propsByPlatform: new Map() }); + } + urlIndex.get(url).pages.add(relPath); + urlIndex.get(url).platforms.add(platformName); + // Store props once per platform so we can generate variant URLs later + if (!urlIndex.get(url).propsByPlatform.has(platformName)) { + urlIndex.get(url).propsByPlatform.set(platformName, props); + } + } + } +} + +const uniqueUrls = [...urlIndex.keys()].sort(); +console.log(` MDX files scanned : ${mdxFiles.length}`); +console.log(` Total ApiLink refs : ${totalLinks}`); +console.log(` Unique staging URLs: ${uniqueUrls.length}`); +console.log(` Concurrency : ${CONCURRENCY}`); +console.log(` Timeout / request : ${TIMEOUT_MS} ms\n`); + +if (uniqueUrls.length === 0) { + console.log('No staging API links resolved. Nothing to check.'); + process.exit(0); +} + +// Discover versions +const versionMap = await discoverVersions(uniqueUrls); + +// Check all URLs +const startTime = Date.now(); +const checkResults = await checkAll(uniqueUrls, versionMap, CONCURRENCY, (_r, done, total) => { + const pct = ((done / total) * 100).toFixed(1); + process.stdout.write(`\r Checking... ${done}/${total} (${pct}%) `); +}); +process.stdout.write('\n'); +const elapsed = ((Date.now() - startTime) / 1000).toFixed(1); +console.log(` Completed in ${elapsed}s\n`); + +// Organize results +const okResults = checkResults.filter(r => r.ok); +const brokenResults = checkResults.filter(r => !r.ok); +const softResults = brokenResults.filter(r => r.status === 'NOT_FOUND'); +const hardResults = brokenResults.filter(r => r.status !== 'NOT_FOUND'); + +const brokenByPlatform = new Map( + targetPlatforms.map(p => [p, []]) +); +for (const result of brokenResults) { + const meta = urlIndex.get(result.url); + for (const platform of meta.platforms) { + if (brokenByPlatform.has(platform)) { + brokenByPlatform.get(platform).push({ + url: result.url, + fetchUrl: result.fetchUrl, + status: result.status ?? result.error, + pages: [...meta.pages], + }); + } + } +} + +// ── Variant URL checking (post-primary-check) ────────────────────────────── +// For every broken (url, platform) pair, compute up to 3 variant URLs and +// batch-check them, then build a suggestion map used in the report. + +const variantUrlSet = new Set(); + +// Collect all variant base-URLs that we need to probe +const brokenVariantMeta = []; // { url, platformName, primaryFetchUrl, variants } +for (const result of brokenResults) { + const meta = urlIndex.get(result.url); + for (const platformName of meta.platforms) { + if (!brokenByPlatform.has(platformName)) continue; + const props = meta.propsByPlatform.get(platformName); + if (!props) continue; + const variants = resolveVariantUrls(result.url, props, platformName); + for (const vUrl of Object.values(variants)) { + variantUrlSet.add(vUrl.split('#')[0]); + } + brokenVariantMeta.push({ url: result.url, platformName, variants }); + } +} + +// Probe all unique variant base-URLs +const variantOkMap = new Map(); // base-url -> boolean +if (variantUrlSet.size > 0) { + process.stdout.write(` Probing ${variantUrlSet.size} variant URL(s) for fix hints...\n`); + const vRes = await checkAll([...variantUrlSet], versionMap, CONCURRENCY, () => {}); + for (const r of vRes) variantOkMap.set(r.url.split('#')[0], r.ok); +} + +// Build suggestion lookup: "${url}::${platform}" -> { variants, variantOk, hint } +const suggestionMap = new Map(); +for (const { url, platformName, variants } of brokenVariantMeta) { + const variantOk = {}; + for (const [name, vUrl] of Object.entries(variants)) { + variantOk[name] = variantOkMap.get(vUrl.split('#')[0]) ?? false; + } + const hint = suggestFix(variantOk, platformName); + suggestionMap.set(`${url}::${platformName}`, { variants, variantOk, hint }); +} +// ───────────────────────────────────────────────────────────────────────────── + +// Print report +const HR = '\u2550'.repeat(72); +const HR2 = '\u2500'.repeat(72); +console.log(HR); +console.log(' API LINK CHECK REPORT (MDX source)'); +console.log(HR); +console.log(` \u2713 OK : ${okResults.length}`); +console.log(` \u2717 Not found : ${softResults.length} \u2190 type/member missing (HTTP 200 + 404 body)`); +console.log(` \u2717 HTTP error : ${hardResults.length}`); +console.log(` \u2717 Total broken : ${brokenResults.length}`); +console.log(HR2); + +if (brokenResults.length === 0) { + console.log('\n All staging API links are reachable.\n'); +} else { + for (const [platform, items] of brokenByPlatform) { + if (items.length === 0) continue; + const unique = [...new Map(items.map(i => [i.url, i])).values()]; + console.log(`\n ${platform} \u2014 ${unique.length} broken link${unique.length === 1 ? '' : 's'}\n`); + for (const item of unique) { + const tag = item.status === 'NOT_FOUND' + ? '[NOT FOUND \u2014 type/member missing]' + : `[HTTP ${item.status ?? item.error}]`; + console.log(` \u2717 ${tag}`); + console.log(` ${item.url}`); + if (item.fetchUrl !== item.url) { + console.log(` checked as: ${item.fetchUrl}`); + } + // Variant hints + const sug = suggestionMap.get(`${item.url}::${platform}`); + if (sug) { + const TICK = '\u2713', CROSS = '\u2717'; + for (const [name, vUrl] of Object.entries(sug.variants)) { + const ok = sug.variantOk[name]; + const label = name === 'noSuffix' ? 'no-suffix' : name === 'noPrefix' ? 'no-prefix' : 'no-suffix+prefix'; + console.log(` ${ok ? TICK : CROSS} ${label}: ${vUrl}`); + } + console.log(` \u2192 FIX: ${sug.hint}`); + } + for (const page of item.pages.slice(0, 3)) { + console.log(` in: ${page}`); + } + if (item.pages.length > 3) { + console.log(` ... and ${item.pages.length - 3} more page(s)`); + } + } + } + console.log(''); +} + +console.log(HR); + +// Optional JSON report +if (OUTPUT) { + const report = { + generatedAt: new Date().toISOString(), + srcDir: SRC_DIR, + platforms: targetPlatforms, + resolvedVersions: Object.fromEntries(versionMap), + totalFiles: mdxFiles.length, + totalLinks, + uniqueUrls: uniqueUrls.length, + ok: okResults.length, + broken: brokenResults.length, + brokenNotFound: softResults.length, + brokenHttp: hardResults.length, + results: checkResults.map(r => { + const meta = urlIndex.get(r.url); + const suggestions = r.ok ? undefined : Object.fromEntries( + [...(meta?.platforms ?? [])].map(p => { + const s = suggestionMap.get(`${r.url}::${p}`); + return [p, s ? { hint: s.hint, variantOk: s.variantOk } : { hint: `exclude="${p}"` }]; + }) + ); + return { + url: r.url, + fetchUrl: r.fetchUrl, + status: r.status ?? null, + error: r.error ?? null, + ok: r.ok, + pages: [...(meta?.pages ?? [])], + platforms: [...(meta?.platforms ?? [])], + ...(suggestions ? { suggestions } : {}), + }; + }), + }; + writeFileSync(OUTPUT, JSON.stringify(report, null, 2)); + console.log(`\n JSON report written to: ${OUTPUT}\n`); +} + +// Optional Markdown report +if (MD_OUTPUT) { + const lines = []; + const ts = new Date().toISOString().replace('T', ' ').slice(0, 19) + ' UTC'; + lines.push(`# API Link Check Report`); + lines.push(`\n_Generated: ${ts}_\n`); + lines.push(`## Summary\n`); + lines.push(`| | |`); + lines.push(`|---|---|`); + lines.push(`| \u2705 OK | ${okResults.length} |`); + lines.push(`| \u274c Not found (type/member missing) | ${softResults.length} |`); + lines.push(`| \u274c HTTP error | ${hardResults.length} |`); + lines.push(`| \u274c **Total broken** | **${brokenResults.length}** |`); + lines.push(``); + + for (const [platform, items] of brokenByPlatform) { + if (items.length === 0) continue; + const unique = [...new Map(items.map(i => [i.url, i])).values()]; + lines.push(`## ${platform} \u2014 ${unique.length} broken link${unique.length === 1 ? '' : 's'}\n`); + + // Group by page + const byPage = new Map(); + for (const item of items) { + for (const page of item.pages) { + if (!byPage.has(page)) byPage.set(page, []); + byPage.get(page).push(item); + } + } + + lines.push(`### By URL\n`); + for (const item of unique) { + const tag = item.status === 'NOT_FOUND' ? 'NOT FOUND \u2014 type/member missing' : `HTTP ${item.status ?? item.error}`; + lines.push(`- \u274c \`${tag}\``); + lines.push(` - URL: \`${item.url}\``); + if (item.fetchUrl !== item.url) { + lines.push(` - Checked as: \`${item.fetchUrl}\``); + } + const mdSug = suggestionMap.get(`${item.url}::${platform}`); + if (mdSug) { + const TICK = '\u2705', CROSS = '\u274c'; + for (const [name, vUrl] of Object.entries(mdSug.variants)) { + const ok = mdSug.variantOk[name]; + const label = name === 'noSuffix' ? 'no-suffix' : name === 'noPrefix' ? 'no-prefix' : 'no-suffix+prefix'; + lines.push(` - ${ok ? TICK : CROSS} ${label}: \`${vUrl}\``); + } + lines.push(` - **FIX**: \`${mdSug.hint}\``); + } + for (const page of item.pages) { + lines.push(` - in: \`${page}\``); + } + } + lines.push(``); + + lines.push(`### By Page\n`); + for (const [page, pageItems] of [...byPage.entries()].sort()) { + const pageUnique = [...new Map(pageItems.map(i => [i.url, i])).values()]; + lines.push(`#### \`${page}\` \u2014 ${pageUnique.length} broken link${pageUnique.length === 1 ? '' : 's'}\n`); + for (const item of pageUnique) { + lines.push(`- \`${item.url}\``); + } + lines.push(``); + } + } + + writeFileSync(MD_OUTPUT, lines.join('\n')); + console.log(`\n Markdown report written to: ${MD_OUTPUT}\n`); +} + +process.exit(brokenResults.length > 0 ? 1 : 0); diff --git a/scripts/migrate-platformblock-to-exclude.mjs b/scripts/migrate-platformblock-to-exclude.mjs new file mode 100644 index 0000000000..bedde0719c --- /dev/null +++ b/scripts/migrate-platformblock-to-exclude.mjs @@ -0,0 +1,72 @@ +#!/usr/bin/env node +/** + * migrate-platformblock-to-exclude.mjs + * + * Scans the xplat MDX content tree for PURE-EXCLUSION wrappers of the form: + * + * + * + * (i.e. a PlatformBlock that lists 3-of-4 known platforms, contains nothing + * but a single self-closing ) and rewrites them as: + * + * + * + * Generalized to any single excluded platform. + * + * Idempotent. Run with `--dry-run` to preview. + * + * Usage: + * node scripts/migrate-platformblock-to-exclude.mjs [--dry-run] + */ + +import { readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs'; +import { join, sep } from 'node:path'; + +const DRY = process.argv.includes('--dry-run'); +const ALL = ['Angular', 'React', 'WebComponents', 'Blazor']; + +const ROOT = join(process.cwd(), 'docs', 'xplat', 'src', 'content'); + +function walk(dir, out = []) { + for (const entry of readdirSync(dir)) { + const full = join(dir, entry); + const st = statSync(full); + if (st.isDirectory()) walk(full, out); + else if (full.endsWith('.mdx')) out.push(full); + } + return out; +} + +// PURE-EXCLUSION wrapper: PlatformBlock that contains exactly one self-closing +// ApiLink (whitespace allowed) and nothing else. +const PB_API_RE = /\s*(]*\/>)\s*<\/PlatformBlock>/g; + +function migrate(text) { + let count = 0; + const out = text.replace(PB_API_RE, (full, forAttr, apiTag) => { + const fors = forAttr.split(',').map(s => s.trim()).filter(Boolean); + // Only handle single-platform exclusion: |fors| === |ALL| - 1 + if (fors.length !== ALL.length - 1) return full; + const excluded = ALL.filter(p => !fors.includes(p)); + if (excluded.length !== 1) return full; + // Skip if tag already has exclude attribute + if (/\sexclude="/.test(apiTag)) return full; + count++; + const newTag = apiTag.replace(/\s*\/>$/, ` exclude="${excluded[0]}" />`); + return newTag; + }); + return { text: out, count }; +} + +let totalFiles = 0, totalReplacements = 0; +for (const file of walk(ROOT)) { + const src = readFileSync(file, 'utf8'); + const { text, count } = migrate(src); + if (count > 0) { + totalFiles++; + totalReplacements += count; + console.log(`${DRY ? '[dry] ' : ''}${file.replace(process.cwd() + sep, '').replaceAll('\\','/')} (+${count})`); + if (!DRY) writeFileSync(file, text); + } +} +console.log(`\n${DRY ? '[dry-run] ' : ''}Files: ${totalFiles}, Replacements: ${totalReplacements}`); diff --git a/src/lib/platform-context.ts b/src/lib/platform-context.ts index f8fe005ca3..4bce5e6ed9 100644 --- a/src/lib/platform-context.ts +++ b/src/lib/platform-context.ts @@ -56,14 +56,19 @@ const PLATFORMS: Record = { grids: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-grids/latest', packageId: 'igniteui-react-grids', noPackagePrefix: true, preserveCase: true }, gauges: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-gauges/latest', packageId: 'igniteui-react-gauges', noPackagePrefix: true, preserveCase: true }, maps: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-maps/latest', packageId: 'igniteui-react-maps', noPackagePrefix: true, preserveCase: true }, - inputs: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-inputs/latest', packageId: 'igniteui-react-inputs', noPackagePrefix: true, preserveCase: true }, - layouts: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-layouts/latest', packageId: 'igniteui-react-layouts', noPackagePrefix: true, preserveCase: true }, + // React: "inputs" / "layouts" components are published under the main `igniteui-react` + // package (no standalone `igniteui-react-inputs` / `igniteui-react-layouts` TypeDoc). + // A handful of layout-only types (IgrDockManager, IgrSplitPane, IgrToolbar, IgrTool*) + // don't exist in the React TypeDoc at all — those will 404 regardless. + inputs: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react/latest', packageId: 'igniteui-react', noPackagePrefix: true, preserveCase: true }, + layouts: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react/latest', packageId: 'igniteui-react', noPackagePrefix: true, preserveCase: true }, excel: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-excel/latest', packageId: 'igniteui-react-excel', noPackagePrefix: true, preserveCase: true }, spreadsheet: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-spreadsheet/latest', packageId: 'igniteui-react-spreadsheet', noPackagePrefix: true, preserveCase: true }, datasources: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-datasources/latest', packageId: 'igniteui-react-datasources', noPackagePrefix: true, preserveCase: true }, 'grid-lite': { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-grids/latest', packageId: 'igniteui-react-grids', noPackagePrefix: true, preserveCase: true }, 'geo-core': { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-core/latest', packageId: 'igniteui-react-core', noPackagePrefix: true, preserveCase: true }, - 'data-grids': { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-data-grids/latest', packageId: 'igniteui-react-data-grids', noPackagePrefix: true, preserveCase: true }, + // No standalone `igniteui-react-data-grids` TypeDoc; data-grid types live in `igniteui-react-grids`. + 'data-grids': { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-grids/latest', packageId: 'igniteui-react-grids', noPackagePrefix: true, preserveCase: true }, dockmanager: { docRoot: 'https://staging.infragistics.com/api/react/igniteui-react-dockmanager/latest', packageId: 'igniteui-react-dockmanager', noPackagePrefix: true, preserveCase: true }, }, packages: {