Customize Column Cells

Users can customize the column cells defaultValue, validators, conditional formatting and styles.

In addition to customizing header style and caption, users can also customize style, conditional formats and validator of column cells in tableSheet view:
<template> <div class="sample-tutorial"> <gc-spread-sheets class="sample-spreadsheets" @workbookInitialized="initSpread"> <gc-worksheet> <gc-column> </gc-column> </gc-worksheet> </gc-spread-sheets> </div> </template> <script setup> import GC from "@mescius/spread-sheets"; import { ref } from "vue"; import "@mescius/spread-sheets-tablesheet"; import "@mescius/spread-sheets-vue"; const spreadRef = ref(null); function initSpread(spread) { spread.suspendPaint(); spread.clearSheets(); spread.options.autoFitType = GC.Spread.Sheets.AutoFitType.cellWithHeader; spread.bind(GC.Spread.Sheets.Events.EditStarting, function (e, args) { if (args.sheet.getValue(0, args.col, GC.Spread.Sheets.SheetArea.colHeader) === 'Customer') { args.cancel = true; } }); //init a data manager var baseApiUrl = getBaseApiUrl(); var dataManager = spread.dataManager(); //add order table var orderTable = dataManager.addTable("orderTable", { remote: { read: { url: baseApiUrl + "/Order" } }, schema: { columns: { CustomerId: { lookup: { name: 'customer', columns: [ { value: "Id", width: 60 }, { value: "CompanyName", width: 200 }, { value: "ContactName", width: 140 }, { value: "ContactTitle", width: 140 } ] } } } } }); //add customer table var customerTable = dataManager.addTable("customerTable", { remote: { read: { url: baseApiUrl + "/Customer" } } }); //add employee table var employeeTable = dataManager.addTable("employeeTable", { remote: { read: { url: baseApiUrl + "/Employee" } } }); //add relationship between order table, customer table and employee table dataManager.addRelationship(orderTable, "CustomerId", "customer", customerTable, "Id", "orders"); dataManager.addRelationship(orderTable, "EmployeeId", "employee", employeeTable, "Id", "orders"); //init a table sheet var sheet = spread.addSheetTab(0, "TableSheet1", GC.Spread.Sheets.SheetType.tableSheet); sheet.options.allowAddNew = false; //hide new row //bind a view to the table sheet var addressStyle = { formatter: 'Ship To: {{=CONCAT(@.ShipAddress, ", ", @.ShipCity)}}' }; var formulaRule = { ruleType: "formulaRule", formula: "@>50", style: { backColor: "pink" } }; var multiSelectStyle = { formatter: '{{=CONCAT([@customer.CompanyName], ", ", [@customer.ContactName])}}', // convert the object to string }; var myView = orderTable.addView("myView", [ { value: "Id", width: 60 }, //set column width 100px { value: "OrderDate", width: 120, style: { formatter: "MM/dd/yyyy", hAlign: "center", cellButtons: [{ command: "openDateTimePicker", imageType: "dropdown", useButtonStyle: true, }] } }, { value: "Freight", width: 100, conditionalFormats: [formulaRule], style: { backColor: "white" } }, /** * customer.companyName - this is a related field from the customer table * update the customerId in orderTable by select from customer table. */ { caption: "Customer", value: "CustomerId", width: 350, style: multiSelectStyle }, /** * [=@] this column will contain the full row as a value, the formatter formula will extract the shipping address from the full row. * Format functions can be used to customize column display value * use star-size "2*" to set column width relative to the viewport width */ { value: "=[@]", caption: "Address", style: addressStyle, width: 450 }, /** * The formatter formula will extract the properties from the full row. * Format functions can be used to customize column display value. */ { caption: "Employee", value: "employee", width: 250, style: { formatter: '{{=[@employee.FirstName] & " " & [@employee.LastName]}} ({{=[@ShipRegion]}})' } }, ]); myView.fetch().then(function () { sheet.setDataView(myView); }); spread.resumePaint(); } function getBaseApiUrl() { return window.location.href.match(/http.+spreadjs\/demos\//)[0] + 'server/api'; } </script> <style scoped> #app { height: 100%; } .sample-tutorial { position: relative; height: 100%; overflow: hidden; } .sample-spreadsheets { width: 100%; height: 100%; overflow: hidden; float: left; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; } </style>
<!DOCTYPE html> <html style="height:100%;font-size:14px;"> <head> <meta charset="utf-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <title>SpreadJS VUE</title> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/en/vue3/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/en/vue3/node_modules/systemjs/dist/system.src.js"></script> <script src="./systemjs.config.js"></script> <script src="./compiler.js" type="module"></script> <script> var System = SystemJS; System.import("./src/app.js"); System.import('$DEMOROOT$/en/lib/vue3/license.js'); </script> </head> <body> <div id="app"></div> </body> </html>
(function (global) { SystemJS.config({ transpiler: 'plugin-babel', babelOptions: { es2015: true }, paths: { // paths serve as alias 'npm:': 'node_modules/' }, packageConfigPaths: [ './node_modules/*/package.json', "./node_modules/@mescius/*/package.json", "./node_modules/@babel/*/package.json", "./node_modules/@vue/*/package.json" ], map: { 'vue': "npm:vue/dist/vue.esm-browser.js", 'tiny-emitter': 'npm:tiny-emitter/index.js', 'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js', "systemjs-babel-build": "npm:systemjs-plugin-babel/systemjs-babel-browser.js", '@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js', '@mescius/spread-sheets-vue': 'npm:@mescius/spread-sheets-vue/index.js', '@mescius/spread-sheets-tablesheet': 'npm:@mescius/spread-sheets-tablesheet/index.js' }, meta: { '*.css': { loader: 'systemjs-plugin-css' }, '*.vue': { loader: "../plugin-vue/index.js" } } }); })(this);