https://github.com/ivteplo/html-sheet-element
HTML Custom Element for Creating Sheets
https://github.com/ivteplo/html-sheet-element
bottom-sheet components css html html-custom-elements javascript pure-javascript sheet ui-components web-components web-components-api
Last synced: 10 months ago
JSON representation
HTML Custom Element for Creating Sheets
- Host: GitHub
- URL: https://github.com/ivteplo/html-sheet-element
- Owner: ivteplo
- License: apache-2.0
- Created: 2022-05-15T13:57:23.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-01T20:42:06.000Z (11 months ago)
- Last Synced: 2025-03-29T03:06:38.386Z (10 months ago)
- Topics: bottom-sheet, components, css, html, html-custom-elements, javascript, pure-javascript, sheet, ui-components, web-components, web-components-api
- Language: JavaScript
- Homepage:
- Size: 172 KB
- Stars: 95
- Watchers: 1
- Forks: 14
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# HTML Sheet Element
HTML Custom Element for creating sheets. Displayed as a bottom sheet on mobile and a centered sheet on desktop.
## Features
- There is a handle at the top of the sheet that can be used to open or close the sheet
- The sheet can be closed using a button in the sheet header, using the `Esc` key, or by clicking outside the bottom sheet
- This behavior is configurable. You can turn off the `Esc` or the click outside the sheet when you want.
- API is similar to the `` element's
- Supports forms inside of it
- Uses familiar method names and the same event names
- There are many customization options
## Installation
You can install this library from the npm registry:
```bash
npm install @ivteplo/html-sheet-element
```
Or you can import it dynamically from a CDN:
```javascript
const { SheetElement } = await import("https://unpkg.com/@ivteplo/html-sheet-element@1.0.0/build/index.js")
```
## Usage
Before being able to use the element in your HTML, you need to specify a tag name for it using JavaScript:
```javascript
import { SheetElement } from "@ivteplo/html-sheet-element"
// You can choose another tag name instead of `ui-sheet`
SheetElement.defineAs("ui-sheet")
```
Then you can use the tag in your HTML:
```html
Hello World!
```
To open a sheet, call the element's `showModal` method:
```javascript
const sheet = document.querySelector("ui-sheet")
sheet.showModal()
```
## API Documentation
You can find API documentation [here](./documentation/API.md).
## Development
### Prerequisites
You need to have Git, Node.js, Deno, and any browser installed.
### Setup
1. Open your terminal
2. Clone this repository
```bash
git clone https://github.com/ivteplo/html-sheet-element/
```
3. Navigate into the cloned directory
```bash
cd html-sheet-element
```
4. Install dependencies
```bash
npm install
```
5. Start the development server
```bash
npm run dev
```
6. Build the library
```bash
npm run build
```
7. Build the API documentation
```bash
npm run docs:api
```
8. Happy hacking :tada: