41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
<!-- FIXME: make this one or more storybooks -->
|
|
|
|
## Using generator components
|
|
|
|
The components within this module require the following import.
|
|
|
|
```ts
|
|
import { GeneratorModule } from "@bitwarden/generator-components";
|
|
```
|
|
|
|
The credential generator provides access to all generator features.
|
|
|
|
```html
|
|
<!-- Bound to active user -->
|
|
<tools-credential-generator />
|
|
|
|
<!-- Bound to a specific user -->
|
|
<tools-credential-generator [user-id]="userId" />
|
|
|
|
<!-- receive updates when a credential is generated.
|
|
`$event` is a `GeneratedCredential`.
|
|
-->
|
|
<tools-credential-generator (onGenerated)="eventHandler($event)" />
|
|
```
|
|
|
|
Specialized components are provided for username and password generation. These
|
|
components support the same properties as the credential generator.
|
|
|
|
```html
|
|
<tools-password-generator [user-id]="userId" (onGenerated)="eventHandler($event)" />
|
|
<tools-username-generator [user-id]="userId" (onGenerated)="eventHandler($event)" />
|
|
```
|
|
|
|
The emission behavior of `onGenerated` varies according to credential type. When
|
|
a credential supports immediate execution, the component automatically generates
|
|
a value and emits from `onGenerated`. An additional emission occurs each time the
|
|
user changes a setting. Users may also request a regeneration.
|
|
|
|
When a credential does not support immediate execution, then `onGenerated` fires
|
|
only when the user clicks the "generate" button.
|