SpreadJS 提供了一个类似 Excel 的名称框组件来显示选定的范围、项目和命名范围。 此功能有助于在项目中添加名称框组件以及扩展控件。

名称对话框（Name Box）通常显示所选单元格的地址。 名称对话框（Name Box）由一个选择器（Selector）和一个下拉菜单（Dropdown）组成。

您可以在名称对话框（Name Box） 的选择器中显示选择，如下所示：

• 选择时显示更改选择

• 设置选择时显示活动单元格

• 选择图表时显示图表名称

名称对话框（Name Box）的下拉列表显示以下自定义名称列表：

• 工作簿自定义名称及其表达式类型，等于 GC.Spread.CalcEngine.ExpressionType.reference

• 活动工作表自定义名称及其表达式类型等于 GC.Spread.CalcEngine.ExpressionType.reference

• 所有工作表的所有表名

创建名称对话框（Name Box）实例

要创建名称对话框（Name Box），请执行以下步骤：

• 在 HTML 中添加 gc.spread.sheets.all.x.x.x.min.js 引用。

<script type="text/javascript" src="scripts/modules/gc.spread.sheets.all.x.x.x.min.js"></script>

• 添加 DIV 容器

<div id="NameBox" style="width:100px"></div>

• 将 名称对话框（Name Box）元素绑定到 SpreadJS 实例。

var sheet = spread.getActiveSheet();
var nameBox = new GC.Spread.Sheets.NameBox.NameBox(document.getElementById('NameBox'), spread);

您可以进一步添加名称对话框（Name Box）选项，请参阅以下设置名称对话框（Name Box）选项部分。

设置选项

您可以添加各种选项来控制 NameBox 的行为，例如设置下拉列表高度、添加自定义名称、导航到范围以及使用 INameBoxOptions 界面显示自定义名称。

以下代码显示了如何设置 NameBox 选项：

 var nameBox = new GC.Spread.Sheets.NameBox.NameBox(document.getElementById('NameBox'), spread, {
     showCustomNameList: false,
     dropDownMaxHeight: 200,
     enableAddCustomName: false,
     enableNavigateToRange: false
 });