browser/libs/components/src/disclosure/disclosure.component.ts

// FIXME: Update this file to be type safe and remove this and next line
// @ts-strict-ignore
import {
  Component,
  EventEmitter,
  HostBinding,
  Input,
  Output,
  booleanAttribute,
} from "@angular/core";

let nextId = 0;

/**
  * The `bit-disclosure` component is used in tandem with the `bitDisclosureTriggerFor` directive to create an accessible content area whose visibility is controlled by a trigger button.

  * To compose a disclosure and trigger:

  * 1. Create a trigger component (see "Supported Trigger Components" section below)
  * 2. Create a `bit-disclosure`
  * 3. Set a template reference on the `bit-disclosure`
  * 4. Use the `bitDisclosureTriggerFor` directive on the trigger component, and pass it the `bit-disclosure` template reference
  * 5. Set the `open` property on the `bit-disclosure` to init the disclosure as either currently expanded or currently collapsed. The disclosure will default to `false`, meaning it defaults to being hidden.
  *
  * @example
  *
  * ```html
  * <button
  *   type="button"
  *   bitIconButton="bwi-sliders"
  *   [buttonType]="'muted'"
  *   [bitDisclosureTriggerFor]="disclosureRef"
  * ></button>
  * <bit-disclosure #disclosureRef open>click button to hide this content</bit-disclosure>
  * ```
  *
 */
@Component({
  selector: "bit-disclosure",
  template: `<ng-content></ng-content>`,
})
export class DisclosureComponent {
  private _open: boolean;

  /** Emits the visibility of the disclosure content */
  @Output() openChange = new EventEmitter<boolean>();

  /**
   * Optionally init the disclosure in its opened state
   */
  // TODO: Skipped for signal migration because:
  //  Accessor inputs cannot be migrated as they are too complex.
  @Input({ transform: booleanAttribute }) set open(isOpen: boolean) {
    this._open = isOpen;
    this.openChange.emit(isOpen);
  }

  @HostBinding("class") get classList() {
    return this.open ? "" : "tw-hidden";
  }

  @HostBinding("id") id = `bit-disclosure-${nextId++}`;

  get open(): boolean {
    return this._open;
  }
}