List item

Create a list item.

This block is available in the latest version of WordPress and does not require the Gutenberg plugin.

Last updated

April 20, 2024

Category: Text

For developers

View source on GitHub

Block Grammar & Markup

<!-- wp:list-item -->
<li>Text & Headings</li>
<!-- /wp:list-item -->

Parent

Optional. Type: Array.

Blocks are able to be inserted into blocks that use InnerBlocks as nested content. Setting parent lets a block require that it is only available when nested within the specified blocks.

Documentation

[
  "core/list"
]

Block Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

{
  "placeholder": {
    "type": "string"
  },
  "content": {
    "type": "rich-text",
    "source": "rich-text",
    "selector": "li",
    "__experimentalRole": "content"
  }
}

Block Supports

Optional. Type: Object.

A set of options that enables or disables block controls in the editor, for example gradient colors or padding.

Documentation

{
  "className": false,
  "__experimentalSelector": "li",
  "spacing": {
    "margin": true,
    "padding": true,
    "__experimentalDefaultControls": {
      "margin": false,
      "padding": false
    }
  },
  "typography": {
    "fontSize": true,
    "lineHeight": true,
    "__experimentalFontFamily": true,
    "__experimentalFontWeight": true,
    "__experimentalFontStyle": true,
    "__experimentalTextTransform": true,
    "__experimentalTextDecoration": true,
    "__experimentalLetterSpacing": true,
    "__experimentalDefaultControls": {
      "fontSize": true
    }
  },
  "interactivity": {
    "clientNavigation": true
  }
}

Transforms

Optional. Type: Object.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms to: Paragraph.

View blocks per attribute or block support:

Block Attributes