Slider Button Card 开源项目教程

Slider Button Card 开源项目教程

slider-button-cardA button card with integrated slider项目地址:https://gitcode.com/gh_mirrors/sl/slider-button-card

项目介绍

Slider Button Card 是一个为 Home Assistant 设计的自定义 Lovelace 卡片，它结合了按钮和滑动条的功能。这个卡片允许用户通过滑动或点击按钮来控制 Home Assistant 中的实体，如风扇、开关、窗帘等。Slider Button Card 提供了丰富的自定义选项，包括滑动方向、背景样式、图标显示等，使得用户界面更加直观和个性化。

项目快速启动

安装步骤

1. 通过 HACS 安装：

   • 打开 Home Assistant 的 HACS 界面。
   • 在“前端”标签中搜索 Slider Button Card。
   • 点击安装并重启 Home Assistant。

2. 手动下载安装：

   • 从 GitHub 仓库 下载 slider-button-card.js 文件。
   • 将文件放入 Home Assistant 配置目录下的 config/www 文件夹。
   • 在 Home Assistant 的配置页面中，进入 Lovelace Dashboards -> Resources，点击添加资源，设置 URL 为 /local/slider-button-card.js，资源类型为 JavaScript 模块。

配置示例

以下是一个基本的配置示例，展示如何在 Lovelace 界面中添加一个 Slider Button Card：

type: custom:slider-button-card
entity: fan.living_fan
slider:
  direction: left-right
  background: triangle
  show_track: true
icon:
  tap_action:
    action: more-info
action_button:
  tap_action:
    action: toggle
  mode: custom
name: Fan Switch

应用案例和最佳实践

控制风扇

使用 Slider Button Card 控制风扇，可以通过滑动条调整风速，点击按钮切换开关状态：

type: custom:slider-button-card
entity: fan.living_fan
slider:
  direction: left-right
  background: triangle
  show_track: true
icon:
  tap_action:
    action: more-info
action_button:
  tap_action:
    action: toggle
  mode: custom
name: Fan Switch

控制开关

对于开关类型的实体，可以使用滑动条作为开关，点击按钮进行更多操作：

type: custom:slider-button-card
entity: switch.socket
slider:
  direction: left-right
  background: custom
  toggle_on_click: true
icon:
  use_state_color: true
tap_action:
  action: more-info
action_button:
  tap_action:
    action: toggle
  mode: custom
name: Switch Cover

典型生态项目

Slider Button Card 可以与其他 Home Assistant 的自定义卡片和组件结合使用，以实现更复杂和个性化的用户界面。以下是一些典型的生态项目：

• Light Group Card：用于控制多个灯光实体的卡片。
• Cover Group Card：用于控制多个窗帘实体的卡片。
• Media Player Group Card：用于控制多个媒体播放器实体的卡片。

通过这些生态项目的结合，可以创建一个统一且功能丰富的 Home Assistant 控制界面。

slider-button-cardA button card with integrated slider项目地址:https://gitcode.com/gh_mirrors/sl/slider-button-card