-
-
Notifications
You must be signed in to change notification settings - Fork 15
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
MHA
committed
Jun 28, 2020
1 parent
1fa2259
commit a20c402
Showing
9 changed files
with
42 additions
and
2,579 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,3 @@ | ||
| /node_modules/ | ||
| /.rpt2_cache/ | ||
| package-lock.json | ||
| /dist |
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,119 +1,69 @@ | ||
| # Select list Card by [@mha](https://github.com/mattieha) | ||
|
|
||
| A community driven boilerplate of best practices for Home Assistant Lovelace custom cards | ||
| # Select list Card by [@mattieha](https://github.com/mattieha) | ||
|
|
||
| [![GitHub Release][releases-shield]][releases] | ||
| [![License][license-shield]](LICENSE.md) | ||
| [](https://github.com/custom-components/hacs) | ||
|
|
||
| ![Project Maintenance][maintenance-shield] | ||
| [![GitHub Activity][commits-shield]][commits] | ||
|
|
||
| [![Discord][discord-shield]][discord] | ||
| [![Community Forum][forum-shield]][forum] | ||
|
|
||
| ## Support | ||
|
|
||
| Hey dude! Help me out for a couple of :beers: or a :coffee:! | ||
|
|
||
| [](https://www.buymeacoffee.com/zJtVxUAgH) | ||
|
|
||
| ## Options | ||
| [](https://github.com/custom-components/hacs) | ||
|
|
||
| | Name | Type | Requirement | Description | Default | | ||
| | ----------------- | ------- | ------------ | ------------------------------------------- | ------------------- | | ||
| | type | string | **Required** | `custom:boilerplate-card` | | ||
| | name | string | **Optional** | Card name | `Boilerplate` | | ||
| | show_error | boolean | **Optional** | Show what an error looks like for the card | `false` | | ||
| | show_warning | boolean | **Optional** | Show what a warning looks like for the card | `false` | | ||
| | entity | string | **Optional** | Home Assistant entity ID. | `none` | | ||
| | tap_action | object | **Optional** | Action to take on tap | `action: more-info` | | ||
| | hold_action | object | **Optional** | Action to take on hold | `none` | | ||
| | double_tap_action | object | **Optional** | Action to take on hold | `none` | | ||
| Display an input_select entity as a list | ||
|
|
||
| ## Action Options | ||
| ## Usage | ||
|
|
||
| | Name | Type | Requirement | Description | Default | | ||
| | --------------- | ------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | ||
| | action | string | **Required** | Action to perform (more-info, toggle, call-service, navigate url, none) | `more-info` | | ||
| | navigation_path | string | **Optional** | Path to navigate to (e.g. /lovelace/0/) when action defined as navigate | `none` | | ||
| | url | string | **Optional** | URL to open on click when action is url. The URL will open in a new tab | `none` | | ||
| | service | string | **Optional** | Service to call (e.g. media_player.media_play_pause) when action defined as call-service | `none` | | ||
| | service_data | object | **Optional** | Service data to include (e.g. entity_id: media_player.bedroom) when action defined as call-service | `none` | | ||
| | haptic | string | **Optional** | Haptic feedback for the [Beta IOS App](http://home-assistant.io/ios/beta) _success, warning, failure, light, medium, heavy, selection_ | `none` | | ||
| | repeat | number | **Optional** | How often to repeat the `hold_action` in milliseconds. | `non` | | ||
| ### Visual Editor | ||
|
|
||
| ## Starting a new card from boilerplate-card | ||
| Select List Card supports Lovelace's Visual Editor. Click the + button to add a card and search for select list. | ||
|
|
||
| ### Step 1 | ||
|  | ||
|
|
||
| Clone this repository | ||
| ## Examples | ||
|
|
||
| ### Step 2 | ||
| ### Default config | ||
|
|
||
| Install necessary modules (verified to work in node 8.x) | ||
| `yarn install` or `npm install` | ||
|  | ||
|
|
||
| ```yaml | ||
| type: 'custom:select-list-card' | ||
| entity: input_select.scenes | ||
| ``` | ||
| ### Step 3 | ||
| ## Options | ||
| Do a test lint & build on the project. You can see available scripts in the package.json | ||
| `npm run build` | ||
| | Name | Type | Requirement | Description | Default | | ||
| | ----------------- | ------- | ------------ | ------------------------------------------- | ------------------- | | ||
| | type | string | **Required** | `custom:select-list-card` | | ||
| | name | string | **Optional** | Card name | `` | | ||
| | entity | string | **Optional** | Home Assistant input_select ID. | `none` | | ||
| | truncate | boolean | **Optional** | Truncate option text | `true` | | ||
| | scrollInToView | boolean | **Optional** | Scroll active item in to view | `true` | | ||
| | maxHeight | string | **Optional** | Max height of the list | `350` | | ||
|
|
||
| ### Step 4 | ||
|
|
||
| Search the repository for all instances of "TODO" and handle the changes/suggestions | ||
| ## Installation | ||
|
|
||
| ### Step 5 | ||
| ### HACS | ||
|
|
||
| Customize to suit your needs and contribute it back to the community | ||
| Install using [HACS](https://hacs.xyz) and add the following to your config: | ||
|
|
||
|
|
||
| ## Starting a new card from boilerplate-card with [devcontainer][devcontainer] | ||
| ```yaml | ||
| resources: | ||
| - url: /hacsfiles/select-list-card/select-list-card.js | ||
| type: module | ||
| ``` | ||
|
|
||
| Note: this is available only in vscode ensure you have the [Remote Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension installed. | ||
| ### Manual | ||
|
|
||
| 1. Fork and clone the repository. | ||
| 2. Open a [devcontainer][devcontainer] terminal and run `npm start` when it's ready. | ||
| 3. The compiled `.js` file will be accessible on | ||
| `http://127.0.0.1:5000/boilerplate-card.js`. | ||
| 4. On a running Home Assistant installation add this to your Lovelace | ||
| `resources:` | ||
| Download select-list-card.js from the [latest realease](https://github.com/mattieha/select-list-card/releases/latest) and place it in your `config/www` folder. Add the following to your config: | ||
|
|
||
| ```yaml | ||
| - url: "http://127.0.0.1:5000/boilerplate-card.js" | ||
| type: module | ||
| resources: | ||
| - url: /local/select-list-card.js | ||
| type: module | ||
| ``` | ||
|
|
||
| _Change "127.0.0.1" to the IP of your development machine._ | ||
| ### Bonus | ||
|
|
||
| If you need a fresh test instance you can install a fresh Home Assistant instance inside the devcontainer as well. | ||
|
|
||
| 1. Run the command `dc start`. | ||
| 2. Home Assistant will install and will eventually be running on port `9123` | ||
| ## Support | ||
|
|
||
| ## [Troubleshooting](https://github.com/thomasloven/hass-config/wiki/Lovelace-Plugins) | ||
| NB This will not work with node 9.x if you see the following errors try installing node 8.10.0 | ||
| ```yarn install | ||
| yarn install v1.3.2 | ||
| [1/4] 🔍 Resolving packages... | ||
| warning [email protected]: This package has been deprecated and is no longer maintained. Please use @rollup/plugin-commonjs. | ||
| [2/4] 🚚 Fetching packages... | ||
| error @typescript-eslint/[email protected]: The engine "node" is incompatible with this module. Expected version "^8.10.0 || ^10.13.0 || >=11.10.1". | ||
| error Found incompatible module | ||
| info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command. | ||
| ``` | ||
| Hey dude! Help me out for a couple of :beers: or a :coffee:! | ||
|
|
||
| [commits-shield]: https://img.shields.io/github/commit-activity/y/custom-cards/boilerplate-card.svg?style=for-the-badge | ||
| [commits]: https://github.com/custom-cards/boilerplate-card/commits/master | ||
| [devcontainer]: https://code.visualstudio.com/docs/remote/containers | ||
| [discord]: https://discord.gg/5e9yvq | ||
| [discord-shield]: https://img.shields.io/discord/330944238910963714.svg?style=for-the-badge | ||
| [forum-shield]: https://img.shields.io/badge/community-forum-brightgreen.svg?style=for-the-badge | ||
| [forum]: https://community.home-assistant.io/c/projects/frontend | ||
| [license-shield]: https://img.shields.io/github/license/custom-cards/boilerplate-card.svg?style=for-the-badge | ||
| [maintenance-shield]: https://img.shields.io/maintenance/yes/2019.svg?style=for-the-badge | ||
| [releases-shield]: https://img.shields.io/github/release/custom-cards/boilerplate-card.svg?style=for-the-badge | ||
| [releases]: https://github.com/custom-cards/boilerplate-card/releases | ||
| [](https://www.buymeacoffee.com/mattijsha) |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.