SpreadJS では、Excelと同様に、選択した範囲、項目、および名前付き範囲を表示するための名前ボックスコンポーネントがあります。 この機能は、プロジェクトにスプレッドコントロールとともに名前ボックスコンポーネントを追加するのに役立ちます。
通常、NameBox には、選択したセルのアドレスが表示されます。 NameBox は、セレクターとドロップダウンで構成されます。
次に示すように、NameBox のセレクターで選択した内容を表示できます。
NameBox のドロップダウンには、次のカスタム名のリストが表示されます。
名前ボックスコンポーネントを作成するには、次の手順に従います。
Javascript |
コードのコピー
|
---|---|
<script type="text/javascript" src="scripts/modules/gc.spread.sheets.all.x.x.x.min.js"></script> |
Javascript |
コードのコピー
|
---|---|
<div id="NameBox" style="width:100px"></div> |
Javascript |
コードのコピー
|
---|---|
var sheet = spread.getActiveSheet(); var nameBox = new GC.Spread.Sheets.NameBox.NameBox(document.getElementById('NameBox'), spread); |
INameBoxOptions インターフェイスを使用して、ドロップダウンリストの高さの設定、カスタム名の追加、範囲への移動、カスタム名の表示など、NameBox の動作を制御するさまざまなオプションを追加できます。
オプション | 値型 | 説明 |
---|---|---|
dropDownMaxHeight | 数値 | ドロップダウンリストの最大の高さを示します。 デフォルト値は 500px です。 |
enableAddCustomName | ブール | セレクターに存在しない名前を入力するときにカスタム名を追加するかどうかを示します。 デフォルト値は true です。 |
enableNavigateToRange | ブール | 名前を入力するか、またはカスタムリスト項目をクリックするときに、名前付き範囲または描画項目に移動するかどうかを示します。 デフォルト値は true です。 |
showCustomNameList | ブール | カスタム名リストのドロップダウン インジケータを表示するかどうかを示します。 |
次のサンプルコードは、NameBox オプションを設定する方法を示します。
Javascript |
コードのコピー
|
---|---|
var nameBox = new GC.Spread.Sheets.NameBox.NameBox(document.getElementById('NameBox'), spread, { showCustomNameList: false, dropDownMaxHeight: 200, enableAddCustomName: false, enableNavigateToRange: false }); |