@blackbaud/skyux-lib-help

Provides a SKYUX library for interacting with the Help Widget. Wraps much of the functionality of [@blackbaud/help-client] in SKYUX-compatible fashion. This module is a dependency of [@skyux-sdk/builder].

Usage no npm install needed!

<script type="module">
  import blackbaudSkyuxLibHelp from 'https://cdn.skypack.dev/@blackbaud/skyux-lib-help';
</script>

README

@blackbaud/skyux-lib-help

npm

Provides a SKYUX library for interacting with the Help Widget. Wraps much of the functionality of @blackbaud/help-client in SKYUX-compatible fashion. This module is a dependency of @skyux-sdk/builder.

SKYUX usage

Enable the help widget by providing a configuration in skyuxconfig.json. @skyux-sdk/builder will initialize the widget based on this config.

{
  "help": {
    "helpMode": "menu"
  }
}

See widget-config.ts for more configuration properties.

Use the widget by injecting the HelpWidgetService into your desired directive/service.

@Component({
  selector: 'my-comp',
  template: `
    <button (click)="open()">Help</button>
  `
})
export class MyComponent {
  public constructor(private helpSvc: HelpWidgetService) {
  }

  public open(): void {
    this.helpSvc.openToHelpKey('bb-custom-fields.html');
  }
}

Menu vs legacy mode

See @blackbaud/help-client for more information on the helpMode property. menu is the recommended mode going forward.