> For the complete documentation index, see [llms.txt](https://docs.matestack.io/matestack-ui-core/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.matestack.io/matestack-ui-core/1.5.0/components-api/core-components/paragraph.md).

# Paragraph

The HTML `<p>` tag, implemented in Ruby. This is a workaround because the single `p` is a [`Kernel` method in Ruby](https://ruby-doc.org/core-2.6.5/Kernel.html#method-i-p) (directly writes `obj.inspect` followed by a newline to the program’s standard output, e.g. `p foo` equals `puts foo.inspect`).

Alias: `pg`

## Parameters

This component can take various optional configuration params and either yield content or display what gets passed to the `text` configuration param.

### Text (optional)

Expects a string which will be displayed as the content inside the `<p>` tag.

### HMTL attributes (optional)

This component accepts all the canonical [HTML global attributes](https://www.w3schools.com/tags/ref_standardattributes.asp) like `id` or `class`.

## Examples

### Example 1: Yield a given block

```ruby
paragraph do
  plain "Hello World"
end
```

returns

```markup
<p>Hello World</p>
```

### Example 2: Render options\[:text] param

```ruby
paragraph text: "Hello World"
```

returns

```markup
<p>Hello World</p>
```

## Example 3: Rendering another component inside

```ruby
paragraph id: "foo", class: "bar" do
  span text: "Hello World"
end
```

returns

```markup
<p id="foo" class="bar">
  <span>Hello World</span>
</p>
```