https://docs.aspose.com/cells/javascript-cpp/apply-style-to-pivot-table/ Recent content in Apply Styles to Pivot Tables in Aspose.Cells for JavaScript via C++ on Documentation Hugo -- gohugo.io en https://docs.aspose.com/cells/javascript-cpp/format-part-of-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/javascript-cpp/format-part-of-pivot-table/ <h2 id="possible-usage-scenarios"><strong>Possible Usage Scenarios</strong></h2> <p><code>PivotTable.FormatAll</code> applies a single style to the entire pivot table and is covered on the parent page. It does not distinguish between labels, values, totals, or particular regions of the report. In practice, only a portion of a pivot table usually needs to stand out. Common targets include the labels belonging to one row field, the value cells produced by one field, the grand-total row, or an arbitrary rectangle such as the first two item rows. Applying a style directly to the worksheet cells of a pivot table is not equivalent. Excel stores pivot-table formatting as semantic <code>PivotArea</code> regions rather than as ordinary cell-style records. A pivot-area format stays attached to a region such as a field&rsquo;s labels or data values, and it is re-resolved when the pivot table is recalculated, refreshed, or expanded. A style written directly to a cell, on the other hand, belongs to that cell position and is not tracked by the pivot model. Aspose.Cells exposes the complete <code>PivotTable.Format</code> overload family so that both kinds of formatting are available:</p> <ul> <li><code>Format(PivotArea, Style)</code> anchors a style to a semantic region that is built with <code>PivotArea.Select</code> or <code>PivotArea.SelectField</code>.</li> <li><code>Format(CellArea, Style)</code> anchors a style to a worksheet rectangle inside the pivot table.</li> <li><code>Format(int row, int column, Style)</code> targets one cell.</li> <li><code>FormatAll(Style)</code> formats the whole pivot table.</li> </ul> <h2 id="format-a-pivot-area"><strong>Format a Pivot Area</strong></h2> <p>The semantic-area workflow is the recommended approach when a highlight must follow a field or a region of the report.</p> <ol> <li>Create a <code>PivotArea</code> with <code>new PivotArea(pivotTable)</code>. The object describes a semantic region that belongs to that specific pivot table.</li> <li>Select a field by its zero-based position on a given axis with <code>PivotArea.Select(PivotFieldType axisType, int fieldPosition, PivotTableSelectionType selectionType)</code>. <ul> <li><code>PivotTableSelectionType.DataAndLabel</code> selects both the labels and the data of the field.</li> <li><code>PivotTableSelectionType.LabelOnly</code> selects only the field&rsquo;s labels.</li> <li><code>PivotTableSelectionType.DataOnly</code> selects only the field&rsquo;s data cells.</li> </ul> </li> <li>Select a field by name with <code>PivotArea.SelectField(PivotFieldType axisType, string fieldName)</code>. When a row field is selected by name, the region resolves to the value cells produced by that field&rsquo;s items.</li> <li>Create a <code>Style</code> with <code>Workbook.CreateStyle()</code>, configure its font, foreground color, and solid background pattern, and pass the style to <code>PivotTable.Format(area, style)</code>.</li> <li>Each call to the <code>PivotArea</code> overload appends one <code>PivotTableFormat</code> entry to <code>PivotTable.PivotFormats</code>.</li> <li>Field-anchored formats are painted when the pivot data is calculated. Therefore, call <code>PivotTable.CalculateData()</code> after applying the formats so that the styles become visible. The following example builds a small fruit-sales pivot table, styles the <code>Fruit</code> row labels with <code>PivotArea.Select</code> and <code>PivotTableSelectionType.LabelOnly</code>, styles the value cells produced by that same row field with <code>PivotArea.SelectField</code>, and then recalculates the pivot table so both styles are painted.</li> </ol> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html"><span class="cp">&lt;!DOCTYPE html&gt;</span> <span class="p">&lt;</span><span class="nt">html</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">title</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">h1</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">h1</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">button</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;runExample&#34;</span><span class="p">&gt;</span>Run Example<span class="p">&lt;/</span><span class="nt">button</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;downloadLink&#34;</span> <span class="na">style</span><span class="o">=</span><span class="s">&#34;display: none;&#34;</span><span class="p">&gt;</span>Download Result<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;result&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">div</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">src</span><span class="o">=</span><span class="s">&#34;aspose.cells.js.min.js&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">&#34;text/javascript&#34;</span><span class="p">&gt;</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">({</span> <span class="nx">license</span><span class="o">:</span> <span class="s2">&#34;/lic/aspose.cells.enc&#34;</span><span class="p">,</span> <span class="nx">fontPath</span><span class="o">:</span> <span class="s2">&#34;/fonts/&#34;</span><span class="p">,</span> <span class="nx">fontList</span><span class="o">:</span> <span class="p">[</span><span class="s2">&#34;arial.ttf&#34;</span><span class="p">,</span> <span class="s2">&#34;NotoSansSC-Regular.ttf&#34;</span><span class="p">]</span> <span class="p">}).</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Aspose.Cells initialized&#34;</span><span class="p">);</span> <span class="p">});</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;runExample&#39;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s1">&#39;click&#39;</span><span class="p">,</span> <span class="kr">async</span> <span class="p">()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="c1">// Fruit sales data </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Year&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Amount&#34;</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="p">}</span> <span class="c1">// Pivot table with its top-left corner at E3 (row 2, column 4) </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Bold yellow fill on the row field&#39;s label cells </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">labelStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">labelStyle</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isBold</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">labelStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">Color</span><span class="p">.</span><span class="nx">Yellow</span><span class="p">;</span> <span class="nx">labelStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">labelArea</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotArea</span><span class="p">(</span><span class="nx">pivotTable</span><span class="p">);</span> <span class="nx">labelArea</span><span class="p">.</span><span class="nx">select</span><span class="p">(</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotTableSelectionType</span><span class="p">.</span><span class="nx">LabelOnly</span> <span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">labelArea</span><span class="p">,</span> <span class="nx">labelStyle</span><span class="p">);</span> <span class="c1">// Light green fill on the value cells the row field produces </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">valueStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">valueStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">Color</span><span class="p">.</span><span class="nx">LightGreen</span><span class="p">;</span> <span class="nx">valueStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">valueArea</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotArea</span><span class="p">(</span><span class="nx">pivotTable</span><span class="p">);</span> <span class="nx">valueArea</span><span class="p">.</span><span class="nx">selectField</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">valueArea</span><span class="p">,</span> <span class="nx">valueStyle</span><span class="p">);</span> <span class="c1">// Field-anchored formats are painted when the data is calculated </span><span class="c1"></span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Label cells E4:E6 are now bold on yellow, value cells F4:F6 are light green </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">outputData</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">blob</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Blob</span><span class="p">([</span><span class="nx">outputData</span><span class="p">]);</span> <span class="kr">const</span> <span class="nx">downloadLink</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;downloadLink&#39;</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">href</span> <span class="o">=</span> <span class="nx">URL</span><span class="p">.</span><span class="nx">createObjectURL</span><span class="p">(</span><span class="nx">blob</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">download</span> <span class="o">=</span> <span class="s2">&#34;FormatPivotArea.xlsx&#34;</span><span class="p">;</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">display</span> <span class="o">=</span> <span class="s2">&#34;block&#34;</span><span class="p">;</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;result&#39;</span><span class="p">).</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="s1">&#39;&lt;p style=&#34;color: green;&#34;&gt;Done! Click the download link to get the result file.&lt;/p&gt;&#39;</span><span class="p">;</span> <span class="p">});</span> <span class="p">&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">html</span><span class="p">&gt;</span> </code></pre></div><h2 id="format-a-cell-area-of-the-pivot-table"><strong>Format a Cell Area of the Pivot Table</strong></h2> <p>Use <code>PivotTable.Format(CellArea, Style)</code> when the region of interest is a plain worksheet rectangle rather than a semantic pivot region. A <code>CellArea</code> is described by the <code>startRow</code>, <code>startColumn</code>, <code>endRow</code>, and <code>endColumn</code> fields. The values are zero-based worksheet coordinates, and the end coordinates identify the last row and column that are included in the rectangle, so the area covers the cells from the start position through the end position inclusive. Unlike a field-anchored format, a <code>CellArea</code> format is applied to the cells immediately. Another call to <code>CalculateData()</code> is not needed for the style to appear. A <code>CellArea</code> rectangle may contain label cells and value cells together. The next section describes how Aspose.Cells and Excel represent that rectangle internally. The following example formats the rectangle <code>E4:F5</code> of the pivot table with an italic, light-blue style and saves the workbook without any further recalculation.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html"><span class="cp">&lt;!DOCTYPE html&gt;</span> <span class="p">&lt;</span><span class="nt">html</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">title</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">h1</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">h1</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">button</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;runExample&#34;</span><span class="p">&gt;</span>Run Example<span class="p">&lt;/</span><span class="nt">button</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;downloadLink&#34;</span> <span class="na">style</span><span class="o">=</span><span class="s">&#34;display: none;&#34;</span><span class="p">&gt;</span>Download Result<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;result&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">div</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">src</span><span class="o">=</span><span class="s">&#34;aspose.cells.js.min.js&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">&#34;text/javascript&#34;</span><span class="p">&gt;</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">({</span> <span class="nx">license</span><span class="o">:</span> <span class="s2">&#34;/lic/aspose.cells.enc&#34;</span><span class="p">,</span> <span class="nx">fontPath</span><span class="o">:</span> <span class="s2">&#34;/fonts/&#34;</span><span class="p">,</span> <span class="nx">fontList</span><span class="o">:</span> <span class="p">[</span><span class="s2">&#34;arial.ttf&#34;</span><span class="p">,</span> <span class="s2">&#34;NotoSansSC-Regular.ttf&#34;</span><span class="p">]</span> <span class="p">}).</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Aspose.Cells initialized&#34;</span><span class="p">);</span> <span class="p">});</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;runExample&#39;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s1">&#39;click&#39;</span><span class="p">,</span> <span class="kr">async</span> <span class="p">()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Year&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Amount&#34;</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Highlight the first two fruit rows (the rectangle E4:F5) </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">highlightStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isItalic</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">Color</span><span class="p">.</span><span class="nx">LightBlue</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">rectangle</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">CellArea</span><span class="p">();</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">=</span> <span class="mi">3</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">rectangle</span><span class="p">,</span> <span class="nx">highlightStyle</span><span class="p">);</span> <span class="c1">// E4:F5 is italic on light blue immediately, no recalculation needed </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">outputData</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">blob</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Blob</span><span class="p">([</span><span class="nx">outputData</span><span class="p">]);</span> <span class="kr">const</span> <span class="nx">downloadLink</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;downloadLink&#39;</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">href</span> <span class="o">=</span> <span class="nx">URL</span><span class="p">.</span><span class="nx">createObjectURL</span><span class="p">(</span><span class="nx">blob</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">download</span> <span class="o">=</span> <span class="s2">&#34;FormatPivotCellArea.xlsx&#34;</span><span class="p">;</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">display</span> <span class="o">=</span> <span class="s2">&#34;block&#34;</span><span class="p">;</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">&#39;result&#39;</span><span class="p">).</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="s1">&#39;&lt;p style=&#34;color: green;&#34;&gt;Done! Click the download link to get the result file.&lt;/p&gt;&#39;</span><span class="p">;</span> <span class="p">});</span> <span class="p">&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">html</span><span class="p">&gt;</span> </code></pre></div><h2 id="how-pivot-areas-and-cell-areas-map"><strong>How Pivot Areas and Cell Areas Map</strong></h2> <p>Excel stores pivot-table formatting as <code>pivotArea</code> records rather than as ordinary worksheet cell-style records. The same model is used by Aspose.Cells, so a formatting request is translated into pivot areas when it is recorded. The relationship between the <code>CellArea</code> supplied by the user and the pivot areas stored internally is many-to-many in both directions.</p> <ul> <li>One <code>CellArea</code> may produce several pivot areas. If the rectangle spans both label cells and value cells, it is decomposed into separate label and data rules, because the pivot model treats label formatting and data formatting independently.</li> <li>One pivot area may resolve to several disjoint <code>CellArea</code> instances. A semantic region such as a grand-total row, or a field whose items are not contiguous, can cover multiple rectangles. This is why <code>PivotArea.GetCellAreas()</code> returns a collection instead of a single rectangle. Every format operation performed through <code>PivotTable.Format</code> is recorded in <code>PivotTable.PivotFormats</code>. Each <code>PivotTableFormat</code> entry exposes the associated <code>PivotArea</code> and the <code>Style</code> that is applied to it. The <code>PivotArea</code> overload adds exactly one entry per call, while a <code>CellArea</code> that contains different semantic regions can add multiple entries. To distinguish the stored regions, each <code>PivotArea</code> exposes the <code>OnlyLabel</code> and <code>OnlyData</code> flags. The example below formats a single rectangle that covers both labels and values, inspects <code>PivotTable.PivotFormats</code>, and prints the <code>CellArea</code> coordinates that each stored pivot area resolves to.</li> </ul> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html"><span class="cp">&lt;!DOCTYPE html&gt;</span> <span class="p">&lt;</span><span class="nt">html</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">title</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">title</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">head</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">h1</span><span class="p">&gt;</span>Aspose.Cells Example<span class="p">&lt;/</span><span class="nt">h1</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">button</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;runExample&#34;</span><span class="p">&gt;</span>Run Example<span class="p">&lt;/</span><span class="nt">button</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">a</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;downloadLink&#34;</span> <span class="na">style</span><span class="o">=</span><span class="s">&#34;display: none;&#34;</span><span class="p">&gt;</span>Download Result<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">div</span> <span class="na">id</span><span class="o">=</span><span class="s">&#34;result&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">div</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">src</span><span class="o">=</span><span class="s">&#34;aspose.cells.js.min.js&#34;</span><span class="p">&gt;&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;</span><span class="nt">script</span> <span class="na">type</span><span class="o">=</span><span class="s">&#34;text/javascript&#34;</span><span class="p">&gt;</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">CellArea</span><span class="p">,</span> <span class="nx">Color</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">({</span> <span class="nx">license</span><span class="o">:</span> <span class="s2">&#34;/lic/aspose.cells.enc&#34;</span><span class="p">,</span> <span class="nx">fontPath</span><span class="o">:</span> <span class="s2">&#34;/fonts/&#34;</span><span class="p">,</span> <span class="nx">fontList</span><span class="o">:</span> <span class="p">[</span><span class="s2">&#34;arial.ttf&#34;</span><span class="p">,</span> <span class="s2">&#34;NotoSansSC-Regular.ttf&#34;</span><span class="p">]</span> <span class="p">}).</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Aspose.Cells initialized&#34;</span><span class="p">);</span> <span class="p">});</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s2">&#34;runExample&#34;</span><span class="p">).</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s2">&#34;click&#34;</span><span class="p">,</span> <span class="kr">async</span> <span class="p">()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">result</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s2">&#34;result&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">downloadLink</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">getElementById</span><span class="p">(</span><span class="s2">&#34;downloadLink&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Year&#34;</span><span class="p">;</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="s2">&#34;Amount&#34;</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">value</span> <span class="o">=</span> <span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">];</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">highlightStyle</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isItalic</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">LightBlue</span><span class="p">;</span> <span class="nx">highlightStyle</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="c1">// ONE rectangle in... </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">rectangle</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">CellArea</span><span class="p">();</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">=</span> <span class="mi">3</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">=</span> <span class="mi">4</span><span class="p">;</span> <span class="nx">rectangle</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="c1">// ...TWO semantic pivot areas out: the label part and the data part are stored separately </span><span class="c1"></span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">format</span><span class="p">(</span><span class="nx">rectangle</span><span class="p">,</span> <span class="nx">highlightStyle</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">pivotFormats</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">pivotFormats</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">outputLines</span> <span class="o">=</span> <span class="p">[</span><span class="sb">`Stored formats: </span><span class="si">${</span><span class="nx">pivotFormats</span><span class="p">.</span><span class="nx">count</span><span class="si">}</span><span class="sb">`</span><span class="p">];</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">pivotFormats</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">pivotFormat</span> <span class="o">=</span> <span class="nx">pivotFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">storedArea</span> <span class="o">=</span> <span class="nx">pivotFormat</span><span class="p">.</span><span class="nx">pivotArea</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">onlyLabel</span> <span class="o">=</span> <span class="nx">storedArea</span><span class="p">.</span><span class="nx">onlyLabel</span> <span class="o">?</span> <span class="s2">&#34;True&#34;</span> <span class="o">:</span> <span class="s2">&#34;False&#34;</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">onlyData</span> <span class="o">=</span> <span class="nx">storedArea</span><span class="p">.</span><span class="nx">onlyData</span> <span class="o">?</span> <span class="s2">&#34;True&#34;</span> <span class="o">:</span> <span class="s2">&#34;False&#34;</span><span class="p">;</span> <span class="nx">outputLines</span><span class="p">.</span><span class="nx">push</span><span class="p">(</span><span class="sb">`Format </span><span class="si">${</span><span class="nx">i</span><span class="si">}</span><span class="sb">: OnlyLabel=</span><span class="si">${</span><span class="nx">onlyLabel</span><span class="si">}</span><span class="sb">, OnlyData=</span><span class="si">${</span><span class="nx">onlyData</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">resolvedAreas</span> <span class="o">=</span> <span class="nx">storedArea</span><span class="p">.</span><span class="nx">cellAreas</span><span class="p">;</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">j</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">j</span> <span class="o">&lt;</span> <span class="nx">resolvedAreas</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">j</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">resolved</span> <span class="o">=</span> <span class="nx">resolvedAreas</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">j</span><span class="p">);</span> <span class="nx">outputLines</span><span class="p">.</span><span class="nx">push</span><span class="p">(</span> <span class="sb">` rows </span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">-</span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">, columns </span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">-</span><span class="si">${</span><span class="nx">resolved</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="si">}</span><span class="sb">`</span> <span class="p">);</span> <span class="p">}</span> <span class="p">}</span> <span class="c1">// This prints: </span><span class="c1"></span> <span class="c1">// Stored formats: 2 </span><span class="c1"></span> <span class="c1">// Format 0: OnlyLabel=True, OnlyData=False </span><span class="c1"></span> <span class="c1">// rows 4-5, columns 5-5 (E4:E5, the label part) </span><span class="c1"></span> <span class="c1">// Format 1: OnlyLabel=False, OnlyData=True </span><span class="c1"></span> <span class="c1">// rows 4-5, columns 6-6 (F4:F5, the data part) </span><span class="c1"></span> <span class="nx">result</span><span class="p">.</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="sb">`&lt;pre&gt;</span><span class="si">${</span><span class="nx">outputLines</span><span class="p">.</span><span class="nx">join</span><span class="p">(</span><span class="s2">&#34;\n&#34;</span><span class="p">)</span><span class="si">}</span><span class="sb">&lt;/pre&gt;`</span> <span class="o">+</span> <span class="sb">`&lt;p style=&#34;color: green;&#34;&gt;Done! Click the download link to get the result file.&lt;/p&gt;`</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">outputData</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">blob</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Blob</span><span class="p">([</span><span class="nx">outputData</span><span class="p">]);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">href</span> <span class="o">=</span> <span class="nx">URL</span><span class="p">.</span><span class="nx">createObjectURL</span><span class="p">(</span><span class="nx">blob</span><span class="p">);</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">download</span> <span class="o">=</span> <span class="s2">&#34;FormatPivotAreasMap.xlsx&#34;</span><span class="p">;</span> <span class="nx">downloadLink</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nx">display</span> <span class="o">=</span> <span class="s2">&#34;block&#34;</span><span class="p">;</span> <span class="p">});</span> <span class="p">&lt;/</span><span class="nt">script</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">body</span><span class="p">&gt;</span> <span class="p">&lt;/</span><span class="nt">html</span><span class="p">&gt;</span> </code></pre></div> <div class="alert alert-primary" role="alert"> Because the formats are stored as pivot areas rather than as ordinary cell styles, they survive recalculation and refresh. When the pivot table is refreshed with <code>PivotTable.RefreshData</code>, recalculated with <code>CalculateData</code>, or saved and reloaded, every stored pivot area re-resolves to the current position of its region and its style is re-applied. </div> <p>Use a <code>PivotArea</code> built with <code>Select</code> or <code>SelectField</code> when a highlight must remain attached to a field or a semantic region across refreshes, and use a <code>CellArea</code> when formatting a fixed rectangle in the current pivot-table layout is sufficient. The single-cell <code>Format(int row, int column, Style)</code> overload targets an individual cell. Use <code>FormatAll</code>, covered on the parent page, when the entire pivot table should be restyled at once.</p> <h2 id="related-articles"><strong>Related Articles</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/apply-style-to-pivot-table/">Applying Style to Pivot Table</a></li> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/pivot-table-add-row-and-column-fields/">Adding Pivot Table Row and Column Fields</a></li> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/manage-value-fields/">Managing Value Fields in Pivot Table</a></li> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/refresh-pivot-table/">Refreshing Pivot Table</a></li> </ul> <button class="floating-button" id="openModalBtn">AI Document Assistant</button> <div class="modal" id="modal"> <button class="close-btn" id="closeModalBtn">Close</button> <iframe src="https://products.aspose.ai/cells/chat/document/javascript-cpp?source=docs" frameborder="0" width="100%" height="100%"></iframe> </div> <style> .floating-button { position: fixed; bottom: 20px; right: 20px; background-color: #007bff; color: white; border: none; padding: 15px 20px; border-radius: 50px; cursor: pointer; font-size: 16px; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2); z-index: 999; } .modal { display: none; position: fixed; top: 10%; left: 10%; width: 80%; height: 80%; background-color: white; border: none; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.3); z-index: 1000; padding: 20px; box-sizing: border-box; } .close-btn { position: absolute; top: 10px; right: 10px; background-color: #f44336; color: white; border: none; padding: 5px 10px; cursor: pointer; font-size: 16px; border-radius: 3px; } </style> <script> const openModalBtn = document.getElementById('openModalBtn'); const closeModalBtn = document.getElementById('closeModalBtn'); const modal = document.getElementById('modal'); openModalBtn.addEventListener('click', function() { modal.style.display = 'block'; }); closeModalBtn.addEventListener('click', function() { modal.style.display = 'none'; }); window.addEventListener('click', function(event) { if (event.target === modal) { modal.style.display = 'none'; } }); </script> https://docs.aspose.com/cells/javascript-cpp/add-conditional-formatting-to-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/javascript-cpp/add-conditional-formatting-to-pivot-table/ <h2 id="possible-usage-scenarios"><strong>Possible Usage Scenarios</strong></h2> <p>The styles described on the parent page and on the sibling page are static - a <code>PivotArea</code> or <code>CellArea</code> region is painted once and keeps its style no matter what the values are. Conditional formatting is the rule-driven counterpart - highlight every amount above 200, shade the middle fifty percent, or flag the bottom-ranked items - and the highlight follows the values whenever the pivot table is recalculated or refreshed. In Aspose.Cells, pivot-table conditional formatting lives in the <code>pivotTable.conditionalFormats</code> collection. Each entry is a <code>PivotConditionalFormat</code> that answers two questions independently:</p> <ul> <li><strong>Where does the rule apply?</strong> The target region is defined either through <code>applyTo(row, column, scope)</code>, which mirrors the scope picker of the Excel user interface, or through <code>addCellArea(cellArea)</code> and the <code>pivotAreas</code> collection, which name the region explicitly.</li> <li><strong>What does the rule test?</strong> One or more conditions are added to <code>formatConditions</code> with <code>addCondition(type, operatorType, formula1, formula2)</code>, and each condition carries its own <code>style</code>.</li> </ul> <div class="alert alert-primary" role="alert"> Do not call <code>formatConditions.add(cellArea, type, operatorType, formula1, formula2)</code> or <code>formatConditions.addArea(cellArea)</code> on the <code>formatConditions</code> object of a pivot conditional format. These two overloads are inherited from the ordinary worksheet conditional-formatting API and do not work for pivot tables - the cell area is never converted to a pivot area, so the request is silently ignored. Always define the region on the <code>PivotConditionalFormat</code> itself (<code>applyTo</code>, <code>addCellArea</code>, or <code>pivotAreas</code>) and add the rule with one of the <code>addCondition</code> overloads. </div> <h2 id="apply-a-rule-with-a-scope-the-excel-ui-way"><strong>Apply a Rule with a Scope (the Excel UI Way)</strong></h2> <p>The first way positions the rule the way the Excel user interface does. A cell of the pivot table is named by its zero-based worksheet coordinates, and a <code>PivotConditionFormatScopeType</code> scope tells Aspose.Cells how far the rule should reach from that cell:</p> <ul> <li><code>PivotConditionFormatScopeType.Data</code> - all value cells that the pivot table produces, including grand totals.</li> <li><code>PivotConditionFormatScopeType.Field</code> - the value cells that belong to the field the cell identifies, excluding grand totals. The cell must be a field cell such as a row-field label; passing a value cell throws an exception.</li> <li><code>PivotConditionFormatScopeType.Selection</code> - only the value cells at the intersection that the cell selects, typically a single value cell. The example below builds a fruit-sales pivot table whose top-left corner is at E3, anchors a conditional format at cell F4 (row 3, column 5) with the <code>Data</code> scope, and highlights every amount greater than 200 in bold white on red. With the values Apple 220, Banana 330, Cherry 200, and the grand total 750, the rule paints F4, F5, and F7 - the resolved region is the whole data column F4:F7, and only the cells whose value passes the rule light up.</li> </ul> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">PivotFieldType</span><span class="p">,</span> <span class="nx">PivotConditionFormatScopeType</span><span class="p">,</span> <span class="nx">FormatConditionType</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">,</span> <span class="nx">Color</span><span class="p">,</span> <span class="nx">BackgroundType</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Year&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="p">}</span> <span class="c1">// Pivot table with its top-left corner at E3 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Anchor the conditional format at F4 (row 3, column 5) with the Data scope </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">index</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">add</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">index</span><span class="p">);</span> <span class="nx">format</span><span class="p">.</span><span class="nx">applyTo</span><span class="p">(</span><span class="mi">3</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="nx">PivotConditionFormatScopeType</span><span class="p">.</span><span class="nx">Data</span><span class="p">);</span> <span class="c1">// Rule - highlight amounts greater than 200 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">conditionIndex</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">addCondition</span><span class="p">(</span> <span class="nx">FormatConditionType</span><span class="p">.</span><span class="nx">CellValue</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">.</span><span class="nx">GreaterThan</span><span class="p">,</span> <span class="s2">&#34;200&#34;</span><span class="p">,</span> <span class="kc">null</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">style</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isBold</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">color</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">White</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">Red</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">conditionIndex</span><span class="p">).</span><span class="nx">style</span> <span class="o">=</span> <span class="nx">style</span><span class="p">;</span> <span class="c1">// wb.save(SaveFormat.Xlsx) returns the file as bytes </span><span class="c1"></span> <span class="nx">fs</span><span class="p">.</span><span class="nx">writeFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatData.xlsx&#34;</span><span class="p">,</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">));</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Done; the rule paints F4, F5, and F7&#34;</span><span class="p">);</span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><p>Anchoring the same rule at the row-field label E4 (row 3, column 4) with the <code>Field</code> scope resolves to F4:F6 instead - the same data column without the grand-total row - because the scope now describes the <code>Fruit</code> field rather than the whole values area. The <code>Selection</code> scope anchored at F4 resolves to F4 alone.</p> <h2 id="define-the-region-manually"><strong>Define the Region Manually</strong></h2> <p>The second way skips the scope picker and names the region explicitly on the <code>PivotConditionalFormat</code>.</p> <h3 id="a-worksheet-rectangle-with-addcellarea"><strong>A worksheet rectangle with addCellArea</strong></h3> <p><code>addCellArea(cellArea)</code> records the given rectangle as the target of the rule. The coordinates are zero-based worksheet coordinates, and the region is exactly the rectangle supplied - no expansion to the data column and no grand-total logic. Use it when the interesting cells are a known fixed rectangle of the current pivot layout.</p> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">PivotFieldType</span><span class="p">,</span> <span class="nx">FormatConditionType</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">,</span> <span class="nx">Color</span><span class="p">,</span> <span class="nx">BackgroundType</span><span class="p">,</span> <span class="nx">CellArea</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Year&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Target the rectangle F4:F6 (the value cells without the grand total) </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">index</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">add</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">index</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">area</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">CellArea</span><span class="p">();</span> <span class="nx">area</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">=</span> <span class="mi">3</span><span class="p">;</span> <span class="nx">area</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">area</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">area</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">addCellArea</span><span class="p">(</span><span class="nx">area</span><span class="p">);</span> <span class="c1">// Rule - italic on light yellow for amounts between 150 and 300 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">conditionIndex</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">addCondition</span><span class="p">(</span> <span class="nx">FormatConditionType</span><span class="p">.</span><span class="nx">CellValue</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">.</span><span class="nx">Between</span><span class="p">,</span> <span class="s2">&#34;150&#34;</span><span class="p">,</span> <span class="s2">&#34;300&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">style</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isItalic</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">LightYellow</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">conditionIndex</span><span class="p">).</span><span class="nx">style</span> <span class="o">=</span> <span class="nx">style</span><span class="p">;</span> <span class="nx">fs</span><span class="p">.</span><span class="nx">writeFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatCellArea.xlsx&#34;</span><span class="p">,</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">));</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Done; the rule paints F4 and F6&#34;</span><span class="p">);</span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><h3 id="a-semantic-pivot-region-with-pivotareas"><strong>A semantic pivot region with pivotAreas</strong></h3> <p><code>pivotAreas</code> is the same semantic-region model that the sibling page uses for static styles. Build a <code>PivotArea</code>, select a field or region with <code>select</code> or <code>selectField</code>, and add it with <code>pivotAreas.addPivotArea(pivotArea)</code>. A semantic region stays attached to its field, so the conditional format follows the field when the pivot table is refreshed and the layout shifts. The <code>pivotAreas.add(pivotArea)</code> overload still runs but is marked obsolete - prefer <code>addPivotArea</code>.</p> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">PivotFieldType</span><span class="p">,</span> <span class="nx">PivotArea</span><span class="p">,</span> <span class="nx">FormatConditionType</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">,</span> <span class="nx">Color</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Year&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Attach the rule to the Amount data field as a semantic region </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">index</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">add</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">index</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">area</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">PivotArea</span><span class="p">(</span><span class="nx">pivotTable</span><span class="p">);</span> <span class="nx">area</span><span class="p">.</span><span class="nx">selectField</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">format</span><span class="p">.</span><span class="nx">pivotAreas</span><span class="p">.</span><span class="nx">addPivotArea</span><span class="p">(</span><span class="nx">area</span><span class="p">);</span> <span class="c1">// Rule - grey text for amounts below 150 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">conditionIndex</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">addCondition</span><span class="p">(</span> <span class="nx">FormatConditionType</span><span class="p">.</span><span class="nx">CellValue</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">.</span><span class="nx">LessThan</span><span class="p">,</span> <span class="s2">&#34;150&#34;</span><span class="p">,</span> <span class="kc">null</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">style</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">color</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">Gray</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">conditionIndex</span><span class="p">).</span><span class="nx">style</span> <span class="o">=</span> <span class="nx">style</span><span class="p">;</span> <span class="nx">fs</span><span class="p">.</span><span class="nx">writeFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatPivotArea.xlsx&#34;</span><span class="p">,</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">));</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Done; the rule is attached to the Amount value cells&#34;</span><span class="p">);</span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><h2 id="where-the-rules-are-stored-and-how-they-survive-a-reload"><strong>Where the Rules Are Stored and How They Survive a Reload</strong></h2> <p>Every <code>conditionalFormats.add()</code> call appends one <code>PivotConditionalFormat</code> to the pivot table. The conditions, their formulas, and their styles are saved with the workbook - reopening the file saved by the first example in Node shows the same rule with its type, operator, and formula intact, and <code>getCellAreas()</code> reports the same region. On this platform the <code>type</code> and <code>operator</code> properties of a condition surface as the numeric enum values. Entries that never received a condition are dropped when the workbook is saved, the same way Excel discards a conditional format that has no rule.</p> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="c1">// Reload the file written by the first example </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">(</span><span class="k">new</span> <span class="nx">Uint8Array</span><span class="p">(</span><span class="nx">fs</span><span class="p">.</span><span class="nx">readFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatData.xlsx&#34;</span><span class="p">)));</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">).</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Conditional formats: &#34;</span> <span class="o">+</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">count</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">j</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">j</span> <span class="o">&lt;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">j</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">condition</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">j</span><span class="p">);</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Format &#34;</span> <span class="o">+</span> <span class="nx">i</span> <span class="o">+</span> <span class="s2">&#34;: &#34;</span> <span class="o">+</span> <span class="nx">condition</span><span class="p">.</span><span class="nx">type</span> <span class="o">+</span> <span class="s2">&#34; &#34;</span> <span class="o">+</span> <span class="nx">condition</span><span class="p">.</span><span class="nx">operator</span> <span class="o">+</span> <span class="s2">&#34; formula1=&#34;</span> <span class="o">+</span> <span class="nx">condition</span><span class="p">.</span><span class="nx">formula1</span><span class="p">);</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">areas</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">getCellAreas</span><span class="p">();</span> <span class="k">for</span> <span class="p">(</span><span class="kr">const</span> <span class="nx">area</span> <span class="k">of</span> <span class="nx">areas</span><span class="p">)</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34; rows &#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&#34;-&#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&#34;, columns &#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&#34;-&#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="p">));</span> <span class="p">}</span> <span class="c1">// This prints: </span><span class="c1"></span> <span class="c1">// Conditional formats: 1 </span><span class="c1"></span> <span class="c1">// Format 0: 1 2 formula1==200 (type 1 = CellValue, operator 2 = GreaterThan) </span><span class="c1"></span> <span class="c1">// rows 4-7, columns 6-6 (F4:F7, the resolved data region) </span><span class="c1"></span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><h2 id="related-articles"><strong>Related Articles</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/apply-style-to-pivot-table/">Applying Style to Pivot Table</a></li> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/format-part-of-pivot-table/">Format Part of a Pivot Table</a></li> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/top-10-show-or-filter-in-pivot-table/">Top 10 Show or Filter in Pivot Table</a></li> <li><a href="https://docs.aspose.com/cells/cells/javascript-cpp/filter-by-label-or-value-of-pivot-table/">Filtering Pivot Tables by Label or Value</a></li> </ul> <button class="floating-button" id="openModalBtn">AI Document Assistant</button> <div class="modal" id="modal"> <button class="close-btn" id="closeModalBtn">Close</button> <iframe src="https://products.aspose.ai/cells/chat/document/javascript-cpp?source=docs" frameborder="0" width="100%" height="100%"></iframe> </div> <style> .floating-button { position: fixed; bottom: 20px; right: 20px; background-color: #007bff; color: white; border: none; padding: 15px 20px; border-radius: 50px; cursor: pointer; font-size: 16px; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2); z-index: 999; } .modal { display: none; position: fixed; top: 10%; left: 10%; width: 80%; height: 80%; background-color: white; border: none; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.3); z-index: 1000; padding: 20px; box-sizing: border-box; } .close-btn { position: absolute; top: 10px; right: 10px; background-color: #f44336; color: white; border: none; padding: 5px 10px; cursor: pointer; font-size: 16px; border-radius: 3px; } </style> <script> const openModalBtn = document.getElementById('openModalBtn'); const closeModalBtn = document.getElementById('closeModalBtn'); const modal = document.getElementById('modal'); openModalBtn.addEventListener('click', function() { modal.style.display = 'block'; }); closeModalBtn.addEventListener('click', function() { modal.style.display = 'none'; }); window.addEventListener('click', function(event) { if (event.target === modal) { modal.style.display = 'none'; } }); </script>