ha-frontend/src/panels/lovelace/editor/config-elements/hui-card-features-editor.ts

540 lines
18 KiB
TypeScript

import { mdiDelete, mdiDrag, mdiListBox, mdiPencil, mdiPlus } from "@mdi/js";
import { HassEntity } from "home-assistant-js-websocket";
import { CSSResultGroup, LitElement, css, html, nothing } from "lit";
import { customElement, property } from "lit/decorators";
import { repeat } from "lit/directives/repeat";
import memoizeOne from "memoize-one";
import { fireEvent } from "../../../../common/dom/fire_event";
import { stopPropagation } from "../../../../common/dom/stop_propagation";
import { LocalizeFunc } from "../../../../common/translations/localize";
import "../../../../components/entity/ha-entity-picker";
import "../../../../components/ha-button";
import {
HaFormSchema,
SchemaUnion,
} from "../../../../components/ha-form/types";
import "../../../../components/ha-icon-button";
import "../../../../components/ha-list-item";
import "../../../../components/ha-sortable";
import "../../../../components/ha-svg-icon";
import {
CUSTOM_TYPE_PREFIX,
CustomCardFeatureEntry,
getCustomCardFeatures,
isCustomType,
stripCustomPrefix,
} from "../../../../data/lovelace_custom_cards";
import { HomeAssistant } from "../../../../types";
import { supportsAlarmModesCardFeature } from "../../card-features/hui-alarm-modes-card-feature";
import { supportsClimateFanModesCardFeature } from "../../card-features/hui-climate-fan-modes-card-feature";
import { supportsClimateHvacModesCardFeature } from "../../card-features/hui-climate-hvac-modes-card-feature";
import { supportsClimatePresetModesCardFeature } from "../../card-features/hui-climate-preset-modes-card-feature";
import { supportsCoverOpenCloseCardFeature } from "../../card-features/hui-cover-open-close-card-feature";
import { supportsCoverPositionCardFeature } from "../../card-features/hui-cover-position-card-feature";
import { supportsCoverTiltCardFeature } from "../../card-features/hui-cover-tilt-card-feature";
import { supportsCoverTiltPositionCardFeature } from "../../card-features/hui-cover-tilt-position-card-feature";
import { supportsFanSpeedCardFeature } from "../../card-features/hui-fan-speed-card-feature";
import { supportsHumidifierModesCardFeature } from "../../card-features/hui-humidifier-modes-card-feature";
import { supportsHumidifierToggleCardFeature } from "../../card-features/hui-humidifier-toggle-card-feature";
import { supportsLawnMowerCommandCardFeature } from "../../card-features/hui-lawn-mower-commands-card-feature";
import { supportsLightBrightnessCardFeature } from "../../card-features/hui-light-brightness-card-feature";
import { supportsLightColorTempCardFeature } from "../../card-features/hui-light-color-temp-card-feature";
import { supportsNumericInputCardFeature } from "../../card-features/hui-numeric-input-card-feature";
import { supportsSelectOptionsCardFeature } from "../../card-features/hui-select-options-card-feature";
import { supportsTargetHumidityCardFeature } from "../../card-features/hui-target-humidity-card-feature";
import { supportsTargetTemperatureCardFeature } from "../../card-features/hui-target-temperature-card-feature";
import { supportsUpdateActionsCardFeature } from "../../card-features/hui-update-actions-card-feature";
import { supportsVacuumCommandsCardFeature } from "../../card-features/hui-vacuum-commands-card-feature";
import { supportsWaterHeaterOperationModesCardFeature } from "../../card-features/hui-water-heater-operation-modes-card-feature";
import { LovelaceCardFeatureConfig } from "../../card-features/types";
import { LovelaceCardFeatureLayout } from "../../cards/types";
import { getCardFeatureElementClass } from "../../create-element/create-card-feature-element";
import { capitalizeFirstLetter } from "../../../../common/string/capitalize-first-letter";
export type FeatureType = LovelaceCardFeatureConfig["type"];
type SupportsFeature = (stateObj: HassEntity) => boolean;
const UI_FEATURE_TYPES = [
"alarm-modes",
"climate-fan-modes",
"climate-hvac-modes",
"climate-preset-modes",
"cover-open-close",
"cover-position",
"cover-tilt-position",
"cover-tilt",
"fan-speed",
"humidifier-modes",
"humidifier-toggle",
"lawn-mower-commands",
"light-brightness",
"light-color-temp",
"select-options",
"target-humidity",
"target-temperature",
"vacuum-commands",
"update-actions",
"water-heater-operation-modes",
"numeric-input",
] as const satisfies readonly FeatureType[];
type UiFeatureTypes = (typeof UI_FEATURE_TYPES)[number];
const EDITABLES_FEATURE_TYPES = new Set<UiFeatureTypes>([
"vacuum-commands",
"alarm-modes",
"climate-hvac-modes",
"humidifier-modes",
"water-heater-operation-modes",
"lawn-mower-commands",
"climate-fan-modes",
"climate-preset-modes",
"numeric-input",
"update-actions",
]);
const SUPPORTS_FEATURE_TYPES: Record<
UiFeatureTypes,
SupportsFeature | undefined
> = {
"alarm-modes": supportsAlarmModesCardFeature,
"climate-fan-modes": supportsClimateFanModesCardFeature,
"climate-hvac-modes": supportsClimateHvacModesCardFeature,
"climate-preset-modes": supportsClimatePresetModesCardFeature,
"cover-open-close": supportsCoverOpenCloseCardFeature,
"cover-position": supportsCoverPositionCardFeature,
"cover-tilt-position": supportsCoverTiltPositionCardFeature,
"cover-tilt": supportsCoverTiltCardFeature,
"fan-speed": supportsFanSpeedCardFeature,
"humidifier-modes": supportsHumidifierModesCardFeature,
"humidifier-toggle": supportsHumidifierToggleCardFeature,
"lawn-mower-commands": supportsLawnMowerCommandCardFeature,
"light-brightness": supportsLightBrightnessCardFeature,
"light-color-temp": supportsLightColorTempCardFeature,
"numeric-input": supportsNumericInputCardFeature,
"target-humidity": supportsTargetHumidityCardFeature,
"target-temperature": supportsTargetTemperatureCardFeature,
"vacuum-commands": supportsVacuumCommandsCardFeature,
"water-heater-operation-modes": supportsWaterHeaterOperationModesCardFeature,
"select-options": supportsSelectOptionsCardFeature,
"update-actions": supportsUpdateActionsCardFeature,
};
const customCardFeatures = getCustomCardFeatures();
const CUSTOM_FEATURE_ENTRIES: Record<
string,
CustomCardFeatureEntry | undefined
> = {};
customCardFeatures.forEach((feature) => {
CUSTOM_FEATURE_ENTRIES[feature.type] = feature;
});
declare global {
interface HASSDomEvents {
"features-changed": {
features: LovelaceCardFeatureConfig[];
};
"layout-changed": {
layout: LovelaceCardFeatureLayout;
};
}
}
@customElement("hui-card-features-editor")
export class HuiCardFeaturesEditor extends LitElement {
@property({ attribute: false }) public hass?: HomeAssistant;
@property({ attribute: false }) public stateObj?: HassEntity;
@property({ attribute: false })
public features?: LovelaceCardFeatureConfig[];
@property({ attribute: false })
public layout?: LovelaceCardFeatureLayout;
@property({ attribute: false })
public featuresTypes?: FeatureType[];
@property()
public label?: string;
private _featuresKeys = new WeakMap<LovelaceCardFeatureConfig, string>();
private _optionsSchema = memoizeOne(
(_localize: LocalizeFunc) =>
[
{
name: "type",
selector: {
select: {
mode: "dropdown",
options: ["vertical", "horizontal", "compact"].map((layout) => ({
label: capitalizeFirstLetter(layout),
value: layout,
})),
},
},
},
] as const satisfies readonly HaFormSchema[]
);
private _computeLabelCallback = (
schema: SchemaUnion<ReturnType<typeof this._optionsSchema>>
) => {
switch (schema.name) {
case "type":
return "Layout";
default:
return this.hass!.localize(
`ui.panel.lovelace.editor.card.generic.${schema.name}`
);
}
};
private _supportsFeatureType(type: string): boolean {
if (!this.stateObj) return false;
if (isCustomType(type)) {
const customType = stripCustomPrefix(type);
const customFeatureEntry = CUSTOM_FEATURE_ENTRIES[customType];
if (!customFeatureEntry?.supported) return true;
try {
return customFeatureEntry.supported(this.stateObj);
} catch {
return false;
}
}
const supportsFeature = SUPPORTS_FEATURE_TYPES[type];
return !supportsFeature || supportsFeature(this.stateObj);
}
private _isFeatureTypeEditable(type: string) {
if (isCustomType(type)) {
const customType = stripCustomPrefix(type);
const customFeatureEntry = CUSTOM_FEATURE_ENTRIES[customType];
return customFeatureEntry?.configurable;
}
return EDITABLES_FEATURE_TYPES.has(type as FeatureType);
}
private _getFeatureTypeLabel(type: string) {
if (isCustomType(type)) {
const customType = stripCustomPrefix(type);
const customFeatureEntry = CUSTOM_FEATURE_ENTRIES[customType];
return customFeatureEntry?.name || type;
}
return (
this.hass!.localize(
`ui.panel.lovelace.editor.features.types.${type}.label`
) || type
);
}
private _getKey(feature: LovelaceCardFeatureConfig) {
if (!this._featuresKeys.has(feature)) {
this._featuresKeys.set(feature, Math.random().toString());
}
return this._featuresKeys.get(feature)!;
}
private _getSupportedFeaturesType() {
const featuresTypes = UI_FEATURE_TYPES.filter(
(type) => !this.featuresTypes || this.featuresTypes.includes(type)
) as readonly string[];
const customFeaturesTypes = customCardFeatures.map(
(feature) => `${CUSTOM_TYPE_PREFIX}${feature.type}`
);
return featuresTypes
.concat(customFeaturesTypes)
.filter((type) => this._supportsFeatureType(type));
}
protected render() {
if (!this.features || !this.hass) {
return nothing;
}
const supportedFeaturesType = this._getSupportedFeaturesType();
const types = supportedFeaturesType.filter((type) => !isCustomType(type));
const customTypes = supportedFeaturesType.filter((type) =>
isCustomType(type)
);
const schema = this._optionsSchema(this.hass.localize);
const data = { ...this.layout };
if (!data.type) {
data.type = "vertical";
}
return html`
<ha-expansion-panel outlined>
<h3 slot="header">
<ha-svg-icon .path=${mdiListBox}></ha-svg-icon>
${this.hass!.localize("ui.panel.lovelace.editor.features.name")}
</h3>
<div class="content">
${supportedFeaturesType.length === 0 && this.features.length === 0
? html`
<ha-alert type="info">
${this.hass!.localize(
"ui.panel.lovelace.editor.features.no_compatible_available"
)}
</ha-alert>
`
: nothing}
${supportedFeaturesType.length > 0
? html`
<ha-form
.hass=${this.hass}
.data=${data}
.schema=${schema}
.computeLabel=${this._computeLabelCallback}
@value-changed=${this._layoutChanged}
></ha-form>
`
: nothing}
<ha-sortable
handle-selector=".handle"
@item-moved=${this._featureMoved}
>
<div class="features">
${repeat(
this.features,
(featureConf) => this._getKey(featureConf),
(featureConf, index) => {
const type = featureConf.type;
const supported = this._supportsFeatureType(type);
const editable = this._isFeatureTypeEditable(type);
return html`
<div class="feature">
<div class="handle">
<ha-svg-icon .path=${mdiDrag}></ha-svg-icon>
</div>
<div class="feature-content">
<div>
<span> ${this._getFeatureTypeLabel(type)} </span>
${this.stateObj && !supported
? html`
<span class="secondary">
${this.hass!.localize(
"ui.panel.lovelace.editor.features.not_compatible"
)}
</span>
`
: nothing}
</div>
</div>
${editable
? html`
<ha-icon-button
.label=${this.hass!.localize(
`ui.panel.lovelace.editor.features.edit`
)}
.path=${mdiPencil}
class="edit-icon"
.index=${index}
@click=${this._editFeature}
.disabled=${!supported}
></ha-icon-button>
`
: nothing}
<ha-icon-button
.label=${this.hass!.localize(
`ui.panel.lovelace.editor.features.remove`
)}
.path=${mdiDelete}
class="remove-icon"
.index=${index}
@click=${this._removeFeature}
></ha-icon-button>
</div>
`;
}
)}
</div>
</ha-sortable>
${supportedFeaturesType.length > 0
? html`
<ha-button-menu
fixed
@action=${this._addFeature}
@closed=${stopPropagation}
>
<ha-button
slot="trigger"
outlined
.label=${this.hass!.localize(
`ui.panel.lovelace.editor.features.add`
)}
>
<ha-svg-icon .path=${mdiPlus} slot="icon"></ha-svg-icon>
</ha-button>
${types.map(
(type) => html`
<ha-list-item .value=${type}>
${this._getFeatureTypeLabel(type)}
</ha-list-item>
`
)}
${types.length > 0 && customTypes.length > 0
? html`<li divider role="separator"></li>`
: nothing}
${customTypes.map(
(type) => html`
<ha-list-item .value=${type}>
${this._getFeatureTypeLabel(type)}
</ha-list-item>
`
)}
</ha-button-menu>
`
: nothing}
</div>
</ha-expansion-panel>
`;
}
private async _addFeature(ev: CustomEvent): Promise<void> {
const index = ev.detail.index as number;
if (index == null) return;
const value = this._getSupportedFeaturesType()[index];
if (!value) return;
const elClass = await getCardFeatureElementClass(value);
let newFeature: LovelaceCardFeatureConfig;
if (elClass && elClass.getStubConfig) {
newFeature = await elClass.getStubConfig(this.hass!, this.stateObj);
} else {
newFeature = { type: value } as LovelaceCardFeatureConfig;
}
const newConfigFeature = this.features!.concat(newFeature);
fireEvent(this, "features-changed", { features: newConfigFeature });
}
private _featureMoved(ev: CustomEvent): void {
ev.stopPropagation();
const { oldIndex, newIndex } = ev.detail;
const newFeatures = this.features!.concat();
newFeatures.splice(newIndex, 0, newFeatures.splice(oldIndex, 1)[0]);
fireEvent(this, "features-changed", { features: newFeatures });
}
private _removeFeature(ev: CustomEvent): void {
const index = (ev.currentTarget as any).index;
const newFeatures = this.features!.concat();
newFeatures.splice(index, 1);
fireEvent(this, "features-changed", { features: newFeatures });
}
private _layoutChanged(ev: CustomEvent): void {
ev.stopPropagation();
const layout = ev.detail.value;
fireEvent(this, "layout-changed", { layout });
}
private _editFeature(ev: CustomEvent): void {
const index = (ev.currentTarget as any).index;
fireEvent(this, "edit-detail-element", {
subElementConfig: {
index,
type: "feature",
elementConfig: this.features![index],
},
});
}
static get styles(): CSSResultGroup {
return css`
:host {
display: flex !important;
flex-direction: column;
}
.content {
padding: 12px;
}
ha-expansion-panel {
display: block;
--expansion-panel-content-padding: 0;
border-radius: 6px;
}
h3 {
margin: 0;
font-size: inherit;
font-weight: inherit;
}
ha-svg-icon,
ha-icon {
color: var(--secondary-text-color);
}
ha-button-menu {
margin-top: 8px;
}
.feature {
display: flex;
align-items: center;
}
.feature .handle {
cursor: move; /* fallback if grab cursor is unsupported */
cursor: grab;
padding-right: 8px;
padding-inline-end: 8px;
padding-inline-start: initial;
direction: var(--direction);
}
.feature .handle > * {
pointer-events: none;
}
.feature-content {
height: 60px;
font-size: 16px;
display: flex;
align-items: center;
justify-content: space-between;
flex-grow: 1;
}
.feature-content div {
display: flex;
flex-direction: column;
}
.remove-icon,
.edit-icon {
--mdc-icon-button-size: 36px;
color: var(--secondary-text-color);
}
.secondary {
font-size: 12px;
color: var(--secondary-text-color);
}
li[divider] {
border-bottom-color: var(--divider-color);
}
`;
}
}
declare global {
interface HTMLElementTagNameMap {
"hui-card-features-editor": HuiCardFeaturesEditor;
}
}