Hantera presentationstabeller i JavaScript

Vad den här sidan handlar om

Skapa och redigera tabeller i PowerPoint-slides med JavaScript och Aspose.Slides för Node.js. Upptäck enkla kodexempel för att effektivisera ditt tabell-arbetsflöde.

Introduktion

En tabell i PowerPoint är ett effektivt sätt att visa och framställa information. Informationen i ett rutnät av celler (ordnade i rader och kolumner) är tydlig och lätt att förstå.

Aspose.Slides tillhandahåller klassen Table, klassen Cell och andra typer som låter dig skapa, uppdatera och hantera tabeller i alla typer av presentationer.

Skapa tabell från grunden

Skapa en instans av klassen Presentation.
Hämta en referens till en bild genom dess index.
Definiera en array för columnWidth.
Definiera en array för rowHeight.
Lägg till ett Table-objekt på bilden via metoden addTable .
Iterera genom varje Cell för att applicera formatering på övre, nedre, högra och vänstra kantlinjerna.
Slå ihop de fyra cellerna i tabellens övre vänstra hörn (de två första kolumnerna i de två första raderna) till en enda cell.
Kom åt en Cell’s TextFrame.
Lägg till lite text i TextFrame.
Spara den ändrade presentationen.

Den här JavaScript‑koden visar hur du skapar en tabell i en presentation:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Instansierar en Presentation-klass som representerar en PPTX-fil
var pres = new aspose.slides.Presentation();
try {
    // Hämtar den första bilden
    var sld = pres.getSlides().get_Item(0);
    // Definierar kolumner med bredder och rader med höjder
    var dblCols = java.newArray("double", [50, 50, 50]);
    var dblRows = java.newArray("double", [50, 30, 30, 30, 30]);
    // Lägger till en tabellform på bilden
    var tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);
    // Ställer in kantformat för varje cell
    for (var row = 0; row < tbl.getRows().size(); row++) {
        for (var cell = 0; cell < tbl.getRows().get_Item(row).size(); cell++) {
            var cellFormat = tbl.getRows().get_Item(row).get_Item(cell).getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderTop().setWidth(5);
            cellFormat.getBorderBottom().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderBottom().setWidth(5);
            cellFormat.getBorderLeft().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderLeft().setWidth(5);
            cellFormat.getBorderRight().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cellFormat.getBorderRight().setWidth(5);
        }
    }
    // Slår ihop det övre vänstra 2x2-blocket av celler till en cell
    tbl.mergeCells(tbl.getRows().get_Item(0).get_Item(0), tbl.getRows().get_Item(1).get_Item(1), false);
    // Lägger till text i den sammanslagna cellen
    tbl.getRows().get_Item(0).get_Item(0).getTextFrame().setText("Merged Cells");
    // Sparar presentationen till disk
    pres.save("table.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Numrering i standardtabell

I en standardtabell är numreringen av celler enkel och nollbaserad. Den första cellen i en tabell har index 0,0 (kolumn 0, rad 0).

Till exempel numreras cellerna i en tabell med 4 kolumner och 4 rader på följande sätt:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

Den här JavaScript‑koden visar hur du specificerar numreringen för celler i en tabell:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Instansierar en Presentation-klass som representerar en PPTX-fil
var pres = new aspose.slides.Presentation();
try {
    // Hämtar den första bilden
    var sld = pres.getSlides().get_Item(0);
    // Definierar kolumner med bredder och rader med höjder
    var dblCols = java.newArray("double", [70, 70, 70, 70]);
    var dblRows = java.newArray("double", [70, 70, 70, 70]);
    // Lägger till en tabellform på bilden
    var tbl = sld.getShapes().addTable(100, 50, dblCols, dblRows);
    // Ställer in kantformat för varje cell
    for (let i = 0; i < tbl.getRows().size(); i++) {
        const row = tbl.getRows().get_Item(i);
        for (let j = 0; j < row.size(); j++) {
            const cell = row.get_Item(j);
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderTop().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderTop().setWidth(5);
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderBottom().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderBottom().setWidth(5);
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderLeft().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderLeft().setWidth(5);
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
            cell.getCellFormat().getBorderRight().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
            cell.getCellFormat().getBorderRight().setWidth(5);
        }
    }
    // Sparar presentationen till disk
    pres.save("StandardTables_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Åtkomst till befintlig tabell

Skapa en instans av klassen Presentation.
Hämta en referens till bilden som innehåller tabellen via dess index.
Skapa ett Table-objekt och sätt det till null.
Iterera genom alla Shape‑objekt tills tabellen hittas.

Om du misstänker att bilden du arbetar med innehåller en enda tabell kan du helt enkelt kontrollera alla former den innehåller. När en form identifieras som en tabell kan du typkonvertera den till ett Table-objekt. Men om bilden du arbetar med innehåller flera tabeller är det bättre att söka efter den tabell du behöver via dess setAlternativeText(String value).
Använd Table-objektet för att arbeta med tabellen. I exemplet nedan sätter vi texten i en cell i tabellen.
Spara den ändrade presentationen.

Den här JavaScript‑koden visar hur du får åtkomst till och arbetar med en befintlig tabell:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Instansierar Presentation-klassen som representerar en PPTX-fil
var pres = new aspose.slides.Presentation("UpdateExistingTable.pptx");
try {
    // Hämtar den första bilden
    var sld = pres.getSlides().get_Item(0);
    // Initierar null TableEx
    var tbl = null;
    // Itererar genom formerna och sätter en referens till den hittade tabellen
    for (let i = 0; i < sld.getShapes().size(); i++) {
        let shp = sld.getShapes().get_Item(i);
        if (java.instanceOf(shp, "com.aspose.slides.ITable")) {
            tbl = shp;
            // Sätter texten för den första kolumnen i den andra raden
            tbl.get_Item(0, 1).getTextFrame().setText("New");
        }
    }
    // Sparar den ändrade presentationen till disk
    pres.save("table1_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Hitta cellen som äger en textram

När generisk textbehandlingskod mottar en TextFrame från en tabell, använd metoden TextFrame.getParentCell för att hämta den ägande Cell. För en tabellcells‑textram returnerar TextFrame.getParentCell ägaren och TextFrame.getParentShape returnerar null, även om själva tabellen är en form.

Cellkoordinaterna är tillgängliga via de skrivskyddade metoderna Cell.getFirstColumnIndex och Cell.getFirstRowIndex. TextFrame.getParentCell erbjuder också skrivskyddad navigering: den returnerar ägaren men ändrar inte ägandeskapet. Kontrollera alltid den returnerade cellen för null innan du använder den.

För ett komplett exempel som identifierar ägare av tabellceller och former, inklusive former associerade med SmartArt‑noder, se Search and Replace Text.

Justera text i tabell

Skapa en instans av klassen Presentation.
Hämta en referens till en bild genom dess index.
Lägg till ett Table-objekt på bilden.
Kom åt ett TextFrame-objekt från tabellen.
Kom åt TextFrame-Paragraph.
Justera texten vertikalt.
Spara den ändrade presentationen.

Den här JavaScript‑koden visar hur du justerar texten i en tabell:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Skapar en instans av Presentation-klassen
var pres = new aspose.slides.Presentation();
try {
    // Hämtar den första bilden
    var slide = pres.getSlides().get_Item(0);
    // Definierar kolumner med bredder och rader med höjder
    var dblCols = java.newArray("double", [120, 120, 120, 120]);
    var dblRows = java.newArray("double", [100, 100, 100, 100]);
    // Lägger till tabellformen på bilden
    var tbl = slide.getShapes().addTable(100, 50, dblCols, dblRows);
    tbl.get_Item(1, 0).getTextFrame().setText("10");
    tbl.get_Item(2, 0).getTextFrame().setText("20");
    tbl.get_Item(3, 0).getTextFrame().setText("30");
    // Hämtar textramen
    var txtFrame = tbl.get_Item(0, 0).getTextFrame();
    // Skapar Paragraph-objektet för textramen
    var paragraph = txtFrame.getParagraphs().get_Item(0);
    // Skapar Portion-objektet för stycket
    var portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLACK"));
    // Justera texten vertikalt
    var cell = tbl.get_Item(0, 0);
    cell.setTextAnchorType(java.newByte(aspose.slides.TextAnchorType.Center));
    cell.setTextVerticalType(java.newByte(aspose.slides.TextVerticalType.Vertical270));
    // Sparar presentationen till disk
    pres.save("Vertical_Align_Text_out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Ange textformatering på tabellnivå

Skapa en instans av Presentation-klassen.
Hämta en referens till en bild genom dess index.
Kom åt ett Table-objekt från bilden.
Ställ in setFontHeight(float value) för texten.
Ställ in setAlignment(int value) och setMarginRight(float value).
Ställ in setTextVerticalType(byte value).
Spara den ändrade presentationen.

Den här JavaScript‑koden visar hur du tillämpar dina föredragna formateringsalternativ på texten i en tabell:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

// Skapar en instans av Presentation-klassen
var pres = new aspose.slides.Presentation("simpletable.pptx");
try {
    // Anta att den första formen på den första bilden är en tabell
    var someTable = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    // Sätter tabellcellernas teckenhöjd
    var portionFormat = new aspose.slides.PortionFormat();
    portionFormat.setFontHeight(25);
    someTable.setTextFormat(portionFormat);
    // Sätter tabellcellernas textjustering och högermarginal i ett anrop
    var paragraphFormat = new aspose.slides.ParagraphFormat();
    paragraphFormat.setAlignment(aspose.slides.TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    someTable.setTextFormat(paragraphFormat);
    // Sätter tabellcellernas vertikala texttyp
    var textFrameFormat = new aspose.slides.TextFrameFormat();
    textFrameFormat.setTextVerticalType(java.newByte(aspose.slides.TextVerticalType.Vertical));
    someTable.setTextFormat(textFrameFormat);
    pres.save("result.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Ange förinställt tabellformat

Aspose.Slides levererar de inbyggda PowerPoint‑tabellstilarna som uppräkningen TableStylePreset, så att du kan applicera samma utseende på vilken tabell som helst. Den här JavaScript‑koden visar hur du ersätter en tabells standardstil med en förinställd stil:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

var pres = new aspose.slides.Presentation();
try {
    var table = pres.getSlides().get_Item(0).getShapes().addTable(10, 10, java.newArray("double", [100, 150]), java.newArray("double", [5, 5, 5]));
    table.setStylePreset(aspose.slides.TableStylePreset.DarkStyle1);// ändra standardstilens förinställda tema
    pres.save("table.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Lås bildförhållande för tabell

Bildförhållandet för en geometrisk form är förhållandet mellan dess storlekar i olika dimensioner. Aspose.Slides tillhandahåller egenskapen setAspectRatioLocked för att låta dig låsa bildförhållandeinställningen för tabeller och andra former.

Den här JavaScript‑koden visar hur du låser bildförhållandet för en tabell:

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var table = pres.getSlides().get_Item(0).getShapes().get_Item(0);
    console.log("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());
    table.getGraphicalObjectLock().setAspectRatioLocked(!table.getGraphicalObjectLock().getAspectRatioLocked());// invert
    console.log("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());
    pres.save("pres-out.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

FAQ

Kan jag aktivera höger‑till‑vänster (RTL) läsriktning för en hel tabell och texten i dess celler?

Ja. Tabellen har en setRightToLeft‑metod och stycken har ParagraphFormat.setRightToLeft. Genom att använda båda säkerställer du korrekt RTL‑ordning och rendering i cellerna.

Hur kan jag förhindra att användare flyttar eller ändrar storlek på en tabell i den slutgiltiga filen?

Använd lås på former för att inaktivera flyttning, storleksändring, markering med mera. Dessa lås gäller även för tabeller.

Stöds det att infoga en bild i en cell som bakgrund?

Ja. Du kan ange en picture fill för en cell; bilden kommer att täcka cellens område enligt valt läge (sträcka eller mosaik).

Hantera rader och kolumner i PowerPoint‑tabeller med JavaScript