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 formato de las celdas de un rango con la API de JavaScript de Excel. El formato incluye fuentes, colores, formatos numéricos, bordes y alineación. Para obtener la lista completa de propiedades y métodos que admite el Range objeto, vea Clase Excel.Range.

Puntos clave

• Use Range.format para acceder a propiedades de formato como fuente, relleno, bordes y alineación.
• Establezca format.fill.color y format.font.color use nombres de color o códigos hexadecimales.
• Use numberFormat para controlar cómo se muestran los números, las fechas y la moneda.
• Los cambios de formato no afectan a los valores de celda, solo a su apariencia.

Establecer el color de fuente y el color de relleno

Las Range.format.font propiedades y Range.format.fill controlan los colores de texto y fondo. Use nombres de color como "rojo" o "blanco", o códigos de color hexadecimales como "#4472C4".

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 el rango después de que se establezca el color de fuente y el color de relleno

Establecer el formato de número

La numberFormat propiedad controla cómo se muestran los valores en las celdas. Los códigos de formato de número siguen la sintaxis de formato de Excel. Entre los formatos comunes se incluyen "0,00" para decimales, "$#,#0,00" para la moneda y "m/d/aaaa" para las fechas.

En el ejemplo de código siguiente se establece el formato numérico de las celdas del rango D3:E5 para mostrar dos posiciones decimales.

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 el rango después de que se establezca el formato de número

Establecimiento de propiedades de fuente

Establezca varias propiedades de fuente, como negrita, cursiva, tamaño y nombre de fuente.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getActiveWorksheet();
    let range = sheet.getRange("B2:E2");

    range.format.font.bold = true;
    range.format.font.italic = true;
    range.format.font.size = 14;
    range.format.font.name = "Arial";

    await context.sync();
});

Establecer alineación de celdas

Las horizontalAlignment propiedades y verticalAlignment controlan cómo se coloca el contenido dentro de las celdas.

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let range = sheet.getRange("A1:E1");

    range.format.horizontalAlignment = Excel.HorizontalAlignment.center;
    range.format.verticalAlignment = Excel.VerticalAlignment.center;

    await context.sync();
});

Vea también

• Modelo de objetos de JavaScript en Excel para Complementos de Office
• Trabajo con celdas mediante la API de JavaScript de Excel
• Obtención de un intervalo mediante la API de JavaScript de Excel
• Establecimiento y obtención de valores de rango, texto o fórmulas mediante la API de JavaScript de Excel
• Trabajo con varios intervalos de forma simultánea en los complementos de Excel