Overview
Provides Canvas developers with tools to help streamline the template development process.
Quick Start
- Install the extension.
- Once activated, the following toolbar entry should be visible:
- If logged in as a user with the
developer role, the Qerent StoryChart application should automatically connect to the local instance of the extension upon startup. After opening any storyline, the toolbar entry should update to reflect this:
- All files with a
.jsx extension (or any document where the language is set to javascriptreact) should now have additional IntelliSense support for the Qerent components.
Features
Fetch Templates for the current page
IntelliSense support for Components, Attributes, Bindings, CSS Classes and Template Fragments
Push Template changes to the browser
A template push is performed automatically whenever a template file linked to the active storyline is saved. This applies to the template file explicitly linked to the page, as well as template fragments referenced within it (recursively). This feature can be disabled via the sc-canvas-toolkit.autoPushTemplatesOnSave configuration property:
Save Template changes to database
Native integration of parser/runtime errors
Parser- and runtime errors are now automatically collected and sent to the connected IDE instance, where it shows up under the "Problems" tab:
Instance Explorer view
This panel displays all the documentation, data and metadata exposed by the connected Web App instances. Frame Data and Parameter Values can be edited here and persists to the connected instances.
Open Storylines in the integrated browser
Use the Qerent: Open Storyline in Integrated Browser command to open a storyline directly inside VS Code. When launched from the Command Palette, the extension prompts for the StoryChart domain, environment and storyline name before opening the resulting storyline URL in the integrated browser.
External tooling can also execute the command via the uri:
vscode://qerent.sc-canvas-toolkit/qerent/open-storyline?url=https%3A%2f%2fsdk-test.dev.qerent.ai%2fstorylines%2ftest-some-storyline
Release Notes
0.8.0
- Adds support for opening storylines in VS Code's integrated browser.
- Adds support for
vscode://qerent.sc-canvas-toolkit/qerent/open-storyline?url=... uri from external tooling.
0.7.2
- Sorts Canvas Binding entries alphabetically.
- Adds support for editing Frame Data and Parameter Values via commands.
0.7.1
- Constrains completion item acceptance to only the
Enter key. This applies to all completion item providers.
0.7.0
- Integrates parser/runtime errors into VS Code's Diagnostics.
- Adds view for exploring component documentation, data, metadata and diagnostics for connected browser instance(s).
- Adds support for editing Frame Data and Parameter Values.
- Adds support for automatically pushing relevant template changes on save.
0.6.0
- Adds detailed type information to attribute completion items and hover tooltips.
0.5.2
- Removes
newline and tab from trigger characters for attribute provider.
- Fixes bug where existing boolean flag attributes were being re-suggested by the attribute provider.
0.5.1
- Improves performance when editing large template files.
- Adds support for null-safe navigation operators within expression tooltips.
0.5.0
- Adds TextMate grammar for qerent/documentation code blocks within Markdown.
0.4.1
- Minor enhancements and QOL changes.
0.4.0
- Adds support for on-disk templates and the
Template component (V2 web app only).
0.3.3
- Minor enhancements and QOL changes.
0.3.2
- Maintenance: Fixes up README and Changelog.
0.3.1
- Updates logo.
- Miscellaneous bug-fixes.
0.3.0
0.2.0
- Adds support for saving active template to database.
Note: As a safety measure, this command is only available when exactly 1 browser instance is connected.
0.1.3
- Improves formatting of expression values.
0.1.2
0.1.1
- Minor documentation changes.
0.1.0
- Initial release of extension.
