https://docs.aspose.com/cells/fr/javascript-cpp/apply-style-to-pivot-table/ Recent content in Appliquer des styles aux tableaux croisés dynamiques dans Aspose.Cells for JavaScript via C++ on Documentation Hugo -- gohugo.io fr https://docs.aspose.com/cells/fr/javascript-cpp/format-part-of-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/fr/javascript-cpp/format-part-of-pivot-table/ <h2 id="scénarios-dutilisation-possibles"><strong>Scénarios d&rsquo;utilisation possibles</strong></h2> <p><code>PivotTable.FormatAll</code> applique un style unique à l&rsquo;ensemble du tableau croisé dynamique et est décrit sur la page parente. Il ne fait pas la distinction entre les étiquettes, les valeurs, les totaux ou les régions particulières du rapport. En pratique, seule une partie d&rsquo;un tableau croisé dynamique doit généralement ressortir. Les cibles courantes comprennent les étiquettes appartenant à un champ de ligne, les cellules de valeurs générées par un champ, la ligne de total général, ou un rectangle arbitraire tel que les deux premières lignes d&rsquo;éléments. Appliquer un style directement aux cellules de la feuille de calcul d&rsquo;un tableau croisé dynamique n&rsquo;est pas équivalent. Excel stocke la mise en forme du tableau croisé dynamique sous forme de régions sémantiques <code>PivotArea</code> plutôt que comme des enregistrements de style de cellule ordinaires. Un format de zone pivot reste attaché à une région telle que les étiquettes d&rsquo;un champ ou les valeurs de données, et il est résolu à nouveau lorsque le tableau croisé dynamique est recalculé, actualisé ou développé. En revanche, un style appliqué directement à une cellule appartient à cette position de cellule et n&rsquo;est pas suivi par le modèle pivot. Aspose.Cells expose la famille complète de surcharges <code>PivotTable.Format</code> afin que les deux types de mise en forme soient disponibles :</p> <ul> <li><code>Format(PivotArea, Style)</code> ancre un style à une région sémantique construite avec <code>PivotArea.Select</code> ou <code>PivotArea.SelectField</code>.</li> <li><code>Format(CellArea, Style)</code> ancre un style à un rectangle de feuille de calcul à l&rsquo;intérieur du tableau croisé dynamique.</li> <li><code>Format(int row, int column, Style)</code> cible une cellule.</li> <li><code>FormatAll(Style)</code> met en forme l&rsquo;ensemble du tableau croisé dynamique.</li> </ul> <h2 id="formater-une-zone-pivot"><strong>Formater une zone Pivot</strong></h2> <p>Le flux de travail basé sur les zones sémantiques est l&rsquo;approche recommandée lorsqu&rsquo;une mise en évidence doit suivre un champ ou une région du rapport.</p> <ol> <li>Créez une <code>PivotArea</code> avec <code>new PivotArea(pivotTable)</code>. L&rsquo;objet décrit une région sémantique appartenant à ce tableau croisé dynamique spécifique.</li> <li>Sélectionnez un champ par sa position indexée à zéro sur un axe donné à l&rsquo;aide de <code>PivotArea.Select(PivotFieldType axisType, int fieldPosition, PivotTableSelectionType selectionType)</code>. <ul> <li><code>PivotTableSelectionType.DataAndLabel</code> sélectionne à la fois les étiquettes et les données du champ.</li> <li><code>PivotTableSelectionType.LabelOnly</code> sélectionne uniquement les étiquettes du champ.</li> <li><code>PivotTableSelectionType.DataOnly</code> sélectionne uniquement les cellules de données du champ.</li> </ul> </li> <li>Sélectionnez un champ par son nom avec <code>PivotArea.SelectField(PivotFieldType axisType, string fieldName)</code>. Lorsqu&rsquo;un champ de ligne est sélectionné par son nom, la région se résout en les cellules de valeur produites par les éléments de ce champ.</li> <li>Créez un <code>Style</code> avec <code>Workbook.CreateStyle()</code>, configurez sa police, sa couleur de premier plan et son motif de fond uni, puis transmettez le style à <code>PivotTable.Format(area, style)</code>.</li> <li>Chaque appel à la surcharge <code>PivotArea</code> ajoute une entrée <code>PivotTableFormat</code> à <code>PivotTable.PivotFormats</code>.</li> <li>Les formats ancrés à un champ sont appliqués lorsque les données du tableau croisé dynamique sont calculées. Par conséquent, appelez <code>PivotTable.CalculateData()</code> après avoir appliqué les formats afin que les styles deviennent visibles. L&rsquo;exemple suivant crée un petit tableau croisé dynamique de ventes de fruits, applique un style aux étiquettes de ligne <code>Fruit</code> avec <code>PivotArea.Select</code> et <code>PivotTableSelectionType.LabelOnly</code>, applique un style aux cellules de valeur générées par ce même champ de ligne avec <code>PivotArea.SelectField</code>, puis recalcule le tableau croisé dynamique afin que les deux styles soient appliqués.</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="formater-une-zone-de-cellules-du-tableau-croisé-dynamique"><strong>Formater une zone de cellules du tableau croisé dynamique</strong></h2> <p>Utilisez <code>PivotTable.Format(CellArea, Style)</code> lorsque la région d&rsquo;intérêt est un simple rectangle de feuille de calcul plutôt qu&rsquo;une région pivot sémantique. Une <code>CellArea</code> est décrite par les champs <code>startRow</code>, <code>startColumn</code>, <code>endRow</code> et <code>endColumn</code>. Les valeurs sont des coordonnées de feuille de calcul indexées à zéro, et les coordonnées de fin identifient la dernière ligne et la dernière colonne incluses dans le rectangle, de sorte que la zone couvre les cellules de la position de départ jusqu&rsquo;à la position de fin, incluses. Contrairement à un format ancré à un champ, un format <code>CellArea</code> est appliqué aux cellules immédiatement. Un autre appel à <code>CalculateData()</code> n&rsquo;est pas nécessaire pour que le style apparaisse. Un rectangle <code>CellArea</code> peut contenir à la fois des cellules d&rsquo;étiquettes et des cellules de valeurs. La section suivante décrit comment Aspose.Cells et Excel représentent ce rectangle en interne. L&rsquo;exemple suivant met en forme le rectangle <code>E4:F5</code> du tableau croisé dynamique avec un style italique et bleu clair, puis enregistre le classeur sans aucun recalcul supplémentaire.</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="comment-les-zones-pivot-et-les-zones-cellule-se-correspondent"><strong>Comment les zones Pivot et les zones Cellule se correspondent</strong></h2> <p>Excel stocke la mise en forme du tableau croisé dynamique sous forme d&rsquo;enregistrements <code>pivotArea</code> plutôt que comme des enregistrements de style de cellule de feuille de calcul ordinaires. Le même modèle est utilisé par Aspose.Cells, de sorte qu&rsquo;une demande de mise en forme est traduite en zones pivot lors de son enregistrement. La relation entre la <code>CellArea</code> fournie par l&rsquo;utilisateur et les zones pivot stockées en interne est plusieurs-à-plusieurs dans les deux sens.</p> <ul> <li>Une <code>CellArea</code> peut produire plusieurs zones pivot. Si le rectangle couvre à la fois des cellules d&rsquo;étiquettes et des cellules de valeurs, il est décomposé en règles distinctes d&rsquo;étiquettes et de données, car le modèle pivot traite la mise en forme des étiquettes et des données de manière indépendante.</li> <li>Une zone pivot peut se résoudre en plusieurs instances <code>CellArea</code> disjointes. Une région sémantique telle qu&rsquo;une ligne de total général, ou un champ dont les éléments ne sont pas contigus, peut couvrir plusieurs rectangles. C&rsquo;est pourquoi <code>PivotArea.GetCellAreas()</code> renvoie une collection plutôt qu&rsquo;un seul rectangle. Chaque opération de mise en forme effectuée via <code>PivotTable.Format</code> est enregistrée dans <code>PivotTable.PivotFormats</code>. Chaque entrée <code>PivotTableFormat</code> expose la <code>PivotArea</code> associée et le <code>Style</code> qui lui est appliqué. La surcharge <code>PivotArea</code> ajoute exactement une entrée par appel, tandis qu&rsquo;une <code>CellArea</code> contenant différentes régions sémantiques peut ajouter plusieurs entrées. Pour distinguer les régions stockées, chaque <code>PivotArea</code> expose les drapeaux <code>OnlyLabel</code> et <code>OnlyData</code>. L&rsquo;exemple ci‑dessous met en forme un seul rectangle couvrant à la fois les étiquettes et les valeurs, examine <code>PivotTable.PivotFormats</code> et imprime les coordonnées <code>CellArea</code> auxquelles chaque zone pivot stockée se résout.</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"> Parce que les formats sont stockés en tant que zones pivot plutôt qu&rsquo;en tant que styles de cellule ordinaires, ils survivent aux recalculs et aux actualisations. Lorsque le tableau croisé dynamique est actualisé avec <code>PivotTable.RefreshData</code>, recalculé avec <code>CalculateData</code>, ou enregistré puis rechargé, chaque zone pivot stockée se résout à nouveau à la position actuelle de sa région et son style est réappliqué. </div> <p>Utilisez une <code>PivotArea</code> construite avec <code>Select</code> ou <code>SelectField</code> lorsqu&rsquo;une mise en évidence doit rester attachée à un champ ou à une région sémantique lors des actualisations, et utilisez une <code>CellArea</code> lorsque le formatage d&rsquo;un rectangle fixe dans la disposition actuelle du tableau croisé dynamique suffit. La surcharge <code>Format(int row, int column, Style)</code> à cellule unique cible une cellule individuelle. Utilisez <code>FormatAll</code>, décrit sur la page parente, lorsque tout le tableau croisé dynamique doit être reformaté d&rsquo;un seul coup.</p> <h2 id="articles-associés"><strong>Articles associés</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/apply-style-to-pivot-table/">Appliquer un style au tableau croisé dynamique</a></li> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/pivot-table-add-row-and-column-fields/">Ajouter des champs de ligne et de colonne au tableau croisé dynamique</a></li> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/manage-value-fields/">Gérer les champs de valeur dans le tableau croisé dynamique</a></li> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/refresh-pivot-table/">Actualiser le tableau croisé dynamique</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/fr/javascript-cpp/add-conditional-formatting-to-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/fr/javascript-cpp/add-conditional-formatting-to-pivot-table/ <h2 id="scénarios-dutilisation-possibles"><strong>Scénarios d&rsquo;utilisation possibles</strong></h2> <p>Les styles décrits sur la page parente et sur la page sœur sont statiques – une région <code>PivotArea</code> ou <code>CellArea</code> est peinte une fois et conserve son style quels que soient les valeurs. La mise en forme conditionnelle est le pendant basé sur des règles – mettre en surbrillance chaque montant supérieur à 200, ombrer les cinquante pour cent du milieu, ou signaler les éléments les mieux classés – et la mise en surbrillance suit les valeurs chaque fois que le tableau croisé dynamique est recalculé ou rafraîchi.<br> Dans Aspose.Cells, la mise en forme conditionnelle d&rsquo;un tableau croisé dynamique se trouve dans la collection <code>pivotTable.conditionalFormats</code>. Chaque entrée est un <code>PivotConditionalFormat</code> qui répond à deux questions de manière indépendante :</p> <ul> <li><strong>Où la règle s&rsquo;applique-t-elle ?</strong> La région cible est définie soit via <code>applyTo(row, column, scope)</code>, qui reproduit le sélecteur de portée de l&rsquo;interface utilisateur Excel, soit via <code>addCellArea(cellArea)</code> et la collection <code>pivotAreas</code>, qui nomment explicitement la région.</li> <li><strong>Que teste la règle ?</strong> Une ou plusieurs conditions sont ajoutées à <code>formatConditions</code> avec <code>addCondition(type, operatorType, formula1, formula2)</code>, et chaque condition possède son propre <code>style</code>.</li> </ul> <div class="alert alert-primary" role="alert"> N&rsquo;appelez pas <code>formatConditions.add(cellArea, type, operatorType, formula1, formula2)</code> ou <code>formatConditions.addArea(cellArea)</code> sur l&rsquo;objet <code>formatConditions</code> d&rsquo;un format conditionnel de tableau croisé dynamique. Ces deux surcharges sont héritées de l&rsquo;API de mise en forme conditionnelle ordinaire des feuilles de calcul et ne fonctionnent pas pour les tableaux croisés dynamiques – la zone de cellules n&rsquo;est jamais convertie en zone de tableau croisé dynamique, de sorte que la requête est silencieusement ignorée. Définissez toujours la région sur le <code>PivotConditionalFormat</code> lui‑même (<code>applyTo</code>, <code>addCellArea</code> ou <code>pivotAreas</code>) et ajoutez la règle avec l&rsquo;une des surcharges <code>addCondition</code>. </div> <h2 id="appliquer-une-règle-avec-une-portée-méthode-de-linterface-excel"><strong>Appliquer une règle avec une portée (méthode de l&rsquo;interface Excel)</strong></h2> <p>La première méthode positionne la règle comme le fait l&rsquo;interface utilisateur d&rsquo;Excel. Une cellule du tableau croisé dynamique est nommée par ses coordonnées de feuille de calcul basées sur zéro, et une portée <code>PivotConditionFormatScopeType</code> indique à Aspose.Cells jusqu&rsquo;où la règle doit s&rsquo;étendre à partir de cette cellule :</p> <ul> <li><code>PivotConditionFormatScopeType.Data</code> – toutes les cellules de valeurs que le tableau croisé dynamique produit, y compris les totaux généraux.</li> <li><code>PivotConditionFormatScopeType.Field</code> – les cellules de valeurs qui appartiennent au champ identifié par la cellule, excluant les totaux généraux. La cellule doit être une cellule de champ, telle qu&rsquo;une étiquette de champ de ligne ; passer une cellule de valeur lève une exception.</li> <li><code>PivotConditionFormatScopeType.Selection</code> – uniquement les cellules de valeurs à l&rsquo;intersection que la cellule sélectionne, généralement une seule cellule de valeur. L&rsquo;exemple ci‑dessus crée un tableau croisé dynamique de ventes de fruits dont le coin supérieur gauche se trouve en E3, ancre une mise en forme conditionnelle à la cellule F4 (ligne 3, colonne 5) avec la portée <code>Data</code>, et met en évidence chaque montant supérieur à 200 en blanc gras sur fond rouge. Avec les valeurs Apple 220, Banana 330, Cherry 200 et le total général 750, la règle colore F4, F5 et F7 – la région résolue est toute la colonne de données F4 : F7, et seules les cellules dont la valeur satisfait la règle s&rsquo;illuminent.</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">Tableau</span> <span class="na">croisé</span> <span class="na">dynamique</span> <span class="na">avec</span> <span class="na">son</span> <span class="na">coin</span> <span class="na">supérieur</span> <span class="na">gauche</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">Ancrer</span> <span class="na">le</span> <span class="na">format</span> <span class="na">conditionnel</span> <span class="na">à</span> <span class="na">F4</span> <span class="err">(</span><span class="na">ligne</span> <span class="na">3</span><span class="err">,</span> <span class="na">colonne</span> <span class="na">5</span><span class="err">)</span> <span class="na">avec</span> <span class="na">la</span> <span class="na">portée</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">Règle</span> <span class="na">-</span> <span class="na">mettre</span> <span class="na">en</span> <span class="na">évidence</span> <span class="na">les</span> <span class="na">montants</span> <span class="na">supérieurs</span> <span class="na">à</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">renvoie</span> <span class="na">le</span> <span class="na">fichier</span> <span class="na">sous</span> <span class="na">forme</span> <span class="na">d</span><span class="err">&#39;</span><span class="na">octets</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>Ancrer la même règle à l’étiquette de champ de ligne E4 (ligne 3, colonne 4) avec la portée <code>Field</code> se résout en F4 : F6 – la même colonne de données sans la ligne de total général – car la portée décrit maintenant le champ <code>Fruit</code> plutôt que la totalité de la zone de valeurs. La portée <code>Selection</code> ancrée à F4 se résout uniquement à F4.</p> <h2 id="définir-la-région-manuellement"><strong>Définir la région manuellement</strong></h2> <p>La deuxième méthode ignore le sélecteur de portée et nomme explicitement la région sur le <code>PivotConditionalFormat</code>.</p> <h3 id="un-rectangle-de-feuille-de-calcul-avec-addcellarea"><strong>Un rectangle de feuille de calcul avec addCellArea</strong></h3> <p><code>addCellArea(cellArea)</code> enregistre le rectangle fourni comme cible de la règle. Les coordonnées sont des coordonnées de feuille de calcul basées sur zéro, et la région correspond exactement au rectangle fourni – aucune extension à la colonne de données et aucune logique de total général. Utilisez‑le lorsque les cellules d’intérêt forment un rectangle fixe connu du présent agencement du tableau croisé dynamique.</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">Cibler</span> <span class="na">le</span> <span class="na">rectangle</span> <span class="na">F4:F6</span> <span class="err">(</span><span class="na">les</span> <span class="na">cellules</span> <span class="na">de</span> <span class="na">valeur</span> <span class="na">sans</span> <span class="na">le</span> <span class="na">total</span> <span class="na">général</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">Règle</span> <span class="na">-</span> <span class="na">italique</span> <span class="na">en</span> <span class="na">jaune</span> <span class="na">clair</span> <span class="na">pour</span> <span class="na">les</span> <span class="na">montants</span> <span class="na">entre</span> <span class="na">150</span> <span class="na">et</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="une-région-pivot-sémantique-avec-pivotareas"><strong>Une région pivot sémantique avec pivotAreas</strong></h3> <p><code>pivotAreas</code> est le même modèle de région sémantique que la page sœur utilise pour les styles statiques. Créez un <code>PivotArea</code>, sélectionnez un champ ou une région avec <code>select</code> ou <code>selectField</code>, puis ajoutez‑le avec <code>pivotAreas.addPivotArea(pivotArea)</code>. Une région sémantique reste attachée à son champ, de sorte que la mise en forme conditionnelle suit le champ lorsque le tableau croisé dynamique est rafraîchi et que la disposition change. La surcharge <code>pivotAreas.add(pivotArea)</code> fonctionne toujours mais est marquée comme obsolète – privilégiez <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">Attacher</span> <span class="na">la</span> <span class="na">règle</span> <span class="na">au</span> <span class="na">champ</span> <span class="na">de</span> <span class="na">données</span> <span class="na">Montant</span> <span class="na">en</span> <span class="na">tant</span> <span class="na">que</span> <span class="na">région</span> <span class="na">sémantique</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">Règle</span> <span class="na">-</span> <span class="na">texte</span> <span class="na">gris</span> <span class="na">pour</span> <span class="na">les</span> <span class="na">montants</span> <span class="na">inférieurs</span> <span class="na">à</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="où-les-règles-sont-stockées-et-comment-elles-survivent-à-un-rechargement"><strong>Où les règles sont stockées et comment elles survivent à un rechargement</strong></h2> <p>Chaque appel <code>conditionalFormats.add()</code> ajoute un <code>PivotConditionalFormat</code> au tableau croisé dynamique. Les conditions, leurs formules et leurs styles sont enregistrés avec le classeur – rouvrir le fichier sauvegardé par le premier exemple dans Node montre la même règle avec son type, son opérateur et sa formule intacts, et <code>getCellAreas()</code> indique la même région. Sur cette plateforme, les propriétés <code>type</code> et <code>operator</code> d’une condition apparaissent sous forme de valeurs numériques d’énumération. Les entrées qui n’ont jamais reçu de condition sont éliminées lors de l’enregistrement du classeur, de la même façon qu’Excel supprime une mise en forme conditionnelle dépourvue de règle.</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; { // Recharger le fichier écrit par le premier exemple 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">Cela</span> <span class="na">affiche</span> <span class="na">:</span> <span class="err">//</span> <span class="na">Formats</span> <span class="na">conditionnels</span> <span class="na">:</span> <span class="na">1</span> <span class="err">//</span> <span class="na">Format</span> <span class="na">0</span> <span class="na">:</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">type</span> <span class="na">1 </span><span class="o">=</span> <span class="s">CellValue,</span> <span class="na">opérateur</span> <span class="na">2 </span><span class="o">=</span> <span class="s">GreaterThan)</span> <span class="err">//</span> <span class="na">lignes</span> <span class="na">4-7</span><span class="err">,</span> <span class="na">colonnes</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">région</span> <span class="na">de</span> <span class="na">données</span> <span class="na">résolue</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="articles-associés"><strong>Articles associés</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/apply-style-to-pivot-table/">Appliquer un style au tableau croisé dynamique</a></li> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/format-part-of-pivot-table/">Formater une partie du tableau croisé dynamique</a></li> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/top-10-show-or-filter-in-pivot-table/">Afficher ou filtrer le Top 10 dans le tableau croisé dynamique</a></li> <li><a href="https://docs.aspose.com/cells/cells/fr/javascript-cpp/filter-by-label-or-value-of-pivot-table/">Filtrer les tableaux croisés dynamiques par libellé ou valeur</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>