@genesislcap/foundation-layout 14.302.0 → 14.302.1-alpha-d11831b.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.
Files changed (26) hide show
  1. package/dist/custom-elements.json +118 -118
  2. package/dist/dts/main/layout-item.d.ts.map +1 -1
  3. package/dist/dts/main/layout-main.d.ts.map +1 -1
  4. package/dist/dts/utils/misc.d.ts.map +1 -1
  5. package/dist/foundation-layout.api.json +1 -1
  6. package/dist/foundation-layout.d.ts +519 -519
  7. package/dist/tsdoc-metadata.json +1 -1
  8. package/docs/api/foundation-layout.foundationlayout.additem.md +49 -4
  9. package/docs/api/foundation-layout.foundationlayout.layoutrequiredregistrations.md +33 -3
  10. package/docs/api/foundation-layout.foundationlayout.loadlayout.md +65 -5
  11. package/docs/api/foundation-layout.foundationlayout.md +357 -23
  12. package/docs/api/foundation-layout.foundationlayout.registeritem.md +49 -4
  13. package/docs/api/foundation-layout.foundationlayout.removeitems.md +49 -4
  14. package/docs/api/foundation-layout.foundationlayoutitem.md +98 -6
  15. package/docs/api/foundation-layout.foundationlayoutregion.md +60 -4
  16. package/docs/api/foundation-layout.layoutcomponentwithstate.applystate.md +31 -3
  17. package/docs/api/foundation-layout.layoutcomponentwithstate.md +34 -4
  18. package/docs/api/foundation-layout.layoutregistrationerror._constructor_.md +31 -3
  19. package/docs/api/foundation-layout.layoutregistrationerror.md +31 -3
  20. package/docs/api/foundation-layout.layoutusageerror._constructor_.md +31 -3
  21. package/docs/api/foundation-layout.layoutusageerror.md +31 -3
  22. package/docs/api/foundation-layout.md +274 -28
  23. package/docs/api/foundation-layout.registeredelementconfig.md +115 -7
  24. package/docs/api/index.md +21 -3
  25. package/docs/api-report.md.api.md +235 -0
  26. package/package.json +13 -13
@@ -5,7 +5,7 @@
5
5
  "toolPackages": [
6
6
  {
7
7
  "packageName": "@microsoft/api-extractor",
8
- "packageVersion": "7.34.9"
8
+ "packageVersion": "7.52.10"
9
9
  }
10
10
  ]
11
11
  }
@@ -14,10 +14,55 @@ addItem(config: RegisteredElementConfig | RegisteredElementConfig[], placement?:
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | config | [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md) \| [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md)<!-- -->\[\] | [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md) configuration items for the new items(s). Pass an array of [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md) to add multiple items at once. |
20
- | placement | [Placement](./foundation-layout.placement.md) | _(Optional)_ where and how to add the new items to the layout. For more info and defaults see [Placement](./foundation-layout.placement.md)<!-- -->. |
17
+ <table><thead><tr><th>
18
+
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ config
36
+
37
+
38
+ </td><td>
39
+
40
+ [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md) \| [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md)<!-- -->\[\]
41
+
42
+
43
+ </td><td>
44
+
45
+ [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md) configuration items for the new items(s). Pass an array of [RegisteredElementConfig](./foundation-layout.registeredelementconfig.md) to add multiple items at once.
46
+
47
+
48
+ </td></tr>
49
+ <tr><td>
50
+
51
+ placement
52
+
53
+
54
+ </td><td>
55
+
56
+ [Placement](./foundation-layout.placement.md)
57
+
58
+
59
+ </td><td>
60
+
61
+ _(Optional)_ where and how to add the new items to the layout. For more info and defaults see [Placement](./foundation-layout.placement.md)<!-- -->.
62
+
63
+
64
+ </td></tr>
65
+ </tbody></table>
21
66
 
22
67
  **Returns:**
23
68
 
@@ -14,9 +14,39 @@ static layoutRequiredRegistrations(layout: SerialisedLayout): string[];
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | layout | [SerialisedLayout](./foundation-layout.serialisedlayout.md) | any version of [SerialisedLayout](./foundation-layout.serialisedlayout.md) object describing the layout |
17
+ <table><thead><tr><th>
18
+
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ layout
36
+
37
+
38
+ </td><td>
39
+
40
+ [SerialisedLayout](./foundation-layout.serialisedlayout.md)
41
+
42
+
43
+ </td><td>
44
+
45
+ any version of [SerialisedLayout](./foundation-layout.serialisedlayout.md) object describing the layout
46
+
47
+
48
+ </td></tr>
49
+ </tbody></table>
20
50
 
21
51
  **Returns:**
22
52
 
@@ -14,11 +14,71 @@ loadLayout(layout: SerialisedLayout, handleMissingItem?: 'placeholder' | 'error'
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | layout | [SerialisedLayout](./foundation-layout.serialisedlayout.md) | any version of [SerialisedLayout](./foundation-layout.serialisedlayout.md) object describing the layout |
20
- | handleMissingItem | 'placeholder' \| 'error' | _(Optional)_ what to do if the layout contains items that are not currently registered with the layout system. Defaults to 'error' which will throw an error. If set to 'placeholder' then any missing items will be replaced with a placeholder element. You can control the text of the placeholder element with [FoundationLayout.missingItemPlaceholder](./foundation-layout.foundationlayout.missingitemplaceholder.md)<!-- -->. |
21
- | disableCache | boolean | _(Optional)_ if set to true then the layout will give you a new instance of every item, even if it has a currently cached item to use. Using this will not stop you from saving and loading state via the [LayoutComponentWithState](./foundation-layout.layoutcomponentwithstate.md) interface. Defaults to false. |
17
+ <table><thead><tr><th>
18
+
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ layout
36
+
37
+
38
+ </td><td>
39
+
40
+ [SerialisedLayout](./foundation-layout.serialisedlayout.md)
41
+
42
+
43
+ </td><td>
44
+
45
+ any version of [SerialisedLayout](./foundation-layout.serialisedlayout.md) object describing the layout
46
+
47
+
48
+ </td></tr>
49
+ <tr><td>
50
+
51
+ handleMissingItem
52
+
53
+
54
+ </td><td>
55
+
56
+ 'placeholder' \| 'error'
57
+
58
+
59
+ </td><td>
60
+
61
+ _(Optional)_ what to do if the layout contains items that are not currently registered with the layout system. Defaults to 'error' which will throw an error. If set to 'placeholder' then any missing items will be replaced with a placeholder element. You can control the text of the placeholder element with [FoundationLayout.missingItemPlaceholder](./foundation-layout.foundationlayout.missingitemplaceholder.md)<!-- -->.
62
+
63
+
64
+ </td></tr>
65
+ <tr><td>
66
+
67
+ disableCache
68
+
69
+
70
+ </td><td>
71
+
72
+ boolean
73
+
74
+
75
+ </td><td>
76
+
77
+ _(Optional)_ if set to true then the layout will give you a new instance of every item, even if it has a currently cached item to use. Using this will not stop you from saving and loading state via the [LayoutComponentWithState](./foundation-layout.layoutcomponentwithstate.md) interface. Defaults to false.
78
+
79
+
80
+ </td></tr>
81
+ </tbody></table>
22
82
 
23
83
  **Returns:**
24
84
 
@@ -23,30 +23,364 @@ The constructor for this class is marked as internal. Third-party code should no
23
23
 
24
24
  ## Properties
25
25
 
26
- | Property | Modifiers | Type | Description |
27
- | --- | --- | --- | --- |
28
- | [autoSaveKey?](./foundation-layout.foundationlayout.autosavekey.md) | | string | _(Optional)_ Attribute which if set will auto save and load the layout as the user changes it. Omit this attribute to disable this feature. Set attribute using <code>auto-save-key</code>. |
29
- | [class](./foundation-layout.foundationlayout.class.md) | | "FoundationLayoutMain" | Identifier constant token. |
30
- | [customButtons](./foundation-layout.foundationlayout.custombuttons.md) | | [CustomButton](./foundation-layout.custombutton.md)<!-- -->\[\] | Set custom button definition on this property to add them to the layout header controls |
31
- | [dimensionsConfig?](./foundation-layout.foundationlayout.dimensionsconfig.md) | | LayoutConfig.Dimensions | _(Optional)_ Apply dimensions config to the layout, such as setting the size of the drag handles. |
32
- | [dragging](./foundation-layout.foundationlayout.dragging.md) | | boolean | Set to true when the user is currently dragging the panes inside of the layout |
33
- | [hasFirstLoaded](./foundation-layout.foundationlayout.hasfirstloaded.md) | | boolean | Boolean signifies whether the layout has loaded for the first time or not. |
34
- | [lifecycleUpdateToken](./foundation-layout.foundationlayout.lifecycleupdatetoken.md) | | string \| undefined | Used to calculate whether a layout item should run its lifecycle methods or not |
35
- | [missingItemPlaceholder](./foundation-layout.foundationlayout.missingitemplaceholder.md) | | (missingItem: string) =&gt; string | Function which is used to generate the placeholder text when a layout is loaded with a missing item. |
36
- | [popoutConfig](./foundation-layout.foundationlayout.popoutconfig.md) | | string \| undefined | **_(BETA)_** Controls whether popout functionality is enabled on the layout. Defaults to disabled. Set this attribute to any string to enable popout functionality. If this string is of format <code>number;number</code> then this will be interpreted as the width and height of the popout window. |
37
- | [reloadBuffer](./foundation-layout.foundationlayout.reloadbuffer.md) | | number | Number describing how long to wait in ms before reloading the config when adding items declaratively by the html API. Default 500 (ms). |
26
+ <table><thead><tr><th>
27
+
28
+ Property
29
+
30
+
31
+ </th><th>
32
+
33
+ Modifiers
34
+
35
+
36
+ </th><th>
37
+
38
+ Type
39
+
40
+
41
+ </th><th>
42
+
43
+ Description
44
+
45
+
46
+ </th></tr></thead>
47
+ <tbody><tr><td>
48
+
49
+ [autoSaveKey?](./foundation-layout.foundationlayout.autosavekey.md)
50
+
51
+
52
+ </td><td>
53
+
54
+
55
+ </td><td>
56
+
57
+ string
58
+
59
+
60
+ </td><td>
61
+
62
+ _(Optional)_ Attribute which if set will auto save and load the layout as the user changes it. Omit this attribute to disable this feature. Set attribute using `auto-save-key`<!-- -->.
63
+
64
+
65
+ </td></tr>
66
+ <tr><td>
67
+
68
+ [class](./foundation-layout.foundationlayout.class.md)
69
+
70
+
71
+ </td><td>
72
+
73
+
74
+ </td><td>
75
+
76
+ "FoundationLayoutMain"
77
+
78
+
79
+ </td><td>
80
+
81
+ Identifier constant token.
82
+
83
+
84
+ </td></tr>
85
+ <tr><td>
86
+
87
+ [customButtons](./foundation-layout.foundationlayout.custombuttons.md)
88
+
89
+
90
+ </td><td>
91
+
92
+
93
+ </td><td>
94
+
95
+ [CustomButton](./foundation-layout.custombutton.md)<!-- -->\[\]
96
+
97
+
98
+ </td><td>
99
+
100
+ Set custom button definition on this property to add them to the layout header controls
101
+
102
+
103
+ </td></tr>
104
+ <tr><td>
105
+
106
+ [dimensionsConfig?](./foundation-layout.foundationlayout.dimensionsconfig.md)
107
+
108
+
109
+ </td><td>
110
+
111
+
112
+ </td><td>
113
+
114
+ LayoutConfig.Dimensions
115
+
116
+
117
+ </td><td>
118
+
119
+ _(Optional)_ Apply dimensions config to the layout, such as setting the size of the drag handles.
120
+
121
+
122
+ </td></tr>
123
+ <tr><td>
124
+
125
+ [dragging](./foundation-layout.foundationlayout.dragging.md)
126
+
127
+
128
+ </td><td>
129
+
130
+
131
+ </td><td>
132
+
133
+ boolean
134
+
135
+
136
+ </td><td>
137
+
138
+ Set to true when the user is currently dragging the panes inside of the layout
139
+
140
+
141
+ </td></tr>
142
+ <tr><td>
143
+
144
+ [hasFirstLoaded](./foundation-layout.foundationlayout.hasfirstloaded.md)
145
+
146
+
147
+ </td><td>
148
+
149
+
150
+ </td><td>
151
+
152
+ boolean
153
+
154
+
155
+ </td><td>
156
+
157
+ Boolean signifies whether the layout has loaded for the first time or not.
158
+
159
+
160
+ </td></tr>
161
+ <tr><td>
162
+
163
+ [lifecycleUpdateToken](./foundation-layout.foundationlayout.lifecycleupdatetoken.md)
164
+
165
+
166
+ </td><td>
167
+
168
+
169
+ </td><td>
170
+
171
+ string \| undefined
172
+
173
+
174
+ </td><td>
175
+
176
+ Used to calculate whether a layout item should run its lifecycle methods or not
177
+
178
+
179
+ </td></tr>
180
+ <tr><td>
181
+
182
+ [missingItemPlaceholder](./foundation-layout.foundationlayout.missingitemplaceholder.md)
183
+
184
+
185
+ </td><td>
186
+
187
+
188
+ </td><td>
189
+
190
+ (missingItem: string) =&gt; string
191
+
192
+
193
+ </td><td>
194
+
195
+ Function which is used to generate the placeholder text when a layout is loaded with a missing item.
196
+
197
+
198
+ </td></tr>
199
+ <tr><td>
200
+
201
+ [popoutConfig](./foundation-layout.foundationlayout.popoutconfig.md)
202
+
203
+
204
+ </td><td>
205
+
206
+
207
+ </td><td>
208
+
209
+ string \| undefined
210
+
211
+
212
+ </td><td>
213
+
214
+ **_(BETA)_** Controls whether popout functionality is enabled on the layout. Defaults to disabled. Set this attribute to any string to enable popout functionality. If this string is of format `number;number` then this will be interpreted as the width and height of the popout window.
215
+
216
+
217
+ </td></tr>
218
+ <tr><td>
219
+
220
+ [reloadBuffer](./foundation-layout.foundationlayout.reloadbuffer.md)
221
+
222
+
223
+ </td><td>
224
+
225
+
226
+ </td><td>
227
+
228
+ number
229
+
230
+
231
+ </td><td>
232
+
233
+ Number describing how long to wait in ms before reloading the config when adding items declaratively by the html API. Default 500 (ms).
234
+
235
+
236
+ </td></tr>
237
+ </tbody></table>
38
238
 
39
239
  ## Methods
40
240
 
41
- | Method | Modifiers | Description |
42
- | --- | --- | --- |
43
- | [addItem(config, placement)](./foundation-layout.foundationlayout.additem.md) | | Dynamically add a new item to the layout. The user can move the new plane to whenever they want once it has been added. |
44
- | [getLayout()](./foundation-layout.foundationlayout.getlayout.md) | | Gets a minified string containing the config describing the current layout of the layout object to later restore in [function](./foundation-layout.foundationlayout.loadlayout.md) |
45
- | [layoutRequiredRegistrations(layout)](./foundation-layout.foundationlayout.layoutrequiredregistrations.md) | <code>static</code> | Gets all of the required element registry function names for a set of config |
46
- | [loadLayout(layout, handleMissingItem, disableCache)](./foundation-layout.foundationlayout.loadlayout.md) | | Restores a layout described in the config from [getLayout()](./foundation-layout.foundationlayout.getlayout.md) |
47
- | [registeredItems()](./foundation-layout.foundationlayout.registereditems.md) | | Gets all of the currently registered names |
48
- | [registerItem(registration, elements)](./foundation-layout.foundationlayout.registeritem.md) | | Register a collection of <code>Element</code> and associate them with an <code>ID</code> with the layout system for later use. |
49
- | [removeItems(registration, force)](./foundation-layout.foundationlayout.removeitems.md) | | Removes all instances of a specified registered item from the layout. |
50
- | [tryActivatePopoutMode()](./foundation-layout.foundationlayout.tryactivatepopoutmode.md) | | **_(BETA)_** If in a popout window from the dynamic layout, this function will run the flow to put the component in popout mode. This function is automatically called if using the declarative HTML API, but if only using the JavaScript API then you will need to call this function manually. |
51
- | [tryLoadLayoutFromLocalStorage()](./foundation-layout.foundationlayout.tryloadlayoutfromlocalstorage.md) | | Try to load a layout from local storage, or return false. Only required if manually calling [FoundationLayout.registerItem()](./foundation-layout.foundationlayout.registeritem.md) |
241
+ <table><thead><tr><th>
242
+
243
+ Method
244
+
245
+
246
+ </th><th>
247
+
248
+ Modifiers
249
+
250
+
251
+ </th><th>
252
+
253
+ Description
254
+
255
+
256
+ </th></tr></thead>
257
+ <tbody><tr><td>
258
+
259
+ [addItem(config, placement)](./foundation-layout.foundationlayout.additem.md)
260
+
261
+
262
+ </td><td>
263
+
264
+
265
+ </td><td>
266
+
267
+ Dynamically add a new item to the layout. The user can move the new plane to whenever they want once it has been added.
268
+
269
+
270
+ </td></tr>
271
+ <tr><td>
272
+
273
+ [getLayout()](./foundation-layout.foundationlayout.getlayout.md)
274
+
275
+
276
+ </td><td>
277
+
278
+
279
+ </td><td>
280
+
281
+ Gets a minified string containing the config describing the current layout of the layout object to later restore in [function](./foundation-layout.foundationlayout.loadlayout.md)
282
+
283
+
284
+ </td></tr>
285
+ <tr><td>
286
+
287
+ [layoutRequiredRegistrations(layout)](./foundation-layout.foundationlayout.layoutrequiredregistrations.md)
288
+
289
+
290
+ </td><td>
291
+
292
+ `static`
293
+
294
+
295
+ </td><td>
296
+
297
+ Gets all of the required element registry function names for a set of config
298
+
299
+
300
+ </td></tr>
301
+ <tr><td>
302
+
303
+ [loadLayout(layout, handleMissingItem, disableCache)](./foundation-layout.foundationlayout.loadlayout.md)
304
+
305
+
306
+ </td><td>
307
+
308
+
309
+ </td><td>
310
+
311
+ Restores a layout described in the config from [getLayout()](./foundation-layout.foundationlayout.getlayout.md)
312
+
313
+
314
+ </td></tr>
315
+ <tr><td>
316
+
317
+ [registeredItems()](./foundation-layout.foundationlayout.registereditems.md)
318
+
319
+
320
+ </td><td>
321
+
322
+
323
+ </td><td>
324
+
325
+ Gets all of the currently registered names
326
+
327
+
328
+ </td></tr>
329
+ <tr><td>
330
+
331
+ [registerItem(registration, elements)](./foundation-layout.foundationlayout.registeritem.md)
332
+
333
+
334
+ </td><td>
335
+
336
+
337
+ </td><td>
338
+
339
+ Register a collection of `Element` and associate them with an `ID` with the layout system for later use.
340
+
341
+
342
+ </td></tr>
343
+ <tr><td>
344
+
345
+ [removeItems(registration, force)](./foundation-layout.foundationlayout.removeitems.md)
346
+
347
+
348
+ </td><td>
349
+
350
+
351
+ </td><td>
352
+
353
+ Removes all instances of a specified registered item from the layout.
354
+
355
+
356
+ </td></tr>
357
+ <tr><td>
358
+
359
+ [tryActivatePopoutMode()](./foundation-layout.foundationlayout.tryactivatepopoutmode.md)
360
+
361
+
362
+ </td><td>
363
+
364
+
365
+ </td><td>
366
+
367
+ **_(BETA)_** If in a popout window from the dynamic layout, this function will run the flow to put the component in popout mode. This function is automatically called if using the declarative HTML API, but if only using the JavaScript API then you will need to call this function manually.
368
+
369
+
370
+ </td></tr>
371
+ <tr><td>
372
+
373
+ [tryLoadLayoutFromLocalStorage()](./foundation-layout.foundationlayout.tryloadlayoutfromlocalstorage.md)
374
+
375
+
376
+ </td><td>
377
+
378
+
379
+ </td><td>
380
+
381
+ Try to load a layout from local storage, or return false. Only required if manually calling [FoundationLayout.registerItem()](./foundation-layout.foundationlayout.registeritem.md)
382
+
383
+
384
+ </td></tr>
385
+ </tbody></table>
52
386
 
@@ -14,10 +14,55 @@ registerItem(registration: string, elements: Element[]): string;
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | registration | string | string of the registration ID |
20
- | elements | Element\[\] | Elements\[\] containing the reference to the elements to register for later usage |
17
+ <table><thead><tr><th>
18
+
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ registration
36
+
37
+
38
+ </td><td>
39
+
40
+ string
41
+
42
+
43
+ </td><td>
44
+
45
+ string of the registration ID
46
+
47
+
48
+ </td></tr>
49
+ <tr><td>
50
+
51
+ elements
52
+
53
+
54
+ </td><td>
55
+
56
+ Element\[\]
57
+
58
+
59
+ </td><td>
60
+
61
+ Elements\[\] containing the reference to the elements to register for later usage
62
+
63
+
64
+ </td></tr>
65
+ </tbody></table>
21
66
 
22
67
  **Returns:**
23
68
 
@@ -14,10 +14,55 @@ removeItems(registration: string, force?: boolean): number;
14
14
 
15
15
  ## Parameters
16
16
 
17
- | Parameter | Type | Description |
18
- | --- | --- | --- |
19
- | registration | string | string of the registration ID |
20
- | force | boolean | _(Optional)_ if set to true then the item will be removed even if it is not closable. Defaults to false, which is the same behaviour as the close button on the header. |
17
+ <table><thead><tr><th>
18
+
19
+ Parameter
20
+
21
+
22
+ </th><th>
23
+
24
+ Type
25
+
26
+
27
+ </th><th>
28
+
29
+ Description
30
+
31
+
32
+ </th></tr></thead>
33
+ <tbody><tr><td>
34
+
35
+ registration
36
+
37
+
38
+ </td><td>
39
+
40
+ string
41
+
42
+
43
+ </td><td>
44
+
45
+ string of the registration ID
46
+
47
+
48
+ </td></tr>
49
+ <tr><td>
50
+
51
+ force
52
+
53
+
54
+ </td><td>
55
+
56
+ boolean
57
+
58
+
59
+ </td><td>
60
+
61
+ _(Optional)_ if set to true then the item will be removed even if it is not closable. Defaults to false, which is the same behaviour as the close button on the header.
62
+
63
+
64
+ </td></tr>
65
+ </tbody></table>
21
66
 
22
67
  **Returns:**
23
68