shape-image-threshold

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die shape-image-threshold CSS Eigenschaft legt die Schwelle für den Alphakanal fest, die verwendet wird, um die Form mit einem Bild als Wert für shape-outside zu extrahieren.

Probieren Sie es aus

Alle Pixel, deren Alpha-Komponente den Schwellenwert überschreitet, gelten als Teil der Form zur Bestimmung ihrer Grenzen. Zum Beispiel bedeutet ein Wert von 0.5, dass die Form alle Pixel einschließt, die mehr als 50% undurchsichtig sind.

Syntax

css
/* <number> value */
shape-image-threshold: 0.7;

/* Global values */
shape-image-threshold: inherit;
shape-image-threshold: initial;
shape-image-threshold: revert;
shape-image-threshold: revert-layer;
shape-image-threshold: unset;

Werte

<alpha-value>

Legt die Schwelle fest, die zur Extraktion einer Form aus einem Bild verwendet wird. Die Form wird durch die Pixel definiert, deren Alphawert größer als die Schwelle ist. Werte außerhalb des Bereichs 0,0 (vollständig transparent) bis 1,0 (vollständig undurchsichtig) werden auf diesen Bereich begrenzt.

Formale Definition

Anfangswert0.0
Anwendbar aufFlusselemente
VererbtNein
Berechneter WertDerselbe wie der angegebene Wert nachdem die <number> auf den Bereich [0.0, 1.0] zugeschnitten wurde.
AnimationstypNummer

Formale Syntax

shape-image-threshold = 
  <opacity-value>  

<opacity-value> = 
  <number>      |
  <percentage>

Beispiele

Text an einem Verlauf ausrichten

Dieses Beispiel erstellt einen <div> Block mit einem Hintergrundbild-Verlauf. Der Verlauf wird als CSS-Form unter Verwendung von shape-outside festgelegt, so dass Pixel innerhalb des Verlaufs, die mindestens 20% undurchsichtig sind (das heißt, jene Pixel mit einer Alpha-Komponente größer als 0.2), als Teil der Form betrachtet werden.

HTML

html
<div id="gradient-shape"></div>

<p>
  Lorem ipsum dolor sit amet, consectetur adipisicing elit. Vel at commodi
  voluptates enim, distinctio officia. Saepe optio accusamus doloribus sint
  facilis itaque ab nulla, dolor molestiae assumenda cum sit placeat adipisci,
  libero quae nihil porro debitis laboriosam inventore animi impedit nostrum
  nesciunt quisquam expedita! Dolores consectetur iure atque a mollitia dicta
  repudiandae illum exercitationem aliquam repellendus ipsum porro modi, id nemo
  eligendi, architecto ratione quibusdam iusto nisi soluta? Totam inventore ea
  eum sed velit et eligendi suscipit accusamus iusto dolore, at provident eius
  alias maxime pariatur non deleniti ipsum sequi rem eveniet laboriosam magni
  expedita?
</p>

CSS

css
#gradient-shape {
  width: 150px;
  height: 150px;
  float: left;
  background-image: linear-gradient(30deg, black, transparent 80%, transparent);
  shape-outside: linear-gradient(30deg, black, transparent 80%, transparent);
  shape-image-threshold: 0.2;
}

Die Form wird hier unter Verwendung von background-image mit einem linearen Verlauf anstelle einer Bilddatei erstellt. Derselbe Verlauf wird auch als das Bild verwendet, aus dem die Form zur Festlegung des Fließbereichs abgeleitet wird, unter Verwendung der shape-outside Eigenschaft.

Die 20% Opazitätsschwelle, um Verlaufs-Pixel als Teil der Form zu behandeln, wird dann unter Verwendung von shape-image-threshold mit einem Wert von 0.2 festgelegt.

Ergebnis

Spezifikationen

Specification
CSS Shapes Module Level 1
# shape-image-threshold-property

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch