Skip to content

Commit

Permalink
Added CSS text-anchor property (#35167)
Browse files Browse the repository at this point in the history
* Added text-anchor property

* Removed redirect

* Fixes for Josh-Cena
  • Loading branch information
meyerweb committed Aug 2, 2024
1 parent 10c7190 commit 58313ee
Show file tree
Hide file tree
Showing 3 changed files with 112 additions and 2 deletions.
1 change: 0 additions & 1 deletion files/en-us/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -11726,7 +11726,6 @@
/en-US/docs/Web/CSS/symbols() /en-US/docs/Web/CSS/symbols
/en-US/docs/Web/CSS/symbols-descriptor /en-US/docs/Web/CSS/@counter-style/symbols
/en-US/docs/Web/CSS/system /en-US/docs/Web/CSS/@counter-style/system
/en-US/docs/Web/CSS/text-anchor /en-US/docs/Web/SVG/Attribute/text-anchor
/en-US/docs/Web/CSS/text-combine-horizontal /en-US/docs/Web/CSS/text-combine-upright
/en-US/docs/Web/CSS/time-function /en-US/docs/Web/CSS/easing-function
/en-US/docs/Web/CSS/timing-function /en-US/docs/Web/CSS/easing-function
Expand Down
106 changes: 106 additions & 0 deletions files/en-us/web/css/text-anchor/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
---
title: text-anchor
slug: Web/CSS/text-anchor
page-type: css-property
browser-compat: css.properties.text-anchor
---

{{CSSRef}}

The **`text-anchor`** [CSS](/en-US/docs/Web/CSS) property aligns a box containing a string of text where the wrapping area is determined from the {{cssxref("inline-size")}} property, and the text is then placed relative to the anchor point of the element, which is defined using the {{SVGAttr('x')}} and {{SVGAttr('y')}} (or {{SVGAttr('dx')}} and {{SVGAttr('dy')}}) attributes. If present, the value of the CSS property overrides any value of the element's {{SVGAttr("text-anchor")}} attribute.

Each individual text fragment within an element is aligned independently; thus, a multi-line {{SVGElement("text")}} element will have each line of text aligned as per the value of `text-anchor`. `text-anchor` values only have an effect on the {{SVGElement("text")}}, {{SVGElement("textPath")}}, {{SVGElement("tref")}}, and {{SVGElement("tspan")}} SVG elements. `text-anchor` does not apply to automatically wrapped text; for that, see {{cssxref('text-align')}}.

## Syntax

```css
text-anchor: start;
text-anchor: middle;
text-anchor: end;

/* Global values */
text-anchor: inherit;
text-anchor: initial;
text-anchor: revert;
text-anchor: revert-layer;
text-anchor: unset;
```

### Values

- `start`

- : Aligns the text such that the inline start of the text string is aligned with the anchor point. This alignment is relative to the writing direction of the text; thus, for example, in right-to-left top-to-bottom writing, the text will be placed to the left of the anchor point. If the text's inline direction is vertical, as with many Asian languages, the top edge of the text is aligned with the anchor point.

- `middle`

- : Aligns the text such that the center (middle) of the text string's inline box is aligned with the anchor point.

- `end`

- : Aligns the text such that the inline end of the text string is aligned with the anchor point. This alignment is relative to the writing direction of the text; thus, for example, in right-to-left top-to-bottom writing, the text will be placed to the right of the anchor point. If the text's inline direction is vertical, as with many Asian languages, the bottom edge of the text is aligned with the anchor point.

## Formal definition

{{CSSInfo}}

## Formal syntax

{{csssyntax}}

## Example

Three `<text>` elements are given the same `x` position, but different values for `text-anchor`. A dashed red line is included to mark the x-axis position of all three anchor points.

```html
<svg
viewBox="0 0 200 150"
height="150"
width="200"
xmlns="http://www.w3.org/2000/svg">
<line
x1="100"
y1="0"
x2="100"
y2="150"
stroke="red"
stroke-dasharray="10,5" />
<text x="100" y="40">Anchored</text>
<text x="100" y="80">Anchored</text>
<text x="100" y="120">Anchored</text>
</svg>
```

```css hidden
text {
font-size: 24px;
}
```

```css
text:nth-of-type(1) {
text-anchor: start;
}
text:nth-of-type(2) {
text-anchor: middle;
}
text:nth-of-type(3) {
text-anchor: end;
}
```

{{EmbedLiveSample("Example", 200, 150)}}

## Specifications

{{Specifications}}

## Browser compatibility

{{Compat}}

## See also

- {{cssxref('dominant-baseline')}}
- SVG {{SVGElement("text")}} element
- SVG {{SVGAttr("text-anchor")}} attribute
7 changes: 6 additions & 1 deletion files/en-us/web/svg/attribute/text-anchor/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ This attribute is not applicable to other types of auto-wrapped text. For those
The `text-anchor` attribute is applied to each individual text chunk within a given {{SVGElement("text")}} element. Each text chunk has an initial current text position, which represents the point in the user coordinate system resulting from (depending on context) application of the {{SVGAttr("x")}} and {{SVGAttr("y")}} attributes on the `<text>` element, any `x` or `y` attribute values on a {{SVGElement("tspan")}} or {{SVGElement("tref")}} element assigned explicitly to the first rendered character in a text chunk, or determination of the initial current text position for a {{SVGElement("textPath")}} element.

> [!NOTE]
> As a presentation attribute, `text-anchor` can be used as a CSS property.
> As a presentation attribute, `text-anchor` can be used as a CSS property. See {{cssxref('text-anchor')}} for more.
You can use this attribute with the following SVG elements:

Expand Down Expand Up @@ -95,3 +95,8 @@ svg {
## Browser compatibility
{{Compat}}
## See also
- SVG {{SVGElement("text")}} element
- CSS {{cssxref('text-anchor')}} property

0 comments on commit 58313ee

Please sign in to comment.