@salesforcedevs/docs-components 1.3.194-alpha.0 → 1.3.194-search-alpha
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/package.json +1 -1
- package/src/modules/doc/amfReference/amfReference.ts +43 -32
- package/src/modules/doc/content/content.css +1 -1
- package/src/modules/doc/contentLayout/contentLayout.ts +15 -13
- package/src/modules/doc/header/header.css +1 -0
- package/src/modules/doc/headingAnchor/headingAnchor.css +2 -2
- package/src/modules/doc/headingContent/headingContent.css +1 -1
- package/src/modules/doc/sprigSurvey/sprigSurvey.scoped.css +1 -1
- package/src/modules/doc/xmlContent/xmlContent.ts +12 -25
- package/src/modules/docHelpers/amfStyle/amfStyle.css +6 -6
- package/src/modules/docHelpers/status/status.css +1 -1
package/package.json
CHANGED
|
@@ -185,12 +185,10 @@ export default class AmfReference extends LightningElement {
|
|
|
185
185
|
constructor() {
|
|
186
186
|
super();
|
|
187
187
|
|
|
188
|
-
this._boundOnApiNavigationChanged =
|
|
189
|
-
this
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
this
|
|
193
|
-
);
|
|
188
|
+
this._boundOnApiNavigationChanged =
|
|
189
|
+
this.onApiNavigationChanged.bind(this);
|
|
190
|
+
this._boundUpdateSelectedItemFromUrlQuery =
|
|
191
|
+
this.updateSelectedItemFromUrlQuery.bind(this);
|
|
194
192
|
}
|
|
195
193
|
|
|
196
194
|
connectedCallback(): void {
|
|
@@ -246,9 +244,8 @@ export default class AmfReference extends LightningElement {
|
|
|
246
244
|
const updatedReferenceId =
|
|
247
245
|
oldReferenceIdNewReferenceIdMap[referenceId];
|
|
248
246
|
const newReferenceId = updatedReferenceId || referenceId;
|
|
249
|
-
const referenceItemConfig =
|
|
250
|
-
newReferenceId
|
|
251
|
-
);
|
|
247
|
+
const referenceItemConfig =
|
|
248
|
+
this.getAmfConfigWithId(newReferenceId);
|
|
252
249
|
if (referenceItemConfig) {
|
|
253
250
|
hashBasedRedirectUrl = `${referenceItemConfig.href}?meta=${encodedMeta}`;
|
|
254
251
|
}
|
|
@@ -328,9 +325,8 @@ export default class AmfReference extends LightningElement {
|
|
|
328
325
|
for (let i = 0; i < allVersions.length; i++) {
|
|
329
326
|
const versionItem = allVersions[i];
|
|
330
327
|
const referenceLink = versionItem.link.href;
|
|
331
|
-
const referenceId =
|
|
332
|
-
referenceLink
|
|
333
|
-
);
|
|
328
|
+
const referenceId =
|
|
329
|
+
this.getReferenceIdFromUrl(referenceLink);
|
|
334
330
|
if (this._currentReferenceId === referenceId) {
|
|
335
331
|
// This is to navigate to respective topic in the changed version
|
|
336
332
|
versionItem.link.href = `${referenceLink}/${currentRefMeta}`;
|
|
@@ -844,9 +840,8 @@ export default class AmfReference extends LightningElement {
|
|
|
844
840
|
this._currentReferenceId
|
|
845
841
|
);
|
|
846
842
|
if (specBasedReference) {
|
|
847
|
-
const currentMeta:
|
|
848
|
-
|
|
849
|
-
| undefined = this.getReferenceMetaInfo(window.location.href);
|
|
843
|
+
const currentMeta: RouteMeta | undefined =
|
|
844
|
+
this.getReferenceMetaInfo(window.location.href);
|
|
850
845
|
const metadata =
|
|
851
846
|
currentMeta && this.getMetadataByUrlQuery(currentMeta);
|
|
852
847
|
if (metadata) {
|
|
@@ -1166,7 +1161,7 @@ export default class AmfReference extends LightningElement {
|
|
|
1166
1161
|
selectedItemMetaData.parentReferencePath,
|
|
1167
1162
|
selectedItemMetaData.meta
|
|
1168
1163
|
);
|
|
1169
|
-
this.
|
|
1164
|
+
this.updateTags(selectedItemMetaData.navTitle);
|
|
1170
1165
|
}
|
|
1171
1166
|
});
|
|
1172
1167
|
} else {
|
|
@@ -1272,18 +1267,16 @@ export default class AmfReference extends LightningElement {
|
|
|
1272
1267
|
}
|
|
1273
1268
|
if (!isRedirecting) {
|
|
1274
1269
|
const currentReferenceUrl = window.location.href;
|
|
1275
|
-
const referenceMeta =
|
|
1276
|
-
currentReferenceUrl
|
|
1277
|
-
|
|
1278
|
-
|
|
1279
|
-
currentReferenceUrl
|
|
1280
|
-
);
|
|
1270
|
+
const referenceMeta =
|
|
1271
|
+
this.getMarkdownReferenceMeta(currentReferenceUrl);
|
|
1272
|
+
const selectedItemRefId =
|
|
1273
|
+
this.getReferenceIdFromUrl(currentReferenceUrl);
|
|
1281
1274
|
const referenceDetails = this.getRefDetailsForGivenTopicMeta(
|
|
1282
1275
|
selectedItemRefId,
|
|
1283
1276
|
referenceMeta
|
|
1284
1277
|
);
|
|
1285
1278
|
if (referenceDetails) {
|
|
1286
|
-
this.
|
|
1279
|
+
this.updateTags(referenceDetails.topicTitle);
|
|
1287
1280
|
}
|
|
1288
1281
|
|
|
1289
1282
|
this.versions = this.getVersions();
|
|
@@ -1311,22 +1304,41 @@ export default class AmfReference extends LightningElement {
|
|
|
1311
1304
|
this.showVersionBanner = false;
|
|
1312
1305
|
}
|
|
1313
1306
|
|
|
1314
|
-
private
|
|
1307
|
+
private updateTags(navTitle = ""): void {
|
|
1308
|
+
if (!navTitle) {
|
|
1309
|
+
return;
|
|
1310
|
+
}
|
|
1311
|
+
|
|
1315
1312
|
// this is required to update the nav title meta tag.
|
|
1316
1313
|
// eslint-disable-next-line @lwc/lwc/no-document-query
|
|
1317
1314
|
const metaNavTitle = document.querySelector('meta[name="nav-title"]');
|
|
1318
|
-
|
|
1315
|
+
// eslint-disable-next-line @lwc/lwc/no-document-query
|
|
1316
|
+
const titleTag = document.querySelector("title");
|
|
1317
|
+
if (metaNavTitle) {
|
|
1319
1318
|
metaNavTitle.setAttribute("content", navTitle);
|
|
1320
1319
|
}
|
|
1320
|
+
|
|
1321
|
+
if (titleTag) {
|
|
1322
|
+
let titleTagValue = titleTag.textContent;
|
|
1323
|
+
const tagValues: string[] = titleTagValue?.split(" | ");
|
|
1324
|
+
if (tagValues) {
|
|
1325
|
+
if (tagValues.length <= 3) {
|
|
1326
|
+
titleTagValue = navTitle + " | " + titleTagValue;
|
|
1327
|
+
} else {
|
|
1328
|
+
tagValues[0] = navTitle;
|
|
1329
|
+
titleTagValue = tagValues.join(" | ");
|
|
1330
|
+
}
|
|
1331
|
+
}
|
|
1332
|
+
titleTag.textContent = titleTagValue;
|
|
1333
|
+
}
|
|
1321
1334
|
}
|
|
1322
1335
|
|
|
1323
1336
|
onNavSelect(event: CustomEvent): void {
|
|
1324
1337
|
const name = event.detail.name;
|
|
1325
1338
|
if (name) {
|
|
1326
1339
|
const urlReferenceId = this.getReferenceIdFromUrl(name);
|
|
1327
|
-
const specBasedReference =
|
|
1328
|
-
urlReferenceId
|
|
1329
|
-
);
|
|
1340
|
+
const specBasedReference =
|
|
1341
|
+
this.isSpecBasedReference(urlReferenceId);
|
|
1330
1342
|
if (specBasedReference) {
|
|
1331
1343
|
const metaVal = this.getMetaFromUrl(name);
|
|
1332
1344
|
const currentSelectedMeta = this.selectedTopic
|
|
@@ -1361,7 +1373,7 @@ export default class AmfReference extends LightningElement {
|
|
|
1361
1373
|
this.coveoAnalyticsToken
|
|
1362
1374
|
);
|
|
1363
1375
|
this.updateUrlWithSelected(parentReferencePath, metaVal);
|
|
1364
|
-
this.
|
|
1376
|
+
this.updateTags(metadata.navTitle);
|
|
1365
1377
|
} else {
|
|
1366
1378
|
if (this.isParentReferencePath(name)) {
|
|
1367
1379
|
this.loadNewReferenceItem(name);
|
|
@@ -1381,9 +1393,8 @@ export default class AmfReference extends LightningElement {
|
|
|
1381
1393
|
const currentReferenceId = this.getReferenceIdFromUrl(currentUrl);
|
|
1382
1394
|
//No need to do anything if user is expanding currently selected reference
|
|
1383
1395
|
if (referenceId !== currentReferenceId) {
|
|
1384
|
-
const isSpecBasedReference =
|
|
1385
|
-
referenceId
|
|
1386
|
-
);
|
|
1396
|
+
const isSpecBasedReference =
|
|
1397
|
+
this.isSpecBasedReference(referenceId);
|
|
1387
1398
|
if (isSpecBasedReference) {
|
|
1388
1399
|
// Perform functionality same as item selection
|
|
1389
1400
|
this.onNavSelect(event);
|
|
@@ -207,9 +207,9 @@ export default class ContentLayout extends LightningElement {
|
|
|
207
207
|
".sticky-doc-header"
|
|
208
208
|
) as HTMLElement;
|
|
209
209
|
|
|
210
|
-
const docPhaseEl = (
|
|
211
|
-
"[name=doc-phase]"
|
|
212
|
-
)
|
|
210
|
+
const docPhaseEl = (
|
|
211
|
+
this.template.querySelector("[name=doc-phase]")! as any
|
|
212
|
+
).assignedElements()[0] as HTMLSlotElement;
|
|
213
213
|
|
|
214
214
|
if (!sidebarEl || !globalNavEl || !contextNavEl || !docHeaderEl) {
|
|
215
215
|
console.warn("One or more required elements are missing.");
|
|
@@ -259,9 +259,8 @@ export default class ContentLayout extends LightningElement {
|
|
|
259
259
|
});
|
|
260
260
|
|
|
261
261
|
// Adjust right nav bar position when doc phase is present
|
|
262
|
-
const rightNavBarEl =
|
|
263
|
-
".right-nav-bar"
|
|
264
|
-
);
|
|
262
|
+
const rightNavBarEl =
|
|
263
|
+
this.template.querySelector(".right-nav-bar");
|
|
265
264
|
|
|
266
265
|
if (rightNavBarEl) {
|
|
267
266
|
rightNavBarEl.style.top = `${
|
|
@@ -323,14 +322,17 @@ export default class ContentLayout extends LightningElement {
|
|
|
323
322
|
};
|
|
324
323
|
|
|
325
324
|
onSlotChange(event: Event): void {
|
|
326
|
-
const slotElements = (
|
|
325
|
+
const slotElements = (
|
|
326
|
+
event.target as HTMLSlotElement
|
|
327
|
+
).assignedElements();
|
|
327
328
|
|
|
328
329
|
if (slotElements.length) {
|
|
329
330
|
this.contentLoaded = true;
|
|
330
331
|
const slotContentElement = slotElements[0];
|
|
331
|
-
const headingElements =
|
|
332
|
-
|
|
333
|
-
|
|
332
|
+
const headingElements =
|
|
333
|
+
slotContentElement.ownerDocument?.getElementsByTagName(
|
|
334
|
+
TOC_HEADER_TAG
|
|
335
|
+
);
|
|
334
336
|
|
|
335
337
|
for (const headingElement of headingElements as any) {
|
|
336
338
|
// Sometimes elements hash is not being set when slot content is wrapped with div
|
|
@@ -390,9 +392,9 @@ export default class ContentLayout extends LightningElement {
|
|
|
390
392
|
globalNavEl?.offsetHeight +
|
|
391
393
|
contextNavEl?.offsetHeight;
|
|
392
394
|
|
|
393
|
-
const docPhaseEl = (
|
|
394
|
-
"[name=doc-phase]"
|
|
395
|
-
)
|
|
395
|
+
const docPhaseEl = (
|
|
396
|
+
this.template.querySelector("[name=doc-phase]")! as any
|
|
397
|
+
).assignedElements()[0] as HTMLSlotElement;
|
|
396
398
|
|
|
397
399
|
const offset = docPhaseEl
|
|
398
400
|
? headerHeight + docPhaseEl.offsetHeight
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
button {
|
|
4
4
|
opacity: 0;
|
|
5
|
-
color: rgb(11 92 171);
|
|
5
|
+
color: rgb(11, 92, 171);
|
|
6
6
|
}
|
|
7
7
|
|
|
8
8
|
button:hover {
|
|
@@ -17,7 +17,7 @@ button:focus {
|
|
|
17
17
|
|
|
18
18
|
button:focus-visible {
|
|
19
19
|
border-radius: 4px;
|
|
20
|
-
border: 2px solid rgb(11 92 171);
|
|
20
|
+
border: 2px solid rgb(11, 92, 171);
|
|
21
21
|
}
|
|
22
22
|
|
|
23
23
|
.icon-wrapper {
|
|
@@ -252,14 +252,11 @@ export default class DocXmlContent extends LightningElementWithState<{
|
|
|
252
252
|
}
|
|
253
253
|
|
|
254
254
|
private get coveoAdvancedQueryConfig(): CoveoAdvancedQueryXMLConfig {
|
|
255
|
-
const config: {
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
locale: this.languageId,
|
|
261
|
-
topicid: this.deliverable
|
|
262
|
-
};
|
|
255
|
+
const config: { locale?: string; topicid?: string; version?: string } =
|
|
256
|
+
{
|
|
257
|
+
locale: this.languageId,
|
|
258
|
+
topicid: this.deliverable
|
|
259
|
+
};
|
|
263
260
|
|
|
264
261
|
if (this.releaseVersionId && this.releaseVersionId !== "noversion") {
|
|
265
262
|
config.version = this.releaseVersionId;
|
|
@@ -414,12 +411,8 @@ export default class DocXmlContent extends LightningElementWithState<{
|
|
|
414
411
|
}
|
|
415
412
|
|
|
416
413
|
getReferenceFromUrl(): PageReference {
|
|
417
|
-
const [
|
|
418
|
-
|
|
419
|
-
docId,
|
|
420
|
-
deliverable,
|
|
421
|
-
contentDocumentId
|
|
422
|
-
] = window.location.pathname.substr(1).split("/");
|
|
414
|
+
const [page, docId, deliverable, contentDocumentId] =
|
|
415
|
+
window.location.pathname.substr(1).split("/");
|
|
423
416
|
|
|
424
417
|
const { origin: domain, hash, search } = window.location;
|
|
425
418
|
|
|
@@ -581,20 +574,14 @@ export default class DocXmlContent extends LightningElementWithState<{
|
|
|
581
574
|
}
|
|
582
575
|
|
|
583
576
|
private updateSearchInput(searchParam: string): void {
|
|
584
|
-
(
|
|
585
|
-
"doc-content-layout"
|
|
586
|
-
)
|
|
577
|
+
(
|
|
578
|
+
this.template.querySelector("doc-content-layout") as any
|
|
579
|
+
)?.setSidebarInputValue(searchParam);
|
|
587
580
|
}
|
|
588
581
|
|
|
589
582
|
private pageReferenceToString(reference: PageReference): string {
|
|
590
|
-
const {
|
|
591
|
-
|
|
592
|
-
docId,
|
|
593
|
-
deliverable,
|
|
594
|
-
contentDocumentId,
|
|
595
|
-
hash,
|
|
596
|
-
search
|
|
597
|
-
} = reference;
|
|
583
|
+
const { page, docId, deliverable, contentDocumentId, hash, search } =
|
|
584
|
+
reference;
|
|
598
585
|
return `/${page}/${docId}/${deliverable}/${contentDocumentId}${this.normalizeSearch(
|
|
599
586
|
search!
|
|
600
587
|
)}${this.normalizeHash(hash)}`;
|
|
@@ -166,12 +166,12 @@ api-security-documentation {
|
|
|
166
166
|
--anypoint-button-emphasis-high-active-background-color: transparent;
|
|
167
167
|
|
|
168
168
|
/* api example */
|
|
169
|
-
--api-example-accent-color: rgb(250 250 250);
|
|
170
|
-
--api-example-background-color: rgb(250 250 250);
|
|
169
|
+
--api-example-accent-color: rgb(250, 250, 250);
|
|
170
|
+
--api-example-background-color: rgb(250, 250, 250);
|
|
171
171
|
--api-example-title-background-color: transparent;
|
|
172
172
|
|
|
173
173
|
/* code snippets */
|
|
174
|
-
--http-code-snippet-container-background-color: rgb(250 250 250);
|
|
174
|
+
--http-code-snippet-container-background-color: rgb(250, 250, 250);
|
|
175
175
|
--http-code-snippet-container-padding: var(--dx-g-spacing-md);
|
|
176
176
|
|
|
177
177
|
/* prism */
|
|
@@ -208,7 +208,7 @@ api-endpoint-documentation {
|
|
|
208
208
|
);
|
|
209
209
|
|
|
210
210
|
/* description */
|
|
211
|
-
--api-endpoint-documentation-description-color: rgb(24 24 24);
|
|
211
|
+
--api-endpoint-documentation-description-color: rgb(24, 24, 24);
|
|
212
212
|
}
|
|
213
213
|
|
|
214
214
|
api-endpoint-documentation,
|
|
@@ -271,11 +271,11 @@ api-method-documentation {
|
|
|
271
271
|
--api-method-documentation-http-method-label-font-weight: var(
|
|
272
272
|
--dx-g-font-bold
|
|
273
273
|
);
|
|
274
|
-
--api-method-documentation-description-color: rgb(24 24 24);
|
|
274
|
+
--api-method-documentation-description-color: rgb(24, 24, 24);
|
|
275
275
|
--api-method-documentation-operation-id-color: var(--dx-g-gray-50);
|
|
276
276
|
|
|
277
277
|
/* body */
|
|
278
|
-
--api-body-document-description-color: rgb(24 24 24);
|
|
278
|
+
--api-body-document-description-color: rgb(24, 24, 24);
|
|
279
279
|
--api-body-document-media-type-selector-color: var(--dx-g-blue-vibrant-20);
|
|
280
280
|
--api-body-document-media-type-selector-font-size: var(
|
|
281
281
|
--amf-h8-mod-font-size
|