@empathyco/x-components 3.0.0-alpha.86 → 3.0.0-alpha.89
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 +22 -0
- package/core/index.js.map +1 -1
- package/design-system/full-theme.css +34 -34
- package/docs/API-reference/api/x-adapter.searchresponse.banners.md +1 -1
- package/docs/API-reference/api/x-adapter.searchresponse.md +5 -5
- package/docs/API-reference/api/x-adapter.searchresponse.partialresults.md +1 -1
- package/docs/API-reference/api/x-adapter.searchresponse.promoteds.md +1 -1
- package/docs/API-reference/api/x-adapter.searchresponse.redirections.md +1 -1
- package/docs/API-reference/api/x-adapter.searchresponse.spellcheck.md +1 -1
- package/docs/API-reference/api/x-components.increasepageappendingresults.md +2 -2
- package/docs/API-reference/api/x-components.increasepageappendingresultswire.md +13 -0
- package/docs/API-reference/api/x-components.md +7 -3
- package/docs/API-reference/api/x-components.resetstate.md +13 -0
- package/docs/API-reference/api/{x-components.saveorigin.md → x-components.saveidentifierresultsorigin.md} +2 -2
- package/docs/API-reference/api/x-components.savesearchorigin.md +13 -0
- package/docs/API-reference/api/x-components.savesearchresponse.md +13 -0
- package/docs/API-reference/api/x-components.searchactions.md +1 -0
- package/docs/API-reference/api/x-components.searchactions.savesearchresponse.md +24 -0
- package/docs/API-reference/api/x-components.setsearchurlparams.md +13 -0
- package/docs/API-reference/api/x-components.snippetconfigextraparams.excludedextraparams.md +13 -0
- package/docs/API-reference/api/x-components.snippetconfigextraparams.md +1 -0
- package/docs/API-reference/components/extra-params/x-components.snippet-config-extra-params.md +4 -3
- package/docs/build-search-ui/README.md +39 -34
- package/docs/build-search-ui/web-archetype-development-guide.md +28 -27
- package/docs/build-search-ui/web-archetype-integration-guide.md +159 -98
- package/docs/build-search-ui/web-how-to-use-x-components-guide.md +28 -37
- package/docs/build-search-ui/{x-architecture/README.md → web-x-architecture.md} +4 -52
- package/docs/build-search-ui/{web-x-components-integration-guide.md → web-x-components-development-guide.md} +27 -30
- package/identifier-results/index.js +1 -1
- package/js/components/decorators/injection.decorators.js.map +1 -1
- package/js/index.js +7 -2
- package/js/index.js.map +1 -1
- package/js/plugins/x-plugin.mixin.js.map +1 -1
- package/js/store/utils/fetch-and-save-action.utils.js +4 -2
- package/js/store/utils/fetch-and-save-action.utils.js.map +1 -1
- package/js/store/utils/store-emitters.utils.js.map +1 -1
- package/js/x-modules/empathize/components/empathize.vue.js.map +1 -1
- package/js/x-modules/empathize/components/empathize.vue_rollup-plugin-vue_script.vue.js +2 -2
- package/js/x-modules/empathize/components/empathize.vue_rollup-plugin-vue_script.vue.js.map +1 -1
- package/js/x-modules/extra-params/components/snippet-config-extra-params.vue.js.map +1 -1
- package/js/x-modules/extra-params/components/snippet-config-extra-params.vue_rollup-plugin-vue_script.vue.js +15 -129
- package/js/x-modules/extra-params/components/snippet-config-extra-params.vue_rollup-plugin-vue_script.vue.js.map +1 -1
- package/js/x-modules/next-queries/components/next-queries-list.vue.js.map +1 -1
- package/js/x-modules/next-queries/components/next-queries-list.vue_rollup-plugin-vue_script.vue.js.map +1 -1
- package/js/x-modules/search/store/actions/fetch-and-save-search-response.action.js +2 -19
- package/js/x-modules/search/store/actions/fetch-and-save-search-response.action.js.map +1 -1
- package/js/x-modules/search/store/actions/save-search-response.action.js +32 -0
- package/js/x-modules/search/store/actions/save-search-response.action.js.map +1 -0
- package/js/x-modules/search/store/module.js +2 -0
- package/js/x-modules/search/store/module.js.map +1 -1
- package/js/x-modules/search/wiring.js +3 -9
- package/js/x-modules/search/wiring.js.map +1 -1
- package/js/x-modules/url/components/url-handler.vue.js.map +1 -1
- package/js/x-modules/url/components/url-handler.vue_rollup-plugin-vue_script.vue.js +2 -1
- package/js/x-modules/url/components/url-handler.vue_rollup-plugin-vue_script.vue.js.map +1 -1
- package/package.json +4 -4
- package/report/x-adapter.api.json +10 -10
- package/report/x-components.api.json +238 -51
- package/report/x-components.api.md +22 -10
- package/search/index.js +6 -1
- package/types/plugins/x-plugin.mixin.d.ts.map +1 -1
- package/types/store/utils/fetch-and-save-action.utils.d.ts.map +1 -1
- package/types/x-modules/extra-params/components/snippet-config-extra-params.vue.d.ts +5 -4
- package/types/x-modules/extra-params/components/snippet-config-extra-params.vue.d.ts.map +1 -1
- package/types/x-modules/identifier-results/store/actions/index.d.ts +5 -0
- package/types/x-modules/identifier-results/store/actions/index.d.ts.map +1 -0
- package/types/x-modules/identifier-results/store/index.d.ts +1 -4
- package/types/x-modules/identifier-results/store/index.d.ts.map +1 -1
- package/types/x-modules/next-queries/components/next-queries-list.vue.d.ts +1 -0
- package/types/x-modules/next-queries/components/next-queries-list.vue.d.ts.map +1 -1
- package/types/x-modules/search/store/actions/fetch-and-save-search-response.action.d.ts.map +1 -1
- package/types/x-modules/search/store/actions/index.d.ts +8 -0
- package/types/x-modules/search/store/actions/index.d.ts.map +1 -0
- package/types/x-modules/search/store/actions/save-search-response.action.d.ts +12 -0
- package/types/x-modules/search/store/actions/save-search-response.action.d.ts.map +1 -0
- package/types/x-modules/search/store/getters/index.d.ts +3 -0
- package/types/x-modules/search/store/getters/index.d.ts.map +1 -0
- package/types/x-modules/search/store/index.d.ts +2 -4
- package/types/x-modules/search/store/index.d.ts.map +1 -1
- package/types/x-modules/search/store/module.d.ts.map +1 -1
- package/types/x-modules/search/store/types.d.ts +6 -0
- package/types/x-modules/search/store/types.d.ts.map +1 -1
- package/types/x-modules/search/wiring.d.ts +2 -8
- package/types/x-modules/search/wiring.d.ts.map +1 -1
- package/types/x-modules/url/components/url-handler.vue.d.ts.map +1 -1
- package/docs/API-reference/api/x-components.setpagesize.md +0 -13
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,28 @@
|
|
|
3
3
|
All notable changes to this project will be documented in this file. See
|
|
4
4
|
[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
5
5
|
|
|
6
|
+
## [3.0.0-alpha.89](https://github.com/empathyco/x/compare/@empathyco/x-components@3.0.0-alpha.88...@empathyco/x-components@3.0.0-alpha.89) (2022-04-29)
|
|
7
|
+
|
|
8
|
+
### Build System
|
|
9
|
+
|
|
10
|
+
- **deps:** update eslint-plugin dependencies (#447)
|
|
11
|
+
([51d60f0](https://github.com/empathyco/x/commit/51d60f0e11fa9667a784bbdb10ba1f39159b382f)),
|
|
12
|
+
closes [EX-5383](https://searchbroker.atlassian.net/browse/EX-5383)
|
|
13
|
+
|
|
14
|
+
# Change Log
|
|
15
|
+
|
|
16
|
+
All notable changes to this project will be documented in this file. See
|
|
17
|
+
[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
18
|
+
|
|
19
|
+
## [3.0.0-alpha.88](https://github.com/empathyco/x/compare/@empathyco/x-components@3.0.0-alpha.87...@empathyco/x-components@3.0.0-alpha.88) (2022-04-29)
|
|
20
|
+
|
|
21
|
+
**Note:** Version bump only for package @empathyco/x-components
|
|
22
|
+
|
|
23
|
+
# Change Log
|
|
24
|
+
|
|
25
|
+
All notable changes to this project will be documented in this file. See
|
|
26
|
+
[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
|
|
27
|
+
|
|
6
28
|
## [3.0.0-alpha.86](https://github.com/empathyco/x/compare/@empathyco/x-components@3.0.0-alpha.85...@empathyco/x-components@3.0.0-alpha.86) (2022-04-19)
|
|
7
29
|
|
|
8
30
|
### Features
|
package/core/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
|
|
@@ -218,20 +218,6 @@
|
|
|
218
218
|
--x-color-border-button-ghost: transparent;
|
|
219
219
|
--x-color-text-button-ghost: var(--x-color-base-lead);
|
|
220
220
|
}
|
|
221
|
-
.x-button--pill.x-button,
|
|
222
|
-
.x-button--pill .x-button {
|
|
223
|
-
--x-size-border-radius-button-default: var(--x-size-border-radius-button-pill);
|
|
224
|
-
--x-size-border-radius-top-left-button-default: var(--x-size-border-radius-top-left-button-pill);
|
|
225
|
-
--x-size-border-radius-top-right-button-default: var(
|
|
226
|
-
--x-size-border-radius-top-right-button-pill
|
|
227
|
-
);
|
|
228
|
-
--x-size-border-radius-bottom-right-button-default: var(
|
|
229
|
-
--x-size-border-radius-bottom-right-button-pill
|
|
230
|
-
);
|
|
231
|
-
--x-size-border-radius-bottom-left-button-default: var(
|
|
232
|
-
--x-size-border-radius-bottom-left-button-pill
|
|
233
|
-
);
|
|
234
|
-
}
|
|
235
221
|
:root {
|
|
236
222
|
--x-size-border-radius-button-pill: var(--x-size-border-radius-base-pill);
|
|
237
223
|
--x-size-border-radius-top-left-button-pill: var(--x-size-border-radius-button-pill);
|
|
@@ -2725,6 +2711,27 @@
|
|
|
2725
2711
|
.x-message > p {
|
|
2726
2712
|
margin: 0;
|
|
2727
2713
|
}
|
|
2714
|
+
:root {
|
|
2715
|
+
--x-string-justify-message-default: center;
|
|
2716
|
+
--x-size-gap-message-default: var(--x-size-base-03);
|
|
2717
|
+
--x-size-padding-message-default: var(--x-size-base-06);
|
|
2718
|
+
--x-color-background-message-default: var(--x-color-base-neutral-95);
|
|
2719
|
+
--x-color-border-message-default: var(--x-color-background-message-default);
|
|
2720
|
+
--x-color-text-message-default: var(--x-color-text-default);
|
|
2721
|
+
--x-size-border-radius-message-default: var(--x-size-border-radius-base-m);
|
|
2722
|
+
--x-size-border-radius-top-left-message-default: var(--x-size-border-radius-message-default);
|
|
2723
|
+
--x-size-border-radius-top-right-message-default: var(--x-size-border-radius-message-default);
|
|
2724
|
+
--x-size-border-radius-bottom-right-message-default: var(--x-size-border-radius-message-default);
|
|
2725
|
+
--x-size-border-radius-bottom-left-message-default: var(--x-size-border-radius-message-default);
|
|
2726
|
+
--x-size-border-width-message-default: var(--x-size-border-width-base);
|
|
2727
|
+
--x-size-border-width-top-message-default: var(--x-size-border-width-message-default);
|
|
2728
|
+
--x-size-border-width-right-message-default: var(--x-size-border-width-message-default);
|
|
2729
|
+
--x-size-border-width-bottom-message-default: var(--x-size-border-width-message-default);
|
|
2730
|
+
--x-size-border-width-left-message-default: var(--x-size-border-width-message-default);
|
|
2731
|
+
--x-font-family-message-default: var(--x-font-family-title3);
|
|
2732
|
+
--x-size-font-message-default: var(--x-size-font-title3);
|
|
2733
|
+
--x-number-font-weight-message-default: var(--x-number-font-weight-title3);
|
|
2734
|
+
}
|
|
2728
2735
|
.x-option-list--bottom.x-option-list,
|
|
2729
2736
|
.x-option-list--bottom .x-option-list {
|
|
2730
2737
|
--x-color-text-option-list-button-default: var(--x-color-text-option-list-button-bottom);
|
|
@@ -7546,24 +7553,17 @@
|
|
|
7546
7553
|
text-transform: none;
|
|
7547
7554
|
}
|
|
7548
7555
|
|
|
7549
|
-
|
|
7550
|
-
|
|
7551
|
-
--x-size-
|
|
7552
|
-
--x-size-
|
|
7553
|
-
--x-
|
|
7554
|
-
|
|
7555
|
-
|
|
7556
|
-
--x-size-border-radius-
|
|
7557
|
-
|
|
7558
|
-
|
|
7559
|
-
--x-size-border-radius-bottom-
|
|
7560
|
-
|
|
7561
|
-
|
|
7562
|
-
--x-size-border-width-top-message-default: var(--x-size-border-width-message-default);
|
|
7563
|
-
--x-size-border-width-right-message-default: var(--x-size-border-width-message-default);
|
|
7564
|
-
--x-size-border-width-bottom-message-default: var(--x-size-border-width-message-default);
|
|
7565
|
-
--x-size-border-width-left-message-default: var(--x-size-border-width-message-default);
|
|
7566
|
-
--x-font-family-message-default: var(--x-font-family-title3);
|
|
7567
|
-
--x-size-font-message-default: var(--x-size-font-title3);
|
|
7568
|
-
--x-number-font-weight-message-default: var(--x-number-font-weight-title3);
|
|
7556
|
+
.x-button--pill.x-button,
|
|
7557
|
+
.x-button--pill .x-button {
|
|
7558
|
+
--x-size-border-radius-button-default: var(--x-size-border-radius-button-pill);
|
|
7559
|
+
--x-size-border-radius-top-left-button-default: var(--x-size-border-radius-top-left-button-pill);
|
|
7560
|
+
--x-size-border-radius-top-right-button-default: var(
|
|
7561
|
+
--x-size-border-radius-top-right-button-pill
|
|
7562
|
+
);
|
|
7563
|
+
--x-size-border-radius-bottom-right-button-default: var(
|
|
7564
|
+
--x-size-border-radius-bottom-right-button-pill
|
|
7565
|
+
);
|
|
7566
|
+
--x-size-border-radius-bottom-left-button-default: var(
|
|
7567
|
+
--x-size-border-radius-bottom-left-button-pill
|
|
7568
|
+
);
|
|
7569
7569
|
}
|
|
@@ -16,13 +16,13 @@ export interface SearchResponse
|
|
|
16
16
|
|
|
17
17
|
| Property | Type | Description |
|
|
18
18
|
| --- | --- | --- |
|
|
19
|
-
| [banners](./x-adapter.searchresponse.banners.md) | Banner\[\] |
|
|
19
|
+
| [banners?](./x-adapter.searchresponse.banners.md) | Banner\[\] | <i>(Optional)</i> |
|
|
20
20
|
| [facets?](./x-adapter.searchresponse.facets.md) | Facet\[\] | <i>(Optional)</i> |
|
|
21
|
-
| [partialResults](./x-adapter.searchresponse.partialresults.md) | PartialResult\[\] |
|
|
22
|
-
| [promoteds](./x-adapter.searchresponse.promoteds.md) | Promoted\[\] |
|
|
21
|
+
| [partialResults?](./x-adapter.searchresponse.partialresults.md) | PartialResult\[\] | <i>(Optional)</i> |
|
|
22
|
+
| [promoteds?](./x-adapter.searchresponse.promoteds.md) | Promoted\[\] | <i>(Optional)</i> |
|
|
23
23
|
| [queryTagging](./x-adapter.searchresponse.querytagging.md) | TaggingInfo | |
|
|
24
|
-
| [redirections](./x-adapter.searchresponse.redirections.md) | Redirection\[\] |
|
|
24
|
+
| [redirections?](./x-adapter.searchresponse.redirections.md) | Redirection\[\] | <i>(Optional)</i> |
|
|
25
25
|
| [results](./x-adapter.searchresponse.results.md) | Result\[\] | |
|
|
26
|
-
| [spellcheck](./x-adapter.searchresponse.spellcheck.md) | string |
|
|
26
|
+
| [spellcheck?](./x-adapter.searchresponse.spellcheck.md) | string | <i>(Optional)</i> |
|
|
27
27
|
| [totalResults](./x-adapter.searchresponse.totalresults.md) | number | |
|
|
28
28
|
|
|
@@ -4,10 +4,10 @@
|
|
|
4
4
|
|
|
5
5
|
## increasePageAppendingResults variable
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Default implementation for the [SearchActions.increasePageAppendingResults()](./x-components.searchactions.increasepageappendingresults.md)<!-- -->.
|
|
8
8
|
|
|
9
9
|
<b>Signature:</b>
|
|
10
10
|
|
|
11
11
|
```typescript
|
|
12
|
-
increasePageAppendingResults:
|
|
12
|
+
increasePageAppendingResults: SearchXStoreModule['actions']['increasePageAppendingResults']
|
|
13
13
|
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [increasePageAppendingResultsWire](./x-components.increasepageappendingresultswire.md)
|
|
4
|
+
|
|
5
|
+
## increasePageAppendingResultsWire variable
|
|
6
|
+
|
|
7
|
+
Increases the current search state `page` by one.
|
|
8
|
+
|
|
9
|
+
<b>Signature:</b>
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
increasePageAppendingResultsWire: import("../../wiring/wiring.types").AnyWire
|
|
13
|
+
```
|
|
@@ -435,7 +435,8 @@ X-Components is a library usable everywhere not only for search experiences.
|
|
|
435
435
|
| [identifierHighlightRegexp](./x-components.identifierhighlightregexp.md) | Default implementation for the [IdentifierResultsGetters.identifierHighlightRegexp](./x-components.identifierresultsgetters.identifierhighlightregexp.md) getter. |
|
|
436
436
|
| [identifierResultsRequest](./x-components.identifierresultsrequest.md) | Default implementation for the [IdentifierResultsGetters.identifierResultsRequest](./x-components.identifierresultsgetters.identifierresultsrequest.md) getter. |
|
|
437
437
|
| [identifierResultsXModule](./x-components.identifierresultsxmodule.md) | IdentifierResults [XModule](./x-components.xmodule.md) implementation. This module is auto-registered as soon as you import any component from the <code>identifier-results</code> entry point. |
|
|
438
|
-
| [increasePageAppendingResults](./x-components.increasepageappendingresults.md) |
|
|
438
|
+
| [increasePageAppendingResults](./x-components.increasepageappendingresults.md) | Default implementation for the [SearchActions.increasePageAppendingResults()](./x-components.searchactions.increasepageappendingresults.md)<!-- -->. |
|
|
439
|
+
| [increasePageAppendingResultsWire](./x-components.increasepageappendingresultswire.md) | Increases the current search state <code>page</code> by one. |
|
|
439
440
|
| [infiniteScroll](./x-components.infinitescroll.md) | Custom Vue directive for infinite scroll.<!-- -->This directive uses the IntersectionObserver API to handle the intersection between the children and the scrollable container. The content of the children moves up on scroll and when it reaches the end the IntersectionObserver triggers that both elements are intersecting.<!-- -->How it works.<!-- -->As a summary, if the scroll reaches the end, the <code>vNode.context.onInfiniteScrollEnd</code> function implemented by the component which imports the directive, is executed. If you provide a margin in the directive options, this function is triggered when the scroll reaches the end minus that amount of pixels. A default margin of 200px is set.<!-- -->Usage.<!-- -->The directive has to be set in the target element. It can receive an argument which will be used to determine the scrollable container. Possible values: \* html: will set the <html> as the scrollable container. \* body: will set the <body> as the scrollable container. \* id: will set the DOM element with the provided id as the scrollable container.<!-- -->If no argument is provided the scrollable container fallbacks to the viewport. |
|
|
440
441
|
| [LightBulbOff](./x-components.lightbulboff.md) | |
|
|
441
442
|
| [LightBulbOn](./x-components.lightbulbon.md) | |
|
|
@@ -472,12 +473,15 @@ X-Components is a library usable everywhere not only for search experiences.
|
|
|
472
473
|
| [removeHistoryQuery](./x-components.removehistoryquery.md) | Removes a single history query from the history queries. |
|
|
473
474
|
| [resetAppending](./x-components.resetappending.md) | Resets the search state <code>isAppendingResults</code>. |
|
|
474
475
|
| [resetSpellcheckQuery](./x-components.resetspellcheckquery.md) | Resets the search state <code>spellcheckedQuery</code> to its initial value, an empty string. |
|
|
476
|
+
| [resetState](./x-components.resetstate.md) | Default implementation for the [SearchActions.resetState()](./x-components.searchactions.resetstate.md)<!-- -->. |
|
|
475
477
|
| [resetStateWire](./x-components.resetstatewire.md) | Batches state resets after [SearchGetters.request](./x-components.searchgetters.request.md) parameters update. |
|
|
476
478
|
| [sanitize](./x-components.sanitize.md) | Sanitize characters from a given string. |
|
|
479
|
+
| [saveIdentifierResultsOrigin](./x-components.saveidentifierresultsorigin.md) | Default implementation for the [IdentifierResultsActions.saveOrigin()](./x-components.identifierresultsactions.saveorigin.md)<!-- -->. |
|
|
477
480
|
| [saveIdentifierResultsOriginWire](./x-components.saveidentifierresultsoriginwire.md) | Sets the identifier results state <code>origin</code>. |
|
|
478
|
-
| [saveOrigin](./x-components.saveorigin.md) | Default implementation for the [IdentifierResultsActions.saveOrigin()](./x-components.identifierresultsactions.saveorigin.md)<!-- -->. |
|
|
479
481
|
| [saveOriginWire](./x-components.saveoriginwire.md) | Sets the search state <code>origin</code>. |
|
|
480
482
|
| [saveQuery](./x-components.savequery.md) | Default implementation for the [IdentifierResultsActions.saveQuery()](./x-components.identifierresultsactions.savequery.md)<!-- -->. |
|
|
483
|
+
| [saveSearchOrigin](./x-components.savesearchorigin.md) | Default implementation for the [SearchActions.saveOrigin()](./x-components.searchactions.saveorigin.md)<!-- -->. |
|
|
484
|
+
| [saveSearchResponse](./x-components.savesearchresponse.md) | Default implementation for the [SearchActions.saveSearchResponse()](./x-components.searchactions.savesearchresponse.md)<!-- -->. |
|
|
481
485
|
| [scrollXModule](./x-components.scrollxmodule.md) | Scroll [XModule](./x-components.xmodule.md) implementation. This module is auto-registered as soon as you import any component from the <code>empathize</code> entry point. |
|
|
482
486
|
| [searchBoxXModule](./x-components.searchboxxmodule.md) | SearchBox [XModule](./x-components.xmodule.md) implementation. This module is auto-registered as soon as you import any component from the <code>search-box</code> entry point. |
|
|
483
487
|
| [SearchIcon](./x-components.searchicon.md) | |
|
|
@@ -498,7 +502,6 @@ X-Components is a library usable everywhere not only for search experiences.
|
|
|
498
502
|
| [setName](./x-components.setname.md) | Sets the device of the [DeviceXModule](./x-components.devicexmodule.md)<!-- -->. |
|
|
499
503
|
| [setNextQueriesExtraParams](./x-components.setnextqueriesextraparams.md) | Sets the next queries state <code>params</code>. |
|
|
500
504
|
| [setNextQueriesQuery](./x-components.setnextqueriesquery.md) | Sets the next queries state <code>query</code>. |
|
|
501
|
-
| [setPageSize](./x-components.setpagesize.md) | Sets the search state <code>pageSize</code>. |
|
|
502
505
|
| [setParams](./x-components.setparams.md) | Sets the extra params of the url module. |
|
|
503
506
|
| [setPendingScrollToWire](./x-components.setpendingscrolltowire.md) | Saves the selector of the item that should be scrolled into the view. |
|
|
504
507
|
| [setPopularSearchesExtraParams](./x-components.setpopularsearchesextraparams.md) | Sets the popular searches state <code>params</code>. |
|
|
@@ -521,6 +524,7 @@ X-Components is a library usable everywhere not only for search experiences.
|
|
|
521
524
|
| [setSearchExtraParams](./x-components.setsearchextraparams.md) | Sets the search state <code>params</code>. |
|
|
522
525
|
| [setSearchPage](./x-components.setsearchpage.md) | Sets the search state <code>page</code>. |
|
|
523
526
|
| [setSearchQuery](./x-components.setsearchquery.md) | Sets the search state <code>query</code>. |
|
|
527
|
+
| [setSearchUrlParams](./x-components.setsearchurlparams.md) | Default implementation for the [SearchActions.setUrlParams()](./x-components.searchactions.seturlparams.md)<!-- -->. |
|
|
524
528
|
| [setSelectedFilters](./x-components.setselectedfilters.md) | Sets the search state <code>selectedFilters</code>. |
|
|
525
529
|
| [setSort](./x-components.setsort.md) | Sets the search state <code>sort</code>. |
|
|
526
530
|
| [setTaggingConfig](./x-components.settaggingconfig.md) | Sets the tagging config state. |
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [resetState](./x-components.resetstate.md)
|
|
4
|
+
|
|
5
|
+
## resetState variable
|
|
6
|
+
|
|
7
|
+
Default implementation for the [SearchActions.resetState()](./x-components.searchactions.resetstate.md)<!-- -->.
|
|
8
|
+
|
|
9
|
+
<b>Signature:</b>
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
resetState: SearchXStoreModule['actions']['resetState']
|
|
13
|
+
```
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
2
|
|
|
3
|
-
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [saveIdentifierResultsOrigin](./x-components.saveidentifierresultsorigin.md)
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## saveIdentifierResultsOrigin variable
|
|
6
6
|
|
|
7
7
|
Default implementation for the [IdentifierResultsActions.saveOrigin()](./x-components.identifierresultsactions.saveorigin.md)<!-- -->.
|
|
8
8
|
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [saveSearchOrigin](./x-components.savesearchorigin.md)
|
|
4
|
+
|
|
5
|
+
## saveSearchOrigin variable
|
|
6
|
+
|
|
7
|
+
Default implementation for the [SearchActions.saveOrigin()](./x-components.searchactions.saveorigin.md)<!-- -->.
|
|
8
|
+
|
|
9
|
+
<b>Signature:</b>
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
saveOrigin: SearchXStoreModule['actions']['saveOrigin']
|
|
13
|
+
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [saveSearchResponse](./x-components.savesearchresponse.md)
|
|
4
|
+
|
|
5
|
+
## saveSearchResponse variable
|
|
6
|
+
|
|
7
|
+
Default implementation for the [SearchActions.saveSearchResponse()](./x-components.searchactions.savesearchresponse.md)<!-- -->.
|
|
8
|
+
|
|
9
|
+
<b>Signature:</b>
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
saveSearchResponse: SearchXStoreModule['actions']['saveSearchResponse']
|
|
13
|
+
```
|
|
@@ -22,5 +22,6 @@ export interface SearchActions
|
|
|
22
22
|
| [increasePageAppendingResults()](./x-components.searchactions.increasepageappendingresults.md) | Checks if there are more pages of results to load. If there are, then increases the page number in state and set to <code>true</code> the [SearchState.isAppendResults](./x-components.searchstate.isappendresults.md) flag. |
|
|
23
23
|
| [resetState(watchedRequest)](./x-components.searchactions.resetstate.md) | Batches state resets in a single action after [SearchGetters.request](./x-components.searchgetters.request.md) parameters update. |
|
|
24
24
|
| [saveOrigin(originInit)](./x-components.searchactions.saveorigin.md) | Creates a [QueryOrigin](./x-components.queryorigin.md) and saves it. |
|
|
25
|
+
| [saveSearchResponse(response)](./x-components.searchactions.savesearchresponse.md) | Saves the [SearchResponse](./x-adapter.searchresponse.md)<!-- -->. |
|
|
25
26
|
| [setUrlParams(urlParams)](./x-components.searchactions.seturlparams.md) | Checks if the url has params on it and then updates the state with these values. |
|
|
26
27
|
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [SearchActions](./x-components.searchactions.md) > [saveSearchResponse](./x-components.searchactions.savesearchresponse.md)
|
|
4
|
+
|
|
5
|
+
## SearchActions.saveSearchResponse() method
|
|
6
|
+
|
|
7
|
+
Saves the [SearchResponse](./x-adapter.searchresponse.md)<!-- -->.
|
|
8
|
+
|
|
9
|
+
<b>Signature:</b>
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
saveSearchResponse(response: SearchResponse): void;
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Parameters
|
|
16
|
+
|
|
17
|
+
| Parameter | Type | Description |
|
|
18
|
+
| --- | --- | --- |
|
|
19
|
+
| response | SearchResponse | The [SearchResponse](./x-adapter.searchresponse.md) to save. |
|
|
20
|
+
|
|
21
|
+
<b>Returns:</b>
|
|
22
|
+
|
|
23
|
+
void
|
|
24
|
+
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [setSearchUrlParams](./x-components.setsearchurlparams.md)
|
|
4
|
+
|
|
5
|
+
## setSearchUrlParams variable
|
|
6
|
+
|
|
7
|
+
Default implementation for the [SearchActions.setUrlParams()](./x-components.searchactions.seturlparams.md)<!-- -->.
|
|
8
|
+
|
|
9
|
+
<b>Signature:</b>
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
setUrlParams: SearchXStoreModule['actions']['setUrlParams']
|
|
13
|
+
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
|
|
2
|
+
|
|
3
|
+
[Home](./index.md) > [@empathyco/x-components](./x-components.md) > [SnippetConfigExtraParams](./x-components.snippetconfigextraparams.md) > [excludedExtraParams](./x-components.snippetconfigextraparams.excludedextraparams.md)
|
|
4
|
+
|
|
5
|
+
## SnippetConfigExtraParams.excludedExtraParams property
|
|
6
|
+
|
|
7
|
+
Collection of properties from the snippet config to exclude from the extra params object.
|
|
8
|
+
|
|
9
|
+
<b>Signature:</b>
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
protected excludedExtraParams: Array<keyof SnippetConfig>;
|
|
13
|
+
```
|
|
@@ -17,5 +17,6 @@ export default class SnippetConfigExtraParams extends Vue
|
|
|
17
17
|
|
|
18
18
|
| Property | Modifiers | Type | Description |
|
|
19
19
|
| --- | --- | --- | --- |
|
|
20
|
+
| [excludedExtraParams](./x-components.snippetconfigextraparams.excludedextraparams.md) | | Array<keyof [SnippetConfig](./x-components.snippetconfig.md)<!-- -->> | Collection of properties from the snippet config to exclude from the extra params object. |
|
|
20
21
|
| [values?](./x-components.snippetconfigextraparams.values.md) | | Dictionary<unknown> | <i>(Optional)</i> A Dictionary where the keys are the extra param names and its values. |
|
|
21
22
|
|
package/docs/API-reference/components/extra-params/x-components.snippet-config-extra-params.md
CHANGED
|
@@ -11,9 +11,10 @@ objects of every x-module.
|
|
|
11
11
|
|
|
12
12
|
## Props
|
|
13
13
|
|
|
14
|
-
| Name
|
|
15
|
-
|
|
|
16
|
-
| <code>values</code>
|
|
14
|
+
| Name | Description | Type | Default |
|
|
15
|
+
| -------------------------------- | ---------------------------------------------------------------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
16
|
+
| <code>values</code> | A Dictionary where the keys are the extra param names and its values. | <code>Dictionary</code> | <code></code> |
|
|
17
|
+
| <code>excludedExtraParams</code> | Collection of properties from the snippet config to exclude from the<br />extra params object. | <code>Array</code> | <code>(): Array<keyof SnippetConfig> => [<br /> 'callbacks',<br /> 'productId',<br /> 'instance',<br /> 'lang',<br /> 'searchLang',<br /> 'consent',<br /> 'documentDirection',<br /> 'currency'<br />]</code> |
|
|
17
18
|
|
|
18
19
|
## See it in action
|
|
19
20
|
|
|
@@ -6,13 +6,15 @@ tags:
|
|
|
6
6
|
- use x components
|
|
7
7
|
- x components
|
|
8
8
|
- interface x
|
|
9
|
+
- x archetype
|
|
10
|
+
- archetype
|
|
9
11
|
---
|
|
10
12
|
|
|
11
13
|
::: slot left-intro-column
|
|
12
14
|
|
|
13
|
-
## Getting started with Interface X
|
|
15
|
+
## Getting started with Interface X
|
|
14
16
|
|
|
15
|
-
Start building your search and discovery experience
|
|
17
|
+
Start building your search and discovery experience:
|
|
16
18
|
|
|
17
19
|
:::
|
|
18
20
|
|
|
@@ -22,12 +24,12 @@ Start building your search and discovery experience in a few simple steps:
|
|
|
22
24
|
|
|
23
25
|
:::
|
|
24
26
|
|
|
25
|
-
- **Discover
|
|
26
|
-
|
|
27
|
+
- **Discover the [Interface X ecosystem](#the-interface-x-ecosystem)** and how Interface X
|
|
28
|
+
works.
|
|
29
|
+
- **[Develop using Interface X](#develop-with-interface-x)** inside your project.
|
|
27
30
|
- **[Integrate the Interface X Archetype](#integrate-interface-x-archetype)** in your store web
|
|
28
31
|
application.
|
|
29
|
-
- **[
|
|
30
|
-
- **[How to use and configure the Interface X Components](#how-to-use-and-configure-the-interface-x-components)**
|
|
32
|
+
- **[Use and configure the Interface X Components](#use-and-configure-the-interface-x-components)**
|
|
31
33
|
in your project.
|
|
32
34
|
|
|
33
35
|
<!-- 3. Style your UI. 4. Translate your search experience-->
|
|
@@ -43,25 +45,15 @@ numerous components to choose from, and the catalog evolves quickly with new exp
|
|
|
43
45
|
Check out the **[open source project in GitHub](https://github.com/empathyco/x)**.
|
|
44
46
|
|
|
45
47
|
Interested in learning more about how Interface X works? Discover more about its
|
|
46
|
-
**[architecture](x-architecture
|
|
47
|
-
|
|
48
|
-
## Integrate Interface X Archetype
|
|
49
|
-
|
|
50
|
-
Once you have finished developing or extending your search interface using the
|
|
51
|
-
Interface X Archetype project you will probably want to integrate it into your current
|
|
52
|
-
store. The integration of an existing Archetype into your project is pretty straightforward. You
|
|
53
|
-
will need to load the generated Javascript into your website and initialise it.
|
|
54
|
-
|
|
55
|
-
To start integrating an existent Archetype into your project please visit
|
|
56
|
-
[extended guide about Archetype integration](web-archetype-integration-guide.md).
|
|
48
|
+
**[architecture](web-x-architecture.md)**.
|
|
57
49
|
|
|
58
50
|
## Develop with Interface X
|
|
59
51
|
|
|
60
|
-
You can use the Interface
|
|
52
|
+
You can use the Interface X in a project in two ways:
|
|
61
53
|
|
|
62
54
|
- using the separate **Interface X Archetype** project, an out-of-the-box project with all
|
|
63
|
-
you need to get up and running fast
|
|
64
|
-
-
|
|
55
|
+
you need to get up and running fast
|
|
56
|
+
- importing the individual **Interface X Components** library in your Vue project for a
|
|
65
57
|
more custom approach.
|
|
66
58
|
|
|
67
59
|
::: note
|
|
@@ -73,9 +65,9 @@ You can use Empathy Search API, Elasticsearch, or Solr endpoints with both appro
|
|
|
73
65
|
##### Develop via Interface X Archetype
|
|
74
66
|
|
|
75
67
|
The **[Interface X Archetype](https://github.com/empathyco/x-archetype)** project is the
|
|
76
|
-
perfect combination of all the existing X Components.
|
|
77
|
-
|
|
78
|
-
perfect solution for most cases
|
|
68
|
+
perfect combination of all the existing X Components. It allows you to ramp up quickly with an
|
|
69
|
+
already working search and discovery experience, instead of starting from a completely blank canvas.
|
|
70
|
+
This is the perfect solution for most cases as you can use it as a springboard to:
|
|
79
71
|
|
|
80
72
|
- Change the default styles for styles that match your application through design tokens or custom
|
|
81
73
|
CSS.
|
|
@@ -86,33 +78,46 @@ perfect solution for most cases. But don’t worry! It’s still super flexible!
|
|
|
86
78
|
- Create new components or modify the existing ones.
|
|
87
79
|
|
|
88
80
|
To start developing the X Archetype project, see
|
|
89
|
-
**[Develop
|
|
81
|
+
**[Develop using Interface X Archetype](web-archetype-development-guide.md)**.
|
|
90
82
|
|
|
91
83
|
##### Develop via Interface X Components library
|
|
92
84
|
|
|
93
85
|
This is the more deep and flexible use of the
|
|
94
|
-
**[Interface
|
|
86
|
+
**[Interface X Components library](https://github.com/empathyco/x/tree/main/packages/x-components)**,
|
|
95
87
|
allowing you to import any components you desire into your Vue application. It lets you connect,
|
|
96
88
|
customize, extend, style, or even create new components without any limitations. This is the way to
|
|
97
|
-
go if you like to look under the hood
|
|
89
|
+
go if you like to look under the hood.
|
|
98
90
|
|
|
99
91
|
- Mix and match with other Vue components.
|
|
100
92
|
- Implement in Vue or React projects.
|
|
101
93
|
- Extend component behavior with your own development.
|
|
102
94
|
- Determine styles using design tokens or custom CSS.
|
|
103
95
|
|
|
104
|
-
To get started with the X
|
|
105
|
-
**[Develop using Interface
|
|
96
|
+
To get started with the X Components library, check out
|
|
97
|
+
**[Develop using Interface X Components library](web-x-components-development-guide.md)**.
|
|
98
|
+
|
|
99
|
+
## Integrate Interface X Archetype
|
|
100
|
+
|
|
101
|
+
With the **[Interface X Archetype](https://github.com/empathyco/x-archetype)** you have an
|
|
102
|
+
isolated search layer up and running in your store web application in a matter of minutes.
|
|
103
|
+
|
|
104
|
+
To integrate the Interface X Archetype into your project, just **load** the generated
|
|
105
|
+
JavaScript file into your website and **initialize** it.
|
|
106
|
+
|
|
107
|
+
Check out
|
|
108
|
+
**[Integrate InterfaceX Archetype into an existing website](web-archetype-integration-guide.md)**,
|
|
109
|
+
to integrate the X Archetype project.
|
|
110
|
+
|
|
111
|
+
## Use and configure the Interface X Components
|
|
106
112
|
|
|
107
|
-
|
|
113
|
+
To use the Interface X Components, just **import** and **register** the component,
|
|
114
|
+
**include** it in your template, and you’re ready to go.
|
|
108
115
|
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
multiple configuration parameters to play around with, allowing you greater flexibility over the
|
|
112
|
-
experience.
|
|
116
|
+
What’s more, each component offers multiple configuration parameters to play around with, giving you
|
|
117
|
+
greater flexibility over the experience.
|
|
113
118
|
|
|
114
119
|
Unsure how to start? Check out
|
|
115
|
-
**[How to use
|
|
120
|
+
**[How to use and configure Interface X Components in your project](web-how-to-use-x-components-guide.md)**.
|
|
116
121
|
|
|
117
122
|
<!--
|
|
118
123
|
## Style your UI
|