Skip to content

StringifiedBooleanConverter ​

ts
const StringifiedBooleanConverter: ConverterFactory<boolean, [string?, string?]>;

Converts a boolean property to a stringified representation. For example setting boolean WAI-ARIA attributes, which are usually set to true or false as string, can not be used as boolean attributes directly in Lit. To handle this, you can use the StringifiedBooleanConverter provided by this package, which allows you to map a boolean value to its string representation.

See ​

https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded#values

Param ​

trueValue

The string representation for true (default: 'true').

Param ​

falseValue

The string representation for false (default: 'false').

Example ​

typescript
class MyDropdown extends LitElement {
  @property({
    type: Boolean,
    reflect: true,
    attribute: 'aria-expanded',
    converter: StringifiedBooleanConverter('true', 'false'),
  })
  active = false;
}