New to Telerik UI for ASP.NET Core? Download free 30-day trial

TextArea Appearance

As of the R1 2022 release, the TextArea component uses a new rendering. To learn more about why we decided to create a new rendering for our components, see the Components Rendering article.

For a live example of the styling options of the TextArea, visit the Appearance Demo of the TextArea.

Options

The TextArea HtmlHelper supports the following styling methods:

  • Size()—configures the overall size of the component.
  • Rounded()—configures the border radius of the component.
  • FillMode()—configures how the color is applied to the component.
  • Overflow()—configures the overflow behavior of the element.
  • Resize()—configures how the resizing of the element is applied.

Size

The Size() method allows you to adjust the size of the TextArea. The default size is Medium.

@(Html.Kendo().TextArea()
    .Name("description")
    .Size(ComponentSize.Medium)
)
<kendo-textarea name="description"
                size="ComponentSize.Medium">
</kendo-textarea>

The option adds a class k-input-md to the wrapping span element span.k-textarea:

<span class="k-textarea k-input k-input-md">
</span>

The following values are available for the Size option:

  • Small
  • Medium
  • Large

Rounded

You can control how much border radius is applied to the component by using the Rounded() method. The default value is Medium.

@(Html.Kendo().TextArea()
    .Name("description")
    .Rounded(Rounded.Medium)
)
<kendo-textarea name="description"
                rounded="Rounded.Medium">
</kendo-textarea>

The value Medium is applied to the wrapping span element through the k-rounded-md class.

<span class="k-textarea k-input k-rounded-md">
</span>

The Rounded() method supports the following values:

  • Small
  • Medium
  • Large
  • Full

FillMode

The FillMode option controls the way the color is applied to the component. The default value is Solid.

@(Html.Kendo().TextArea()
    .Name("description")
    .FillMode(FillMode.Solid)
)
<kendo-textarea name="description"
                fill-mode="FillMode.Solid">
</kendo-textarea>

The option adds a class k-input-solid to the wrapping span element of the TextArea:

<span class="k-textarea k-input k-input-solid">
</span>

The following values are available for the FillMode option:

  • Solid
  • Flat
  • Outline

Overflow

The Overflow() method allows you to handle the content overflow of the TextArea. By default, it is set to Auto.

@(Html.Kendo().TextArea()
    .Name("description")
    .Overflow(TextAreaOverflow.Auto)
)
<kendo-textarea name="description"
                overflow="TextAreaOverflow.Auto">
</kendo-textarea>

The option is applied to the TextArea element through the k-overflow-auto class.

<textarea class="k-input-inner k-overflow-auto" placeholder="..."></textarea>

The following values are available for the Overflow option:

  • Auto
  • Hidden
  • Visible
  • Scroll
  • Clip

Resize

The Resize() method defines how the component should be resized. The default Resize value is None.

@(Html.Kendo().TextArea()
    .Name("description")
    .Resize(TextAreaResize.None)
)
<kendo-textarea name="description"
                resize="TextAreaResize.None">
</kendo-textarea>

The option is applied to the wrapping span element through the k-resize-none class.

<span class="k-textarea k-input k-resize-none">
</span>

The following values are available for the Resize option:

  • Both
  • Horizontal
  • Vertical
  • None

Old vs New Rendering

The old rendering of the component consisted of a wrapping span element with the k-textarea class and a child textarea element with the k-textbox class.

<span class="k-textarea">
    <textarea class='k-textbox'></textarea>
</span>

The new rendering of the component also consists of a wrapping span element that has a child textarea element:

  • The span element controls the overall appearance of the component and has the following class structure:

    <span class="k-textarea k-input k-input-md k-rounded-md k-input-solid">
    </span>
    
  • The textarea element controls the appearance of the textarea itself and has the following class structure:

    <textarea class="k-input-inner k-overflow-hidden k-resize-both" placeholder="..."></textarea>
    

The full rendering of the component has the following HTML structure:

<span class="k-textarea k-input k-input-md k-rounded-md k-input-solid">
    <textarea class="k-input-inner k-overflow-hidden k-resize-both" placeholder="...">...</textarea>
</span>

Visual Backwards Compatibility

To achieve the same look and feel as the old rendering, the element references must be updated. Visit the CSS Classes Migration and JQuery Selectors Migration sections of the Components Rendering article for additional information.

The new styling and rendering supports only the default options when you use a LESS theme.

Previously, a reference to the textarea element was obtainable through the k-textbox class.

$(".k-textbox") // Returns a reference to the textarea element in the old rendering.

With the new rendering, the textarea element must be targeted by using the k-input-inner class.

$(".k-input-inner") // Returns a reference to the textarea element in the new rendering.

See Also

In this article