单元格级别绑定

SpreadJS 支持单元格级别绑定,你可以将数据源的数据绑定到单元格上。

<p>你必须创建一个单元格级别绑定的数据源, 然后使用 <strong>setBindingPath</strong> 方法来设置绑定路径到指定的单元格,并将数据源设置到表单上。例如:</p> <pre><code class="hljs js language-js"><span class="hljs-keyword">var</span> person = { <span class="hljs-attr">name</span>: <span class="hljs-string">'Wang feng'</span>, <span class="hljs-attr">age</span>: <span class="hljs-number">25</span>, <span class="hljs-attr">sex</span>: <span class="hljs-string">'male'</span>, <span class="hljs-attr">address</span>: { <span class="hljs-attr">postcode</span>: <span class="hljs-string">'710075'</span> } }; <span class="hljs-keyword">var</span> source = <span class="hljs-keyword">new</span> GC.Spread.Sheets.Bindings.CellBindingSource(person); sheet.setBindingPath(<span class="hljs-number">2</span>, <span class="hljs-number">1</span>, <span class="hljs-string">'name'</span>); sheet.setBindingPath(<span class="hljs-number">3</span>, <span class="hljs-number">1</span>, <span class="hljs-string">'age'</span>); sheet.setBindingPath(<span class="hljs-number">4</span>, <span class="hljs-number">1</span>, <span class="hljs-string">'sex'</span>); sheet.setBindingPath(<span class="hljs-number">5</span>, <span class="hljs-number">1</span>, <span class="hljs-string">'address.postcode'</span>); sheet.setDataSource(source); </code></pre> <p>你可以使用 <strong>getBindingPath</strong> 方法来获取指定单元格的绑定信息。</p>
var person, sheet; window.onload = function () { var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss")); initSpread(spread); }; function initSpread(spread) { var spreadNS = GC.Spread.Sheets; sheet = spread.sheets[0]; sheet.suspendPaint(); sheet.setColumnWidth(0, 120); sheet.setColumnWidth(1, 120); sheet.setColumnWidth(2, 120); sheet.setValue(0, 0, 'cell-binding'); sheet.setValue(2, 1, 'Name'); sheet.setValue(3, 1, 'Age'); sheet.setValue(4, 1, 'Sex'); sheet.setValue(5, 1, 'Address.postcode'); person = { name: "Wang Feng", age: 25, sex: "Male", address: { postcode: "710075" } }; document.getElementById("personName").value=person.name || ""; document.getElementById("personAge").value=person.age || ""; document.getElementById("personSex").value=person.sex || ""; document.getElementById("personPostcode").value=person.address.postcode || ""; var source = new spreadNS.Bindings.CellBindingSource(person); sheet.setBindingPath(2, 2, "name"); sheet.setBindingPath(3, 2, "age"); sheet.setBindingPath(4, 2, "sex"); sheet.setBindingPath(5, 2, "address.postcode"); sheet.setDataSource(source); sheet.setSelection(2, 2, 1, 1); var path = sheet.getBindingPath(2, 2); sheet.getRange(2, 2, 4, 1).backColor("rgb(208,206,206)"); document.getElementById("bindingPath").innerHTML=path || ""; sheet.bind(spreadNS.Events.SelectionChanged, function() { var activeCell = sheet.getSelections()[0]; var path = sheet.getBindingPath(activeCell.row, activeCell.col); document.getElementById("bindingPath").innerHTML=path || ""; }); sheet.bind(spreadNS.Events.CellChanged, function() { document.getElementById("personName").value=person.name || ""; document.getElementById("personAge").value=person.age || ""; document.getElementById("personSex").value=person.sex || ""; document.getElementById("personPostcode").value=person.address.postcode || ""; }); sheet.resumePaint(); }; var updateName = function(value) { if (person && sheet) { person.name = value; sheet.repaint(); } }; var updateAge = function(value) { if (person && sheet) { person.age = value; sheet.repaint(); } }; var updateSex = function(value) { if (person && sheet) { person.sex = value; sheet.repaint(); } }; var updatePostcode = function(value) { if (person && sheet) { person.address.postcode = value; sheet.repaint(); } };
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta name="spreadjs culture" content="zh-cn" /> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/zh/purejs/node_modules/@grapecity/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script> <script src="app.js" type="text/javascript"></script> <link rel="stylesheet" type="text/css" href="styles.css"> </head> <body> <div class="sample-tutorial"> <div id="ss" class="sample-spreadsheets"></div> <div class="options-container"> <div class="option-row"> <label style="background-color:lavender;">Select one of the gray cells to get its binding. You can also change the Person object below to see it change in the Spread instance: change any of the text in the text boxes below.</label> </div> <div class="option-row"> <label>Name:&nbsp;&nbsp;</label> <input type="text" id="personName" onkeyup="updateName(this.value)"/> <label>Age:&nbsp;&nbsp;</label> <input type="text" id="personAge" onkeyup="updateAge(this.value)"/> <label>Sex:&nbsp;&nbsp;</label> <input type="text" id="personSex" onkeyup="updateSex(this.value)"/> <label>Postcode:&nbsp;&nbsp;</label> <input type="text" id="personPostcode" onkeyup="updatePostcode(this.value)"/> <label>GetBindingPath:&nbsp;&nbsp;</label> <label id="bindingPath" style="color:darkgreen"></label> </div> </div> </div> </body> </html>
.sample-tutorial { position: relative; height: 100%; overflow: hidden; } .sample-spreadsheets { width: calc(100% - 280px); height: 100%; overflow: hidden; float: left; } .options-container { float: right; width: 280px; padding: 12px; height: 100%; box-sizing: border-box; background: #fbfbfb; overflow: auto; } .option-row { font-size: 14px; padding: 5px; margin-top: 10px; } label { display: block; margin-bottom: 6px; } input { padding: 4px 6px; } input[type=button] { margin-top: 6px; display: block; } input[type=text] { margin-top: 6px; margin-bottom: 6px; display: block; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }