@roomle/embedding-lib 4.38.0 → 4.41.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/docs/__sidebar__.json +14 -0
- package/docs/api/classes/exposed_analytics_callbacks.ExposedAnalyticsCallbacks.md +1 -1
- package/docs/api/classes/exposed_api.ExposedApi.md +11 -11
- package/docs/api/classes/exposed_callbacks.ExposedCallbacks.md +8 -8
- package/docs/api/classes/roomle_configurator_api.default.md +9 -9
- package/docs/api/enums/types.UI_BUTTON.md +33 -22
- package/docs/api/interfaces/exposed_callbacks.Labels.md +2 -2
- package/docs/api/interfaces/exposed_callbacks.Price.md +2 -2
- package/docs/api/interfaces/roomle_configurator_api.RoomleEmbeddingApiKeys.md +4 -4
- package/docs/api/interfaces/types.ConfiguratorSettings.md +5 -5
- package/docs/api/interfaces/types.EmbeddingSkin.md +5 -5
- package/docs/api/interfaces/types.UiInitData.md +31 -16
- package/docs/api/modules/roomle_configurator_api.md +3 -3
- package/docs/examples/11_light_settings.html +89 -62
- package/docs/examples/roomle-configurator-api.es.min.js +254 -58
- package/docs/hsp.md +61 -0
- package/docs/integration.md +1101 -0
- package/docs/md/web/ui/EMBEDDING-CHANGELOG.md +10 -37
- package/docs/migration-guides/v2-to-v3.md +2 -2
- package/docs/moc/index.md +86 -0
- package/docs/simple.md +1 -1
- package/package.json +2 -2
- package/types/index.d.ts +18 -6
- package/types/src/common/store/collection-view-state.d.ts +8 -3
- package/types/src/common/store/common-ui-state.d.ts +1 -1
- package/types/src/configurator/embedding/exposed-api.d.ts +0 -1
- package/types/src/configurator/embedding/types.d.ts +8 -1
- package/types/src/configurator/store/ui-state.d.ts +1 -0
- package/types/tests/helpers/dom.d.ts +1 -1
- package/types/tests/helpers/mocks/sdk-connector.d.ts +1 -0
- package/types/tests/integration/planner/components/utils/sidebar-nav/SidebarNav.spec.d.ts +1 -0
- package/types/tests/unit/configurator/components/utils/WordWrap.spec.d.ts +1 -0
- package/docs/index.md +0 -847
|
@@ -43,6 +43,7 @@
|
|
|
43
43
|
- [isItem](types.UiInitData.md#isitem)
|
|
44
44
|
- [locale](types.UiInitData.md#locale)
|
|
45
45
|
- [ls](types.UiInitData.md#ls)
|
|
46
|
+
- [materialMultiSelect](types.UiInitData.md#materialmultiselect)
|
|
46
47
|
- [maxHorizontalCameraAngle](types.UiInitData.md#maxhorizontalcameraangle)
|
|
47
48
|
- [maxVerticalCameraAngle](types.UiInitData.md#maxverticalcameraangle)
|
|
48
49
|
- [meshSelection](types.UiInitData.md#meshselection)
|
|
@@ -127,7 +128,7 @@ to view 3d content. Imagine it then as a <img> tag for 3d content
|
|
|
127
128
|
|
|
128
129
|
#### Defined in
|
|
129
130
|
|
|
130
|
-
[src/configurator/embedding/types.ts:
|
|
131
|
+
[src/configurator/embedding/types.ts:92](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L92)
|
|
131
132
|
|
|
132
133
|
___
|
|
133
134
|
|
|
@@ -144,7 +145,7 @@ InitDataDefinition.applyCurrentGlobalParameters
|
|
|
144
145
|
|
|
145
146
|
#### Defined in
|
|
146
147
|
|
|
147
|
-
[src/configurator/embedding/types.ts:
|
|
148
|
+
[src/configurator/embedding/types.ts:139](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L139)
|
|
148
149
|
|
|
149
150
|
___
|
|
150
151
|
|
|
@@ -209,12 +210,13 @@ ___
|
|
|
209
210
|
| `resetcamera?` | false \| true |
|
|
210
211
|
| `savedraft?` | false \| true |
|
|
211
212
|
| `snapping?` | false \| true |
|
|
213
|
+
| `startPlanner?` | false \| true |
|
|
212
214
|
| `startconfigure?` | false \| true |
|
|
213
215
|
| `undo?` | false \| true |
|
|
214
216
|
|
|
215
217
|
#### Defined in
|
|
216
218
|
|
|
217
|
-
[src/configurator/embedding/types.ts:
|
|
219
|
+
[src/configurator/embedding/types.ts:40](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L40)
|
|
218
220
|
|
|
219
221
|
___
|
|
220
222
|
|
|
@@ -345,7 +347,7 @@ usage: http://www.example.com/configurator?id=#CONFIGURATIONID#
|
|
|
345
347
|
|
|
346
348
|
#### Defined in
|
|
347
349
|
|
|
348
|
-
[src/configurator/embedding/types.ts:
|
|
350
|
+
[src/configurator/embedding/types.ts:79](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L79)
|
|
349
351
|
|
|
350
352
|
___
|
|
351
353
|
|
|
@@ -410,7 +412,7 @@ an e-mail
|
|
|
410
412
|
|
|
411
413
|
#### Defined in
|
|
412
414
|
|
|
413
|
-
[src/configurator/embedding/types.ts:
|
|
415
|
+
[src/configurator/embedding/types.ts:97](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L97)
|
|
414
416
|
|
|
415
417
|
___
|
|
416
418
|
|
|
@@ -424,7 +426,7 @@ so that we can ensure a smooth transition between different versions of our conf
|
|
|
424
426
|
|
|
425
427
|
#### Defined in
|
|
426
428
|
|
|
427
|
-
[src/configurator/embedding/types.ts:
|
|
429
|
+
[src/configurator/embedding/types.ts:113](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L113)
|
|
428
430
|
|
|
429
431
|
___
|
|
430
432
|
|
|
@@ -452,7 +454,7 @@ set this flag to false if the user did not give the consent to Analytics
|
|
|
452
454
|
|
|
453
455
|
#### Defined in
|
|
454
456
|
|
|
455
|
-
[src/configurator/embedding/types.ts:
|
|
457
|
+
[src/configurator/embedding/types.ts:117](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L117)
|
|
456
458
|
|
|
457
459
|
___
|
|
458
460
|
|
|
@@ -464,7 +466,7 @@ set this flag to true if you want to group the part list by main components
|
|
|
464
466
|
|
|
465
467
|
#### Defined in
|
|
466
468
|
|
|
467
|
-
[src/configurator/embedding/types.ts:
|
|
469
|
+
[src/configurator/embedding/types.ts:107](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L107)
|
|
468
470
|
|
|
469
471
|
___
|
|
470
472
|
|
|
@@ -552,6 +554,19 @@ node_modules/@roomle/web-sdk/lib/definitions/common-core/src/utils/shims.d.ts:20
|
|
|
552
554
|
|
|
553
555
|
___
|
|
554
556
|
|
|
557
|
+
### materialMultiSelect
|
|
558
|
+
|
|
559
|
+
• `Optional` **materialMultiSelect**: false \| true
|
|
560
|
+
|
|
561
|
+
set this flag to true if you want that a user can select more than one material category at once
|
|
562
|
+
default: false
|
|
563
|
+
|
|
564
|
+
#### Defined in
|
|
565
|
+
|
|
566
|
+
[src/configurator/embedding/types.ts:144](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L144)
|
|
567
|
+
|
|
568
|
+
___
|
|
569
|
+
|
|
555
570
|
### maxHorizontalCameraAngle
|
|
556
571
|
|
|
557
572
|
• `Optional` **maxHorizontalCameraAngle**: `number`
|
|
@@ -651,7 +666,7 @@ small div
|
|
|
651
666
|
|
|
652
667
|
#### Defined in
|
|
653
668
|
|
|
654
|
-
[src/configurator/embedding/types.ts:
|
|
669
|
+
[src/configurator/embedding/types.ts:103](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L103)
|
|
655
670
|
|
|
656
671
|
___
|
|
657
672
|
|
|
@@ -772,7 +787,7 @@ ___
|
|
|
772
787
|
|
|
773
788
|
#### Defined in
|
|
774
789
|
|
|
775
|
-
[src/configurator/embedding/types.ts:
|
|
790
|
+
[src/configurator/embedding/types.ts:65](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L65)
|
|
776
791
|
|
|
777
792
|
___
|
|
778
793
|
|
|
@@ -887,7 +902,7 @@ for details see deeplink, the only change is that the placeholder is <CONF_ID> h
|
|
|
887
902
|
|
|
888
903
|
#### Defined in
|
|
889
904
|
|
|
890
|
-
[src/configurator/embedding/types.ts:
|
|
905
|
+
[src/configurator/embedding/types.ts:70](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L70)
|
|
891
906
|
|
|
892
907
|
___
|
|
893
908
|
|
|
@@ -949,7 +964,7 @@ ___
|
|
|
949
964
|
|
|
950
965
|
#### Defined in
|
|
951
966
|
|
|
952
|
-
[src/configurator/embedding/types.ts:
|
|
967
|
+
[src/configurator/embedding/types.ts:62](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L62)
|
|
953
968
|
|
|
954
969
|
___
|
|
955
970
|
|
|
@@ -1007,7 +1022,7 @@ You can find all labels here: [Base.json](../../../ui/base.json)
|
|
|
1007
1022
|
|
|
1008
1023
|
#### Defined in
|
|
1009
1024
|
|
|
1010
|
-
[src/configurator/embedding/types.ts:
|
|
1025
|
+
[src/configurator/embedding/types.ts:134](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L134)
|
|
1011
1026
|
|
|
1012
1027
|
___
|
|
1013
1028
|
|
|
@@ -1088,7 +1103,7 @@ ___
|
|
|
1088
1103
|
|
|
1089
1104
|
#### Defined in
|
|
1090
1105
|
|
|
1091
|
-
[src/configurator/embedding/types.ts:
|
|
1106
|
+
[src/configurator/embedding/types.ts:64](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L64)
|
|
1092
1107
|
|
|
1093
1108
|
___
|
|
1094
1109
|
|
|
@@ -1139,7 +1154,7 @@ usm:frame is loaded all the items from the tag "DB_Start_ohne_Element" are now s
|
|
|
1139
1154
|
|
|
1140
1155
|
#### Defined in
|
|
1141
1156
|
|
|
1142
|
-
[src/configurator/embedding/types.ts:
|
|
1157
|
+
[src/configurator/embedding/types.ts:86](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L86)
|
|
1143
1158
|
|
|
1144
1159
|
___
|
|
1145
1160
|
|
|
@@ -1149,7 +1164,7 @@ ___
|
|
|
1149
1164
|
|
|
1150
1165
|
#### Defined in
|
|
1151
1166
|
|
|
1152
|
-
[src/configurator/embedding/types.ts:
|
|
1167
|
+
[src/configurator/embedding/types.ts:63](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/types.ts#L63)
|
|
1153
1168
|
|
|
1154
1169
|
___
|
|
1155
1170
|
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
|
|
27
27
|
#### Defined in
|
|
28
28
|
|
|
29
|
-
[src/configurator/embedding/roomle-configurator-api.ts:70](https://gitlab.com/roomle/web/roomle-ui/-/blob/
|
|
29
|
+
[src/configurator/embedding/roomle-configurator-api.ts:70](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/roomle-configurator-api.ts#L70)
|
|
30
30
|
|
|
31
31
|
___
|
|
32
32
|
|
|
@@ -36,7 +36,7 @@ ___
|
|
|
36
36
|
|
|
37
37
|
#### Defined in
|
|
38
38
|
|
|
39
|
-
[src/configurator/embedding/roomle-configurator-api.ts:72](https://gitlab.com/roomle/web/roomle-ui/-/blob/
|
|
39
|
+
[src/configurator/embedding/roomle-configurator-api.ts:72](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/roomle-configurator-api.ts#L72)
|
|
40
40
|
|
|
41
41
|
___
|
|
42
42
|
|
|
@@ -46,4 +46,4 @@ ___
|
|
|
46
46
|
|
|
47
47
|
#### Defined in
|
|
48
48
|
|
|
49
|
-
[src/configurator/embedding/roomle-configurator-api.ts:71](https://gitlab.com/roomle/web/roomle-ui/-/blob/
|
|
49
|
+
[src/configurator/embedding/roomle-configurator-api.ts:71](https://gitlab.com/roomle/web/roomle-ui/-/blob/e62175ee/src/configurator/embedding/roomle-configurator-api.ts#L71)
|
|
@@ -6,31 +6,36 @@
|
|
|
6
6
|
padding: 0;
|
|
7
7
|
overflow: hidden;
|
|
8
8
|
}
|
|
9
|
+
|
|
9
10
|
.ls, .product {
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
11
|
+
width: 70px;
|
|
12
|
+
height: 70px;
|
|
13
|
+
margin: 10px;
|
|
14
|
+
background-color: azure;
|
|
15
|
+
border: 1px solid blue;
|
|
16
|
+
color: #090909;
|
|
17
|
+
text-align: center;
|
|
18
|
+
display: flex;
|
|
19
|
+
align-items: center;
|
|
20
|
+
cursor: pointer;
|
|
20
21
|
}
|
|
22
|
+
|
|
21
23
|
.product {
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
24
|
+
width: 70px;
|
|
25
|
+
height: 70px;
|
|
26
|
+
margin: 10px;
|
|
27
|
+
background-color: rgb(232, 254, 232);
|
|
28
|
+
border: 1px solid green;
|
|
27
29
|
}
|
|
30
|
+
|
|
28
31
|
.ls div, .product div {
|
|
29
|
-
|
|
32
|
+
width: 100%;
|
|
30
33
|
}
|
|
34
|
+
|
|
31
35
|
.container {
|
|
32
|
-
|
|
36
|
+
display: flex;
|
|
33
37
|
}
|
|
38
|
+
|
|
34
39
|
#configurator-container {
|
|
35
40
|
width: 1024px;
|
|
36
41
|
height: 600px;
|
|
@@ -40,60 +45,82 @@
|
|
|
40
45
|
|
|
41
46
|
<body>
|
|
42
47
|
<div class="container">
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
48
|
+
<div class="product"
|
|
49
|
+
data-roomle-id="usm:frame:1E13940F850F734EDF5ADF48191E9ACDAD93BEC0BE757F89E78807A5DA0FAD8C">
|
|
50
|
+
<div>Shelf</div>
|
|
51
|
+
</div>
|
|
52
|
+
<div class="product"
|
|
53
|
+
data-roomle-id="musterring:Felicia_Sofa:7698BEE48226BBB1E0AF93F342018DC1FC269242F02D1F0C9367414A26CA3425">
|
|
54
|
+
<div>Sofa</div>
|
|
55
|
+
</div>
|
|
56
|
+
<div class="product"
|
|
57
|
+
data-roomle-id="hussl:ST6N:C39C46D1AD6F8BC9E3F778A6F92CB017B785CE960D8D4C7146223348A9B70590">
|
|
58
|
+
<div>Chair</div>
|
|
59
|
+
</div>
|
|
46
60
|
</div>
|
|
47
61
|
<div class="container">
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
62
|
+
<div class="ls" data-roomle-ls="sofa">
|
|
63
|
+
<div>Sofa<br>Light</div>
|
|
64
|
+
</div>
|
|
65
|
+
<div class="ls" data-roomle-ls="shelf">
|
|
66
|
+
<div>Shelf<br>Light</div>
|
|
67
|
+
</div>
|
|
68
|
+
<div class="ls" data-roomle-ls="shelf_front">
|
|
69
|
+
<div>Shelf Front<br>Light</div>
|
|
70
|
+
</div>
|
|
71
|
+
<div class="ls" data-roomle-ls="equal">
|
|
72
|
+
<div>Equal<br>Light</div>
|
|
73
|
+
</div>
|
|
74
|
+
<div class="ls" data-roomle-ls="camera">
|
|
75
|
+
<div>Camera<br>Light</div>
|
|
76
|
+
</div>
|
|
77
|
+
<div class="ls" data-roomle-ls="baked">
|
|
78
|
+
<div>Baked<br>Light</div>
|
|
79
|
+
</div>
|
|
54
80
|
</div>
|
|
55
81
|
<div id="configurator-container"></div>
|
|
56
82
|
<script src="./roomle-configurator-api.es.min.js" type="module"></script>
|
|
57
83
|
<script type="module">
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
84
|
+
import RoomleConfiguratorApi from './roomle-configurator-api.es.min.js';
|
|
85
|
+
|
|
86
|
+
(async () => {
|
|
87
|
+
const options = {
|
|
88
|
+
id: 'usm:frame:1E13940F850F734EDF5ADF48191E9ACDAD93BEC0BE757F89E78807A5DA0FAD8C',
|
|
89
|
+
};
|
|
90
|
+
const configurator = await RoomleConfiguratorApi.createConfigurator(
|
|
91
|
+
'demoConfigurator',
|
|
92
|
+
document.getElementById('configurator-container'),
|
|
93
|
+
options,
|
|
94
|
+
);
|
|
68
95
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
96
|
+
[...document.querySelectorAll('.ls')].forEach((button) => {
|
|
97
|
+
button.addEventListener('click', (productDomNode) => {
|
|
98
|
+
const target = productDomNode.target;
|
|
99
|
+
let roomleLs = target.getAttribute('data-roomle-ls') || target.parentElement.getAttribute('data-roomle-ls');
|
|
100
|
+
if (!roomleLs) {
|
|
101
|
+
return;
|
|
102
|
+
}
|
|
103
|
+
// this is obfuscated on purpose because it uses internal API functions
|
|
104
|
+
// which are not meant to be used! This example should only demonstrate
|
|
105
|
+
// the different light settings. Sure it's easy to decode the string but
|
|
106
|
+
// please do not copy and paste the decoded code into your production app
|
|
107
|
+
// unless you know what you do :-)
|
|
108
|
+
eval(atob('Y29uZmlndXJhdG9yLmV4dGVuZGVkLmxvYWREeW5hbWljTGlnaHRTZXR0aW5nKHtsczogcm9vbWxlTHN9KQ=='));
|
|
109
|
+
});
|
|
110
|
+
});
|
|
84
111
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
let roomleId = target.getAttribute('data-roomle-id') || target.parentElement.getAttribute('data-roomle-id');
|
|
89
|
-
if(!roomleId) {
|
|
90
|
-
return;
|
|
91
|
-
}
|
|
92
|
-
configurator.ui.loadObject(roomleId);
|
|
93
|
-
});
|
|
94
|
-
});
|
|
95
|
-
})();
|
|
112
|
+
[...document.querySelectorAll('.product')].forEach((button) => {
|
|
113
|
+
button.addEventListener('click', (productDomNode) => {
|
|
114
|
+
const target = productDomNode.target;
|
|
96
115
|
let roomleId = target.getAttribute('data-roomle-id') || target.parentElement.getAttribute('data-roomle-id');
|
|
116
|
+
if (!roomleId) {
|
|
117
|
+
return;
|
|
118
|
+
}
|
|
119
|
+
configurator.ui.loadObject(roomleId);
|
|
120
|
+
});
|
|
121
|
+
});
|
|
122
|
+
})();
|
|
123
|
+
let roomleId = target.getAttribute('data-roomle-id') || target.parentElement.getAttribute('data-roomle-id');
|
|
97
124
|
</script>
|
|
98
125
|
</body>
|
|
99
126
|
</html>
|