https://docs.aspose.com/cells/es/javascript-cpp/apply-style-to-pivot-table/ Recent content in Aplicar estilos a tablas dinámicas en Aspose.Cells for JavaScript via C++ on Documentation Hugo -- gohugo.io es https://docs.aspose.com/cells/es/javascript-cpp/format-part-of-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/es/javascript-cpp/format-part-of-pivot-table/ <h2 id="escenarios-de-uso-posibles"><strong>Escenarios de uso posibles</strong></h2> <p><code>PivotTable.FormatAll</code> aplica un solo estilo a toda la tabla dinámica y se cubre en la página principal. No distingue entre etiquetas, valores, totales o regiones particulares del informe.<br> En la práctica, solo una parte de una tabla dinámica suele necesitar resaltarse. Los objetivos comunes incluyen las etiquetas pertenecientes a un campo de fila, las celdas de valor producidas por un campo, la fila de total general o un rectángulo arbitrario como las dos primeras filas de ítems.<br> Aplicar un estilo directamente a las celdas de la hoja de cálculo de una tabla dinámica no es equivalente. Excel almacena el formato de la tabla dinámica como regiones semánticas <code>PivotArea</code> en lugar de registros ordinarios de estilo de celda. Un formato de área de pivote permanece vinculado a una región como las etiquetas de un campo o los valores de datos, y se vuelve a resolver cuando la tabla dinámica se recalcula, actualiza o expande. Un estilo escrito directamente en una celda, por otro lado, pertenece a esa posición de celda y no es rastreado por el modelo de pivote.<br> Aspose.Cells expone toda la familia de sobrecargas <code>PivotTable.Format</code> para que ambos tipos de formato estén disponibles:</p> <ul> <li><code>Format(PivotArea, Style)</code> ancla un estilo a una región semántica que se construye con <code>PivotArea.Select</code> o <code>PivotArea.SelectField</code>.</li> <li><code>Format(CellArea, Style)</code> ancla un estilo a un rectángulo de hoja de cálculo dentro de la tabla dinámica.</li> <li><code>Format(int row, int column, Style)</code> apunta a una sola celda.</li> <li><code>FormatAll(Style)</code> formatea toda la tabla dinámica.</li> </ul> <h2 id="formatear-un-área-de-pivote"><strong>Formatear un Área de Pivote</strong></h2> <p>El flujo de trabajo de área semántica es el enfoque recomendado cuando un resaltado debe seguir a un campo o a una región del informe.</p> <ol> <li>Cree un <code>PivotArea</code> con <code>new PivotArea(pivotTable)</code>. El objeto describe una región semántica que pertenece a esa tabla dinámica específica.</li> <li>Seleccione un campo por su posición basada en cero en un eje dado con <code>PivotArea.Select(PivotFieldType axisType, int fieldPosition, PivotTableSelectionType selectionType)</code>. <ul> <li><code>PivotTableSelectionType.DataAndLabel</code> selecciona tanto las etiquetas como los datos del campo.</li> <li><code>PivotTableSelectionType.LabelOnly</code> selecciona solo las etiquetas del campo.</li> <li><code>PivotTableSelectionType.DataOnly</code> selecciona solo las celdas de datos del campo.</li> </ul> </li> <li>Seleccione un campo por nombre con <code>PivotArea.SelectField(PivotFieldType axisType, string fieldName)</code>. Cuando se selecciona un campo de fila por nombre, la región se resuelve a las celdas de valor producidas por los ítems de ese campo.</li> <li>Cree un <code>Style</code> con <code>Workbook.CreateStyle()</code>, configure su fuente, color de primer plano y patrón de fondo sólido, y pase el estilo a <code>PivotTable.Format(area, style)</code>.</li> <li>Cada llamada a la sobrecarga <code>PivotArea</code> agrega una entrada <code>PivotTableFormat</code> a <code>PivotTable.PivotFormats</code>.</li> <li>Los formatos anclados a campos se pintan cuando se calculan los datos del pivote. Por lo tanto, llame a <code>PivotTable.CalculateData()</code> después de aplicar los formatos para que los estilos se vuelvan visibles.<br> El siguiente ejemplo construye una pequeña tabla dinámica de ventas de frutas, aplica estilo a las etiquetas de fila <code>Fruit</code> con <code>PivotArea.Select</code> y <code>PivotTableSelectionType.LabelOnly</code>, aplica estilo a las celdas de valor producidas por ese mismo campo de fila con <code>PivotArea.SelectField</code>, y luego recalcula la tabla dinámica para que ambos estilos se pinten.</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="formatear-un-cell-area-de-la-tabla-dinámica"><strong>Formatear un Cell Area de la tabla dinámica</strong></h2> <p>Utilice <code>PivotTable.Format(CellArea, Style)</code> cuando la región de interés sea un rectángulo simple de hoja de cálculo y no una región semántica de pivote.<br> Un <code>CellArea</code> se describe mediante los campos <code>startRow</code>, <code>startColumn</code>, <code>endRow</code> y <code>endColumn</code>. Los valores son coordenadas de hoja basadas en cero, y las coordenadas finales identifican la última fila y columna incluidas en el rectángulo, de modo que el área cubre las celdas desde la posición inicial hasta la posición final inclusive.<br> A diferencia de un formato anclado a un campo, un formato <code>CellArea</code> se aplica a las celdas inmediatamente. No se necesita otra llamada a <code>CalculateData()</code> para que el estilo aparezca.<br> Un rectángulo <code>CellArea</code> puede contener celdas de etiqueta y celdas de valor juntas. La siguiente sección describe cómo Aspose.Cells y Excel representan internamente ese rectángulo.<br> El siguiente ejemplo formatea el rectángulo <code>E4:F5</code> de la tabla dinámica con un estilo cursiva, azul claro y guarda el libro sin necesidad de recalcular nuevamente.</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="cómo-se-asignan-las-áreas-pivot-y-cell"><strong>Cómo se asignan las áreas Pivot y Cell</strong></h2> <p>Excel almacena el formato de la tabla dinámica como registros <code>pivotArea</code> en lugar de registros ordinarios de estilo de celda de hoja de cálculo. El mismo modelo es utilizado por Aspose.Cells, de modo que una solicitud de formato se traduce en áreas de pivote cuando se registra.<br> La relación entre el <code>CellArea</code> proporcionado por el usuario y las áreas de pivote almacenadas internamente es de muchos a muchos en ambas direcciones.</p> <ul> <li>Un <code>CellArea</code> puede producir varias áreas de pivote. Si el rectángulo abarca tanto celdas de etiqueta como celdas de valor, se descompone en reglas separadas de etiqueta y datos, porque el modelo de pivote trata el formato de etiquetas y el de datos de forma independiente.</li> <li>Un área de pivote puede resolverse en varias instancias <code>CellArea</code> disjuntas. Una región semántica como una fila de total general, o un campo cuyos ítems no son contiguos, puede cubrir múltiples rectángulos. Por eso <code>PivotArea.GetCellAreas()</code> devuelve una colección en lugar de un solo rectángulo. Cada operación de formato realizada a través de <code>PivotTable.Format</code> se registra en <code>PivotTable.PivotFormats</code>. Cada entrada <code>PivotTableFormat</code> expone el <code>PivotArea</code> asociado y el <code>Style</code> que se le aplicó. La sobrecarga <code>PivotArea</code> agrega exactamente una entrada por llamada, mientras que un <code>CellArea</code> que contiene diferentes regiones semánticas puede añadir varias entradas.<br> Para distinguir las regiones almacenadas, cada <code>PivotArea</code> expone los indicadores <code>OnlyLabel</code> y <code>OnlyData</code>. El ejemplo a continuación formatea un solo rectángulo que cubre tanto etiquetas como valores, inspecciona <code>PivotTable.PivotFormats</code> y muestra las coordenadas <code>CellArea</code> a las que cada área de pivote almacenada se resuelve.</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"> Debido a que los formatos se almacenan como áreas de pivote en lugar de como estilos de celda ordinarios, sobreviven a la recalculación y actualización. Cuando la tabla dinámica se actualiza con <code>PivotTable.RefreshData</code>, se recalcula con <code>CalculateData</code>, o se guarda y vuelve a cargar, cada área de pivote almacenada se vuelve a resolver a la posición actual de su región y su estilo se vuelve a aplicar. </div> <p>Utilice un <code>PivotArea</code> construido con <code>Select</code> o <code>SelectField</code> cuando un resaltado deba permanecer adjunto a un campo o a una región semántica a través de actualizaciones, y use un <code>CellArea</code> cuando sea suficiente formatear un rectángulo fijo en el diseño actual de la tabla dinámica. La sobrecarga de una sola celda <code>Format(int row, int column, Style)</code> apunta a una celda individual. Use <code>FormatAll</code>, cubierto en la página principal, cuando toda la tabla dinámica deba volver a estilizarse de una vez.</p> <h2 id="artículos-relacionados"><strong>Artículos relacionados</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/apply-style-to-pivot-table/">Aplicar estilo a la tabla dinámica</a></li> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/pivot-table-add-row-and-column-fields/">Agregar campos de fila y columna a la tabla dinámica</a></li> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/manage-value-fields/">Administrar campos de valor en la tabla dinámica</a></li> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/refresh-pivot-table/">Actualizar la tabla dinámica</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/es/javascript-cpp/add-conditional-formatting-to-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/es/javascript-cpp/add-conditional-formatting-to-pivot-table/ <h2 id="escenarios-de-uso-posibles"><strong>Escenarios de uso posibles</strong></h2> <p>Los estilos descritos en la página principal y en la página hermana son estáticos: una región <code>PivotArea</code> o <code>CellArea</code> se pinta una vez y mantiene su estilo sin importar los valores. El formato condicional es la contraparte basada en reglas: resaltar cada cantidad superior a 200, sombrear el cincuenta por ciento medio o marcar los elementos con menor rango, y el resaltado sigue a los valores cada vez que la tabla dinámica se recalcula o se actualiza.<br> En Aspose.Cells, el formato condicional de tabla dinámica vive en la colección <code>pivotTable.conditionalFormats</code>. Cada entrada es un <code>PivotConditionalFormat</code> que responde a dos preguntas de forma independiente:</p> <ul> <li><strong>¿Dónde se aplica la regla?</strong> La región objetivo se define ya sea mediante <code>applyTo(row, column, scope)</code>, que refleja el selector de alcance de la interfaz de usuario de Excel, o mediante <code>addCellArea(cellArea)</code> y la colección <code>pivotAreas</code>, que nombran la región explícitamente.</li> <li><strong>¿Qué evalúa la regla?</strong> Una o más condiciones se añaden a <code>formatConditions</code> con <code>addCondition(type, operatorType, formula1, formula2)</code>, y cada condición lleva su propio <code>style</code>.</li> </ul> <div class="alert alert-primary" role="alert"> No llame a <code>formatConditions.add(cellArea, type, operatorType, formula1, formula2)</code> o <code>formatConditions.addArea(cellArea)</code> en el objeto <code>formatConditions</code> de un formato condicional de pivote. Estas dos sobrecargas se heredan de la API de formato condicional ordinaria de la hoja de cálculo y no funcionan para tablas dinámicas: el área de celda nunca se convierte en un área de pivote, por lo que la solicitud se ignora silenciosamente. Siempre defina la región en el propio <code>PivotConditionalFormat</code> (<code>applyTo</code>, <code>addCellArea</code> o <code>pivotAreas</code>) y añada la regla con una de las sobrecargas de <code>addCondition</code>. </div> <h2 id="aplicar-una-regla-con-un-alcance-la-forma-de-la-ui-de-excel"><strong>Aplicar una regla con un alcance (la forma de la UI de Excel)</strong></h2> <p>La primera manera coloca la regla como lo hace la interfaz de usuario de Excel. Una celda de la tabla dinámica se nombra por sus coordenadas de hoja de cálculo basadas en cero, y un alcance <code>PivotConditionFormatScopeType</code> indica an Aspose.Cells hasta dónde debe llegar la regla desde esa celda:</p> <ul> <li><code>PivotConditionFormatScopeType.Data</code> - todas las celdas de valor que genera la tabla dinámica, incluidos los totales generales.</li> <li><code>PivotConditionFormatScopeType.Field</code> - las celdas de valor que pertenecen al campo que identifica la celda, excluyendo los totales generales. La celda debe ser una celda de campo, como una etiqueta de fila de campo; proporcionar una celda de valor genera una excepción.</li> <li><code>PivotConditionFormatScopeType.Selection</code> - solo las celdas de valor en la intersección que la celda selecciona, típicamente una única celda de valor. El ejemplo a continuación crea una tabla dinámica de ventas de frutas cuya esquina superior izquierda está en E3, ancla un formato condicional en la celda F4 (fila 3, columna 5) con el alcance <code>Data</code>, y resalta cada cantidad mayor a 200 en blanco negrita sobre rojo. Con los valores Manzana 220, Plátano 330, Cereza 200 y el total general 750, la regla colorea F4, F5 y F7; la región resuelta es toda la columna de datos F4:F7, y solo las celdas cuyo valor cumple la regla se iluminan.</li> </ul> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); const { Workbook, SaveFormat, PivotFieldType, PivotConditionFormatScopeType, FormatConditionType, OperatorType, Color, BackgroundType } = AsposeCells; AsposeCells.onReady().then(() =&gt; { const workbook = new Workbook(); const sheet = workbook.worksheets.get(0); const cells = sheet.cells; const fruits = [&#34;Apple&#34;, &#34;Banana&#34;, &#34;Apple&#34;, &#34;Banana&#34;, &#34;Cherry&#34;, &#34;Cherry&#34;]; const years = [2024, 2024, 2025, 2025, 2024, 2025]; const amounts = [100, 150, 120, 180, 90, 110]; cells.get(&#34;A1&#34;).putValue(&#34;Fruit&#34;); cells.get(&#34;B1&#34;).putValue(&#34;Year&#34;); cells.get(&#34;C1&#34;).putValue(&#34;Amount&#34;); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">fruits.length</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">0</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">fruits</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">1</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">years</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">2</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">amounts</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="err">}</span> <span class="err">//</span> <span class="na">Tabla</span> <span class="na">dinámica</span> <span class="na">con</span> <span class="na">su</span> <span class="na">esquina</span> <span class="na">superior</span> <span class="na">izquierda</span> <span class="na">en</span> <span class="na">E3</span> <span class="na">const</span> <span class="na">pivotTable </span><span class="o">=</span> <span class="s">sheet.pivotTables.add(&#34;=A1:C7&#34;,</span> <span class="na">2</span><span class="err">,</span> <span class="na">4</span><span class="err">);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Row</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Fruit</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">calculateData</span><span class="err">();</span> <span class="err">//</span> <span class="na">Anclar</span> <span class="na">el</span> <span class="na">formato</span> <span class="na">condicional</span> <span class="na">en</span> <span class="na">F4</span> <span class="err">(</span><span class="na">fila</span> <span class="na">3</span><span class="err">,</span> <span class="na">columna</span> <span class="na">5</span><span class="err">)</span> <span class="na">con</span> <span class="na">el</span> <span class="na">alcance</span> <span class="na">Data</span> <span class="na">const</span> <span class="na">index </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.add();</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(index);</span> <span class="na">format</span><span class="err">.</span><span class="na">applyTo</span><span class="err">(</span><span class="na">3</span><span class="err">,</span> <span class="na">5</span><span class="err">,</span> <span class="na">PivotConditionFormatScopeType</span><span class="err">.</span><span class="na">Data</span><span class="err">);</span> <span class="err">//</span> <span class="na">Regla</span> <span class="na">-</span> <span class="na">resaltar</span> <span class="na">cantidades</span> <span class="na">mayores</span> <span class="na">a</span> <span class="na">200</span> <span class="na">const</span> <span class="na">conditionIndex </span><span class="o">=</span> <span class="s">format.formatConditions.addCondition(</span> <span class="na">FormatConditionType</span><span class="err">.</span><span class="na">CellValue</span><span class="err">,</span> <span class="na">OperatorType</span><span class="err">.</span><span class="na">GreaterThan</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">200</span><span class="err">&#34;,</span> <span class="na">null</span><span class="err">);</span> <span class="na">const</span> <span class="na">style </span><span class="o">=</span> <span class="s">workbook.createStyle();</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">isBold </span><span class="o">=</span> <span class="s">true;</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">color </span><span class="o">=</span> <span class="s">Color.White;</span> <span class="na">style</span><span class="err">.</span><span class="na">foregroundColor </span><span class="o">=</span> <span class="s">Color.Red;</span> <span class="na">style</span><span class="err">.</span><span class="na">pattern </span><span class="o">=</span> <span class="s">BackgroundType.Solid;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">conditionIndex</span><span class="err">).</span><span class="na">style </span><span class="o">=</span> <span class="s">style;</span> <span class="err">//</span> <span class="na">wb</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">)</span> <span class="na">devuelve</span> <span class="na">el</span> <span class="na">archivo</span> <span class="na">como</span> <span class="na">bytes</span> <span class="na">fs</span><span class="err">.</span><span class="na">writeFileSync</span><span class="err">(&#34;</span><span class="na">PivotConditionalFormatData</span><span class="err">.</span><span class="na">xlsx</span><span class="err">&#34;,</span> <span class="na">workbook</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">));</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Done</span><span class="err">;</span> <span class="na">the</span> <span class="na">rule</span> <span class="na">paints</span> <span class="na">F4</span><span class="err">,</span> <span class="na">F5</span><span class="err">,</span> <span class="na">and</span> <span class="na">F7</span><span class="err">&#34;);</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><p>Anclar la misma regla en la etiqueta de fila de campo E4 (fila 3, columna 4) con el alcance <code>Field</code> se resuelve a F4:F6 en su lugar — la misma columna de datos sin la fila de total general — porque el alcance ahora describe el campo <code>Fruit</code> en lugar de todo el área de valores. El alcance <code>Selection</code> anclado en F4 se resuelve únicamente a F4.</p> <h2 id="definir-la-región-manualmente"><strong>Definir la región manualmente</strong></h2> <h3 id="un-rectángulo-de-hoja-de-cálculo-con-addcellarea"><strong>Un rectángulo de hoja de cálculo con addCellArea</strong></h3> <p><code>addCellArea(cellArea)</code> registra el rectángulo proporcionado como el objetivo de la regla. Las coordenadas son coordenadas de hoja de cálculo basadas en cero, y la región es exactamente el rectángulo suministrado — sin expansión a la columna de datos y sin lógica de totales generales. Úselo cuando las celdas de interés son un rectángulo fijo conocido del diseño actual de la tabla dinámica.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); const { Workbook, SaveFormat, PivotFieldType, FormatConditionType, OperatorType, Color, BackgroundType, CellArea } = AsposeCells; AsposeCells.onReady().then(() =&gt; { const workbook = new Workbook(); const sheet = workbook.worksheets.get(0); const cells = sheet.cells; const fruits = [&#34;Apple&#34;, &#34;Banana&#34;, &#34;Apple&#34;, &#34;Banana&#34;, &#34;Cherry&#34;, &#34;Cherry&#34;]; const years = [2024, 2024, 2025, 2025, 2024, 2025]; const amounts = [100, 150, 120, 180, 90, 110]; cells.get(&#34;A1&#34;).putValue(&#34;Fruit&#34;); cells.get(&#34;B1&#34;).putValue(&#34;Year&#34;); cells.get(&#34;C1&#34;).putValue(&#34;Amount&#34;); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">fruits.length</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">0</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">fruits</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">1</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">years</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">2</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">amounts</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="err">}</span> <span class="na">const</span> <span class="na">pivotTable </span><span class="o">=</span> <span class="s">sheet.pivotTables.add(&#34;=A1:C7&#34;,</span> <span class="na">2</span><span class="err">,</span> <span class="na">4</span><span class="err">);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Row</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Fruit</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">calculateData</span><span class="err">();</span> <span class="err">//</span> <span class="na">Apuntar</span> <span class="na">al</span> <span class="na">rectángulo</span> <span class="na">F4:F6</span> <span class="err">(</span><span class="na">las</span> <span class="na">celdas</span> <span class="na">de</span> <span class="na">valor</span> <span class="na">sin</span> <span class="na">el</span> <span class="na">total</span> <span class="na">general</span><span class="err">)</span> <span class="na">const</span> <span class="na">index </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.add();</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(index);</span> <span class="na">const</span> <span class="na">area </span><span class="o">=</span> <span class="s">new</span> <span class="na">CellArea</span><span class="err">();</span> <span class="na">area</span><span class="err">.</span><span class="na">startRow </span><span class="o">=</span> <span class="s">3;</span> <span class="na">area</span><span class="err">.</span><span class="na">startColumn </span><span class="o">=</span> <span class="s">5;</span> <span class="na">area</span><span class="err">.</span><span class="na">endRow </span><span class="o">=</span> <span class="s">5;</span> <span class="na">area</span><span class="err">.</span><span class="na">endColumn </span><span class="o">=</span> <span class="s">5;</span> <span class="na">format</span><span class="err">.</span><span class="na">addCellArea</span><span class="err">(</span><span class="na">area</span><span class="err">);</span> <span class="err">//</span> <span class="na">Regla</span> <span class="na">-</span> <span class="na">cursiva</span> <span class="na">en</span> <span class="na">amarillo</span> <span class="na">claro</span> <span class="na">para</span> <span class="na">montos</span> <span class="na">entre</span> <span class="na">150</span> <span class="na">y</span> <span class="na">300</span> <span class="na">const</span> <span class="na">conditionIndex </span><span class="o">=</span> <span class="s">format.formatConditions.addCondition(</span> <span class="na">FormatConditionType</span><span class="err">.</span><span class="na">CellValue</span><span class="err">,</span> <span class="na">OperatorType</span><span class="err">.</span><span class="na">Between</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">150</span><span class="err">&#34;,</span> <span class="err">&#34;</span><span class="na">300</span><span class="err">&#34;);</span> <span class="na">const</span> <span class="na">style </span><span class="o">=</span> <span class="s">workbook.createStyle();</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">isItalic </span><span class="o">=</span> <span class="s">true;</span> <span class="na">style</span><span class="err">.</span><span class="na">foregroundColor </span><span class="o">=</span> <span class="s">Color.LightYellow;</span> <span class="na">style</span><span class="err">.</span><span class="na">pattern </span><span class="o">=</span> <span class="s">BackgroundType.Solid;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">conditionIndex</span><span class="err">).</span><span class="na">style </span><span class="o">=</span> <span class="s">style;</span> <span class="na">fs</span><span class="err">.</span><span class="na">writeFileSync</span><span class="err">(&#34;</span><span class="na">PivotConditionalFormatCellArea</span><span class="err">.</span><span class="na">xlsx</span><span class="err">&#34;,</span> <span class="na">workbook</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">));</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Done</span><span class="err">;</span> <span class="na">the</span> <span class="na">rule</span> <span class="na">paints</span> <span class="na">F4</span> <span class="na">and</span> <span class="na">F6</span><span class="err">&#34;);</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><h3 id="una-región-pivot-semántica-con-pivotareas"><strong>Una región pivot semántica con pivotAreas</strong></h3> <p><code>pivotAreas</code> es el mismo modelo de región semántica que la página hermana utiliza para estilos estáticos. Construya un <code>PivotArea</code>, seleccione un campo o región con <code>select</code> o <code>selectField</code>, y añádalo con <code>pivotAreas.addPivotArea(pivotArea)</code>. Una región semántica permanece adjunta a su campo, por lo que el formato condicional sigue al campo cuando la tabla dinámica se actualiza y el diseño cambia. La sobrecarga <code>pivotAreas.add(pivotArea)</code> sigue funcionando pero está marcada como obsoleta — prefiera <code>addPivotArea</code>.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); const { Workbook, SaveFormat, PivotFieldType, PivotArea, FormatConditionType, OperatorType, Color } = AsposeCells; AsposeCells.onReady().then(() =&gt; { const workbook = new Workbook(); const sheet = workbook.worksheets.get(0); const cells = sheet.cells; const fruits = [&#34;Apple&#34;, &#34;Banana&#34;, &#34;Apple&#34;, &#34;Banana&#34;, &#34;Cherry&#34;, &#34;Cherry&#34;]; const years = [2024, 2024, 2025, 2025, 2024, 2025]; const amounts = [100, 150, 120, 180, 90, 110]; cells.get(&#34;A1&#34;).putValue(&#34;Fruit&#34;); cells.get(&#34;B1&#34;).putValue(&#34;Year&#34;); cells.get(&#34;C1&#34;).putValue(&#34;Amount&#34;); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">fruits.length</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">0</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">fruits</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">1</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">years</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="na">cells</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">i</span> <span class="err">+</span> <span class="na">1</span><span class="err">,</span> <span class="na">2</span><span class="err">).</span><span class="na">putValue</span><span class="err">(</span><span class="na">amounts</span><span class="err">[</span><span class="na">i</span><span class="err">]);</span> <span class="err">}</span> <span class="na">const</span> <span class="na">pivotTable </span><span class="o">=</span> <span class="s">sheet.pivotTables.add(&#34;=A1:C7&#34;,</span> <span class="na">2</span><span class="err">,</span> <span class="na">4</span><span class="err">);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Row</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Fruit</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">addFieldToArea</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">pivotTable</span><span class="err">.</span><span class="na">calculateData</span><span class="err">();</span> <span class="err">//</span> <span class="na">Adjuntar</span> <span class="na">la</span> <span class="na">regla</span> <span class="na">al</span> <span class="na">campo</span> <span class="na">de</span> <span class="na">datos</span> <span class="na">Amount</span> <span class="na">como</span> <span class="na">una</span> <span class="na">región</span> <span class="na">semántica</span> <span class="na">const</span> <span class="na">index </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.add();</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(index);</span> <span class="na">const</span> <span class="na">area </span><span class="o">=</span> <span class="s">new</span> <span class="na">PivotArea</span><span class="err">(</span><span class="na">pivotTable</span><span class="err">);</span> <span class="na">area</span><span class="err">.</span><span class="na">selectField</span><span class="err">(</span><span class="na">PivotFieldType</span><span class="err">.</span><span class="na">Data</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">Amount</span><span class="err">&#34;);</span> <span class="na">format</span><span class="err">.</span><span class="na">pivotAreas</span><span class="err">.</span><span class="na">addPivotArea</span><span class="err">(</span><span class="na">area</span><span class="err">);</span> <span class="err">//</span> <span class="na">Regla</span> <span class="na">-</span> <span class="na">texto</span> <span class="na">gris</span> <span class="na">para</span> <span class="na">montos</span> <span class="na">menores</span> <span class="na">a</span> <span class="na">150</span> <span class="na">const</span> <span class="na">conditionIndex </span><span class="o">=</span> <span class="s">format.formatConditions.addCondition(</span> <span class="na">FormatConditionType</span><span class="err">.</span><span class="na">CellValue</span><span class="err">,</span> <span class="na">OperatorType</span><span class="err">.</span><span class="na">LessThan</span><span class="err">,</span> <span class="err">&#34;</span><span class="na">150</span><span class="err">&#34;,</span> <span class="na">null</span><span class="err">);</span> <span class="na">const</span> <span class="na">style </span><span class="o">=</span> <span class="s">workbook.createStyle();</span> <span class="na">style</span><span class="err">.</span><span class="na">font</span><span class="err">.</span><span class="na">color </span><span class="o">=</span> <span class="s">Color.Gray;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">get</span><span class="err">(</span><span class="na">conditionIndex</span><span class="err">).</span><span class="na">style </span><span class="o">=</span> <span class="s">style;</span> <span class="na">fs</span><span class="err">.</span><span class="na">writeFileSync</span><span class="err">(&#34;</span><span class="na">PivotConditionalFormatPivotArea</span><span class="err">.</span><span class="na">xlsx</span><span class="err">&#34;,</span> <span class="na">workbook</span><span class="err">.</span><span class="na">save</span><span class="err">(</span><span class="na">SaveFormat</span><span class="err">.</span><span class="na">Xlsx</span><span class="err">));</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Done</span><span class="err">;</span> <span class="na">the</span> <span class="na">rule</span> <span class="na">is</span> <span class="na">attached</span> <span class="na">to</span> <span class="na">the</span> <span class="na">Amount</span> <span class="na">value</span> <span class="na">cells</span><span class="err">&#34;);</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><h2 id="dónde-se-almacenan-las-reglas-y-cómo-sobreviven-a-una-recarga"><strong>Dónde se almacenan las reglas y cómo sobreviven a una recarga</strong></h2> <p>Cada llamada a <code>conditionalFormats.add()</code> agrega un <code>PivotConditionalFormat</code> a la tabla dinámica. Las condiciones, sus fórmulas y sus estilos se guardan con el libro de trabajo; volver a abrir el archivo guardado por el primer ejemplo en Node muestra la misma regla con su tipo, operador y fórmula intactos, y <code>getCellAreas()</code> informa la misma región. En esta plataforma, las propiedades <code>type</code> y <code>operator</code> de una condición aparecen como los valores numéricos del enumerado. Las entradas que nunca recibieron una condición se eliminan al guardar el libro de trabajo, de la misma manera que Excel descarta un formato condicional sin regla.</p> <div class="highlight"><pre class="chroma"><code class="language-html" data-lang="html">const fs = require(&#34;fs&#34;); const { AsposeCells } = require(&#34;aspose.cells.js&#34;); AsposeCells.onReady().then(() =&gt; { // Recargar el archivo escrito por el primer ejemplo const workbook = new Workbook(new Uint8Array(fs.readFileSync(&#34;PivotConditionalFormatData.xlsx&#34;))); const pivotTable = workbook.worksheets.get(0).pivotTables.get(0); console.log(&#34;Conditional formats: &#34; + pivotTable.conditionalFormats.count); for (let i = 0; i <span class="p">&lt;</span> <span class="nt">pivotTable.conditionalFormats.count</span><span class="err">;</span> <span class="na">i</span><span class="err">++)</span> <span class="err">{</span> <span class="na">const</span> <span class="na">format </span><span class="o">=</span> <span class="s">pivotTable.conditionalFormats.get(i);</span> <span class="na">for</span> <span class="err">(</span><span class="na">let</span> <span class="na">j </span><span class="o">=</span> <span class="s">0;</span> <span class="na">j</span> <span class="err">&lt;</span> <span class="na">format</span><span class="err">.</span><span class="na">formatConditions</span><span class="err">.</span><span class="na">count</span><span class="err">;</span> <span class="na">j</span><span class="err">++)</span> <span class="err">{</span> <span class="na">const</span> <span class="na">condition </span><span class="o">=</span> <span class="s">format.formatConditions.get(j);</span> <span class="na">console</span><span class="err">.</span><span class="na">log</span><span class="err">(&#34;</span><span class="na">Format</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="na">i</span> <span class="err">+</span> <span class="err">&#34;</span><span class="na">:</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="na">condition</span><span class="err">.</span><span class="na">type</span> <span class="err">+</span> <span class="err">&#34;</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="na">condition</span><span class="err">.</span><span class="na">operator</span> <span class="err">+</span> <span class="err">&#34;</span> <span class="na">formula1</span><span class="o">=</span><span class="s">&#34; + condition.formula1); </span><span class="s"> } </span><span class="s"> const areas = format.getCellAreas(); </span><span class="s"> for (const area of areas) </span><span class="s"> console.log(&#34;</span> <span class="na">rows</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">startRow</span> <span class="err">+</span> <span class="na">1</span><span class="err">)</span> <span class="err">+</span> <span class="err">&#34;</span><span class="na">-</span><span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">endRow</span> <span class="err">+</span> <span class="na">1</span><span class="err">)</span> <span class="err">+</span> <span class="err">&#34;,</span> <span class="na">columns</span> <span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">startColumn</span> <span class="err">+</span> <span class="na">1</span><span class="err">)</span> <span class="err">+</span> <span class="err">&#34;</span><span class="na">-</span><span class="err">&#34;</span> <span class="err">+</span> <span class="err">(</span><span class="na">area</span><span class="err">.</span><span class="na">endColumn</span> <span class="err">+</span> <span class="na">1</span><span class="err">));</span> <span class="err">}</span> <span class="err">//</span> <span class="na">Esto</span> <span class="na">imprime:</span> <span class="err">//</span> <span class="na">Formatos</span> <span class="na">condicionales:</span> <span class="na">1</span> <span class="err">//</span> <span class="na">Formato</span> <span class="na">0:</span> <span class="na">1</span> <span class="na">2</span> <span class="na">formula1</span><span class="o">=</span><span class="s">=200</span> <span class="err">(</span><span class="na">tipo</span> <span class="na">1 </span><span class="o">=</span> <span class="s">CellValue,</span> <span class="na">operador</span> <span class="na">2 </span><span class="o">=</span> <span class="s">GreaterThan)</span> <span class="err">//</span> <span class="na">filas</span> <span class="na">4-7</span><span class="err">,</span> <span class="na">columnas</span> <span class="na">6-6</span> <span class="err">(</span><span class="na">F4:F7</span><span class="err">,</span> <span class="na">la</span> <span class="na">región</span> <span class="na">de</span> <span class="na">datos</span> <span class="na">resuelta</span><span class="err">)</span> <span class="na">process</span><span class="err">.</span><span class="na">exit</span><span class="err">(</span><span class="na">0</span><span class="err">);</span> <span class="err">});</span> </code></pre></div><h2 id="artículos-relacionados"><strong>Artículos relacionados</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/apply-style-to-pivot-table/">Aplicar estilo a tabla dinámica</a></li> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/format-part-of-pivot-table/">Formato de parte de una tabla dinámica</a></li> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/top-10-show-or-filter-in-pivot-table/">Mostrar o filtrar los 10 principales en tabla dinámica</a></li> <li><a href="https://docs.aspose.com/cells/cells/es/javascript-cpp/filter-by-label-or-value-of-pivot-table/">Filtrar tablas dinámicas por etiqueta o valor</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>