استخدام فئة ChartGlobalizationSettings لضبط لغة مختلفة لمكون المخطط باستخدام جافا سكريبت عبر C++

سيناريوهات الاستخدام المحتملة

قامت APIs الخاصة بـ Aspose.Cells بالكشف عن فئة ChartGlobalizationSettings للتعامل مع السيناريوهات التي يرغب فيها المستخدم في تعيين مكونات المخطط إلى لغات مختلفة وتسميات مخصصة للمجاميع الفرعية في جدول البيانات.

مقدمة في فئة ChartGlobalizationSettings

تقدم فئة ChartGlobalizationSettings حالياً الطرق الثمانية التالية والتي يمكن تجاوزها في فئة مخصصة لترجمة مثل اسم عنوان المحور، اسم وحدة المحور، اسم عنوان المخطط، وغيرها إلى لغات مختلفة.

  1. ChartGlobalizationSettings.axisTitleName: يحصل على اسم العنوان للمحور.
  2. ChartGlobalizationSettings.axisUnitName(DisplayUnitType): يحصل على اسم وحدة المحور.
  3. ChartGlobalizationSettings.chartTitleName: يحصل على اسم عنوان الرسم البياني.
  4. ChartGlobalizationSettings.legendDecreaseName: يحصل على اسم الانخفاض لوحة التفسير.
  5. ChartGlobalizationSettings.legendIncreaseName: يحصل على اسم زيادة للوسيلة التوضيحية.
  6. ChartGlobalizationSettings.legendTotalName: يحصل على اسم الإجمالي لوحة التفسير.
  7. ChartGlobalizationSettings.otherName: يحصل على اسم تسميات “أخرى” للرسم البياني.
  8. ChartGlobalizationSettings.seriesName: يحصل على اسم السلاسل في الرسم البياني.

ترجمة لغة مخصصة

هنا، سنقوم بإنشاء رسم بياني شلالي استنادًا إلى البيانات التالية. سيتم عرض أسماء مكونات الرسم البياني باللغة الإنجليزية في الرسم البياني. سنستخدم مثال باللغة التركية لنريك كيفية عرض عنوان الرسم البياني وأسماء زيادة/انخفاض لوحة التفسير واسم الإجمالي وعنوان المحور باللغة التركية.

todo:image_alt_text

الكود المثالي

يقوم الكود العيني التالي بتحميل ملف Excel العيني.

<!DOCTYPE html>
<html>
    <head>
        <title>Aspose.Cells Chart Globalization Settings Example</title>
    </head>
    <body>
        <h1>Chart Globalization Settings Example (Turkey)</h1>
        <input type="file" id="fileInput" accept=".xls,.xlsx,.csv" />
        <button id="runExample">Run Example</button>
        <a id="downloadLink" style="display: none;">Download Result</a>
        <div id="result"></div>
    </body>

    <script src="aspose.cells.js.min.js"></script>
    <script type="text/javascript">
        const { Workbook, SaveFormat } = AsposeCells;

        AsposeCells.onReady({
            license: "/lic/aspose.cells.enc",
            fontPath: "/fonts/",
            fontList: [
                "arial.ttf",
                "NotoSansSC-Regular.ttf"
            ]
        }).then(() => {
            console.log("Aspose.Cells initialized");
        });

        // Define TurkeyChartGlobalizationSettings by converting getXxx methods to properties
        class TurkeyChartGlobalizationSettings extends AsposeCells.ChartGlobalizationSettings {
            constructor() {
                super();
                this.chartTitleName = "Grafik Başlığı"; // Chart Title
                this.legendIncreaseName = "Artış"; // Increase
                this.legendDecreaseName = "Düşüş"; // Decrease
                this.legendTotalName = "Toplam"; // Total
                this.axisTitleName = "Eksen Başlığı"; // Axis Title
            }
        }

        document.getElementById('runExample').addEventListener('click', async () => {
            const fileInput = document.getElementById('fileInput');
            const resultDiv = document.getElementById('result');
            resultDiv.innerHTML = '';

            if (!fileInput.files.length) {
                resultDiv.innerHTML = '<p style="color: red;">Please select an Excel file.</p>';
                return;
            }

            // No try-catch: let errors propagate
            const file = fileInput.files[0];
            const arrayBuffer = await file.arrayBuffer();

            // Instantiate Workbook from uploaded file
            const workbook = new Workbook(new Uint8Array(arrayBuffer));

            // Set custom chartGlobalizationSettings (Turkey)
            workbook.settings.globalizationSettings.chartSettings = new TurkeyChartGlobalizationSettings();

            // Access the first worksheet and its charts
            const worksheet = workbook.worksheets.get(0);
            const chartCollection = worksheet.charts;
            const chart = chartCollection.get(0);

            // Calculate the chart
            chart.calculate();

            // Get the chart title text
            const title = chart.title;
            const titleText = title ? title.text : "(No Title)";

            // Prepare output messages
            const messages = [];
            messages.push('<p style="color: green;">Operation completed successfully!</p>');
            messages.push(`<p>Workbook chart title: ${titleText}</p>`);

            // Get legend labels and output them
            const legendEntriesLabels = chart.legend.legendLabels;
            if (legendEntriesLabels && legendEntriesLabels.forEach) {
                const legendItems = [];
                legendEntriesLabels.forEach(label => {
                    legendItems.push(`<li>${label}</li>`);
                });
                if (legendItems.length) {
                    messages.push('<p>Workbook chart legend:</p>');
                    messages.push(`<ul>${legendItems.join('')}</ul>`);
                } else {
                    messages.push('<p>(No legend labels found)</p>');
                }
            } else {
                messages.push('<p>(No legend or legend labels available)</p>');
            }

            // Save modified workbook to allow download (optional)
            const outputData = workbook.save(SaveFormat.Xlsx);
            const blob = new Blob([outputData]);
            const downloadLink = document.getElementById('downloadLink');
            downloadLink.href = URL.createObjectURL(blob);
            downloadLink.download = 'output.xlsx';
            downloadLink.style.display = 'block';
            downloadLink.textContent = 'Download Modified Excel File';

            resultDiv.innerHTML = messages.join('');
        });
    </script>
</html>

الإخراج الذي تم توليده بواسطة رمز العينة

هذا هو إنتاج الكونسول للكود العيني أعلاه.

  

Workbook chart title: Grafik Başlığı  

Workbook chart legend: Artış  

Workbook chart legend: Düşüş  

Workbook chart legend: Toplam  

Workbook category axis title: Eksen Başlığı
الحصول على ورقة العمل المرتبطة بالمخطط باستخدام JavaScript عبر C++ ثلاث طرق لتصفية بيانات المخطط باستخدام JavaScript عبر C++