From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- files/tr/web/css/shape-outside/index.html | 208 ++++++++++++++++++++++++++++++ 1 file changed, 208 insertions(+) create mode 100644 files/tr/web/css/shape-outside/index.html (limited to 'files/tr/web/css/shape-outside') diff --git a/files/tr/web/css/shape-outside/index.html b/files/tr/web/css/shape-outside/index.html new file mode 100644 index 0000000000..1e4aed1e56 --- /dev/null +++ b/files/tr/web/css/shape-outside/index.html @@ -0,0 +1,208 @@ +--- +title: shape-outside +slug: Web/CSS/shape-outside +tags: + - Boundaries + - CSS + - CSS Property + - CSS Shapes + - Float Area + - Property + - Reference + - Shape + - margin + - 'recipe:css-property' + - shape-outside + - wrapping +translation_of: Web/CSS/shape-outside +--- +
{{CSSRef}}
+ +

The shape-outside CSS property defines a shape—which may be non-rectangular—around which adjacent inline content should wrap. By default, inline content wraps around its margin box; shape-outside provides a way to customize this wrapping, making it possible to wrap text around complex objects rather than simple boxes.

+ +
{{EmbedInteractiveExample("pages/css/shape-outside.html")}}
+ + + +

Syntax

+ +
/* Keyword values */
+shape-outside: none;
+shape-outside: margin-box;
+shape-outside: content-box;
+shape-outside: border-box;
+shape-outside: padding-box;
+
+/* Function values */
+shape-outside: circle();
+shape-outside: ellipse();
+shape-outside: inset(10px 10px 10px 10px);
+shape-outside: polygon(10px 10px, 20px 20px, 30px 30px);
+shape-outside: path('M0.5,1 C0.5,1,0,0.7,0,0.3 A0.25,0.25,1,1,1,0.5,0.3 A0.25,0.25,1,1,1,1,0.3 C1,0.7,0.5,1,0.5,1 Z');
+
+/* <url> value */
+shape-outside: url(image.png);
+
+/* <gradient> value */
+shape-outside: linear-gradient(45deg, rgba(255, 255, 255, 0) 150px, red 150px);
+
+/* Global values */
+shape-outside: initial;
+shape-outside: inherit;
+shape-outside: unset;
+
+ +

The shape-outside property is specified using the values from the list below, which define the float area for float elements. The float area determines the shape around which inline content (float elements) wrap.

+ +

Values

+ +
+
none
+
The float area is unaffected. Inline content wraps around the element's margin box, like usual.
+
<shape-box>
+
The float area is computed according to the shape of a float element's edges (as defined by the CSS box model). This can be margin-box, border-box, padding-box, or content-box. The shape includes any curvature created by the {{cssxref("border-radius")}} property (behavior which is similar to {{cssxref("background-clip")}}).
+
+
+
margin-box
+
Defines the shape enclosed by the outside margin edge. The corner radii of this shape are determined by the corresponding {{cssxref("border-radius")}} and {{cssxref("margin")}} values. If the border-radius / margin ratio is 1 or more, then the margin box corner radius is border-radius + margin. If the ratio is less than 1, then the margin box corner radius is border-radius + (margin * (1 + (ratio-1)^3)).
+
border-box
+
+

Defines the shape enclosed by the outside border edge. The shape follows the normal border radius shaping rules for the outside of the border.

+
+
padding-box
+
+

Defines the shape enclosed by the outside padding edge. The shape follows the normal border radius shaping rules for the inside of the border.

+
+
content-box
+
+

Defines the shape enclosed by the outside content edge. Each corner radius of this box is the larger of 0 or border-radius - border-width - padding.

+
+
+
+
{{cssxref("<basic-shape>")}}
+
The float area is computed based on the shape created by of one of inset(), circle(), ellipse(),  polygon(), or as added in the level 2 specification path(). If a <shape-box> is also supplied, it defines the reference box for the <basic-shape> function. Otherwise, the reference box defaults to margin-box.
+
{{cssxref("<image>")}}
+
The float area is extracted and computed based on the alpha channel of the specified {{cssxref("<image>")}} as defined by {{cssxref("shape-image-threshold")}}.
+
+
Note: {{glossary("User agent", "User agents")}} must use the potentially CORS-enabled fetch method defined by the HTML5 specification for all URLs in a shape-outside value. When fetching, user agents must use "Anonymous" mode, set the referrer source to the stylesheet's URL, and set the origin to the URL of the containing document. If this results in network errors such that there is no valid fallback image, the effect is as if the value none had been specified.
+
+
+ +

Interpolation

+ +

When animating between one <basic-shape> and a second, the rules below are applied. The values in the shape functions interpolate as a simple list. The list values interpolate as {{cssxref("<length>")}}, {{cssxref("<percentage>")}}, or {{cssxref("calc")}} where possible. If list values are not one of those types but are identical (such as finding nonzero in the same list position in both lists), those values do interpolate.

+ + + +

Formal definition

+ +

{{CSSInfo}}

+ +

Formal syntax

+ +
{{csssyntax}}
+ +

Examples

+ +

Funneling text

+ +

HTML

+ +
<div class="main">
+  <div class="left"></div>
+  <div class="right"></div>
+  <p>
+    Sometimes a web page's text content appears to be
+    funneling your attention towards a spot on the page
+    to drive you to follow a particular link. Sometimes
+    you don't notice.
+  </p>
+</div>
+ +

CSS

+ +
.main {
+  width: 530px;
+}
+
+.left,
+.right {
+  width: 40%;
+  height: 12ex;
+  background-color: lightgray;
+}
+
+.left {
+  -webkit-shape-outside: polygon(0 0, 100% 100%, 0 100%);
+  shape-outside: polygon(0 0, 100% 100%, 0 100%);
+  float: left;
+  -webkit-clip-path: polygon(0 0, 100% 100%, 0 100%);
+  clip-path: polygon(0 0, 100% 100%, 0 100%);
+}
+
+.right {
+  -webkit-shape-outside: polygon(100% 0, 100% 100%, 0 100%);
+  shape-outside: polygon(100% 0, 100% 100%, 0 100%);
+  float: right;
+  -webkit-clip-path: polygon(100% 0, 100% 100%, 0 100%);
+  clip-path: polygon(100% 0, 100% 100%, 0 100%);
+}
+
+p {
+  text-align: center;
+}
+ +

Result

+ +

{{EmbedLiveSample("Funneling_text", "100%", 130)}}

+ +

Specifications

+ + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('CSS Shapes', '#shape-outside-property', 'shape-outside')}}{{Spec2('CSS Shapes')}}Initial definition.
{{SpecName('CSS Shapes 2', '#shape-outside-property', 'shape-outside')}}{{Spec2('CSS Shapes 2')}}Adds the path() value
+ +

Browser compatibility

+ +
+ + +

{{Compat("css.properties.shape-outside")}}

+
+ +

See also

+ + -- cgit v1.2.3-54-g00ecf