About¶
About:
The About Page provides detailed information about the product.
Usage¶
The About Page is a part of an overarching concept to fulfil legal guidelines beside of providing additional information about the product (e.g. version).
Code¶
The component has 3 modes which can be selected using the licenseInfo
parameter.
api
(preferred): License texts are lazy loaded separately for each component. Requires a service to provide license data. With the parameterlicenseInfo.icon
you can set a custom license file icon.text
: Plain text input to dump all license textsiframe
(avoid): Embedded page to display the licenses from another source.
Usage¶
import { SiAboutComponent } from '@siemens/element-ng/about';
@Component({
imports: [SiAboutComponent,...]
})
Please use the appropriate input properties for the legal artifact links like Corporate Information
or Acceptable Use Policy
. This ensures the same order in all applications.
License via API¶
The API variant allows fast and neat navigation through the different license files. By clicking on the subsystems and components, the license details are loaded lazily via API and revealed when loaded.
Just set the licenseInfo.api
parameter to the API endpoint which provides the license data.
License data format¶
The JSON based API supported by the about dialog is structured into three levels of endpoints:
Endpoint:
/api/licenses/
- MIME Type:
application/json
- Description: Top-level index listing all subsystems
- Result:
[ { "name": "OS", "href": "/api/licenses/os/"}, { "name": "Dummy", "href": "/api/licenses/Dummy/"} ]
- MIME Type:
Endpoint:
/api/licenses/<subsystem>
- MIME Type:
application/json
- Description: Subsystem-level index listing all components
- Result:
[ { "name": "boost 1.66", "href": "/api/licenses/os/boost_1.66.copyright"} ]
- MIME Type:
Endpoint:
/api/licenses/<subsystem>/<component>
- MIME Type:
text/plain
- Description: Literal content of the component’s copyright or acknowledgement file
- Result:
Boost copyright text
- MIME Type:
License Text¶
Use the licenseInfo.text
parameter to display the provided license text as plain text.
License Introduction Text and API¶
If your application requires showing a disclaimer in addition to the component licenses provided via API, you can combine the parameters licenseInfo.text
and licenseInfo.api
.
License Iframe¶
You can also use a URL in the licenseInfo.iframe
parameter to show an embedded page containing license information.
Except where otherwise noted, content on this site is licensed under MIT License.