iTwin.js Embed API

The iTwin.js Embed API allows you to embed an iTwin.js application via an iFrame into any "host" web application with a simple request.

The Embed API includes a set of functionality that allows the hosting application to interact with the embedded application. The specific functionality the API exposes is driven by the iTwin.js application that is being embedded and therefore support may vary from application to application.

The current feature set includes:

• Support for opening to a specific Context/iModel/Changeset
  • Via query params
• Option to turn on/off the iModelIndex page
  • Design Review specific
• Interactions with the embedded iTwin.js Application
  • Unified Selection
    • Listen to selection events, more details
    • Drive Unified Selection by Element Ids
  • Perform full ECSql queries
    • To get started with ECSql, visit here
  • Get Element Properties
  • Viewport functionality
    • Drive Zoom by element ids
    • Limited Emphasize and Override capabilities
• Support for custom messages, event and querystring parameter that can be tailored in a specific embedded application.
• Extensions loading from iTwin.js Extension Service.

Example

A basic javascript sample is provided and available in the demos folder. The two main files are index.html and demo.js.