Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@material/density

Package Overview
Dependencies
Maintainers
15
Versions
1643
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@material/density

Density utilities for Material Components for the web

  • 14.0.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
15
Created
Source

Density

Density subsystem provides adaptive layout to components. Material Design uses low-density space by default but offers high-density space when it improves the user experience. Components with high density enable users to process and take action against large amounts of information in a more manageable way. List, tables, and long forms are components that benefit from increased density.

Design & API Documentation

  • Material Design guidelines: Applying density
  • Demo: Glitch

Installation

npm install @material/density

NOTE: You do not need to directly depend on @material/density, use component provided density Sass mixins instead.

Basic Usage

The styles for applying density to button component instance looks like this:

@use "@material/button";

.my-custom-button {
  // Sets button density scale to `-3`, i.e. button height to `24px`.
  @include button.density(-3);
}

This would apply -3 (high density) to button component instance.

You would indirectly use the Density API through respective component's mixin which takes care of setting appropriate component height.

Here are the components that do provide density Sass mixins:

Density Mixins

Components that supports density provides Sass mixins to customize density for that component. Each density mixin takes in a density scale number, e.g. 0 (the default) or -1 (higher density).

Currently, the density system only allows negative numbers to customize for high density. The lower the density scale, the higher the component density. The exact density scale range depends on the component. If the scale number is unsupported by the component density mixin, the compiler will report an error at build time.

The height or size of a component is calculated with the following formula:

@use "@material/button";
@use "@material/density";

$height: button.$height + density.$interval * $density-scale
/// @example 36px + 4px * (-3) => 24px

The density interval is set to 4px for visual consistency.

It is recommended to customize density via the provided density mixins, rather than arbitrarily applying component height.

NOTE: Touch targets are automatically disabled when density mixins are applied, since dense components should be optionally enabled and therefore do not have the same default accessibility requirements.

Component variants

Components that has different variants may have their own density mixin.

For example, Tab Bar has two density mixins:

  • tab-bar.density(): Density mixin for standard tab bar.
  • tab-bar.stacked-density(): Density mixin for tab bar that has icon stacked on top of label.

Similarly, text field provides 3 different density mixins based on its variant.

Nested components

Material component that renders another component inside it needs set its own density scale accordingly. Applying density mixin on parent component does not automatically apply density to its children.

For example, Applying density to data table does not automatically set density scale to row checkbox. You'll have to explicitly set density scale to its children. This'll allow clients to have full control on the layout.

Style Customization

This package is used as utility for other components' density mixins. Customizations provided by this package is not intended to be consumed directly by developers, use component's density mixin instead.

Sass Variables

VariableDescription
$intervalDensity interval between each dense scale. This interval is used for numbered density scale to calculate dense height based on baseline component height.
$minimum-scaleMinimum scale supported by density subsystem. This scale always maps to highest dense scale.
$maximum-scaleMaximum scale supported by density subsystem. This scale always maps to lowest dense scale.
$supported-scalesSupported density scale when density literal is used (For example, minimum).

Sass Functions

FunctionDescription
prop-value($density-config, $density-scale, $property-name)Returns component property value based on given density config and density scale.

Keywords

FAQs

Package last updated on 28 Apr 2022

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc