Establecimiento del formato de intervalo mediante la API de JavaScript de Excel

En este artículo se proporcionan ejemplos de código que establecen el color de fuente, el color de relleno y el formato de número para las celdas de un rango con la API de JavaScript de Excel. Para obtener la lista completa de propiedades y métodos que admite el Range objeto, vea Clase Excel.Range.

Nota:

La API de JavaScript para Excel no tiene un objeto o clase de "Celda". En su lugar, se definen todas las celdas de Excel como objetos Range. Una celda individual en la interfaz de usuario de Excel se traduce en un objeto Range con una celda en la API de JavaScript para Excel. Un solo objeto Range también puede contener varias celdas contiguas. Consulte Trabajar con celdas mediante la API de JavaScript para Excel para obtener más información.

Establecer el color de fuente y el color de relleno

En el ejemplo de código siguiente se establece el color de fuente y el color de relleno de las celdas del rango B2:E2.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let range = sheet.getRange("B2:E2");
    range.format.fill.color = "#4472C4";
    range.format.font.color = "white";

    await context.sync();
});

Datos en el rango antes de que se establezca el color de fuente y el color de relleno

Datos en Excel antes de establecer el formato.

Datos en el rango después de que se establezca el color de fuente y el color de relleno

Datos en Excel después de establecer el formato.

Establecer el formato de número

En el ejemplo de código siguiente se establece el formato de número de las celdas en el rango D3:E5.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");

    let formats = [
        ["0.00", "0.00"],
        ["0.00", "0.00"],
        ["0.00", "0.00"]
    ];

    let range = sheet.getRange("D3:E5");
    range.numberFormat = formats;

    await context.sync();
});

Datos en el rango antes de que se establezca el formato de número

Datos en Excel antes de establecer el formato de número.

Datos en el rango después de que se establezca el formato de número

Datos en Excel después de establecer el formato de número.

Vea también