Normalization of a CSS z-index value to a 32-bit floating-point number
Note
This project is a work in progress, so please watch for a new release and ensure to use the latest version.
Origin
I struggled to map CSS z-index values to 32-bit floating-point numbers between 0.0 and 1.0 because dividing a large number by another large number, such as 2_147_483_646.0 / 2_147_483_647.0
, does not yield precise results.
To illustrate the issue, here are some examples (see playground):
2_147_483_646.0 / 2_147_483_647.0 = 1.0
2_147_483_645.0 / 2_147_483_647.0 = 1.0
2_147_483_644.0 / 2_147_483_647.0 = 1.0
2_147_483_643.0 / 2_147_483_647.0 = 1.0
2_147_483_642.0 / 2_147_483_647.0 = 1.0
2_147_483_641.0 / 2_147_483_647.0 = 1.0
2_147_483_640.0 / 2_147_483_647.0 = 1.0
2_147_483_639.0 / 2_147_483_647.0 = 1.0
2_147_483_638.0 / 2_147_483_647.0 = 1.0
2_147_483_637.0 / 2_147_483_647.0 = 1.0
I spent some time experimenting to figure out a reasonable approach to this challenge, and I may have finally found a way to manage the headache of mapping CSS z-index values.
Usage
Run the following Cargo command in your project directory:
Or add the following line to your Cargo.toml:
[]
= "0.7"
And in your Rust file:
use normalize;
Custom lower, middle, and upper ranges are now available under the 'custom' feature flag as of version 0.6
NOTE: This version has not been thoroughly tested yet.
To use, add the following line to your Cargo.toml:
[]
= { = "0.7", = ["custom"] }
And in your Rust file:
use ;
Supported ranges of z-indexes
LOWER | MIDDLE | UPPER |
---|---|---|
-2_147_483_647..=-2_139_095_039 |
-4_194_303..=4_194_304 |
2_139_095_040..=2_147_483_647 |
Total number of supported z-indexes (as of 1/16/2024)
8,388,608 * 3 + 1 = 25,165,825
License
Licensed under either of
at your option.