Class BulletListBlockSettings

Represents settings specific to a bullet list block used in the SfBlockEditor.

Inheritance

object

BlockSettings

BulletListBlockSettings

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Syncfusion.Blazor.BlockEditor

Assembly: Syncfusion.Blazor.dll

Syntax

public class BulletListBlockSettings : BlockSettings

Remarks

Assign an instance of this settings class to BlockModel.Properties when BlockModel.BlockType is BulletList.

Use Placeholder to guide users when a new list item has no content. The placeholder is shown only while the item is empty and is hidden once the user provides text.

Localization: Provide region-specific placeholder text via resource files to ensure a consistent experience across locales.

Performance: Rendering bullet list items is lightweight and scales with the number of BlockModel instances. Update instances of this settings class from the UI thread to avoid threading issues.

Examples

Creates a bullet list block with a placeholder for empty items inside an SfBlockEditor.

<SfBlockEditor @bind-Blocks="Blocks" />

@code {
    private List<BlockModel> Blocks = new()
    {
        new BlockModel
        {
            ID = "bullet-list-header",
            BlockType = BlockType.BulletList,
            Properties = new BulletListBlockSettings
            {
                Placeholder = "Add a list item..."
            },
            Content = new List<ContentModel>
            {
                new ContentModel
                {
                    ID = "bullet-list-header-content",
                    ContentType = ContentType.Text,
                    Content = "Text blocks: Paragraph, Heading 1�4",
                    Properties = new TextContentSettings
                    {
                        Styles = new StyleModel { Bold = true }
                    }
                }
            }
        }
    };
}

Constructors

BulletListBlockSettings()

Declaration

public BulletListBlockSettings()

Properties

Placeholder

Gets or sets the placeholder text displayed when a BulletList item has no content in the SfBlockEditor.

Declaration

public string Placeholder { get; set; }

Property Value

Type	Description
string	A string representing the placeholder text for an empty bullet list item. The default value is "" (empty string).

Remarks

Use this property to guide users on what to enter (for example, "Add a list item..."). The placeholder is shown only while the item's content is empty and is hidden once the user provides text.

If the value is null or empty, no placeholder text is rendered.

For localization, provide region-specific placeholder text via resource files to ensure consistency across locales.