Files
vault/ui/lib/core/addon/components/masked-input.js
claire bontempo e61bd967e3 Add docfy for addon components (#27188)
* move script to scripts folder

* add docfy to router and scripts

* add docfy to router and scripts

* fix jsdoc syntax

* add component markdown files to gitignore

* improve error handling for scripts

* tidy up remaining jsdoc syntax

* add sample jsdoc components

* add known issue info

* make not using multi-line components clearer

* make generating docs clearer

* update copy

* final how to docfy cleanup

* fix ts file @module syntax

* fix read more syntax

* make docfy typescript compatible
2024-05-29 14:06:38 -07:00

77 lines
2.4 KiB
JavaScript

/**
* Copyright (c) HashiCorp, Inc.
* SPDX-License-Identifier: BUSL-1.1
*/
import { debug } from '@ember/debug';
import { action } from '@ember/object';
import { guidFor } from '@ember/object/internals';
import Component from '@glimmer/component';
import { tracked } from '@glimmer/tracking';
import autosize from 'autosize';
/**
* @module MaskedInput
* `MaskedInput` components are textarea inputs where the input is hidden. They are used to enter sensitive information like passwords.
*
* @example
* <MaskedInput @value="my secret value" @allowCopy={{true}} @allowDownload={{true}} @onChange={{log "handle change"}} />
*
* @param {string} value - The value to display in the input.
* @param {string} name - The key correlated to the value. Used for the download file name.
* @param {function} [onChange=Callback] - Callback triggered on change, sends new value. Must set the value of @value
* @param {boolean} [allowCopy=false] - Whether or not the input should render with a copy button.
* @param {boolean} [allowDownload=false] - Renders a download button that prompts a confirmation modal to download the secret value
* @param {boolean} [displayOnly=false] - Whether or not to display the value as a display only `pre` element or as an input.
*
*/
export default class MaskedInputComponent extends Component {
textareaId = 'textarea-' + guidFor(this);
@tracked showValue = false;
@tracked modalOpen = false;
@tracked stringifyDownload = false;
constructor() {
super(...arguments);
if (!this.args.onChange && !this.args.displayOnly) {
debug('onChange is required for editable Masked Input!');
}
this.updateSize();
}
updateSize() {
autosize(document.getElementById(this.textareaId));
}
@action onChange(evt) {
const value = evt.target.value;
if (this.args.onChange) {
this.args.onChange(value);
}
}
@action handleKeyUp(name, evt) {
this.updateSize();
const { value } = evt.target;
if (this.args.onKeyUp) {
this.args.onKeyUp(name, value);
}
}
@action toggleMask() {
this.showValue = !this.showValue;
}
@action toggleStringifyDownload(event) {
this.stringifyDownload = event.target.checked;
}
get copyValue() {
// Value must be a string to be copied
const { value } = this.args;
if (!value || typeof value === 'string') return value;
if (typeof value === 'object') return JSON.stringify(value);
return value.toString();
}
}