diff --git a/docs/guides/configuration.md b/docs/guides/configuration.md index 1f6437e..63c980e 100644 --- a/docs/guides/configuration.md +++ b/docs/guides/configuration.md @@ -8,17 +8,17 @@ description: You can learn about the configuration in the documentation of the D Configure the Pivot table and the Configuration panel through the following API: -- [`config`](api/config/config-property.md) — define the structure of the Pivot table and how data is aggregated -- [`render-table`](api/events/render-table-event.md) — change the table configuration on the fly -- [`tableShape`](api/config/tableshape-property.md) — configure the look of the Pivot table -- [`columnShape`](api/config/columnshape-property.md) — configure the look and behavior of columns -- [`headerShape`](api/config/headershape-property.md) — configure the look and behavior of headers -- [`configPanel`](api/config/configpanel-property.md) — control the visibility of the Configuration panel -- [`setLocale`](api/methods/setlocale-method.md) — apply a locale (see [Localization](guides/localization.md)) -- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) — load data and field metadata -- [`predicates`](api/config/predicates-property.md) — pre-process data before aggregation -- [`methods`](api/config/methods-property.md) — define custom aggregation methods -- [`limits`](api/config/limits-property.md) — cap the number of rows and columns in the final dataset +- [`config`](api/config/config-property.md) - define the structure of the Pivot table and how data is aggregated +- [`render-table`](api/events/render-table-event.md) - change the table configuration on the fly +- [`tableShape`](api/config/tableshape-property.md) - configure the look of the Pivot table +- [`columnShape`](api/config/columnshape-property.md) - configure the look and behavior of columns +- [`headerShape`](api/config/headershape-property.md) - configure the look and behavior of headers +- [`configPanel`](api/config/configpanel-property.md) - control the visibility of the Configuration panel +- [`setLocale`](api/methods/setlocale-method.md) - apply a locale (see [Localization](guides/localization.md)) +- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) - load data and field metadata +- [`predicates`](api/config/predicates-property.md) - pre-process data before aggregation +- [`methods`](api/config/methods-property.md) - define custom aggregation methods +- [`limits`](api/config/limits-property.md) - cap the number of rows and columns in the final dataset For instructions on working with data, see [Working with data](guides/working-with-data.md). @@ -81,14 +81,14 @@ To set the width of specific columns, use the `width` parameter of the [`columnS ## Autosize columns to content -Use the `autoWidth` parameter of the [`columnShape`](api/config/columnshape-property.md) property to calculate column widths automatically. All `autoWidth` sub-parameters are optional — for full descriptions see the [`columnShape`](api/config/columnshape-property.md) reference. +Use the `autoWidth` parameter of the [`columnShape`](api/config/columnshape-property.md) property to calculate column widths automatically. All `autoWidth` sub-parameters are optional. For full descriptions, see the [`columnShape`](api/config/columnshape-property.md) reference. The `autoWidth` object accepts the following parameters: -- `columns` — object that selects which fields receive auto-calculated width -- `auto` — adjusts the width to the header, the cell content, or both -- `maxRows` — number of data rows analyzed to detect column size (default: 20) -- `firstOnly` — if `true` (default), analyzes each field only once. When multiple columns are based on the same field (e.g., `oil` with `count` and `oil` with `sum`), only the first column is analyzed and the others inherit its width +- `columns` - object that selects which fields receive auto-calculated width +- `auto` - adjusts the width to the header, the cell content, or both +- `maxRows` - number of data rows analyzed to detect column size (default: 20) +- `firstOnly` - if `true` (default), analyzes each field only once. When multiple columns are based on the same field (e.g., `oil` with `count` and `oil` with `sum`), only the first column is analyzed and the others inherit its width The following code snippet enables `autoWidth` for four fields and disables `firstOnly` so every column gets its own measurement: @@ -460,7 +460,7 @@ widget.api.on("render-table", ({ config: tableConfig }) => { ## Sort in columns -Sorting in the UI is enabled by default — users click a column header to sort. To disable it, set the `sort` parameter of the [`columnShape`](api/config/columnshape-property.md) property to `false`. +Sorting in the UI is enabled by default: users click a column header to sort. To disable it, set the `sort` parameter of the [`columnShape`](api/config/columnshape-property.md) property to `false`. The following code snippet disables UI sorting: @@ -727,10 +727,10 @@ For an alternative API, use the [`showConfigPanel`](api/methods/showconfigpanel- The Configuration panel supports the following field operations: -- [`add-field`](api/events/add-field-event.md) — add a field to an area -- [`delete-field`](api/events/delete-field-event.md) — remove a field from an area -- [`update-field`](api/events/update-field-event.md) — update a field's method or settings -- [`move-field`](api/events/move-field-event.md) — reorder fields within an area +- [`add-field`](api/events/add-field-event.md) - add a field to an area +- [`delete-field`](api/events/delete-field-event.md) - remove a field from an area +- [`update-field`](api/events/update-field-event.md) - update a field's method or settings +- [`move-field`](api/events/move-field-event.md) - reorder fields within an area **Related samples**: - [Pivot 2. Adding text templates for table and header cells](https://snippet.dhtmlx.com/n9ylp6b2) diff --git a/docs/guides/initialization.md b/docs/guides/initialization.md index c1f33c8..c8e3214 100644 --- a/docs/guides/initialization.md +++ b/docs/guides/initialization.md @@ -66,10 +66,10 @@ const table = new pivot.Pivot("#root", { The constructor returns a Pivot instance. Call API methods on the returned instance: -- [`getTable`](api/methods/gettable-method.md) — get access to the underlying Table widget instance -- [`setConfig`](api/methods/setconfig-method.md) — update the current Pivot configuration -- [`setLocale`](api/methods/setlocale-method.md) — apply a new locale to Pivot -- [`showConfigPanel`](api/methods/showconfigpanel-method.md) — show or hide the Configuration panel +- [`getTable`](api/methods/gettable-method.md) - get access to the underlying Table widget instance +- [`setConfig`](api/methods/setconfig-method.md) - update the current Pivot configuration +- [`setLocale`](api/methods/setlocale-method.md) - apply a new locale to Pivot +- [`showConfigPanel`](api/methods/showconfigpanel-method.md) - show or hide the Configuration panel ## Configuration properties diff --git a/docs/guides/integration-with-angular.md b/docs/guides/integration-with-angular.md index 5aa5383..af097b1 100644 --- a/docs/guides/integration-with-angular.md +++ b/docs/guides/integration-with-angular.md @@ -25,7 +25,7 @@ ng new my-angular-pivot-app ~~~ :::note -Disable Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) when prompted by the Angular CLI — this guide assumes a client-rendered app. +Disable Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) when prompted by the Angular CLI. This guide assumes a client-rendered app. ::: The command installs all necessary tools. No additional commands are needed. diff --git a/docs/guides/loading-data.md b/docs/guides/loading-data.md index 86f08e8..d61e6ac 100644 --- a/docs/guides/loading-data.md +++ b/docs/guides/loading-data.md @@ -167,9 +167,9 @@ Pivot accepts CSV data after you convert it to JSON with an external JS parsing The example below uses the external [PapaParse](https://cdnjs.cloudflare.com/ajax/libs/PapaParse/5.4.1/papaparse.min.js) library to load and convert data on a button click. The `convert()` helper takes the following parameters: -- `data` — a string with CSV data -- `headers` — an array of CSV field names -- `meta` — an object mapping field names to data types +- `data` - a string with CSV data +- `headers` - an array of CSV field names +- `meta` - an object mapping field names to data types The following code snippet creates Pivot, defines the `convert()` helper, and applies parsed CSV data through [`setConfig`](api/methods/setconfig-method.md) on a button click: diff --git a/docs/guides/stylization.md b/docs/guides/stylization.md index bd88622..7a64d82 100644 --- a/docs/guides/stylization.md +++ b/docs/guides/stylization.md @@ -112,7 +112,7 @@ To style body or footer cells, use the `cellStyle` parameter of the [`tableShape The example below applies styles to body and header cells: - body cells receive a class based on cell values (e.g., `"Down"`, `"Up"`, `"Idle"` in the `status` field) and on total values (greater than 40 or less than 5) -- header cells receive a class based on the value of the `streaming` field — `status-down` for `"no"` and `status-up` for any other value +- header cells receive a class based on the value of the `streaming` field: `status-down` for `"no"` and `status-up` for any other value ~~~jsx const widget = new pivot.Pivot("#pivot", { diff --git a/docs/guides/typescript-support.md b/docs/guides/typescript-support.md index e9495fd..540bd5e 100644 --- a/docs/guides/typescript-support.md +++ b/docs/guides/typescript-support.md @@ -6,7 +6,7 @@ description: You can learn about using typescript with the DHTMLX JavaScript Piv # TypeScript support -DHTMLX Pivot ships TypeScript definitions starting from v2.0. The definitions are ready to use — no extra configuration needed. +DHTMLX Pivot ships TypeScript definitions starting from v2.0. The definitions are ready to use, with no extra configuration needed. :::info Try Pivot live in the [Snippet Tool](https://snippet.dhtmlx.com/y2buoahe). diff --git a/docs/guides/working-with-data.md b/docs/guides/working-with-data.md index ab26158..74e83db 100644 --- a/docs/guides/working-with-data.md +++ b/docs/guides/working-with-data.md @@ -10,7 +10,7 @@ This page describes how to aggregate, format, sort, filter, and pre-process data ## Define fields -Use the [`fields`](api/config/fields-property.md) property to declare the fields that Pivot can place in rows, columns, and values. Each item in the `fields` array describes one field — its ID, label, and data type. +Use the [`fields`](api/config/fields-property.md) property to declare the fields that Pivot can place in rows, columns, and values. Each item in the `fields` array describes one field: its ID, label, and data type. The following code snippet initializes Pivot with five fields: @@ -127,7 +127,7 @@ For the `xlsx` export format, Pivot exports date and number fields as raw values ## Define Pivot structure -Use the [`config`](api/config/config-property.md) property to declare which fields appear as rows, columns, and aggregated values, and how the data is filtered. The `config` property has no predefined values — you must set it to render any data. See the [`config`](api/config/config-property.md) reference for the full parameter list. +Use the [`config`](api/config/config-property.md) property to declare which fields appear as rows, columns, and aggregated values, and how the data is filtered. The `config` property has no predefined values, so you must set it to render any data. See the [`config`](api/config/config-property.md) reference for the full parameter list. The following code snippet places `continent` and `name` in rows, `year` in columns, three aggregations in values, and a filter on `name`: @@ -253,9 +253,9 @@ In the UI, filters appear as drop-down lists for each field. Pivot supports the following filter conditions per data type: -- text fields — `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` -- numeric fields — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` -- date fields — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` +- text fields: `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` +- numeric fields: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` +- date fields: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` The `includes` rule restricts a filter to a specific set of allowed values. @@ -263,7 +263,7 @@ The `includes` rule restricts a filter to a specific set of allowed values. To declare a filter, add the `filters` object to the [`config`](api/config/config-property.md) property, keyed by field ID. Each value is an object of filter conditions. -The following code snippet applies two filters — one on `genre` (values containing `"D"`, restricted to `"Drama"`) and one on `title` (values containing `"A"`): +The following code snippet applies two filters, one on `genre` (values containing `"D"`, restricted to `"Drama"`) and one on `title` (values containing `"A"`): ~~~jsx const table = new pivot.Pivot("#root", { @@ -304,7 +304,7 @@ To filter data through the Table widget API instead, access the Table instance w To prevent the component from hanging on very large datasets, cap the number of rows and columns in the final dataset with the [`limits`](api/config/limits-property.md) property. Pivot interrupts rendering once the limit is reached. The default cap is 10000 for rows and 5000 for columns. :::note -Limits apply to large datasets. The numbers are approximate — Pivot does not guarantee an exact row/column count. +Limits apply to large datasets. The numbers are approximate; Pivot does not guarantee an exact row/column count. ::: The following code snippet caps the dataset at 10 rows and 3 columns: @@ -337,19 +337,19 @@ const table = new pivot.Pivot("#root", { Pivot includes the following built-in aggregation methods: -- `sum` (numeric values only) — sums all selected values; ignores empty cells, logical values like `TRUE`, and text -- `min` (numeric and date values) — returns the minimum value; ignores empty cells, logical values, and text. Returns `0` if the input contains no numbers -- `max` (numeric and date values) — returns the maximum value; ignores empty cells, logical values, and text. Returns `0` if the input contains no numbers -- `count` (numeric, text, and date values) — counts non-blank cells; this is the default method assigned to every newly added field -- `countunique` (numeric and text values) — counts the number of unique values in the input -- `average` (numeric values only) — calculates the arithmetic mean of the input; ignores empty cells, logical values, and text. Includes cells with the value zero -- `counta` (numeric, text, and date values) — counts all non-blank values, including numbers, dates, and text -- `median` (numeric values only) — returns the median of the input -- `product` (numeric values only) — returns the product of all numbers in the input -- `stdev` (numeric values only) — standard deviation, treating the input as a sample of a larger set -- `stdevp` (numeric values only) — standard deviation, treating the input as the entire population -- `var` (numeric values only) — variance, treating the input as a sample of a larger set -- `varp` (numeric values only) — variance, treating the input as the entire population +- `sum` (numeric values only) - sums all selected values; ignores empty cells, logical values like `TRUE`, and text +- `min` (numeric and date values) - returns the minimum value; ignores empty cells, logical values, and text. Returns `0` if the input contains no numbers +- `max` (numeric and date values) - returns the maximum value; ignores empty cells, logical values, and text. Returns `0` if the input contains no numbers +- `count` (numeric, text, and date values) - counts non-blank cells; this is the default method assigned to every newly added field +- `countunique` (numeric and text values) - counts the number of unique values in the input +- `average` (numeric values only) - calculates the arithmetic mean of the input; ignores empty cells, logical values, and text. Includes cells with the value zero +- `counta` (numeric, text, and date values) - counts all non-blank values, including numbers, dates, and text +- `median` (numeric values only) - returns the median of the input +- `product` (numeric values only) - returns the product of all numbers in the input +- `stdev` (numeric values only) - standard deviation, treating the input as a sample of a larger set +- `stdevp` (numeric values only) - standard deviation, treating the input as the entire population +- `var` (numeric values only) - variance, treating the input as a sample of a larger set +- `varp` (numeric values only) - variance, treating the input as the entire population The following code snippet shows the built-in method definitions: @@ -572,12 +572,12 @@ const defaultPredicates = { To add a custom predicate, configure the [`predicates`](api/config/predicates-property.md) property. Each entry pairs a predicate ID (the key) with a configuration object: -- `type` — the field types this predicate accepts (`"number"`, `"date"`, `"text"`, or an array) -- `label` — the predicate label shown in the GUI drop-down for a row/column -- `handler` — function that transforms a value and returns the processed value -- `template` — optional function that controls how the processed value is displayed -- `field` — optional function that limits the predicate to specific fields -- `filter` — optional filter configuration when the filter type should differ from `type`, or when the data format should differ from `template` +- `type` - the field types this predicate accepts (`"number"`, `"date"`, `"text"`, or an array) +- `label` - the predicate label shown in the GUI drop-down for a row/column +- `handler` - function that transforms a value and returns the processed value +- `template` - optional function that controls how the processed value is displayed +- `field` - optional function that limits the predicate to specific fields +- `filter` - optional filter configuration when the filter type should differ from `type`, or when the data format should differ from `template` To use a custom predicate, set its ID as the `method` of the row or column where the predicate should apply. diff --git a/docs/how-to-start.md b/docs/how-to-start.md index a1e30cf..b963faa 100644 --- a/docs/how-to-start.md +++ b/docs/how-to-start.md @@ -6,7 +6,7 @@ description: You can explore how to start working with DHTMLX Pivot in the docum # How to start -This clear and comprehensive tutorial will guide your through the steps you need to take in order to get a full-functional Pivot on a page. +This tutorial walks you through the steps needed to get a fully functional Pivot on a page. ![DHTMLX Pivot interface showing the Configuration panel and data table](/img/pivot-main.png) diff --git a/docs/index.md b/docs/index.md index 3b105db..07e7edc 100644 --- a/docs/index.md +++ b/docs/index.md @@ -9,7 +9,7 @@ description: You can have an overview of DHTMLX JavaScript Pivot library in the JavaScript Pivot library is a ready-made component for creating Pivot tables from large datasets. The widget API can be easily adjusted to the needs of your web application. It provides the end user with functionality for comparing and analyzing complex data within one table. -## Pivot structure­ +## Pivot structure The Pivot UI consists of the two main components: the Configuration panel and the table with data. diff --git a/i18n/GLOSSARY.md b/i18n/GLOSSARY.md index acfeb7b..a78dc8a 100644 --- a/i18n/GLOSSARY.md +++ b/i18n/GLOSSARY.md @@ -105,3 +105,30 @@ Keep these terms in English across all locales (verified: identical counts in ru > Not in this list — these UI concepts **are** localized (keep English only for a literal UI label): > `Toolbar` (→ ru "панель инструментов"), `Menu` (→ "меню"), `Fill Handle` (→ "маркер заполнения"), > `context menu`. + +## 6. Punctuation + +**The em dash (`—`) is never a separator in documentation body text.** It is the single loudest +marker of machine-generated prose, and the English source does not use it. The house style for a +term/description list item is a plain hyphen, matching the API reference pages +(``- `width` - (optional) defines the column width``). + +| Pattern | en | ru | de | ko | zh | +|---|---|---|---|---|---| +| list item, term in backticks / link | `` `param` - description `` | `` `param` - описание `` | `` `param` - Beschreibung `` | `` `param` - 설명 `` | `` `param`:说明 `` | +| list item, plain-text lead | ``- text fields: `equal`, …`` | ``- текстовые поля: `equal`, …`` | ``- Textfelder: `equal`, …`` | ``- 텍스트 필드: `equal`, …`` | ``- 文本字段:`equal`, …`` | +| appositive inside a sentence | `a second API, the Table widget, for …` | `второму API, виджету Table, для …` | `eine zweite API, das Table-Widget, für …` | 문장을 나누거나 `:` 사용 | 用逗号或括号,勿用 `——` | + +Rules per locale: + +- **all** — do not copy an em dash from the source, and do not introduce one that the source does + not have. Recast an appositive as a comma pair, parentheses, a colon, or a separate sentence. +- **ru** — the copula dash **stays**: it is required Russian punctuation, not an English carry-over. + Keep it in `Значение по умолчанию — пустой массив`, `каждый ключ — это идентификатор поля`, + `Предикаты — это функции…`, ``а `nested` — **true**``, and before a generalizing word after a + list of homogeneous members (``` `export`, фильтрация по строкам — всё это работает через… ```). +- **zh** — use the full-width colon `:` as the list separator. `——` is valid Chinese punctuation, + but use it only where the English source has a deliberate dash of its own; never as a + translation of an appositive. +- **de** — the same applies to the en dash `–` (Gedankenstrich): it does not belong in headings + or `title:` / `description:` front matter that the English source writes without one. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/.sync b/i18n/de/docusaurus-plugin-content-docs/current/.sync index 4ed164f..7c568cc 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/.sync +++ b/i18n/de/docusaurus-plugin-content-docs/current/.sync @@ -1 +1 @@ -10518169aead802523be5a1c20e5730654345e9b +f7879008e5891430a2dbcdad5acd0cf246dc1ee5 diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md index 440ed9c..4a4dc83 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/configuration.md @@ -8,17 +8,17 @@ description: Sie können mehr über die Konfiguration in der Dokumentation der D Konfigurieren Sie die Pivot-Tabelle und das Konfigurationspanel über die folgende API: -- [`config`](api/config/config-property.md) — definiert die Struktur der Pivot-Tabelle und wie Daten aggregiert werden -- [`render-table`](api/events/render-table-event.md) — ändert die Tabellenkonfiguration zur Laufzeit -- [`tableShape`](api/config/tableshape-property.md) — konfiguriert das Erscheinungsbild der Pivot-Tabelle -- [`columnShape`](api/config/columnshape-property.md) — konfiguriert das Erscheinungsbild und Verhalten von Spalten -- [`headerShape`](api/config/headershape-property.md) — konfiguriert das Erscheinungsbild und Verhalten von Kopfzeilen -- [`configPanel`](api/config/configpanel-property.md) — steuert die Sichtbarkeit des Konfigurationspanels -- [`setLocale`](api/methods/setlocale-method.md) — wendet ein Locale an (siehe [Lokalisierung](guides/localization.md)) -- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) — lädt Daten und Feld-Metadaten -- [`predicates`](api/config/predicates-property.md) — verarbeitet Daten vor der Aggregation -- [`methods`](api/config/methods-property.md) — definiert benutzerdefinierte Aggregationsmethoden -- [`limits`](api/config/limits-property.md) — begrenzt die Anzahl der Zeilen und Spalten im finalen Datensatz +- [`config`](api/config/config-property.md) - definiert die Struktur der Pivot-Tabelle und wie Daten aggregiert werden +- [`render-table`](api/events/render-table-event.md) - ändert die Tabellenkonfiguration zur Laufzeit +- [`tableShape`](api/config/tableshape-property.md) - konfiguriert das Erscheinungsbild der Pivot-Tabelle +- [`columnShape`](api/config/columnshape-property.md) - konfiguriert das Erscheinungsbild und Verhalten von Spalten +- [`headerShape`](api/config/headershape-property.md) - konfiguriert das Erscheinungsbild und Verhalten von Kopfzeilen +- [`configPanel`](api/config/configpanel-property.md) - steuert die Sichtbarkeit des Konfigurationspanels +- [`setLocale`](api/methods/setlocale-method.md) - wendet ein Locale an (siehe [Lokalisierung](guides/localization.md)) +- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) - lädt Daten und Feld-Metadaten +- [`predicates`](api/config/predicates-property.md) - verarbeitet Daten vor der Aggregation +- [`methods`](api/config/methods-property.md) - definiert benutzerdefinierte Aggregationsmethoden +- [`limits`](api/config/limits-property.md) - begrenzt die Anzahl der Zeilen und Spalten im finalen Datensatz Anweisungen zur Arbeit mit Daten finden Sie unter [Mit Daten arbeiten](guides/working-with-data.md). @@ -81,14 +81,14 @@ Um die Breite bestimmter Spalten festzulegen, verwenden Sie den Parameter `width ## Spalten automatisch an den Inhalt anpassen {#autosize-columns-to-content} -Verwenden Sie den Parameter `autoWidth` der Eigenschaft [`columnShape`](api/config/columnshape-property.md), um Spaltenbreiten automatisch zu berechnen. Alle `autoWidth`-Unterparameter sind optional — vollständige Beschreibungen finden Sie in der Referenz zu [`columnShape`](api/config/columnshape-property.md). +Verwenden Sie den Parameter `autoWidth` der Eigenschaft [`columnShape`](api/config/columnshape-property.md), um Spaltenbreiten automatisch zu berechnen. Alle `autoWidth`-Unterparameter sind optional. Vollständige Beschreibungen finden Sie in der Referenz zu [`columnShape`](api/config/columnshape-property.md). Das `autoWidth`-Objekt akzeptiert die folgenden Parameter: -- `columns` — Objekt, das festlegt, welche Felder eine automatisch berechnete Breite erhalten -- `auto` — passt die Breite an die Kopfzeile, den Zelleninhalt oder beides an -- `maxRows` — Anzahl der analysierten Datenzeilen zur Ermittlung der Spaltengröße (Standard: 20) -- `firstOnly` — wenn `true` (Standard), wird jedes Feld nur einmal analysiert. Wenn mehrere Spalten auf demselben Feld basieren (z. B. `oil` mit `count` und `oil` mit `sum`), wird nur die erste Spalte analysiert und die anderen übernehmen deren Breite +- `columns` - Objekt, das festlegt, welche Felder eine automatisch berechnete Breite erhalten +- `auto` - passt die Breite an die Kopfzeile, den Zelleninhalt oder beides an +- `maxRows` - Anzahl der analysierten Datenzeilen zur Ermittlung der Spaltengröße (Standard: 20) +- `firstOnly` - wenn `true` (Standard), wird jedes Feld nur einmal analysiert. Wenn mehrere Spalten auf demselben Feld basieren (z. B. `oil` mit `count` und `oil` mit `sum`), wird nur die erste Spalte analysiert und die anderen übernehmen deren Breite Das folgende Code-Snippet aktiviert `autoWidth` für vier Felder und deaktiviert `firstOnly`, sodass jede Spalte eine eigene Messung erhält: @@ -460,7 +460,7 @@ widget.api.on("render-table", ({ config: tableConfig }) => { ## In Spalten sortieren {#sort-in-columns} -Die Sortierung in der Benutzeroberfläche ist standardmäßig aktiviert — Benutzer klicken auf eine Spaltenüberschrift, um zu sortieren. Um sie zu deaktivieren, setzen Sie den Parameter `sort` der Eigenschaft [`columnShape`](api/config/columnshape-property.md) auf `false`. +Die Sortierung in der Benutzeroberfläche ist standardmäßig aktiviert: Benutzer klicken auf eine Spaltenüberschrift, um zu sortieren. Um sie zu deaktivieren, setzen Sie den Parameter `sort` der Eigenschaft [`columnShape`](api/config/columnshape-property.md) auf `false`. Das folgende Code-Snippet deaktiviert die UI-Sortierung: @@ -727,10 +727,10 @@ Als alternative API verwenden Sie die Methode [`showConfigPanel`](api/methods/sh Das Konfigurationspanel unterstützt die folgenden Feldoperationen: -- [`add-field`](api/events/add-field-event.md) — ein Feld zu einem Bereich hinzufügen -- [`delete-field`](api/events/delete-field-event.md) — ein Feld aus einem Bereich entfernen -- [`update-field`](api/events/update-field-event.md) — die Methode oder Einstellungen eines Feldes aktualisieren -- [`move-field`](api/events/move-field-event.md) — Felder innerhalb eines Bereichs neu anordnen +- [`add-field`](api/events/add-field-event.md) - ein Feld zu einem Bereich hinzufügen +- [`delete-field`](api/events/delete-field-event.md) - ein Feld aus einem Bereich entfernen +- [`update-field`](api/events/update-field-event.md) - die Methode oder Einstellungen eines Feldes aktualisieren +- [`move-field`](api/events/move-field-event.md) - Felder innerhalb eines Bereichs neu anordnen **Verwandte Beispiele**: - [Pivot 2. Texttemplates für Tabellen- und Kopfzeilenzellen hinzufügen](https://snippet.dhtmlx.com/n9ylp6b2) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/initialization.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/initialization.md index 95a3e7f..46c84fc 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/initialization.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/initialization.md @@ -66,10 +66,10 @@ const table = new pivot.Pivot("#root", { Der Konstruktor gibt eine Pivot-Instanz zurück. Rufen Sie API-Methoden auf der zurückgegebenen Instanz auf: -- [`getTable`](api/methods/gettable-method.md) — Zugriff auf die zugrunde liegende Table-Widget-Instanz erhalten -- [`setConfig`](api/methods/setconfig-method.md) — die aktuelle Pivot-Konfiguration aktualisieren -- [`setLocale`](api/methods/setlocale-method.md) — eine neue Locale auf Pivot anwenden -- [`showConfigPanel`](api/methods/showconfigpanel-method.md) — das Konfigurationspanel ein- oder ausblenden +- [`getTable`](api/methods/gettable-method.md) - Zugriff auf die zugrunde liegende Table-Widget-Instanz erhalten +- [`setConfig`](api/methods/setconfig-method.md) - die aktuelle Pivot-Konfiguration aktualisieren +- [`setLocale`](api/methods/setlocale-method.md) - eine neue Locale auf Pivot anwenden +- [`showConfigPanel`](api/methods/showconfigpanel-method.md) - das Konfigurationspanel ein- oder ausblenden ## Konfigurationseigenschaften {#configuration-properties} diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md index 2e933bf..f63d1f5 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md @@ -25,7 +25,7 @@ ng new my-angular-pivot-app ~~~ :::note -Deaktivieren Sie Server-Side Rendering (SSR) und Static Site Generation (SSG/Prerendering), wenn die Angular CLI danach fragt — dieser Guide setzt eine client-seitig gerenderte App voraus. +Deaktivieren Sie Server-Side Rendering (SSR) und Static Site Generation (SSG/Prerendering), wenn die Angular CLI danach fragt. Dieser Guide setzt eine client-seitig gerenderte App voraus. ::: Der Befehl installiert alle erforderlichen Werkzeuge. Weitere Befehle sind nicht notwendig. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/loading-data.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/loading-data.md index 76201e6..e556603 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/loading-data.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/loading-data.md @@ -167,9 +167,9 @@ Pivot akzeptiert CSV-Daten, nachdem Sie diese mit einer externen JS-Parsing-Bibl Das folgende Beispiel verwendet die externe [PapaParse](https://cdnjs.cloudflare.com/ajax/libs/PapaParse/5.4.1/papaparse.min.js)-Bibliothek, um Daten bei einem Button-Klick zu laden und zu konvertieren. Der `convert()`-Helfer nimmt folgende Parameter entgegen: -- `data` — ein String mit CSV-Daten -- `headers` — ein Array mit CSV-Feldnamen -- `meta` — ein Objekt, das Feldnamen auf Datentypen abbildet +- `data` - ein String mit CSV-Daten +- `headers` - ein Array mit CSV-Feldnamen +- `meta` - ein Objekt, das Feldnamen auf Datentypen abbildet Das folgende Code-Snippet erstellt Pivot, definiert den `convert()`-Helfer und wendet die geparsten CSV-Daten über [`setConfig`](api/methods/setconfig-method.md) bei einem Button-Klick an: diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/stylization.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/stylization.md index 730b3b6..9375133 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/stylization.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/stylization.md @@ -112,7 +112,7 @@ Um Body- oder Footer-Zellen zu gestalten, verwenden Sie den Parameter `cellStyle Das folgende Beispiel wendet Styles auf Body- und Header-Zellen an: - Body-Zellen erhalten eine Klasse basierend auf Zellwerten (z. B. `"Down"`, `"Up"`, `"Idle"` im Feld `status`) und auf Gesamtwerten (größer als 40 oder kleiner als 5) -- Header-Zellen erhalten eine Klasse basierend auf dem Wert des Feldes `streaming` — `status-down` für `"no"` und `status-up` für jeden anderen Wert +- Header-Zellen erhalten eine Klasse basierend auf dem Wert des Feldes `streaming`: `status-down` für `"no"` und `status-up` für jeden anderen Wert ~~~jsx const widget = new pivot.Pivot("#pivot", { diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/typescript-support.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/typescript-support.md index 5bea14a..e1a716e 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/typescript-support.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/typescript-support.md @@ -6,7 +6,7 @@ description: Sie können in der Dokumentation erfahren, wie TypeScript mit der D # TypeScript-Unterstützung {#typescript-support} -DHTMLX Pivot wird ab v2.0 mit TypeScript-Definitionen geliefert. Die Definitionen sind sofort einsatzbereit – keine zusätzliche Konfiguration erforderlich. +DHTMLX Pivot wird ab v2.0 mit TypeScript-Definitionen geliefert. Die Definitionen sind sofort einsatzbereit, eine zusätzliche Konfiguration ist nicht erforderlich. :::info Testen Sie Pivot live im [Snippet-Tool](https://snippet.dhtmlx.com/y2buoahe). diff --git a/i18n/de/docusaurus-plugin-content-docs/current/guides/working-with-data.md b/i18n/de/docusaurus-plugin-content-docs/current/guides/working-with-data.md index 6d6ad18..e5e02f7 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/guides/working-with-data.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/guides/working-with-data.md @@ -10,7 +10,7 @@ Diese Seite beschreibt, wie Sie Daten in Pivot aggregieren, formatieren, sortier ## Felder definieren {#define-fields} -Verwenden Sie die Eigenschaft [`fields`](api/config/fields-property.md), um die Felder zu deklarieren, die Pivot in Zeilen, Spalten und Werten platzieren kann. Jedes Element im `fields`-Array beschreibt ein Feld — seine ID, sein Label und seinen Datentyp. +Verwenden Sie die Eigenschaft [`fields`](api/config/fields-property.md), um die Felder zu deklarieren, die Pivot in Zeilen, Spalten und Werten platzieren kann. Jedes Element im `fields`-Array beschreibt ein Feld: seine ID, sein Label und seinen Datentyp. Der folgende Code-Ausschnitt initialisiert Pivot mit fünf Feldern: @@ -127,7 +127,7 @@ Für das `xlsx`-Exportformat exportiert Pivot Datums- und Zahlenfelder als Rohwe ## Pivot-Struktur definieren {#define-pivot-structure} -Verwenden Sie die Eigenschaft [`config`](api/config/config-property.md), um zu deklarieren, welche Felder als Zeilen, Spalten und aggregierte Werte erscheinen und wie die Daten gefiltert werden. Die Eigenschaft `config` hat keine vordefinierten Werte — Sie müssen sie setzen, um Daten zu rendern. Die vollständige Parameterliste finden Sie in der Referenz zu [`config`](api/config/config-property.md). +Verwenden Sie die Eigenschaft [`config`](api/config/config-property.md), um zu deklarieren, welche Felder als Zeilen, Spalten und aggregierte Werte erscheinen und wie die Daten gefiltert werden. Die Eigenschaft `config` hat keine vordefinierten Werte, daher müssen Sie sie setzen, um Daten zu rendern. Die vollständige Parameterliste finden Sie in der Referenz zu [`config`](api/config/config-property.md). Der folgende Code-Ausschnitt platziert `continent` und `name` in Zeilen, `year` in Spalten, drei Aggregationen in Werten und einen Filter auf `name`: @@ -253,9 +253,9 @@ In der Benutzeroberfläche erscheinen Filter als Dropdown-Listen für jedes Feld Pivot unterstützt die folgenden Filterbedingungen je Datentyp: -- Textfelder — `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` -- Numerische Felder — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` -- Datumsfelder — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` +- Textfelder: `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` +- Numerische Felder: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` +- Datumsfelder: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` Die Regel `includes` schränkt einen Filter auf eine bestimmte Menge zulässiger Werte ein. @@ -263,7 +263,7 @@ Die Regel `includes` schränkt einen Filter auf eine bestimmte Menge zulässiger Um einen Filter zu deklarieren, fügen Sie das `filters`-Objekt zur Eigenschaft [`config`](api/config/config-property.md) hinzu, mit der Feld-ID als Schlüssel. Jeder Wert ist ein Objekt mit Filterbedingungen. -Der folgende Code-Ausschnitt wendet zwei Filter an — einen auf `genre` (Werte, die `"D"` enthalten, eingeschränkt auf `"Drama"`) und einen auf `title` (Werte, die `"A"` enthalten): +Der folgende Code-Ausschnitt wendet zwei Filter an: einen auf `genre` (Werte, die `"D"` enthalten, eingeschränkt auf `"Drama"`) und einen auf `title` (Werte, die `"A"` enthalten): ~~~jsx const table = new pivot.Pivot("#root", { @@ -304,7 +304,7 @@ Um Daten stattdessen über die Table-Widget-API zu filtern, greifen Sie mit der Um zu verhindern, dass die Komponente bei sehr großen Datensätzen hängt, begrenzen Sie die Anzahl der Zeilen und Spalten im finalen Datensatz mit der Eigenschaft [`limits`](api/config/limits-property.md). Pivot unterbricht das Rendering, sobald das Limit erreicht ist. Die Standardobergrenze liegt bei 10000 für Zeilen und 5000 für Spalten. :::note -Limits gelten für große Datensätze. Die Zahlen sind ungefähr — Pivot garantiert keine exakte Zeilen-/Spaltenanzahl. +Limits gelten für große Datensätze. Die Zahlen sind Näherungswerte. Pivot garantiert keine exakte Zeilen-/Spaltenanzahl. ::: Der folgende Code-Ausschnitt begrenzt den Datensatz auf 10 Zeilen und 3 Spalten: @@ -337,19 +337,19 @@ const table = new pivot.Pivot("#root", { Pivot enthält die folgenden integrierten Aggregationsmethoden: -- `sum` (nur numerische Werte) — summiert alle ausgewählten Werte; ignoriert leere Zellen, logische Werte wie `TRUE` und Text -- `min` (numerische Werte und Datumswerte) — gibt den Minimalwert zurück; ignoriert leere Zellen, logische Werte und Text. Gibt `0` zurück, wenn die Eingabe keine Zahlen enthält -- `max` (numerische Werte und Datumswerte) — gibt den Maximalwert zurück; ignoriert leere Zellen, logische Werte und Text. Gibt `0` zurück, wenn die Eingabe keine Zahlen enthält -- `count` (numerische, Text- und Datumswerte) — zählt nicht leere Zellen; dies ist die Standardmethode, die jedem neu hinzugefügten Feld zugewiesen wird -- `countunique` (numerische Werte und Textwerte) — zählt die Anzahl eindeutiger Werte in der Eingabe -- `average` (nur numerische Werte) — berechnet das arithmetische Mittel der Eingabe; ignoriert leere Zellen, logische Werte und Text. Berücksichtigt Zellen mit dem Wert null -- `counta` (numerische, Text- und Datumswerte) — zählt alle nicht leeren Werte, einschließlich Zahlen, Datumsangaben und Text -- `median` (nur numerische Werte) — gibt den Median der Eingabe zurück -- `product` (nur numerische Werte) — gibt das Produkt aller Zahlen in der Eingabe zurück -- `stdev` (nur numerische Werte) — Standardabweichung, wobei die Eingabe als Stichprobe einer größeren Menge behandelt wird -- `stdevp` (nur numerische Werte) — Standardabweichung, wobei die Eingabe als die gesamte Population behandelt wird -- `var` (nur numerische Werte) — Varianz, wobei die Eingabe als Stichprobe einer größeren Menge behandelt wird -- `varp` (nur numerische Werte) — Varianz, wobei die Eingabe als die gesamte Population behandelt wird +- `sum` (nur numerische Werte) - summiert alle ausgewählten Werte; ignoriert leere Zellen, logische Werte wie `TRUE` und Text +- `min` (numerische Werte und Datumswerte) - gibt den Minimalwert zurück; ignoriert leere Zellen, logische Werte und Text. Gibt `0` zurück, wenn die Eingabe keine Zahlen enthält +- `max` (numerische Werte und Datumswerte) - gibt den Maximalwert zurück; ignoriert leere Zellen, logische Werte und Text. Gibt `0` zurück, wenn die Eingabe keine Zahlen enthält +- `count` (numerische, Text- und Datumswerte) - zählt nicht leere Zellen; dies ist die Standardmethode, die jedem neu hinzugefügten Feld zugewiesen wird +- `countunique` (numerische Werte und Textwerte) - zählt die Anzahl eindeutiger Werte in der Eingabe +- `average` (nur numerische Werte) - berechnet das arithmetische Mittel der Eingabe; ignoriert leere Zellen, logische Werte und Text. Berücksichtigt Zellen mit dem Wert null +- `counta` (numerische, Text- und Datumswerte) - zählt alle nicht leeren Werte, einschließlich Zahlen, Datumsangaben und Text +- `median` (nur numerische Werte) - gibt den Median der Eingabe zurück +- `product` (nur numerische Werte) - gibt das Produkt aller Zahlen in der Eingabe zurück +- `stdev` (nur numerische Werte) - Standardabweichung, wobei die Eingabe als Stichprobe einer größeren Menge behandelt wird +- `stdevp` (nur numerische Werte) - Standardabweichung, wobei die Eingabe als die gesamte Population behandelt wird +- `var` (nur numerische Werte) - Varianz, wobei die Eingabe als Stichprobe einer größeren Menge behandelt wird +- `varp` (nur numerische Werte) - Varianz, wobei die Eingabe als die gesamte Population behandelt wird Der folgende Code-Ausschnitt zeigt die integrierten Methodendefinitionen: @@ -556,7 +556,7 @@ const table = new pivot.Pivot("#root", { Prädikate sind Vorverarbeitungsfunktionen, die Rohfelddaten transformieren, bevor Pivot die Daten in Zeilen oder Spalten verwendet. Ein Prädikat kann beispielsweise Datumsangaben vor der Aggregation nach Monat gruppieren. -Der folgende Code-Ausschnitt zeigt die integrierten Datumspr­ädikate, die Pivot standardmäßig anwendet: +Der folgende Code-Ausschnitt zeigt die integrierten Datumsprädikate, die Pivot standardmäßig anwendet: ~~~jsx const defaultPredicates = { @@ -572,12 +572,12 @@ const defaultPredicates = { Um ein benutzerdefiniertes Prädikat hinzuzufügen, konfigurieren Sie die Eigenschaft [`predicates`](api/config/predicates-property.md). Jeder Eintrag verknüpft eine Prädikat-ID (den Schlüssel) mit einem Konfigurationsobjekt: -- `type` — die Feldtypen, die dieses Prädikat akzeptiert (`"number"`, `"date"`, `"text"` oder ein Array) -- `label` — das Prädikat-Label, das im GUI-Dropdown für eine Zeile/Spalte angezeigt wird -- `handler` — Funktion, die einen Wert transformiert und den verarbeiteten Wert zurückgibt -- `template` — optionale Funktion, die steuert, wie der verarbeitete Wert angezeigt wird -- `field` — optionale Funktion, die das Prädikat auf bestimmte Felder beschränkt -- `filter` — optionale Filter-Konfiguration, wenn der Filtertyp vom `type` abweichen soll oder wenn das Datenformat vom `template` abweichen soll +- `type` - die Feldtypen, die dieses Prädikat akzeptiert (`"number"`, `"date"`, `"text"` oder ein Array) +- `label` - das Prädikat-Label, das im GUI-Dropdown für eine Zeile/Spalte angezeigt wird +- `handler` - Funktion, die einen Wert transformiert und den verarbeiteten Wert zurückgibt +- `template` - optionale Funktion, die steuert, wie der verarbeitete Wert angezeigt wird +- `field` - optionale Funktion, die das Prädikat auf bestimmte Felder beschränkt +- `filter` - optionale Filter-Konfiguration, wenn der Filtertyp vom `type` abweichen soll oder wenn das Datenformat vom `template` abweichen soll Um ein benutzerdefiniertes Prädikat zu verwenden, setzen Sie seine ID als `method` der Zeile oder Spalte, auf die das Prädikat angewendet werden soll. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/how-to-start.md b/i18n/de/docusaurus-plugin-content-docs/current/how-to-start.md index 77b15e1..601e460 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/how-to-start.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/how-to-start.md @@ -1,7 +1,7 @@ --- sidebar_label: Erste Schritte title: Erste Schritte -description: Erfahren Sie, wie Sie mit DHTMLX Pivot arbeiten – in der Dokumentation der DHTMLX JavaScript Pivot-Bibliothek. Durchsuchen Sie Entwicklerleitfäden und API-Referenzen, probieren Sie Codebeispiele und Live-Demos aus und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Pivot herunter. +description: Erfahren Sie in der Dokumentation der DHTMLX JavaScript Pivot-Bibliothek, wie Sie mit DHTMLX Pivot arbeiten. Durchsuchen Sie Entwicklerleitfäden und API-Referenzen, probieren Sie Codebeispiele und Live-Demos aus und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Pivot herunter. --- # Erste Schritte {#how-to-start} diff --git a/i18n/de/docusaurus-plugin-content-docs/current/index.md b/i18n/de/docusaurus-plugin-content-docs/current/index.md index 5e917e1..2c5ef50 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/index.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/index.md @@ -1,11 +1,11 @@ --- sidebar_label: Pivot-Übersicht -title: JavaScript Pivot – Übersicht +title: Übersicht über JavaScript Pivot slug: / description: In dieser Dokumentation erhalten Sie einen Überblick über die DHTMLX JavaScript Pivot-Bibliothek. Durchsuchen Sie Entwicklerhandbücher und die API-Referenz, probieren Sie Code-Beispiele und Live-Demos aus und laden Sie eine kostenlose 30-Tage-Evaluierungsversion von DHTMLX Pivot herunter. --- -# DHTMLX Pivot – Übersicht {#dhtmlx-pivot-overview} +# Übersicht über DHTMLX Pivot {#dhtmlx-pivot-overview} Die JavaScript Pivot-Bibliothek ist eine fertige Komponente zur Erstellung von Pivot-Tabellen aus großen Datensätzen. Die Widget-API lässt sich problemlos an die Anforderungen Ihrer Webanwendung anpassen. Sie bietet dem Endbenutzer Funktionen zum Vergleichen und Analysieren komplexer Daten innerhalb einer einzigen Tabelle. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/news/whats-new.md b/i18n/de/docusaurus-plugin-content-docs/current/news/whats-new.md index 2a7ce40..0b0f73b 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/news/whats-new.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/news/whats-new.md @@ -108,7 +108,7 @@ Tipps zur Migration auf die neue Version finden Sie auf der Seite [Migration](ne - Weitere Funktionen zum Aggregieren von Daten wurden hinzugefügt: - [Begrenzen geladener Daten](guides/working-with-data.md#limiting-loaded-data) - Mehr [Operationen mit Daten](guides/working-with-data.md#applying-maths-methods) sind verfügbar - - [Daten mit Predicates verarbeiten](guides/working-with-data.md#processing-data-with-predicates) – Anwenden benutzerdefinierter Vorverarbeitungsfunktionen für Daten + - [Daten mit Predicates verarbeiten](guides/working-with-data.md#processing-data-with-predicates) - Anwenden benutzerdefinierter Vorverarbeitungsfunktionen für Daten - [Datumsformat über Gebietsschema festlegen](guides/localization.md#date-formatting) - Neue Methoden wurden hinzugefügt: [`getTable()`](api/methods/gettable-method.md), [`setConfig()`](api/methods/setconfig-method.md), [`setLocale()`](api/methods/setlocale-method.md), [`showConfigPanel()`](api/methods/showconfigpanel-method.md) - Neue Events wurden hinzugefügt: [`add-field`](api/events/add-field-event.md), [`delete-field`](api/events/delete-field-event.md), [`open-filter`](api/events/open-filter-event.md), [`render-table`](api/events/render-table-event.md), [`move-field`](api/events/move-field-event.md), [`show-config-panel`](api/events/show-config-panel-event.md), [`show-config-panel`](api/events/show-config-panel-event.md), [`update-config`](api/events/update-config-event.md), [`update-field`](api/events/update-field-event.md). diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/.sync b/i18n/ko/docusaurus-plugin-content-docs/current/.sync index 4ed164f..7c568cc 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/.sync +++ b/i18n/ko/docusaurus-plugin-content-docs/current/.sync @@ -1 +1 @@ -10518169aead802523be5a1c20e5730654345e9b +f7879008e5891430a2dbcdad5acd0cf246dc1ee5 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/guides/configuration.md b/i18n/ko/docusaurus-plugin-content-docs/current/guides/configuration.md index 0cda1e6..1e25ca8 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/guides/configuration.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/guides/configuration.md @@ -8,17 +8,17 @@ description: DHTMLX JavaScript Pivot 라이브러리 문서에서 구성에 대 다음 API를 통해 Pivot 테이블과 구성 패널을 설정합니다: -- [`config`](api/config/config-property.md) — Pivot 테이블의 구조와 데이터 집계 방식을 정의합니다 -- [`render-table`](api/events/render-table-event.md) — 테이블 구성을 런타임에 변경합니다 -- [`tableShape`](api/config/tableshape-property.md) — Pivot 테이블의 외관을 설정합니다 -- [`columnShape`](api/config/columnshape-property.md) — 열의 외관과 동작을 설정합니다 -- [`headerShape`](api/config/headershape-property.md) — 헤더의 외관과 동작을 설정합니다 -- [`configPanel`](api/config/configpanel-property.md) — 구성 패널의 표시 여부를 제어합니다 -- [`setLocale`](api/methods/setlocale-method.md) — 로케일을 적용합니다([지역화](guides/localization.md) 참조) -- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) — 데이터와 필드 메타데이터를 불러옵니다 -- [`predicates`](api/config/predicates-property.md) — 집계 전에 데이터를 전처리합니다 -- [`methods`](api/config/methods-property.md) — 사용자 정의 집계 메서드를 정의합니다 -- [`limits`](api/config/limits-property.md) — 최종 데이터셋의 행과 열 수를 제한합니다 +- [`config`](api/config/config-property.md) - Pivot 테이블의 구조와 데이터 집계 방식을 정의합니다 +- [`render-table`](api/events/render-table-event.md) - 테이블 구성을 런타임에 변경합니다 +- [`tableShape`](api/config/tableshape-property.md) - Pivot 테이블의 외관을 설정합니다 +- [`columnShape`](api/config/columnshape-property.md) - 열의 외관과 동작을 설정합니다 +- [`headerShape`](api/config/headershape-property.md) - 헤더의 외관과 동작을 설정합니다 +- [`configPanel`](api/config/configpanel-property.md) - 구성 패널의 표시 여부를 제어합니다 +- [`setLocale`](api/methods/setlocale-method.md) - 로케일을 적용합니다([지역화](guides/localization.md) 참조) +- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) - 데이터와 필드 메타데이터를 불러옵니다 +- [`predicates`](api/config/predicates-property.md) - 집계 전에 데이터를 전처리합니다 +- [`methods`](api/config/methods-property.md) - 사용자 정의 집계 메서드를 정의합니다 +- [`limits`](api/config/limits-property.md) - 최종 데이터셋의 행과 열 수를 제한합니다 데이터 작업에 대한 자세한 내용은 [데이터 작업](guides/working-with-data.md)을 참조하세요. @@ -85,10 +85,10 @@ const table = new pivot.Pivot("#root", { `autoWidth` 객체는 다음 매개변수를 받습니다: -- `columns` — 자동 계산 너비를 적용할 필드를 선택하는 객체 -- `auto` — 너비를 헤더, 셀 콘텐츠, 또는 둘 다에 맞춥니다 -- `maxRows` — 열 크기를 감지하기 위해 분석할 데이터 행 수(기본값: 20) -- `firstOnly` — `true`(기본값)이면 각 필드를 한 번만 분석합니다. 동일한 필드 기반의 여러 열(예: `count`와 `sum`을 사용하는 `oil`)이 있을 경우, 첫 번째 열만 분석하고 나머지 열은 해당 너비를 상속합니다 +- `columns` - 자동 계산 너비를 적용할 필드를 선택하는 객체 +- `auto` - 너비를 헤더, 셀 콘텐츠, 또는 둘 다에 맞춥니다 +- `maxRows` - 열 크기를 감지하기 위해 분석할 데이터 행 수(기본값: 20) +- `firstOnly` - `true`(기본값)이면 각 필드를 한 번만 분석합니다. 동일한 필드 기반의 여러 열(예: `count`와 `sum`을 사용하는 `oil`)이 있을 경우, 첫 번째 열만 분석하고 나머지 열은 해당 너비를 상속합니다 다음 코드 스니펫은 네 개의 필드에 `autoWidth`를 활성화하고, `firstOnly`를 비활성화하여 각 열이 개별적으로 측정되도록 합니다: @@ -727,10 +727,10 @@ table.api.intercept("show-config-panel", () => { 구성 패널은 다음 필드 작업을 지원합니다: -- [`add-field`](api/events/add-field-event.md) — 영역에 필드를 추가합니다 -- [`delete-field`](api/events/delete-field-event.md) — 영역에서 필드를 제거합니다 -- [`update-field`](api/events/update-field-event.md) — 필드의 메서드 또는 설정을 업데이트합니다 -- [`move-field`](api/events/move-field-event.md) — 영역 내 필드의 순서를 변경합니다 +- [`add-field`](api/events/add-field-event.md) - 영역에 필드를 추가합니다 +- [`delete-field`](api/events/delete-field-event.md) - 영역에서 필드를 제거합니다 +- [`update-field`](api/events/update-field-event.md) - 필드의 메서드 또는 설정을 업데이트합니다 +- [`move-field`](api/events/move-field-event.md) - 영역 내 필드의 순서를 변경합니다 **관련 예제**: - [Pivot 2. 테이블 및 헤더 셀에 텍스트 템플릿 추가](https://snippet.dhtmlx.com/n9ylp6b2) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/guides/initialization.md b/i18n/ko/docusaurus-plugin-content-docs/current/guides/initialization.md index e1109a1..140c723 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/guides/initialization.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/guides/initialization.md @@ -66,10 +66,10 @@ const table = new pivot.Pivot("#root", { 생성자는 Pivot 인스턴스를 반환합니다. 반환된 인스턴스에서 API 메서드를 호출하세요: -- [`getTable`](api/methods/gettable-method.md) — 기반 Table 위젯 인스턴스에 접근합니다 -- [`setConfig`](api/methods/setconfig-method.md) — 현재 Pivot 구성을 업데이트합니다 -- [`setLocale`](api/methods/setlocale-method.md) — Pivot에 새 로케일을 적용합니다 -- [`showConfigPanel`](api/methods/showconfigpanel-method.md) — 구성 패널을 표시하거나 숨깁니다 +- [`getTable`](api/methods/gettable-method.md) - 기반 Table 위젯 인스턴스에 접근합니다 +- [`setConfig`](api/methods/setconfig-method.md) - 현재 Pivot 구성을 업데이트합니다 +- [`setLocale`](api/methods/setlocale-method.md) - Pivot에 새 로케일을 적용합니다 +- [`showConfigPanel`](api/methods/showconfigpanel-method.md) - 구성 패널을 표시하거나 숨깁니다 ## 구성 속성 {#configuration-properties} diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md b/i18n/ko/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md index e4f76fb..8efed30 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md @@ -25,7 +25,7 @@ ng new my-angular-pivot-app ~~~ :::note -Angular CLI의 안내에 따라 서버 사이드 렌더링(SSR)과 정적 사이트 생성(SSG/Prerendering)을 비활성화하세요 — 이 가이드는 클라이언트 렌더링 앱을 기준으로 합니다. +Angular CLI의 안내에 따라 서버 사이드 렌더링(SSR)과 정적 사이트 생성(SSG/Prerendering)을 비활성화하세요. 이 가이드는 클라이언트 렌더링 앱을 기준으로 합니다. ::: 명령어를 실행하면 필요한 모든 도구가 설치됩니다. 추가 명령어는 필요하지 않습니다. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/guides/loading-data.md b/i18n/ko/docusaurus-plugin-content-docs/current/guides/loading-data.md index 57992d3..57673f0 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/guides/loading-data.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/guides/loading-data.md @@ -167,9 +167,9 @@ Pivot은 외부 JS 파싱 라이브러리로 CSV 데이터를 JSON으로 변환 아래 예제는 외부 [PapaParse](https://cdnjs.cloudflare.com/ajax/libs/PapaParse/5.4.1/papaparse.min.js) 라이브러리를 사용하여 버튼 클릭 시 데이터를 로드하고 변환합니다. `convert()` 헬퍼는 다음 매개변수를 받습니다: -- `data` — CSV 데이터 문자열 -- `headers` — CSV 필드 이름 배열 -- `meta` — 필드 이름을 데이터 타입에 매핑하는 객체 +- `data` - CSV 데이터 문자열 +- `headers` - CSV 필드 이름 배열 +- `meta` - 필드 이름을 데이터 타입에 매핑하는 객체 다음 코드 스니펫은 Pivot을 생성하고, `convert()` 헬퍼를 정의하며, 버튼 클릭 시 [`setConfig`](api/methods/setconfig-method.md)를 통해 파싱된 CSV 데이터를 적용합니다: diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/guides/stylization.md b/i18n/ko/docusaurus-plugin-content-docs/current/guides/stylization.md index 5c3cbe6..84b1258 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/guides/stylization.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/guides/stylization.md @@ -112,7 +112,7 @@ Pivot은 하나의 내장 테마인 **Material**을 제공합니다. 위젯 컨 아래 예제는 본문 셀과 헤더 셀에 스타일을 적용합니다: - 본문 셀은 셀 값(예: `status` 필드의 `"Down"`, `"Up"`, `"Idle"`)과 합계 값(40보다 크거나 5보다 작은 경우)에 따라 클래스를 받습니다. -- 헤더 셀은 `streaming` 필드의 값에 따라 클래스를 받습니다 — `"no"`이면 `status-down`, 다른 값이면 `status-up` +- 헤더 셀은 `streaming` 필드의 값에 따라 클래스를 받습니다: `"no"`이면 `status-down`, 다른 값이면 `status-up` ~~~jsx const widget = new pivot.Pivot("#pivot", { diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-data.md b/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-data.md index 6b47ac9..aab8076 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-data.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-data.md @@ -253,9 +253,9 @@ UI에서 필터는 각 필드의 드롭다운 목록으로 표시됩니다. Pivot은 데이터 타입별로 다음과 같은 필터 조건을 지원합니다: -- 텍스트 필드 — `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` -- 숫자 필드 — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` -- 날짜 필드 — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` +- 텍스트 필드: `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` +- 숫자 필드: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` +- 날짜 필드: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` `includes` 규칙은 필터를 특정 허용 값 집합으로 제한합니다. @@ -263,7 +263,7 @@ Pivot은 데이터 타입별로 다음과 같은 필터 조건을 지원합니 필터를 선언하려면 [`config`](api/config/config-property.md) 속성에 `filters` 객체를 추가하고 필드 ID를 키로 사용합니다. 각 값은 필터 조건 객체입니다. -다음 코드 예제는 두 개의 필터를 적용합니다 — `genre`에 하나(`"D"`를 포함하는 값, `"Drama"`로 제한)와 `title`에 하나(`"A"`를 포함하는 값): +다음 코드 예제는 두 개의 필터를 적용합니다: `genre`에 하나(`"D"`를 포함하는 값, `"Drama"`로 제한)와 `title`에 하나(`"A"`를 포함하는 값): ~~~jsx const table = new pivot.Pivot("#root", { @@ -337,19 +337,19 @@ const table = new pivot.Pivot("#root", { Pivot에는 다음과 같은 기본 집계 메서드가 포함되어 있습니다: -- `sum` (숫자 값만) — 선택된 모든 값을 합산하며, 빈 셀, `TRUE`와 같은 논리 값, 텍스트는 무시합니다 -- `min` (숫자 및 날짜 값) — 최솟값을 반환하며, 빈 셀, 논리 값, 텍스트는 무시합니다. 입력에 숫자가 없으면 `0`을 반환합니다 -- `max` (숫자 및 날짜 값) — 최댓값을 반환하며, 빈 셀, 논리 값, 텍스트는 무시합니다. 입력에 숫자가 없으면 `0`을 반환합니다 -- `count` (숫자, 텍스트, 날짜 값) — 비어 있지 않은 셀을 계산하며, 새로 추가된 모든 필드에 기본으로 할당되는 메서드입니다 -- `countunique` (숫자 및 텍스트 값) — 입력에서 고유한 값의 수를 계산합니다 -- `average` (숫자 값만) — 입력의 산술 평균을 계산하며, 빈 셀, 논리 값, 텍스트는 무시합니다. 값이 0인 셀은 포함합니다 -- `counta` (숫자, 텍스트, 날짜 값) — 숫자, 날짜, 텍스트를 포함한 모든 비어 있지 않은 값을 계산합니다 -- `median` (숫자 값만) — 입력의 중앙값을 반환합니다 -- `product` (숫자 값만) — 입력의 모든 숫자의 곱을 반환합니다 -- `stdev` (숫자 값만) — 표준 편차이며, 입력을 더 큰 집합의 표본으로 처리합니다 -- `stdevp` (숫자 값만) — 표준 편차이며, 입력을 전체 모집단으로 처리합니다 -- `var` (숫자 값만) — 분산이며, 입력을 더 큰 집합의 표본으로 처리합니다 -- `varp` (숫자 값만) — 분산이며, 입력을 전체 모집단으로 처리합니다 +- `sum` (숫자 값만) - 선택된 모든 값을 합산하며, 빈 셀, `TRUE`와 같은 논리 값, 텍스트는 무시합니다 +- `min` (숫자 및 날짜 값) - 최솟값을 반환하며, 빈 셀, 논리 값, 텍스트는 무시합니다. 입력에 숫자가 없으면 `0`을 반환합니다 +- `max` (숫자 및 날짜 값) - 최댓값을 반환하며, 빈 셀, 논리 값, 텍스트는 무시합니다. 입력에 숫자가 없으면 `0`을 반환합니다 +- `count` (숫자, 텍스트, 날짜 값) - 비어 있지 않은 셀을 계산하며, 새로 추가된 모든 필드에 기본으로 할당되는 메서드입니다 +- `countunique` (숫자 및 텍스트 값) - 입력에서 고유한 값의 수를 계산합니다 +- `average` (숫자 값만) - 입력의 산술 평균을 계산하며, 빈 셀, 논리 값, 텍스트는 무시합니다. 값이 0인 셀은 포함합니다 +- `counta` (숫자, 텍스트, 날짜 값) - 숫자, 날짜, 텍스트를 포함한 모든 비어 있지 않은 값을 계산합니다 +- `median` (숫자 값만) - 입력의 중앙값을 반환합니다 +- `product` (숫자 값만) - 입력의 모든 숫자의 곱을 반환합니다 +- `stdev` (숫자 값만) - 표준 편차이며, 입력을 더 큰 집합의 표본으로 처리합니다 +- `stdevp` (숫자 값만) - 표준 편차이며, 입력을 전체 모집단으로 처리합니다 +- `var` (숫자 값만) - 분산이며, 입력을 더 큰 집합의 표본으로 처리합니다 +- `varp` (숫자 값만) - 분산이며, 입력을 전체 모집단으로 처리합니다 다음 코드 예제는 내장 메서드 정의를 보여줍니다: @@ -572,12 +572,12 @@ const defaultPredicates = { 커스텀 프레디케이트를 추가하려면 [`predicates`](api/config/predicates-property.md) 속성을 구성합니다. 각 항목은 프레디케이트 ID(키)와 구성 객체를 쌍으로 구성합니다: -- `type` — 이 프레디케이트가 받는 필드 타입 (`"number"`, `"date"`, `"text"` 또는 배열) -- `label` — 행/열의 GUI 드롭다운에 표시되는 프레디케이트 레이블 -- `handler` — 값을 변환하고 처리된 값을 반환하는 함수 -- `template` — 처리된 값의 표시 방식을 제어하는 선택적 함수 -- `field` — 프레디케이트를 특정 필드로 제한하는 선택적 함수 -- `filter` — 필터 타입이 `type`과 달라야 하거나, 데이터 포맷이 `template`과 달라야 할 때 사용하는 선택적 필터 구성 +- `type` - 이 프레디케이트가 받는 필드 타입 (`"number"`, `"date"`, `"text"` 또는 배열) +- `label` - 행/열의 GUI 드롭다운에 표시되는 프레디케이트 레이블 +- `handler` - 값을 변환하고 처리된 값을 반환하는 함수 +- `template` - 처리된 값의 표시 방식을 제어하는 선택적 함수 +- `field` - 프레디케이트를 특정 필드로 제한하는 선택적 함수 +- `filter` - 필터 타입이 `type`과 달라야 하거나, 데이터 포맷이 `template`과 달라야 할 때 사용하는 선택적 필터 구성 커스텀 프레디케이트를 사용하려면 해당 ID를 프레디케이트가 적용될 행 또는 열의 `method`로 설정합니다. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-server.md b/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-server.md index c65cbcd..ea03b17 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-server.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/guides/working-with-server.md @@ -8,9 +8,9 @@ Pivot은 전적으로 브라우저에서 실행됩니다. 위젯은 원시 행 일반적인 통합은 세 부분으로 구성됩니다. -1. **데이터 로드** — 초기화 시 서버에서 집계되지 않은 원시 데이터를 불러옵니다 -2. **config 저장** — 사용자가 레이아웃을 변경할 때 저장하여 세션을 나중에 재개할 수 있도록 합니다 -3. **집계된 테이블 저장** — 서버에서 집계 결과의 스냅샷이 필요할 때 저장합니다 +1. **데이터 로드**: 초기화 시 서버에서 집계되지 않은 원시 데이터를 불러옵니다 +2. **config 저장**: 사용자가 레이아웃을 변경할 때 저장하여 세션을 나중에 재개할 수 있도록 합니다 +3. **집계된 테이블 저장**: 서버에서 집계 결과의 스냅샷이 필요할 때 저장합니다 ## 서버에서 원시 데이터 로드하기 {#load-raw-data-from-the-server} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/.sync b/i18n/ru/docusaurus-plugin-content-docs/current/.sync index 4ed164f..7c568cc 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/.sync +++ b/i18n/ru/docusaurus-plugin-content-docs/current/.sync @@ -1 +1 @@ -10518169aead802523be5a1c20e5730654345e9b +f7879008e5891430a2dbcdad5acd0cf246dc1ee5 diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/configpanel-property.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/configpanel-property.md index b04aab5..47ebb43 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/configpanel-property.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/configpanel-property.md @@ -22,8 +22,8 @@ configPanel?: boolean; Свойство может принимать значение **true** или **false**: -- `true` — по умолчанию, показывает панель конфигурации -- `false` — скрывает панель конфигурации +- `true` - по умолчанию, показывает панель конфигурации +- `false` - скрывает панель конфигурации ## Пример {#example} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/predicates-property.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/predicates-property.md index a64f817..24e9702 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/predicates-property.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/predicates-property.md @@ -40,7 +40,7 @@ predicates?: { - `filter` - (необязательный) по умолчанию тип фильтра берётся из параметра `type`, но если требуется другой, можно использовать этот объект `filter`. Он имеет следующие параметры: - `type` - (необязательный) определяет, какой тип поля будет применён: "number"|"text"|"date"|"tuple". "tuple" — это комбинированный фильтр для числовых значений (данные фильтруются по числовому значению, но в фильтре отображается текстовое значение) - `format` - (необязательный) функция, определяющая формат отображения вариантов фильтрации; если формат не задан, применяется формат из параметра `template`; если `type` (для объекта `filter`) не указан, формат будет применён для типа, заданного в параметре `type` предиката -- `handler` - (обязательный для пользовательских предикатов) функция, определяющая порядок обработки данных; функция принимает единственный аргумент — обрабатываемое значение — и возвращает обработанное значение +- `handler` - (обязательный для пользовательских предикатов) функция, определяющая порядок обработки данных; функция принимает единственный аргумент (обрабатываемое значение) и возвращает обработанное значение - `template` - (необязательный) функция, определяющая способ отображения данных; функция возвращает обработанное значение, принимает значение, возвращённое `handler`, и при необходимости позволяет локализовать текстовые значения с помощью [`locale`](api/config/locale-property.md) Следующие предикаты применяются по умолчанию, если через свойство `predicates` не задан ни один предикат: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/readonly-property.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/readonly-property.md index a3bd0e8..c69d512 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/api/config/readonly-property.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/config/readonly-property.md @@ -22,8 +22,8 @@ description: В документации библиотеки DHTMLX JavaScript Свойство может принимать значения **true** или **false**: -- `true` — включает режим только для чтения -- `false` — значение по умолчанию, отключает режим только для чтения +- `true` - включает режим только для чтения +- `false` - значение по умолчанию, отключает режим только для чтения ## Пример {#example} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/events/add-field-event.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/events/add-field-event.md index d705908..9f5b8cd 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/api/events/add-field-event.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/events/add-field-event.md @@ -29,7 +29,7 @@ description: Вы можете узнать о событии add-field в до - `area` - (обязательный) название области, в которую добавляется новое поле: "rows", "columns" или "values" - `field` - (обязательный) название поля - `method` - (необязательный) определяет метод агрегации данных (если не указан, устанавливается первый метод, подходящий для данного типа данных); метод может быть одним из следующих: - - для области **values** является обязательным — это строка с одним из типов операций над данными: [Методы по умолчанию](guides/working-with-data.md#default-methods) + - для области **values** является обязательным; это строка с одним из типов операций над данными: [Методы по умолчанию](guides/working-with-data.md#default-methods) - для областей **rows** и **columns** является необязательным; если значение задано, это предикат — пользовательский или один из встроенных: "year", "quarter", "month", "week", "day", "hour", "minute". По умолчанию используется исходное значение. Если задан пользовательский предикат или метод, необходимо указать id для свойства [predicates](api/config/predicates-property.md) или [methods](api/config/methods-property.md). diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/events/update-config-event.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/events/update-config-event.md index e1c4b47..b7c76ef 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/api/events/update-config-event.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/events/update-config-event.md @@ -10,7 +10,7 @@ description: Вы можете узнать о событии update-config в @short: Срабатывает при изменении строк, столбцов или функций агрегации через интерфейс Pivot -Это действие удобно для сохранения пользовательской конфигурации агрегации, чтобы её можно было применить при следующем использовании виджета — позволяя пользователю продолжить с того места, где он остановился. +Это действие удобно для сохранения пользовательской конфигурации агрегации, чтобы её можно было применить при следующем использовании виджета, позволяя пользователю продолжить с того места, где он остановился. ### Использование {#usage} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/helpers/template.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/helpers/template.md index e6afb42..089acb3 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/api/helpers/template.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/helpers/template.md @@ -71,7 +71,7 @@ pivot.template({value, field, method, cell, column}) => string; ### Пример {#example} -Фрагмент ниже показывает, как определять шаблоны с помощью хелпера `pivot.template`. Хелпер применяется непосредственно перед отрисовкой таблицы — путём перехвата события [render-table](api/events/render-table-event.md) с помощью метода [api.intercept()](api/internal/intercept-method.md). +Фрагмент ниже показывает, как определять шаблоны с помощью хелпера `pivot.template`. Хелпер применяется непосредственно перед отрисовкой таблицы, путём перехвата события [render-table](api/events/render-table-event.md) с помощью метода [api.intercept()](api/internal/intercept-method.md). Фрагмент демонстрирует, как добавлять иконки к: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/api/methods/gettable-method.md b/i18n/ru/docusaurus-plugin-content-docs/current/api/methods/gettable-method.md index 4bc78cf..37f656b 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/api/methods/gettable-method.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/api/methods/gettable-method.md @@ -20,7 +20,7 @@ getTable(wait:boolean): Table | Promise; ### Параметры {#parameters} -`wait` — определяет, нужно ли ожидать, пока API Table станет доступным в Pivot (необходимо, когда API Table используется в процессе инициализации Pivot). Если значение установлено в **true**, метод возвращает промис с API Table. +`wait` - определяет, нужно ли ожидать, пока API Table станет доступным в Pivot (необходимо, когда API Table используется в процессе инициализации Pivot). Если значение установлено в **true**, метод возвращает промис с API Table. ### Пример {#example} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md index 8106fc9..a07be33 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/configuration.md @@ -8,17 +8,17 @@ description: Вы можете узнать о конфигурации в до Настройте таблицу Pivot и панель конфигурации с помощью следующего API: -- [`config`](api/config/config-property.md) — определяет структуру таблицы Pivot и способ агрегации данных -- [`render-table`](api/events/render-table-event.md) — изменяет конфигурацию таблицы на лету -- [`tableShape`](api/config/tableshape-property.md) — настраивает внешний вид таблицы Pivot -- [`columnShape`](api/config/columnshape-property.md) — настраивает внешний вид и поведение столбцов -- [`headerShape`](api/config/headershape-property.md) — настраивает внешний вид и поведение заголовков -- [`configPanel`](api/config/configpanel-property.md) — управляет видимостью панели конфигурации -- [`setLocale`](api/methods/setlocale-method.md) — применяет локаль (см. [Локализация](guides/localization.md)) -- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) — загружают данные и метаданные полей -- [`predicates`](api/config/predicates-property.md) — предварительно обрабатывают данные перед агрегацией -- [`methods`](api/config/methods-property.md) — определяют пользовательские методы агрегации -- [`limits`](api/config/limits-property.md) — ограничивают количество строк и столбцов в итоговом наборе данных +- [`config`](api/config/config-property.md) - определяет структуру таблицы Pivot и способ агрегации данных +- [`render-table`](api/events/render-table-event.md) - изменяет конфигурацию таблицы на лету +- [`tableShape`](api/config/tableshape-property.md) - настраивает внешний вид таблицы Pivot +- [`columnShape`](api/config/columnshape-property.md) - настраивает внешний вид и поведение столбцов +- [`headerShape`](api/config/headershape-property.md) - настраивает внешний вид и поведение заголовков +- [`configPanel`](api/config/configpanel-property.md) - управляет видимостью панели конфигурации +- [`setLocale`](api/methods/setlocale-method.md) - применяет локаль (см. [Локализация](guides/localization.md)) +- [`data`](api/config/data-property.md), [`fields`](api/config/fields-property.md) - загружают данные и метаданные полей +- [`predicates`](api/config/predicates-property.md) - предварительно обрабатывают данные перед агрегацией +- [`methods`](api/config/methods-property.md) - определяют пользовательские методы агрегации +- [`limits`](api/config/limits-property.md) - ограничивают количество строк и столбцов в итоговом наборе данных Инструкции по работе с данными см. в разделе [Работа с данными](guides/working-with-data.md). @@ -81,14 +81,14 @@ const table = new pivot.Pivot("#root", { ## Автоматическое изменение ширины столбцов по содержимому -Используйте параметр `autoWidth` свойства [`columnShape`](api/config/columnshape-property.md), чтобы вычислять ширину столбцов автоматически. Все подпараметры `autoWidth` являются необязательными — полные описания см. в справочнике [`columnShape`](api/config/columnshape-property.md). +Используйте параметр `autoWidth` свойства [`columnShape`](api/config/columnshape-property.md), чтобы вычислять ширину столбцов автоматически. Все подпараметры `autoWidth` являются необязательными. Полные описания см. в справочнике [`columnShape`](api/config/columnshape-property.md). Объект `autoWidth` принимает следующие параметры: -- `columns` — объект, определяющий, для каких полей вычисляется ширина автоматически -- `auto` — подстраивает ширину под заголовок, содержимое ячейки или под оба варианта -- `maxRows` — количество строк данных, анализируемых для определения размера столбца (по умолчанию: 20) -- `firstOnly` — если `true` (по умолчанию), каждое поле анализируется только один раз. Когда несколько столбцов основаны на одном поле (например, `oil` с `count` и `oil` с `sum`), анализируется только первый столбец, а остальные наследуют его ширину +- `columns` - объект, определяющий, для каких полей вычисляется ширина автоматически +- `auto` - подстраивает ширину под заголовок, содержимое ячейки или под оба варианта +- `maxRows` - количество строк данных, анализируемых для определения размера столбца (по умолчанию: 20) +- `firstOnly` - если `true` (по умолчанию), каждое поле анализируется только один раз. Когда несколько столбцов основаны на одном поле (например, `oil` с `count` и `oil` с `sum`), анализируется только первый столбец, а остальные наследуют его ширину Следующий фрагмент кода включает `autoWidth` для четырёх полей и отключает `firstOnly`, чтобы каждый столбец получил собственное измерение: @@ -460,7 +460,7 @@ widget.api.on("render-table", ({ config: tableConfig }) => { ## Сортировка в столбцах -Сортировка в интерфейсе включена по умолчанию — пользователи нажимают на заголовок столбца для сортировки. Чтобы отключить её, установите параметр `sort` свойства [`columnShape`](api/config/columnshape-property.md) в `false`. +Сортировка в интерфейсе включена по умолчанию: пользователи нажимают на заголовок столбца для сортировки. Чтобы отключить её, установите параметр `sort` свойства [`columnShape`](api/config/columnshape-property.md) в `false`. Следующий фрагмент кода отключает сортировку в интерфейсе: @@ -727,10 +727,10 @@ table.api.intercept("show-config-panel", () => { Панель конфигурации поддерживает следующие операции с полями: -- [`add-field`](api/events/add-field-event.md) — добавить поле в область -- [`delete-field`](api/events/delete-field-event.md) — удалить поле из области -- [`update-field`](api/events/update-field-event.md) — обновить метод или настройки поля -- [`move-field`](api/events/move-field-event.md) — изменить порядок полей внутри области +- [`add-field`](api/events/add-field-event.md) - добавить поле в область +- [`delete-field`](api/events/delete-field-event.md) - удалить поле из области +- [`update-field`](api/events/update-field-event.md) - обновить метод или настройки поля +- [`move-field`](api/events/move-field-event.md) - изменить порядок полей внутри области **Связанные примеры**: - [Pivot 2. Добавление текстовых шаблонов для ячеек таблицы и заголовков](https://snippet.dhtmlx.com/n9ylp6b2) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/initialization.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/initialization.md index 8ee085b..c82695a 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/initialization.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/initialization.md @@ -66,10 +66,10 @@ const table = new pivot.Pivot("#root", { Конструктор возвращает экземпляр Pivot. Вызывайте методы API на возвращённом экземпляре: -- [`getTable`](api/methods/gettable-method.md) — получить доступ к экземпляру виджета Table -- [`setConfig`](api/methods/setconfig-method.md) — обновить текущую конфигурацию Pivot -- [`setLocale`](api/methods/setlocale-method.md) — применить новую локаль к Pivot -- [`showConfigPanel`](api/methods/showconfigpanel-method.md) — показать или скрыть панель конфигурации +- [`getTable`](api/methods/gettable-method.md) - получить доступ к экземпляру виджета Table +- [`setConfig`](api/methods/setconfig-method.md) - обновить текущую конфигурацию Pivot +- [`setLocale`](api/methods/setlocale-method.md) - применить новую локаль к Pivot +- [`showConfigPanel`](api/methods/showconfigpanel-method.md) - показать или скрыть панель конфигурации ## Параметры конфигурации {#configuration-properties} diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md index af4416b..91f14c6 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md @@ -25,7 +25,7 @@ ng new my-angular-pivot-app ~~~ :::note -При запросе Angular CLI отключите Server-Side Rendering (SSR) и Static Site Generation (SSG/Prerendering) — данное руководство предполагает клиентский рендеринг. +При запросе Angular CLI отключите Server-Side Rendering (SSR) и Static Site Generation (SSG/Prerendering). Данное руководство предполагает клиентский рендеринг. ::: Команда установит все необходимые инструменты. Дополнительные команды не требуются. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/loading-data.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/loading-data.md index 3ecf78e..f017482 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/loading-data.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/loading-data.md @@ -167,9 +167,9 @@ Pivot принимает данные CSV после их конвертации В примере ниже используется внешняя библиотека [PapaParse](https://cdnjs.cloudflare.com/ajax/libs/PapaParse/5.4.1/papaparse.min.js) для загрузки и конвертации данных по нажатию кнопки. Вспомогательная функция `convert()` принимает следующие параметры: -- `data` — строка с данными CSV -- `headers` — массив названий полей CSV -- `meta` — объект, сопоставляющий названия полей с типами данных +- `data` - строка с данными CSV +- `headers` - массив названий полей CSV +- `meta` - объект, сопоставляющий названия полей с типами данных Следующий фрагмент кода создаёт Pivot, определяет вспомогательную функцию `convert()` и применяет спарсенные данные CSV через [`setConfig`](api/methods/setconfig-method.md) по нажатию кнопки: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md index 907c292..4cfb324 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/mcp-server.md @@ -6,7 +6,7 @@ description: Конфигурация, методы агрегации, пред # MCP-сервер DHTMLX Pivot: конфигурация, агрегация и экспорт {#dhtmlx-pivot-mcp-server-configuration-aggregation-and-export} -DHTMLX Pivot превращает [единый объект конфигурации](api/config/config-property.md) в полностью агрегированную таблицу и открывает доступ к целому второму API — [базовому виджету Table](api/methods/gettable-method.md) — для экспорта данных или раскрытия строк дерева. Изменения макета и полные перерисовки таблицы запускают собственные события: [редактирование макета](api/events/update-config-event.md) вызывает одно событие, а [каждая перерисовка внутри](api/events/render-table-event.md) — другое. Чтобы не ошибиться во всём этом, нужна актуальная документация, а не устаревшая догадка. +DHTMLX Pivot превращает [единый объект конфигурации](api/config/config-property.md) в полностью агрегированную таблицу и открывает доступ к целому второму API, [базовому виджету Table](api/methods/gettable-method.md), для экспорта данных или раскрытия строк дерева. Изменения макета и полные перерисовки таблицы запускают собственные события: [редактирование макета](api/events/update-config-event.md) вызывает одно событие, а [каждая перерисовка внутри](api/events/render-table-event.md) — другое. Чтобы не ошибиться во всём этом, нужна актуальная документация, а не устаревшая догадка. Вместо этого обратитесь к MCP-серверу DHTMLX: он возвращает [актуальную структуру `config`](api/config/config-property.md), [путь экспорта через getTable()](guides/exporting-data.md) и [нужное событие для сохранения состояния](/guides/working-with-server#save-the-users-layout-to-resume-the-session), поэтому ассистент генерирует код, который соответствует тому, как Pivot на самом деле ведёт себя сегодня. @@ -27,7 +27,7 @@ MCP-сервер может рассказать почти всё о докум - Поиска актуального API для [методов](api/overview/methods-overview.md), [событий](api/overview/events-overview.md) и [свойств](api/overview/properties-overview.md), включая методы [Event Bus](api/overview/internal-eventbus-overview.md) и [состояния](api/overview/internal-state-overview.md). - Генерации готового к запуску кода [инициализации](guides/initialization.md) с нужными для конкретной таблицы `fields`, `data` и структурой [`config`](api/config/config-property.md). - Определения [строк, столбцов и значений](guides/working-with-data.md#define-pivot-structure) в свойстве `config`, включая обе допустимые формы записи `values`. -- Выбора или написания [методов агрегации](guides/working-with-data.md#applying-maths-methods) — от встроенного набора `sum`/`count`/`average` до пользовательского метода, добавленного через свойство [`methods`](api/config/methods-property.md). +- Выбора или написания [методов агрегации](guides/working-with-data.md#applying-maths-methods), от встроенного набора `sum`/`count`/`average` до пользовательского метода, добавленного через свойство [`methods`](api/config/methods-property.md). - Предварительной обработки данных с помощью [предикатов](guides/working-with-data.md#processing-data-with-predicates) перед агрегацией, например группировки дат по месяцам. - Изменения размера, закрепления и шаблонизации ячеек таблицы через [`tableShape`](api/config/tableshape-property.md) и [`headerShape`](api/config/headershape-property.md), включая [режим дерева](guides/configuration.md#enabling-the-tree-mode) и [закреплённые столбцы](guides/configuration.md#freezing-columns). - [Локализации](guides/localization.md) подписей и форматов дат/чисел, а также [стилизации](guides/stylization.md) таблицы с помощью CSS-переменных `--wx-pivot-*`. @@ -36,7 +36,7 @@ MCP-сервер может рассказать почти всё о докум ## Куда попадает вопрос о Pivot в MCP {#where-a-pivot-question-lands-in-mcp} -Вопрос о Pivot, отправленный на MCP-сервер DHTMLX, проходит через конвейер Retrieval-Augmented Generation (RAG), построенный на Model Context Protocol (MCP), и попадает в один из двух сценариев: *Search*, который возвращает подходящие страницы документации, из которых ассистент пишет ответ, или *Inference*, который читает эти страницы и сам отвечает на вопрос. Обращения к документации требует только половина этого запроса. Ассистент выделяет эту половину и дописывает остальное — логику сохранения, специфичную для конкретного сервера, — из того, что уже знает. +Вопрос о Pivot, отправленный на MCP-сервер DHTMLX, проходит через конвейер Retrieval-Augmented Generation (RAG), построенный на Model Context Protocol (MCP), и попадает в один из двух сценариев: *Search*, который возвращает подходящие страницы документации, из которых ассистент пишет ответ, или *Inference*, который читает эти страницы и сам отвечает на вопрос. Обращения к документации требует только половина этого запроса. Ассистент выделяет эту половину и дописывает остальное (логику сохранения, специфичную для конкретного сервера) из того, что уже знает. Рассмотрим промпт *«Напиши обработчик, который сохраняет config Pivot на сервер при каждом изменении макета»*: @@ -51,13 +51,13 @@ MCP-сервер может рассказать почти всё о докум ## Подключение ИИ-инструмента к MCP-серверу {#linking-your-ai-tool-to-the-mcp-server} -Какой бы инструмент разработки с ИИ вы ни использовали вместе с Pivot, подключение к MCP-серверу сводится к одному шагу: указать в нём URL конечной точки ниже — через команду CLI или JSON-файл конфигурации. +Какой бы инструмент разработки с ИИ вы ни использовали вместе с Pivot, подключение к MCP-серверу сводится к одному шагу: указать в нём URL конечной точки ниже, используя команду CLI или JSON-файл конфигурации. ~~~jsx https://docs.dhtmlx.com/mcp ~~~ -Далее — инструкции по настройке для популярных инструментов. +Далее следуют инструкции по настройке для популярных инструментов. ### Claude Code {#claude-code} @@ -87,7 +87,7 @@ claude mcp add --transport http dhtmlx-mcp https://docs.dhtmlx.com/mcp ### Cursor {#cursor} :::info -Полный набор параметров настройки MCP — в [официальной документации](https://cursor.com/en-US/docs/mcp) Cursor. +Полный набор параметров настройки MCP приведён в [официальной документации](https://cursor.com/en-US/docs/mcp) Cursor. ::: Шаги для добавления сервера: @@ -112,7 +112,7 @@ claude mcp add --transport http dhtmlx-mcp https://docs.dhtmlx.com/mcp #### Antigravity 2.0 {#antigravity-20} :::info -Полная картина по интеграции MCP-сервера в Antigravity — в [официальной документации](https://antigravity.google/docs/mcp). +Полная картина по интеграции MCP-сервера в Antigravity описана в [официальной документации](https://antigravity.google/docs/mcp). ::: Чтобы подключить MCP-сервер DHTMLX к Google Antigravity, выполните следующие шаги: @@ -158,7 +158,7 @@ https://docs.dhtmlx.com/mcp ### ChatGPT {#chatgpt} :::info -Все шаги настройки MCP-коннектора в ChatGPT — в [официальной документации](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt). +Все шаги настройки MCP-коннектора в ChatGPT описаны в [официальной документации](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt). ::: Шаги настройки коннектора: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/stylization.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/stylization.md index d2e7b47..6a0cc51 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/stylization.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/stylization.md @@ -112,7 +112,7 @@ Pivot предоставляет одну встроенную тему: **Mater Пример ниже применяет стили к ячейкам тела и заголовка: - ячейки тела получают класс на основе значений ячейки (например, `"Down"`, `"Up"`, `"Idle"` в поле `status`) и итоговых значений (больше 40 или меньше 5) -- ячейки заголовка получают класс на основе значения поля `streaming` — `status-down` для `"no"` и `status-up` для любого другого значения +- ячейки заголовка получают класс на основе значения поля `streaming`: `status-down` для `"no"` и `status-up` для любого другого значения ~~~jsx const widget = new pivot.Pivot("#pivot", { diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/typescript-support.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/typescript-support.md index 9ddfca1..2481770 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/typescript-support.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/typescript-support.md @@ -6,7 +6,7 @@ description: Вы можете узнать об использовании Type # Поддержка TypeScript {#typescript-support} -DHTMLX Pivot поставляется с определениями TypeScript начиная с версии v2.0. Определения готовы к использованию — дополнительная настройка не требуется. +DHTMLX Pivot поставляется с определениями TypeScript начиная с версии v2.0. Определения готовы к использованию, дополнительная настройка не требуется. :::info Попробуйте Pivot в [Snippet Tool](https://snippet.dhtmlx.com/y2buoahe). diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/guides/working-with-data.md b/i18n/ru/docusaurus-plugin-content-docs/current/guides/working-with-data.md index 1b12863..8ab836d 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/guides/working-with-data.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/guides/working-with-data.md @@ -10,7 +10,7 @@ description: В документации библиотеки DHTMLX JavaScript ## Определение полей {#define-fields} -Используйте свойство [`fields`](api/config/fields-property.md), чтобы объявить поля, которые Pivot может размещать в строках, столбцах и значениях. Каждый элемент массива `fields` описывает одно поле — его идентификатор, метку и тип данных. +Используйте свойство [`fields`](api/config/fields-property.md), чтобы объявить поля, которые Pivot может размещать в строках, столбцах и значениях. Каждый элемент массива `fields` описывает одно поле: его идентификатор, метку и тип данных. Следующий фрагмент кода инициализирует Pivot с пятью полями: @@ -127,7 +127,7 @@ new pivot.Pivot("#pivot", { ## Определение структуры Pivot {#define-pivot-structure} -Используйте свойство [`config`](api/config/config-property.md), чтобы объявить, какие поля отображаются как строки, столбцы и агрегированные значения, а также как фильтруются данные. Свойство `config` не имеет предопределённых значений — вы должны задать его для отображения любых данных. Полный список параметров см. в справочнике [`config`](api/config/config-property.md). +Используйте свойство [`config`](api/config/config-property.md), чтобы объявить, какие поля отображаются как строки, столбцы и агрегированные значения, а также как фильтруются данные. Свойство `config` не имеет предопределённых значений, поэтому вы должны задать его для отображения любых данных. Полный список параметров см. в справочнике [`config`](api/config/config-property.md). Следующий фрагмент кода помещает `continent` и `name` в строки, `year` — в столбцы, три агрегации — в значения и добавляет фильтр по `name`: @@ -253,9 +253,9 @@ Pivot поддерживает фильтры, привязанные к тип Pivot поддерживает следующие условия фильтрации по типам данных: -- текстовые поля — `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` -- числовые поля — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` -- поля дат — `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` +- текстовые поля: `equal`, `notEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith`, `includes` +- числовые поля: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `contains`, `notContains`, `beginsWith`, `notBeginsWith`, `endsWith`, `notEndsWith` +- поля дат: `equal`, `notEqual`, `greater`, `greaterOrEqual`, `less`, `lessOrEqual`, `between`, `notBetween`, `includes` Правило `includes` ограничивает фильтр конкретным набором допустимых значений. @@ -263,7 +263,7 @@ Pivot поддерживает следующие условия фильтра Чтобы объявить фильтр, добавьте объект `filters` в свойство [`config`](api/config/config-property.md), используя идентификатор поля в качестве ключа. Каждое значение — объект с условиями фильтрации. -Следующий фрагмент кода применяет два фильтра — один по `genre` (значения, содержащие `"D"`, ограниченные значением `"Drama"`) и один по `title` (значения, содержащие `"A"`): +Следующий фрагмент кода применяет два фильтра: один по `genre` (значения, содержащие `"D"`, ограниченные значением `"Drama"`) и один по `title` (значения, содержащие `"A"`): ~~~jsx const table = new pivot.Pivot("#root", { @@ -304,7 +304,7 @@ const table = new pivot.Pivot("#root", { Чтобы предотвратить зависание компонента на очень больших наборах данных, ограничьте количество строк и столбцов в итоговом наборе с помощью свойства [`limits`](api/config/limits-property.md). Pivot прерывает отрисовку по достижении лимита. По умолчанию лимит составляет 10000 строк и 5000 столбцов. :::note -Лимиты применяются к большим наборам данных. Числа приблизительны — Pivot не гарантирует точного количества строк/столбцов. +Лимиты применяются к большим наборам данных. Числа приблизительны: Pivot не гарантирует точного количества строк/столбцов. ::: Следующий фрагмент кода ограничивает набор данных 10 строками и 3 столбцами: @@ -337,19 +337,19 @@ const table = new pivot.Pivot("#root", { Pivot включает следующие встроенные методы агрегации: -- `sum` (только числовые значения) — суммирует все выбранные значения; игнорирует пустые ячейки, логические значения вроде `TRUE` и текст -- `min` (числовые значения и даты) — возвращает минимальное значение; игнорирует пустые ячейки, логические значения и текст. Возвращает `0`, если во входных данных нет чисел -- `max` (числовые значения и даты) — возвращает максимальное значение; игнорирует пустые ячейки, логические значения и текст. Возвращает `0`, если во входных данных нет чисел -- `count` (числовые, текстовые значения и даты) — считает непустые ячейки; это метод по умолчанию, назначаемый каждому вновь добавленному полю -- `countunique` (числовые и текстовые значения) — считает количество уникальных значений во входных данных -- `average` (только числовые значения) — вычисляет среднее арифметическое; игнорирует пустые ячейки, логические значения и текст. Включает ячейки со значением ноль -- `counta` (числовые, текстовые значения и даты) — считает все непустые значения, включая числа, даты и текст -- `median` (только числовые значения) — возвращает медиану входных данных -- `product` (только числовые значения) — возвращает произведение всех чисел во входных данных -- `stdev` (только числовые значения) — стандартное отклонение, при котором входные данные рассматриваются как выборка из большей совокупности -- `stdevp` (только числовые значения) — стандартное отклонение, при котором входные данные рассматриваются как вся генеральная совокупность -- `var` (только числовые значения) — дисперсия, при которой входные данные рассматриваются как выборка из большей совокупности -- `varp` (только числовые значения) — дисперсия, при которой входные данные рассматриваются как вся генеральная совокупность +- `sum` (только числовые значения) - суммирует все выбранные значения; игнорирует пустые ячейки, логические значения вроде `TRUE` и текст +- `min` (числовые значения и даты) - возвращает минимальное значение; игнорирует пустые ячейки, логические значения и текст. Возвращает `0`, если во входных данных нет чисел +- `max` (числовые значения и даты) - возвращает максимальное значение; игнорирует пустые ячейки, логические значения и текст. Возвращает `0`, если во входных данных нет чисел +- `count` (числовые, текстовые значения и даты) - считает непустые ячейки; это метод по умолчанию, назначаемый каждому вновь добавленному полю +- `countunique` (числовые и текстовые значения) - считает количество уникальных значений во входных данных +- `average` (только числовые значения) - вычисляет среднее арифметическое; игнорирует пустые ячейки, логические значения и текст. Включает ячейки со значением ноль +- `counta` (числовые, текстовые значения и даты) - считает все непустые значения, включая числа, даты и текст +- `median` (только числовые значения) - возвращает медиану входных данных +- `product` (только числовые значения) - возвращает произведение всех чисел во входных данных +- `stdev` (только числовые значения) - стандартное отклонение, при котором входные данные рассматриваются как выборка из большей совокупности +- `stdevp` (только числовые значения) - стандартное отклонение, при котором входные данные рассматриваются как вся генеральная совокупность +- `var` (только числовые значения) - дисперсия, при которой входные данные рассматриваются как выборка из большей совокупности +- `varp` (только числовые значения) - дисперсия, при которой входные данные рассматриваются как вся генеральная совокупность Следующий фрагмент кода показывает определения встроенных методов: @@ -572,12 +572,12 @@ const defaultPredicates = { Чтобы добавить пользовательский предикат, настройте свойство [`predicates`](api/config/predicates-property.md). Каждая запись связывает идентификатор предиката (ключ) с объектом конфигурации: -- `type` — типы полей, которые принимает предикат (`"number"`, `"date"`, `"text"` или массив) -- `label` — метка предиката, отображаемая в выпадающем списке GUI для строки/столбца -- `handler` — функция, преобразующая значение и возвращающая обработанное значение -- `template` — необязательная функция, управляющая отображением обработанного значения -- `field` — необязательная функция, ограничивающая предикат конкретными полями -- `filter` — необязательная конфигурация фильтра, если тип фильтра должен отличаться от `type` или формат данных должен отличаться от `template` +- `type` - типы полей, которые принимает предикат (`"number"`, `"date"`, `"text"` или массив) +- `label` - метка предиката, отображаемая в выпадающем списке GUI для строки/столбца +- `handler` - функция, преобразующая значение и возвращающая обработанное значение +- `template` - необязательная функция, управляющая отображением обработанного значения +- `field` - необязательная функция, ограничивающая предикат конкретными полями +- `filter` - необязательная конфигурация фильтра, если тип фильтра должен отличаться от `type` или формат данных должен отличаться от `template` Чтобы использовать пользовательский предикат, задайте его идентификатор как `method` строки или столбца, к которым предикат должен применяться. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/how-to-start.md b/i18n/ru/docusaurus-plugin-content-docs/current/how-to-start.md index 9df0e29..bf43da4 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/how-to-start.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/how-to-start.md @@ -116,7 +116,7 @@ const table = new pivot.Pivot("#root", { ## Что дальше {#whats-next} -Вот и всё. Всего несколько простых шагов — и у вас есть удобный инструмент для анализа данных. Теперь вы можете приступить к решению своих задач или продолжить изучение возможностей JavaScript Pivot: +Вот и всё. Всего несколько простых шагов, и у вас есть удобный инструмент для анализа данных. Теперь вы можете приступить к решению своих задач или продолжить изучение возможностей JavaScript Pivot: - Страницы раздела [Руководства](/category/guides) содержат инструкции по установке, загрузке данных, стилизации и другие полезные советы для работы с конфигурацией Pivot - [Справочник API](api/overview/main-overview.md) содержит описание функциональности Pivot diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/news/whats-new.md b/i18n/ru/docusaurus-plugin-content-docs/current/news/whats-new.md index 130a647..1f2b18b 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/news/whats-new.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/news/whats-new.md @@ -101,14 +101,14 @@ API версии 1.5 несовместим с API версии 2.0. - делать столбцы сворачиваемыми ([пример](https://snippet.dhtmlx.com/pt2ljmcm)) - Форма и размеры таблицы настраиваются через свойство [`tableShape`](api/config/tableshape-property.md), которое позволяет: - настраивать высоту строк, заголовков, нижнего колонтитула: rowHeight, headerHeight, footerHeight ([Изменение размеров таблицы](guides/configuration.md#resizing-the-table)) - - генерировать итоговые значения не только для столбцов, но и для строк — с помощью параметра **totalColumn** свойства `tableShape` ([пример](https://snippet.dhtmlx.com/f0ag0t9t)) + - генерировать итоговые значения не только для столбцов, но и для строк с помощью параметра **totalColumn** свойства `tableShape` ([пример](https://snippet.dhtmlx.com/f0ag0t9t)) - скрывать дублирующиеся значения в представлении таблицы (параметр **cleanRows** свойства [`tableShape`](api/config/tableshape-property.md)) - фиксировать столбцы слева, делая их статичными при прокрутке ([пример](https://snippet.dhtmlx.com/lahf729o)) - разворачивать или сворачивать все строки ([пример](https://snippet.dhtmlx.com/i4mi6ejn)) - Добавлены дополнительные возможности для агрегирования данных: - [ограничение загружаемых данных](guides/working-with-data.md#limiting-loaded-data) - доступно больше [операций с данными](guides/working-with-data.md#applying-maths-methods) - - [обработка данных с помощью предикатов](guides/working-with-data.md#processing-data-with-predicates) — применение пользовательских функций предварительной обработки данных + - [обработка данных с помощью предикатов](guides/working-with-data.md#processing-data-with-predicates) - применение пользовательских функций предварительной обработки данных - [задание формата даты через локаль](guides/localization.md#date-formatting) - Добавлены новые методы: [`getTable()`](api/methods/gettable-method.md), [`setConfig()`](api/methods/setconfig-method.md), [`setLocale()`](api/methods/setlocale-method.md), [`showConfigPanel()`](api/methods/showconfigpanel-method.md) - Добавлены новые события: [`add-field`](api/events/add-field-event.md), [`delete-field`](api/events/delete-field-event.md), [`open-filter`](api/events/open-filter-event.md), [`render-table`](api/events/render-table-event.md), [`move-field`](api/events/move-field-event.md), [`show-config-panel`](api/events/show-config-panel-event.md), [`show-config-panel`](api/events/show-config-panel-event.md), [`update-config`](api/events/update-config-event.md), [`update-field`](api/events/update-field-event.md). diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/.sync b/i18n/zh/docusaurus-plugin-content-docs/current/.sync index 4ed164f..7c568cc 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/.sync +++ b/i18n/zh/docusaurus-plugin-content-docs/current/.sync @@ -1 +1 @@ -10518169aead802523be5a1c20e5730654345e9b +f7879008e5891430a2dbcdad5acd0cf246dc1ee5 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/api/methods/showconfigpanel-method.md b/i18n/zh/docusaurus-plugin-content-docs/current/api/methods/showconfigpanel-method.md index 0b9d7fb..323fe55 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/api/methods/showconfigpanel-method.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/api/methods/showconfigpanel-method.md @@ -20,7 +20,7 @@ showConfigPanel({mode: boolean}): void; ### 参数 {#parameters} -- `mode`(boolean)—(必填)若值设置为 **true**(默认值),则显示配置面板;若值设置为 **false**,则隐藏配置面板 +- `mode`(boolean):(必填)若值设置为 **true**(默认值),则显示配置面板;若值设置为 **false**,则隐藏配置面板 ### 示例 {#example} diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md index 40013c3..2485a80 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/configuration.md @@ -8,17 +8,17 @@ description: 您可以在 DHTMLX JavaScript Pivot 库的文档中了解配置相 通过以下 API 配置 Pivot 表格和配置面板: -- [`config`](api/config/config-property.md) — 定义 Pivot 表格的结构及数据聚合方式 -- [`render-table`](api/events/render-table-event.md) — 动态更改表格配置 -- [`tableShape`](api/config/tableshape-property.md) — 配置 Pivot 表格的外观 -- [`columnShape`](api/config/columnshape-property.md) — 配置列的外观和行为 -- [`headerShape`](api/config/headershape-property.md) — 配置表头的外观和行为 -- [`configPanel`](api/config/configpanel-property.md) — 控制配置面板的显示状态 -- [`setLocale`](api/methods/setlocale-method.md) — 应用语言环境(参见[本地化](guides/localization.md)) -- [`data`](api/config/data-property.md)、[`fields`](api/config/fields-property.md) — 加载数据和字段元数据 -- [`predicates`](api/config/predicates-property.md) — 在聚合前对数据进行预处理 -- [`methods`](api/config/methods-property.md) — 定义自定义聚合方法 -- [`limits`](api/config/limits-property.md) — 限制最终数据集中的行数和列数 +- [`config`](api/config/config-property.md):定义 Pivot 表格的结构及数据聚合方式 +- [`render-table`](api/events/render-table-event.md):动态更改表格配置 +- [`tableShape`](api/config/tableshape-property.md):配置 Pivot 表格的外观 +- [`columnShape`](api/config/columnshape-property.md):配置列的外观和行为 +- [`headerShape`](api/config/headershape-property.md):配置表头的外观和行为 +- [`configPanel`](api/config/configpanel-property.md):控制配置面板的显示状态 +- [`setLocale`](api/methods/setlocale-method.md):应用语言环境(参见[本地化](guides/localization.md)) +- [`data`](api/config/data-property.md)、[`fields`](api/config/fields-property.md):加载数据和字段元数据 +- [`predicates`](api/config/predicates-property.md):在聚合前对数据进行预处理 +- [`methods`](api/config/methods-property.md):定义自定义聚合方法 +- [`limits`](api/config/limits-property.md):限制最终数据集中的行数和列数 有关数据操作的说明,请参见[数据操作](guides/working-with-data.md)。 @@ -81,14 +81,14 @@ const table = new pivot.Pivot("#root", { ## 自动调整列宽以适应内容 {#autosize-columns-to-content} -使用 [`columnShape`](api/config/columnshape-property.md) 属性的 `autoWidth` 参数自动计算列宽。所有 `autoWidth` 子参数均为可选项——完整说明请参见 [`columnShape`](api/config/columnshape-property.md) 参考文档。 +使用 [`columnShape`](api/config/columnshape-property.md) 属性的 `autoWidth` 参数自动计算列宽。所有 `autoWidth` 子参数均为可选项。完整说明请参见 [`columnShape`](api/config/columnshape-property.md) 参考文档。 `autoWidth` 对象接受以下参数: -- `columns` — 选择哪些字段启用自动计算宽度的对象 -- `auto` — 根据表头、单元格内容或两者来调整宽度 -- `maxRows` — 用于检测列尺寸所分析的数据行数(默认值:20) -- `firstOnly` — 若为 `true`(默认值),则每个字段仅分析一次。当多列基于同一字段时(例如,`oil` 对应 `count` 和 `oil` 对应 `sum`),仅分析第一列,其余列继承其宽度 +- `columns`:选择哪些字段启用自动计算宽度的对象 +- `auto`:根据表头、单元格内容或两者来调整宽度 +- `maxRows`:用于检测列尺寸所分析的数据行数(默认值:20) +- `firstOnly`:若为 `true`(默认值),则每个字段仅分析一次。当多列基于同一字段时(例如,`oil` 对应 `count` 和 `oil` 对应 `sum`),仅分析第一列,其余列继承其宽度 以下代码片段为四个字段启用 `autoWidth` 并禁用 `firstOnly`,使每列独立进行宽度计算: @@ -460,7 +460,7 @@ widget.api.on("render-table", ({ config: tableConfig }) => { ## 列排序 {#sort-in-columns} -UI 中的排序功能默认启用——用户单击列表头即可排序。要禁用排序,请将 [`columnShape`](api/config/columnshape-property.md) 属性的 `sort` 参数设置为 `false`。 +UI 中的排序功能默认启用:用户单击列表头即可排序。要禁用排序,请将 [`columnShape`](api/config/columnshape-property.md) 属性的 `sort` 参数设置为 `false`。 以下代码片段禁用 UI 排序: @@ -727,10 +727,10 @@ table.api.intercept("show-config-panel", () => { 配置面板支持以下字段操作: -- [`add-field`](api/events/add-field-event.md) — 将字段添加到区域 -- [`delete-field`](api/events/delete-field-event.md) — 从区域移除字段 -- [`update-field`](api/events/update-field-event.md) — 更新字段的方法或设置 -- [`move-field`](api/events/move-field-event.md) — 在区域内对字段重新排序 +- [`add-field`](api/events/add-field-event.md):将字段添加到区域 +- [`delete-field`](api/events/delete-field-event.md):从区域移除字段 +- [`update-field`](api/events/update-field-event.md):更新字段的方法或设置 +- [`move-field`](api/events/move-field-event.md):在区域内对字段重新排序 **相关示例**: - [Pivot 2. 为表格和表头单元格添加文本模板](https://snippet.dhtmlx.com/n9ylp6b2) diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/initialization.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/initialization.md index e79056f..913b8f3 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/initialization.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/initialization.md @@ -66,10 +66,10 @@ const table = new pivot.Pivot("#root", { 构造函数返回一个 Pivot 实例。可在返回的实例上调用以下 API 方法: -- [`getTable`](api/methods/gettable-method.md) — 获取底层 Table 组件实例 -- [`setConfig`](api/methods/setconfig-method.md) — 更新当前 Pivot 配置 -- [`setLocale`](api/methods/setlocale-method.md) — 为 Pivot 应用新的语言环境 -- [`showConfigPanel`](api/methods/showconfigpanel-method.md) — 显示或隐藏配置面板 +- [`getTable`](api/methods/gettable-method.md):获取底层 Table 组件实例 +- [`setConfig`](api/methods/setconfig-method.md):更新当前 Pivot 配置 +- [`setLocale`](api/methods/setlocale-method.md):为 Pivot 应用新的语言环境 +- [`showConfigPanel`](api/methods/showconfigpanel-method.md):显示或隐藏配置面板 ## 配置属性 {#configuration-properties} diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md index 4aed09e..9ab1b4d 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/integration-with-angular.md @@ -25,7 +25,7 @@ ng new my-angular-pivot-app ~~~ :::note -当 Angular CLI 询问时,请禁用服务器端渲染(SSR)和静态站点生成(SSG/Prerendering)——本指南假设使用客户端渲染应用。 +当 Angular CLI 询问时,请禁用服务器端渲染(SSR)和静态站点生成(SSG/Prerendering)。本指南假设使用客户端渲染应用。 ::: 该命令会安装所有必要的工具,无需执行其他命令。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/loading-data.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/loading-data.md index 2a04cd5..180d13f 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/loading-data.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/loading-data.md @@ -167,9 +167,9 @@ Pivot 支持通过外部 JS 解析库将 CSV 数据转换为 JSON 后再加载 以下示例使用外部 [PapaParse](https://cdnjs.cloudflare.com/ajax/libs/PapaParse/5.4.1/papaparse.min.js) 库在点击按钮时加载并转换数据。`convert()` 辅助函数接受以下参数: -- `data` — 包含 CSV 数据的字符串 -- `headers` — CSV 字段名称的数组 -- `meta` — 将字段名称映射到数据类型的对象 +- `data`:包含 CSV 数据的字符串 +- `headers`:CSV 字段名称的数组 +- `meta`:将字段名称映射到数据类型的对象 以下代码片段创建 Pivot,定义 `convert()` 辅助函数,并在点击按钮时通过 [`setConfig`](api/methods/setconfig-method.md) 应用解析后的 CSV 数据: diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md index 0d16715..02902be 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/mcp-server.md @@ -6,7 +6,7 @@ description: 通过 MCP 服务器,DHTMLX Pivot 的 config、聚合方法、谓 # DHTMLX Pivot MCP 服务器:配置、聚合和导出 {#dhtmlx-pivot-mcp-server-configuration-aggregation-and-export} -DHTMLX Pivot 将[一个配置对象](api/config/config-property.md)转换为完全聚合的表格,并开放了整个第二套 API——[底层的 Table widget](api/methods/gettable-method.md),用于导出数据或展开树形行。布局更改和完整表格重绘各自触发自己的事件:[布局编辑](api/events/update-config-event.md)触发其中一个,而[底层的每一次重绘](api/events/render-table-event.md)触发另一个。要做对这一切,靠的是最新文档,而不是过时的猜测。 +DHTMLX Pivot 将[一个配置对象](api/config/config-property.md)转换为完全聚合的表格,并开放了整个第二套 API,即[底层的 Table widget](api/methods/gettable-method.md),用于导出数据或展开树形行。布局更改和完整表格重绘各自触发自己的事件:[布局编辑](api/events/update-config-event.md)触发其中一个,而[底层的每一次重绘](api/events/render-table-event.md)触发另一个。要做对这一切,靠的是最新文档,而不是过时的猜测。 不妨改为查询 DHTMLX MCP 服务器:它会返回当前的 [`config` 结构](api/config/config-property.md)、[通过 getTable() 的导出路径](guides/exporting-data.md),以及[用于持久化的正确事件](/guides/working-with-server#save-the-users-layout-to-resume-the-session),从而让助手生成的代码与 Pivot 当前实际的行为方式相匹配。 @@ -36,7 +36,7 @@ MCP 服务器几乎可以告诉您关于 DHTMLX Pivot 文档的一切,从以 ## Pivot 问题在 MCP 中的去向 {#where-a-pivot-question-lands-in-mcp} -发送到 DHTMLX MCP 服务器的 Pivot 问题会经过一条基于 Model Context Protocol(MCP)构建的检索增强生成(RAG)流水线,并落入两种工作流之一:*Search*,返回匹配的参考页面供助手据此编写代码;或 *Inference*,直接读取这些页面并自行回答问题。这类请求中只有一半需要查阅文档。助手会精确定位出这一半,其余部分——即特定于服务器的保存逻辑——则依靠自身已有的知识来编写。 +发送到 DHTMLX MCP 服务器的 Pivot 问题会经过一条基于 Model Context Protocol(MCP)构建的检索增强生成(RAG)流水线,并落入两种工作流之一:*Search*,返回匹配的参考页面供助手据此编写代码;或 *Inference*,直接读取这些页面并自行回答问题。这类请求中只有一半需要查阅文档。助手会精确定位出这一半,其余部分(即特定于服务器的保存逻辑)则依靠自身已有的知识来编写。 以提示词 *"编写一个处理程序,在每次布局更改时将 Pivot 的 config 保存到服务器。"* 为例: diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/stylization.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/stylization.md index 544a596..a7db00c 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/stylization.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/stylization.md @@ -112,7 +112,7 @@ Pivot 提供一个内置主题:**Material**。可通过向 widget 容器添加 以下示例为正文和表头单元格应用样式: - 正文单元格根据单元格值(例如 `status` 字段中的 `"Down"`、`"Up"`、`"Idle"`)以及汇总值(大于 40 或小于 5)接收相应类名 -- 表头单元格根据 `streaming` 字段的值接收类名——值为 `"no"` 时使用 `status-down`,其他值使用 `status-up` +- 表头单元格根据 `streaming` 字段的值接收类名:值为 `"no"` 时使用 `status-down`,其他值使用 `status-up` ~~~jsx const widget = new pivot.Pivot("#pivot", { diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/guides/working-with-data.md b/i18n/zh/docusaurus-plugin-content-docs/current/guides/working-with-data.md index f7efc2b..6127b31 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/guides/working-with-data.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/guides/working-with-data.md @@ -10,7 +10,7 @@ description: 您可以在 DHTMLX JavaScript Pivot 库的文档中了解如何处 ## 定义字段 {#define-fields} -使用 [`fields`](api/config/fields-property.md) 属性声明 Pivot 可放置在行、列和值中的字段。`fields` 数组中的每个条目描述一个字段——其 ID、标签和数据类型。 +使用 [`fields`](api/config/fields-property.md) 属性声明 Pivot 可放置在行、列和值中的字段。`fields` 数组中的每个条目描述一个字段:其 ID、标签和数据类型。 以下代码片段使用五个字段初始化 Pivot: @@ -127,7 +127,7 @@ new pivot.Pivot("#pivot", { ## 定义 Pivot 结构 {#define-pivot-structure} -使用 [`config`](api/config/config-property.md) 属性声明哪些字段作为行、列和聚合值显示,以及如何筛选数据。`config` 属性没有预定义值——您必须设置它才能渲染任何数据。完整参数列表请参阅 [`config`](api/config/config-property.md) 参考。 +使用 [`config`](api/config/config-property.md) 属性声明哪些字段作为行、列和聚合值显示,以及如何筛选数据。`config` 属性没有预定义值,您必须设置它才能渲染任何数据。完整参数列表请参阅 [`config`](api/config/config-property.md) 参考。 以下代码片段将 `continent` 和 `name` 放在行中,`year` 放在列中,三个聚合放在值中,并对 `name` 添加筛选器: @@ -253,9 +253,9 @@ Pivot 支持与字段数据类型绑定的筛选器。可以在初始化后通 Pivot 支持按数据类型划分的以下筛选条件: -- 文本字段 — `equal`、`notEqual`、`contains`、`notContains`、`beginsWith`、`notBeginsWith`、`endsWith`、`notEndsWith`、`includes` -- 数字字段 — `equal`、`notEqual`、`greater`、`greaterOrEqual`、`less`、`lessOrEqual`、`contains`、`notContains`、`beginsWith`、`notBeginsWith`、`endsWith`、`notEndsWith` -- 日期字段 — `equal`、`notEqual`、`greater`、`greaterOrEqual`、`less`、`lessOrEqual`、`between`、`notBetween`、`includes` +- 文本字段:`equal`、`notEqual`、`contains`、`notContains`、`beginsWith`、`notBeginsWith`、`endsWith`、`notEndsWith`、`includes` +- 数字字段:`equal`、`notEqual`、`greater`、`greaterOrEqual`、`less`、`lessOrEqual`、`contains`、`notContains`、`beginsWith`、`notBeginsWith`、`endsWith`、`notEndsWith` +- 日期字段:`equal`、`notEqual`、`greater`、`greaterOrEqual`、`less`、`lessOrEqual`、`between`、`notBetween`、`includes` `includes` 规则将筛选器限制为一组特定的允许值。 @@ -263,7 +263,7 @@ Pivot 支持按数据类型划分的以下筛选条件: 要声明筛选器,请将 `filters` 对象添加到 [`config`](api/config/config-property.md) 属性中,以字段 ID 为键。每个值是一个筛选条件对象。 -以下代码片段应用两个筛选器——一个针对 `genre`(包含 `"D"` 的值,限制为 `"Drama"`),一个针对 `title`(包含 `"A"` 的值): +以下代码片段应用两个筛选器:一个针对 `genre`(包含 `"D"` 的值,限制为 `"Drama"`),一个针对 `title`(包含 `"A"` 的值): ~~~jsx const table = new pivot.Pivot("#root", { @@ -304,7 +304,7 @@ const table = new pivot.Pivot("#root", { 为防止组件在非常大的数据集上挂起,请使用 [`limits`](api/config/limits-property.md) 属性限制最终数据集中的行数和列数。Pivot 在达到限制后中断渲染。默认上限为行 10000、列 5000。 :::note -限制适用于大型数据集。这些数值是近似值——Pivot 不保证精确的行/列数量。 +限制适用于大型数据集。这些数值是近似值,Pivot 不保证精确的行/列数量。 ::: 以下代码片段将数据集限制为 10 行和 3 列: @@ -337,19 +337,19 @@ const table = new pivot.Pivot("#root", { Pivot 包含以下内置聚合方法: -- `sum`(仅限数值)— 对所有选定值求和;忽略空单元格、`TRUE` 等逻辑值和文本 -- `min`(数值和日期值)— 返回最小值;忽略空单元格、逻辑值和文本。如果输入不包含数字,则返回 `0` -- `max`(数值和日期值)— 返回最大值;忽略空单元格、逻辑值和文本。如果输入不包含数字,则返回 `0` -- `count`(数值、文本和日期值)— 计算非空白单元格数量;这是分配给每个新添加字段的默认方法 -- `countunique`(数值和文本值)— 计算输入中唯一值的数量 -- `average`(仅限数值)— 计算输入的算术平均值;忽略空单元格、逻辑值和文本。包含值为零的单元格 -- `counta`(数值、文本和日期值)— 计算所有非空白值,包括数字、日期和文本 -- `median`(仅限数值)— 返回输入的中位数 -- `product`(仅限数值)— 返回输入中所有数字的乘积 -- `stdev`(仅限数值)— 标准差,将输入视为较大集合的样本 -- `stdevp`(仅限数值)— 标准差,将输入视为整体总体 -- `var`(仅限数值)— 方差,将输入视为较大集合的样本 -- `varp`(仅限数值)— 方差,将输入视为整体总体 +- `sum`(仅限数值):对所有选定值求和;忽略空单元格、`TRUE` 等逻辑值和文本 +- `min`(数值和日期值):返回最小值;忽略空单元格、逻辑值和文本。如果输入不包含数字,则返回 `0` +- `max`(数值和日期值):返回最大值;忽略空单元格、逻辑值和文本。如果输入不包含数字,则返回 `0` +- `count`(数值、文本和日期值):计算非空白单元格数量;这是分配给每个新添加字段的默认方法 +- `countunique`(数值和文本值):计算输入中唯一值的数量 +- `average`(仅限数值):计算输入的算术平均值;忽略空单元格、逻辑值和文本。包含值为零的单元格 +- `counta`(数值、文本和日期值):计算所有非空白值,包括数字、日期和文本 +- `median`(仅限数值):返回输入的中位数 +- `product`(仅限数值):返回输入中所有数字的乘积 +- `stdev`(仅限数值):标准差,将输入视为较大集合的样本 +- `stdevp`(仅限数值):标准差,将输入视为整体总体 +- `var`(仅限数值):方差,将输入视为较大集合的样本 +- `varp`(仅限数值):方差,将输入视为整体总体 以下代码片段显示内置方法定义: @@ -572,12 +572,12 @@ const defaultPredicates = { 要添加自定义谓词,请配置 [`predicates`](api/config/predicates-property.md) 属性。每个条目将谓词 ID(键)与配置对象配对: -- `type` — 此谓词接受的字段类型(`"number"`、`"date"`、`"text"` 或数组) -- `label` — 在行/列的 GUI 下拉列表中显示的谓词标签 -- `handler` — 转换值并返回处理结果的函数 -- `template` — 可选函数,控制处理后值的显示方式 -- `field` — 可选函数,将谓词限制为特定字段 -- `filter` — 可选筛选器配置,当筛选器类型应与 `type` 不同,或数据格式应与 `template` 不同时使用 +- `type`:此谓词接受的字段类型(`"number"`、`"date"`、`"text"` 或数组) +- `label`:在行/列的 GUI 下拉列表中显示的谓词标签 +- `handler`:转换值并返回处理结果的函数 +- `template`:可选函数,控制处理后值的显示方式 +- `field`:可选函数,将谓词限制为特定字段 +- `filter`:可选筛选器配置,当筛选器类型应与 `type` 不同,或数据格式应与 `template` 不同时使用 要使用自定义谓词,请将其 ID 设置为应应用谓词的行或列的 `method`。 diff --git a/i18n/zh/docusaurus-plugin-content-docs/current/news/whats-new.md b/i18n/zh/docusaurus-plugin-content-docs/current/news/whats-new.md index bfb4660..339eee3 100644 --- a/i18n/zh/docusaurus-plugin-content-docs/current/news/whats-new.md +++ b/i18n/zh/docusaurus-plugin-content-docs/current/news/whats-new.md @@ -108,7 +108,7 @@ description: 您可以在 DHTMLX JavaScript UI 库的文档中查阅 DHTMLX Pivo - 数据聚合新增更多功能: - [限制加载的数据量](guides/working-with-data.md#limiting-loaded-data) - 支持更多[数据操作](guides/working-with-data.md#applying-maths-methods) - - [使用谓词处理数据](guides/working-with-data.md#processing-data-with-predicates) — 为数据应用自定义预处理函数 + - [使用谓词处理数据](guides/working-with-data.md#processing-data-with-predicates):为数据应用自定义预处理函数 - [通过语言环境设置日期格式](guides/localization.md#date-formatting) - 新增方法:[`getTable()`](api/methods/gettable-method.md)、[`setConfig()`](api/methods/setconfig-method.md)、[`setLocale()`](api/methods/setlocale-method.md)、[`showConfigPanel()`](api/methods/showconfigpanel-method.md) - 新增事件:[`add-field`](api/events/add-field-event.md)、[`delete-field`](api/events/delete-field-event.md)、[`open-filter`](api/events/open-filter-event.md)、[`render-table`](api/events/render-table-event.md)、[`move-field`](api/events/move-field-event.md)、[`show-config-panel`](api/events/show-config-panel-event.md)、[`show-config-panel`](api/events/show-config-panel-event.md)、[`update-config`](api/events/update-config-event.md)、[`update-field`](api/events/update-field-event.md)。