# chmod-checkbox

> Simple and ready to use chmod based checkbox web component with StencilJS

Latest version **0.0.41** (published 2019-10-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install chmod-checkbox
pnpm add chmod-checkbox
yarn add chmod-checkbox
bun add chmod-checkbox
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.41 |
| Published | 2019-10-02 |
| First published | 2019-10-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 222.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | freakycoder |

## Links

- npm: https://www.npmjs.com/package/chmod-checkbox
- npm.io page: https://npm.io/package/chmod-checkbox

## Recent versions

- 0.0.41 (latest) — 2019-10-02
- 0.0.4 — 2019-10-02
- 0.0.37 — 2019-10-02
- 0.0.35 — 2019-10-02
- 0.0.33 — 2019-10-01
- 0.0.31 — 2019-10-01
- 0.0.3 — 2019-10-01
- 0.0.25 — 2019-10-01
- 0.0.24 — 2019-10-01
- 0.0.23 — 2019-10-01
- 0.0.22 — 2019-10-01
- 0.0.21 — 2019-10-01
- 0.0.2 — 2019-10-01
- 0.0.11 — 2019-10-01
- 0.0.1 — 2019-10-01

## README

![Built With Stencil](https://img.shields.io/badge/-Built%20With%20Stencil-16161d.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBHZW5lcmF0b3I6IEFkb2JlIElsbHVzdHJhdG9yIDE5LjIuMSwgU1ZHIEV4cG9ydCBQbHVnLUluIC4gU1ZHIFZlcnNpb246IDYuMDAgQnVpbGQgMCkgIC0tPgo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IgoJIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiBzdHlsZT0iZW5hYmxlLWJhY2tncm91bmQ6bmV3IDAgMCA1MTIgNTEyOyIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI%2BCjxzdHlsZSB0eXBlPSJ0ZXh0L2NzcyI%2BCgkuc3Qwe2ZpbGw6I0ZGRkZGRjt9Cjwvc3R5bGU%2BCjxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik00MjQuNywzNzMuOWMwLDM3LjYtNTUuMSw2OC42LTkyLjcsNjguNkgxODAuNGMtMzcuOSwwLTkyLjctMzAuNy05Mi43LTY4LjZ2LTMuNmgzMzYuOVYzNzMuOXoiLz4KPHBhdGggY2xhc3M9InN0MCIgZD0iTTQyNC43LDI5Mi4xSDE4MC40Yy0zNy42LDAtOTIuNy0zMS05Mi43LTY4LjZ2LTMuNkgzMzJjMzcuNiwwLDkyLjcsMzEsOTIuNyw2OC42VjI5Mi4xeiIvPgo8cGF0aCBjbGFzcz0ic3QwIiBkPSJNNDI0LjcsMTQxLjdIODcuN3YtMy42YzAtMzcuNiw1NC44LTY4LjYsOTIuNy02OC42SDMzMmMzNy45LDAsOTIuNywzMC43LDkyLjcsNjguNlYxNDEuN3oiLz4KPC9zdmc%2BCg%3D%3D&colorA=16161d&style=for-the-badge)


<img alt="WebComponent Chmod Checkbox" src="assets/logo.png" width="1050"/>


[![CHMOD based animated checkbox WebComponent with StencilJS](https://img.shields.io/badge/-CHMOD%20based%20animated%20checkbox%20WebComponent%20with%20StencilJS-lightgrey?style=for-the-badge)](https://github.com/WrathChaos/web-component-chmod-checkbox)


[![npm version](https://img.shields.io/npm/v/chmod-checkbox.svg?style=for-the-badge)](https://www.npmjs.com/package/chmod-checkbox)
[![npm](https://img.shields.io/npm/dt/chmod-checkbox.svg?style=for-the-badge)](https://www.npmjs.com/package/chmod-checkbox)
![Platform - Android and iOS](https://img.shields.io/badge/platform-Android%20%7C%20iOS-blue.svg?style=for-the-badge)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
[![styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg?style=for-the-badge)](https://github.com/prettier/prettier)




<p align="center">
  <img alt="WebComponent Chmod Checkbox" src="assets/Screenshots/example.gif" />
  <img alt="WebComponent Chmod Checkbox" src="assets/Screenshots/example.png" />
</p>


Chmod Checkbox comes with three (3) animated checkbox which includes READ, WRITE and EXECUTE values. These text values are customizable. It has built-in chmod calculator for each value. 


## Fundamental CHMOD Architecture


| Value | R   | W   | X   | Description   |
| ----- | --- | --- | --- | ------------- |
| 0     | 0   | 0   | 0   | NO_PERMISSION |
| 1     | 1   | 0   | 0   | READ          |
| 2     | 0   | 1   | 0   | WRITE         |
| 3     | 1   | 1   | 0   | READ/WRITE    |
| 4     | 0   | 0   | 1   | EXECUTE       |
| 5     | 1   | 0   | 1   | READ/EXECUTE  |
| 6     | 0   | 1   | 1   | WRITE/EXECUTE |
| 7     | 1   | 1   | 1   | ALL           |


## Installation

### Script tag (Recommended: Painless)
- Put a script tag similar to this `<script src="https://unpkg.com/chmod-checkbox@latest/dist/chmod-checkbox.js"></script>` in the head of your index.html
- Then you can use the element anywhere in your template, JSX, html etc

### Node Modules
- Run `npm install chmod-checkbox --save`
- Put a script tag similar to this `<script src='node_modules/chmod-checkbox/dist/chmod-checkbox.js'></script>` in the head of your index.html
- Then you can use the element anywhere in your template, JSX, html etc

### In a stencil-starter app
- Run `npm install chmod-checkbox --save`
- Add an import to the npm packages `import chmod-checkbox;`
- Then you can use the element anywhere in your template, JSX, html etc

# Usage

```html
<chmod-checkbox permission="0" />
```

## How to get value from a prop?

```javascript
document.querySelectorAll("chmod-checkbox")[0].base
document.querySelectorAll("chmod-checkbox")[0].permission
document.querySelectorAll("chmod-checkbox")[0].first
document.querySelectorAll("chmod-checkbox")[0].middle
document.querySelectorAll("chmod-checkbox")[0].last

```

### Configuration - Props


| Property   |  Type  | Default | Description                       |
| ---------- | :----: | :-----: | --------------------------------- |
| permission | number |    0    | get the changing permission value |


### Future Plans

- [x] ~~LICENSE~~
- [ ] Customizable colors
- [ ] Make another web-component with just animated checkbox and implement it on this library
- [ ] Write an article about the lib on Medium


## Author

FreakyCoder, kurayogun@gmail.com

## License

WebComponent Chmod Checkbox is available under the MIT license. See the LICENSE file for more info.

---
_Source: https://npm.io/package/chmod-checkbox · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._