@sassoftware/vi-api 1.40.1 → 1.40.3
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/component/index.d.ts +2 -2
- package/config/config-api.d.ts +3 -3
- package/control/control-api.d.ts +5 -5
- package/event/event-api.d.ts +1 -1
- package/index.d.ts +1 -1
- package/metadata/admin/admin-metadata-api.d.ts +1 -1
- package/metadata/metadata-api.d.ts +3 -3
- package/object/object-api.d.ts +2 -2
- package/package.json +1 -1
- package/page-admin/page-admin-api.d.ts +1 -1
- package/page-model/page-model-api.d.ts +4 -2
- package/page-template/page-template-api.d.ts +7 -7
- package/property/property-api.d.ts +4 -4
- package/property/property-api.js +1 -1
- package/resource/resource-api.d.ts +1 -1
- package/score-reps/index.d.ts +1 -1
- package/score-reps/package.json +1 -1
- package/search/client/client-search-api.d.ts +2 -2
- package/search/search-api.d.ts +3 -3
- package/sheet/sheet-api.d.ts +1 -1
- package/shell-tabs/shell-tabs-api.d.ts +31 -31
- package/svi-datahub/index.d.ts +229 -219
- package/svi-datahub/package.json +1 -1
- package/svi-sand/index.d.ts +1 -1
- package/svi-sand/package.json +1 -1
package/component/index.d.ts
CHANGED
|
@@ -15,7 +15,7 @@ export interface ComponentCreationResult<T> {
|
|
|
15
15
|
setComponentInputValue?: (name: keyof T, value: unknown) => void;
|
|
16
16
|
}
|
|
17
17
|
/**
|
|
18
|
-
* Functionality related to dynamically creating SAS Visual Investigator
|
|
18
|
+
* Functionality related to dynamically creating SAS Visual Investigator user interface components.
|
|
19
19
|
* Accessed from the window at window.sas.vi.component.
|
|
20
20
|
*/
|
|
21
21
|
export interface ComponentApi {
|
|
@@ -27,7 +27,7 @@ export interface ComponentApi {
|
|
|
27
27
|
create(component: SviComponent.SearchAndSelectWithPreview, target: HTMLElement, bindings?: SearchAndSelectWithPreviewBindings): Promise<ComponentCreationResult<SearchAndSelectWithPreviewBindings>>;
|
|
28
28
|
create(component: SviComponent.TimeSlider, target: HTMLElement, bindings?: TimeSliderBindings): Promise<ComponentCreationResult<TimeSliderBindings>>;
|
|
29
29
|
/**
|
|
30
|
-
* Dynamically create a SAS Visual Investigator
|
|
30
|
+
* Dynamically create a SAS Visual Investigator user interface component appended to a given target DOM element location.
|
|
31
31
|
*
|
|
32
32
|
* @method
|
|
33
33
|
* @param component {SviComponent} Creates the component.
|
package/config/config-api.d.ts
CHANGED
|
@@ -133,15 +133,15 @@ export interface ConfigApi {
|
|
|
133
133
|
/**
|
|
134
134
|
* @method
|
|
135
135
|
* @description Registers a new solution and version in the SAS Visual Investigator About dialog box.
|
|
136
|
-
* If a solution with that key already exists
|
|
136
|
+
* If a solution with that key already exists it will not be overwritten.
|
|
137
137
|
* @param key {string} Unique identifier for the solution.
|
|
138
|
-
* @param label {string} Localized name of the solution to be
|
|
138
|
+
* @param label {string} Localized name of the solution to be displayed.
|
|
139
139
|
* @param [version] {string} Version of the solution.
|
|
140
140
|
*/
|
|
141
141
|
registerSolution(key: string, label: string, version?: string): void;
|
|
142
142
|
/**
|
|
143
143
|
* @method
|
|
144
|
-
* @description Retrieves registered solution extension with a given name.
|
|
144
|
+
* @description Retrieves the registered solution extension with a given name.
|
|
145
145
|
* @param name {string} Name of the solution extension.
|
|
146
146
|
* @returns A Promise that resolves to the solution extension if the name is found.
|
|
147
147
|
*/
|
package/control/control-api.d.ts
CHANGED
|
@@ -92,7 +92,7 @@ export interface ControlAdminApi {
|
|
|
92
92
|
/**
|
|
93
93
|
* Registers a function to be invoked when retrieving this control's internationalization resources.
|
|
94
94
|
* @method
|
|
95
|
-
* @param fn {function}
|
|
95
|
+
* @param fn {function} A function that returns each internationalization resource's key and value.
|
|
96
96
|
* No parameters. Return type: Record<string, string>
|
|
97
97
|
*/
|
|
98
98
|
registerGetI18nResourcesFn(fn: () => Record<string, string>): void;
|
|
@@ -415,7 +415,7 @@ export interface ControlPageApi extends ControlPageApiBase {
|
|
|
415
415
|
save(stopEditing: boolean, closeObject: boolean): Promise<void>;
|
|
416
416
|
}
|
|
417
417
|
/**
|
|
418
|
-
* Methods related to files
|
|
418
|
+
* Methods related to files.
|
|
419
419
|
*/
|
|
420
420
|
export interface ControlFileApiBase {
|
|
421
421
|
/**
|
|
@@ -432,15 +432,15 @@ export interface ControlFileApiBase {
|
|
|
432
432
|
*/
|
|
433
433
|
export interface ControlFileApi extends ControlFileApiBase {
|
|
434
434
|
/**
|
|
435
|
-
* Opens the file upload dialog.
|
|
435
|
+
* Opens the file upload dialog box.
|
|
436
436
|
*
|
|
437
437
|
* @method
|
|
438
|
-
* @param {IAttachmentFormData} options Additional options to pass to the file upload dialog.
|
|
438
|
+
* @param {IAttachmentFormData} options Additional options to pass to the file upload dialog box.
|
|
439
439
|
* @returns {Promise<SASObjectAttachedFile[]>} Promise which resolves to an array of uploaded files.
|
|
440
440
|
*/
|
|
441
441
|
openFileUploadDialog(options: AttachmentFormData): Promise<SASObjectAttachedFile[]>;
|
|
442
442
|
/**
|
|
443
|
-
* Opens the image upload dialog.
|
|
443
|
+
* Opens the image upload dialog box.
|
|
444
444
|
*
|
|
445
445
|
* @method
|
|
446
446
|
* @param {boolean} allowMultiple Determines if multiple files can be uploaded at once.
|
package/event/event-api.d.ts
CHANGED
|
@@ -43,7 +43,7 @@ export interface EventApi {
|
|
|
43
43
|
* @description Subscribes to an event and registers a function to be called on any future published events.
|
|
44
44
|
* If the eventName does not exist, it is created.
|
|
45
45
|
* @param eventName {string} Name of the event to subscribe to.
|
|
46
|
-
* @param {EventApi~subscriptionCallback} Function
|
|
46
|
+
* @param {EventApi~subscriptionCallback} Function Invoked when the subscription is triggered by an event.
|
|
47
47
|
* Has access to the event's payload.
|
|
48
48
|
* @returns The subscription being made to the event.
|
|
49
49
|
*/
|
package/index.d.ts
CHANGED
|
@@ -40,7 +40,7 @@ export interface SviCommonApi {
|
|
|
40
40
|
pageTemplate: PageTemplateApi;
|
|
41
41
|
property: PropertyApi;
|
|
42
42
|
refData: RefDataApi;
|
|
43
|
-
/** @deprecated Use window.sas.viInit.registerResourceBundle to register resources before the rest of the Visual Investigator API is ready. */
|
|
43
|
+
/** @deprecated Use window.sas.viInit.registerResourceBundle to register resources before the rest of the SAS Visual Investigator API is ready. */
|
|
44
44
|
resource: ResourceApi;
|
|
45
45
|
search: SearchApi;
|
|
46
46
|
theme: ThemeApi;
|
|
@@ -4,7 +4,7 @@ export interface FieldTypeLabels {
|
|
|
4
4
|
}
|
|
5
5
|
/**
|
|
6
6
|
* {@link MetadataApi} extension provides the functionality related to retrieval of metadata.
|
|
7
|
-
* Additional methods are available only in the SAS Visual Investigator
|
|
7
|
+
* Additional methods are available only in the SAS Visual Investigator Manage and Investigate interface.
|
|
8
8
|
* Accessed from the window at window.sas.vi.metadata.
|
|
9
9
|
* @extends MetadataApi
|
|
10
10
|
*/
|
|
@@ -160,7 +160,7 @@ export interface MetadataApi {
|
|
|
160
160
|
/**
|
|
161
161
|
* @method
|
|
162
162
|
* @description Gets create, read, and update access rights for the provided entities via batch call.
|
|
163
|
-
* @param objectType {string[]} Entity
|
|
163
|
+
* @param objectType {string[]} Entity names.
|
|
164
164
|
* @returns Object with a Promise of type EntityAccessRule[] for each rule, where EntityAccessRule maps to the access rule of a given entity name.
|
|
165
165
|
*/
|
|
166
166
|
getEntitiesAccessRules(objectTypes: string[]): EntitiesAccessRules;
|
|
@@ -206,7 +206,7 @@ export interface MetadataApi {
|
|
|
206
206
|
* @param objectType {string} Finds relationships for the entity.
|
|
207
207
|
* @param [relationshipObjectType] {string} Used for filtering the name of an expected related entity.
|
|
208
208
|
* @param [relationshipName] {string} Used for filtering the name of an expected relationship.
|
|
209
|
-
* @param flattenMultiLinkIntoSingles
|
|
209
|
+
* @param flattenMultiLinkIntoSingles Whether Relationships with a One->(multiple) links will get flattened into many One->Single relationships.
|
|
210
210
|
* @returns A Promise resolving to an object containing relationship type metadata.
|
|
211
211
|
* The object is empty if no relationship types exist.
|
|
212
212
|
*/
|
|
@@ -266,7 +266,7 @@ export interface MetadataApi {
|
|
|
266
266
|
* @method
|
|
267
267
|
* @description Gets relationships with a specified end type.
|
|
268
268
|
* @param endType endType {string} End type entity name.
|
|
269
|
-
* @param options
|
|
269
|
+
* @param options See {@link OptionsForGetRelationshipsForObjectType}
|
|
270
270
|
*/
|
|
271
271
|
getRelationshipsForObjectType(endType: string, options: OptionsForGetRelationshipsForObjectType): Promise<RelationshipWithLabel[]>;
|
|
272
272
|
}
|
package/object/object-api.d.ts
CHANGED
|
@@ -166,8 +166,8 @@ export interface ObjectApi {
|
|
|
166
166
|
/**
|
|
167
167
|
* @method
|
|
168
168
|
* @description Creates a new object and relates it with an existing one.
|
|
169
|
-
* @param from {LinkObject}
|
|
170
|
-
* @param to {NewLinkObject}
|
|
169
|
+
* @param from {LinkObject} Existing Object that the relationship is from.
|
|
170
|
+
* @param to {NewLinkObject} New Object to be created and related to.
|
|
171
171
|
* @param relationship {ObjectRelationship} The relationship.
|
|
172
172
|
* @return A Promise that resolves to a newly created relationship.
|
|
173
173
|
*/
|
package/package.json
CHANGED
|
@@ -17,7 +17,7 @@ export interface PageAdminApi {
|
|
|
17
17
|
* @method
|
|
18
18
|
* @description Registers a page designer configuration.
|
|
19
19
|
* @param name {string} A unique name for the configuration.
|
|
20
|
-
* @param applicationType {ApplicationType} The name of the
|
|
20
|
+
* @param applicationType {ApplicationType} The name of the application type used for this page. Must be a valid datahub client application (for example, "desktop" or "mobile").
|
|
21
21
|
* @param templateType {TemplateType} The name of the template type used for this page. Must be a valid datahub template type (for example, "home" or "page").
|
|
22
22
|
* @param controlGroups {Control[]} The control categories that are displayed in the designer's left hand side toolbox. Must be valid control categories.
|
|
23
23
|
* @param canvasCssClass {string} A CSS class that is applied to the canvas in the designer.
|
|
@@ -4,7 +4,6 @@ import { FileOperation, SASObjectAttachedFile } from "../file/file-api";
|
|
|
4
4
|
import { ObjectFieldRestrictions } from "../object/object-api";
|
|
5
5
|
import { PathsRepresentation } from "../svi-sand";
|
|
6
6
|
import { TemplateFileCategoryAssociationDTO } from "../svi-datahub";
|
|
7
|
-
import { ILinkedTemplate } from "../../spb";
|
|
8
7
|
export declare enum PageMode {
|
|
9
8
|
Create = "create",
|
|
10
9
|
Edit = "edit",
|
|
@@ -92,7 +91,10 @@ export interface PageTemplateMetadata {
|
|
|
92
91
|
fileCategories?: TemplateFileCategoryAssociationDTO[];
|
|
93
92
|
insightsCreationEnabled: boolean;
|
|
94
93
|
insightsEnabled: boolean;
|
|
95
|
-
linkedTemplates:
|
|
94
|
+
linkedTemplates: Array<{
|
|
95
|
+
templateUuid: string;
|
|
96
|
+
traversalUuid: string;
|
|
97
|
+
}>;
|
|
96
98
|
resources: {
|
|
97
99
|
[property: string]: string;
|
|
98
100
|
};
|
|
@@ -7,10 +7,10 @@ import { ApplicationType, TemplateType } from "../page-admin/page-admin-api";
|
|
|
7
7
|
export interface PageTemplateApi {
|
|
8
8
|
/**
|
|
9
9
|
* @method
|
|
10
|
-
* @description Retrieves all
|
|
10
|
+
* @description Retrieves all templates matching the parameters.
|
|
11
11
|
* @param entityType {string} The object type for which the templates are to be retrieved.
|
|
12
|
-
* @param includeNoDataSource {boolean}
|
|
13
|
-
* @param clientApplication {ApplicationType} The name of the
|
|
12
|
+
* @param includeNoDataSource {boolean} Boolean to determine whether templates with no dataSource should be included.
|
|
13
|
+
* @param clientApplication {ApplicationType} The name of the application type used for this page. Must be a valid datahub client application (for example, desktop | mobile).
|
|
14
14
|
* @param templateType {TemplateType} The name of the template type used for this page. Must be a valid datahub template type (for example, home | page).
|
|
15
15
|
* @returns A promise of an array of {@link TemplateResourceSummary}.
|
|
16
16
|
*/
|
|
@@ -18,21 +18,21 @@ export interface PageTemplateApi {
|
|
|
18
18
|
/**
|
|
19
19
|
* @method
|
|
20
20
|
* @description Gets the page template with the specified ID.
|
|
21
|
-
* @param templateId {number}
|
|
22
|
-
* @returns A promise containing the page template metadata {@link Template}
|
|
21
|
+
* @param templateId {number} The ID of the page template.
|
|
22
|
+
* @returns A promise containing the page template metadata {@link Template}.
|
|
23
23
|
*/
|
|
24
24
|
getPageTemplateById(templateId: number): Promise<Template>;
|
|
25
25
|
/**
|
|
26
26
|
* @method
|
|
27
27
|
* @description Gets the page template with the specified UUID.
|
|
28
|
-
* @param templateUuid {string}
|
|
28
|
+
* @param templateUuid {string} The UUID of the page template.
|
|
29
29
|
* @returns A promise containing the page template metadata {@link Template}.
|
|
30
30
|
*/
|
|
31
31
|
getPageTemplateByUuid(templateUuid: string): Promise<Template>;
|
|
32
32
|
/**
|
|
33
33
|
* @method
|
|
34
34
|
* @description Get all templates of a specific client and template type. If null params defaults to clientApplication = DESKTOP, templateType = PAGE
|
|
35
|
-
* @param [clientApplication] {ApplicationType} The name of the
|
|
35
|
+
* @param [clientApplication] {ApplicationType} The name of the application type used for this page. Must be a valid datahub client application (for example, desktop | mobile).
|
|
36
36
|
* @param [templateType] {TemplateType} The name of the template type used for this page. Must be a valid datahub template type (for example, home | page).
|
|
37
37
|
* @returns A promise which returns an array of {@link TemplateResourceSummary}
|
|
38
38
|
*/
|
|
@@ -81,11 +81,11 @@ export interface PageControlPropertyLocalizer extends PropertyLocalizer<Control>
|
|
|
81
81
|
*/
|
|
82
82
|
export interface PropertyLocalizer<T> {
|
|
83
83
|
/**
|
|
84
|
-
*
|
|
84
|
+
* Control type to be localized,
|
|
85
85
|
*/
|
|
86
86
|
localizerType: LocalizerType;
|
|
87
87
|
/**
|
|
88
|
-
*
|
|
88
|
+
* Property type to be localized.
|
|
89
89
|
* (the type that the property editor is registered against)
|
|
90
90
|
*/
|
|
91
91
|
propertyType: string;
|
|
@@ -129,7 +129,7 @@ export interface PropertyApi {
|
|
|
129
129
|
registerPropertyLocalizer(localizer: ControlPropertyLocalizer): void;
|
|
130
130
|
/**
|
|
131
131
|
* @method
|
|
132
|
-
* @description Determines whether
|
|
132
|
+
* @description Determines whether the child object data source property editor is valid.
|
|
133
133
|
* Typically passed as a function reference to registerCustomEditor() instead of being called directly.
|
|
134
134
|
* @param {PropertyConfig} propertyConfig Configuration details relating to the property type. For example, required, type, and so on.
|
|
135
135
|
* @param {string} propertyKey Key where this property's value is stored.
|
|
@@ -159,7 +159,7 @@ export interface PropertyApi {
|
|
|
159
159
|
getChildObjectMetadata(propertyConfig: PropertyConfig, propertyKey: string, control: Control): PageTemplateMetadata | undefined;
|
|
160
160
|
}
|
|
161
161
|
/**
|
|
162
|
-
* Determines whether
|
|
162
|
+
* Determines whether the property editor is valid.
|
|
163
163
|
* @callback PropertyApi~isPropertyEditorValid
|
|
164
164
|
* @param {PropertyConfig} propertyConfig Configuration details relating to the custom property type. For example, required, type, and so on.
|
|
165
165
|
* @param {string} propertyKey Key where this property's value is stored.
|
package/property/property-api.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
export {};
|
|
2
2
|
/**
|
|
3
|
-
* Determines whether
|
|
3
|
+
* Determines whether the property editor is valid.
|
|
4
4
|
* @callback PropertyApi~isPropertyEditorValid
|
|
5
5
|
* @param {PropertyConfig} propertyConfig Configuration details relating to the custom property type. For example, required, type, and so on.
|
|
6
6
|
* @param {string} propertyKey Key where this property's value is stored.
|
|
@@ -2,7 +2,7 @@ export interface I18nResources {
|
|
|
2
2
|
[key: string]: string | I18nResources;
|
|
3
3
|
}
|
|
4
4
|
/**
|
|
5
|
-
* @deprecated Use window.sas.viInit.registerResourceBundle to register resources before the rest of the Visual Investigator API is ready.
|
|
5
|
+
* @deprecated Use window.sas.viInit.registerResourceBundle to register resources before the rest of the SAS Visual Investigator API is ready.
|
|
6
6
|
* This API provides the resource functionality in SAS Visual Investigator.
|
|
7
7
|
* Accessed from the window at window.sas.vi.resource.
|
|
8
8
|
*/
|
package/score-reps/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/* tslint:disable */
|
|
2
2
|
/* eslint-disable */
|
|
3
|
-
// Generated using typescript-generator version 2.15.527 on 2024-
|
|
3
|
+
// Generated using typescript-generator version 2.15.527 on 2024-04-29 09:50:32.
|
|
4
4
|
|
|
5
5
|
export interface BaseRep extends TrackedResource {
|
|
6
6
|
links?: Link[];
|
package/score-reps/package.json
CHANGED
|
@@ -62,7 +62,7 @@ export interface SearchAndCreateResponse {
|
|
|
62
62
|
}
|
|
63
63
|
/**
|
|
64
64
|
* {@link SearchApi} extension pertains to functionality related to SAS Visual Investigator's search capabilities.
|
|
65
|
-
* These additional methods are available only in the SAS Visual Investigator
|
|
65
|
+
* These additional methods are available only in the SAS Visual Investigator Investigate and Search interface.
|
|
66
66
|
* Accessed from the window at window.sas.vi.search.
|
|
67
67
|
* @extends SearchApi
|
|
68
68
|
*/
|
|
@@ -121,7 +121,7 @@ export interface ClientSearchApi extends SearchApi {
|
|
|
121
121
|
openAddObjectsToWorkspaceDialog(visualizationName: Visualization, objects: ObjectIdentifier[], currentObject?: ObjectIdentifier, networkData?: NetworkData): Promise<void>;
|
|
122
122
|
/**
|
|
123
123
|
* @method
|
|
124
|
-
* @description Adds an image to the Insights selected in the "Add image to Insights" dialog
|
|
124
|
+
* @description Adds an image to the Insights selected in the "Add image to Insights" dialog.
|
|
125
125
|
* @param imageData {Uint8Array} Image to add.
|
|
126
126
|
* @param contentType {string} This is used in the content-type header when the file is uploaded. For example 'image/png'.
|
|
127
127
|
* @param [height] {string} Height of the Insights cell.
|
package/search/search-api.d.ts
CHANGED
|
@@ -44,16 +44,16 @@ export interface QueryBuilderResult {
|
|
|
44
44
|
queryModel: QueryBuilderModel;
|
|
45
45
|
}
|
|
46
46
|
/**
|
|
47
|
-
* This API
|
|
47
|
+
* This API relates to SAS Visual Investigator's search functionality.
|
|
48
48
|
* Accessed from the window at window.sas.vi.search.
|
|
49
49
|
*/
|
|
50
50
|
export interface SearchApi {
|
|
51
51
|
/**
|
|
52
52
|
* @method
|
|
53
|
-
* @description Opens the query builder dialog allowing the user to create a new query or edit an existing one passed in via the
|
|
53
|
+
* @description Opens the query builder dialog box allowing the user to create a new query or edit an existing one passed in via the
|
|
54
54
|
* query model parameter.
|
|
55
55
|
* @param dialogTitle {string} Title of the dialog.
|
|
56
|
-
* @param [submitButtonText] {string} Text for the dialog submit button.
|
|
56
|
+
* @param [submitButtonText] {string} Text for the dialog box submit button.
|
|
57
57
|
* @param [queryModel] {QueryBuilderModel} An existing query model that can be used to initially populate the query builder.
|
|
58
58
|
* @param [enforceObjectType] {string} If enforceObjectType is set, the user cannot choose which entity to query. It is pre-set to the specified entity.
|
|
59
59
|
* @param [restrictObjectTypes] {Array<string>} If restrictObjectTypes is set, then the entity dropdown is filtered to show only the entities in this list.
|
package/sheet/sheet-api.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { ObjectIdentifier, ObjectSheetSettings, VIObject } from "../object/object-api";
|
|
2
2
|
import { NetworkData, Visualization } from "../search/client/client-search-api";
|
|
3
3
|
/**
|
|
4
|
-
* This API
|
|
4
|
+
* This API relates to SAS Visual Investigator's sheet functionality.
|
|
5
5
|
* Accessed from the window at window.sas.vi.sheet.
|
|
6
6
|
*/
|
|
7
7
|
export interface SheetApi {
|
|
@@ -114,39 +114,39 @@ export interface ExternalTabConfig<T = SviShellTabData, P = any> {
|
|
|
114
114
|
buildOnRegister?: boolean;
|
|
115
115
|
}
|
|
116
116
|
/**
|
|
117
|
-
* This API provides functionality
|
|
117
|
+
* This API provides functionality relating to the shell tabs.
|
|
118
118
|
* Accessed from the window at window.sas.vi.shellTabs.
|
|
119
119
|
*/
|
|
120
120
|
export interface ShellTabsApi<T = SviShellTabData> {
|
|
121
121
|
/**
|
|
122
122
|
* @method
|
|
123
|
-
* @description
|
|
123
|
+
* @description This is used to expose any {@link PotentialTabItem} hooks on a component up to the Tab Service.
|
|
124
124
|
* @param [context] {this} pass "this"
|
|
125
|
-
* @param [elRef] {HTMLElement} pass the ElementRef for the component
|
|
125
|
+
* @param [elRef] {HTMLElement} This will pass the ElementRef for the component
|
|
126
126
|
*
|
|
127
127
|
* onTabClose {@link OnTabClose}, optional, can be used to prevent closing of a tab or close async
|
|
128
128
|
* onAttachTab {@link OnAttachTab}, will always trigger when currentNavigationBarTab has set
|
|
129
129
|
* onAttachToolbar {@link TabWithToolbar}, optional, will set currentToolbar if there was a toolbar in the VI Router
|
|
130
130
|
* onTabEnter {@link OnTabEnter}, optional, will trigger when tab is entered
|
|
131
131
|
* onTabLeave {@link OnTabLeave}, optional, will trigger when tab is left
|
|
132
|
-
* onTabSaveConfirm {@link OnTabSaveConfirm}, optional, basic dialog can be created whe closing a dirty tab
|
|
132
|
+
* onTabSaveConfirm {@link OnTabSaveConfirm}, optional, basic dialog box can be created whe closing a dirty tab.
|
|
133
133
|
*/
|
|
134
134
|
createTabApiForElement: (context: any, nativeElement: HTMLElement) => void;
|
|
135
135
|
/**
|
|
136
136
|
* @method
|
|
137
|
-
* @description Use this function to register new routes for tabs
|
|
138
|
-
* @param [tabsToAdd] {ExternalTabConfig[]} -
|
|
137
|
+
* @description Use this function to register new routes for tabs.
|
|
138
|
+
* @param [tabsToAdd] {ExternalTabConfig[]} - See {@link ExternalTabConfig}
|
|
139
139
|
*/
|
|
140
140
|
registerExternalTabs: (tab: Array<ExternalTabConfig<T>>) => void;
|
|
141
141
|
/**
|
|
142
142
|
* @method
|
|
143
|
-
* @description Use this function to remove routes added via registerTabFn
|
|
144
|
-
* @param [tabsToRemove] {ExternalTabConfig[]} -
|
|
143
|
+
* @description Use this function to remove routes added via registerTabFn.
|
|
144
|
+
* @param [tabsToRemove] {ExternalTabConfig[]} - See {@link ExternalTabConfig}
|
|
145
145
|
*/
|
|
146
146
|
unregisterExternalTabs: (tabsToRemove: Array<ExternalTabConfig<T>>) => void;
|
|
147
147
|
/**
|
|
148
148
|
* @method
|
|
149
|
-
* @description
|
|
149
|
+
* @description This will return the current primary and secondary tabs.
|
|
150
150
|
*/
|
|
151
151
|
getSelectedTab: () => {
|
|
152
152
|
primaryTab: INavigationBarTab;
|
|
@@ -154,17 +154,17 @@ export interface ShellTabsApi<T = SviShellTabData> {
|
|
|
154
154
|
};
|
|
155
155
|
/**
|
|
156
156
|
* @method
|
|
157
|
-
* @description
|
|
157
|
+
* @description This stream will track the current top level tab.
|
|
158
158
|
*/
|
|
159
159
|
selectedPrimaryTabChanged$: Observable<INavigationBarTab>;
|
|
160
160
|
/**
|
|
161
161
|
* @method
|
|
162
|
-
* @description
|
|
162
|
+
* @description This stream will track the current second level tab.
|
|
163
163
|
*/
|
|
164
164
|
selectedSecondaryTabChanged$: Observable<INavigationBarTab | undefined>;
|
|
165
165
|
/**
|
|
166
166
|
* @method
|
|
167
|
-
* @description
|
|
167
|
+
* @description This stream will update after any additions/removals to either system or application tabs.
|
|
168
168
|
*/
|
|
169
169
|
openTabsChanged$: Observable<{
|
|
170
170
|
systemTabs: INavigationBarTab[];
|
|
@@ -172,18 +172,18 @@ export interface ShellTabsApi<T = SviShellTabData> {
|
|
|
172
172
|
}>;
|
|
173
173
|
/**
|
|
174
174
|
* @method
|
|
175
|
-
* @description
|
|
175
|
+
* @description This stream will emit any removed tabs.
|
|
176
176
|
*/
|
|
177
177
|
tabRemoved$: Observable<INavigationBarTab>;
|
|
178
178
|
/**
|
|
179
179
|
* @method
|
|
180
180
|
* @description get Tab by ID
|
|
181
|
-
* @param [tabId] {string} will be ID of an existing tab
|
|
181
|
+
* @param [tabId] {string} This will be ID of an existing tab.
|
|
182
182
|
*/
|
|
183
183
|
getTabById: (tabId: string) => INavigationBarTab | undefined;
|
|
184
184
|
/**
|
|
185
185
|
* @method
|
|
186
|
-
* @description will return a slice of the current system and application tabs
|
|
186
|
+
* @description This will return a slice of the current system and application tabs.
|
|
187
187
|
*/
|
|
188
188
|
getAllTabs: () => {
|
|
189
189
|
system: INavigationBarTab[];
|
|
@@ -191,48 +191,48 @@ export interface ShellTabsApi<T = SviShellTabData> {
|
|
|
191
191
|
};
|
|
192
192
|
/**
|
|
193
193
|
* @method
|
|
194
|
-
* @description will move user to the default tab
|
|
194
|
+
* @description This will move user to the default tab.
|
|
195
195
|
*/
|
|
196
196
|
selectDefaultTab: () => Promise<boolean>;
|
|
197
197
|
/**
|
|
198
198
|
* @method
|
|
199
|
-
* @description will attempt to open+select a matching INavigationBarTab and optional secondaryTab, returning false on failure
|
|
200
|
-
* in the event the tab doesn't exist already, it will add the tab assuming an appropriate route has been registered for it
|
|
201
|
-
* @param [tabToSelect] {INavigationBarTab}
|
|
202
|
-
* @param [secondaryTab] {INavigationBarTab}
|
|
203
|
-
* selected secondary tab of the primary tab or
|
|
199
|
+
* @description This will attempt to open+select a matching INavigationBarTab and optional secondaryTab, returning false on failure
|
|
200
|
+
* in the event the tab doesn't exist already, it will add the tab assuming an appropriate route has been registered for it.
|
|
201
|
+
* @param [tabToSelect] {INavigationBarTab} See {@link INavigationBarTab}
|
|
202
|
+
* @param [secondaryTab] {INavigationBarTab} See {@link INavigationBarTab} if left undefined, this will select the previously
|
|
203
|
+
* selected secondary tab of the primary tab or its first index secondary tab.
|
|
204
204
|
*/
|
|
205
205
|
openTab: (tabToSelect: INavigationBarTab, secondaryTab?: INavigationBarTab) => Promise<boolean>;
|
|
206
206
|
/**
|
|
207
207
|
* @method
|
|
208
|
-
* @description will attempt to select a tab by its id, returning false on failure
|
|
209
|
-
* @param [tabId] {string} will be ID of an existing tab
|
|
208
|
+
* @description This will attempt to select a tab by its id, returning false on failure.
|
|
209
|
+
* @param [tabId] {string} This will be ID of an existing tab.
|
|
210
210
|
*/
|
|
211
211
|
selectTabById: (tabId: string) => Promise<boolean>;
|
|
212
212
|
/**
|
|
213
213
|
* @method
|
|
214
|
-
* @description will remove an application tab, if allowed, and will trigger any closing and saving logic beforehand
|
|
215
|
-
* @param [tabIdToRemove] {string} will be ID of an existing tab
|
|
216
|
-
* @param [suppressNavigation] {boolean} if you
|
|
214
|
+
* @description This will remove an application tab, if allowed, and will trigger any closing and saving logic beforehand.
|
|
215
|
+
* @param [tabIdToRemove] {string} This will be ID of an existing tab.
|
|
216
|
+
* @param [suppressNavigation] {boolean} Set supressNavigation to true if you want to close a tab that isn't open.
|
|
217
217
|
*/
|
|
218
218
|
removeApplicationTabById: (tabIdToRemove: string, suppressNavigation?: boolean) => Promise<boolean>;
|
|
219
219
|
/**
|
|
220
220
|
* @method
|
|
221
|
-
* @description will remove an existing application tab then replace with another, if {@link removeApplicationTabById} is unsuccessful this will fail
|
|
221
|
+
* @description This will remove an existing application tab then replace with another, if {@link removeApplicationTabById} is unsuccessful this will fail
|
|
222
222
|
* use case can be saving a tab which has a temporary ID, and reopening it with a saved payload.
|
|
223
|
-
* @param [tabId] {string} will be ID of an existing tab
|
|
224
|
-
* @param [newTab] {INavigationBarTab}
|
|
223
|
+
* @param [tabId] {string} This will be ID of an existing tab.
|
|
224
|
+
* @param [newTab] {INavigationBarTab} See {@link INavigationBarTab}
|
|
225
225
|
*
|
|
226
226
|
*/
|
|
227
227
|
replaceApplicationTab: (tabId: string, newTab: INavigationBarTab) => Promise<boolean>;
|
|
228
228
|
/**
|
|
229
229
|
* @method
|
|
230
|
-
* @description will run {@link removeApplicationTabById} on all tabs, will stop if any fail to close, will wait for each close to complete
|
|
230
|
+
* @description This will run {@link removeApplicationTabById} on all tabs, will stop if any fail to close, will wait for each close to complete.
|
|
231
231
|
*/
|
|
232
232
|
removeAllApplicationTabs: () => Promise<boolean>;
|
|
233
233
|
/**
|
|
234
234
|
* @method
|
|
235
|
-
* @description will run same as {@link removeAllApplicationTabs}, but not on the provided tabIdToKeep
|
|
235
|
+
* @description This will run the same as {@link removeAllApplicationTabs}, but not on the provided tabIdToKeep.
|
|
236
236
|
* @param [tabIdToKeep] {string}
|
|
237
237
|
*/
|
|
238
238
|
removeOtherApplicationTabs: (tabIdToKeep?: string) => Promise<boolean>;
|