Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/byteyard/fluidsizingcss
FluidSizingCSS is a pure CSS solution for responsive design, offering fluid sizing locks for seamless scaling across devices. It eliminates the need for external tools, enabling developers to create adaptable, lightweight, and fast interfaces with native CSS.
https://github.com/byteyard/fluidsizingcss
adaptive-design css fluid-sizing media-queries native-css responsive-design scaling web-development
Last synced: 2 months ago
JSON representation
FluidSizingCSS is a pure CSS solution for responsive design, offering fluid sizing locks for seamless scaling across devices. It eliminates the need for external tools, enabling developers to create adaptable, lightweight, and fast interfaces with native CSS.
- Host: GitHub
- URL: https://github.com/byteyard/fluidsizingcss
- Owner: byteyard
- License: mit
- Created: 2024-08-20T04:44:16.000Z (5 months ago)
- Default Branch: production
- Last Pushed: 2024-08-21T04:37:58.000Z (5 months ago)
- Last Synced: 2024-09-29T06:47:17.217Z (4 months ago)
- Topics: adaptive-design, css, fluid-sizing, media-queries, native-css, responsive-design, scaling, web-development
- Language: CSS
- Homepage: http://fluidsizingcss.com/
- Size: 347 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
FluidSizingCSS
## Rethink Responsive Design with Pure CSS Fluid Sizing
FluidSizingCSS is a pioneering solution for responsive design that transforms how interfaces adapt between mobile and desktop. This package offers the world's first pure CSS implementation of fluid sizing locks, eliminating the need for SCSS or external tools. Designed for developers and loved by designers, it enables perfect fluid scaling using only native CSS, making your site more adaptable, lighter, and faster.
> [!TIP]
> See the [FluidSizingCSS Demo](https://codepen.io/arinker/pen/poXLzBG) on CodePen.
---
## Table of Contents
1. [Installation](#installation)
- [Via npm](#via-npm)
- [Optional: Smaller CSS Files](#optional-smaller-css-files)
- [Via CDN](#via-cdn)
1. [File Sizes](#file-sizes)
1. [How It Works](#how-it-works)
- [Example Usage](#example-usage)
- [Global Settings](#global-settings)
1. [Complete List of Fluid Properties](#complete-list-of-fluid-properties)
- [Common Fluid Properties](#common-fluid-properties)
- [Logical Fluid Properties](#logical-fluid-properties)
- [Physical Fluid Properties](#physical-fluid-properties)
1. [License](#license)
---
## Installation
### Via npm
1. **Install FluidSizingCSS**:
```bash
npm install fluidsizingcss
```
2. **Import the CSS file** into your project based on the framework you’re using:
- **React**: Import in your JavaScript/TypeScript file:
```javascript
import 'fluidsizingcss/all';
```
- **Vue.js**: Import in your entry file:
```javascript
import 'fluidsizingcss/all';
```
- **Angular**: Add to the `styles` array in `angular.json`:
```json
"styles": [
"node_modules/fluidsizingcss/dist/fluidsizingcss.min.css",
"src/styles.css"
]
```
- **HTML/Vanilla JavaScript**: Add to your HTML ``:
```html
```
- **SASS/SCSS**: Import in your main SASS/SCSS file:
```scss
@import 'node_modules/fluidsizingcss/dist/fluidsizingcss.min.css';
```
### Optional: Smaller CSS Files
To improve performance, you can choose specialized versions of FluidSizingCSS:
- **Logical Properties Only** (e.g., `block-size`, `inline-size`):
```javascript
import 'fluidsizingcss/logical';
```
- **Physical Properties Only** (e.g., `height`, `width`):
```javascript
import 'fluidsizingcss/physical';
```
### Via CDN
Alternatively, include FluidSizingCSS directly in your HTML:
- **Full Version**:
```html
```
```html
```
- **Logical Properties Only**:
```html
```
```html
```
- **Physical Properties Only**:
```html
```
```html
```
---
### File Sizes
The following table provides an overview of the different versions of FluidSizingCSS files, including their standard CSS size, minified size, and the size after Brotli compression. This information helps you understand the trade-offs between file size and performance optimization in your project.
| File Name | Raw | Minified | Brotli compressed |
|-------------------------------|------------|-----------------|------------------------|
| `fluidsizingcss.css` | 49.22 KB | 38.03 KB | 2.69 KB |
| `fluidsizingcss-logical.css` | 33.56 KB | 25.8 KB | 1.91 KB |
| `fluidsizingcss-physical.css` | 28.12 KB | 21.35 KB | 1.93 KB |
---
## How It Works
FluidSizingCSS leverages CSS custom properties, `calc()`, and `clamp()` to implement fluid sizing techniques. This method enables smooth adaptation of typography and design elements across different devices, avoiding the abrupt changes typically associated with traditional breakpoints.
### Example Usage
To define fluid sizing for a heading, include the following in your CSS:
> [!CAUTION]
> All values must be unitless to ensure compatibility with CSS mathematical operations.
```css
:root {
--s-min: 400; /* Lower Lock: Min Screen Size */
--s-max: 1400; /* Upper Lock: Max Screen Size */
}
h1 {
font-size: var(--fs);
--fs-min: 60; /* Minimum Font Size */
--fs-max: 240; /* Maximum Font Size */
line-height: var(--lh);
--lh-min: 60; /* Minimum Line-Height */
--lh-max: 240; /* Maximum Line-Height */
}
```
### Global Settings
Set global minimum and maximum screen sizes and base font size at the `:root` level:
```css
@layer fluid, base;
@layer base {
:root {
--s-min: 400; /* Screen Size Min for General Fluid Sizing */
--s-max: 1400; /* Screen Size Max for General Fluid Sizing */
--rem: 16; /* Pixel per REM for General Fluid Sizing */
}
}
```
---
## Complete List of Fluid Properties
FluidSizingCSS provides a comprehensive set of fluid properties, allowing you to create responsive and adaptive designs across different screen sizes. These properties are categorized into
* Common Fluid Properties,
* Logical Fluid Properties and
* Physical Fluid Properties.
### Common Fluid Properties
These are general properties like margins, padding, and text formatting that apply universally, ensuring consistent fluid responsiveness across your design.
#### Text Formatting
- **font-size:** `--fs`
- **line-height:** `--lh`
- **letter-spacing:** `--ls`
- **word-spacing:** `--ws`
- **text-indent:** `--ti`
- **text-decoration-thickness:** `--tdt`
- **text-underline-offset:** `--tuo`
#### Margin
- **margin:** `--m`
#### Padding
- **padding:** `--p`
#### Border Width
- **border-width:** `--bw`
#### Border Radius
- **border-radius:** `--br`
#### Outline
- **outline-width:** `--ow`
- **outline-offset:** `--oo`
#### Inset
- **inset:** `--i`
#### Grid, Flex, and Columns
- **grid-auto-columns:** `--gac`
- **grid-auto-rows:** `--gar`
- **gap:** `--g`
- **column-gap:** `--cg`
- **row-gap:** `--rg`
- **column-width:** `--cw`
- **column-rule-width:** `--crw`
- **flex-basis:** `--fb`
#### Background
- **background-position-x:** `--bpx`
- **background-position-y:** `--bpy`
#### Scroll
- **scroll-margin:** `--sm`
- **scroll-padding:** `--sp`
### Logical Fluid Properties
These properties adjust layout dimensions and spacing using logical directions (e.g., block, inline) relative to writing modes, enhancing adaptability across different content flows.
#### Block
- **block-size:** `--bs`
- **min-block-size:** `--minbs`
- **max-block-size:** `--maxbs`
#### Inline
- **inline-size:** `--is`
- **min-inline-size:** `--minis`
- **max-inline-size:** `--maxis`
#### Margin
- **margin-block:** `--mb`
- **margin-block-start:** `--mbs`
- **margin-block-end:** `--mbe`
- **margin-inline:** `--mi`
- **margin-inline-start:** `--mis`
- **margin-inline-end:** `--mie`
#### Padding
- **padding-block:** `--pb`
- **padding-block-start:** `--pbs`
- **padding-block-end:** `--pbe`
- **padding-inline:** `--pi`
- **padding-inline-start:** `--pis`
- **padding-inline-end:** `--pie`
#### Border Width
- **border-block-width:** `--bbw`
- **border-block-start-width:** `--bbsw`
- **border-block-end-width:** `--bbew`
- **border-inline-width:** `--biw`
- **border-inline-start-width:** `--bisw`
- **border-inline-end-width:** `--biew`
#### Border Radius
- **border-start-start-radius:** `--bssr`
- **border-start-end-radius:** `--bser`
- **border-end-end-radius:** `--beer`
- **border-end-start-radius:** `--besr`
#### Inset
- **inset-block:** `--ib`
- **inset-block-start:** `--ibs`
- **inset-block-end:** `--ibe`
- **inset-inline:** `--ii`
- **inset-inline-start:** `--iis`
- **inset-inline-end:** `--iie`
#### Scroll
- **scroll-margin-block:** `--smb`
- **scroll-margin-block-start:** `--smbs`
- **scroll-margin-block-end:** `--smbe`
- **scroll-margin-inline:** `--smi`
- **scroll-margin-inline-start:** `--smis`
- **scroll-margin-inline-end:** `--smie`
- **scroll-padding-block:** `--spb`
- **scroll-padding-block-start:** `--spbs`
- **scroll-padding-block-end:** `--spbe`
- **scroll-padding-inline:** `--spi`
- **scroll-padding-inline-start:** `--spis`
- **scroll-padding-inline-end:** `--spie`
### Physical Fluid Properties
These properties control physical dimensions (e.g., height, width) and positions (e.g., top, left) based on the viewport, allowing precise fluid scaling of elements.
#### Height
- **height:** `--h`
- **min-height:** `--minh`
- **max-height:** `--maxh`
#### Width
- **width:** `--w`
- **min-width:** `--minw`
- **max-width:** `--maxw`
#### Margin
- **margin-top:** `--mt`
- **margin-bottom:** `--mgb`
- **margin-left:** `--ml`
- **margin-right:** `--mr`
#### Padding
- **padding-top:** `--pt`
- **padding-bottom:** `--pb`
- **padding-left:** `--pl`
- **padding-right:** `--pr`
#### Border Width
- **border-top-width:** `--btw`
- **border-bottom-width:** `--bbwth`
- **border-left-width:** `--blw`
- **border-right-width:** `--bbrw`
#### Border Radius
- **border-top-left-radius:** `--btlr`
- **border-top-right-radius:** `--btrr`
- **border-bottom-right-radius:** `--bbrr`
- **border-bottom-left-radius:** `--bblr`
#### Inset
- **top:** `--top`
- **bottom:** `--bot`
- **left:** `--lft`
- **right:** `--rgt`
#### Scroll
- **scroll-margin-top:** `--smt`
- **scroll-margin-bottom:** `--smb`
- **scroll-margin-left:** `--sml`
- **scroll-margin-right:** `--smr`
- **scroll-padding-top:** `--spt`
- **scroll-padding-bottom:** `--spbt`
- **scroll-padding-left:** `--spl`
- **scroll-padding-right:** `--spr`
## License
FluidSizingCSS is licensed under the MIT License.