Använda ChartGlobalizationSettings klass för att ställa in olika språk för diagramkomponenten med JavaScript via C++

Möjliga användningsscenario

Aspose.Cells API:er har exponerat ChartGlobalizationSettings-klassen för att hantera scenarier där användaren vill ställa in diagramkomponenter till olika språk och anpassade etiketter för deltotaler i ett kalkylblad.

Introduktion till ChartGlobalizationSettings-klassen

Klass ChartGlobalizationSettings erbjuder för närvarande följande 8 metoder som kan åsidosättas i en anpassad klass för att översätta till exempel AxisTitle-namn, AxisUnit-namn, ChartTitle-namn och så vidare till olika språk.

  1. ChartGlobalizationSettings.axisTitleName: Hämtar namnet på titeln för axeln.
  2. ChartGlobalizationSettings.axisUnitName(DisplayUnitType): Hämtar namnet på axelenhet.
  3. ChartGlobalizationSettings.chartTitleName: Hämtar namnet på diagramtiteln.
  4. ChartGlobalizationSettings.legendDecreaseName: Hämtar namnet på minskningen för förklaringen.
  5. ChartGlobalizationSettings.legendIncreaseName: Hämtar namnet på Increase för Legend.
  6. ChartGlobalizationSettings.legendTotalName: Hämtar namnet på totalen för förklaringen.
  7. ChartGlobalizationSettings.otherName: Hämtar namnet på “Annan” etiketter för diagrammet.
  8. ChartGlobalizationSettings.seriesName: Hämtar namnet på serier i diagrammet.

Anpassad språköversättning

Här kommer vi att skapa en stapeldiagram baserat på följande data. Namnen på diagramkomponenterna kommer att visas på engelska i diagrammet. Vi kommer att använda ett turkiskt språkexempel för att visa hur man visar diagramtitel, förklarings-ökning/minskning, totalt namn och axelns titel på turkiska.

todo:image_alt_text

Exempelkod

Följande exempelkod laddar prov Excel-filen.

<!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>

Utdata genererad av provkoden

Detta är konsoloutputen för ovanstående exempelkod.

  

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ığı
Hämta Arbetsblad för Diagrammet med JavaScript via C++ Tre metoder för att filtrera diagramdata med JavaScript via C++