A Guides component that can draw ruler and manage guidelines.
Demo / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i @scena/guides ``` ### scripts ```html ``` ## 🚀 How to use ```tsx import Guides from "@scena/guides"; const guides = new Guides(document.body, { type: "horizontal", }).on("changeGuides", e => { console.log(e.guides); }); let scrollX = 0; let scrollY = 0; window.addEventListener("resize", () => { guides.resize(); }); window.addEventListener("wheel", e => { scrollX += e.deltaX; scrollY += e.deltaY; guides.scrollGuides(scrollY); guides.scroll(scrollX); }); ``` ### Ruler Units The default unit is px, and a line is drawn every 50px. If you want to use a different unit instead of the px unit, use it like this: * 1px (Default) * zoom: 1 * unit: 50 (every 50px) * 1cm = 37.7952px * zoom: 37.7952 * unit: 1 (every 1cm) * 1in = 96px = 2.54cm * zoom: 96 * unit: 1 (every 1in) See: - https://www.w3schools.com/cssref/css_units.asp - https://www.scaler.com/topics/css/css-units/ ## ⚙️ Developments The `guides` repo is managed as a [monorepo](https://github.com/lerna/lerna) with `yarn`. ```sh yarn config set registry https://registry.npmjs.org/ ``` ## ⭐️ Show Your Support Please give a ⭐️ if this project helped you! ## 👏 Contributing If you have any questions or requests or want to contribute to `guides` or other packages, please write the [issue](https://github.com/daybrush/guides/issues) or give me a Pull Request freely. ## 🐞 Bug Report If you find a bug, please report to us opening a new [Issue](https://github.com/daybrush/guides/issues) on GitHub. ## 📝 License This project is [MIT](https://github.com/daybrush/guides/blob/master/LICENSE) licensed. ``` MIT License Copyright (c) 2019 Daybrush Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ``` ================================================ FILE: config/update-type-consts.js ================================================ const path = require("path"); const { convertProperties } = require("@daybrush/release/angular"); const { PROPERTIES, EVENTS } = require("../packages/react-guides/dist/guides.cjs.js"); convertProperties( { ANGULAR_GUIDES_INPUTS: PROPERTIES, ANGULAR_GUIDES_OUTPUTS: EVENTS, }, [ path.resolve(__dirname, "../packages/ngx-guides/projects/ngx-guides/src/public-api.ts"), ], ); ================================================ FILE: demo/index.css ================================================ @import url("https://fonts.googleapis.com/css?family=Open+Sans:300,400,600&display=swap"); @import url("https://fonts.googleapis.com/css?family=Roboto:100&display=swap"); html, body { font-family: "Open Sans", sans-serif; position: relative; margin: 0; padding: 0; height: 100%; color: #333; letter-spacing: 1px; background: #f5f5f5; font-weight: 300; touch-action: manipulation; } #root, .page { position: relative; width: 100%; height: 100%; overflow: hidden; } a { text-decoration: none; color: #333; } .ruler { position:absolute; top: 0; left: 0; } .ruler.horizontal { left: 0px; width: 100%; height: 30px; } .ruler.vertical { top: 0px; width: 30px; height: 100%; } .box { position: relative; width: 30px; height: 30px; background: #444; box-sizing: border-box; z-index: 21; } .box:before, .box:after { position: absolute; content: ""; background: #777; } .box:before { width: 1px; height: 100%; left: 100%; } .box:after { height: 1px; width: 100%; top: 100%; } .container { position: relative; top: 50%; left: 50%; transform: translate(-50%, -50%); text-align: center; max-width: calc(100% - 60px); width: 100%; } .badges { padding: 10px; } .badges img { height: 20px; margin: 0px 2px; } .buttons { text-align: center; margin: 0; padding: 10px; } .buttons a { margin: 0; position: relative; text-decoration: none; color: #333; border: 1px solid #333; padding: 12px 30px; min-width: 140px; text-align: center; display: inline-block; box-sizing: border-box; margin: 5px; transition: all ease 0.5s; } .buttons a:hover { background: #333; color: #fff; } p { padding: 0; margin: 0; } .dragit { font-weight: bold; } ================================================ FILE: demo/index.html ================================================
Drag Screen & Rulers!
A Guides component that can draw ruler and manage guidelines.
A Guides component that can draw ruler and manage guidelines.
Demo / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i @scena/guides ``` ### scripts ```html ``` ## 🚀 How to use ```tsx import Guides from "@scena/guides"; const guides = new Guides(document.body, { type: "horizontal", }).on("changeGuides", e => { console.log(e.guides); }); let scrollX = 0; let scrollY = 0; window.addEventListener("resize", () => { guides.resize(); }); window.addEventListener("wheel", e => { scrollX += e.deltaX; scrollY += e.deltaY; guides.scrollGuides(scrollY); guides.scroll(scrollX); }); ``` ### Ruler Units The default unit is px, and a line is drawn every 50px. If you want to use a different unit instead of the px unit, use it like this: * 1px (Default) * zoom: 1 * unit: 50 (every 50px) * 1cm = 37.7952px * zoom: 37.7952 * unit: 1 (every 1cm) * 1in = 96px = 2.54cm * zoom: 96 * unit: 1 (every 1in) See: https://www.w3schools.com/cssref/css_units.asp ## ⚙️ Developments ### `npm run demo:start` Runs the app in the development mode.
An Angular Guides component that can draw grids and scroll infinitely.
Demo / CodeSandbox / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i ngx-guides ``` ## 🚀 How to use * app.component.html ```html
An Angular Guides component that can draw grids and scroll infinitely.
Demo / CodeSandbox / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i ngx-guides ``` ## 🚀 How to use * app.component.html ```htmlHere are some links to help you get started:
What do you want to do next with your app?
ng generate component xyz
ng add @angular/material
ng add @angular/pwa
ng add _____
ng test
ng build
A Preact Guides component that can draw ruler and manage guidelines.
Demo / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i preact-guides ``` ## 🚀 How to use ```tsx import { Component, h } from "preact"; import Guides from "preact-guides"; export default class App extends Component { render() { return (
A React Guides component that can draw ruler and manage guidelines.
Demo / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i @scena/react-guides ``` ## 🚀 How to use * [React Codesandbox Demo](https://codesandbox.io/s/react-guides-dpwyqr) ```tsx import * as React from "react"; import Guides from "@scena/react-guides"; export default class App extends React.Component { render() { return (
Drag Screen & Rulers!
/
A React Guides component that can draw ruler and manage guidelines.
A Svelte Guides component that can draw ruler and manage guidelines.
Demo / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i svelte-guides ``` ## 🚀 How to use ```html
Drag Screen & Rulers!
A Svelte Guides component that can draw ruler and manage guidelines.
A Vue Guides component that can draw grids and scroll infinitely.
Demo / Vue 3 / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i vue-guides ``` ## 🚀 How to use ```html
Drag Screen & Rulers!
A Svelte Guides component that can draw ruler and manage guidelines.
A Vue 3 Guides component that can draw grids and scroll infinitely.
Demo / Vue 2 / API / Ruler / Main Project
## ⚙️ Installation ### npm ```sh $ npm i vue3-guides ``` ## 🚀 How to use ```html
Drag Screen & Rulers!
A Svelte Guides component that can draw ruler and manage guidelines.
