Clay
Skip to ContentClayClay by Liferay
  • Get Started
    • Introduction
    • What is Clay
    • Importing the JS Component
    • Using JS Components with Metal.js
    • Web Components
  • Foundations
    • Grid
    • Typography
  • Lexicon Core Components
    • Alerts
    • Badges
    • Buttons
    • Cards
    • Charts
      • Advanced Examples
        • Axis Label
        • Axis Range
        • Data Color
        • Gridlines
        • Predictive forecasting
        • Regions
        • X Axis Tick Formatting
      • Basic Examples
        • Bar Chart
        • Bubble Chart
        • Combination Chart
        • Donut Chart
        • Gauge Chart
        • Geomap Chart
        • Line Chart
        • Pie Chart
        • Scatter Chart
        • Spline Chart
        • Step Chart
    • Dataset Display
    • Dropdown Menu
    • Forms
      • Checkbox, Radio, and Toggle
      • Forms
      • Forms Hierarchy
      • Forms Navigation
      • Multi Step Form
      • Multi Step Form Simplified
      • Selectors
      • Text Input
      • Text Input Group
      • Text Input Localizable
      • Text Input Variations
    • Icons
    • Labels
    • Link
    • List
    • Loading Indicator
    • Modals
    • Navigation
      • Breadcrumbs
      • Navigation Bar
      • Vertical Navigation
    • Pagination
    • Popovers and Tooltips
    • Progress Bars
    • Sidebar
      • Info Panel
    • Stickers
    • Table
      • Inline Edit Table
      • Table
    • Tabs
    • Toolbars
      • Management Toolbar
  • CSS Framework
    • SCSS
    • Class Helpers
    • Satellite Components
      • Alerts
      • Badges
      • Button Group
      • Cards
      • Dropdown Menu
      • Forms
        • Form Elements
        • Form Elements (Input Groups)
        • Form Elements (Validation)
      • Images (Aspect Ratios)
      • Images and Thumbnails
      • Labels
      • Links
      • List Groups
      • Modals
      • Nav
      • Navigation
        • Header
      • Paginations
      • Panels
      • Popovers and Tooltips
      • Progress Bars
      • Stickers
      • Tables
      • Tbar (Toolbar)
      • Timelines
      • Toggle Switch
    • Page Examples
      • Card View Template
      • Document Upload
      • List View Template
      • Table View Template
      • Users and Organizations
  • News

Images (Aspect Ratios)

Image Aspect Ratios

Sometimes you can't control the size of an image. Constrain your images with aspect-ratios. The base class aspect-ratio maintains a one-to-one ratio relative to its container's width.

Use aspect-ratio-3-to-2, aspect-ratio-4-to-3, aspect-ratio-8-to-5, or aspect-ratio-16-to-9 to maintain the specific ratio relative to its container, or set padding-bottom to the ratio you want to create your own aspect ratio, e.g. 2 to 1 {literal}.aspect-ratio-2-to-1 { padding-bottom: 50% }{/literal}.

Aspect Ratio Item Fluid

Original Image
thumbnail
1:1
thumbnail
3:2
thumbnail
4:3
thumbnail
8:5
thumbnail
16:9
thumbnail
<div class="aspect-ratio">
	<img alt="thumbnail" class="aspect-ratio-item-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-3-to-2">
	<img alt="thumbnail" class="aspect-ratio-item-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-4-to-3">
	<img alt="thumbnail" class="aspect-ratio-item-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-8-to-5">
	<img alt="thumbnail" class="aspect-ratio-item-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

Aspect Ratio Item Vertical Fluid

1:1
thumbnail
3:2
thumbnail
4:3
thumbnail
8:5
thumbnail
16:9
thumbnail
<div class="aspect-ratio">
	<img alt="thumbnail" class="aspect-ratio-item-vertical-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-3-to-2">
	<img alt="thumbnail" class="aspect-ratio-item-vertical-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-4-to-3">
	<img alt="thumbnail" class="aspect-ratio-item-vertical-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-8-to-5">
	<img alt="thumbnail" class=" aspect-ratio-item-vertical-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class=" aspect-ratio-item-vertical-fluid" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

Aspect Ratio Item

Add the aspect-ratio-item class to an image to keep the content's original size and crop the visible area.

thumbnail
<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class=" aspect-ratio-item aspect-ratio-item-center aspect-ratio-item-middle" src="/images/thumbnail_hot_air_ballon.jpg" />
</div>

Aspect Ratio Item Helper Classes

aspect-ratio-item-center-middle
thumbnail
aspect-ratio-item-fluid
thumbnail
aspect-ratio-item-top-center
thumbnail
aspect-ratio-item-top-right
thumbnail
aspect-ratio-item-right-middle
thumbnail
aspect-ratio-item-bottom-right
thumbnail
aspect-ratio-item-bottom-center
thumbnail
aspect-ratio-item-bottom-left
thumbnail
aspect-ratio-item-left-middle
thumbnail
<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-center-middle aspect-ratio-item-fluid" src="/images/liferay_logo_tagline.png"/>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-fluid" src="/images/liferay_logo_tagline.png"/>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-top-center aspect-ratio-item-fluid" src="/images/liferay_logo_tagline.png"/>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-fluid aspect-ratio-item-top-right" src="/images/liferay_logo_tagline.png"/>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-bottom-right aspect-ratio-item-fluid" src="/images/liferay_logo_tagline.png"/>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-bottom-center aspect-ratio-item-fluid" src="/images/liferay_logo_tagline.png"/>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-bottom-left aspect-ratio-item-fluid" src="/images/liferay_logo_tagline.png"/>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<img alt="thumbnail" class="aspect-ratio-item-left-middle aspect-ratio-item-fluid" src="/images/liferay_logo_tagline.png"/>
</div>

Aspect Ratio Background Images

aspect-ratio-bg-cover
aspect-ratio-bg-center
<div class="aspect-ratio aspect-ratio-16-to-9 aspect-ratio-bg-cover" style="background-image: url(/images/thumbnail_hot_air_ballon.jpg);">
</div>

<div class="aspect-ratio aspect-ratio-16-to-9 aspect-ratio-bg-center" style="background-image: url(/images/liferay_logo_tagline.png);">
</div>

Aspect Ratio with Other Things

Some ReallySuperInsanelyJustIncrediblyLongAndTotallyNotPossible Text?
133
<div class="aspect-ratio aspect-ratio-16-to-9">
	<div class="aspect-ratio-item-center-middle aspect-ratio-item-fluid">
		<svg class="lexicon-icon lexicon-icon-folder" focusable="false" role="presentation">
			<use href="/images/icons/icons.svg#folder" />
		</svg>
	</div>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<div class="aspect-ratio-item-center-middle aspect-ratio-item-fluid">
		Some ReallySuperInsanelyJustIncrediblyLongAndTotallyNotPossible Text?
	</div>
</div>

<div class="aspect-ratio aspect-ratio-16-to-9">
	<div class="aspect-ratio-item-center-middle aspect-ratio-item-fluid">
		<span class="rounded-circle sticker sticker-danger">133</span>
	</div>
</div>

Except as otherwise noted, the content of this site is licensed under CC BY-SA 4.0 license.