https://docs.aspose.com/cells/ar/javascript-cpp/apply-style-to-pivot-table/ Recent content in تطبيق الأنماط على الجداول المحورية في Aspose.Cells for JavaScript via C++ on Documentation Hugo -- gohugo.io ar https://docs.aspose.com/cells/ar/javascript-cpp/format-part-of-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/ar/javascript-cpp/format-part-of-pivot-table/ <h2 id="سيناريوهات-الاستخدام-الممكنة"><strong>سيناريوهات الاستخدام الممكنة</strong></h2> <p><code>PivotTable.FormatAll</code> يطبق نمطًا واحدًا على كامل جدول محوري ويتم تغطيته في الصفحة الأم. لا يميز بين الملصقات، القيم، الإجماليات، أو مناطق معينة في التقرير. في الواقع، عادةً ما يحتاج جزء فقط من جدول محوري إلى إبراز. تشمل الأهداف الشائعة الملصقات التابعة لحقل صف واحد، الخلايا التي تحتوي على القيم التي ينتجها حقل معين، صف الإجمالي الكلي، أو مستطيل عشوائي مثل الصفين الأولين للعناصر. تطبيق نمط مباشرةً على خلايا ورقة عمل لجدول محوري ليس مكافئًا. Excel يخزن تنسيق الجداول المحورية كمناطق <code>PivotArea</code> دلالية بدلاً من سجلات أنماط الخلايا العادية. يبقى تنسيق منطقة pivot مرتبطًا بمنطقة مثل ملصقات حقل أو قيم البيانات، ويتم إعادة حلها عندما يُعاد حساب جدول محوري أو يُنعَّش أو يُوسَّع. أما النمط المكتوب مباشرةً إلى خلية، فهو ينتمي إلى موقع تلك الخلية ولا يتعقّبها نموذج الجدول المحوري. Aspose.Cells يعرض العائلة الكاملة لتجاوزات <code>PivotTable.Format</code> بحيث يتوفر كلا النوعين من التنسيق:</p> <ul> <li><code>Format(PivotArea, Style)</code> يربط نمطًا بمنطقة دلالية تُبنى باستخدام <code>PivotArea.Select</code> أو <code>PivotArea.SelectField</code>.</li> <li><code>Format(CellArea, Style)</code> يربط نمطًا بمستطيل ورقة عمل داخل جدول محوري.</li> <li><code>Format(int row, int column, Style)</code> يستهدف خلية واحدة.</li> <li><code>FormatAll(Style)</code> ينسق كامل جدول محوري.</li> </ul> <h2 id="تنسيق-منطقة-pivotarea"><strong>تنسيق منطقة PivotArea</strong></h2> <p>سير عمل المنطقة الدلالية هو النهج الموصى به عندما يجب أن يتبع التمييز حقلًا أو منطقةً في التقرير.</p> <ol> <li>أنشئ <code>PivotArea</code> باستخدام <code>new PivotArea(pivotTable)</code>. يصف هذا الكائن منطقة دلالية تنتمي إلى جدول محوري محدد.</li> <li>حدّد حقلًا بحسب موضعه الصفري على محور معين باستخدام <code>PivotArea.Select(PivotFieldType axisType, int fieldPosition, PivotTableSelectionType selectionType)</code>. <ul> <li><code>PivotTableSelectionType.DataAndLabel</code> يحدد كلًا من الملصقات والبيانات الخاصة بالحقل.</li> <li><code>PivotTableSelectionType.LabelOnly</code> يحدد ملصقات الحقل فقط.</li> <li><code>PivotTableSelectionType.DataOnly</code> يحدد خلايا بيانات الحقل فقط.</li> </ul> </li> <li>حدّد حقلًا بالاسم باستخدام <code>PivotArea.SelectField(PivotFieldType axisType, string fieldName)</code>. عندما يتم اختيار حقل صف بالاسم، تتحول المنطقة إلى خلايا القيم التي ينتجها عناصر ذلك الحقل.</li> <li>أنشئ <code>Style</code> باستخدام <code>Workbook.CreateStyle()</code>، واضبط الخط ولون المقدمة ونمط الخلفية الصلبة، ثم مرّر النمط إلى <code>PivotTable.Format(area, style)</code>.</li> <li>كل استدعاء لتجاوز <code>PivotArea</code> يضيف إدخالًا واحدًا من نوع <code>PivotTableFormat</code> إلى <code>PivotTable.PivotFormats</code>.</li> <li>تُرسم التنسيقات المرتبطة بالحقل عندما يتم حساب بيانات الجدول المحوري. لذلك، استدعِ <code>PivotTable.CalculateData()</code> بعد تطبيق التنسيقات لكي تصبح الأنماط مرئية. المثال التالي ينشئ جدولًا محوريًا صغيرًا لمبيعات الفاكهة، ويُنسّق ملصقات صف <code>Fruit</code> باستخدام <code>PivotArea.Select</code> و <code>PivotTableSelectionType.LabelOnly</code>، ويُنسّق خلايا القيمة التي ينتجها نفس حقل الصف باستخدام <code>PivotArea.SelectField</code>، ثم يُعيد حساب جدول محوري بحيث تُظهر كلا النمطين.</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="تنسيق-منطقة-خلية-ضمن-جدول-محوري"><strong>تنسيق منطقة خلية ضمن جدول محوري</strong></h2> <p>استخدم <code>PivotTable.Format(CellArea, Style)</code> عندما تكون المنطقة المطلوبة مستطيل ورقة عمل عادي بدلاً من منطقة pivot دلالية. <code>CellArea</code> يَُوصف بالحقول <code>startRow</code> و <code>startColumn</code> و <code>endRow</code> و <code>endColumn</code>. القيم هي إحداثيات ورقة العمل بصفرية، وتحدد إحداثيات النهاية الصف والعمود الأخيرين المشمولين في المستطيل، لذا يغطي المنطقة الخلايا من الموضع الابتدائي حتى الموضع النهائي شاملًا. على عكس التنسيق المرتبط بالحقل، يتم تطبيق تنسيق <code>CellArea</code> على الخلايا فورًا. لا يلزم استدعاء إضافي لـ <code>CalculateData()</code> لظهور النمط. قد يحتوي مستطيل <code>CellArea</code> على خلايا تسميات وخلايا قيم معًا. يصف القسم التالي كيف تمثل Aspose.Cells وExcel ذلك المستطيل داخليًا. المثال التالي ينسق المستطيل <code>E4:F5</code> من جدول محوري بنمط مائل، أزرق فاتح، ويحفظ المصنف دون أي إعادة حساب إضافية.</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="كيفية-ربط-مناطق-pivot-ومناطق-cellarea"><strong>كيفية ربط مناطق Pivot ومناطق CellArea</strong></h2> <p>Excel يخزن تنسيق الجداول المحورية كسجلات <code>pivotArea</code> بدلاً من سجلات أنماط خلايا ورقة عمل عادية. يستخدم Aspose.Cells نفس النموذج، لذا يتم ترجمة طلب التنسيق إلى مناطق pivot عند تسجيله. العلاقة بين <code>CellArea</code> التي يزودها المستخدم ومناطق pivot المخزنة داخليًا هي علاقة متعدد‑إلى‑متعدد في كلا الاتجاهين.</p> <ul> <li>قد ينتج <code>CellArea</code> واحد عدة مناطق pivot. إذا كان المستطيل يشمل كلًا من خلايا التسميات وخلايا القيم، فإنه يُقسَّم إلى قواعد للملصقات والبيانات منفصلة، لأن نموذج pivot يتعامل مع تنسيق الملصقات وتنسيق البيانات بشكل مستقل.</li> <li>قد تتحول منطقة pivot واحدة إلى عدة أمثلة <code>CellArea</code> منفصلة. يمكن لمنطقة دلالية مثل صف الإجمالي الكلي، أو حقل لا تكون عناصره متجاورة، أن يغطي مستطيلات متعددة. لهذا السبب تُرجع <code>PivotArea.GetCellAreas()</code> مجموعة بدلاً من مستطيل واحد. يتم تسجيل كل عملية تنسيق تُجرى عبر <code>PivotTable.Format</code> في <code>PivotTable.PivotFormats</code>. كل إدخال من نوع <code>PivotTableFormat</code> يعرض <code>PivotArea</code> المرتبطة والنمط <code>Style</code> المطبق عليها. يُضيف تجاوز <code>PivotArea</code> إدخالًا واحدًا بالضبط لكل استدعاء، بينما يمكن لـ <code>CellArea</code> الذي يحتوي على مناطق دلالية مختلفة إضافة عدة إدخالات. لتمييز المناطق المخزنة، تعرض كل <code>PivotArea</code> العلامتين <code>OnlyLabel</code> و <code>OnlyData</code>. المثال أدناه ينسق مستطيلًا واحدًا يغطي كلًا من الملصقات والقيم، ويستعرض <code>PivotTable.PivotFormats</code>، ويطبع إحداثيات <code>CellArea</code> التي تحل كل منطقة pivot مخزنة إليها.</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"> نظرًا لأن التنسيقات تُخزن كمناطق pivot بدلاً من أنماط خلايا عادية، فإنها تبقى بعد إعادة الحساب والتحديث. عندما يتم تحديث جدول محوري باستخدام <code>PivotTable.RefreshData</code>، أو إعادة حسابه بـ <code>CalculateData</code>، أو حفظه وإعادة تحميله، تعيد كل منطقة pivot مخزنة حل موقعها الحالي وتُطبق النمط مرة أخرى. </div> <p>استخدم <code>PivotArea</code> المبنية بـ <code>Select</code> أو <code>SelectField</code> عندما يجب أن يبقى التمييز مرتبطًا بحقل أو منطقة دلالية عبر عمليات التحديث، واستخدم <code>CellArea</code> عندما يكون تنسيق مستطيل ثابت في تخطيط جدول محوري الحالي كافيًا. يتوجه تجاوز <code>Format(int row, int column, Style)</code> للخلية الواحدة. استخدم <code>FormatAll</code>، الذي يُغطى في الصفحة الأم، عندما يجب إعادة تنسيق كامل جدول محوري مرة واحدة.</p> <h2 id="مقالات-ذات-صلة"><strong>مقالات ذات صلة</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/apply-style-to-pivot-table/">تطبيق نمط على جدول محوري</a></li> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/pivot-table-add-row-and-column-fields/">إضافة حقول الصف والعمود إلى جدول محوري</a></li> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/manage-value-fields/">إدارة حقول القيم في جدول محوري</a></li> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/refresh-pivot-table/">تحديث جدول محوري</a></li> </ul> <button class="floating-button" id="openModalBtn">AI Document Assistant</button> <div class="modal" id="modal"> <button class="close-btn" id="closeModalBtn">Close</button> <iframe src="https://products.aspose.ai/cells/chat/document/javascript-cpp?source=docs" frameborder="0" width="100%" height="100%"></iframe> </div> <style> .floating-button { position: fixed; bottom: 20px; right: 20px; background-color: #007bff; color: white; border: none; padding: 15px 20px; border-radius: 50px; cursor: pointer; font-size: 16px; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2); z-index: 999; } .modal { display: none; position: fixed; top: 10%; left: 10%; width: 80%; height: 80%; background-color: white; border: none; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.3); z-index: 1000; padding: 20px; box-sizing: border-box; } .close-btn { position: absolute; top: 10px; right: 10px; background-color: #f44336; color: white; border: none; padding: 5px 10px; cursor: pointer; font-size: 16px; border-radius: 3px; } </style> <script> const openModalBtn = document.getElementById('openModalBtn'); const closeModalBtn = document.getElementById('closeModalBtn'); const modal = document.getElementById('modal'); openModalBtn.addEventListener('click', function() { modal.style.display = 'block'; }); closeModalBtn.addEventListener('click', function() { modal.style.display = 'none'; }); window.addEventListener('click', function(event) { if (event.target === modal) { modal.style.display = 'none'; } }); </script> https://docs.aspose.com/cells/ar/javascript-cpp/add-conditional-formatting-to-pivot-table/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.aspose.com/cells/ar/javascript-cpp/add-conditional-formatting-to-pivot-table/ <h2 id="سيناريوهات-الاستخدام-المحتملة"><strong>سيناريوهات الاستخدام المحتملة</strong></h2> <p>الأنماط الموضحة في الصفحة الأم والصفحة الشقيقة ثابتة - يُطبق تنسيق على منطقة <code>PivotArea</code> أو <code>CellArea</code> مرة واحدة وتظل تنسيقها كما هو بغض النظر عن القيم. التنسيق الشرطي هو المقابل القائم على القواعد - إبراز كل مبلغ يزيد عن 200، تظليل الخمسين بالمئة الوسطى، أو وضع علامة على العناصر ذات الترتيب الأدنى - ويستمر الإبراز في متابعة القيم كلما أعيد حساب جدول محوري أو تم تحديثه.<br> في Aspose.Cells، يقع التنسيق الشرطي للجدول المحوري في مجموعة <code>pivotTable.conditionalFormats</code>. كل إدخال هو <code>PivotConditionalFormat</code> يجيب على سؤالين بشكل مستقل:</p> <ul> <li><strong>أين تُطبق القاعدة؟</strong> يتم تعريف منطقة الهدف إما عبر <code>applyTo(row, column, scope)</code> التي تحاكي أداة اختيار النطاق في واجهة مستخدم Excel، أو عبر <code>addCellArea(cellArea)</code> ومجموعة <code>pivotAreas</code> التي تحدد المنطقة صراحةً.</li> <li><strong>ماذا تختبر القاعدة؟</strong> يتم إضافة شرط أو أكثر إلى <code>formatConditions</code> باستخدام <code>addCondition(type, operatorType, formula1, formula2)</code>، وكل شرط يحمل نمطه الخاص.</li> </ul> <div class="alert alert-primary" role="alert"> لا تقم باستدعاء <code>formatConditions.add(cellArea, type, operatorType, formula1, formula2)</code> أو <code>formatConditions.addArea(cellArea)</code> على كائن <code>formatConditions</code> لتنسيق شرطي للجدول المحوري. هاتان الطريقتان الموروثتان من واجهة برمجة التطبيقات العادية لتنسيق الخلايا الشرطي في ورقة العمل لا تعملان مع الجداول المحورية - لا يتم تحويل مساحة الخلية إلى مساحة جدول محوري، لذا يتم تجاهل الطلب صامتًا. احرص دائمًا على تعريف المنطقة على <code>PivotConditionalFormat</code> نفسه (<code>applyTo</code>، <code>addCellArea</code>، أو <code>pivotAreas</code>) وإضافة القاعدة باستخدام إحدى إصدارات <code>addCondition</code>. </div> <h2 id="تطبيق-قاعدة-بنطاق-طريقة-واجهة-excel"><strong>تطبيق قاعدة بنطاق (طريقة واجهة Excel)</strong></h2> <p>الطريقة الأولى تضع القاعدة كما تفعل واجهة Excel. تُسمى خلية في جدول محوري بإحداثيات ورقة عمل صفرية الأساس، ويخبر نطاق <code>PivotConditionFormatScopeType</code> Aspose.Cells إلى أي مدى يجب أن تصل القاعدة من تلك الخلية:</p> <ul> <li><code>PivotConditionFormatScopeType.Data</code> - جميع خلايا القيم التي ينتجها الجدول المحوري، بما في ذلك المجاميع الكلية.</li> <li><code>PivotConditionFormatScopeType.Field</code> - خلايا القيم التي تنتمي إلى الحقل الذي تحدده الخلية، باستثناء المجاميع الكلية. يجب أن تكون الخلية خلية حقل مثل تسمية حقل الصف؛ تمرير خلية قيمة يؤدي إلى استثناء.</li> <li><code>PivotConditionFormatScopeType.Selection</code> - فقط خلايا القيم عند التقاطع التي تختارها الخلية، عادةً خلية قيمة واحدة.<br> يبني المثال أدناه جدولًا محوريًا لمبيعات الفواكه حيث الزاوية العلوية اليسرى في الخلية E3، يربط تنسيقًا شرطيًا بالخلية F4 (صف 3، عمود 5) بنطاق <code>Data</code>، ويبرز كل مبلغ أكبر من 200 بخط أبيض عريض على خلفية حمراء. مع القيم تفاح 220، موز 330، كرز 200، والمجموع الكلي 750، تقوم القاعدة بتلوين F4 وF5 وF7 - المنطقة المحلولة هي كامل عمود البيانات F4:F7، وفقط الخلايا التي تتجاوز القاعدة تُضاء.</li> </ul> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">PivotFieldType</span><span class="p">,</span> <span class="nx">PivotConditionFormatScopeType</span><span class="p">,</span> <span class="nx">FormatConditionType</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">,</span> <span class="nx">Color</span><span class="p">,</span> <span class="nx">BackgroundType</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Year&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="p">}</span> <span class="c1">// Pivot table with its top-left corner at E3 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Anchor the conditional format at F4 (row 3, column 5) with the Data scope </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">index</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">add</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">index</span><span class="p">);</span> <span class="nx">format</span><span class="p">.</span><span class="nx">applyTo</span><span class="p">(</span><span class="mi">3</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="nx">PivotConditionFormatScopeType</span><span class="p">.</span><span class="nx">Data</span><span class="p">);</span> <span class="c1">// Rule - highlight amounts greater than 200 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">conditionIndex</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">addCondition</span><span class="p">(</span> <span class="nx">FormatConditionType</span><span class="p">.</span><span class="nx">CellValue</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">.</span><span class="nx">GreaterThan</span><span class="p">,</span> <span class="s2">&#34;200&#34;</span><span class="p">,</span> <span class="kc">null</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">style</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isBold</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">color</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">White</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">Red</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">conditionIndex</span><span class="p">).</span><span class="nx">style</span> <span class="o">=</span> <span class="nx">style</span><span class="p">;</span> <span class="c1">// wb.save(SaveFormat.Xlsx) returns the file as bytes </span><span class="c1"></span> <span class="nx">fs</span><span class="p">.</span><span class="nx">writeFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatData.xlsx&#34;</span><span class="p">,</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">));</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Done; the rule paints F4, F5, and F7&#34;</span><span class="p">);</span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><p>ربط القاعدة نفسها بملصق حقل الصف E4 (صف 3، عمود 4) بنطاق <code>Field</code> يحل إلى F4:F6 بدلاً من ذلك - نفس عمود البيانات بدون صف المجموع الكلي - لأن النطاق الآن يصف حقل <code>Fruit</code> بدلاً من مساحة القيم بالكامل. النطاق <code>Selection</code> المرتبط بـ F4 يحل إلى F4 فقط.</p> <h2 id="تعريف-المنطقة-يدويا"><strong>تعريف المنطقة يدويًا</strong></h2> <p>الطريقة الثانية تتجاوز أداة اختيار النطاق وتحدد المنطقة صراحةً على <code>PivotConditionalFormat</code>.</p> <h3 id="مستطيل-ورقة-عمل-باستخدام-addcellarea"><strong>مستطيل ورقة عمل باستخدام addCellArea</strong></h3> <p><code>addCellArea(cellArea)</code> يسجل المستطيل المقدم كهدف للقاعدة. الإحداثيات هي إحداثيات ورقة عمل صفرية الأساس، والمنطقة هي بالضبط المستطيل المزوَّد - لا توسيع إلى عمود البيانات ولا منطق للمجموع الكلي. استخدمه عندما تكون الخلايا المطلوبة مستطيلًا ثابتًا معروفًا في تخطيط الجدول المحوري الحالي.</p> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">PivotFieldType</span><span class="p">,</span> <span class="nx">FormatConditionType</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">,</span> <span class="nx">Color</span><span class="p">,</span> <span class="nx">BackgroundType</span><span class="p">,</span> <span class="nx">CellArea</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Year&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Target the rectangle F4:F6 (the value cells without the grand total) </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">index</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">add</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">index</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">area</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">CellArea</span><span class="p">();</span> <span class="nx">area</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">=</span> <span class="mi">3</span><span class="p">;</span> <span class="nx">area</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">area</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">area</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">=</span> <span class="mi">5</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">addCellArea</span><span class="p">(</span><span class="nx">area</span><span class="p">);</span> <span class="c1">// Rule - italic on light yellow for amounts between 150 and 300 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">conditionIndex</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">addCondition</span><span class="p">(</span> <span class="nx">FormatConditionType</span><span class="p">.</span><span class="nx">CellValue</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">.</span><span class="nx">Between</span><span class="p">,</span> <span class="s2">&#34;150&#34;</span><span class="p">,</span> <span class="s2">&#34;300&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">style</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">isItalic</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">foregroundColor</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">LightYellow</span><span class="p">;</span> <span class="nx">style</span><span class="p">.</span><span class="nx">pattern</span> <span class="o">=</span> <span class="nx">BackgroundType</span><span class="p">.</span><span class="nx">Solid</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">conditionIndex</span><span class="p">).</span><span class="nx">style</span> <span class="o">=</span> <span class="nx">style</span><span class="p">;</span> <span class="nx">fs</span><span class="p">.</span><span class="nx">writeFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatCellArea.xlsx&#34;</span><span class="p">,</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">));</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Done; the rule paints F4 and F6&#34;</span><span class="p">);</span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><h3 id="منطقة-جدول-محوري-دلالية-باستخدام-pivotareas"><strong>منطقة جدول محوري دلالية باستخدام pivotAreas</strong></h3> <p><code>pivotAreas</code> هو نفس نموذج المنطقة الدلالية الذي تستخدمه الصفحة الشقيقة للأنماط الثابتة. أنشئ <code>PivotArea</code>، اختر حقلًا أو منطقة باستخدام <code>select</code> أو <code>selectField</code>، وأضفه باستخدام <code>pivotAreas.addPivotArea(pivotArea)</code>. تبقى المنطقة الدلالية مرتبطة بحقلها، لذا يتبع التنسيق الشرطي الحقل عندما يتم تحديث جدول محوري ويتغير التخطيط. التحميل <code>pivotAreas.add(pivotArea)</code> لا يزال يعمل لكنه مُعلَّم كمتقَدَّم - يُفضَّل استخدام <code>addPivotArea</code>.</p> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">Workbook</span><span class="p">,</span> <span class="nx">SaveFormat</span><span class="p">,</span> <span class="nx">PivotFieldType</span><span class="p">,</span> <span class="nx">PivotArea</span><span class="p">,</span> <span class="nx">FormatConditionType</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">,</span> <span class="nx">Color</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">AsposeCells</span><span class="p">;</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">sheet</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">cells</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">cells</span><span class="p">;</span> <span class="kr">const</span> <span class="nx">fruits</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Apple&#34;</span><span class="p">,</span> <span class="s2">&#34;Banana&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">,</span> <span class="s2">&#34;Cherry&#34;</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">years</span> <span class="o">=</span> <span class="p">[</span><span class="mi">2024</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2025</span><span class="p">,</span> <span class="mi">2024</span><span class="p">,</span> <span class="mi">2025</span><span class="p">];</span> <span class="kr">const</span> <span class="nx">amounts</span> <span class="o">=</span> <span class="p">[</span><span class="mi">100</span><span class="p">,</span> <span class="mi">150</span><span class="p">,</span> <span class="mi">120</span><span class="p">,</span> <span class="mi">180</span><span class="p">,</span> <span class="mi">90</span><span class="p">,</span> <span class="mi">110</span><span class="p">];</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;A1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;B1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Year&#34;</span><span class="p">);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="s2">&#34;C1&#34;</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">fruits</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">0</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">fruits</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">1</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">years</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="nx">cells</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">).</span><span class="nx">putValue</span><span class="p">(</span><span class="nx">amounts</span><span class="p">[</span><span class="nx">i</span><span class="p">]);</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">sheet</span><span class="p">.</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">add</span><span class="p">(</span><span class="s2">&#34;=A1:C7&#34;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Row</span><span class="p">,</span> <span class="s2">&#34;Fruit&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">addFieldToArea</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">calculateData</span><span class="p">();</span> <span class="c1">// Attach the rule to the Amount data field as a semantic region </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">index</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">add</span><span class="p">();</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">index</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">area</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">PivotArea</span><span class="p">(</span><span class="nx">pivotTable</span><span class="p">);</span> <span class="nx">area</span><span class="p">.</span><span class="nx">selectField</span><span class="p">(</span><span class="nx">PivotFieldType</span><span class="p">.</span><span class="nx">Data</span><span class="p">,</span> <span class="s2">&#34;Amount&#34;</span><span class="p">);</span> <span class="nx">format</span><span class="p">.</span><span class="nx">pivotAreas</span><span class="p">.</span><span class="nx">addPivotArea</span><span class="p">(</span><span class="nx">area</span><span class="p">);</span> <span class="c1">// Rule - grey text for amounts below 150 </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">conditionIndex</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">addCondition</span><span class="p">(</span> <span class="nx">FormatConditionType</span><span class="p">.</span><span class="nx">CellValue</span><span class="p">,</span> <span class="nx">OperatorType</span><span class="p">.</span><span class="nx">LessThan</span><span class="p">,</span> <span class="s2">&#34;150&#34;</span><span class="p">,</span> <span class="kc">null</span><span class="p">);</span> <span class="kr">const</span> <span class="nx">style</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">createStyle</span><span class="p">();</span> <span class="nx">style</span><span class="p">.</span><span class="nx">font</span><span class="p">.</span><span class="nx">color</span> <span class="o">=</span> <span class="nx">Color</span><span class="p">.</span><span class="nx">Gray</span><span class="p">;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">conditionIndex</span><span class="p">).</span><span class="nx">style</span> <span class="o">=</span> <span class="nx">style</span><span class="p">;</span> <span class="nx">fs</span><span class="p">.</span><span class="nx">writeFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatPivotArea.xlsx&#34;</span><span class="p">,</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">save</span><span class="p">(</span><span class="nx">SaveFormat</span><span class="p">.</span><span class="nx">Xlsx</span><span class="p">));</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Done; the rule is attached to the Amount value cells&#34;</span><span class="p">);</span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><h2 id="أين-تخزن-القواعد-وكيفية-بقاءها-بعد-إعادة-التحميل"><strong>أين تُخزن القواعد وكيفية بقاءها بعد إعادة التحميل</strong></h2> <p>كل استدعاء <code>conditionalFormats.add()</code> يضيف <code>PivotConditionalFormat</code> واحدًا إلى جدول محوري. تُحفظ الشروط وصيغها وأنماطها مع المصنف - عند إعادة فتح الملف المحفوظ من المثال الأول في Node يُظهر نفس القاعدة مع نوعها ومعاملها وصيغتها بدون تعديل، وتُظهر <code>getCellAreas()</code> نفس المنطقة. على هذه المنصة تُظهر خاصيتي <code>type</code> و <code>operator</code> للشرط كقيم عددية للعددية enum. تُحذف الإدخالات التي لم تتلقَ شرطًا أبداً عند حفظ المصنف، بالطريقة نفسها التي يتخلص منها Excel من تنسيق شرطي لا يحتوي على قاعدة.</p> <div class="highlight"><pre class="chroma"><code class="language-js" data-lang="js"><span class="kr">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;fs&#34;</span><span class="p">);</span> <span class="kr">const</span> <span class="p">{</span> <span class="nx">AsposeCells</span> <span class="p">}</span> <span class="o">=</span> <span class="nx">require</span><span class="p">(</span><span class="s2">&#34;aspose.cells.js&#34;</span><span class="p">);</span> <span class="nx">AsposeCells</span><span class="p">.</span><span class="nx">onReady</span><span class="p">().</span><span class="nx">then</span><span class="p">(()</span> <span class="p">=&gt;</span> <span class="p">{</span> <span class="c1">// Reload the file written by the first example </span><span class="c1"></span> <span class="kr">const</span> <span class="nx">workbook</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">Workbook</span><span class="p">(</span><span class="k">new</span> <span class="nx">Uint8Array</span><span class="p">(</span><span class="nx">fs</span><span class="p">.</span><span class="nx">readFileSync</span><span class="p">(</span><span class="s2">&#34;PivotConditionalFormatData.xlsx&#34;</span><span class="p">)));</span> <span class="kr">const</span> <span class="nx">pivotTable</span> <span class="o">=</span> <span class="nx">workbook</span><span class="p">.</span><span class="nx">worksheets</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">).</span><span class="nx">pivotTables</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Conditional formats: &#34;</span> <span class="o">+</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">count</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">i</span> <span class="o">&lt;</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">format</span> <span class="o">=</span> <span class="nx">pivotTable</span><span class="p">.</span><span class="nx">conditionalFormats</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span> <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">j</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">j</span> <span class="o">&lt;</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">count</span><span class="p">;</span> <span class="nx">j</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span> <span class="kr">const</span> <span class="nx">condition</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">formatConditions</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">j</span><span class="p">);</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34;Format &#34;</span> <span class="o">+</span> <span class="nx">i</span> <span class="o">+</span> <span class="s2">&#34;: &#34;</span> <span class="o">+</span> <span class="nx">condition</span><span class="p">.</span><span class="nx">type</span> <span class="o">+</span> <span class="s2">&#34; &#34;</span> <span class="o">+</span> <span class="nx">condition</span><span class="p">.</span><span class="nx">operator</span> <span class="o">+</span> <span class="s2">&#34; formula1=&#34;</span> <span class="o">+</span> <span class="nx">condition</span><span class="p">.</span><span class="nx">formula1</span><span class="p">);</span> <span class="p">}</span> <span class="kr">const</span> <span class="nx">areas</span> <span class="o">=</span> <span class="nx">format</span><span class="p">.</span><span class="nx">getCellAreas</span><span class="p">();</span> <span class="k">for</span> <span class="p">(</span><span class="kr">const</span> <span class="nx">area</span> <span class="k">of</span> <span class="nx">areas</span><span class="p">)</span> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">&#34; rows &#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">startRow</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&#34;-&#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">endRow</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&#34;, columns &#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">startColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="p">)</span> <span class="o">+</span> <span class="s2">&#34;-&#34;</span> <span class="o">+</span> <span class="p">(</span><span class="nx">area</span><span class="p">.</span><span class="nx">endColumn</span> <span class="o">+</span> <span class="mi">1</span><span class="p">));</span> <span class="p">}</span> <span class="c1">// This prints: </span><span class="c1"></span> <span class="c1">// Conditional formats: 1 </span><span class="c1"></span> <span class="c1">// Format 0: 1 2 formula1==200 (type 1 = CellValue, operator 2 = GreaterThan) </span><span class="c1"></span> <span class="c1">// rows 4-7, columns 6-6 (F4:F7, the resolved data region) </span><span class="c1"></span> <span class="nx">process</span><span class="p">.</span><span class="nx">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span> </code></pre></div><h2 id="مقالات-ذات-صلة"><strong>مقالات ذات صلة</strong></h2> <ul> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/apply-style-to-pivot-table/">تطبيق نمط على جدول محوري</a></li> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/format-part-of-pivot-table/">تنسيق جزء من جدول محوري</a></li> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/top-10-show-or-filter-in-pivot-table/">أعلى 10 إظهار أو تصفية في جدول محوري</a></li> <li><a href="https://docs.aspose.com/cells/cells/ar/javascript-cpp/filter-by-label-or-value-of-pivot-table/">تصفية الجداول المحورية حسب التسمية أو القيمة</a></li> </ul> <button class="floating-button" id="openModalBtn">AI Document Assistant</button> <div class="modal" id="modal"> <button class="close-btn" id="closeModalBtn">Close</button> <iframe src="https://products.aspose.ai/cells/chat/document/javascript-cpp?source=docs" frameborder="0" width="100%" height="100%"></iframe> </div> <style> .floating-button { position: fixed; bottom: 20px; right: 20px; background-color: #007bff; color: white; border: none; padding: 15px 20px; border-radius: 50px; cursor: pointer; font-size: 16px; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.2); z-index: 999; } .modal { display: none; position: fixed; top: 10%; left: 10%; width: 80%; height: 80%; background-color: white; border: none; box-shadow: 0 4px 8px rgba(0, 0, 0, 0.3); z-index: 1000; padding: 20px; box-sizing: border-box; } .close-btn { position: absolute; top: 10px; right: 10px; background-color: #f44336; color: white; border: none; padding: 5px 10px; cursor: pointer; font-size: 16px; border-radius: 3px; } </style> <script> const openModalBtn = document.getElementById('openModalBtn'); const closeModalBtn = document.getElementById('closeModalBtn'); const modal = document.getElementById('modal'); openModalBtn.addEventListener('click', function() { modal.style.display = 'block'; }); closeModalBtn.addEventListener('click', function() { modal.style.display = 'none'; }); window.addEventListener('click', function(event) { if (event.target === modal) { modal.style.display = 'none'; } }); </script>