open-grid 1.3.1 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +28 -0
- package/README.ja.md +462 -0
- package/README.md +52 -18
- package/README.zh.md +455 -0
- package/dist/{OpenGrid-B7m7ei7f.cjs → OpenGrid-BOtTt5aI.cjs} +2 -2
- package/dist/{OpenGrid-CeUdO_fM.js → OpenGrid-sI_vdHQw.js} +2 -2
- package/dist/Registry-CPJYOqCn.js +74 -0
- package/dist/Registry-D74ZmdDz.cjs +71 -0
- package/dist/index-B3fKi43v.js +481 -0
- package/dist/{index-JjfWY3Bt.cjs → index-D1l3XFCM.cjs} +92 -160
- package/dist/open-grid-react.cjs +1 -1
- package/dist/open-grid-react.js +1 -1
- package/dist/open-grid-vue.cjs +1 -1
- package/dist/open-grid-vue.js +1 -1
- package/dist/open-grid.cjs +31 -31
- package/dist/open-grid.js +86 -82
- package/dist/types/core/FilterSelect.d.ts +269 -33
- package/dist/types/core/GridShuttle.d.ts +160 -24
- package/dist/types/core/IconRegistry.d.ts +241 -33
- package/dist/types/core/OpenGrid.d.ts +2589 -327
- package/dist/types/core/OrgChart.d.ts +249 -32
- package/dist/types/core/SkinRegistry.d.ts +295 -60
- package/dist/types/core/XmlConverter.d.ts +388 -47
- package/dist/types/core/chart/types.d.ts +1008 -126
- package/dist/types/core/extension/Registry.d.ts +389 -51
- package/dist/types/core/extension/reserved.d.ts +34 -5
- package/dist/types/core/i18n/LocaleRegistry.d.ts +271 -54
- package/dist/types/core/i18n/types.d.ts +636 -85
- package/dist/types/core/types.d.ts +3576 -426
- package/dist/types/index.d.ts +226 -17
- package/package.json +3 -1
- package/dist/index-DrCPRuYi.js +0 -548
|
@@ -15,33 +15,100 @@ import { CFRule } from './cf/CFRule.js';
|
|
|
15
15
|
import { IRealtimeSource, RealtimeController, RtAnnounceSummary, FrameScheduler } from './realtime/index.js';
|
|
16
16
|
/**
|
|
17
17
|
* `setRealtimeSource` 에 넘기는 실시간 배선 옵션. 전부 선택 항목이며, 생략하면 안전한 기본값이 쓰인다.
|
|
18
|
-
*
|
|
18
|
+
*
|
|
19
|
+
* Options passed to `setRealtimeSource` for wiring a realtime source; all optional, with safe defaults.
|
|
20
|
+
*
|
|
21
|
+
* `setRealtimeSource` に渡すリアルタイム配線オプション。すべて任意項目で、省略すると安全な既定値が使われます。
|
|
22
|
+
*
|
|
23
|
+
* 传给 `setRealtimeSource` 的实时配线选项。全部为可选项,省略时采用安全的默认值。
|
|
19
24
|
*/
|
|
20
25
|
export interface RealtimeWireOptions {
|
|
21
|
-
/**
|
|
26
|
+
/**
|
|
27
|
+
* 프레임당 최대 적용 셀 수(백프레셔).
|
|
28
|
+
*
|
|
29
|
+
* Max cells applied per frame (backpressure).
|
|
30
|
+
*
|
|
31
|
+
* フレームあたりの最大適用セル数(バックプレッシャー)。
|
|
32
|
+
*
|
|
33
|
+
* 每帧最多应用的单元格数(背压)。
|
|
34
|
+
*/
|
|
22
35
|
maxBatchPerFrame?: number;
|
|
23
|
-
/**
|
|
36
|
+
/**
|
|
37
|
+
* 프레임 스케줄러 주입(헤드리스/테스트 결정론). 기본=rAF/폴백.
|
|
38
|
+
*
|
|
39
|
+
* Injected frame scheduler; default rAF/fallback.
|
|
40
|
+
*
|
|
41
|
+
* フレームスケジューラの注入(ヘッドレス/テストの決定性)。既定=rAF/フォールバック。
|
|
42
|
+
*
|
|
43
|
+
* 注入帧调度器(无头/测试的确定性)。默认=rAF/回退。
|
|
44
|
+
*/
|
|
24
45
|
scheduleFrame?: FrameScheduler;
|
|
25
|
-
/**
|
|
46
|
+
/**
|
|
47
|
+
* stale 판정 임계(ms). 기본 5000.
|
|
48
|
+
*
|
|
49
|
+
* Stale threshold(ms); default 5000.
|
|
50
|
+
*
|
|
51
|
+
* stale 判定のしきい値(ms)。既定 5000。
|
|
52
|
+
*
|
|
53
|
+
* stale 判定的阈值(ms)。默认 5000。
|
|
54
|
+
*/
|
|
26
55
|
staleAfterMs?: number;
|
|
27
|
-
/**
|
|
56
|
+
/**
|
|
57
|
+
* 실시간 갱신 규모를 스크린리더에 알릴 요약 콜백(aria-live 연동). 미지정 시 아무 것도 알리지 않는다.
|
|
58
|
+
*
|
|
59
|
+
* Callback that hands a summary of realtime updates to a screen reader (aria-live). Announces nothing when omitted.
|
|
60
|
+
*
|
|
61
|
+
* リアルタイム更新の規模をスクリーンリーダーに伝える要約コールバック(aria-live 連携)。未指定の場合は何も通知しません。
|
|
62
|
+
*
|
|
63
|
+
* 向屏幕阅读器通知实时更新规模的摘要回调(aria-live 联动)。未指定时不通知任何内容。
|
|
64
|
+
*/
|
|
28
65
|
announce?: (summary: RtAnnounceSummary) => void;
|
|
29
|
-
/**
|
|
66
|
+
/**
|
|
67
|
+
* SR 디바운스 윈도우(ms). 기본 500.
|
|
68
|
+
*
|
|
69
|
+
* SR debounce window(ms); default 500.
|
|
70
|
+
*
|
|
71
|
+
* SR のデバウンスウィンドウ(ms)。既定 500。
|
|
72
|
+
*
|
|
73
|
+
* SR 防抖窗口(ms)。默认 500。
|
|
74
|
+
*/
|
|
30
75
|
debounceMs?: number;
|
|
31
76
|
}
|
|
32
77
|
/**
|
|
33
|
-
* OPEN_GRID 코어 그리드 클래스.
|
|
78
|
+
* OPEN_GRID 코어 그리드 클래스.
|
|
79
|
+
*
|
|
80
|
+
* The OPEN_GRID core grid class.
|
|
81
|
+
*
|
|
82
|
+
* OPEN_GRID のコアグリッドクラス。
|
|
83
|
+
*
|
|
84
|
+
* OPEN_GRID 的核心表格类。
|
|
34
85
|
*
|
|
35
86
|
* 컨테이너 요소에 마운트되어 가상 스크롤로 대량 행을 렌더하는 초경량 데이터 그리드. 수천~수십만 행을
|
|
36
87
|
* 표로 다루면서 정렬·필터·그룹/트리·병합·범위 선택과 채우기·마스터/디테일·셀 수식·그리드 데이터 통합
|
|
37
88
|
* 차트가 필요할 때 쓴다. 코어를 고치지 않고 동작을 바꾸는 override/strategy 확장 커널을 함께 제공한다.
|
|
38
|
-
*
|
|
89
|
+
*
|
|
90
|
+
* An ultra-light data grid that mounts into a container element and renders large row sets through
|
|
39
91
|
* virtual scrolling. Use it to present thousands to hundreds of thousands of rows with sorting,
|
|
40
92
|
* filtering, group/tree, merging, range selection & fill, master/detail, cell formulas, and integrated
|
|
41
93
|
* charts backed by the grid data. It also ships the override/strategy extension kernel for changing
|
|
42
94
|
* behavior without editing the core.
|
|
43
95
|
*
|
|
44
|
-
*
|
|
96
|
+
* コンテナ要素にマウントされ、仮想スクロールで大量の行をレンダリングする超軽量データグリッドです。数千~数十万行を
|
|
97
|
+
* 表として扱いながら、ソート・フィルター・グループ/ツリー・結合・範囲選択と塗りつぶし・マスター/ディテール・セル数式・
|
|
98
|
+
* グリッドデータ統合チャートが必要なときに使います。コアを修正せずに動作を変える override/strategy 拡張カーネルも
|
|
99
|
+
* 併せて提供します。
|
|
100
|
+
*
|
|
101
|
+
* 挂载到容器元素、以虚拟滚动渲染大量行的超轻量数据表格。需要把数千至数十万行当作表格处理,同时使用排序、
|
|
102
|
+
* 筛选、分组/树、合并、范围选择与填充、主从明细、单元格公式、基于表格数据的集成图表时使用。还一并提供
|
|
103
|
+
* 无需修改核心即可改变行为的 override/strategy 扩展内核。
|
|
104
|
+
*
|
|
105
|
+
* @typeParam T - 행 데이터 타입
|
|
106
|
+
*
|
|
107
|
+
* Row data type
|
|
108
|
+
*
|
|
109
|
+
* 行データの型
|
|
110
|
+
*
|
|
111
|
+
* 行数据的类型
|
|
45
112
|
* @example
|
|
46
113
|
* const grid = new OpenGrid('#host', {
|
|
47
114
|
* columns: [
|
|
@@ -61,25 +128,81 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
61
128
|
private _ro;
|
|
62
129
|
private _renderer;
|
|
63
130
|
private _appearance;
|
|
64
|
-
/**
|
|
131
|
+
/**
|
|
132
|
+
* R12c: per-instance 아이콘 오버라이드 레지스트리(전역 iconRegistry 의 child). 첫 setIcon 때 지연 생성.
|
|
133
|
+
*
|
|
134
|
+
* R12c: per-instance icon override registry (a child of the global iconRegistry); lazily created on the first setIcon.
|
|
135
|
+
*
|
|
136
|
+
* R12c: インスタンスごとのアイコンオーバーライドレジストリ(グローバル iconRegistry の child)。最初の setIcon 時に遅延生成。
|
|
137
|
+
*
|
|
138
|
+
* R12c: 按实例的图标覆盖注册表(全局 iconRegistry 的 child)。首次 setIcon 时延迟创建。
|
|
139
|
+
*/
|
|
65
140
|
private _icons;
|
|
66
|
-
/**
|
|
141
|
+
/**
|
|
142
|
+
* i18n: per-instance 로케일 오버라이드 레지스트리(전역 localeRegistry 의 child). locale/messages 옵션 또는 첫 setLocale/setMessage 때 지연 생성.
|
|
143
|
+
*
|
|
144
|
+
* i18n: per-instance locale override registry (a child of the global localeRegistry); lazily created from the locale/messages options or on the first setLocale/setMessage.
|
|
145
|
+
*
|
|
146
|
+
* i18n: インスタンスごとのロケールオーバーライドレジストリ(グローバル localeRegistry の child)。locale/messages オプション、または最初の setLocale/setMessage 時に遅延生成。
|
|
147
|
+
*
|
|
148
|
+
* i18n: 按实例的区域设置覆盖注册表(全局 localeRegistry 的 child)。由 locale/messages 选项,或首次 setLocale/setMessage 时延迟创建。
|
|
149
|
+
*/
|
|
67
150
|
private _locales;
|
|
68
151
|
private _sfMgr;
|
|
69
152
|
private _rowMgr;
|
|
70
153
|
private _editMgr;
|
|
71
154
|
private _trigMgr;
|
|
72
155
|
private _destroyed;
|
|
73
|
-
/**
|
|
156
|
+
/**
|
|
157
|
+
* R5(§3.1 C4): 렌더 루프 컨트롤러. `_mount` 에서 renderer/vs 배선 초입에 생성.
|
|
158
|
+
*
|
|
159
|
+
* R5 (§3.1 C4): the render-loop controller; created in `_mount` at the start of the renderer/vs wiring.
|
|
160
|
+
*
|
|
161
|
+
* R5(§3.1 C4): レンダーループのコントローラ。`_mount` で renderer/vs 配線の冒頭に生成。
|
|
162
|
+
*
|
|
163
|
+
* R5(§3.1 C4): 渲染循环的控制器。在 `_mount` 中于 renderer/vs 配线的开头生成。
|
|
164
|
+
*/
|
|
74
165
|
private _render;
|
|
75
|
-
/**
|
|
166
|
+
/**
|
|
167
|
+
* R6(§3.1 C5): 데이터 변경 서비스(setData/insert/push/delete/writeCell/writeCells + batch + commit).
|
|
168
|
+
*
|
|
169
|
+
* R6 (§3.1 C5): the data mutation service (setData/insert/push/delete/writeCell/writeCells + batch + commit).
|
|
170
|
+
*
|
|
171
|
+
* R6(§3.1 C5): データ変更サービス(setData/insert/push/delete/writeCell/writeCells + batch + commit)。
|
|
172
|
+
*
|
|
173
|
+
* R6(§3.1 C5): 数据变更服务(setData/insert/push/delete/writeCell/writeCells + batch + commit)。
|
|
174
|
+
*/
|
|
76
175
|
private _mutation;
|
|
77
|
-
/**
|
|
176
|
+
/**
|
|
177
|
+
* R7(§3.1 C9): F3 수식 컨트롤러(accessor 조립·recalc flush·에러 표현 + 공개 수식 API).
|
|
178
|
+
*
|
|
179
|
+
* R7 (§3.1 C9): the F3 formula controller (accessor assembly, recalc flush, error surfacing + the public formula API).
|
|
180
|
+
*
|
|
181
|
+
* R7(§3.1 C9): F3 数式コントローラ(accessor の組み立て・recalc の flush・エラー表現 + 公開数式 API)。
|
|
182
|
+
*
|
|
183
|
+
* R7(§3.1 C9): F3 公式控制器(accessor 的组装、recalc 的 flush、错误呈现 + 公开公式 API)。
|
|
184
|
+
*/
|
|
78
185
|
private _formula;
|
|
79
|
-
/**
|
|
186
|
+
/**
|
|
187
|
+
* R7(§3.1 C8): 크로스그리드 컨트롤러(moveRowsTo/매핑/3단계 드롭 발화).
|
|
188
|
+
*
|
|
189
|
+
* R7 (§3.1 C8): the cross-grid controller (moveRowsTo / mapping / three-phase drop emission).
|
|
190
|
+
*
|
|
191
|
+
* R7(§3.1 C8): クロスグリッドのコントローラ(moveRowsTo/マッピング/3 段階ドロップの発火)。
|
|
192
|
+
*
|
|
193
|
+
* R7(§3.1 C8): 跨表格控制器(moveRowsTo/映射/3 阶段拖放的触发)。
|
|
194
|
+
*/
|
|
80
195
|
private _cross;
|
|
81
196
|
private _colWidths;
|
|
82
|
-
/**
|
|
197
|
+
/**
|
|
198
|
+
* 사용자가 헤더 드래그로 직접 조절한 컬럼 폭 (field 기준). _recalcWidths 가 덮어쓰지 않도록 보존
|
|
199
|
+
*
|
|
200
|
+
* Column widths the user adjusted by dragging the header (keyed by field); preserved so that _recalcWidths does not overwrite them.
|
|
201
|
+
*
|
|
202
|
+
* ユーザーがヘッダーのドラッグで直接調整した列幅(field 基準)。_recalcWidths が上書きしないよう保存します。
|
|
203
|
+
*
|
|
204
|
+
* 用户通过拖动表头直接调整的列宽(以 field 为准)。为防止 _recalcWidths 覆盖而保留。
|
|
205
|
+
*/
|
|
83
206
|
private _userWidths;
|
|
84
207
|
private _filterPanel;
|
|
85
208
|
private _filterSelect;
|
|
@@ -97,29 +220,125 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
97
220
|
private _findMgr;
|
|
98
221
|
private _grpMgr;
|
|
99
222
|
private _cellEvt;
|
|
100
|
-
/**
|
|
223
|
+
/**
|
|
224
|
+
* F1: 범위 선택 + 채우기 핸들 배선 관리자(11_design_F1_v2.md).
|
|
225
|
+
*
|
|
226
|
+
* F1: the manager wiring range selection + the fill handle (11_design_F1_v2.md).
|
|
227
|
+
*
|
|
228
|
+
* F1: 範囲選択 + 塗りつぶしハンドルの配線マネージャ(11_design_F1_v2.md)。
|
|
229
|
+
*
|
|
230
|
+
* F1: 范围选择 + 填充手柄的配线管理器(11_design_F1_v2.md)。
|
|
231
|
+
*/
|
|
101
232
|
private _rangeMgr;
|
|
102
|
-
/**
|
|
233
|
+
/**
|
|
234
|
+
* F2: 마스터/디테일 배선(11_design_F2_v2.md). 헤드리스 코어(core/detail/*)를 소비.
|
|
235
|
+
*
|
|
236
|
+
* F2: master/detail wiring (11_design_F2_v2.md); consumes the headless core (core/detail/*).
|
|
237
|
+
*
|
|
238
|
+
* F2: マスター/ディテールの配線(11_design_F2_v2.md)。ヘッドレスコア(core/detail/*)を利用。
|
|
239
|
+
*
|
|
240
|
+
* F2: 主从明细的配线(11_design_F2_v2.md)。使用无头核心(core/detail/*)。
|
|
241
|
+
*/
|
|
103
242
|
private _detailMgr;
|
|
104
|
-
/**
|
|
243
|
+
/**
|
|
244
|
+
* F4: 그리드 데이터 통합 차트 오케스트레이터(11_design_F4_v2.md). 헤드리스 chart/* 소비.
|
|
245
|
+
*
|
|
246
|
+
* F4: the grid-data integrated chart orchestrator (11_design_F4_v2.md); consumes the headless chart/*.
|
|
247
|
+
*
|
|
248
|
+
* F4: グリッドデータ統合チャートのオーケストレータ(11_design_F4_v2.md)。ヘッドレスな chart/* を利用。
|
|
249
|
+
*
|
|
250
|
+
* F4: 表格数据集成图表的编排器(11_design_F4_v2.md)。使用无头的 chart/*。
|
|
251
|
+
*/
|
|
105
252
|
private _chartMgr;
|
|
106
|
-
/**
|
|
253
|
+
/**
|
|
254
|
+
* Phase 0(C0.3): flat/visual index ↔ data 리졸버. 어떤 기능도 켜지지 않아도 항상 존재.
|
|
255
|
+
*
|
|
256
|
+
* Phase 0 (C0.3): the flat/visual index ↔ data resolver; always present even when no feature is enabled.
|
|
257
|
+
*
|
|
258
|
+
* Phase 0(C0.3): flat/visual index ↔ data のリゾルバ。どの機能も有効でなくても常に存在します。
|
|
259
|
+
*
|
|
260
|
+
* Phase 0(C0.3): flat/visual index ↔ data 的解析器。即使未启用任何功能也始终存在。
|
|
261
|
+
*/
|
|
107
262
|
private _flatModel;
|
|
108
|
-
/**
|
|
263
|
+
/**
|
|
264
|
+
* F3: 셀 수식 헤드리스 오케스트레이터(core/formula/* 소비, 재구현 아님). 항상 존재(헤드리스라 유휴 비용 0).
|
|
265
|
+
*
|
|
266
|
+
* F3: the headless cell-formula orchestrator (consumes core/formula/*, not a re-implementation); always present (headless, so zero idle cost).
|
|
267
|
+
*
|
|
268
|
+
* F3: セル数式のヘッドレスオーケストレータ(core/formula/* を利用し、再実装ではありません)。常に存在します(ヘッドレスなのでアイドルコストは 0)。
|
|
269
|
+
*
|
|
270
|
+
* F3: 单元格公式的无头编排器(使用 core/formula/*,并非重新实现)。始终存在(无头,空闲成本为 0)。
|
|
271
|
+
*/
|
|
109
272
|
private _recalc;
|
|
110
|
-
/**
|
|
273
|
+
/**
|
|
274
|
+
* F3(C2): writeCell 단건 쓰기가 쌓아두는 dirty seed. endBatch/즉시 flush 시 onValuesChanged 1회로 소비.
|
|
275
|
+
*
|
|
276
|
+
* F3 (C2): dirty seeds accumulated by single writeCell writes; consumed by one onValuesChanged at endBatch/immediate flush.
|
|
277
|
+
*
|
|
278
|
+
* F3(C2): writeCell の単件書き込みが積み上げる dirty seed。endBatch/即時 flush の際に onValuesChanged 1 回で消費します。
|
|
279
|
+
*
|
|
280
|
+
* F3(C2): writeCell 的单件写入所积累的 dirty seed。endBatch/即时 flush 时以 1 次 onValuesChanged 消费。
|
|
281
|
+
*/
|
|
111
282
|
private _formulaDirtySeeds;
|
|
112
|
-
/**
|
|
283
|
+
/**
|
|
284
|
+
* CF 엔진(동적 import 로 조립). 미설정=null → applyCF 콜백 즉시 return(byte-identical).
|
|
285
|
+
*
|
|
286
|
+
* CF engine (lazily assembled).
|
|
287
|
+
*
|
|
288
|
+
* CF エンジン(動的 import で組み立て)。未設定=null → applyCF コールバックは即座に return(byte-identical)。
|
|
289
|
+
*
|
|
290
|
+
* CF 引擎(以动态 import 组装)。未设置=null → applyCF 回调立即 return(byte-identical)。
|
|
291
|
+
*/
|
|
113
292
|
private _cf;
|
|
114
|
-
/**
|
|
293
|
+
/**
|
|
294
|
+
* 컬럼별 통계 캐시(per-render 재계산 금지 — setConditionalFormat/데이터변경 시에만 갱신).
|
|
295
|
+
*
|
|
296
|
+
* Per-column stats cache.
|
|
297
|
+
*
|
|
298
|
+
* 列ごとの統計キャッシュ(レンダーごとの再計算は禁止 — setConditionalFormat/データ変更時のみ更新)。
|
|
299
|
+
*
|
|
300
|
+
* 按列的统计缓存(禁止每次渲染重算 — 仅在 setConditionalFormat/数据变更时更新)。
|
|
301
|
+
*/
|
|
115
302
|
private _cfStats;
|
|
116
|
-
/**
|
|
303
|
+
/**
|
|
304
|
+
* 현재 적용된 CF 규칙(데이터 변경 시 통계 재계산에 재사용).
|
|
305
|
+
*
|
|
306
|
+
* Currently applied CF rules.
|
|
307
|
+
*
|
|
308
|
+
* 現在適用されている CF ルール(データ変更時の統計再計算に再利用)。
|
|
309
|
+
*
|
|
310
|
+
* 当前已应用的 CF 规则(数据变更时的统计重算中复用)。
|
|
311
|
+
*/
|
|
117
312
|
private _cfRules;
|
|
118
|
-
/**
|
|
313
|
+
/**
|
|
314
|
+
* CF 색 시드 읽기 포트(동적 import 후 보관 — cf/ 정적 참조 회피로 별 청크 유지).
|
|
315
|
+
*
|
|
316
|
+
* CF appearance read port.
|
|
317
|
+
*
|
|
318
|
+
* CF の色シード読み取りポート(動的 import 後に保持 — cf/ の静的参照を避けて別チャンクを維持)。
|
|
319
|
+
*
|
|
320
|
+
* CF 的颜色种子读取端口(动态 import 后保留 — 避开对 cf/ 的静态引用以维持独立分块)。
|
|
321
|
+
*/
|
|
119
322
|
private _cfAppearance;
|
|
120
|
-
/**
|
|
323
|
+
/**
|
|
324
|
+
* CF 통계 계산기(cf/ 동적 청크에서 보관 — 동기 재계산용, cf/ 정적 참조 회피).
|
|
325
|
+
*
|
|
326
|
+
* CF stats computer captured from the dynamic chunk.
|
|
327
|
+
*
|
|
328
|
+
* CF の統計計算機(cf/ の動的チャンクから保持 — 同期再計算用、cf/ の静的参照を回避)。
|
|
329
|
+
*
|
|
330
|
+
* CF 的统计计算器(从 cf/ 的动态分块中保留 — 用于同步重算,避开对 cf/ 的静态引用)。
|
|
331
|
+
*/
|
|
121
332
|
private _cfComputeStats;
|
|
122
|
-
/**
|
|
333
|
+
/**
|
|
334
|
+
* RT 컨트롤러(동적 import 로 조립). 미설정=null → 실시간 미배선(byte-identical).
|
|
335
|
+
*
|
|
336
|
+
* Realtime controller (lazily assembled).
|
|
337
|
+
*
|
|
338
|
+
* RT コントローラ(動的 import で組み立て)。未設定=null → リアルタイムは未配線(byte-identical)。
|
|
339
|
+
*
|
|
340
|
+
* RT 控制器(以动态 import 组装)。未设置=null → 实时未配线(byte-identical)。
|
|
341
|
+
*/
|
|
123
342
|
private _rt;
|
|
124
343
|
private _ovk;
|
|
125
344
|
/**
|
|
@@ -127,60 +346,183 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
127
346
|
* 레이어를 얹고(`grid.override(name, (orig, ...args) => ...)`), `.strategy(slot, fn)` 으로는 코어가
|
|
128
347
|
* 미리 열어 둔 확장 슬롯(예: 표시 텍스트 포맷터)에 함수를 꽂는다. 특정 그리드의 표시·계산·검증 로직만
|
|
129
348
|
* 살짝 바꾸고 싶을 때 상속·포크 없이 쓰는 훅. destroy 시 모든 레이어가 자동 복구된다.
|
|
130
|
-
*
|
|
349
|
+
*
|
|
350
|
+
* Entry point to wrap and change this instance's public-method behavior without editing the core.
|
|
131
351
|
* Calling it layers a wrapper over the original (`grid.override(name, (orig, ...args) => ...)`);
|
|
132
352
|
* `.strategy(slot, fn)` plugs a function into a slot the core opened in advance (e.g. the display
|
|
133
353
|
* formatter). Use it as a hook when you want to tweak one grid's display/compute/validation logic
|
|
134
354
|
* without subclassing or forking. All layers are restored automatically on destroy.
|
|
355
|
+
*
|
|
356
|
+
* このインスタンスの公開メソッドの動作を、コアを修正せずにラップして変える入口です。呼び出すと元のメソッドを包む
|
|
357
|
+
* レイヤーを重ね(`grid.override(name, (orig, ...args) => ...)`)、`.strategy(slot, fn)` ではコアがあらかじめ
|
|
358
|
+
* 開いておいた拡張スロット(例: 表示テキストのフォーマッタ)に関数を差し込みます。特定のグリッドの表示・計算・検証
|
|
359
|
+
* ロジックだけを少し変えたいときに、継承やフォークなしで使うフックです。destroy 時にすべてのレイヤーが自動的に
|
|
360
|
+
* 復元されます。
|
|
361
|
+
*
|
|
362
|
+
* 把这个实例的公开方法行为包起来、无需修改核心即可改变的入口。调用后会在原方法之上叠加一层包装
|
|
363
|
+
* (`grid.override(name, (orig, ...args) => ...)`),`.strategy(slot, fn)` 则把函数插入核心事先开放的
|
|
364
|
+
* 扩展槽(例如显示文本的格式化器)。想只稍微改动某个表格的显示、计算、校验逻辑时,可以不用继承或 fork 而使用的
|
|
365
|
+
* 钩子。destroy 时所有层都会自动恢复。
|
|
366
|
+
*
|
|
135
367
|
* @example
|
|
136
368
|
* grid.override('getDisplayValue', (orig, ri, field) => orig(ri, field).toUpperCase());
|
|
137
369
|
* grid.override.strategy('displayFormatter', (v) => v == null ? '-' : String(v));
|
|
138
370
|
*/
|
|
139
371
|
override: OverrideApi<T>;
|
|
140
|
-
/**
|
|
372
|
+
/**
|
|
373
|
+
* R11(§3.1 C7): 커널 위 타입드 확장점 레지스트리. _mount 초입에 생성(커널 준비 후).
|
|
374
|
+
*
|
|
375
|
+
* R11 (§3.1 C7): the typed extension-point registry on top of the kernel; created at the start of _mount (after the kernel is ready).
|
|
376
|
+
*
|
|
377
|
+
* R11(§3.1 C7): カーネル上の型付き拡張点レジストリ。_mount の冒頭で生成(カーネル準備後)。
|
|
378
|
+
*
|
|
379
|
+
* R11(§3.1 C7): 内核之上的类型化扩展点注册表。在 _mount 的开头生成(内核准备完成后)。
|
|
380
|
+
*/
|
|
141
381
|
private _extensions;
|
|
142
382
|
/**
|
|
143
383
|
* 확장점 레지스트리 정면 — 렌더훅 등록, strategy/override 타입드 카탈로그, 커밋 전후 훅(MutationHook)을
|
|
144
384
|
* 한곳에서 발견·등록한다. 코어를 고치지 않고 셀 클래스·aria 라벨·표시 텍스트 같은 렌더 파이프라인 지점에
|
|
145
385
|
* 끼어들고 싶을 때 진입점으로 쓴다. 반환값으로 훅을 등록하면 다음 렌더부터 반영된다.
|
|
146
|
-
*
|
|
386
|
+
*
|
|
387
|
+
* Facade for the extension-point registry — discover and register render hooks, the typed
|
|
147
388
|
* strategy/override catalog, and before/after commit hooks (MutationHook) in one place. Use it as
|
|
148
389
|
* the entry point when you want to hook into the render pipeline (cell class, aria label, display
|
|
149
390
|
* text) without editing the core; hooks you register apply from the next render on.
|
|
150
391
|
*
|
|
151
|
-
*
|
|
392
|
+
* 拡張点レジストリのファサード — レンダーフックの登録、strategy/override の型付きカタログ、コミット前後のフック
|
|
393
|
+
* (MutationHook)を一箇所で発見・登録します。コアを修正せずに、セルクラス・aria ラベル・表示テキストといった
|
|
394
|
+
* レンダーパイプラインの地点に割り込みたいときの入口として使います。戻り値でフックを登録すると、次のレンダーから
|
|
395
|
+
* 反映されます。
|
|
396
|
+
*
|
|
397
|
+
* 扩展点注册表的门面 — 在一处发现并注册渲染钩子、strategy/override 的类型化目录、提交前后的钩子
|
|
398
|
+
* (MutationHook)。想在不修改核心的前提下,介入单元格类名、aria 标签、显示文本这类渲染管线的地点时,
|
|
399
|
+
* 用它作为入口。用返回值注册钩子后,从下一次渲染开始生效。
|
|
400
|
+
*
|
|
401
|
+
* @returns 확장점 레지스트리
|
|
402
|
+
*
|
|
403
|
+
* The extension-point registry
|
|
404
|
+
*
|
|
405
|
+
* 拡張点レジストリ
|
|
406
|
+
*
|
|
407
|
+
* 扩展点注册表
|
|
152
408
|
*/
|
|
153
409
|
get extensions(): ExtensionPointRegistry<T>;
|
|
154
|
-
/**
|
|
410
|
+
/**
|
|
411
|
+
* 정적 전역 override 레이어 (모든 신규 인스턴스에 생성자 말미 적용).
|
|
412
|
+
*
|
|
413
|
+
* Static global override layers (applied at the end of the constructor to every new instance).
|
|
414
|
+
*
|
|
415
|
+
* 静的グローバルな override レイヤー(すべての新規インスタンスにコンストラクタ末尾で適用)。
|
|
416
|
+
*
|
|
417
|
+
* 静态全局的 override 层(在构造函数末尾应用到所有新实例)。
|
|
418
|
+
*/
|
|
155
419
|
private static _defaultOverrides;
|
|
156
|
-
/**
|
|
420
|
+
/**
|
|
421
|
+
* 정적 전역 strategy 슬롯.
|
|
422
|
+
*
|
|
423
|
+
* Static global strategy slots.
|
|
424
|
+
*
|
|
425
|
+
* 静的グローバルな strategy スロット。
|
|
426
|
+
*
|
|
427
|
+
* 静态全局的 strategy 槽。
|
|
428
|
+
*/
|
|
157
429
|
private static _defaultStrategies;
|
|
158
430
|
/**
|
|
159
|
-
* 정적: 모든 신규 그리드에 적용될 override 레이어 등록.
|
|
160
|
-
*
|
|
431
|
+
* 정적: 모든 신규 그리드에 적용될 override 레이어 등록.
|
|
432
|
+
*
|
|
433
|
+
* Static: register an override layer applied to every newly created grid.
|
|
434
|
+
*
|
|
435
|
+
* 静的: すべての新規グリッドに適用される override レイヤーを登録。
|
|
436
|
+
*
|
|
437
|
+
* 静态: 注册应用到所有新建表格的 override 层。
|
|
438
|
+
*
|
|
439
|
+
* @param name - 대상 공개 메서드 이름
|
|
440
|
+
*
|
|
441
|
+
* Target public method name
|
|
442
|
+
*
|
|
443
|
+
* 対象となる公開メソッド名
|
|
444
|
+
*
|
|
445
|
+
* 目标公开方法名
|
|
446
|
+
*
|
|
447
|
+
* @param fn - override 레이어 함수(첫 인자 orig)
|
|
448
|
+
*
|
|
449
|
+
* Override layer function (first arg = orig)
|
|
450
|
+
*
|
|
451
|
+
* override レイヤー関数(第 1 引数が orig)
|
|
452
|
+
*
|
|
453
|
+
* override 层函数(第 1 个参数为 orig)
|
|
454
|
+
*
|
|
455
|
+
* @param opts - 재진입/에러 정책
|
|
456
|
+
*
|
|
457
|
+
* Reentrancy & error policy
|
|
458
|
+
*
|
|
459
|
+
* 再入/エラーのポリシー
|
|
460
|
+
*
|
|
461
|
+
* 重入/错误的策略
|
|
462
|
+
*
|
|
463
|
+
* @returns 체이닝용 OpenGrid 클래스
|
|
464
|
+
*
|
|
465
|
+
* The OpenGrid class for chaining
|
|
466
|
+
*
|
|
467
|
+
* チェーン用の OpenGrid クラス
|
|
468
|
+
*
|
|
469
|
+
* 用于链式调用的 OpenGrid 类
|
|
161
470
|
*
|
|
162
|
-
* @param name - 대상 공개 메서드 이름 / Target public method name
|
|
163
|
-
* @param fn - override 레이어 함수(첫 인자 orig) / Override layer function (first arg = orig)
|
|
164
|
-
* @param opts - 재진입/에러 정책 / Reentrancy & error policy
|
|
165
|
-
* @returns 체이닝용 OpenGrid 클래스 / The OpenGrid class for chaining
|
|
166
471
|
* @example
|
|
167
472
|
* OpenGrid.defaultOverride('getDisplayValue', (orig, ri, field) => orig(ri, field).toUpperCase());
|
|
168
473
|
*/
|
|
169
474
|
static defaultOverride(name: string, fn: OverrideLayer, opts?: OverrideCallOptions): typeof OpenGrid;
|
|
170
|
-
/**
|
|
475
|
+
/**
|
|
476
|
+
* 정적 전역 defaults 네임스페이스 (strategy 슬롯).
|
|
477
|
+
*
|
|
478
|
+
* Static global defaults namespace (strategy slots).
|
|
479
|
+
*
|
|
480
|
+
* 静的グローバルな defaults 名前空間(strategy スロット)。
|
|
481
|
+
*
|
|
482
|
+
* 静态全局的 defaults 命名空间(strategy 槽)。
|
|
483
|
+
*/
|
|
171
484
|
static defaults: {
|
|
172
485
|
strategy(slot: string, fn: Function): typeof OpenGrid;
|
|
173
486
|
};
|
|
174
487
|
/**
|
|
175
488
|
* 커스텀 셀 렌더러 타입을 코어 편집 없이 등록. `col.type`/`col.renderer`(문자열 또는 `{type}`)가
|
|
176
489
|
* `typeName` 과 일치하면 등록 팩토리가 렌더러를 생성한다. 프로세스 전역(모든 그리드 인스턴스 공유).
|
|
177
|
-
*
|
|
490
|
+
*
|
|
491
|
+
* Register a custom cell renderer type without editing the core. When `col.type`/`col.renderer`
|
|
178
492
|
* (string or `{type}`) matches `typeName`, the registered factory creates the renderer.
|
|
179
493
|
* Process-global (shared by all grid instances).
|
|
180
494
|
*
|
|
181
|
-
*
|
|
182
|
-
*
|
|
183
|
-
*
|
|
495
|
+
* カスタムセルレンダラーの型を、コアを修正せずに登録します。`col.type`/`col.renderer`(文字列または `{type}`)が
|
|
496
|
+
* `typeName` と一致すると、登録したファクトリがレンダラーを生成します。プロセスグローバル(すべてのグリッド
|
|
497
|
+
* インスタンスで共有)。
|
|
498
|
+
*
|
|
499
|
+
* 注册自定义单元格渲染器的类型,无需修改核心。`col.type`/`col.renderer`(字符串或 `{type}`)与
|
|
500
|
+
* `typeName` 一致时,注册的工厂会生成渲染器。进程全局(所有表格实例共享)。
|
|
501
|
+
*
|
|
502
|
+
* @param typeName - 렌더러 타입 이름
|
|
503
|
+
*
|
|
504
|
+
* Renderer type name
|
|
505
|
+
*
|
|
506
|
+
* レンダラーの型名
|
|
507
|
+
*
|
|
508
|
+
* 渲染器的类型名
|
|
509
|
+
*
|
|
510
|
+
* @param factory - 렌더러 팩토리
|
|
511
|
+
*
|
|
512
|
+
* Renderer factory
|
|
513
|
+
*
|
|
514
|
+
* レンダラーのファクトリ
|
|
515
|
+
*
|
|
516
|
+
* 渲染器的工厂
|
|
517
|
+
*
|
|
518
|
+
* @returns 체이닝용 OpenGrid 클래스
|
|
519
|
+
*
|
|
520
|
+
* The OpenGrid class for chaining
|
|
521
|
+
*
|
|
522
|
+
* チェーン用の OpenGrid クラス
|
|
523
|
+
*
|
|
524
|
+
* 用于链式调用的 OpenGrid 类
|
|
525
|
+
*
|
|
184
526
|
* @example
|
|
185
527
|
* OpenGrid.registerRenderer('stars', () => ({ render: (ctx) => '★'.repeat(ctx.value) }));
|
|
186
528
|
*/
|
|
@@ -189,13 +531,43 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
189
531
|
* 커스텀 셀 에디터 타입을 코어 편집 없이 등록한다. 셀을 편집 상태로 열 때 `col.editor` 가 `typeName`
|
|
190
532
|
* 과 일치하면 등록한 팩토리가 에디터를 만든다. 기본 제공 에디터(text/number/date 등)로 부족한 입력 UI가
|
|
191
533
|
* 필요할 때 쓴다. 프로세스 전역이라 한 번 등록하면 모든 그리드 인스턴스가 공유한다.
|
|
192
|
-
*
|
|
534
|
+
*
|
|
535
|
+
* Register a custom cell editor type without editing the core. When a cell opens for editing and
|
|
193
536
|
* `col.editor` matches `typeName`, the registered factory creates the editor. Use it when the
|
|
194
537
|
* built-in editors (text/number/date, …) are not enough. Process-global (shared by all instances).
|
|
195
538
|
*
|
|
196
|
-
*
|
|
197
|
-
*
|
|
198
|
-
*
|
|
539
|
+
* カスタムセルエディタの型を、コアを修正せずに登録します。セルを編集状態で開くとき `col.editor` が `typeName`
|
|
540
|
+
* と一致すると、登録したファクトリがエディタを生成します。標準提供のエディタ(text/number/date など)では足りない
|
|
541
|
+
* 入力 UI が必要なときに使います。プロセスグローバルなので、一度登録すればすべてのグリッドインスタンスで共有されます。
|
|
542
|
+
*
|
|
543
|
+
* 注册自定义单元格编辑器的类型,无需修改核心。打开单元格进入编辑状态时,若 `col.editor` 与 `typeName`
|
|
544
|
+
* 一致,注册的工厂会创建编辑器。内置编辑器(text/number/date 等)不够用时使用。进程全局,注册一次后所有
|
|
545
|
+
* 表格实例共享。
|
|
546
|
+
*
|
|
547
|
+
* @param typeName - 에디터 타입 이름
|
|
548
|
+
*
|
|
549
|
+
* Editor type name
|
|
550
|
+
*
|
|
551
|
+
* エディタの型名
|
|
552
|
+
*
|
|
553
|
+
* 编辑器的类型名
|
|
554
|
+
*
|
|
555
|
+
* @param factory - 에디터 팩토리
|
|
556
|
+
*
|
|
557
|
+
* Editor factory
|
|
558
|
+
*
|
|
559
|
+
* エディタのファクトリ
|
|
560
|
+
*
|
|
561
|
+
* 编辑器的工厂
|
|
562
|
+
*
|
|
563
|
+
* @returns 체이닝용 OpenGrid 클래스
|
|
564
|
+
*
|
|
565
|
+
* The OpenGrid class for chaining
|
|
566
|
+
*
|
|
567
|
+
* チェーン用の OpenGrid クラス
|
|
568
|
+
*
|
|
569
|
+
* 用于链式调用的 OpenGrid 类
|
|
570
|
+
*
|
|
199
571
|
* @example
|
|
200
572
|
* OpenGrid.registerEditor('slider', () => {
|
|
201
573
|
* let input: HTMLInputElement;
|
|
@@ -219,18 +591,51 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
219
591
|
* 그리드의 "생김새"만 바꾸고 싶을 때 쓴다 — 한 번 등록하면 어떤 인스턴스든 `grid.setSkin(name)` 으로
|
|
220
592
|
* 골라 쓴다. 내부 동작: 델타를 FORM 전용으로 검증(색 리터럴이 섞이면 색⊥형태 직교성을 깨므로 **throw**)하고
|
|
221
593
|
* 포커스 링 접근성 가드레일을 적용한 뒤, 런타임 `<style>` 로 `.og-container[data-og-skin="name"]` 블록을 주입한다.
|
|
222
|
-
*
|
|
594
|
+
*
|
|
595
|
+
* Register a custom skin (the FORM axis — shape/border/radius) globally without editing the core.
|
|
223
596
|
* Use it when you want to restyle only the grid's "look" independently of the color theme; once
|
|
224
597
|
* registered, any instance can pick it via `grid.setSkin(name)`. It validates the delta as
|
|
225
598
|
* FORM-only (**throws** if a color literal is present, to keep color⊥form orthogonal), applies the
|
|
226
599
|
* focus-ring accessibility guardrail, then injects a runtime `<style>` block for
|
|
227
600
|
* `.og-container[data-og-skin="name"]`.
|
|
228
601
|
*
|
|
229
|
-
*
|
|
230
|
-
*
|
|
231
|
-
*
|
|
602
|
+
* カスタムスキン(形状・輪郭線・角丸といった FORM 軸)を、コアを修正せずにグローバル登録します。カラーテーマとは
|
|
603
|
+
* 別に、グリッドの「見た目」だけを変えたいときに使います — 一度登録すれば、どのインスタンスでも
|
|
604
|
+
* `grid.setSkin(name)` で選んで使えます。内部動作: デルタを FORM 専用として検証し(色リテラルが混ざると
|
|
605
|
+
* 色⊥形状の直交性が崩れるため **throw**)、フォーカスリングのアクセシビリティガードレールを適用したうえで、
|
|
606
|
+
* ランタイムの `<style>` で `.og-container[data-og-skin="name"]` ブロックを注入します。
|
|
607
|
+
*
|
|
608
|
+
* 把自定义皮肤(形状、轮廓线、圆角这类 FORM 轴)在不修改核心的前提下全局注册。想与颜色主题分开、只改表格的
|
|
609
|
+
* 「外观」时使用 — 一旦注册,任何实例都能用 `grid.setSkin(name)` 选用。内部动作: 把 delta 作为 FORM 专用
|
|
610
|
+
* 校验(混入颜色字面量会破坏色⊥形的正交性,故 **throw**),应用焦点环的无障碍护栏,再以运行时 `<style>` 注入
|
|
611
|
+
* `.og-container[data-og-skin="name"]` 块。
|
|
612
|
+
*
|
|
613
|
+
* @param name - 스킨 id
|
|
614
|
+
*
|
|
615
|
+
* Skin id
|
|
616
|
+
*
|
|
617
|
+
* スキン id
|
|
618
|
+
*
|
|
619
|
+
* 皮肤 id
|
|
620
|
+
*
|
|
621
|
+
* @param delta - FORM 전용 토큰 델타(색값 넣으면 throw)
|
|
622
|
+
*
|
|
623
|
+
* FORM-only token delta (throws on color values)
|
|
624
|
+
*
|
|
625
|
+
* FORM 専用のトークンデルタ(色値を入れると throw)
|
|
626
|
+
*
|
|
627
|
+
* FORM 专用的 token delta(放入颜色值则 throw)
|
|
628
|
+
*
|
|
629
|
+
* @returns 체이닝용 OpenGrid 클래스
|
|
630
|
+
*
|
|
631
|
+
* The OpenGrid class for chaining
|
|
632
|
+
*
|
|
633
|
+
* チェーン用の OpenGrid クラス
|
|
634
|
+
*
|
|
635
|
+
* 用于链式调用的 OpenGrid 类
|
|
636
|
+
*
|
|
232
637
|
* @example
|
|
233
|
-
* //
|
|
638
|
+
* // Adjusts only form tokens, never color.
|
|
234
639
|
* OpenGrid.defineSkin('round', { '--og-radius-md': '14px' });
|
|
235
640
|
* grid.setSkin('round');
|
|
236
641
|
*/
|
|
@@ -240,13 +645,37 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
240
645
|
* 아이콘 대신 자사 아이콘 팩을 쓰고 싶을 때 role → 아이콘을 통째로 매핑한다 — 이후 모든 인스턴스의
|
|
241
646
|
* 아이콘 해석에 반영된다. 값은 알려진 아이콘 key 이거나 원시 SVG 본문 마크업. 한 인스턴스만 바꾸려면
|
|
242
647
|
* `grid.setIcon(role, svg)` 를 쓴다.
|
|
243
|
-
*
|
|
648
|
+
*
|
|
649
|
+
* Register/replace semantic icon role sets (sort arrows, row-delete icon, …) **globally** without
|
|
244
650
|
* editing the core — map role → icon in one shot to swap in your own icon pack; it then affects icon
|
|
245
651
|
* resolution across all instances. Values are known icon keys or raw SVG body markup. To change a
|
|
246
652
|
* single instance only, use `grid.setIcon(role, svg)`.
|
|
247
653
|
*
|
|
248
|
-
*
|
|
249
|
-
*
|
|
654
|
+
* セマンティックなアイコン role のセット(ソート矢印・行削除アイコンなど)を、コアを修正せずに **グローバル** に
|
|
655
|
+
* 差し替えます。標準アイコンの代わりに自社のアイコンパックを使いたいとき、role → アイコンをまとめてマッピング
|
|
656
|
+
* します — 以降、すべてのインスタンスのアイコン解決に反映されます。値は既知のアイコン key、または生の SVG 本体
|
|
657
|
+
* マークアップです。1 つのインスタンスだけを変えるには `grid.setIcon(role, svg)` を使います。
|
|
658
|
+
*
|
|
659
|
+
* 把语义图标 role 集合(排序箭头、行删除图标等)在不修改核心的前提下 **全局** 替换。想用自家图标包代替
|
|
660
|
+
* 默认图标时,把 role → 图标整体映射 — 此后所有实例的图标解析都会反映。值为已知的图标 key,或原始 SVG
|
|
661
|
+
* 主体标记。只想改一个实例时,使用 `grid.setIcon(role, svg)`。
|
|
662
|
+
*
|
|
663
|
+
* @param map - role → 아이콘 key 또는 원시 SVG
|
|
664
|
+
*
|
|
665
|
+
* role → icon key or raw SVG
|
|
666
|
+
*
|
|
667
|
+
* role → アイコン key または生の SVG
|
|
668
|
+
*
|
|
669
|
+
* role → 图标 key 或原始 SVG
|
|
670
|
+
*
|
|
671
|
+
* @returns 체이닝용 OpenGrid 클래스
|
|
672
|
+
*
|
|
673
|
+
* The OpenGrid class for chaining
|
|
674
|
+
*
|
|
675
|
+
* チェーン用の OpenGrid クラス
|
|
676
|
+
*
|
|
677
|
+
* 用于链式调用的 OpenGrid 类
|
|
678
|
+
*
|
|
250
679
|
* @example
|
|
251
680
|
* OpenGrid.defineIconSet({ 'sort.asc': 'arrow-up', 'sort.desc': 'arrow-down' });
|
|
252
681
|
*/
|
|
@@ -257,110 +686,377 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
257
686
|
* 이후 모든 인스턴스가 `grid.setLocale(id)` 로 사용. per-instance 오버라이드는 `grid.setMessage` 참조.
|
|
258
687
|
* 예) OpenGrid.defineLocale('ja', { contextMenu: { find: '検索' } })
|
|
259
688
|
*
|
|
260
|
-
*
|
|
689
|
+
* i18n: register/replace a UI-string locale **globally** without editing the core (thin
|
|
261
690
|
* delegation façade isomorphic to defineSkin/defineIconSet — the canonical entry is
|
|
262
691
|
* `localeRegistry.register`). Partial catalogs are allowed (ko fills the gaps via fallback).
|
|
263
692
|
* Any instance can then call `grid.setLocale(id)`. For per-instance overrides see `grid.setMessage`.
|
|
264
693
|
*
|
|
265
|
-
*
|
|
266
|
-
*
|
|
267
|
-
*
|
|
268
|
-
*
|
|
694
|
+
* i18n: UI 文字列のロケールを、コアを修正せずに **グローバル** に登録/差し替えします(defineSkin/defineIconSet と
|
|
695
|
+
* 同型の薄い委譲ファサード — 正本は `localeRegistry.register`)。部分カタログを許容します(不足分はフォールバックで
|
|
696
|
+
* ko が埋めます)。以降、すべてのインスタンスが `grid.setLocale(id)` で使用できます。インスタンスごとの
|
|
697
|
+
* オーバーライドは `grid.setMessage` を参照してください。
|
|
698
|
+
*
|
|
699
|
+
* i18n: 把 UI 字符串的区域设置在不修改核心的前提下 **全局** 注册/替换(与 defineSkin/defineIconSet 同型的
|
|
700
|
+
* 薄委托门面 — 正本是 `localeRegistry.register`)。允许部分目录(缺失部分由回退的 ko 填补)。此后所有实例
|
|
701
|
+
* 都能用 `grid.setLocale(id)` 使用。按实例的覆盖请参阅 `grid.setMessage`。
|
|
702
|
+
* 例) OpenGrid.defineLocale('ja', { contextMenu: { find: '検索' } })
|
|
703
|
+
*
|
|
704
|
+
* @param id - 로케일 id(예 'ja')
|
|
705
|
+
*
|
|
706
|
+
* Locale id (e.g. 'ja')
|
|
707
|
+
*
|
|
708
|
+
* ロケール id(例 'ja')
|
|
709
|
+
*
|
|
710
|
+
* 区域设置 id(例 'ja')
|
|
711
|
+
*
|
|
712
|
+
* @param messages - 메시지 부분/전체 카탈로그
|
|
713
|
+
*
|
|
714
|
+
* Partial or full message catalog
|
|
715
|
+
*
|
|
716
|
+
* メッセージの部分/全体カタログ
|
|
717
|
+
*
|
|
718
|
+
* 消息的部分/全体目录
|
|
719
|
+
*
|
|
720
|
+
* @param opts - `extends`: ko 이전에 시도할 폴백 로케일
|
|
721
|
+
*
|
|
722
|
+
* `extends`: fallback locale tried before ko
|
|
723
|
+
*
|
|
724
|
+
* `extends`: ko より前に試すフォールバックロケール
|
|
725
|
+
*
|
|
726
|
+
* `extends`: 比 ko 更先尝试的回退区域设置
|
|
727
|
+
*
|
|
728
|
+
* @returns 체이닝용 OpenGrid 클래스
|
|
729
|
+
*
|
|
730
|
+
* The OpenGrid class for chaining
|
|
731
|
+
*
|
|
732
|
+
* チェーン用の OpenGrid クラス
|
|
733
|
+
*
|
|
734
|
+
* 用于链式调用的 OpenGrid 类
|
|
269
735
|
*/
|
|
270
736
|
static defineLocale(id: string, messages: PartialLocaleMessages, opts?: {
|
|
271
737
|
extends?: string;
|
|
272
738
|
}): typeof OpenGrid;
|
|
273
739
|
/**
|
|
274
|
-
* 그리드를 생성해 컨테이너에 마운트한다.
|
|
740
|
+
* 그리드를 생성해 컨테이너에 마운트한다.
|
|
275
741
|
*
|
|
276
|
-
*
|
|
277
|
-
*
|
|
278
|
-
*
|
|
279
|
-
*
|
|
742
|
+
* Create the grid and mount it into the container.
|
|
743
|
+
*
|
|
744
|
+
* グリッドを生成してコンテナにマウントします。
|
|
745
|
+
*
|
|
746
|
+
* 生成表格并挂载到容器。
|
|
747
|
+
*
|
|
748
|
+
* @param container - CSS 셀렉터 또는 호스트 요소
|
|
749
|
+
*
|
|
750
|
+
* CSS selector or host element
|
|
751
|
+
*
|
|
752
|
+
* CSS セレクタまたはホスト要素
|
|
753
|
+
*
|
|
754
|
+
* CSS 选择器或宿主元素
|
|
755
|
+
*
|
|
756
|
+
* @param options - 그리드 옵션(columns 필수)
|
|
757
|
+
*
|
|
758
|
+
* Grid options (columns required)
|
|
759
|
+
*
|
|
760
|
+
* グリッドオプション(columns は必須)
|
|
761
|
+
*
|
|
762
|
+
* 表格选项(columns 必填)
|
|
763
|
+
*
|
|
764
|
+
* @example
|
|
765
|
+
* const grid = new OpenGrid('#host', { columns: [{ field: 'id', header: 'ID' }] });
|
|
280
766
|
*/
|
|
281
767
|
constructor(container: string | HTMLElement, options: GridOptions<T>);
|
|
282
|
-
/**
|
|
768
|
+
/**
|
|
769
|
+
* 특정 메서드에 얹은 override 하나만 벗겨 원본 동작으로 되돌린다(다른 override 는 유지).
|
|
770
|
+
*
|
|
771
|
+
* Peel off one method's override, restoring its original behavior (others stay).
|
|
772
|
+
*
|
|
773
|
+
* 特定のメソッドに重ねた override を 1 つだけ剥がし、元の動作に戻します(ほかの override は維持)。
|
|
774
|
+
*
|
|
775
|
+
* 只剥掉某个方法上叠加的一层 override,恢复原本动作(其他 override 保持不变)。
|
|
776
|
+
*/
|
|
283
777
|
restore(name: string): this;
|
|
284
|
-
/**
|
|
778
|
+
/**
|
|
779
|
+
* 얹어 둔 모든 override·strategy 를 한 번에 걷어 낸다. destroy 가 자동으로 호출하므로 보통 직접 부를 일은 없다.
|
|
780
|
+
*
|
|
781
|
+
* Remove every override & strategy at once; destroy calls it automatically, so you rarely need it directly.
|
|
782
|
+
*
|
|
783
|
+
* 重ねてあるすべての override・strategy を一度に取り除きます。destroy が自動的に呼ぶため、通常は直接呼ぶ必要はありません。
|
|
784
|
+
*
|
|
785
|
+
* 把叠加的所有 override、strategy 一次性撤除。destroy 会自动调用,通常无需直接调用。
|
|
786
|
+
*/
|
|
285
787
|
restoreAll(): this;
|
|
286
|
-
/**
|
|
788
|
+
/**
|
|
789
|
+
* 해당 메서드가 지금 override 로 감싸여 있는지 확인한다(조건부로 override 를 얹기 전 점검용).
|
|
790
|
+
*
|
|
791
|
+
* Check whether the method is currently wrapped by an override (handy before layering conditionally).
|
|
792
|
+
*
|
|
793
|
+
* そのメソッドが現在 override で包まれているかを確認します(条件付きで override を重ねる前の点検用)。
|
|
794
|
+
*
|
|
795
|
+
* 确认该方法当前是否被 override 包裹(便于在有条件地叠加 override 之前检查)。
|
|
796
|
+
*/
|
|
287
797
|
hasOverride(name: string): boolean;
|
|
288
|
-
/**
|
|
798
|
+
/**
|
|
799
|
+
* 현재 override 가 걸린 메서드 이름들을 돌려준다(무엇을 손댔는지 감사·디버깅용).
|
|
800
|
+
*
|
|
801
|
+
* Names of currently overridden methods — for auditing/debugging what you have touched.
|
|
802
|
+
*
|
|
803
|
+
* 現在 override が掛かっているメソッド名を返します(何に手を入れたかの監査・デバッグ用)。
|
|
804
|
+
*
|
|
805
|
+
* 返回当前被 override 的方法名(用于审计、调试改动了什么)。
|
|
806
|
+
*/
|
|
289
807
|
getOverrideNames(): string[];
|
|
290
|
-
/**
|
|
808
|
+
/**
|
|
809
|
+
* strategy 슬롯에 꽂힌 함수를 읽는다. 미등록이면 넘긴 fallback 을 그대로 돌려주므로 호출부는 항상 함수를 얻는다.
|
|
810
|
+
*
|
|
811
|
+
* Read the function plugged into a strategy slot; returns your fallback when unset, so callers always get a function.
|
|
812
|
+
*
|
|
813
|
+
* strategy スロットに差し込まれた関数を読み取ります。未登録の場合は渡した fallback をそのまま返すため、呼び出し側は常に関数を得られます。
|
|
814
|
+
*
|
|
815
|
+
* 读取插入 strategy 槽的函数。未注册时原样返回传入的 fallback,因此调用方总能得到一个函数。
|
|
816
|
+
*/
|
|
291
817
|
getStrategy<F extends Function>(slot: string, fallback: F): F;
|
|
292
818
|
private _mount;
|
|
293
819
|
private _initContextMenu;
|
|
294
820
|
/**
|
|
295
|
-
* 컨텍스트 메뉴를 지정 좌표에 연다.
|
|
821
|
+
* 컨텍스트 메뉴를 지정 좌표에 연다.
|
|
822
|
+
*
|
|
823
|
+
* Open the context menu at the event position.
|
|
824
|
+
*
|
|
825
|
+
* コンテキストメニューを指定座標に開きます。
|
|
826
|
+
*
|
|
827
|
+
* 在指定坐标打开上下文菜单。
|
|
828
|
+
*
|
|
829
|
+
* @param e - 좌표를 제공할 마우스 이벤트
|
|
830
|
+
*
|
|
831
|
+
* Mouse event providing coordinates
|
|
832
|
+
*
|
|
833
|
+
* 座標を提供するマウスイベント
|
|
834
|
+
*
|
|
835
|
+
* 提供坐标的鼠标事件
|
|
836
|
+
*
|
|
837
|
+
* @param items - 커스텀 메뉴 항목(생략 시 기본 메뉴)
|
|
838
|
+
*
|
|
839
|
+
* Custom items (default menu when omitted)
|
|
840
|
+
*
|
|
841
|
+
* カスタムメニュー項目(省略時は既定メニュー)
|
|
296
842
|
*
|
|
297
|
-
*
|
|
298
|
-
* @param items - 커스텀 메뉴 항목(생략 시 기본 메뉴) / Custom items (default menu when omitted)
|
|
843
|
+
* 自定义菜单项(省略时为默认菜单)
|
|
299
844
|
*/
|
|
300
845
|
openContextMenu(e: MouseEvent, items?: import('./types').ContextMenuItem[]): void;
|
|
301
|
-
/**
|
|
846
|
+
/**
|
|
847
|
+
* 컨텍스트 메뉴를 닫는다.
|
|
848
|
+
*
|
|
849
|
+
* Close the context menu.
|
|
850
|
+
*
|
|
851
|
+
* コンテキストメニューを閉じます。
|
|
852
|
+
*
|
|
853
|
+
* 关闭上下文菜单。
|
|
854
|
+
*/
|
|
302
855
|
closeContextMenu(): void;
|
|
303
856
|
/**
|
|
304
857
|
* 상위 선택이 하위 선택지를 좁히는 연동(캐스케이딩) 필터 셀렉트 패널을 붙이거나 뗀다. 예를 들어 "국가 →
|
|
305
858
|
* 도시"처럼 앞 컬럼 값에 따라 뒷 컬럼 후보가 달라지는 상단 필터 UI가 필요할 때 config 로 설정하고,
|
|
306
859
|
* `null` 을 넘기면 패널을 제거한다.
|
|
307
|
-
*
|
|
860
|
+
*
|
|
861
|
+
* Attach or detach a cascading filter-select panel where each choice narrows the next (e.g.
|
|
308
862
|
* "country → city", so a later column's options depend on the earlier value). Pass a config to set
|
|
309
863
|
* it up, or `null` to remove the panel.
|
|
310
864
|
*
|
|
311
|
-
*
|
|
865
|
+
* 上位の選択が下位の選択肢を絞り込む連動(カスケーディング)フィルターセレクトパネルを取り付け、または取り外します。
|
|
866
|
+
* たとえば「国 → 都市」のように、前の列の値によって後ろの列の候補が変わる上部フィルター UI が必要なときに config で
|
|
867
|
+
* 設定し、`null` を渡すとパネルを削除します。
|
|
868
|
+
*
|
|
869
|
+
* 装上或卸下上位选择收窄下位选项的联动(级联)筛选选择面板。例如需要「国家 → 城市」这类、后一列的候选
|
|
870
|
+
* 随前一列的值而变化的顶部筛选 UI 时,用 config 设置;传入 `null` 则移除面板。
|
|
871
|
+
*
|
|
872
|
+
* @param config - 패널 구성 또는 제거용 null
|
|
873
|
+
*
|
|
874
|
+
* Panel config, or null to remove
|
|
875
|
+
*
|
|
876
|
+
* パネル構成、または削除用の null
|
|
877
|
+
*
|
|
878
|
+
* 面板配置,或用于移除的 null
|
|
312
879
|
*/
|
|
313
880
|
setFilterSelect(config: FilterSelectConfig | null): void;
|
|
314
881
|
/**
|
|
315
882
|
* 생성 후에 그리드 옵션 일부만 바꿔 끼운다. 그리드를 다시 만들지 않고 컨텍스트 메뉴 구성이나 그룹핑
|
|
316
883
|
* 기준 같은 설정을 바꾸고 싶을 때 쓴다 — 넘긴 옵션만 덮어쓴 뒤, 영향받는 부분(contextMenu 재초기화·
|
|
317
884
|
* groupBy 재구성 등)만 골라 갱신하고 다시 그린다.
|
|
318
|
-
*
|
|
885
|
+
*
|
|
886
|
+
* Swap in part of the grid options after construction. Use it to change settings like the context
|
|
319
887
|
* menu or grouping keys without recreating the grid — only the passed options are overwritten, then
|
|
320
888
|
* just the affected parts (re-init contextMenu, rebuild groupBy, …) are refreshed and re-rendered.
|
|
321
889
|
*
|
|
322
|
-
*
|
|
890
|
+
* 生成後にグリッドオプションの一部だけを差し替えます。グリッドを作り直さずに、コンテキストメニューの構成や
|
|
891
|
+
* グループ化の基準といった設定を変えたいときに使います — 渡したオプションだけを上書きしたあと、影響を受ける部分
|
|
892
|
+
* (contextMenu の再初期化・groupBy の再構成など)だけを選んで更新し、描画し直します。
|
|
893
|
+
*
|
|
894
|
+
* 生成后只替换表格选项的一部分。想在不重建表格的情况下,改动上下文菜单的构成或分组基准这类设置时使用 —
|
|
895
|
+
* 只覆盖传入的选项,然后仅挑出受影响的部分(contextMenu 的重新初始化、groupBy 的重新构建等)更新并重新绘制。
|
|
896
|
+
*
|
|
897
|
+
* @param opts - 갱신할 옵션 부분집합
|
|
898
|
+
*
|
|
899
|
+
* Subset of options to update
|
|
900
|
+
*
|
|
901
|
+
* 更新するオプションの部分集合
|
|
902
|
+
*
|
|
903
|
+
* 要更新的选项子集
|
|
323
904
|
*/
|
|
324
905
|
setOptions(opts: Partial<GridOptions<T>>): void;
|
|
325
906
|
/**
|
|
326
|
-
* 컬럼 마스킹 ON/OFF 전환.
|
|
327
|
-
* enabled=true → 마스킹 적용 (기본 상태)
|
|
328
|
-
* enabled=false → 컬럼 전체 마스킹 해제 (원문 표시)
|
|
907
|
+
* 컬럼 마스킹 ON/OFF 전환.
|
|
908
|
+
* enabled=true → 마스킹 적용 (기본 상태)
|
|
909
|
+
* enabled=false → 컬럼 전체 마스킹 해제 (원문 표시)
|
|
910
|
+
*
|
|
911
|
+
* Toggle column masking on/off.
|
|
912
|
+
* enabled=true → apply masking (default state)
|
|
913
|
+
* enabled=false → reveal the whole column (show raw values)
|
|
914
|
+
*
|
|
915
|
+
* 列マスキングの ON/OFF 切り替え。
|
|
916
|
+
* enabled=true → マスキングを適用(既定の状態)
|
|
917
|
+
* enabled=false → 列全体のマスキングを解除(原文を表示)
|
|
918
|
+
*
|
|
919
|
+
* 列掩码的 ON/OFF 切换。
|
|
920
|
+
* enabled=true → 应用掩码(默认状态)
|
|
921
|
+
* enabled=false → 解除整列的掩码(显示原文)
|
|
922
|
+
*
|
|
923
|
+
* @param field - 대상 컬럼 field
|
|
924
|
+
*
|
|
925
|
+
* Target column field
|
|
926
|
+
*
|
|
927
|
+
* 対象となる列の field
|
|
928
|
+
*
|
|
929
|
+
* 目标列的 field
|
|
329
930
|
*
|
|
330
|
-
* @param
|
|
331
|
-
*
|
|
931
|
+
* @param enabled - 마스킹 활성 여부
|
|
932
|
+
*
|
|
933
|
+
* Whether masking is active
|
|
934
|
+
*
|
|
935
|
+
* マスキングを有効にするかどうか
|
|
936
|
+
*
|
|
937
|
+
* 是否启用掩码
|
|
332
938
|
*/
|
|
333
939
|
setMaskEnabled(field: string, enabled: boolean): void;
|
|
334
|
-
/**
|
|
940
|
+
/**
|
|
941
|
+
* 현재 컬럼 마스킹 활성 여부 반환. true=마스킹 중, false=해제됨
|
|
942
|
+
*
|
|
943
|
+
* Return whether masking is active for the column (true = masked, false = revealed).
|
|
944
|
+
*
|
|
945
|
+
* 現在の列マスキングが有効かどうかを返します。true=マスキング中、false=解除済み。
|
|
946
|
+
*
|
|
947
|
+
* 返回当前列的掩码是否启用。true=掩码中,false=已解除。
|
|
948
|
+
*/
|
|
335
949
|
getMaskEnabled(field: string): boolean;
|
|
336
950
|
private _initWorksheets;
|
|
337
951
|
private _loadWorksheetState;
|
|
338
952
|
/**
|
|
339
|
-
* 워크시트(탭)를 추가한다.
|
|
953
|
+
* 워크시트(탭)를 추가한다.
|
|
340
954
|
*
|
|
341
|
-
*
|
|
342
|
-
*
|
|
343
|
-
*
|
|
955
|
+
* Add a worksheet (tab).
|
|
956
|
+
*
|
|
957
|
+
* ワークシート(タブ)を追加します。
|
|
958
|
+
*
|
|
959
|
+
* 添加工作表(标签页)。
|
|
960
|
+
*
|
|
961
|
+
* @param name - 시트 이름
|
|
962
|
+
*
|
|
963
|
+
* Sheet name
|
|
964
|
+
*
|
|
965
|
+
* シート名
|
|
966
|
+
*
|
|
967
|
+
* 工作表名
|
|
968
|
+
*
|
|
969
|
+
* @param columns - 시트 전용 컬럼(생략 시 그리드 columns)
|
|
970
|
+
*
|
|
971
|
+
* Sheet columns (grid columns when omitted)
|
|
972
|
+
*
|
|
973
|
+
* シート専用の列(省略時はグリッドの columns)
|
|
974
|
+
*
|
|
975
|
+
* 工作表专用的列(省略时为表格的 columns)
|
|
976
|
+
*
|
|
977
|
+
* @param data - 시트 데이터
|
|
978
|
+
*
|
|
979
|
+
* Sheet data
|
|
980
|
+
*
|
|
981
|
+
* シートのデータ
|
|
982
|
+
*
|
|
983
|
+
* 工作表的数据
|
|
344
984
|
*/
|
|
345
985
|
addWorksheet(name: string, columns?: import('./types').ColumnDef<T>[], data?: T[]): void;
|
|
346
|
-
/**
|
|
986
|
+
/**
|
|
987
|
+
* 워크시트를 제거한다.
|
|
988
|
+
*
|
|
989
|
+
* Remove a worksheet.
|
|
990
|
+
*
|
|
991
|
+
* ワークシートを削除します。
|
|
992
|
+
*
|
|
993
|
+
* 删除工作表。
|
|
994
|
+
*/
|
|
347
995
|
removeWorksheet(name: string): void;
|
|
348
|
-
/**
|
|
996
|
+
/**
|
|
997
|
+
* 지정 워크시트로 전환한다.
|
|
998
|
+
*
|
|
999
|
+
* Switch to the given worksheet.
|
|
1000
|
+
*
|
|
1001
|
+
* 指定したワークシートに切り替えます。
|
|
1002
|
+
*
|
|
1003
|
+
* 切换到指定的工作表。
|
|
1004
|
+
*/
|
|
349
1005
|
switchWorksheet(name: string): void;
|
|
350
|
-
/**
|
|
1006
|
+
/**
|
|
1007
|
+
* 워크시트 이름을 변경한다.
|
|
1008
|
+
*
|
|
1009
|
+
* Rename a worksheet.
|
|
1010
|
+
*
|
|
1011
|
+
* ワークシート名を変更します。
|
|
1012
|
+
*
|
|
1013
|
+
* 修改工作表名。
|
|
1014
|
+
*/
|
|
351
1015
|
renameWorksheet(oldName: string, newName: string): void;
|
|
352
|
-
/**
|
|
1016
|
+
/**
|
|
1017
|
+
* 워크시트 상태 스냅샷 조회(없으면 undefined).
|
|
1018
|
+
*
|
|
1019
|
+
* Get a worksheet state snapshot (undefined when absent).
|
|
1020
|
+
*
|
|
1021
|
+
* ワークシート状態のスナップショットを取得(存在しない場合は undefined)。
|
|
1022
|
+
*
|
|
1023
|
+
* 获取工作表状态的快照(不存在时为 undefined)。
|
|
1024
|
+
*/
|
|
353
1025
|
getWorksheet(name: string): import('./types').WorksheetState<T> | undefined;
|
|
354
|
-
/**
|
|
1026
|
+
/**
|
|
1027
|
+
* 워크시트 이름 목록.
|
|
1028
|
+
*
|
|
1029
|
+
* List of worksheet names.
|
|
1030
|
+
*
|
|
1031
|
+
* ワークシート名の一覧。
|
|
1032
|
+
*
|
|
1033
|
+
* 工作表名的列表。
|
|
1034
|
+
*/
|
|
355
1035
|
getWorksheetNames(): string[];
|
|
356
|
-
/**
|
|
1036
|
+
/**
|
|
1037
|
+
* 모든 워크시트를 다중 시트 엑셀로 내보낸다.
|
|
1038
|
+
*
|
|
1039
|
+
* Export all worksheets as a multi-sheet Excel file.
|
|
1040
|
+
*
|
|
1041
|
+
* すべてのワークシートを複数シートの Excel として書き出します。
|
|
1042
|
+
*
|
|
1043
|
+
* 把所有工作表导出为多工作表的 Excel。
|
|
1044
|
+
*/
|
|
357
1045
|
exportSheetsExcel(filename?: string): void;
|
|
358
1046
|
private _onResize;
|
|
359
1047
|
private _recalcWidths;
|
|
360
1048
|
private _renderHeader;
|
|
361
1049
|
private _syncHeaderLayout;
|
|
362
1050
|
private _doRender;
|
|
363
|
-
/**
|
|
1051
|
+
/**
|
|
1052
|
+
* F2(§4.5/§6.1): masterDetail.enabled 아니면 undefined(GridRenderer 는 기존 경로 그대로).
|
|
1053
|
+
*
|
|
1054
|
+
* F2 (§4.5/§6.1): undefined unless masterDetail.enabled (GridRenderer keeps its existing path).
|
|
1055
|
+
*
|
|
1056
|
+
* F2(§4.5/§6.1): masterDetail.enabled でなければ undefined(GridRenderer は既存の経路のまま)。
|
|
1057
|
+
*
|
|
1058
|
+
* F2(§4.5/§6.1): 若非 masterDetail.enabled 则为 undefined(GridRenderer 保持既有路径不变)。
|
|
1059
|
+
*/
|
|
364
1060
|
private _buildDetailRenderContext;
|
|
365
1061
|
private _handleGroupToggle;
|
|
366
1062
|
private _visRange;
|
|
@@ -378,25 +1074,91 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
378
1074
|
private _handleFilterIconClick;
|
|
379
1075
|
private _handleAllCheck;
|
|
380
1076
|
private _handleRowDrop;
|
|
381
|
-
/**
|
|
1077
|
+
/**
|
|
1078
|
+
* @internal 드래그/셔틀이 참조하는 바디 엘리먼트 (레지스트리 해석용)
|
|
1079
|
+
*
|
|
1080
|
+
* Body element referenced by drag/shuttle (registry resolution).
|
|
1081
|
+
*
|
|
1082
|
+
* ドラッグ/シャトルが参照するボディ要素(レジストリ解決用)。
|
|
1083
|
+
*
|
|
1084
|
+
* 拖拽/穿梭所引用的 body 元素(用于注册表解析)。
|
|
1085
|
+
*/
|
|
382
1086
|
_crossBodyEl(): HTMLElement;
|
|
383
|
-
/**
|
|
1087
|
+
/**
|
|
1088
|
+
* fromIndex 를 잡고 드래그할 때 함께 이동할 행 집합 (다중선택에 포함되면 선택 전체)
|
|
1089
|
+
*
|
|
1090
|
+
* The set of rows that move together when dragging by fromIndex (the whole selection when fromIndex is part of a multi-selection).
|
|
1091
|
+
*
|
|
1092
|
+
* fromIndex をつかんでドラッグするときに一緒に移動する行の集合(複数選択に含まれる場合は選択全体)。
|
|
1093
|
+
*
|
|
1094
|
+
* 抓住 fromIndex 拖拽时一起移动的行集合(若包含在多选中则为整个选择)。
|
|
1095
|
+
*/
|
|
384
1096
|
private _dragRowSet;
|
|
385
1097
|
/**
|
|
386
1098
|
* 이 그리드의 행들을 다른 그리드로 이동(move)한다. 드래그·화살표 셔틀 공통 경로.
|
|
387
1099
|
* 3단계 이벤트(before→after→complete)와 crossGridMapping(필드 매핑)을 적용한다.
|
|
388
|
-
*
|
|
1100
|
+
*
|
|
1101
|
+
* Move rows from this grid to another grid (shared path for drag and arrow shuttle).
|
|
389
1102
|
* Applies the three-phase events (before→after→complete) and crossGridMapping (field mapping).
|
|
390
1103
|
*
|
|
391
|
-
*
|
|
392
|
-
*
|
|
393
|
-
*
|
|
394
|
-
*
|
|
1104
|
+
* このグリッドの行を別のグリッドへ移動(move)します。ドラッグ・矢印シャトル共通の経路です。
|
|
1105
|
+
* 3 段階イベント(before→after→complete)と crossGridMapping(フィールドマッピング)を適用します。
|
|
1106
|
+
*
|
|
1107
|
+
* 把这个表格的行移动(move)到另一个表格。拖拽与箭头穿梭的公共路径。
|
|
1108
|
+
* 应用 3 阶段事件(before→after→complete)与 crossGridMapping(字段映射)。
|
|
1109
|
+
*
|
|
1110
|
+
* @param target - 대상 그리드
|
|
1111
|
+
*
|
|
1112
|
+
* Target grid
|
|
1113
|
+
*
|
|
1114
|
+
* 対象グリッド
|
|
1115
|
+
*
|
|
1116
|
+
* 目标表格
|
|
1117
|
+
*
|
|
1118
|
+
* @param sourceIndexes - 이동할 소스 행 인덱스들
|
|
1119
|
+
*
|
|
1120
|
+
* Source row indexes to move
|
|
1121
|
+
*
|
|
1122
|
+
* 移動するソース行のインデックス
|
|
1123
|
+
*
|
|
1124
|
+
* 要移动的源行索引
|
|
1125
|
+
*
|
|
1126
|
+
* @param targetIndex - 삽입 시작 인덱스(생략 시 끝)
|
|
1127
|
+
*
|
|
1128
|
+
* Insertion start index (end when omitted)
|
|
1129
|
+
*
|
|
1130
|
+
* 挿入開始インデックス(省略時は末尾)
|
|
1131
|
+
*
|
|
1132
|
+
* 插入的起始索引(省略时为末尾)
|
|
1133
|
+
*
|
|
1134
|
+
* @returns 이동 성공 여부
|
|
1135
|
+
*
|
|
1136
|
+
* Whether the move succeeded
|
|
1137
|
+
*
|
|
1138
|
+
* 移動が成功したかどうか
|
|
1139
|
+
*
|
|
1140
|
+
* 移动是否成功
|
|
395
1141
|
*/
|
|
396
1142
|
moveRowsTo(target: OpenGridInstance<T>, sourceIndexes: number[], targetIndex?: number): Promise<boolean>;
|
|
397
|
-
/**
|
|
1143
|
+
/**
|
|
1144
|
+
* 체크된 행을 다른 그리드로 이동 (화살표 셔틀용). 체크 없으면 무시.
|
|
1145
|
+
*
|
|
1146
|
+
* Move checked rows to another grid (arrow-shuttle use). No-op when nothing is checked.
|
|
1147
|
+
*
|
|
1148
|
+
* チェックされた行を別のグリッドへ移動(矢印シャトル用)。チェックがなければ何もしません。
|
|
1149
|
+
*
|
|
1150
|
+
* 把勾选的行移动到另一个表格(用于箭头穿梭)。没有勾选则不做任何事。
|
|
1151
|
+
*/
|
|
398
1152
|
moveCheckedTo(target: OpenGridInstance<T>): Promise<boolean>;
|
|
399
|
-
/**
|
|
1153
|
+
/**
|
|
1154
|
+
* 행 위치 이동(드롭 경로에서 실행).
|
|
1155
|
+
*
|
|
1156
|
+
* Move a row to a new position (executed on the drop path).
|
|
1157
|
+
*
|
|
1158
|
+
* 行の位置を移動(ドロップ経路で実行)。
|
|
1159
|
+
*
|
|
1160
|
+
* 移动行的位置(在拖放路径中执行)。
|
|
1161
|
+
*/
|
|
400
1162
|
reorderRow(fromIndex: number, toIndex: number): void;
|
|
401
1163
|
private _handleColResize;
|
|
402
1164
|
private _handleKeyDown;
|
|
@@ -407,34 +1169,101 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
407
1169
|
* 그리드의 데이터 전체를 새 배열로 갈아끼운다. 서버에서 목록을 새로 받아오는 등 데이터를 통째로 바꿀 때
|
|
408
1170
|
* 쓴다. 행 식별자(id)를 새로 발급하므로 기존 행에 걸려 있던 셀 수식 상태는 이때 초기화된다 — 일부만 바꿀
|
|
409
1171
|
* 때는 `writeCell`/`insertRow`/`deleteRow` 쪽이 상태를 보존한다.
|
|
410
|
-
*
|
|
1172
|
+
*
|
|
1173
|
+
* Replace the whole data set with a new array. Use it when the data changes entirely (e.g. a fresh
|
|
411
1174
|
* list from the server). It reissues row ids, so any existing cell-formula state is reset here — for
|
|
412
1175
|
* partial changes prefer `writeCell`/`insertRow`/`deleteRow`, which preserve state.
|
|
413
1176
|
*
|
|
414
|
-
*
|
|
1177
|
+
* グリッドのデータ全体を新しい配列に差し替えます。サーバーから一覧を取り直すなど、データをまるごと入れ替えるときに
|
|
1178
|
+
* 使います。行識別子(id)を発行し直すため、既存の行に掛かっていたセル数式の状態はこのとき初期化されます — 一部だけを
|
|
1179
|
+
* 変えるときは `writeCell`/`insertRow`/`deleteRow` のほうが状態を保持します。
|
|
1180
|
+
*
|
|
1181
|
+
* 把表格的全部数据换成新数组。从服务器重新取回列表等、要整体替换数据时使用。因为会重新签发行标识符(id),
|
|
1182
|
+
* 挂在既有行上的单元格公式状态会在此时初始化 — 只改一部分时,`writeCell`/`insertRow`/`deleteRow`
|
|
1183
|
+
* 这一侧会保留状态。
|
|
1184
|
+
*
|
|
1185
|
+
* @param data - 새 행 배열
|
|
1186
|
+
*
|
|
1187
|
+
* New array of rows
|
|
1188
|
+
*
|
|
1189
|
+
* 新しい行の配列
|
|
1190
|
+
*
|
|
1191
|
+
* 新的行数组
|
|
1192
|
+
*
|
|
415
1193
|
* @example
|
|
416
1194
|
* grid.setData([{ name: 'Kim' }, { name: 'Lee' }]);
|
|
417
1195
|
*/
|
|
418
1196
|
setData(data: T[]): void;
|
|
419
|
-
/**
|
|
1197
|
+
/**
|
|
1198
|
+
* 지금 화면에 보이는 순서·범위 그대로의 데이터 배열을 돌려준다(정렬·필터가 반영된 결과). 사용자가 보고 있는 그대로를 내보내거나 집계할 때 쓴다.
|
|
1199
|
+
*
|
|
1200
|
+
* Return the data array as currently shown (sort/filter applied) — use it to export or aggregate exactly what the user sees.
|
|
1201
|
+
*
|
|
1202
|
+
* いま画面に見えている順序・範囲そのままのデータ配列を返します(ソート・フィルターが反映された結果)。ユーザーが見ているままを書き出したり集計したりするときに使います。
|
|
1203
|
+
*
|
|
1204
|
+
* 返回当前画面上所见的顺序、范围原样的数据数组(已反映排序、筛选的结果)。想把用户所见的内容原样导出或聚合时使用。
|
|
1205
|
+
*/
|
|
420
1206
|
getData(): T[];
|
|
421
|
-
/**
|
|
1207
|
+
/**
|
|
1208
|
+
* 정렬·필터를 걷어 낸 원본 데이터 배열을 돌려준다. "원래 넣었던 전체 데이터"가 필요할 때 getData() 대신 쓴다.
|
|
1209
|
+
*
|
|
1210
|
+
* Return the original data array before sort/filter — use it instead of getData() when you need the full, unfiltered set.
|
|
1211
|
+
*
|
|
1212
|
+
* ソート・フィルターを取り除いた元のデータ配列を返します。「もともと入れた全データ」が必要なときに getData() の代わりに使います。
|
|
1213
|
+
*
|
|
1214
|
+
* 返回去掉排序、筛选的原始数据数组。需要「原本放入的全部数据」时,代替 getData() 使用。
|
|
1215
|
+
*/
|
|
422
1216
|
getSourceRows(): T[];
|
|
423
|
-
/**
|
|
1217
|
+
/**
|
|
1218
|
+
* 기존 데이터 뒤에 행들을 이어 붙인다. 전체를 setData 로 갈아끼우지 않고 뒤에만 덧붙일 때 쓴다(무한 스크롤·추가 로드 등).
|
|
1219
|
+
*
|
|
1220
|
+
* Append rows after the existing data — for adding to the tail without replacing everything via setData (infinite scroll, load-more, …).
|
|
1221
|
+
*
|
|
1222
|
+
* 既存データの後ろに行を継ぎ足します。全体を setData で差し替えずに末尾だけ追加するときに使います(無限スクロール・追加ロードなど)。
|
|
1223
|
+
*
|
|
1224
|
+
* 在既有数据后面接上行。不用 setData 替换整体、只在末尾追加时使用(无限滚动、追加加载等)。
|
|
1225
|
+
*/
|
|
424
1226
|
pushData(data: T[]): void;
|
|
425
|
-
/**
|
|
1227
|
+
/**
|
|
1228
|
+
* 기존 데이터 앞에 행들을 끼워 넣는다(최신 항목을 맨 위로 올릴 때 등).
|
|
1229
|
+
*
|
|
1230
|
+
* Prepend rows before the existing data (e.g. to push newest items to the top).
|
|
1231
|
+
*
|
|
1232
|
+
* 既存データの前に行を挿し込みます(最新の項目を先頭に上げるときなど)。
|
|
1233
|
+
*
|
|
1234
|
+
* 在既有数据前面插入行(例如把最新的项目提到最前时)。
|
|
1235
|
+
*/
|
|
426
1236
|
prefixData(data: T[]): void;
|
|
427
1237
|
/**
|
|
428
1238
|
* 조건부서식(CF) 규칙을 설정한다 — 데이터바·히트맵·아이콘셋을 렌더 경로에 배선한다.
|
|
429
1239
|
* CF 는 opt-in 이라 첫 호출 때 CF 엔진(cf/**)을 **동적 import** 로 조립한다(베이스 번들 무증가, 별 청크).
|
|
430
1240
|
* 규칙이 걸린 컬럼마다 컬럼 통계를 1회 캐시 계산(per-render 재계산 금지)한 뒤 재렌더한다.
|
|
431
1241
|
* `rules=[]` 를 넘기면 CF 를 해제한다(엔진·통계 캐시 clear + 잔재 제거 재렌더).
|
|
432
|
-
*
|
|
1242
|
+
*
|
|
1243
|
+
* Set conditional-formatting rules — wires data-bars/heatmaps/icon-sets into the render path.
|
|
433
1244
|
* CF is opt-in; the CF engine (cf/**) is assembled via **dynamic import** on first call (no base-bundle
|
|
434
1245
|
* growth, separate chunk). Column stats are cached once per rule-bearing column (never re-computed
|
|
435
1246
|
* per render), then a re-render paints them. Passing `rules=[]` clears CF (engine/cache reset + residue-stripping re-render).
|
|
436
1247
|
*
|
|
437
|
-
*
|
|
1248
|
+
* 条件付き書式(CF)のルールを設定します — データバー・ヒートマップ・アイコンセットをレンダー経路に配線します。
|
|
1249
|
+
* CF は opt-in のため、初回呼び出し時に CF エンジン(cf/**)を **動的 import** で組み立てます(ベースバンドルは
|
|
1250
|
+
* 増えず、別チャンク)。ルールが掛かった列ごとに列統計を 1 回だけキャッシュ計算し(レンダーごとの再計算は禁止)、
|
|
1251
|
+
* そのうえで再レンダーします。`rules=[]` を渡すと CF を解除します(エンジン・統計キャッシュを clear + 残滓を
|
|
1252
|
+
* 取り除く再レンダー)。
|
|
1253
|
+
*
|
|
1254
|
+
* 设置条件格式(CF)的规则 — 把数据条、热力图、图标集配线到渲染路径。
|
|
1255
|
+
* CF 为 opt-in,首次调用时以 **动态 import** 组装 CF 引擎(cf/**)(基础包不增加,独立分块)。
|
|
1256
|
+
* 对每个挂有规则的列只缓存计算 1 次列统计(禁止每次渲染重算),然后重新渲染。
|
|
1257
|
+
* 传入 `rules=[]` 则解除 CF(clear 引擎与统计缓存 + 去除残留的重新渲染)。
|
|
1258
|
+
*
|
|
1259
|
+
* @param rules - CF 규칙 배열(빈 배열이면 해제)
|
|
1260
|
+
*
|
|
1261
|
+
* CF rule array (empty array clears CF)
|
|
1262
|
+
*
|
|
1263
|
+
* CF ルールの配列(空配列なら解除)
|
|
1264
|
+
*
|
|
1265
|
+
* CF 规则的数组(空数组则解除)
|
|
1266
|
+
*
|
|
438
1267
|
* @example
|
|
439
1268
|
* await grid.setConditionalFormat([
|
|
440
1269
|
* { id: 'bar', when: { type: 'compare', op: '>=', a: 0 }, encode: { kind: 'bar', axis: 'zero' }, scope: { columnId: 'amount' }, priority: 0 },
|
|
@@ -444,7 +1273,14 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
444
1273
|
/**
|
|
445
1274
|
* CF 규칙이 걸린 컬럼마다 현재 데이터로 컬럼 통계를 계산해 캐시한다(per-render 재계산 금지의 근거).
|
|
446
1275
|
* 통계 계산기는 setConditionalFormat 에서 cf/ 동적 청크로부터 보관한 참조를 동기 사용한다.
|
|
447
|
-
*
|
|
1276
|
+
*
|
|
1277
|
+
* Recompute & cache per-column CF stats using the computer captured from the cf/ dynamic chunk.
|
|
1278
|
+
*
|
|
1279
|
+
* CF ルールが掛かった列ごとに、現在のデータで列統計を計算してキャッシュします(レンダーごとの再計算を禁止できる根拠)。
|
|
1280
|
+
* 統計計算機は、setConditionalFormat で cf/ の動的チャンクから保持した参照を同期的に使います。
|
|
1281
|
+
*
|
|
1282
|
+
* 对每个挂有 CF 规则的列,用当前数据计算列统计并缓存(禁止每次渲染重算的依据)。
|
|
1283
|
+
* 统计计算器同步使用 setConditionalFormat 中从 cf/ 动态分块保留下来的引用。
|
|
448
1284
|
*/
|
|
449
1285
|
private _recomputeCFStats;
|
|
450
1286
|
/**
|
|
@@ -452,160 +1288,527 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
452
1288
|
* CF 와 동일하게 첫 호출 시에만 realtime/ 를 동적 import(별 청크·베이스 번들 무증가). 델타는 기존
|
|
453
1289
|
* 단일 쓰기 경로(MutationService)를 재사용해 적용되므로 증분=전체 불변식·수식 재계산·차트 라이브
|
|
454
1290
|
* 갱신(dataChange 구독)을 자연 상속한다. 재호출 시 이전 소스는 detach 후 교체.
|
|
455
|
-
*
|
|
456
|
-
*
|
|
457
|
-
*
|
|
458
|
-
*
|
|
459
|
-
*
|
|
460
|
-
*
|
|
461
|
-
*
|
|
462
|
-
*
|
|
463
|
-
*
|
|
1291
|
+
*
|
|
1292
|
+
* Wire a realtime source (polling/streaming/custom — any `IRealtimeSource` via DI). Like CF, the
|
|
1293
|
+
* realtime/ chunk is dynamically imported only on first call (separate chunk; base bundle unchanged).
|
|
1294
|
+
* Deltas reuse the existing single write path (MutationService), inheriting the incremental=full
|
|
1295
|
+
* invariant, formula recompute, and live chart refresh (dataChange subscription). Re-calling
|
|
1296
|
+
* detaches and replaces the previous source.
|
|
1297
|
+
*
|
|
1298
|
+
* リアルタイムデータソースをグリッドに配線します(ポーリング/ストリーミング/カスタム — `IRealtimeSource` の実装で
|
|
1299
|
+
* あれば何でも DI 可能)。CF と同じく、初回呼び出し時にのみ realtime/ を動的 import します(別チャンク・ベース
|
|
1300
|
+
* バンドルは増えません)。デルタは既存の単一書き込み経路(MutationService)を再利用して適用されるため、増分=全体の
|
|
1301
|
+
* 不変条件・数式の再計算・チャートのライブ更新(dataChange の購読)を自然に継承します。再度呼び出すと、以前の
|
|
1302
|
+
* ソースは detach してから差し替えられます。
|
|
1303
|
+
*
|
|
1304
|
+
* 把实时数据源配线到表格(轮询/流式/自定义 — 只要是 `IRealtimeSource` 的实现都可以 DI)。
|
|
1305
|
+
* 与 CF 相同,仅在首次调用时动态 import realtime/(独立分块、基础包不增加)。增量复用既有的单一写入路径
|
|
1306
|
+
* (MutationService)来应用,因此自然继承增量=整体的不变条件、公式的重算、图表的实时更新(dataChange 的订阅)。
|
|
1307
|
+
* 再次调用时,先 detach 之前的源再替换。
|
|
1308
|
+
*
|
|
1309
|
+
* @param source - 실시간 소스(예: `new PollingSource({...})`)
|
|
1310
|
+
*
|
|
1311
|
+
* Realtime source (e.g. `new PollingSource({...})`)
|
|
1312
|
+
*
|
|
1313
|
+
* リアルタイムソース(例: `new PollingSource({...})`)
|
|
1314
|
+
*
|
|
1315
|
+
* 实时源(例: `new PollingSource({...})`)
|
|
1316
|
+
*
|
|
1317
|
+
* @param opts - 백프레셔·신선도·SR 옵션(전부 옵션)
|
|
1318
|
+
*
|
|
1319
|
+
* Backpressure/freshness/SR options (all optional)
|
|
1320
|
+
*
|
|
1321
|
+
* バックプレッシャー・鮮度・SR のオプション(すべて任意)
|
|
1322
|
+
*
|
|
1323
|
+
* 背压、新鲜度、SR 的选项(全部可选)
|
|
1324
|
+
*
|
|
1325
|
+
* @returns 배선된 컨트롤러(`.connection`·`.backpressureStats`·`.onConnection`·`.detach()`)
|
|
1326
|
+
*
|
|
1327
|
+
* The wired controller
|
|
1328
|
+
*
|
|
1329
|
+
* 配線されたコントローラ(`.connection`・`.backpressureStats`・`.onConnection`・`.detach()`)
|
|
1330
|
+
*
|
|
1331
|
+
* 配线好的控制器(`.connection`、`.backpressureStats`、`.onConnection`、`.detach()`)
|
|
1332
|
+
*
|
|
464
1333
|
* @example
|
|
465
1334
|
* const src = new PollingSource({ intervalMs: 1000, fetcher: async () => ({ kind: 'delta', seq, cells }) });
|
|
466
1335
|
* const rt = await grid.setRealtimeSource(src);
|
|
467
1336
|
* rt.onConnection((s) => console.log(s.status));
|
|
468
1337
|
*/
|
|
469
1338
|
setRealtimeSource(source: IRealtimeSource<T>, opts?: RealtimeWireOptions): Promise<RealtimeController<T>>;
|
|
470
|
-
/**
|
|
1339
|
+
/**
|
|
1340
|
+
* 실시간 소스 배선을 해제한다(구독·타이머·소켓 정리, 멱등).
|
|
1341
|
+
*
|
|
1342
|
+
* Disconnect the realtime source (teardown; idempotent).
|
|
1343
|
+
*
|
|
1344
|
+
* リアルタイムソースの配線を解除します(購読・タイマー・ソケットの後片付け、冪等)。
|
|
1345
|
+
*
|
|
1346
|
+
* 解除实时源的配线(清理订阅、定时器、套接字,幂等)。
|
|
1347
|
+
*/
|
|
471
1348
|
disconnectRealtime(): void;
|
|
472
|
-
/**
|
|
1349
|
+
/**
|
|
1350
|
+
* 데이터만 전부 비운다 — 컬럼 정의와 옵션은 그대로 두고 행만 0건으로 만든다. 같은 표 구조를 유지한 채 내용만 갈아엎기 전에 쓴다.
|
|
1351
|
+
*
|
|
1352
|
+
* Empty just the data — keep column defs and options, drop all rows to zero. Use it before reloading content into the same table shape.
|
|
1353
|
+
*
|
|
1354
|
+
* データだけをすべて空にします — 列定義とオプションはそのままに、行だけを 0 件にします。同じ表の構造を保ったまま中身だけを入れ替える前に使います。
|
|
1355
|
+
*
|
|
1356
|
+
* 只把数据全部清空 — 列定义与选项保持原样,只把行变成 0 件。想保持同样的表结构、只替换内容之前使用。
|
|
1357
|
+
*/
|
|
473
1358
|
clearData(): void;
|
|
474
1359
|
/**
|
|
475
1360
|
* 행 1건을 원하는 위치에 끼워 넣고 화면을 갱신한다. "추가" 버튼으로 빈 행이나 새 레코드를 넣을 때 쓰며,
|
|
476
1361
|
* 일부 필드만 담은 부분 객체를 넘겨도 된다(나머지는 비어 있는 채로 삽입). 삽입 후 변경 추적에 "추가된 행"으로
|
|
477
1362
|
* 잡히고, `before:insertRow` 트리거로 취소·검증할 수 있다.
|
|
478
|
-
*
|
|
1363
|
+
*
|
|
1364
|
+
* Insert one row at a chosen position and refresh the view. Use it for an "add" button that inserts a
|
|
479
1365
|
* blank row or a new record; a partial object is fine (missing fields stay empty). The row is tracked as
|
|
480
1366
|
* "added", and a `before:insertRow` trigger can cancel/validate it.
|
|
481
1367
|
*
|
|
482
|
-
*
|
|
483
|
-
*
|
|
1368
|
+
* 行を 1 件、任意の位置に挿し込んで画面を更新します。「追加」ボタンで空行や新しいレコードを入れるときに使い、
|
|
1369
|
+
* 一部のフィールドだけを持つ部分オブジェクトを渡しても構いません(残りは空のまま挿入されます)。挿入後は変更追跡に
|
|
1370
|
+
* 「追加された行」として捕捉され、`before:insertRow` トリガーでキャンセル・検証できます。
|
|
1371
|
+
*
|
|
1372
|
+
* 把 1 行插入到任意位置并刷新画面。用「添加」按钮放入空行或新记录时使用,
|
|
1373
|
+
* 传入只含部分字段的部分对象也可以(其余字段以空值插入)。插入后会被变更追踪捕捉为「添加的行」,
|
|
1374
|
+
* 并可用 `before:insertRow` 触发器取消、校验。
|
|
1375
|
+
*
|
|
1376
|
+
* @param item - 행 데이터(부분 객체 허용)
|
|
1377
|
+
*
|
|
1378
|
+
* Row data (partial object allowed)
|
|
1379
|
+
*
|
|
1380
|
+
* 行データ(部分オブジェクト可)
|
|
1381
|
+
*
|
|
1382
|
+
* 行数据(允许部分对象)
|
|
1383
|
+
*
|
|
1384
|
+
* @param position - 삽입 위치(기본 'last')
|
|
1385
|
+
*
|
|
1386
|
+
* Insertion position (default 'last')
|
|
1387
|
+
*
|
|
1388
|
+
* 挿入位置(既定 'last')
|
|
1389
|
+
*
|
|
1390
|
+
* 插入位置(默认 'last')
|
|
1391
|
+
*
|
|
484
1392
|
* @example
|
|
485
1393
|
* grid.insertRow({ name: 'New' }, 'first');
|
|
486
1394
|
*/
|
|
487
1395
|
insertRow(item: Partial<T>, position?: Position): void;
|
|
488
|
-
/** 행(들)을 끝에 추가한다. / Append row(s) at the end. */
|
|
489
|
-
pushRow(items: Partial<T> | Partial<T>[]): void;
|
|
490
|
-
/** @deprecated 하위호환 alias → pushRow / Backward-compat alias → pushRow */
|
|
491
|
-
appendRows(items: Partial<T> | Partial<T>[]): void;
|
|
492
|
-
/** 행(들)을 맨 앞에 추가한다. / Prepend row(s) at the beginning. */
|
|
493
|
-
unshiftRow(items: Partial<T> | Partial<T>[]): void;
|
|
494
|
-
/** @deprecated 하위호환 alias → unshiftRow / Backward-compat alias → unshiftRow */
|
|
495
|
-
prependRows(items: Partial<T> | Partial<T>[]): void;
|
|
496
1396
|
/**
|
|
497
|
-
*
|
|
498
|
-
*
|
|
499
|
-
*
|
|
500
|
-
*
|
|
501
|
-
*
|
|
502
|
-
* as "removed" and can be read via `getRemovedRows()`.
|
|
1397
|
+
* 행(들)을 끝에 추가한다.
|
|
1398
|
+
*
|
|
1399
|
+
* Append row(s) at the end.
|
|
1400
|
+
*
|
|
1401
|
+
* 行を末尾に追加します。
|
|
503
1402
|
*
|
|
504
|
-
*
|
|
1403
|
+
* 把行追加到末尾。
|
|
505
1404
|
*/
|
|
506
|
-
|
|
1405
|
+
pushRow(items: Partial<T> | Partial<T>[]): void;
|
|
507
1406
|
/**
|
|
508
|
-
* @deprecated
|
|
509
|
-
*
|
|
510
|
-
*
|
|
1407
|
+
* @deprecated 하위호환 alias → pushRow
|
|
1408
|
+
*
|
|
1409
|
+
* Backward-compat alias → pushRow
|
|
1410
|
+
*
|
|
1411
|
+
* 後方互換のエイリアス → pushRow
|
|
1412
|
+
*
|
|
1413
|
+
* 后方兼容的别名 → pushRow
|
|
1414
|
+
*/
|
|
1415
|
+
appendRows(items: Partial<T> | Partial<T>[]): void;
|
|
1416
|
+
/**
|
|
1417
|
+
* 행(들)을 맨 앞에 추가한다.
|
|
1418
|
+
*
|
|
1419
|
+
* Prepend row(s) at the beginning.
|
|
1420
|
+
*
|
|
1421
|
+
* 行を先頭に追加します。
|
|
1422
|
+
*
|
|
1423
|
+
* 把行追加到最前。
|
|
1424
|
+
*/
|
|
1425
|
+
unshiftRow(items: Partial<T> | Partial<T>[]): void;
|
|
1426
|
+
/**
|
|
1427
|
+
* @deprecated 하위호환 alias → unshiftRow
|
|
1428
|
+
*
|
|
1429
|
+
* Backward-compat alias → unshiftRow
|
|
1430
|
+
*
|
|
1431
|
+
* 後方互換のエイリアス → unshiftRow
|
|
1432
|
+
*
|
|
1433
|
+
* 后方兼容的别名 → unshiftRow
|
|
1434
|
+
*/
|
|
1435
|
+
prependRows(items: Partial<T> | Partial<T>[]): void;
|
|
1436
|
+
/**
|
|
1437
|
+
* 행을 인덱스로 삭제하고 화면을 갱신한다. 하나만 지우려면 숫자를, 여러 개를 한 번에 지우려면 인덱스 배열을
|
|
1438
|
+
* 넘긴다(배열로 넘기면 배치로 한 번에 처리되어 개별 호출보다 빠르다). 삭제된 행은 변경 추적의 "삭제된 행"으로
|
|
1439
|
+
* 남아 `getRemovedRows()` 로 확인할 수 있다.
|
|
1440
|
+
*
|
|
1441
|
+
* Delete row(s) by index and refresh. Pass a number for one row, or an array to remove several at once
|
|
1442
|
+
* (an array is handled in a single batch, faster than one-by-one). Removed rows stay in change tracking
|
|
1443
|
+
* as "removed" and can be read via `getRemovedRows()`.
|
|
1444
|
+
*
|
|
1445
|
+
* 行をインデックスで削除して画面を更新します。1 件だけ消すなら数値を、複数をまとめて消すならインデックスの配列を
|
|
1446
|
+
* 渡します(配列で渡すとバッチで一括処理され、個別呼び出しより高速です)。削除された行は変更追跡の「削除された行」と
|
|
1447
|
+
* して残り、`getRemovedRows()` で確認できます。
|
|
1448
|
+
*
|
|
1449
|
+
* 按索引删除行并刷新画面。只删 1 件传数值,要一次删多件则传索引的数组
|
|
1450
|
+
* (以数组传入会按批一次性处理,比逐个调用更快)。被删除的行会作为变更追踪的「删除的行」保留,
|
|
1451
|
+
* 可用 `getRemovedRows()` 确认。
|
|
1452
|
+
*
|
|
1453
|
+
* @param rowIndex - 삭제할 행 인덱스(단건 또는 배열)
|
|
1454
|
+
*
|
|
1455
|
+
* Row index to delete (single or array)
|
|
1456
|
+
*
|
|
1457
|
+
* 削除する行のインデックス(単件または配列)
|
|
1458
|
+
*
|
|
1459
|
+
* 要删除的行索引(单件或数组)
|
|
1460
|
+
*/
|
|
1461
|
+
deleteRow(rowIndex: number | number[]): void;
|
|
1462
|
+
/**
|
|
1463
|
+
* @deprecated no-op stub — id 기반 삭제는 미구현(본문 없음). 인덱스로 지우려면 `deleteRow(rowIndex)`
|
|
1464
|
+
* 를, id→인덱스 변환은 `getFlatRowModel()`/`getData()` 조회 후 `deleteRow` 를 사용.
|
|
1465
|
+
*
|
|
1466
|
+
* no-op stub — id-based deletion is not implemented (empty body). Use `deleteRow(rowIndex)`;
|
|
511
1467
|
* resolve id→index via `getFlatRowModel()`/`getData()` first.
|
|
1468
|
+
*
|
|
1469
|
+
* no-op スタブ — id ベースの削除は未実装です(本体なし)。インデックスで消すには `deleteRow(rowIndex)` を、
|
|
1470
|
+
* id→インデックスの変換は `getFlatRowModel()`/`getData()` で引いたうえで `deleteRow` を使ってください。
|
|
1471
|
+
*
|
|
1472
|
+
* no-op 桩 — 基于 id 的删除未实现(无主体)。要按索引删除请用 `deleteRow(rowIndex)`;
|
|
1473
|
+
* id→索引的转换请先用 `getFlatRowModel()`/`getData()` 查出,再使用 `deleteRow`。
|
|
512
1474
|
*/
|
|
513
1475
|
deleteById(_ids: string[]): void;
|
|
514
|
-
/**
|
|
1476
|
+
/**
|
|
1477
|
+
* 셀에 저장된 가공 전 원시 값을 그대로 읽는다(포맷·마스킹을 거치지 않은 실제 데이터). 계산·비교에 쓸 원값이 필요할 때 getDisplayValue 대신 쓴다.
|
|
1478
|
+
*
|
|
1479
|
+
* Read the raw stored cell value (no formatting/masking) — use it instead of getDisplayValue when you need the real value for compute/compare.
|
|
1480
|
+
*
|
|
1481
|
+
* セルに保存された加工前の生の値をそのまま読み取ります(フォーマットやマスキングを経ていない実データ)。計算・比較に使う元の値が必要なときに getDisplayValue の代わりに使います。
|
|
1482
|
+
*
|
|
1483
|
+
* 原样读取单元格中保存的、加工前的原始值(未经过格式化或掩码的实际数据)。需要用于计算、比较的原值时,代替 getDisplayValue 使用。
|
|
1484
|
+
*/
|
|
515
1485
|
readCell(rowIndex: number, field: string): any;
|
|
516
1486
|
/**
|
|
517
1487
|
* 화면에 실제로 보이는 셀 텍스트를 돌려준다 — 원시 값에 displayFormatter 전략(숫자·날짜 포맷 등)을 적용한
|
|
518
1488
|
* 결과다. 표에 표시되는 문자열 그대로를 복사·검색·툴팁에 쓰고 싶을 때 readCell(원값) 대신 쓴다.
|
|
519
|
-
*
|
|
1489
|
+
*
|
|
1490
|
+
* Return the cell text as actually displayed — the raw value with the displayFormatter strategy
|
|
520
1491
|
* (number/date formatting, …) applied. Use it instead of readCell (raw) when you want the exact shown
|
|
521
1492
|
* string for copy/search/tooltip.
|
|
522
1493
|
*
|
|
523
|
-
*
|
|
524
|
-
*
|
|
525
|
-
*
|
|
1494
|
+
* 画面に実際に見えているセルのテキストを返します — 生の値に displayFormatter 戦略(数値・日付のフォーマットなど)を
|
|
1495
|
+
* 適用した結果です。表に表示される文字列そのものをコピー・検索・ツールチップに使いたいときに、readCell(生の値)の
|
|
1496
|
+
* 代わりに使います。
|
|
1497
|
+
*
|
|
1498
|
+
* 返回画面上实际可见的单元格文本 — 是对原始值应用 displayFormatter 策略(数值、日期格式化等)后的结果。
|
|
1499
|
+
* 想把表格中显示的字符串原样用于复制、搜索、提示框时,代替 readCell(原值)使用。
|
|
1500
|
+
*
|
|
1501
|
+
* @param rowIndex - 화면 기준 행 위치(flat index)
|
|
1502
|
+
*
|
|
1503
|
+
* On-screen row position (flat index)
|
|
1504
|
+
*
|
|
1505
|
+
* 画面基準の行位置(flat index)
|
|
1506
|
+
*
|
|
1507
|
+
* 以画面为准的行位置(flat index)
|
|
1508
|
+
*
|
|
1509
|
+
* @param field - 컬럼 field
|
|
1510
|
+
*
|
|
1511
|
+
* Column field
|
|
1512
|
+
*
|
|
1513
|
+
* 列の field
|
|
1514
|
+
*
|
|
1515
|
+
* 列的 field
|
|
1516
|
+
*
|
|
1517
|
+
* @returns 표시용 문자열
|
|
1518
|
+
*
|
|
1519
|
+
* The display string
|
|
1520
|
+
*
|
|
1521
|
+
* 表示用の文字列
|
|
1522
|
+
*
|
|
1523
|
+
* 显示用的字符串
|
|
526
1524
|
*/
|
|
527
1525
|
getDisplayValue(rowIndex: number, field: string): string;
|
|
528
1526
|
/**
|
|
529
1527
|
* 셀 하나의 값을 코드로 바꾼다(사용자 편집이 아니라 프로그램 갱신 경로). 값을 쓰면서 변경 추적에 기록하고,
|
|
530
1528
|
* 이 셀을 참조하는 수식들을 다시 계산하도록 표시한 뒤 화면을 다시 그린다. 낱개로 여러 셀을 바꿀 때는 렌더가
|
|
531
1529
|
* 매번 일어나니, 대량이면 `writeCells()` 나 `beginBatch()`/`endBatch()` 로 묶는 편이 빠르다.
|
|
532
|
-
*
|
|
1530
|
+
*
|
|
1531
|
+
* Change one cell's value from code (the programmatic path, not user editing). It records the change in
|
|
533
1532
|
* change tracking, marks formulas that reference this cell for recompute, then re-renders. For many cells,
|
|
534
1533
|
* prefer `writeCells()` or `beginBatch()`/`endBatch()` since each call re-renders.
|
|
535
1534
|
*
|
|
536
|
-
*
|
|
537
|
-
*
|
|
538
|
-
*
|
|
1535
|
+
* セル 1 つの値をコードから変えます(ユーザー編集ではなくプログラムからの更新経路)。値を書きながら変更追跡に記録し、
|
|
1536
|
+
* このセルを参照する数式を再計算対象として印を付けたうえで、画面を描画し直します。ばらばらに複数のセルを変えると
|
|
1537
|
+
* そのつどレンダーが走るため、大量の場合は `writeCells()` や `beginBatch()`/`endBatch()` でまとめたほうが高速です。
|
|
1538
|
+
*
|
|
1539
|
+
* 用代码改变单个单元格的值(不是用户编辑,而是程序的更新路径)。写值的同时记录到变更追踪,
|
|
1540
|
+
* 并把引用该单元格的公式标记为重算对象,然后重新绘制画面。零散地改多个单元格会每次都触发渲染,
|
|
1541
|
+
* 数量大时用 `writeCells()` 或 `beginBatch()`/`endBatch()` 打包更快。
|
|
1542
|
+
*
|
|
1543
|
+
* @param rowIndex - 화면 기준 행 위치(flat index)
|
|
1544
|
+
*
|
|
1545
|
+
* On-screen row position (flat index)
|
|
1546
|
+
*
|
|
1547
|
+
* 画面基準の行位置(flat index)
|
|
1548
|
+
*
|
|
1549
|
+
* 以画面为准的行位置(flat index)
|
|
1550
|
+
*
|
|
1551
|
+
* @param field - 컬럼 field
|
|
1552
|
+
*
|
|
1553
|
+
* Column field
|
|
1554
|
+
*
|
|
1555
|
+
* 列の field
|
|
1556
|
+
*
|
|
1557
|
+
* 列的 field
|
|
1558
|
+
*
|
|
1559
|
+
* @param value - 기록할 값
|
|
1560
|
+
*
|
|
1561
|
+
* Value to write
|
|
1562
|
+
*
|
|
1563
|
+
* 書き込む値
|
|
1564
|
+
*
|
|
1565
|
+
* 要写入的值
|
|
539
1566
|
*/
|
|
540
1567
|
writeCell(rowIndex: number, field: string, value: any): void;
|
|
541
|
-
/**
|
|
1568
|
+
/**
|
|
1569
|
+
* 지정 인덱스의 행 객체를 돌려준다(단건 조회용).
|
|
1570
|
+
*
|
|
1571
|
+
* Return the row object at the given index (single-row lookup).
|
|
1572
|
+
*
|
|
1573
|
+
* 指定インデックスの行オブジェクトを返します(単件照会用)。
|
|
1574
|
+
*
|
|
1575
|
+
* 返回指定索引的行对象(单件查询用)。
|
|
1576
|
+
*/
|
|
542
1577
|
getRowAt(rowIndex: number): T;
|
|
543
1578
|
/**
|
|
544
1579
|
* 화면상의 행 위치(flat/visual index)와 실제 데이터 행을 서로 변환해 주는 리졸버를 돌려준다. 그룹 머리글·
|
|
545
1580
|
* 트리 자식·상세 패널 같은 의사(pseudo) 행이 섞여 index 와 데이터가 어긋날 때, "이 index 가 진짜 데이터 행인가,
|
|
546
1581
|
* 몇 번 rowId 인가"를 물어보는 단일 창구다. 범위 선택+채우기·수식·차트 기능이 좌표를 해석할 때 모두 이 모델을 거친다.
|
|
547
|
-
*
|
|
1582
|
+
*
|
|
1583
|
+
* Return the resolver that maps between an on-screen row position (flat/visual index) and the actual
|
|
548
1584
|
* data row. When pseudo rows (group headers, tree children, detail panels) are interleaved and the
|
|
549
1585
|
* index no longer lines up with the data, this is the single place to ask "is this index a real data
|
|
550
1586
|
* row, and which rowId is it?". Range-fill, formulas, and charts all resolve coordinates through it.
|
|
551
1587
|
*
|
|
552
|
-
*
|
|
1588
|
+
* 画面上の行位置(flat/visual index)と実際のデータ行を相互に変換するリゾルバを返します。グループ見出し・ツリーの
|
|
1589
|
+
* 子・詳細パネルといった擬似(pseudo)行が混ざって index とデータがずれるとき、「この index は本当のデータ行なのか、
|
|
1590
|
+
* どの rowId なのか」を尋ねる唯一の窓口です。範囲選択+塗りつぶし・数式・チャートの各機能は、座標を解釈する際に
|
|
1591
|
+
* すべてこのモデルを経由します。
|
|
1592
|
+
*
|
|
1593
|
+
* 返回在画面上的行位置(flat/visual index)与实际数据行之间相互转换的解析器。当分组标题、树的子项、
|
|
1594
|
+
* 明细面板这类伪(pseudo)行混入,index 与数据对不上时,它是询问「这个 index 是不是真正的数据行,是哪个 rowId」
|
|
1595
|
+
* 的唯一窗口。范围选择+填充、公式、图表各功能在解释坐标时,都要经由这个模型。
|
|
1596
|
+
*
|
|
1597
|
+
* @returns flat/visual index ↔ data 리졸버
|
|
1598
|
+
*
|
|
1599
|
+
* The flat/visual index ↔ data resolver
|
|
1600
|
+
*
|
|
1601
|
+
* flat/visual index ↔ data のリゾルバ
|
|
1602
|
+
*
|
|
1603
|
+
* flat/visual index ↔ data 的解析器
|
|
553
1604
|
*/
|
|
554
1605
|
getFlatRowModel(): FlatRowModel;
|
|
555
|
-
/**
|
|
1606
|
+
/**
|
|
1607
|
+
* 배치 쓰기를 연다. 이 뒤로 이어지는 writeCell 들은 그때그때 다시 그리지 않고 모아 두었다가 endBatch 에서 한 번에 반영된다. 수많은 셀을 갱신할 때 endBatch 와 짝지어 감싼다.
|
|
1608
|
+
*
|
|
1609
|
+
* Open a write batch — subsequent writeCell calls are collected instead of re-rendering each time, and flushed together at endBatch. Wrap bulk updates with a matching endBatch.
|
|
1610
|
+
*
|
|
1611
|
+
* バッチ書き込みを開きます。これ以降に続く writeCell は、そのつど描画し直さずに溜め込まれ、endBatch でまとめて反映されます。多数のセルを更新するときは endBatch と対にして囲みます。
|
|
1612
|
+
*
|
|
1613
|
+
* 打开批量写入。此后接续的 writeCell 不会每次重绘,而是先攒起来,在 endBatch 一次性反映。更新大量单元格时,与 endBatch 成对包住。
|
|
1614
|
+
*/
|
|
556
1615
|
beginBatch(): void;
|
|
557
|
-
/**
|
|
1616
|
+
/**
|
|
1617
|
+
* 배치를 닫고 모아 둔 쓰기를 한 번에 반영한다 — 그 사이 변경이 있었으면 렌더 1회 + dataChange 이벤트 1회만 발생한다. beginBatch 와 반드시 짝을 맞춘다.
|
|
1618
|
+
*
|
|
1619
|
+
* Close the batch and flush collected writes at once — if anything changed, exactly one render + one dataChange event fires. Always pair it with beginBatch.
|
|
1620
|
+
*
|
|
1621
|
+
* バッチを閉じ、溜め込んだ書き込みを一度に反映します — その間に変更があれば、レンダー 1 回 + dataChange イベント 1 回だけが発生します。必ず beginBatch と対にしてください。
|
|
1622
|
+
*
|
|
1623
|
+
* 关闭批量并把攒下的写入一次性反映 — 其间若有变更,只发生 1 次渲染 + 1 次 dataChange 事件。务必与 beginBatch 成对使用。
|
|
1624
|
+
*/
|
|
558
1625
|
endBatch(): void;
|
|
559
1626
|
/**
|
|
560
1627
|
* 셀에 스프레드시트 스타일 수식을 건다("=A1+B2" 형태). 셀 값을 고정 숫자가 아니라 다른 셀에서
|
|
561
1628
|
* 계산되게 만들고 싶을 때 쓴다 — 참조한 셀이 바뀌면 이 셀도 자동으로 다시 계산되고, 순환 참조·에러는
|
|
562
1629
|
* `getCellError()` 로 표면화된다.
|
|
563
|
-
*
|
|
1630
|
+
*
|
|
1631
|
+
* Attach a spreadsheet-style formula to a cell (e.g. "=A1+B2"). Use it when a cell's value should
|
|
564
1632
|
* be computed from other cells rather than a fixed number — the cell recomputes automatically when
|
|
565
1633
|
* a referenced cell changes, and cycles/errors surface via `getCellError()`.
|
|
566
1634
|
*
|
|
567
|
-
*
|
|
568
|
-
*
|
|
569
|
-
*
|
|
1635
|
+
* セルにスプレッドシート形式の数式を掛けます(「=A1+B2」の形)。セルの値を固定の数値ではなく、ほかのセルから
|
|
1636
|
+
* 計算させたいときに使います — 参照したセルが変われば、このセルも自動的に再計算され、循環参照やエラーは
|
|
1637
|
+
* `getCellError()` で表面化します。
|
|
1638
|
+
*
|
|
1639
|
+
* 给单元格挂上电子表格式的公式(「=A1+B2」的形式)。想让单元格的值不是固定数值、而是由其他单元格
|
|
1640
|
+
* 计算得出时使用 — 被引用的单元格一变,这个单元格也会自动重算,循环引用与错误则通过 `getCellError()` 表面化。
|
|
1641
|
+
*
|
|
1642
|
+
* @param rowIndex - 화면 기준 행 위치(flat index)
|
|
1643
|
+
*
|
|
1644
|
+
* On-screen row position (flat index)
|
|
1645
|
+
*
|
|
1646
|
+
* 画面基準の行位置(flat index)
|
|
1647
|
+
*
|
|
1648
|
+
* 以画面为准的行位置(flat index)
|
|
1649
|
+
*
|
|
1650
|
+
* @param field - 컬럼 field
|
|
1651
|
+
*
|
|
1652
|
+
* Column field
|
|
1653
|
+
*
|
|
1654
|
+
* 列の field
|
|
1655
|
+
*
|
|
1656
|
+
* 列的 field
|
|
1657
|
+
*
|
|
1658
|
+
* @param formula - '=' 로 시작하는 수식 원문
|
|
1659
|
+
*
|
|
1660
|
+
* Formula source starting with '='
|
|
1661
|
+
*
|
|
1662
|
+
* '=' で始まる数式の原文
|
|
1663
|
+
*
|
|
1664
|
+
* 以 '=' 开头的公式原文
|
|
1665
|
+
*
|
|
570
1666
|
* @example
|
|
571
1667
|
* grid.setCellFormula(2, 'total', '=A1+B1');
|
|
572
1668
|
*/
|
|
573
1669
|
setCellFormula(rowIndex: number, field: string, formula: string): void;
|
|
574
|
-
/**
|
|
1670
|
+
/**
|
|
1671
|
+
* 셀 수식 원문(없으면 null).
|
|
1672
|
+
*
|
|
1673
|
+
* Formula source of the cell (null when absent).
|
|
1674
|
+
*
|
|
1675
|
+
* セル数式の原文(なければ null)。
|
|
1676
|
+
*
|
|
1677
|
+
* 单元格公式的原文(没有则为 null)。
|
|
1678
|
+
*/
|
|
575
1679
|
getCellFormula(rowIndex: number, field: string): string | null;
|
|
576
|
-
/**
|
|
1680
|
+
/**
|
|
1681
|
+
* 셀에 수식이 있는지.
|
|
1682
|
+
*
|
|
1683
|
+
* Whether the cell has a formula.
|
|
1684
|
+
*
|
|
1685
|
+
* セルに数式があるかどうか。
|
|
1686
|
+
*
|
|
1687
|
+
* 单元格是否有公式。
|
|
1688
|
+
*/
|
|
577
1689
|
hasCellFormula(rowIndex: number, field: string): boolean;
|
|
578
|
-
/**
|
|
1690
|
+
/**
|
|
1691
|
+
* 수식 제거(마지막 계산값은 유지).
|
|
1692
|
+
*
|
|
1693
|
+
* Remove the formula (last computed value kept).
|
|
1694
|
+
*
|
|
1695
|
+
* 数式の削除(最後の計算値は維持)。
|
|
1696
|
+
*
|
|
1697
|
+
* 删除公式(最后的计算值保留)。
|
|
1698
|
+
*/
|
|
579
1699
|
clearCellFormula(rowIndex: number, field: string): void;
|
|
580
|
-
/**
|
|
1700
|
+
/**
|
|
1701
|
+
* 셀 수식 에러 코드(없으면 null).
|
|
1702
|
+
*
|
|
1703
|
+
* Formula error code of the cell (null when none).
|
|
1704
|
+
*
|
|
1705
|
+
* セル数式のエラーコード(なければ null)。
|
|
1706
|
+
*
|
|
1707
|
+
* 单元格公式的错误码(没有则为 null)。
|
|
1708
|
+
*/
|
|
581
1709
|
getCellError(rowIndex: number, field: string): FormulaErrorCode | null;
|
|
582
|
-
/**
|
|
1710
|
+
/**
|
|
1711
|
+
* 디버깅용 — 이 셀을 참조하는(종속) 셀들.
|
|
1712
|
+
*
|
|
1713
|
+
* Debugging — cells that depend on this cell.
|
|
1714
|
+
*
|
|
1715
|
+
* デバッグ用 — このセルを参照する(従属)セル群。
|
|
1716
|
+
*
|
|
1717
|
+
* 调试用 — 引用该单元格的(从属)单元格。
|
|
1718
|
+
*/
|
|
583
1719
|
getDependents(rowIndex: number, field: string): Array<{
|
|
584
1720
|
rowIndex: number;
|
|
585
1721
|
field: string;
|
|
586
1722
|
}>;
|
|
587
|
-
/**
|
|
1723
|
+
/**
|
|
1724
|
+
* 디버깅용 — 이 셀이 참조하는(선행) 셀들.
|
|
1725
|
+
*
|
|
1726
|
+
* Debugging — cells this cell references (precedents).
|
|
1727
|
+
*
|
|
1728
|
+
* デバッグ用 — このセルが参照する(先行)セル群。
|
|
1729
|
+
*
|
|
1730
|
+
* 调试用 — 该单元格引用的(先行)单元格。
|
|
1731
|
+
*/
|
|
588
1732
|
getPrecedents(rowIndex: number, field: string): Array<{
|
|
589
1733
|
rowIndex: number;
|
|
590
1734
|
field: string;
|
|
591
1735
|
}>;
|
|
592
|
-
/**
|
|
1736
|
+
/**
|
|
1737
|
+
* 전체 수식 위상 재계산.
|
|
1738
|
+
*
|
|
1739
|
+
* Recalculate all formulas in topological order.
|
|
1740
|
+
*
|
|
1741
|
+
* 全数式のトポロジカル再計算。
|
|
1742
|
+
*
|
|
1743
|
+
* 全部公式的拓扑重算。
|
|
1744
|
+
*/
|
|
593
1745
|
recalculate(): void;
|
|
594
|
-
/**
|
|
1746
|
+
/**
|
|
1747
|
+
* 단일 셀 + 종속 폐포만 재계산.
|
|
1748
|
+
*
|
|
1749
|
+
* Recalculate one cell plus its dependent closure.
|
|
1750
|
+
*
|
|
1751
|
+
* 単一セル + その従属閉包のみを再計算。
|
|
1752
|
+
*
|
|
1753
|
+
* 只重算单个单元格 + 其从属闭包。
|
|
1754
|
+
*/
|
|
595
1755
|
recalculateCell(rowIndex: number, field: string): void;
|
|
596
1756
|
/**
|
|
597
1757
|
* 원본 셀 수식을 dRow/dCol 만큼 옮겨 새 위치에 맞게 상대 참조를 조정한 수식 원문을 만든다. 범위 선택+채우기
|
|
598
1758
|
* 로 수식을 아래·옆으로 끌어 복사할 때, 절대 참조(`$` 고정)는 그대로 두고 상대 참조만 이동량만큼 밀어 주는
|
|
599
1759
|
* 저수준 도우미다(엑셀에서 수식을 드래그 복사하면 참조가 따라 움직이는 것과 같은 규칙).
|
|
600
|
-
*
|
|
1760
|
+
*
|
|
1761
|
+
* Produce a formula source with relative references shifted by dRow/dCol so it fits a new location.
|
|
601
1762
|
* A low-level helper used when range-fill drags a formula down/across: absolute (`$`-locked) refs stay
|
|
602
1763
|
* put while relative refs move by the offset — the same rule as drag-copying a formula in a spreadsheet.
|
|
603
1764
|
*
|
|
604
|
-
*
|
|
605
|
-
*
|
|
606
|
-
*
|
|
607
|
-
*
|
|
608
|
-
*
|
|
1765
|
+
* 元のセル数式を dRow/dCol の分だけずらし、新しい位置に合わせて相対参照を調整した数式の原文を作ります。範囲選択+
|
|
1766
|
+
* 塗りつぶしで数式を下・横へ引いてコピーするとき、絶対参照(`$` で固定)はそのままに、相対参照だけを移動量の分だけ
|
|
1767
|
+
* ずらす低レベルのヘルパーです(スプレッドシートで数式をドラッグコピーすると参照が付いて動くのと同じ規則)。
|
|
1768
|
+
*
|
|
1769
|
+
* 把原单元格公式按 dRow/dCol 平移,生成一份按新位置调整了相对引用的公式原文。用范围选择+填充把公式
|
|
1770
|
+
* 向下、向旁拖拽复制时,绝对引用(用 `$` 固定)保持不动,只把相对引用按位移量推移的低层辅助函数
|
|
1771
|
+
* (与在 Excel 中拖拽复制公式时引用会跟着移动的规则相同)。
|
|
1772
|
+
*
|
|
1773
|
+
* @param srcRowId - 원본 셀의 rowId
|
|
1774
|
+
*
|
|
1775
|
+
* rowId of the source cell
|
|
1776
|
+
*
|
|
1777
|
+
* 元のセルの rowId
|
|
1778
|
+
*
|
|
1779
|
+
* 原单元格的 rowId
|
|
1780
|
+
*
|
|
1781
|
+
* @param srcField - 원본 셀의 field
|
|
1782
|
+
*
|
|
1783
|
+
* field of the source cell
|
|
1784
|
+
*
|
|
1785
|
+
* 元のセルの field
|
|
1786
|
+
*
|
|
1787
|
+
* 原单元格的 field
|
|
1788
|
+
*
|
|
1789
|
+
* @param dRow - 행 오프셋
|
|
1790
|
+
*
|
|
1791
|
+
* Row offset
|
|
1792
|
+
*
|
|
1793
|
+
* 行のオフセット
|
|
1794
|
+
*
|
|
1795
|
+
* 行的偏移量
|
|
1796
|
+
*
|
|
1797
|
+
* @param dCol - 열 오프셋
|
|
1798
|
+
*
|
|
1799
|
+
* Column offset
|
|
1800
|
+
*
|
|
1801
|
+
* 列のオフセット
|
|
1802
|
+
*
|
|
1803
|
+
* 列的偏移量
|
|
1804
|
+
*
|
|
1805
|
+
* @returns 이동 반영된 새 수식 원문
|
|
1806
|
+
*
|
|
1807
|
+
* New formula source with the offset applied
|
|
1808
|
+
*
|
|
1809
|
+
* 移動が反映された新しい数式の原文
|
|
1810
|
+
*
|
|
1811
|
+
* 反映了平移的新公式原文
|
|
609
1812
|
*/
|
|
610
1813
|
offsetFormula(srcRowId: string, srcField: string, dRow: number, dCol: number): string;
|
|
611
1814
|
/**
|
|
@@ -614,14 +1817,40 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
614
1817
|
* index)이며, 대상이 실제 데이터 행이 아니라 그룹 머리글·트리·상세 같은 의사(pseudo) 행이면 데이터 훼손을
|
|
615
1818
|
* 막기 위해 그 셀은 조용히 건너뛴다. 건너뛴 셀 수를 돌려주고, 1건이라도 있으면 스크린리더 안내와
|
|
616
1819
|
* 'writeCellsSkip' 이벤트로 알린다.
|
|
617
|
-
*
|
|
1820
|
+
*
|
|
1821
|
+
* Write many cells at once. They are wrapped in one batch, so render/events fire once at the end
|
|
618
1822
|
* instead of per cell — much faster than looping single `writeCell` calls for hundreds of cells. Each
|
|
619
1823
|
* rowIndex is an on-screen position (flat index); if a target is not a real data row but a pseudo row
|
|
620
1824
|
* (group header, tree, detail), that cell is skipped to avoid corrupting data. Returns the number of
|
|
621
1825
|
* skipped cells and, when non-zero, surfaces it via a screen-reader announce + a 'writeCellsSkip' event.
|
|
622
1826
|
*
|
|
623
|
-
*
|
|
624
|
-
*
|
|
1827
|
+
* 複数のセルを一度に書き込みます。内部でバッチにまとめて処理するため、レンダーやイベントがセルごとに走らず最後に
|
|
1828
|
+
* 1 回だけ起こり、数百セルを更新するときに `writeCell` を 1 件ずつ繰り返すよりはるかに高速です。各 rowIndex は
|
|
1829
|
+
* 画面基準の位置(flat index)であり、対象が実際のデータ行ではなくグループ見出し・ツリー・詳細といった擬似(pseudo)
|
|
1830
|
+
* 行の場合は、データの破損を防ぐためそのセルを黙ってスキップします。スキップしたセル数を返し、1 件でもあれば
|
|
1831
|
+
* スクリーンリーダーへの通知と 'writeCellsSkip' イベントで知らせます。
|
|
1832
|
+
*
|
|
1833
|
+
* 一次写入多个单元格。内部打包成批处理,因此渲染与事件不会每个单元格都触发,而是最后只发生 1 次,
|
|
1834
|
+
* 更新数百个单元格时比逐个重复 `writeCell` 快得多。各 rowIndex 是以画面为准的位置(flat index),
|
|
1835
|
+
* 若目标不是实际的数据行,而是分组标题、树、明细这类伪(pseudo)行,为防止数据损坏会静默跳过该单元格。
|
|
1836
|
+
* 返回跳过的单元格数,只要有 1 件就通过屏幕阅读器通知和 'writeCellsSkip' 事件告知。
|
|
1837
|
+
*
|
|
1838
|
+
* @param patches - 쓰기 목록
|
|
1839
|
+
*
|
|
1840
|
+
* List of writes
|
|
1841
|
+
*
|
|
1842
|
+
* 書き込みの一覧
|
|
1843
|
+
*
|
|
1844
|
+
* 写入的列表
|
|
1845
|
+
*
|
|
1846
|
+
* @returns 건너뛴 셀 수
|
|
1847
|
+
*
|
|
1848
|
+
* Number of skipped cells
|
|
1849
|
+
*
|
|
1850
|
+
* スキップしたセル数
|
|
1851
|
+
*
|
|
1852
|
+
* 跳过的单元格数
|
|
1853
|
+
*
|
|
625
1854
|
* @example
|
|
626
1855
|
* const skipped = grid.writeCells([
|
|
627
1856
|
* { rowIndex: 0, field: 'qty', value: 10 },
|
|
@@ -633,41 +1862,140 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
633
1862
|
field: string;
|
|
634
1863
|
value: any;
|
|
635
1864
|
}>): number;
|
|
636
|
-
/**
|
|
1865
|
+
/**
|
|
1866
|
+
* 사용자가 드래그로 선택한 셀 사각형(범위)들을 정규화해 돌려준다. 선택이 없으면 빈 배열. 현재 버전은 한 번에 하나의 범위만 다루므로 길이는 최대 1이다.
|
|
1867
|
+
*
|
|
1868
|
+
* Return the user's drag-selected cell rectangles, normalized; empty when nothing is selected. This version handles one range at a time, so length is at most 1.
|
|
1869
|
+
*
|
|
1870
|
+
* ユーザーがドラッグで選択したセルの矩形(範囲)を正規化して返します。選択がなければ空配列です。現在のバージョンは一度に 1 つの範囲しか扱わないため、長さは最大 1 です。
|
|
1871
|
+
*
|
|
1872
|
+
* 把用户拖拽选中的单元格矩形(范围)规范化后返回。没有选择则为空数组。当前版本一次只处理 1 个范围,因此长度最大为 1。
|
|
1873
|
+
*/
|
|
637
1874
|
getRangeSelection(): CellRange[];
|
|
638
|
-
/**
|
|
1875
|
+
/**
|
|
1876
|
+
* 지금 활성인 선택 범위 하나를 바로 꺼내는 지름길(선택이 없으면 null). 선택 여부만 확인하거나 그 범위로 값을 읽을 때 쓴다.
|
|
1877
|
+
*
|
|
1878
|
+
* Shortcut to the single active selection range (null when none) — handy to check selection or read values from it.
|
|
1879
|
+
*
|
|
1880
|
+
* いま有効な選択範囲を 1 つだけ直接取り出す近道(選択がなければ null)。選択の有無を確認したり、その範囲から値を読んだりするときに使います。
|
|
1881
|
+
*
|
|
1882
|
+
* 直接取出当前有效的 1 个选择范围的近道(没有选择则为 null)。用于确认是否有选择,或从该范围读取值。
|
|
1883
|
+
*/
|
|
639
1884
|
getActiveRange(): CellRange | null;
|
|
640
|
-
/**
|
|
1885
|
+
/**
|
|
1886
|
+
* 마우스 드래그 없이 코드로 셀 범위를 선택 상태로 만든다. 검색 결과나 계산으로 특정 영역을 하이라이트하고 싶을 때 쓴다.
|
|
1887
|
+
*
|
|
1888
|
+
* Select a cell range from code (no mouse drag) — use it to highlight a region from a search result or computation.
|
|
1889
|
+
*
|
|
1890
|
+
* マウスのドラッグなしに、コードからセル範囲を選択状態にします。検索結果や計算によって特定の領域をハイライトしたいときに使います。
|
|
1891
|
+
*
|
|
1892
|
+
* 不用鼠标拖拽,而从代码把单元格范围置为选中状态。想根据搜索结果或计算高亮特定区域时使用。
|
|
1893
|
+
*/
|
|
641
1894
|
setRangeSelection(range: CellRange | CellRange[]): void;
|
|
642
|
-
/**
|
|
1895
|
+
/**
|
|
1896
|
+
* 현재 범위 선택을 모두 해제해 하이라이트를 지운다.
|
|
1897
|
+
*
|
|
1898
|
+
* Clear the range selection, removing the highlight.
|
|
1899
|
+
*
|
|
1900
|
+
* 現在の範囲選択をすべて解除し、ハイライトを消します。
|
|
1901
|
+
*
|
|
1902
|
+
* 解除当前的全部范围选择,清除高亮。
|
|
1903
|
+
*/
|
|
643
1904
|
clearRangeSelection(): void;
|
|
644
|
-
/**
|
|
1905
|
+
/**
|
|
1906
|
+
* 활성 범위 안의 셀 값들을 행×열 2차원 배열로 추출한다. 선택 영역을 복사하거나 외부로 넘길 때 쓴다.
|
|
1907
|
+
*
|
|
1908
|
+
* Extract the active range's cell values as a row×column 2D array — for copying or exporting the selection.
|
|
1909
|
+
*
|
|
1910
|
+
* 有効な範囲内のセル値を、行×列の 2 次元配列として取り出します。選択領域をコピーしたり外部へ渡したりするときに使います。
|
|
1911
|
+
*
|
|
1912
|
+
* 把有效范围内的单元格值,以行×列的二维数组取出。用于复制选择区域或传给外部。
|
|
1913
|
+
*/
|
|
645
1914
|
getRangeValues(): any[][];
|
|
646
|
-
/**
|
|
1915
|
+
/**
|
|
1916
|
+
* 활성 범위의 숫자 셀들만 모아 합계·평균 등 요약값을 계산한다(정밀 십진 연산 기반, 선택 없으면 null). 상태바에 "선택 합계"를 띄우는 용도.
|
|
1917
|
+
*
|
|
1918
|
+
* Compute sum/avg… over just the numeric cells in the active range (exact-decimal math; null when no selection) — e.g. to show a "sum of selection" in a status bar.
|
|
1919
|
+
*
|
|
1920
|
+
* 有効な範囲の数値セルだけを集めて、合計・平均などの要約値を計算します(高精度な十進演算に基づき、選択がなければ null)。ステータスバーに「選択範囲の合計」を出す用途です。
|
|
1921
|
+
*
|
|
1922
|
+
* 只收集有效范围内的数值单元格,计算合计、平均等汇总值(基于高精度十进制运算,没有选择则为 null)。用途是在状态栏显示「选择范围的合计」。
|
|
1923
|
+
*/
|
|
647
1924
|
getRangeStats(): RangeStats | null;
|
|
648
1925
|
/**
|
|
649
1926
|
* 원본 범위의 값을 대상 범위로 채워 넣는다 — 엑셀에서 채우기 핸들을 아래·옆으로 끌어 값을 복사하거나
|
|
650
1927
|
* 연속값을 만드는 동작을 프로그램으로 실행하는 API다. 채우는 방향(가로/세로)은 두 범위의 상대 위치로
|
|
651
1928
|
* 자동 추론하며, 내부적으로 배치로 묶어 한 번에 반영한다.
|
|
652
|
-
*
|
|
1929
|
+
*
|
|
1930
|
+
* Fill the target range from the source range — the programmatic form of dragging Excel's fill
|
|
653
1931
|
* handle down/across to copy values or extend a series. The direction (horizontal/vertical) is
|
|
654
1932
|
* inferred from the two ranges' relative position, and the writes are applied in one batch.
|
|
655
1933
|
*
|
|
656
|
-
*
|
|
657
|
-
*
|
|
658
|
-
*
|
|
1934
|
+
* 元の範囲の値を対象範囲へ流し込みます — スプレッドシートで塗りつぶしハンドルを下・横へ引いて値をコピーしたり、
|
|
1935
|
+
* 連続値を作ったりする動作をプログラムから実行する API です。塗りつぶす方向(横/縦)は 2 つの範囲の相対位置から
|
|
1936
|
+
* 自動的に推論し、内部ではバッチにまとめて一度に反映します。
|
|
1937
|
+
*
|
|
1938
|
+
* 把源范围的值灌入目标范围 — 是把在 Excel 中把填充手柄向下、向旁拖拽以复制值或生成连续值的动作,
|
|
1939
|
+
* 用程序执行的 API。填充的方向(横/纵)由两个范围的相对位置自动推断,内部打包成批一次性反映。
|
|
1940
|
+
*
|
|
1941
|
+
* @param source - 원본 범위
|
|
1942
|
+
*
|
|
1943
|
+
* Source range
|
|
1944
|
+
*
|
|
1945
|
+
* 元の範囲
|
|
1946
|
+
*
|
|
1947
|
+
* 源范围
|
|
1948
|
+
*
|
|
1949
|
+
* @param target - 대상 범위
|
|
1950
|
+
*
|
|
1951
|
+
* Target range
|
|
1952
|
+
*
|
|
1953
|
+
* 対象範囲
|
|
1954
|
+
*
|
|
1955
|
+
* 目标范围
|
|
1956
|
+
*
|
|
1957
|
+
* @param mode - 'copy'(같은 값 복사, 기본) 또는 'series'(연속값 생성)
|
|
1958
|
+
*
|
|
1959
|
+
* 'copy' (repeat values, default) or 'series' (extend a sequence)
|
|
1960
|
+
*
|
|
1961
|
+
* 'copy'(同じ値をコピー、既定)または 'series'(連続値を生成)
|
|
1962
|
+
*
|
|
1963
|
+
* 'copy'(复制相同的值,默认)或 'series'(生成连续值)
|
|
659
1964
|
*/
|
|
660
1965
|
fillRange(source: CellRange, target: CellRange, mode?: 'copy' | 'series'): void;
|
|
661
1966
|
/**
|
|
662
1967
|
* 그리드에 들어 있는 데이터를 그대로 원천으로 삼아 차트를 만든다. 별도로 데이터를 넘길 필요 없이
|
|
663
1968
|
* "어떤 컬럼을(source/series) 어떤 모양으로(type) 그릴지"만 지정하면 된다. `live: true` 로 만들면
|
|
664
1969
|
* 그리드 데이터가 바뀔 때 차트도 자동으로 다시 그려져, 표와 그래프가 항상 같은 값을 가리킨다.
|
|
665
|
-
*
|
|
1970
|
+
*
|
|
1971
|
+
* Create a chart that uses the grid's own data as its source. You don't pass data separately — just
|
|
666
1972
|
* declare which columns to draw (source/series) and how (type). With `live: true` the chart re-renders
|
|
667
1973
|
* whenever the grid data changes, so table and chart always show the same numbers.
|
|
668
1974
|
*
|
|
669
|
-
*
|
|
670
|
-
*
|
|
1975
|
+
* グリッドに入っているデータをそのまま源としてチャートを作ります。データを別途渡す必要はなく、「どの列を
|
|
1976
|
+
* (source/series)どの形で(type)描くか」だけを指定します。`live: true` で作ると、グリッドのデータが変わったとき
|
|
1977
|
+
* チャートも自動的に描画し直され、表とグラフが常に同じ値を指します。
|
|
1978
|
+
*
|
|
1979
|
+
* 把表格中的数据直接当作源来制作图表。无需另外传入数据,只要指定「把哪些列(source/series)
|
|
1980
|
+
* 以什么形状(type)绘制」即可。用 `live: true` 创建时,表格数据一变,图表也会自动重新绘制,
|
|
1981
|
+
* 使表与图始终指向相同的值。
|
|
1982
|
+
*
|
|
1983
|
+
* @param config - 차트 구성(소스·타입·배치 등)
|
|
1984
|
+
*
|
|
1985
|
+
* Chart config (source, type, placement, …)
|
|
1986
|
+
*
|
|
1987
|
+
* チャートの構成(ソース・タイプ・配置など)
|
|
1988
|
+
*
|
|
1989
|
+
* 图表的构成(源、类型、放置等)
|
|
1990
|
+
*
|
|
1991
|
+
* @returns 생성된 차트 인스턴스
|
|
1992
|
+
*
|
|
1993
|
+
* The created chart instance
|
|
1994
|
+
*
|
|
1995
|
+
* 生成されたチャートインスタンス
|
|
1996
|
+
*
|
|
1997
|
+
* 生成的图表实例
|
|
1998
|
+
*
|
|
671
1999
|
* @example
|
|
672
2000
|
* const chart = grid.createChart({
|
|
673
2001
|
* type: 'bar',
|
|
@@ -676,21 +2004,69 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
676
2004
|
* });
|
|
677
2005
|
*/
|
|
678
2006
|
createChart(config: ChartConfig): ChartInstance;
|
|
679
|
-
/**
|
|
2007
|
+
/**
|
|
2008
|
+
* 이 그리드가 만들어 아직 살아 있는 차트 인스턴스들을 돌려준다(일괄 갱신·조회용).
|
|
2009
|
+
*
|
|
2010
|
+
* Return the still-alive chart instances this grid created — for bulk refresh/inspection.
|
|
2011
|
+
*
|
|
2012
|
+
* このグリッドが作り、まだ生きているチャートインスタンスを返します(一括更新・照会用)。
|
|
2013
|
+
*
|
|
2014
|
+
* 返回这个表格创建且仍然存活的图表实例(用于批量更新、查询)。
|
|
2015
|
+
*/
|
|
680
2016
|
getCharts(): ChartInstance[];
|
|
681
|
-
/**
|
|
2017
|
+
/**
|
|
2018
|
+
* 이 그리드가 만든 모든 차트를 파괴한다. 데이터 변경 구독까지 함께 끊어 메모리 누수를 막으므로, 차트를 정리할 때 반드시 호출한다.
|
|
2019
|
+
*
|
|
2020
|
+
* Destroy every chart this grid made, cutting their data-change subscriptions too to prevent leaks — call it when tearing charts down.
|
|
2021
|
+
*
|
|
2022
|
+
* このグリッドが作ったすべてのチャートを破棄します。データ変更の購読も併せて切ってメモリリークを防ぐため、チャートを片付けるときは必ず呼び出してください。
|
|
2023
|
+
*
|
|
2024
|
+
* 销毁这个表格创建的所有图表。会一并切断数据变更的订阅以防止内存泄漏,因此清理图表时务必调用。
|
|
2025
|
+
*/
|
|
682
2026
|
destroyCharts(): void;
|
|
683
|
-
/**
|
|
2027
|
+
/**
|
|
2028
|
+
* 마지막 저장 이후 무엇이 바뀌었는지를 추가·수정·삭제 세 묶음으로 돌려준다. "변경분만 서버로 보내기"처럼 저장 시 델타를 만들 때 쓴다.
|
|
2029
|
+
*
|
|
2030
|
+
* Return what changed since the last save, grouped as added/edited/removed — for building a save delta ("send only changes to the server").
|
|
2031
|
+
*
|
|
2032
|
+
* 最後の保存以降に何が変わったかを、追加・修正・削除の 3 つの束にして返します。「変更分だけをサーバーへ送る」のように、保存時のデルタを作るときに使います。
|
|
2033
|
+
*
|
|
2034
|
+
* 把最后一次保存之后发生的变化,按添加、修改、删除三组返回。像「只把变更部分发往服务器」那样,制作保存时的增量时使用。
|
|
2035
|
+
*/
|
|
684
2036
|
getChanges(): {
|
|
685
2037
|
added: T[];
|
|
686
2038
|
edited: T[];
|
|
687
2039
|
removed: T[];
|
|
688
2040
|
};
|
|
689
|
-
/**
|
|
2041
|
+
/**
|
|
2042
|
+
* 수정된 행 목록.
|
|
2043
|
+
*
|
|
2044
|
+
* Edited rows.
|
|
2045
|
+
*
|
|
2046
|
+
* 修正された行の一覧。
|
|
2047
|
+
*
|
|
2048
|
+
* 修改过的行的列表。
|
|
2049
|
+
*/
|
|
690
2050
|
getEditedRows(): T[];
|
|
691
|
-
/**
|
|
692
|
-
|
|
693
|
-
|
|
2051
|
+
/**
|
|
2052
|
+
* @deprecated 하위 호환 — getEditedRows() 권장.
|
|
2053
|
+
*
|
|
2054
|
+
* Backward compat — prefer getEditedRows().
|
|
2055
|
+
*
|
|
2056
|
+
* 後方互換 — getEditedRows() を推奨。
|
|
2057
|
+
*
|
|
2058
|
+
* 后方兼容 — 推荐 getEditedRows()。
|
|
2059
|
+
*/
|
|
2060
|
+
getChangedRows(): T[];
|
|
2061
|
+
/**
|
|
2062
|
+
* 행별 변경 필드·old/new 값 상세.
|
|
2063
|
+
*
|
|
2064
|
+
* Per-row changed fields with old/new values.
|
|
2065
|
+
*
|
|
2066
|
+
* 行ごとの変更フィールドと old/new 値の詳細。
|
|
2067
|
+
*
|
|
2068
|
+
* 每行的变更字段与 old/new 值的详情。
|
|
2069
|
+
*/
|
|
694
2070
|
getChangedColumns(): Array<{
|
|
695
2071
|
row: T;
|
|
696
2072
|
fields: string[];
|
|
@@ -700,248 +2076,950 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
700
2076
|
newValue: any;
|
|
701
2077
|
}>;
|
|
702
2078
|
}>;
|
|
703
|
-
/**
|
|
2079
|
+
/**
|
|
2080
|
+
* 추가된 행 목록.
|
|
2081
|
+
*
|
|
2082
|
+
* Added rows.
|
|
2083
|
+
*
|
|
2084
|
+
* 追加された行の一覧。
|
|
2085
|
+
*
|
|
2086
|
+
* 添加的行的列表。
|
|
2087
|
+
*/
|
|
704
2088
|
getAddedRows(): T[];
|
|
705
|
-
/**
|
|
2089
|
+
/**
|
|
2090
|
+
* 삭제된 행 목록.
|
|
2091
|
+
*
|
|
2092
|
+
* Removed rows.
|
|
2093
|
+
*
|
|
2094
|
+
* 削除された行の一覧。
|
|
2095
|
+
*
|
|
2096
|
+
* 删除的行的列表。
|
|
2097
|
+
*/
|
|
706
2098
|
getRemovedRows(): T[];
|
|
707
|
-
/**
|
|
2099
|
+
/**
|
|
2100
|
+
* 행의 원본(수정 전) 스냅샷.
|
|
2101
|
+
*
|
|
2102
|
+
* Original (pre-edit) snapshot of the row.
|
|
2103
|
+
*
|
|
2104
|
+
* 行の元(修正前)のスナップショット。
|
|
2105
|
+
*
|
|
2106
|
+
* 行的原始(修改前)快照。
|
|
2107
|
+
*/
|
|
708
2108
|
getOriginalRow(rowIndex: number): T | undefined;
|
|
709
|
-
/**
|
|
2109
|
+
/**
|
|
2110
|
+
* stateField 값이 있는 행 목록.
|
|
2111
|
+
*
|
|
2112
|
+
* Rows having a value in stateField.
|
|
2113
|
+
*
|
|
2114
|
+
* stateField に値がある行の一覧。
|
|
2115
|
+
*
|
|
2116
|
+
* stateField 中有值的行的列表。
|
|
2117
|
+
*/
|
|
710
2118
|
getRowsWithState(stateField: string): T[];
|
|
711
|
-
/**
|
|
2119
|
+
/**
|
|
2120
|
+
* @deprecated no-op stub — undo/redo 히스토리는 미구현. 변이 가드는 TriggerManager `before:*` 훅,
|
|
712
2121
|
* 변경 추적은 `getChanges()`/`getOriginalRow()` 를 사용.
|
|
713
|
-
*
|
|
714
|
-
*
|
|
2122
|
+
*
|
|
2123
|
+
* no-op stub — undo/redo history is not implemented. Use TriggerManager `before:*` hooks
|
|
2124
|
+
* for mutation guards and `getChanges()`/`getOriginalRow()` for change tracking.
|
|
2125
|
+
*
|
|
2126
|
+
* no-op スタブ — undo/redo の履歴は未実装です。変更のガードには TriggerManager の `before:*` フックを、
|
|
2127
|
+
* 変更追跡には `getChanges()`/`getOriginalRow()` を使ってください。
|
|
2128
|
+
*
|
|
2129
|
+
* no-op 桩 — undo/redo 的历史未实现。变更的守卫请用 TriggerManager 的 `before:*` 钩子,
|
|
2130
|
+
* 变更追踪请用 `getChanges()`/`getOriginalRow()`。
|
|
2131
|
+
*/
|
|
715
2132
|
undo(): void;
|
|
716
|
-
/**
|
|
2133
|
+
/**
|
|
2134
|
+
* @deprecated no-op stub — undo/redo 히스토리 미구현(위 `undo()` 참조).
|
|
2135
|
+
*
|
|
2136
|
+
* no-op stub — see `undo()` above.
|
|
2137
|
+
*
|
|
2138
|
+
* no-op スタブ — undo/redo の履歴は未実装(上の `undo()` を参照)。
|
|
2139
|
+
*
|
|
2140
|
+
* no-op 桩 — undo/redo 的历史未实现(参见上面的 `undo()`)。
|
|
2141
|
+
*/
|
|
717
2142
|
redo(): void;
|
|
718
|
-
/**
|
|
2143
|
+
/**
|
|
2144
|
+
* @deprecated no-op stub — undo/redo 히스토리 자체가 없어 비울 것도 없음(위 `undo()` 참조).
|
|
2145
|
+
*
|
|
2146
|
+
* no-op stub — there is no history to clear (see `undo()`).
|
|
2147
|
+
*
|
|
2148
|
+
* no-op スタブ — undo/redo の履歴自体がないため、消すものもありません(上の `undo()` を参照)。
|
|
2149
|
+
*
|
|
2150
|
+
* no-op 桩 — 本来就没有 undo/redo 的历史,因此也没有可清空的东西(参见上面的 `undo()`)。
|
|
2151
|
+
*/
|
|
719
2152
|
clearHistory(): void;
|
|
720
|
-
/**
|
|
2153
|
+
/**
|
|
2154
|
+
* 보이는 리프 컬럼 정의 목록.
|
|
2155
|
+
*
|
|
2156
|
+
* Visible leaf column definitions.
|
|
2157
|
+
*
|
|
2158
|
+
* 表示されているリーフ列の定義一覧。
|
|
2159
|
+
*
|
|
2160
|
+
* 显示中的叶子列的定义列表。
|
|
2161
|
+
*/
|
|
721
2162
|
getColumnDefs(): ColumnDef<T>[];
|
|
722
|
-
/**
|
|
2163
|
+
/**
|
|
2164
|
+
* 숨김 포함 전체 리프 컬럼 정의.
|
|
2165
|
+
*
|
|
2166
|
+
* All leaf column definitions including hidden.
|
|
2167
|
+
*
|
|
2168
|
+
* 非表示を含む全リーフ列の定義。
|
|
2169
|
+
*
|
|
2170
|
+
* 包含隐藏列的全部叶子列的定义。
|
|
2171
|
+
*/
|
|
723
2172
|
getAllColumnDefs(): ColumnDef<T>[];
|
|
724
|
-
/**
|
|
2173
|
+
/**
|
|
2174
|
+
* 보이는 컬럼 수.
|
|
2175
|
+
*
|
|
2176
|
+
* Number of visible columns.
|
|
2177
|
+
*
|
|
2178
|
+
* 表示されている列の数。
|
|
2179
|
+
*
|
|
2180
|
+
* 显示中的列数。
|
|
2181
|
+
*/
|
|
725
2182
|
getColumnCount(): number;
|
|
726
|
-
/**
|
|
2183
|
+
/**
|
|
2184
|
+
* 컬럼 구성 전체를 새 정의로 갈아끼우고 다시 그린다. 화면 모드에 따라 보여줄 열 세트를 통째로 바꿀 때 쓴다(개별 추가/삭제는 insertColumn/deleteColumn).
|
|
2185
|
+
*
|
|
2186
|
+
* Replace the entire column set with new definitions and re-render — for swapping the whole column layout by view mode (use insertColumn/deleteColumn for single changes).
|
|
2187
|
+
*
|
|
2188
|
+
* 列構成の全体を新しい定義に差し替えて描画し直します。画面モードに応じて見せる列のセットをまるごと変えるときに使います(個別の追加/削除は insertColumn/deleteColumn)。
|
|
2189
|
+
*
|
|
2190
|
+
* 把列构成的整体换成新定义并重新绘制。按画面模式整体更换要展示的列集合时使用(单个的添加/删除用 insertColumn/deleteColumn)。
|
|
2191
|
+
*/
|
|
727
2192
|
applyColumns(columns: ColumnDef<T>[]): void;
|
|
728
|
-
/**
|
|
2193
|
+
/**
|
|
2194
|
+
* 컬럼 1개를 삽입한다.
|
|
2195
|
+
*
|
|
2196
|
+
* Insert one column.
|
|
2197
|
+
*
|
|
2198
|
+
* 列を 1 つ挿入します。
|
|
2199
|
+
*
|
|
2200
|
+
* 插入 1 个列。
|
|
2201
|
+
*/
|
|
729
2202
|
insertColumn(colDef: ColumnDef<T>, position?: Position): void;
|
|
730
|
-
/**
|
|
2203
|
+
/**
|
|
2204
|
+
* 컬럼을 삭제한다(해당 field 참조 수식은 #REF 처리).
|
|
2205
|
+
*
|
|
2206
|
+
* Delete a column (formulas referencing the field become #REF).
|
|
2207
|
+
*
|
|
2208
|
+
* 列を削除します(その field を参照する数式は #REF になります)。
|
|
2209
|
+
*
|
|
2210
|
+
* 删除列(引用该 field 的公式会变成 #REF)。
|
|
2211
|
+
*/
|
|
731
2212
|
deleteColumn(field: string): void;
|
|
732
2213
|
private _reorderColumn;
|
|
733
|
-
/**
|
|
2214
|
+
/**
|
|
2215
|
+
* 컬럼(들)을 숨긴다.
|
|
2216
|
+
*
|
|
2217
|
+
* Hide column(s).
|
|
2218
|
+
*
|
|
2219
|
+
* 列を非表示にします。
|
|
2220
|
+
*
|
|
2221
|
+
* 隐藏列。
|
|
2222
|
+
*/
|
|
734
2223
|
hideColumn(field: string | string[]): void;
|
|
735
|
-
/**
|
|
2224
|
+
/**
|
|
2225
|
+
* 숨긴 컬럼(들)을 다시 표시한다.
|
|
2226
|
+
*
|
|
2227
|
+
* Show hidden column(s).
|
|
2228
|
+
*
|
|
2229
|
+
* 非表示にした列を再び表示します。
|
|
2230
|
+
*
|
|
2231
|
+
* 把隐藏的列重新显示。
|
|
2232
|
+
*/
|
|
736
2233
|
showColumn(field: string | string[]): void;
|
|
737
|
-
/**
|
|
2234
|
+
/**
|
|
2235
|
+
* field 의 보이는 컬럼 인덱스(-1 = 없음).
|
|
2236
|
+
*
|
|
2237
|
+
* Visible column index of the field (-1 when absent).
|
|
2238
|
+
*
|
|
2239
|
+
* field の表示列インデックス(-1 = なし)。
|
|
2240
|
+
*
|
|
2241
|
+
* field 的显示列索引(-1 = 没有)。
|
|
2242
|
+
*/
|
|
738
2243
|
getColumnIndex(field: string): number;
|
|
739
|
-
/**
|
|
2244
|
+
/**
|
|
2245
|
+
* 인덱스 위치의 field 명(없으면 '').
|
|
2246
|
+
*
|
|
2247
|
+
* Field name at the index ('' when absent).
|
|
2248
|
+
*
|
|
2249
|
+
* インデックス位置の field 名(なければ '')。
|
|
2250
|
+
*
|
|
2251
|
+
* 索引位置的 field 名(没有则为 '')。
|
|
2252
|
+
*/
|
|
740
2253
|
getFieldAt(idx: number): string;
|
|
741
|
-
/**
|
|
2254
|
+
/**
|
|
2255
|
+
* 해당 컬럼의 값 배열.
|
|
2256
|
+
*
|
|
2257
|
+
* Values of the column.
|
|
2258
|
+
*
|
|
2259
|
+
* その列の値の配列。
|
|
2260
|
+
*
|
|
2261
|
+
* 该列的值的数组。
|
|
2262
|
+
*/
|
|
742
2263
|
getColValues(field: string, _all?: boolean): any[];
|
|
743
|
-
/**
|
|
2264
|
+
/**
|
|
2265
|
+
* 해당 컬럼의 고유 값 배열.
|
|
2266
|
+
*
|
|
2267
|
+
* Unique values of the column.
|
|
2268
|
+
*
|
|
2269
|
+
* その列の一意な値の配列。
|
|
2270
|
+
*
|
|
2271
|
+
* 该列的唯一值的数组。
|
|
2272
|
+
*/
|
|
744
2273
|
getUniqueValues(field: string, all?: boolean): any[];
|
|
745
|
-
/**
|
|
2274
|
+
/**
|
|
2275
|
+
* @deprecated no-op stub — 컬럼 폭 일괄 설정은 구현돼 있지 않다(본문 없음). 폭은 `ColumnDef.width` 로
|
|
746
2276
|
* 지정하거나 헤더 경계를 드래그해 조절하며, 남는 공간은 그리드가 자동 배분한다.
|
|
747
|
-
*
|
|
748
|
-
*
|
|
2277
|
+
*
|
|
2278
|
+
* no-op stub — bulk width setting is not implemented (empty body). Set widths via `ColumnDef.width`
|
|
2279
|
+
* or by dragging header borders; the grid auto-distributes remaining space.
|
|
2280
|
+
*
|
|
2281
|
+
* no-op スタブ — 列幅の一括設定は実装されていません(本体なし)。幅は `ColumnDef.width` で指定するか、
|
|
2282
|
+
* ヘッダーの境界をドラッグして調整し、余った空間はグリッドが自動的に配分します。
|
|
2283
|
+
*
|
|
2284
|
+
* no-op 桩 — 列宽的批量设置未实现(无主体)。宽度请用 `ColumnDef.width` 指定,或拖拽表头的边界调整,
|
|
2285
|
+
* 剩余空间由表格自动分配。
|
|
2286
|
+
*/
|
|
749
2287
|
setColWidths(_widths: number[]): void;
|
|
750
|
-
/**
|
|
2288
|
+
/**
|
|
2289
|
+
* @deprecated no-op stub — 폭 계산 미구현으로 항상 빈 배열을 돌려준다(본문 없음). 폭 배분은 그리드가 자동 처리한다.
|
|
2290
|
+
*
|
|
2291
|
+
* no-op stub — width calculation is not implemented; always returns [] (empty body). The grid distributes widths automatically.
|
|
2292
|
+
*
|
|
2293
|
+
* no-op スタブ — 幅の計算は未実装のため、常に空配列を返します(本体なし)。幅の配分はグリッドが自動的に処理します。
|
|
2294
|
+
*
|
|
2295
|
+
* no-op 桩 — 宽度计算未实现,因此总是返回空数组(无主体)。宽度的分配由表格自动处理。
|
|
2296
|
+
*/
|
|
751
2297
|
calcColWidths(_fitToGrid?: boolean): number[];
|
|
752
|
-
/**
|
|
2298
|
+
/**
|
|
2299
|
+
* 선택된 행 데이터 목록.
|
|
2300
|
+
*
|
|
2301
|
+
* Selected row data.
|
|
2302
|
+
*
|
|
2303
|
+
* 選択された行データの一覧。
|
|
2304
|
+
*
|
|
2305
|
+
* 选中的行数据的列表。
|
|
2306
|
+
*/
|
|
753
2307
|
getSelections(): T[];
|
|
754
|
-
/**
|
|
2308
|
+
/**
|
|
2309
|
+
* 활성 행 인덱스(-1 = 없음).
|
|
2310
|
+
*
|
|
2311
|
+
* Active row index (-1 when none).
|
|
2312
|
+
*
|
|
2313
|
+
* アクティブ行のインデックス(-1 = なし)。
|
|
2314
|
+
*
|
|
2315
|
+
* 活动行的索引(-1 = 没有)。
|
|
2316
|
+
*/
|
|
755
2317
|
getActiveRow(): number;
|
|
756
|
-
/**
|
|
2318
|
+
/**
|
|
2319
|
+
* 지정 행을 활성/선택한다.
|
|
2320
|
+
*
|
|
2321
|
+
* Activate (select) the given row.
|
|
2322
|
+
*
|
|
2323
|
+
* 指定した行をアクティブ化(選択)します。
|
|
2324
|
+
*
|
|
2325
|
+
* 把指定的行激活(选中)。
|
|
2326
|
+
*/
|
|
757
2327
|
activate(index: number): void;
|
|
758
|
-
/**
|
|
2328
|
+
/**
|
|
2329
|
+
* 선택 해제.
|
|
2330
|
+
*
|
|
2331
|
+
* Clear the selection.
|
|
2332
|
+
*
|
|
2333
|
+
* 選択の解除。
|
|
2334
|
+
*
|
|
2335
|
+
* 解除选择。
|
|
2336
|
+
*/
|
|
759
2337
|
deselect(): void;
|
|
760
|
-
/**
|
|
2338
|
+
/**
|
|
2339
|
+
* 체크된 행 목록({row, rowIndex}).
|
|
2340
|
+
*
|
|
2341
|
+
* Checked rows ({row, rowIndex}).
|
|
2342
|
+
*
|
|
2343
|
+
* チェックされた行の一覧({row, rowIndex})。
|
|
2344
|
+
*
|
|
2345
|
+
* 勾选的行的列表({row, rowIndex})。
|
|
2346
|
+
*/
|
|
761
2347
|
getChecked(): Array<{
|
|
762
2348
|
row: T;
|
|
763
2349
|
rowIndex: number;
|
|
764
2350
|
}>;
|
|
765
|
-
/**
|
|
2351
|
+
/**
|
|
2352
|
+
* 체크된 행 데이터만 배열로.
|
|
2353
|
+
*
|
|
2354
|
+
* Checked row data only.
|
|
2355
|
+
*
|
|
2356
|
+
* チェックされた行データのみを配列で。
|
|
2357
|
+
*
|
|
2358
|
+
* 仅以数组返回勾选的行数据。
|
|
2359
|
+
*/
|
|
766
2360
|
getAllChecked(): T[];
|
|
767
|
-
/**
|
|
2361
|
+
/**
|
|
2362
|
+
* @deprecated no-op stub — id 기반 체크 미구현. 값 기준 체크는 `checkByValue(field, values)` 사용.
|
|
2363
|
+
*
|
|
2364
|
+
* no-op stub — id-based checking not implemented; use `checkByValue(field, values)`.
|
|
2365
|
+
*
|
|
2366
|
+
* no-op スタブ — id ベースのチェックは未実装。値基準のチェックは `checkByValue(field, values)` を使ってください。
|
|
2367
|
+
*
|
|
2368
|
+
* no-op 桩 — 基于 id 的勾选未实现。按值勾选请用 `checkByValue(field, values)`。
|
|
2369
|
+
*/
|
|
768
2370
|
checkById(_ids: string[]): void;
|
|
769
|
-
/**
|
|
2371
|
+
/**
|
|
2372
|
+
* @deprecated no-op stub — id 기반 체크 추가 미구현(위 `checkById()` 참조). `checkByValue` 사용.
|
|
2373
|
+
*
|
|
2374
|
+
* no-op stub — see `checkById()`; use `checkByValue`.
|
|
2375
|
+
*
|
|
2376
|
+
* no-op スタブ — id ベースのチェック追加は未実装(上の `checkById()` を参照)。`checkByValue` を使ってください。
|
|
2377
|
+
*
|
|
2378
|
+
* no-op 桩 — 基于 id 的追加勾选未实现(参见上面的 `checkById()`)。请用 `checkByValue`。
|
|
2379
|
+
*/
|
|
770
2380
|
addCheckById(_ids: string[]): void;
|
|
771
|
-
/**
|
|
2381
|
+
/**
|
|
2382
|
+
* field 값이 values 에 포함되는 행을 체크한다.
|
|
2383
|
+
*
|
|
2384
|
+
* Check rows whose field value is in values.
|
|
2385
|
+
*
|
|
2386
|
+
* field の値が values に含まれる行をチェックします。
|
|
2387
|
+
*
|
|
2388
|
+
* 勾选 field 的值包含在 values 中的行。
|
|
2389
|
+
*/
|
|
772
2390
|
checkByValue(field: string, values: any[]): void;
|
|
773
|
-
/**
|
|
2391
|
+
/**
|
|
2392
|
+
* @deprecated no-op stub — id 기반 체크 해제 미구현. 전체 해제는 `uncheckAll()` 사용.
|
|
2393
|
+
*
|
|
2394
|
+
* no-op stub — id-based unchecking not implemented; use `uncheckAll()`.
|
|
2395
|
+
*
|
|
2396
|
+
* no-op スタブ — id ベースのチェック解除は未実装。全解除は `uncheckAll()` を使ってください。
|
|
2397
|
+
*
|
|
2398
|
+
* no-op 桩 — 基于 id 的取消勾选未实现。全部解除请用 `uncheckAll()`。
|
|
2399
|
+
*/
|
|
774
2400
|
uncheckById(_ids: string[]): void;
|
|
775
|
-
/**
|
|
2401
|
+
/**
|
|
2402
|
+
* 전체 체크 해제.
|
|
2403
|
+
*
|
|
2404
|
+
* Uncheck all rows.
|
|
2405
|
+
*
|
|
2406
|
+
* すべてのチェックを解除。
|
|
2407
|
+
*
|
|
2408
|
+
* 解除所有勾选。
|
|
2409
|
+
*/
|
|
776
2410
|
uncheckAll(): void;
|
|
777
2411
|
/**
|
|
778
2412
|
* 데이터를 정렬한다 — 헤더 클릭 없이 코드로 정렬을 걸 때 쓴다. 한 컬럼만 정렬하려면 field 와 방향을,
|
|
779
2413
|
* 여러 컬럼을 우선순위대로 정렬하려면 SortItem 배열을 넘긴다. 정렬 전후로 `before/after:orderBy` 트리거가
|
|
780
2414
|
* 돌고, 취소 가능한 `before:orderBy` 로 정렬을 막을 수도 있다.
|
|
781
|
-
*
|
|
2415
|
+
*
|
|
2416
|
+
* Sort the data from code without a header click. Pass a field + direction for a single column, or a
|
|
782
2417
|
* SortItem array to sort by several columns in priority order. `before/after:orderBy` triggers run
|
|
783
2418
|
* around it, and a cancelable `before:orderBy` can veto the sort.
|
|
784
2419
|
*
|
|
785
|
-
*
|
|
786
|
-
*
|
|
2420
|
+
* データを並べ替えます — ヘッダーをクリックせず、コードからソートを掛けるときに使います。1 列だけ並べ替えるなら
|
|
2421
|
+
* field と方向を、複数の列を優先順位どおりに並べ替えるなら SortItem の配列を渡します。ソートの前後で
|
|
2422
|
+
* `before/after:orderBy` トリガーが走り、キャンセル可能な `before:orderBy` でソートを止めることもできます。
|
|
2423
|
+
*
|
|
2424
|
+
* 对数据排序 — 不点击表头、而从代码施加排序时使用。只排 1 列就传 field 与方向,
|
|
2425
|
+
* 要按优先顺序排多列则传 SortItem 的数组。排序前后会跑 `before/after:orderBy` 触发器,
|
|
2426
|
+
* 也能用可取消的 `before:orderBy` 阻止排序。
|
|
2427
|
+
*
|
|
2428
|
+
* @param fieldOrList - field 명 또는 정렬 목록
|
|
2429
|
+
*
|
|
2430
|
+
* Field name or sort list
|
|
2431
|
+
*
|
|
2432
|
+
* field 名またはソートの一覧
|
|
2433
|
+
*
|
|
2434
|
+
* field 名或排序的列表
|
|
2435
|
+
*
|
|
2436
|
+
* @param dir - 단일 field 일 때 방향(기본 'asc')
|
|
2437
|
+
*
|
|
2438
|
+
* Direction for single-field form (default 'asc')
|
|
2439
|
+
*
|
|
2440
|
+
* 単一 field のときの方向(既定 'asc')
|
|
2441
|
+
*
|
|
2442
|
+
* 单一 field 时的方向(默认 'asc')
|
|
787
2443
|
*/
|
|
788
2444
|
orderBy(fieldOrList: string | SortItem[], dir?: 'asc' | 'desc'): void;
|
|
789
|
-
/**
|
|
2445
|
+
/**
|
|
2446
|
+
* 정렬을 초기 상태로 되돌린다.
|
|
2447
|
+
*
|
|
2448
|
+
* Reset sorting to the initial state.
|
|
2449
|
+
*
|
|
2450
|
+
* ソートを初期状態に戻します。
|
|
2451
|
+
*
|
|
2452
|
+
* 把排序恢复到初始状态。
|
|
2453
|
+
*/
|
|
790
2454
|
resetOrder(): void;
|
|
791
2455
|
/**
|
|
792
2456
|
* 한 컬럼에 필터 조건을 걸어 조건에 맞는 행만 남긴다 — 필터 UI를 열지 않고 코드로 필터링할 때 쓴다.
|
|
793
2457
|
* 같은 컬럼에 다시 호출하면 그 컬럼 필터가 교체되고, 전체 해제는 `resetFilter()` 를 쓴다. 정렬과 마찬가지로
|
|
794
2458
|
* `before/after:setFilter` 트리거가 함께 돈다.
|
|
795
|
-
*
|
|
2459
|
+
*
|
|
2460
|
+
* Filter a column so only matching rows remain — for filtering from code without opening the filter UI.
|
|
796
2461
|
* Calling it again on the same column replaces that column's filter; clear everything via `resetFilter()`.
|
|
797
2462
|
* Like sorting, `before/after:setFilter` triggers run around it.
|
|
798
2463
|
*
|
|
799
|
-
*
|
|
800
|
-
*
|
|
2464
|
+
* 1 つの列にフィルター条件を掛け、条件に合う行だけを残します — フィルター UI を開かずにコードから絞り込むときに
|
|
2465
|
+
* 使います。同じ列に再度呼び出すとその列のフィルターが差し替わり、全解除は `resetFilter()` を使います。ソートと
|
|
2466
|
+
* 同じく `before/after:setFilter` トリガーが併せて走ります。
|
|
2467
|
+
*
|
|
2468
|
+
* 对 1 个列施加筛选条件,只留下符合条件的行 — 不打开筛选 UI、而从代码筛选时使用。
|
|
2469
|
+
* 对同一列再次调用会替换该列的筛选,全部解除请用 `resetFilter()`。与排序一样,
|
|
2470
|
+
* `before/after:setFilter` 触发器也会一并运行。
|
|
2471
|
+
*
|
|
2472
|
+
* @param field - 대상 컬럼 field
|
|
2473
|
+
*
|
|
2474
|
+
* Target column field
|
|
2475
|
+
*
|
|
2476
|
+
* 対象となる列の field
|
|
2477
|
+
*
|
|
2478
|
+
* 目标列的 field
|
|
2479
|
+
*
|
|
2480
|
+
* @param filterItems - 필터 조건 목록
|
|
2481
|
+
*
|
|
2482
|
+
* Filter conditions
|
|
2483
|
+
*
|
|
2484
|
+
* フィルター条件の一覧
|
|
2485
|
+
*
|
|
2486
|
+
* 筛选条件的列表
|
|
801
2487
|
*/
|
|
802
2488
|
setFilter(field: string, filterItems: FilterItem[]): void;
|
|
803
|
-
/**
|
|
2489
|
+
/**
|
|
2490
|
+
* 필터 해제(field 생략 시 전체).
|
|
2491
|
+
*
|
|
2492
|
+
* Clear filters (all when field omitted).
|
|
2493
|
+
*
|
|
2494
|
+
* フィルターの解除(field を省略すると全体)。
|
|
2495
|
+
*
|
|
2496
|
+
* 解除筛选(省略 field 则为全体)。
|
|
2497
|
+
*/
|
|
804
2498
|
resetFilter(field?: string): void;
|
|
805
|
-
/**
|
|
2499
|
+
/**
|
|
2500
|
+
* F3-R13/MCCONNELL-03(P0): 정렬/필터 후 범위-보유(hasRangeRef) 수식 전부 dirty(§3.5).
|
|
2501
|
+
*
|
|
2502
|
+
* F3-R13/MCCONNELL-03 (P0): after sort/filter, mark every range-bearing (hasRangeRef) formula dirty (§3.5).
|
|
2503
|
+
*
|
|
2504
|
+
* F3-R13/MCCONNELL-03(P0): ソート/フィルター後、範囲を保持する(hasRangeRef)数式をすべて dirty にします(§3.5)。
|
|
2505
|
+
*
|
|
2506
|
+
* F3-R13/MCCONNELL-03(P0): 排序/筛选后,把持有范围的(hasRangeRef)公式全部置为 dirty(§3.5)。
|
|
2507
|
+
*/
|
|
806
2508
|
private _recalcRangeBearingFormulas;
|
|
807
|
-
/**
|
|
2509
|
+
/**
|
|
2510
|
+
* 현재 필터 상태 스냅샷.
|
|
2511
|
+
*
|
|
2512
|
+
* Snapshot of the current filter state.
|
|
2513
|
+
*
|
|
2514
|
+
* 現在のフィルター状態のスナップショット。
|
|
2515
|
+
*
|
|
2516
|
+
* 当前筛选状态的快照。
|
|
2517
|
+
*/
|
|
808
2518
|
getFilterState(): Record<string, FilterItem[]>;
|
|
809
|
-
/**
|
|
2519
|
+
/**
|
|
2520
|
+
* 필터 상태를 복원한다.
|
|
2521
|
+
*
|
|
2522
|
+
* Restore a saved filter state.
|
|
2523
|
+
*
|
|
2524
|
+
* フィルター状態を復元します。
|
|
2525
|
+
*
|
|
2526
|
+
* 恢复筛选状态。
|
|
2527
|
+
*/
|
|
810
2528
|
restoreFilter(state: Record<string, FilterItem[]>): void;
|
|
811
2529
|
private _applyFilters;
|
|
812
|
-
/**
|
|
2530
|
+
/**
|
|
2531
|
+
* 왼쪽 n개 컬럼을 가로 스크롤에도 고정한다. 이름·id 같은 식별 컬럼을 항상 보이게 두고 나머지만 좌우로 훑을 때 쓴다(n=0 이면 고정 해제).
|
|
2532
|
+
*
|
|
2533
|
+
* Freeze the leftmost n columns against horizontal scroll — keep identity columns (name/id) always visible while scrolling the rest (n=0 unfreezes).
|
|
2534
|
+
*
|
|
2535
|
+
* 左から n 列を横スクロールに対しても固定します。名前・id といった識別用の列を常に見えるようにし、残りだけを左右に見ていくときに使います(n=0 なら固定を解除)。
|
|
2536
|
+
*
|
|
2537
|
+
* 把左起 n 列对横向滚动也固定。想让名称、id 这类识别用的列始终可见,只把其余部分左右浏览时使用(n=0 则解除固定)。
|
|
2538
|
+
*/
|
|
813
2539
|
freeze(n: number): void;
|
|
814
|
-
/**
|
|
2540
|
+
/**
|
|
2541
|
+
* 수동 병합: [{row, col, rowSpan?, colSpan?}]
|
|
2542
|
+
*
|
|
2543
|
+
* Manual merge: [{row, col, rowSpan?, colSpan?}]
|
|
2544
|
+
*
|
|
2545
|
+
* 手動結合: [{row, col, rowSpan?, colSpan?}]
|
|
2546
|
+
*
|
|
2547
|
+
* 手动合并: [{row, col, rowSpan?, colSpan?}]
|
|
2548
|
+
*/
|
|
815
2549
|
mergeCells(cells: MergeCell[]): void;
|
|
816
|
-
/**
|
|
2550
|
+
/**
|
|
2551
|
+
* 자동 병합: 지정 필드 컬럼에서 연속 같은 값을 rowSpan으로 묶는다.
|
|
2552
|
+
*
|
|
2553
|
+
* Auto merge: consecutive equal values in the given field columns are merged via rowSpan.
|
|
2554
|
+
*
|
|
2555
|
+
* 自動結合: 指定した field の列で、連続する同じ値を rowSpan でまとめます。
|
|
2556
|
+
*
|
|
2557
|
+
* 自动合并: 在指定 field 的列中,把连续相同的值用 rowSpan 归并。
|
|
2558
|
+
*/
|
|
817
2559
|
autoMerge(fields: string[]): void;
|
|
818
|
-
/**
|
|
2560
|
+
/**
|
|
2561
|
+
* 병합 해제.
|
|
2562
|
+
*
|
|
2563
|
+
* Clear all merges.
|
|
2564
|
+
*
|
|
2565
|
+
* 結合の解除。
|
|
2566
|
+
*
|
|
2567
|
+
* 解除合并。
|
|
2568
|
+
*/
|
|
819
2569
|
clearMerge(): void;
|
|
820
|
-
/**
|
|
2570
|
+
/**
|
|
2571
|
+
* @deprecated no-op stub — 행 고정(freeze rows) 미구현. 컬럼 고정만 지원하며 `freeze(n)` 사용.
|
|
2572
|
+
*
|
|
2573
|
+
* no-op stub — frozen rows are not implemented; only column freezing via `freeze(n)`.
|
|
2574
|
+
*
|
|
2575
|
+
* no-op スタブ — 行の固定(freeze rows)は未実装です。列の固定のみ対応しており、`freeze(n)` を使ってください。
|
|
2576
|
+
*
|
|
2577
|
+
* no-op 桩 — 行的固定(freeze rows)未实现。仅支持列的固定,请用 `freeze(n)`。
|
|
2578
|
+
*/
|
|
821
2579
|
freezeRows(_n: number): void;
|
|
822
|
-
/**
|
|
2580
|
+
/**
|
|
2581
|
+
* 지정한 필드 값이 같은 행끼리 접었다 펼 수 있는 그룹으로 묶는다(다중 필드면 계층 그룹). "부서별 → 팀별"처럼 데이터를 범주로 요약해 보여 줄 때 쓴다. 해제는 `clearGroup()`.
|
|
2582
|
+
*
|
|
2583
|
+
* Group rows sharing the given field values into collapsible groups (multiple fields → nested groups) — for summarizing data by category ("by dept → by team"). Undo with `clearGroup()`.
|
|
2584
|
+
*
|
|
2585
|
+
* 指定した field の値が同じ行どうしを、折りたたみ・展開できるグループにまとめます(複数 field なら階層グループ)。「部署別 → チーム別」のようにデータをカテゴリで要約して見せるときに使います。解除は `clearGroup()`。
|
|
2586
|
+
*
|
|
2587
|
+
* 把指定 field 的值相同的行,归并成可折叠、展开的组(多个 field 则为层级组)。想像「按部门 → 按团队」那样把数据按类别汇总展示时使用。解除用 `clearGroup()`。
|
|
2588
|
+
*/
|
|
823
2589
|
groupBy(fields: string[]): void;
|
|
824
|
-
/**
|
|
2590
|
+
/**
|
|
2591
|
+
* 그룹핑 해제.
|
|
2592
|
+
*
|
|
2593
|
+
* Clear grouping.
|
|
2594
|
+
*
|
|
2595
|
+
* グループ化の解除。
|
|
2596
|
+
*
|
|
2597
|
+
* 解除分组。
|
|
2598
|
+
*/
|
|
825
2599
|
clearGroup(): void;
|
|
826
|
-
/**
|
|
2600
|
+
/**
|
|
2601
|
+
* 모든 그룹 펼침.
|
|
2602
|
+
*
|
|
2603
|
+
* Expand all groups.
|
|
2604
|
+
*
|
|
2605
|
+
* すべてのグループを展開。
|
|
2606
|
+
*
|
|
2607
|
+
* 展开所有的组。
|
|
2608
|
+
*/
|
|
827
2609
|
expandAll(): void;
|
|
828
|
-
/**
|
|
2610
|
+
/**
|
|
2611
|
+
* 모든 그룹 접힘.
|
|
2612
|
+
*
|
|
2613
|
+
* Collapse all groups.
|
|
2614
|
+
*
|
|
2615
|
+
* すべてのグループを折りたたみ。
|
|
2616
|
+
*
|
|
2617
|
+
* 折叠所有的组。
|
|
2618
|
+
*/
|
|
829
2619
|
collapseAll(): void;
|
|
830
|
-
/**
|
|
2620
|
+
/**
|
|
2621
|
+
* 트리 모드 활성화.
|
|
2622
|
+
*
|
|
2623
|
+
* Enable tree mode.
|
|
2624
|
+
*
|
|
2625
|
+
* ツリーモードの有効化。
|
|
2626
|
+
*
|
|
2627
|
+
* 启用树模式。
|
|
2628
|
+
*/
|
|
831
2629
|
enableTree(): void;
|
|
832
|
-
/**
|
|
2630
|
+
/**
|
|
2631
|
+
* 트리 모드 비활성화.
|
|
2632
|
+
*
|
|
2633
|
+
* Disable tree mode.
|
|
2634
|
+
*
|
|
2635
|
+
* ツリーモードの無効化。
|
|
2636
|
+
*
|
|
2637
|
+
* 停用树模式。
|
|
2638
|
+
*/
|
|
833
2639
|
disableTree(): void;
|
|
834
|
-
/**
|
|
2640
|
+
/**
|
|
2641
|
+
* 지정 트리 노드 펼침/접힘.
|
|
2642
|
+
*
|
|
2643
|
+
* Expand/collapse the given tree nodes.
|
|
2644
|
+
*
|
|
2645
|
+
* 指定したツリーノードの展開/折りたたみ。
|
|
2646
|
+
*
|
|
2647
|
+
* 指定的树节点的展开/折叠。
|
|
2648
|
+
*/
|
|
835
2649
|
expandNodes(ids: any | any[], open?: boolean): void;
|
|
836
|
-
/**
|
|
2650
|
+
/**
|
|
2651
|
+
* 모든 트리 노드 펼침.
|
|
2652
|
+
*
|
|
2653
|
+
* Expand all tree nodes.
|
|
2654
|
+
*
|
|
2655
|
+
* すべてのツリーノードを展開。
|
|
2656
|
+
*
|
|
2657
|
+
* 展开所有的树节点。
|
|
2658
|
+
*/
|
|
837
2659
|
expandAllNodes(): void;
|
|
838
|
-
/**
|
|
2660
|
+
/**
|
|
2661
|
+
* 모든 트리 노드 접힘.
|
|
2662
|
+
*
|
|
2663
|
+
* Collapse all tree nodes.
|
|
2664
|
+
*
|
|
2665
|
+
* すべてのツリーノードを折りたたみ。
|
|
2666
|
+
*
|
|
2667
|
+
* 折叠所有的树节点。
|
|
2668
|
+
*/
|
|
839
2669
|
collapseAllNodes(): void;
|
|
840
|
-
/**
|
|
2670
|
+
/**
|
|
2671
|
+
* 행 아래에 상세(마스터/디테일) 패널을 펼쳐 그 행의 하위 정보나 서브그리드를 보여 준다. 목록 행을 눌러 세부를 펼치는 UI를 코드로 여는 API다. rowRef 는 화면 위치(flat index)나 행 id({id})로 지정한다.
|
|
2672
|
+
*
|
|
2673
|
+
* Expand the master/detail panel under a row to reveal its sub-info or a subgrid — the code path for a click-to-expand row UI. Reference the row by on-screen position (flat index) or id ({id}).
|
|
2674
|
+
*
|
|
2675
|
+
* 行の下に詳細(マスター/ディテール)パネルを展開し、その行の下位情報やサブグリッドを見せます。一覧の行を押して詳細を開く UI を、コードから開く API です。rowRef は画面位置(flat index)または行 id({id})で指定します。
|
|
2676
|
+
*
|
|
2677
|
+
* 在行的下方展开明细(主从)面板,展示该行的下级信息或子表格。是把点击列表行以展开详情的 UI 从代码打开的 API。rowRef 用画面位置(flat index)或行 id({id})指定。
|
|
2678
|
+
*/
|
|
841
2679
|
expandRow(rowRef: number | {
|
|
842
2680
|
id: string;
|
|
843
2681
|
}): void;
|
|
844
|
-
/**
|
|
2682
|
+
/**
|
|
2683
|
+
* 행 상세 패널 접힘.
|
|
2684
|
+
*
|
|
2685
|
+
* Collapse the detail panel.
|
|
2686
|
+
*
|
|
2687
|
+
* 行の詳細パネルの折りたたみ。
|
|
2688
|
+
*
|
|
2689
|
+
* 折叠行的明细面板。
|
|
2690
|
+
*/
|
|
845
2691
|
collapseRow(rowRef: number | {
|
|
846
2692
|
id: string;
|
|
847
2693
|
}): void;
|
|
848
|
-
/**
|
|
2694
|
+
/**
|
|
2695
|
+
* 행 상세 패널 토글.
|
|
2696
|
+
*
|
|
2697
|
+
* Toggle the detail panel.
|
|
2698
|
+
*
|
|
2699
|
+
* 行の詳細パネルのトグル。
|
|
2700
|
+
*
|
|
2701
|
+
* 切换行的明细面板。
|
|
2702
|
+
*/
|
|
849
2703
|
toggleRow(rowRef: number | {
|
|
850
2704
|
id: string;
|
|
851
2705
|
}): void;
|
|
852
|
-
/**
|
|
2706
|
+
/**
|
|
2707
|
+
* 행 상세 패널 펼침 여부.
|
|
2708
|
+
*
|
|
2709
|
+
* Whether the detail panel is expanded.
|
|
2710
|
+
*
|
|
2711
|
+
* 行の詳細パネルが展開されているかどうか。
|
|
2712
|
+
*
|
|
2713
|
+
* 行的明细面板是否已展开。
|
|
2714
|
+
*/
|
|
853
2715
|
isRowExpanded(rowRef: number | {
|
|
854
2716
|
id: string;
|
|
855
2717
|
}): boolean;
|
|
856
|
-
/**
|
|
2718
|
+
/**
|
|
2719
|
+
* 모든 상세 패널 접힘.
|
|
2720
|
+
*
|
|
2721
|
+
* Collapse all detail panels.
|
|
2722
|
+
*
|
|
2723
|
+
* すべての詳細パネルの折りたたみ。
|
|
2724
|
+
*
|
|
2725
|
+
* 折叠所有的明细面板。
|
|
2726
|
+
*/
|
|
857
2727
|
collapseAllDetails(): void;
|
|
858
|
-
/**
|
|
2728
|
+
/**
|
|
2729
|
+
* 상세 인스턴스(renderer 반환값 또는 자동 서브그리드; 펼친 적 없으면 undefined).
|
|
2730
|
+
*
|
|
2731
|
+
* Detail instance (renderer result or auto subgrid; undefined if never expanded).
|
|
2732
|
+
*
|
|
2733
|
+
* 詳細インスタンス(renderer の戻り値または自動サブグリッド。一度も展開していなければ undefined)。
|
|
2734
|
+
*
|
|
2735
|
+
* 明细实例(renderer 的返回值或自动子表格。一次都没展开过则为 undefined)。
|
|
2736
|
+
*/
|
|
859
2737
|
getDetailInstance<D = any>(rowRef: number | {
|
|
860
2738
|
id: string;
|
|
861
2739
|
}): D | undefined;
|
|
862
|
-
/**
|
|
2740
|
+
/**
|
|
2741
|
+
* 열려 있는 상세 패널의 폭을 부모 그리드 컬럼 폭에 다시 맞춘다. 컬럼 크기를 바꾼 뒤 상세 패널 정렬이 어긋나 보일 때 수동으로 재동기한다(보통은 자동 처리됨).
|
|
2742
|
+
*
|
|
2743
|
+
* Re-sync open detail panels' widths to the parent column widths. Call it when panel alignment drifts after resizing columns (usually handled automatically).
|
|
2744
|
+
*
|
|
2745
|
+
* 開いている詳細パネルの幅を、親グリッドの列幅に合わせ直します。列のサイズを変えたあとに詳細パネルの位置がずれて見えるとき、手動で同期させます(通常は自動的に処理されます)。
|
|
2746
|
+
*
|
|
2747
|
+
* 把打开着的明细面板的宽度,重新对齐到父表格的列宽。改变列的尺寸后明细面板的对齐看起来错位时,手动同步(通常会自动处理)。
|
|
2748
|
+
*/
|
|
863
2749
|
resyncPanelWidths(): void;
|
|
864
|
-
/**
|
|
2750
|
+
/**
|
|
2751
|
+
* @deprecated no-op stub — 부모 지정 트리행 삽입 미구현. 평면 삽입은 `insertRow(item, pos)`,
|
|
865
2752
|
* 트리 구성은 `enableTree()`/`groupBy(fields)` 사용.
|
|
866
|
-
*
|
|
867
|
-
*
|
|
2753
|
+
*
|
|
2754
|
+
* no-op stub — parented tree-row insertion is not implemented. Use `insertRow(item, pos)`
|
|
2755
|
+
* for flat insertion and `enableTree()`/`groupBy(fields)` for tree structure.
|
|
2756
|
+
*
|
|
2757
|
+
* no-op スタブ — 親を指定したツリー行の挿入は未実装です。平坦な挿入は `insertRow(item, pos)` を、
|
|
2758
|
+
* ツリーの構成は `enableTree()`/`groupBy(fields)` を使ってください。
|
|
2759
|
+
*
|
|
2760
|
+
* no-op 桩 — 指定父节点的树行插入未实现。平坦的插入请用 `insertRow(item, pos)`,
|
|
2761
|
+
* 树的构成请用 `enableTree()`/`groupBy(fields)`。
|
|
2762
|
+
*/
|
|
868
2763
|
addTreeRow(_item: Partial<T>, _pid: string, _pos?: Position): void;
|
|
869
|
-
/**
|
|
2764
|
+
/**
|
|
2765
|
+
* 현재 그리드 내용을 엑셀(xlsx) 파일로 내려받게 한다. 문자열을 넘기면 파일명으로, 옵션 객체로는 컬럼·범위 등을 세밀 지정한다(기본은 보이는 데이터 전부).
|
|
2766
|
+
*
|
|
2767
|
+
* Download the current grid as an Excel (xlsx) file. A string is used as the filename; an options object fine-tunes columns/scope (defaults to all visible data).
|
|
2768
|
+
*
|
|
2769
|
+
* 現在のグリッドの内容を Excel(xlsx)ファイルとしてダウンロードさせます。文字列を渡すとファイル名として、オプションオブジェクトでは列・範囲などを細かく指定します(既定は見えているデータ全部)。
|
|
2770
|
+
*
|
|
2771
|
+
* 把当前表格的内容作为 Excel(xlsx)文件下载。传入字符串则作为文件名,用选项对象可细致指定列、范围等(默认是可见数据的全部)。
|
|
2772
|
+
*/
|
|
870
2773
|
exportExcel(options?: ExportOptions | string): void;
|
|
871
|
-
/**
|
|
2774
|
+
/**
|
|
2775
|
+
* 현재 그리드 내용을 CSV 파일로 내려받게 한다(가벼운 텍스트 교환용). 옵션은 exportExcel 과 동일.
|
|
2776
|
+
*
|
|
2777
|
+
* Download the current grid as a CSV file (lightweight text interchange); same options as exportExcel.
|
|
2778
|
+
*
|
|
2779
|
+
* 現在のグリッドの内容を CSV ファイルとしてダウンロードさせます(軽量なテキスト交換用)。オプションは exportExcel と同じです。
|
|
2780
|
+
*
|
|
2781
|
+
* 把当前表格的内容作为 CSV 文件下载(用于轻量的文本交换)。选项与 exportExcel 相同。
|
|
2782
|
+
*/
|
|
872
2783
|
exportCsv(options?: ExportOptions | string): void;
|
|
873
|
-
/**
|
|
2784
|
+
/**
|
|
2785
|
+
* 현재 그리드 내용을 JSON 파일로 내려받게 한다(원본 객체 구조 보존). 옵션은 exportExcel 과 동일.
|
|
2786
|
+
*
|
|
2787
|
+
* Download the current grid as a JSON file (preserves the object structure); same options as exportExcel.
|
|
2788
|
+
*
|
|
2789
|
+
* 現在のグリッドの内容を JSON ファイルとしてダウンロードさせます(元のオブジェクト構造を保持)。オプションは exportExcel と同じです。
|
|
2790
|
+
*
|
|
2791
|
+
* 把当前表格的内容作为 JSON 文件下载(保留原始的对象结构)。选项与 exportExcel 相同。
|
|
2792
|
+
*/
|
|
874
2793
|
exportJson(options?: ExportOptions | string): void;
|
|
875
|
-
/**
|
|
2794
|
+
/**
|
|
2795
|
+
* 인쇄용 창을 연다.
|
|
2796
|
+
*
|
|
2797
|
+
* Open the print view.
|
|
2798
|
+
*
|
|
2799
|
+
* 印刷用のウィンドウを開きます。
|
|
2800
|
+
*
|
|
2801
|
+
* 打开打印用的窗口。
|
|
2802
|
+
*/
|
|
876
2803
|
print(options?: {
|
|
877
2804
|
title?: string;
|
|
878
2805
|
excludeFields?: string[];
|
|
879
2806
|
}): void;
|
|
880
2807
|
/**
|
|
881
|
-
* 데이터 배열 변환.
|
|
2808
|
+
* 데이터 배열 변환.
|
|
2809
|
+
*
|
|
2810
|
+
* Convert the data set.
|
|
2811
|
+
*
|
|
2812
|
+
* データ配列の変換。
|
|
2813
|
+
*
|
|
2814
|
+
* 数据数组的转换。
|
|
2815
|
+
*
|
|
2816
|
+
* @param keyValue - true = 객체 배열(기본), false = 값 2D 배열
|
|
882
2817
|
*
|
|
883
|
-
*
|
|
2818
|
+
* true = object array (default), false = 2D value array
|
|
2819
|
+
*
|
|
2820
|
+
* true = オブジェクト配列(既定)、false = 値の 2 次元配列
|
|
2821
|
+
*
|
|
2822
|
+
* true = 对象数组(默认),false = 值的二维数组
|
|
884
2823
|
*/
|
|
885
2824
|
toArray(keyValue?: boolean): any[];
|
|
886
2825
|
/**
|
|
887
2826
|
* 사용자가 검색 결과나 차트 클릭으로 특정 행을 가리켰을 때, 그 행이 화면에 보이도록 스크롤하고 선택 표시까지
|
|
888
2827
|
* 해 준다. 큰 데이터에서 "어디였더라"를 없애는 이동 도우미다.
|
|
889
|
-
*
|
|
2828
|
+
*
|
|
2829
|
+
* When a search result or chart click points at a specific row, scroll it into view and select it.
|
|
890
2830
|
* A navigation helper that removes the "where was it again?" problem in large data.
|
|
891
2831
|
*
|
|
892
|
-
*
|
|
2832
|
+
* ユーザーが検索結果やチャートのクリックで特定の行を指し示したとき、その行が画面に見えるようスクロールし、選択表示
|
|
2833
|
+
* までを行います。大きなデータで「どこだったか」をなくす移動のヘルパーです。
|
|
2834
|
+
*
|
|
2835
|
+
* 当用户通过搜索结果或点击图表指向特定的行时,滚动到该行在画面上可见的位置,并做出选中标示。
|
|
2836
|
+
* 是在大数据中消除「刚才在哪来着」的移动辅助函数。
|
|
2837
|
+
*
|
|
2838
|
+
* @param rowIndex - 이동할 행의 위치(flat index)
|
|
2839
|
+
*
|
|
2840
|
+
* Position (flat index) of the row to jump to
|
|
2841
|
+
*
|
|
2842
|
+
* 移動先の行の位置(flat index)
|
|
2843
|
+
*
|
|
2844
|
+
* 要移动到的行的位置(flat index)
|
|
893
2845
|
*/
|
|
894
2846
|
jumpToRow(rowIndex: number): void;
|
|
895
|
-
/**
|
|
2847
|
+
/**
|
|
2848
|
+
* @deprecated no-op stub — 특정 컬럼으로 가로 스크롤 이동 미구현. 행 이동은 `jumpToRow(rowIndex)` 사용.
|
|
2849
|
+
*
|
|
2850
|
+
* no-op stub — horizontal jump-to-column is not implemented; use `jumpToRow(rowIndex)`.
|
|
2851
|
+
*
|
|
2852
|
+
* no-op スタブ — 特定の列への横スクロール移動は未実装です。行の移動は `jumpToRow(rowIndex)` を使ってください。
|
|
2853
|
+
*
|
|
2854
|
+
* no-op 桩 — 向特定列的横向滚动移动未实现。行的移动请用 `jumpToRow(rowIndex)`。
|
|
2855
|
+
*/
|
|
896
2856
|
jumpToCol(_field: string): void;
|
|
897
|
-
/**
|
|
2857
|
+
/**
|
|
2858
|
+
* 현재 스크롤 좌표.
|
|
2859
|
+
*
|
|
2860
|
+
* Current scroll position.
|
|
2861
|
+
*
|
|
2862
|
+
* 現在のスクロール座標。
|
|
2863
|
+
*
|
|
2864
|
+
* 当前的滚动坐标。
|
|
2865
|
+
*/
|
|
898
2866
|
getScrollPos(): {
|
|
899
2867
|
x: number;
|
|
900
2868
|
y: number;
|
|
901
2869
|
};
|
|
902
|
-
/**
|
|
2870
|
+
/**
|
|
2871
|
+
* 푸터 정의를 교체하고 다시 그린다.
|
|
2872
|
+
*
|
|
2873
|
+
* Replace footer definitions and re-render the footer.
|
|
2874
|
+
*
|
|
2875
|
+
* フッター定義を差し替えて描画し直します。
|
|
2876
|
+
*
|
|
2877
|
+
* 替换页脚定义并重新绘制。
|
|
2878
|
+
*/
|
|
903
2879
|
setFooter(fd: any[]): void;
|
|
904
|
-
/**
|
|
2880
|
+
/**
|
|
2881
|
+
* 푸터 집계값 목록.
|
|
2882
|
+
*
|
|
2883
|
+
* Computed footer values.
|
|
2884
|
+
*
|
|
2885
|
+
* フッターの集計値の一覧。
|
|
2886
|
+
*
|
|
2887
|
+
* 页脚的汇总值的列表。
|
|
2888
|
+
*/
|
|
905
2889
|
getFooterData(): any[];
|
|
906
|
-
/**
|
|
2890
|
+
/**
|
|
2891
|
+
* 특정 field 의 푸터 집계값(없으면 null).
|
|
2892
|
+
*
|
|
2893
|
+
* Footer value of the field (null when absent).
|
|
2894
|
+
*
|
|
2895
|
+
* 特定の field のフッター集計値(なければ null)。
|
|
2896
|
+
*
|
|
2897
|
+
* 特定 field 的页脚汇总值(没有则为 null)。
|
|
2898
|
+
*/
|
|
907
2899
|
getFooterValue(field: string): any;
|
|
908
2900
|
private _renderFooterEl;
|
|
909
|
-
/**
|
|
2901
|
+
/**
|
|
2902
|
+
* 그리드 크기를 변경하고 재배치한다.
|
|
2903
|
+
*
|
|
2904
|
+
* Resize the grid and relayout.
|
|
2905
|
+
*
|
|
2906
|
+
* グリッドのサイズを変更して再配置します。
|
|
2907
|
+
*
|
|
2908
|
+
* 变更表格的尺寸并重新布局。
|
|
2909
|
+
*/
|
|
910
2910
|
resize(w?: number, h?: number): void;
|
|
911
|
-
/**
|
|
2911
|
+
/**
|
|
2912
|
+
* 색 테마(data-og-theme)를 전환한다.
|
|
2913
|
+
*
|
|
2914
|
+
* Switch the color theme (data-og-theme).
|
|
2915
|
+
*
|
|
2916
|
+
* カラーテーマ(data-og-theme)を切り替えます。
|
|
2917
|
+
*
|
|
2918
|
+
* 切换颜色主题(data-og-theme)。
|
|
2919
|
+
*/
|
|
912
2920
|
setTheme(theme: string): void;
|
|
913
|
-
/**
|
|
2921
|
+
/**
|
|
2922
|
+
* 색 축 CSS 변수 1개를 런타임 설정한다.
|
|
2923
|
+
*
|
|
2924
|
+
* Set one color-axis CSS variable at runtime.
|
|
2925
|
+
*
|
|
2926
|
+
* 色軸の CSS 変数を 1 つ、ランタイムで設定します。
|
|
2927
|
+
*
|
|
2928
|
+
* 在运行时设置 1 个颜色轴的 CSS 变量。
|
|
2929
|
+
*/
|
|
914
2930
|
setThemeVar(k: string, v: string): void;
|
|
915
2931
|
/**
|
|
916
2932
|
* 이 그리드의 스킨(형태 축)을 런타임에 바꾼다 — `defineSkin` 으로 등록해 둔 스킨 id 를 골라 적용한다.
|
|
917
2933
|
* 색 테마와는 완전히 별개라 색은 하나도 건드리지 않고 모서리·외곽선 같은 "생김새"만 바뀐다. 전환하면
|
|
918
2934
|
* 형태 토큰을 다시 해석해야 하므로 헤더와 본문을 한 번 다시 그린다(스킨을 쓸 때만 드는 비용).
|
|
919
|
-
*
|
|
2935
|
+
*
|
|
2936
|
+
* Switch this grid's skin (the form axis) at runtime — pick a skin id registered via `defineSkin`.
|
|
920
2937
|
* Fully separate from color themes, so no color changes; only the "look" (radius, border, …) changes.
|
|
921
2938
|
* Switching re-resolves form tokens, so the header and body are re-rendered once (a cost paid only when
|
|
922
2939
|
* you use skins).
|
|
923
2940
|
*
|
|
924
|
-
*
|
|
2941
|
+
* このグリッドのスキン(形状軸)をランタイムで変えます — `defineSkin` で登録しておいたスキン id を選んで適用します。
|
|
2942
|
+
* カラーテーマとは完全に別なので、色にはいっさい触れず、角丸・輪郭線といった「見た目」だけが変わります。切り替えると
|
|
2943
|
+
* 形状トークンを解決し直す必要があるため、ヘッダーと本文を 1 回描画し直します(スキンを使うときだけ掛かるコスト)。
|
|
2944
|
+
*
|
|
2945
|
+
* 在运行时改变这个表格的皮肤(形状轴)— 挑选用 `defineSkin` 注册好的皮肤 id 应用。
|
|
2946
|
+
* 与颜色主题完全无关,因此完全不碰颜色,只改变圆角、轮廓线这类「外观」。切换时需要重新解析
|
|
2947
|
+
* 形状 token,因此把表头与主体重新绘制 1 次(只有使用皮肤时才付出的成本)。
|
|
2948
|
+
*
|
|
2949
|
+
* @param skin - 적용할 스킨 id('default' = 기본 형태)
|
|
2950
|
+
*
|
|
2951
|
+
* Skin id to apply ('default' = stock form)
|
|
2952
|
+
*
|
|
2953
|
+
* 適用するスキン id('default' = 標準の形状)
|
|
2954
|
+
*
|
|
2955
|
+
* 要应用的皮肤 id('default' = 默认形状)
|
|
925
2956
|
*/
|
|
926
2957
|
setSkin(skin: string): void;
|
|
927
|
-
/**
|
|
2958
|
+
/**
|
|
2959
|
+
* 지금 적용된 스킨 id 를 돌려준다('default' = 기본 형태). 어떤 스킨이 걸려 있는지 확인하거나 토글할 때 쓴다.
|
|
2960
|
+
*
|
|
2961
|
+
* Return the currently applied skin id ('default' = stock form) — to check or toggle which skin is active.
|
|
2962
|
+
*
|
|
2963
|
+
* いま適用されているスキン id を返します('default' = 標準の形状)。どのスキンが掛かっているかを確認したり、トグルしたりするときに使います。
|
|
2964
|
+
*
|
|
2965
|
+
* 返回当前已应用的皮肤 id('default' = 默认形状)。用于确认挂着哪个皮肤,或做切换。
|
|
2966
|
+
*/
|
|
928
2967
|
getSkin(): string;
|
|
929
2968
|
/**
|
|
930
2969
|
* 이 그리드 인스턴스에서만 특정 아이콘 role(정렬 화살표·삭제 아이콘 등) 하나를 다른 아이콘으로 바꾼다.
|
|
931
2970
|
* 전역 `defineIconSet` 과 달리 다른 그리드에는 영향을 주지 않는다(인스턴스별 격리) — 한 화면에서만 아이콘을
|
|
932
2971
|
* 커스터마이즈하고 싶을 때 쓴다. svgOrKey 는 알려진 아이콘 key 이거나 원시 SVG 본문이며, 없는 role/글리프를
|
|
933
2972
|
* 넘겨도 안전하게 폴백한다(throw 하지 않음). 체이닝용 this 를 돌려준다.
|
|
934
|
-
*
|
|
2973
|
+
*
|
|
2974
|
+
* Replace a single icon role (sort arrow, delete icon, …) for this grid instance only. Unlike the
|
|
935
2975
|
* global `defineIconSet`, it does not affect other grids (per-instance isolation) — use it to customize
|
|
936
2976
|
* icons on one screen. svgOrKey is a known icon key or raw SVG body; unknown roles/glyphs fall back
|
|
937
2977
|
* safely (never throws). Returns this for chaining.
|
|
938
2978
|
*
|
|
939
|
-
*
|
|
940
|
-
*
|
|
941
|
-
*
|
|
2979
|
+
* このグリッドインスタンスでのみ、特定のアイコン role(ソート矢印・削除アイコンなど)を 1 つ別のアイコンに差し替え
|
|
2980
|
+
* ます。グローバルな `defineIconSet` と違い、ほかのグリッドには影響しません(インスタンスごとの分離) — 1 つの画面
|
|
2981
|
+
* だけでアイコンをカスタマイズしたいときに使います。svgOrKey は既知のアイコン key、または生の SVG 本体で、存在しない
|
|
2982
|
+
* role/グリフを渡しても安全にフォールバックします(throw しません)。チェーン用に this を返します。
|
|
2983
|
+
*
|
|
2984
|
+
* 只在这个表格实例上,把特定的图标 role(排序箭头、删除图标等)换成别的图标。
|
|
2985
|
+
* 与全局的 `defineIconSet` 不同,不会影响其他表格(按实例隔离)— 想只在一个画面上自定义图标时使用。
|
|
2986
|
+
* svgOrKey 是已知的图标 key,或原始 SVG 主体;传入不存在的 role/字形也会安全回退(不会 throw)。
|
|
2987
|
+
* 返回用于链式调用的 this。
|
|
2988
|
+
*
|
|
2989
|
+
* @param role - 시맨틱 아이콘 role
|
|
2990
|
+
*
|
|
2991
|
+
* Semantic icon role
|
|
2992
|
+
*
|
|
2993
|
+
* セマンティックなアイコン role
|
|
2994
|
+
*
|
|
2995
|
+
* 语义图标 role
|
|
2996
|
+
*
|
|
2997
|
+
* @param svgOrKey - 아이콘 key 또는 원시 SVG
|
|
2998
|
+
*
|
|
2999
|
+
* Icon key or raw SVG
|
|
3000
|
+
*
|
|
3001
|
+
* アイコン key または生の SVG
|
|
3002
|
+
*
|
|
3003
|
+
* 图标 key 或原始 SVG
|
|
3004
|
+
*
|
|
3005
|
+
* @returns 체이닝용 this
|
|
3006
|
+
*
|
|
3007
|
+
* this for chaining
|
|
3008
|
+
*
|
|
3009
|
+
* チェーン用の this
|
|
3010
|
+
*
|
|
3011
|
+
* 用于链式调用的 this
|
|
942
3012
|
*/
|
|
943
3013
|
setIcon(role: string, svgOrKey: string): this;
|
|
944
|
-
/**
|
|
3014
|
+
/**
|
|
3015
|
+
* 아이콘 role 을 실제 렌더용 마크업(또는 SVGElement)으로 해석한다. 인스턴스 오버라이드(setIcon)가 있으면 그것을, 없으면 전역 아이콘을 쓴다. 커스텀 셀·버튼에 그리드와 같은 아이콘을 직접 그려 넣을 때 쓴다.
|
|
3016
|
+
*
|
|
3017
|
+
* Resolve an icon role to render markup (or an SVGElement), using this instance's override (setIcon) first, then the global icon — for drawing grid-consistent icons into custom cells/buttons.
|
|
3018
|
+
*
|
|
3019
|
+
* アイコン role を実際のレンダリング用マークアップ(または SVGElement)へ解決します。インスタンスのオーバーライド(setIcon)があればそれを、なければグローバルのアイコンを使います。カスタムセルやボタンに、グリッドと同じアイコンを自分で描き込むときに使います。
|
|
3020
|
+
*
|
|
3021
|
+
* 把图标 role 解析为实际渲染用的标记(或 SVGElement)。有实例的覆盖(setIcon)就用它,没有则用全局的图标。想在自定义单元格或按钮上亲手画入与表格相同的图标时使用。
|
|
3022
|
+
*/
|
|
945
3023
|
renderIcon(role: string, opts?: {
|
|
946
3024
|
size?: number;
|
|
947
3025
|
title?: string;
|
|
@@ -952,50 +3030,154 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
952
3030
|
* `lang` 속성을 로케일 Intl 태그로 갱신(스크린리더 발음 전환), 상주 크롬(페이지네이션/찾기)의
|
|
953
3031
|
* 라벨을 새로 그리고, 캐시된 필터 패널을 무효화한 뒤 헤더+가시창을 1회 재렌더한다.
|
|
954
3032
|
* 미등록 로케일은 throw 하지 않고 폴백 유지(never-throw). 전환 후 `localeChange` 이벤트 발화.
|
|
955
|
-
*
|
|
3033
|
+
*
|
|
3034
|
+
* i18n: switch this instance's UI locale. setSkin camp — data-immutable + partial chrome/viewport
|
|
956
3035
|
* re-render. Updates `lang` to the locale's Intl tag (screen-reader pronunciation), refreshes
|
|
957
3036
|
* resident chrome labels (pagination/find), invalidates the cached filter panel, then re-renders
|
|
958
3037
|
* the header + visible window once. Unknown locales never throw. Emits `localeChange` afterwards.
|
|
959
3038
|
*
|
|
960
|
-
*
|
|
3039
|
+
* i18n: このインスタンスの UI ロケールを切り替えます。setSkin の陣営 — データは不変 + クロム/可視領域の部分再
|
|
3040
|
+
* レンダーです。`lang` 属性をロケールの Intl タグに更新し(スクリーンリーダーの発音を切り替え)、常駐クロム
|
|
3041
|
+
* (ページネーション/検索)のラベルを描き直し、キャッシュされたフィルターパネルを無効化したうえで、ヘッダー+可視
|
|
3042
|
+
* 領域を 1 回再レンダーします。未登録のロケールは throw せずフォールバックを維持します(never-throw)。切り替え後に
|
|
3043
|
+
* `localeChange` イベントを発火します。
|
|
3044
|
+
*
|
|
3045
|
+
* i18n: 切换这个实例的 UI 区域设置。属于 setSkin 阵营 — 数据不变 + 外壳/可视区的部分重新渲染。
|
|
3046
|
+
* 把 `lang` 属性更新为区域设置的 Intl 标签(切换屏幕阅读器的发音),重绘常驻外壳
|
|
3047
|
+
* (分页/查找)的标签,使缓存的筛选面板失效,然后把表头 + 可视区重新渲染 1 次。
|
|
3048
|
+
* 未注册的区域设置不会 throw,而是保持回退(never-throw)。切换后触发 `localeChange` 事件。
|
|
3049
|
+
*
|
|
3050
|
+
* @param locale - 로케일 id(예 'en')
|
|
3051
|
+
*
|
|
3052
|
+
* Locale id (e.g. 'en')
|
|
3053
|
+
*
|
|
3054
|
+
* ロケール id(例 'en')
|
|
3055
|
+
*
|
|
3056
|
+
* 区域设置 id(例 'en')
|
|
3057
|
+
*
|
|
961
3058
|
* @example
|
|
962
3059
|
* grid.setLocale('en');
|
|
963
3060
|
*/
|
|
964
3061
|
setLocale(locale: string): void;
|
|
965
|
-
/**
|
|
3062
|
+
/**
|
|
3063
|
+
* i18n: 현재 인스턴스 로케일 id('ko' = 기본).
|
|
3064
|
+
*
|
|
3065
|
+
* i18n: current instance locale id ('ko' = default).
|
|
3066
|
+
*
|
|
3067
|
+
* i18n: 現在のインスタンスのロケール id('ko' = 既定)。
|
|
3068
|
+
*
|
|
3069
|
+
* i18n: 当前实例的区域设置 id('ko' = 默认)。
|
|
3070
|
+
*/
|
|
966
3071
|
getLocale(): string;
|
|
967
3072
|
/**
|
|
968
3073
|
* i18n: 이 인스턴스만 단일 메시지를 오버라이드(setIcon 동형 — 첫 호출 때 child 지연 생성, 멀티그리드 격리).
|
|
969
|
-
* 자동 재렌더는 하지 않는다(다음 렌더/setLocale 때 반영).
|
|
970
|
-
*
|
|
971
|
-
*
|
|
3074
|
+
* 자동 재렌더는 하지 않는다(다음 렌더/setLocale 때 반영).
|
|
3075
|
+
*
|
|
3076
|
+
* i18n: override a single message for this instance only (isomorphic to setIcon — lazy child on first
|
|
3077
|
+
* call, multi-grid isolation). No auto re-render (applied on the next render/setLocale).
|
|
3078
|
+
*
|
|
3079
|
+
* i18n: このインスタンスだけで単一のメッセージをオーバーライドします(setIcon と同型 — 初回呼び出し時に child を
|
|
3080
|
+
* 遅延生成、マルチグリッドで分離)。自動の再レンダーは行いません(次のレンダー/setLocale 時に反映)。
|
|
3081
|
+
*
|
|
3082
|
+
* i18n: 只在这个实例上覆盖单条消息(与 setIcon 同型 — 首次调用时延迟生成 child,多表格隔离)。
|
|
3083
|
+
* 不做自动的重新渲染(在下一次渲染/setLocale 时反映)。
|
|
3084
|
+
*
|
|
3085
|
+
* @param key - dot-key 메시지 키(예 'filter.apply')
|
|
3086
|
+
*
|
|
3087
|
+
* dot-key message key (e.g. 'filter.apply')
|
|
3088
|
+
*
|
|
3089
|
+
* dot-key 形式のメッセージキー(例 'filter.apply')
|
|
3090
|
+
*
|
|
3091
|
+
* dot-key 形式的消息键(例 'filter.apply')
|
|
3092
|
+
*
|
|
3093
|
+
* @param value - 문자열('{name}' 보간) 또는 함수
|
|
3094
|
+
*
|
|
3095
|
+
* string ('{name}' interpolation) or a function
|
|
3096
|
+
*
|
|
3097
|
+
* 文字列('{name}' の補間)または関数
|
|
3098
|
+
*
|
|
3099
|
+
* 字符串('{name}' 插值)或函数
|
|
3100
|
+
*
|
|
3101
|
+
* @returns 체이닝용 this
|
|
3102
|
+
*
|
|
3103
|
+
* this for chaining
|
|
3104
|
+
*
|
|
3105
|
+
* チェーン用の this
|
|
972
3106
|
*
|
|
973
|
-
*
|
|
974
|
-
* @param value - 문자열('{name}' 보간) 또는 함수 / string ('{name}' interpolation) or a function
|
|
975
|
-
* @returns 체이닝용 this / this for chaining
|
|
3107
|
+
* 用于链式调用的 this
|
|
976
3108
|
*/
|
|
977
3109
|
setMessage(key: LocaleMessageKey | string, value: MessageValue): this;
|
|
978
3110
|
/**
|
|
979
3111
|
* i18n: 메시지를 해석한다(인스턴스 오버라이드 우선 → 활성 로케일 → ko → 키 원문). throw 하지 않음 —
|
|
980
|
-
* 렌더 루프(셀 aria) 소비자용.
|
|
981
|
-
* the key itself). Never throws — for render-loop consumers (cell aria).
|
|
3112
|
+
* 렌더 루프(셀 aria) 소비자용.
|
|
982
3113
|
*
|
|
983
|
-
*
|
|
984
|
-
*
|
|
985
|
-
*
|
|
3114
|
+
* i18n: resolve a message (instance override → active locale → ko → the key itself). Never throws —
|
|
3115
|
+
* for render-loop consumers (cell aria).
|
|
3116
|
+
*
|
|
3117
|
+
* i18n: メッセージを解決します(インスタンスのオーバーライド優先 → 有効なロケール → ko → キーの原文)。throw しま
|
|
3118
|
+
* せん — レンダーループ(セルの aria)の利用者向けです。
|
|
3119
|
+
*
|
|
3120
|
+
* i18n: 解析消息(实例的覆盖优先 → 有效的区域设置 → ko → 键的原文)。不会 throw —
|
|
3121
|
+
* 面向渲染循环(单元格的 aria)的使用者。
|
|
3122
|
+
*
|
|
3123
|
+
* @param key - dot-key 메시지 키
|
|
3124
|
+
*
|
|
3125
|
+
* dot-key message key
|
|
3126
|
+
*
|
|
3127
|
+
* dot-key 形式のメッセージキー
|
|
3128
|
+
*
|
|
3129
|
+
* dot-key 形式的消息键
|
|
3130
|
+
*
|
|
3131
|
+
* @param params - `{name}` 보간 파라미터
|
|
3132
|
+
*
|
|
3133
|
+
* `{name}` interpolation params
|
|
3134
|
+
*
|
|
3135
|
+
* `{name}` の補間パラメータ
|
|
3136
|
+
*
|
|
3137
|
+
* `{name}` 的插值参数
|
|
3138
|
+
*
|
|
3139
|
+
* @returns 해석된 문자열(미등록 키면 키 원문)
|
|
3140
|
+
*
|
|
3141
|
+
* Resolved string (the key itself when unknown)
|
|
3142
|
+
*
|
|
3143
|
+
* 解決された文字列(未登録のキーならキーの原文)
|
|
3144
|
+
*
|
|
3145
|
+
* 解析后的字符串(未注册的键则为键的原文)
|
|
986
3146
|
*/
|
|
987
3147
|
t(key: LocaleMessageKey | string, params?: Record<string, string | number>): string;
|
|
988
3148
|
/**
|
|
989
3149
|
* 형태(FORM 축) CSS 변수 하나를 런타임에 덮어쓴다 — 색 변수를 바꾸는 `setThemeVar` 의 형태 축 짝이다.
|
|
990
3150
|
* 스킨 하나를 통째로 만들 필요 없이 모서리 반경 하나만 살짝 조정하고 싶을 때 쓴다. 값은 컨테이너 인라인
|
|
991
3151
|
* 스타일로 들어가 스타일시트를 항상 이긴다. 색·형태를 섞지 않도록 색 값을 넣으면 **throw** 한다.
|
|
992
|
-
*
|
|
3152
|
+
*
|
|
3153
|
+
* Override a single form-axis CSS variable at runtime — the form-axis sibling of `setThemeVar`
|
|
993
3154
|
* (which changes color variables). Use it to nudge one token (e.g. a radius) without defining a whole
|
|
994
3155
|
* skin. The value goes in as container-inline style, so it always beats stylesheets. To keep color and
|
|
995
3156
|
* form separate, passing a color value **throws**.
|
|
996
3157
|
*
|
|
997
|
-
*
|
|
998
|
-
*
|
|
3158
|
+
* 形状(FORM 軸)の CSS 変数を 1 つ、ランタイムで上書きします — 色の変数を変える `setThemeVar` の、形状軸における
|
|
3159
|
+
* 対です。スキンを 1 つまるごと作らなくても、角丸の半径だけを少し調整したいときに使います。値はコンテナのインライン
|
|
3160
|
+
* スタイルとして入るため、常にスタイルシートに勝ちます。色と形状を混ぜないよう、色の値を入れると **throw** します。
|
|
3161
|
+
*
|
|
3162
|
+
* 在运行时覆盖 1 个形状(FORM 轴)的 CSS 变量 — 是改变颜色变量的 `setThemeVar` 在形状轴上的
|
|
3163
|
+
* 对应物。无需整个做出一个皮肤,只想稍微调整圆角半径时使用。值以容器的内联样式进入,
|
|
3164
|
+
* 因此总能胜过样式表。为了不把颜色与形状混在一起,放入颜色值会 **throw**。
|
|
3165
|
+
*
|
|
3166
|
+
* @param k - CSS 변수 이름(예 '--og-radius-md')
|
|
3167
|
+
*
|
|
3168
|
+
* CSS variable name (e.g. '--og-radius-md')
|
|
3169
|
+
*
|
|
3170
|
+
* CSS 変数名(例 '--og-radius-md')
|
|
3171
|
+
*
|
|
3172
|
+
* CSS 变量名(例 '--og-radius-md')
|
|
3173
|
+
*
|
|
3174
|
+
* @param v - 형태 값(색값 넣으면 throw)
|
|
3175
|
+
*
|
|
3176
|
+
* Form value (throws on a color value)
|
|
3177
|
+
*
|
|
3178
|
+
* 形状の値(色値を入れると throw)
|
|
3179
|
+
*
|
|
3180
|
+
* 形状的值(放入颜色值则 throw)
|
|
999
3181
|
*/
|
|
1000
3182
|
setSkinVar(k: string, v: string): void;
|
|
1001
3183
|
/**
|
|
@@ -1003,46 +3185,126 @@ export declare class OpenGrid<T extends Record<string, any> = any> extends Event
|
|
|
1003
3185
|
* ('comfortable') 보여 줄 때 쓴다. 행 높이·안쪽 여백 토큰만 조정하는 순수 가산적 변경이라 색·형태·질감은
|
|
1004
3186
|
* 전혀 건드리지 않는다. 밀도는 행 높이를 바꾸므로 좌표를 다시 계산해야 할 때 창 크기 변경과 똑같은 경로로
|
|
1005
3187
|
* 재배치한다. 없는 이름을 넘겨도 안전하게 기본값으로 되돌아간다(throw 안 함).
|
|
1006
|
-
*
|
|
3188
|
+
*
|
|
3189
|
+
* Change how tightly rows are packed (density) — show the same data more compactly ('compact') or with
|
|
1007
3190
|
* more breathing room ('comfortable'). It adjusts only row-height/padding tokens (purely additive), never
|
|
1008
3191
|
* touching color/form/texture. Because density changes row height, it relayouts via the same path as a
|
|
1009
3192
|
* window resize when needed. An unknown name safely falls back to the default (never throws).
|
|
1010
3193
|
*
|
|
1011
|
-
*
|
|
3194
|
+
* 行間の詰まり具合(密度)を変えます — 同じデータを画面によりぎっしり('compact')、またはゆったり('comfortable')
|
|
3195
|
+
* 見せるときに使います。行の高さ・内側の余白のトークンだけを調整する純粋に加算的な変更なので、色・形状・質感には
|
|
3196
|
+
* いっさい触れません。密度は行の高さを変えるため、座標を計算し直す必要があるときはウィンドウのサイズ変更と同じ経路で
|
|
3197
|
+
* 再配置します。存在しない名前を渡しても安全に既定値へ戻ります(throw しません)。
|
|
3198
|
+
*
|
|
3199
|
+
* 改变行间的紧密程度(密度)— 想把同样的数据在画面上显示得更密('compact')或更宽松('comfortable')
|
|
3200
|
+
* 时使用。它只调整行高、内侧留白的 token,是纯粹加算式的变更,完全不碰颜色、形状、质感。
|
|
3201
|
+
* 因为密度会改变行高,需要重新计算坐标时,以与窗口尺寸变更相同的路径重新布局。
|
|
3202
|
+
* 传入不存在的名称也会安全地回到默认值(不会 throw)。
|
|
3203
|
+
*
|
|
3204
|
+
* @param name - 밀도 값 id(예 'compact', 'comfortable')
|
|
3205
|
+
*
|
|
3206
|
+
* Density value id (e.g. 'compact')
|
|
3207
|
+
*
|
|
3208
|
+
* 密度の値 id(例 'compact'、'comfortable')
|
|
3209
|
+
*
|
|
3210
|
+
* 密度的值 id(例 'compact'、'comfortable')
|
|
1012
3211
|
*/
|
|
1013
3212
|
setDensity(name: string): void;
|
|
1014
3213
|
/**
|
|
1015
3214
|
* 배경 질감을 바꾼다 — 밋밋한 배경 대신 리넨('linen')·종이결('paper-grain')·모눈('graph') 같은 결을 깔고
|
|
1016
3215
|
* 싶을 때 쓴다. 배경 페인트만 바꾸는 순수 가산적 변경이라 행 위치는 그대로다(재배치 없음). 색·형태·밀도 축과
|
|
1017
3216
|
* 따로 논다. 없는 이름을 넘겨도 안전하게 기본(질감 없음)으로 되돌아간다(throw 안 함).
|
|
1018
|
-
*
|
|
3217
|
+
*
|
|
3218
|
+
* Change the background texture — lay a grain like linen ('linen'), paper ('paper-grain'), or a grid
|
|
1019
3219
|
* ('graph') over the plain background. It only repaints the background (purely additive), so row positions
|
|
1020
3220
|
* stay put (no relayout). Independent of the color/form/density axes. An unknown name safely falls back to
|
|
1021
3221
|
* none (never throws).
|
|
1022
3222
|
*
|
|
1023
|
-
*
|
|
3223
|
+
* 背景の質感を変えます — のっぺりした背景の代わりに、リネン('linen')・紙目('paper-grain')・方眼('graph')といった
|
|
3224
|
+
* 風合いを敷きたいときに使います。背景のペイントだけを変える純粋に加算的な変更なので、行の位置はそのままです
|
|
3225
|
+
* (再配置なし)。色・形状・密度の各軸とは独立しています。存在しない名前を渡しても安全に既定(質感なし)へ戻ります
|
|
3226
|
+
* (throw しません)。
|
|
3227
|
+
*
|
|
3228
|
+
* 改变背景的质感 — 想在平淡的背景上铺一层亚麻('linen')、纸纹('paper-grain')、方格('graph')这类
|
|
3229
|
+
* 纹理时使用。它只改变背景的绘制,是纯粹加算式的变更,因此行的位置保持不变(无需重新布局)。
|
|
3230
|
+
* 与颜色、形状、密度各轴互不相干。传入不存在的名称也会安全地回到默认(无质感)(不会 throw)。
|
|
3231
|
+
*
|
|
3232
|
+
* @param name - 질감 값 id(예 'linen', 'paper-grain', 'graph')
|
|
3233
|
+
*
|
|
3234
|
+
* Texture value id (e.g. 'linen')
|
|
3235
|
+
*
|
|
3236
|
+
* 質感の値 id(例 'linen'、'paper-grain'、'graph')
|
|
3237
|
+
*
|
|
3238
|
+
* 质感的值 id(例 'linen'、'paper-grain'、'graph')
|
|
1024
3239
|
*/
|
|
1025
3240
|
setTexture(name: string): void;
|
|
1026
3241
|
/**
|
|
1027
|
-
* 트리거 등록('before:{op}' 취소 가능, 'after:{op}' 결과 수신).
|
|
1028
|
-
*
|
|
3242
|
+
* 트리거 등록('before:{op}' 취소 가능, 'after:{op}' 결과 수신).
|
|
3243
|
+
*
|
|
3244
|
+
* Register a trigger ('before:{op}' can cancel, 'after:{op}' receives the result).
|
|
3245
|
+
*
|
|
3246
|
+
* トリガーの登録('before:{op}' はキャンセル可能、'after:{op}' は結果を受け取ります)。
|
|
3247
|
+
*
|
|
3248
|
+
* 注册触发器('before:{op}' 可取消,'after:{op}' 接收结果)。
|
|
3249
|
+
*
|
|
3250
|
+
* @param event - 트리거 이벤트명
|
|
3251
|
+
*
|
|
3252
|
+
* Trigger event name
|
|
3253
|
+
*
|
|
3254
|
+
* トリガーのイベント名
|
|
3255
|
+
*
|
|
3256
|
+
* 触发器的事件名
|
|
3257
|
+
*
|
|
3258
|
+
* @param handler - 핸들러(ctx.cancel() 지원)
|
|
3259
|
+
*
|
|
3260
|
+
* Handler (supports ctx.cancel())
|
|
3261
|
+
*
|
|
3262
|
+
* ハンドラ(ctx.cancel() に対応)
|
|
3263
|
+
*
|
|
3264
|
+
* 处理函数(支持 ctx.cancel())
|
|
3265
|
+
*
|
|
3266
|
+
* @returns 체이닝용 this
|
|
3267
|
+
*
|
|
3268
|
+
* this for chaining
|
|
3269
|
+
*
|
|
3270
|
+
* チェーン用の this
|
|
3271
|
+
*
|
|
3272
|
+
* 用于链式调用的 this
|
|
1029
3273
|
*
|
|
1030
|
-
* @param event - 트리거 이벤트명 / Trigger event name
|
|
1031
|
-
* @param handler - 핸들러(ctx.cancel() 지원) / Handler (supports ctx.cancel())
|
|
1032
|
-
* @returns 체이닝용 this / this for chaining
|
|
1033
3274
|
* @example
|
|
1034
3275
|
* grid.addTrigger('before:insertRow', ctx => { if (!ctx.args[0]?.name) ctx.cancel(); });
|
|
1035
3276
|
*/
|
|
1036
3277
|
addTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
|
|
1037
|
-
/**
|
|
3278
|
+
/**
|
|
3279
|
+
* 트리거 제거.
|
|
3280
|
+
*
|
|
3281
|
+
* Remove a trigger.
|
|
3282
|
+
*
|
|
3283
|
+
* トリガーの削除。
|
|
3284
|
+
*
|
|
3285
|
+
* 删除触发器。
|
|
3286
|
+
*/
|
|
1038
3287
|
removeTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
|
|
1039
|
-
/**
|
|
3288
|
+
/**
|
|
3289
|
+
* 트리거 전체 또는 특정 이벤트 클리어.
|
|
3290
|
+
*
|
|
3291
|
+
* Clear all triggers or those of one event.
|
|
3292
|
+
*
|
|
3293
|
+
* トリガー全体、または特定イベントのトリガーのクリア。
|
|
3294
|
+
*
|
|
3295
|
+
* 清除触发器的全体,或特定事件的触发器。
|
|
3296
|
+
*/
|
|
1040
3297
|
clearTriggers(event?: TriggerEvent | string): this;
|
|
1041
3298
|
private _mkCtx;
|
|
1042
3299
|
private _trig;
|
|
1043
3300
|
/**
|
|
1044
3301
|
* 그리드를 파괴한다(옵저버/이벤트/차트/패널 해제, DOM 정리, override 전체 복구).
|
|
1045
|
-
*
|
|
3302
|
+
*
|
|
3303
|
+
* Destroy the grid (detach observers/events/charts/panels, clean the DOM, restore all overrides).
|
|
3304
|
+
*
|
|
3305
|
+
* グリッドを破棄します(オブザーバ/イベント/チャート/パネルの解除、DOM の後片付け、override の全復元)。
|
|
3306
|
+
*
|
|
3307
|
+
* 销毁表格(解除观察器/事件/图表/面板,清理 DOM,恢复全部 override)。
|
|
1046
3308
|
*/
|
|
1047
3309
|
destroy(): void;
|
|
1048
3310
|
}
|