Dummy

Bootstrap 5 Dummy plugin

Dummy plugin creates placeholder content for accelerated building and testing your frontend templates.

Responsive Dummy plugin built with the latest Bootstrap 5. Plenty of implementation examples such as images, lists, tables, and much more.

Note: Read the API tab to find all available options and advanced customization

Note: Currently, the plugin is only compatible with the basic MDB package imported in UMD format. More about import MDB formats.


Create Dummy component for an element by adding data-mdb-dummy-init attribute to it. Depending on the base element, different Dummies will be created. For most of the HTML tags default Dummy is Text.

To explicitly create specific Dummy add proper data-mdb- attribute to element with data-mdb-dummy-init attribute.

Text

Create Dummy Text by adding data-mdb-dummy-text to element. To create text with custom length add value of desired length to the attribute. Change text color with data-mdb-text-color attribute.

Implicitly generated text:
Explicitly generated text with 40 characters length:
Text with custom color:
        
            
          <dl class="row">
            <dt class="col-sm-6" data-mdb-dummy-init>Implicitly generated text:</dt>
            <dd class="col-sm-6"></dd>

            <dt class="col-sm-6">Explicitly generated text with 40 characters length:</dt>
            <dd class="col-sm-6" data-mdb-dummy-init data-mdb-dummy-text="40"></dd>

            <dt class="col-sm-6">Text with custom color:</dt>
            <dd class="col-sm-6" data-mdb-dummy-init data-mdb-dummy-text-color="red"></dd>
          </dl>
        
        
    

Image

Create Dummy Image by adding data-mdb-dummy-img to element.

Default

By default Dummy Image is created with size 150x150px and grey background

        
            
            <img data-mdb-dummy-init data-mdb-dummy-img />
          
        
    

Size

Change Dummy Image size with data-mdb-dummy-img="width value, height value". Height value is optional, when omitted square image will be created.

        
            
            <img class="dummy" data-mdb-dummy-img="400,300" />
          
        
    

Make Dummy Image inherit full size of its container with data-mdb-dummy-img="100%,100%".

Note: It will only work with container having explicitly set width and height.

Setting data-mdb-dummy-img="100%" will create square image with width and height of its container width

        
            
            <div style="width: 500px">
              <img data-mdb-dummy-init data-mdb-dummy-img="100%" />
            </div>
          
        
    

Text

Add text to Dummy Image with data-mdb-dummy-img-text attribute. Pass any value to attrtibute to set your own text or leave empty to create Dummy Text inside image. Set length of Dummy Text with data-mdb-dummy-text="text length value"

        
            
            <img data-mdb-dummy-init data-mdb-dummy-img="300" data-mdb-dummy-img-text="Custom text" />
            <img data-mdb-dummy-init data-mdb-dummy-img="300" data-mdb-dummy-img-text data-mdb-dummy-text="25" />
          
        
    

Colours

Set the image background color using data-mdb-color and the text color with data-mdb-dummy-text-color. Note that Dummy Image only accepts color values in hexadecimal format (hex).

        
            
            <img 
              data-mdb-dummy-init
              data-mdb-dummy-img="200"
              data-mdb-dummy-img-text
              data-mdb-dummy-text="5"
              data-mdb-color="#FF5733"
              data-mdb-dummy-text-color="#FFF"
            />
          
        
    

List

Create Dummy List by adding data-mdb-dummy-list to ul or ol element.

Default

By default, Dummy List will generate a list with 5 Dummy Text elements.

        
            
            <ul data-mdb-dummy-init></ul>
          
        
    

Size

Change Dummy List length with data-mdb-dummy-list="length value" and length of Dummy Text element with data-mdb-dummy-text="text length value".

        
            
            <ul data-mdb-dummy-init data-mdb-dummy-list="10" data-mdb-dummy-text="30"></ul>
          
        
    

Table

Create Dummy Table by adding the data-mdb-dummy-table to the table element.

Default

By default Dummy Table will generate a table with 5 rows and 5 columns.

        
            
            <table data-mdb-dummy-init></table>
          
        
    

Size

Adjust the size of Dummy Table rows and columns using data-mdb-dummy-table="rows length value, columns length value". Modify the length of the default Dummy Text with data-mdb-dummy-text="text length value"

        
            
            <table data-mdb-dummy-init data-mdb-dummy-table="10,5" data-mdb-dummy-text="10"></table>
          
        
    

Copy

Create a Dummy Copy of any existing element with data-mdb-dummy-copy="existing element selector"

Original element

Card title

Some quick example text to build on the card title and make up the bulk of the card's content.

Dummy Copy element

        
            
          <div class="col-6 d-flex flex-column align-items-center">
            <p><strong>Original element</strong></p>
            <div class="card" id="original-element">
              <div class="card-body">
                <h5 class="card-title">Card title</h5>
                <p class="card-text">
                  Some quick example text to build on the card title and make up the bulk of the
                  card's content.
                </p>
                <button type="button" class="btn btn-primary" data-mdb-ripple-init>Button</button>
              </div>
            </div>
          </div>
          <div class="col-6 d-flex flex-column align-items-center">
            <p><strong>Dummy Copy element</strong></p>
            <div data-mdb-dummy-init data-mdb-dummy-copy="#original-element"></div>
          </div>
        
        
    

Repeat

Dummy Repeat will duplicate the element on which data-mdb-dummy-repeat="number of repetitions" was invoked.

  • Woman Portrait

    Jane Smith

    Lorem ipsum dolor sit amet consectetur adipisicing elit. Corrupti molestiae inventore, quis omnis est, asperiores repellat dignissimos blanditiis placeat ad eveniet deserunt temporibus explicabo voluptatem tenetur? Consequatur totam maiores eum.

        
            
          <ul class="list-unstyled">
            <li data-mdb-dummy-init data-mdb-dummy-repeat="3">
              <div class="row mb-4">
                <div class="col-2">
                  <img 
                    src="https://mdbcdn.b-cdn.net/img/Photos/Avatars/img%20(26).webp"
                    class="img-fluid shadow-1-strong rounded" 
                    alt="Woman Portrait">
                </div>

                <div class="col-10">
                  <p class="mb-2"><strong>Jane Smith</strong></p>
                  <p>
                    Lorem ipsum dolor sit amet consectetur adipisicing elit. Corrupti molestiae inventore, quis omnis
                    est, asperiores repellat dignissimos blanditiis placeat ad eveniet deserunt temporibus explicabo
                    voluptatem tenetur? Consequatur totam maiores eum.
                  </p>
                </div>
              </div>
            </li>
          </ul>
        
        
    

Any content inside Dummy Repeat can be created from Dummy elements.

        
            
          <ul class="list-unstyled">
            <li data-mdb-dummy-init data-mdb-dummy-repeat="3">
              <div class="row mb-4">
                <div class="col-2">
                  <img class="dummy img-fluid shadow-1-strong rounded" data-mdb-dummy-init data-mdb-dummy-img="120">
                </div>
                <div class="col-10">
                  <strong>
                    <p data-mdb-dummy-init data-mdb-dummy-text="15"></p>
                  </strong>
                  <p data-mdb-dummy-init data-mdb-dummy-text="100"></p>
                </div>
              </div>
            </li>
          </ul>
        
        
    

Template

Dummy Template can generate a single Dummy element or an entire template based on the tag elements passed as string into data-mdb-dummy-template.

Default

By default Dummy Template will create a template of h1,p,table,h2,p,form,blockquote,img,ul tags.

        
            
            <div data-mdb-dummy-init data-mdb-dummy-template></div>
          
        
    

Layouts

Combine Dummy Template with other Dummy elements and MDBootstrap components to create layouts in no time!

        
            
            <div class="container">
              <div data-mdb-dummy-init class="mb-4" data-mdb-dummy-template="h1,p"></div>

              <p data-mdb-dummy-init class="note note-light"></p>

              <img data-mdb-dummy-init class="mb-4" data-mdb-dummy-img="100%,500" data-mdb-dummy-img-text />

              <div data-mdb-dummy-init class="mb-4" data-mdb-dummy-template="blockquote,ul,h2"></div>

              <p data-mdb-dummy-init class="mb-4" id="dummy-text" data-mdb-dummy-text="500"></p>

              <div class="d-flex justify-content-between mb-4">
                <div data-mdb-dummy-init class="card col-3" data-mdb-dummy-repeat="2">
                  <img class="card-img-top" data-mdb-dummy-init data-mdb-dummy-img="100%" alt="..." />
                  <div class="card-body">
                    <h5 data-mdb-dummy-init class="card-title"></h5>
                    <p data-mdb-dummy-init class="card-text"></p>
                    <a href="#!" data-mdb-dummy-init class="btn btn-primary"></a>
                  </div>
                </div>
              </div>

              <p data-mdb-dummy-init data-mdb-dummy-copy="#dummy-text"></p>

              <div class="d-flex align-items-center">
                <img class="col-6" data-mdb-dummy-init data-mdb-dummy-img="100%" data-mdb-dummy-img-text data-mdb-dummy-img-text-length="10">
                <div class="col-6" data-mdb-dummy-init data-mdb-dummy-template="form"></div>
              </div>

            </div>
          
        
    

Dummy - API


Import

        
            
          import Dummy from 'mdb-dummy';
        
        
    

Usage

Via data attributes

Using the Datatable plugin doesn't require any additional JavaScript code - simply add data-mdb-dummy-init attribute to base element and use other data attributes to set all options.

        
            
        <div data-mdb-dummy-init></div>
      
        
    

Via JavaScript

        
            
        const dummyElement = document.getElementById('dummy-element');
        new Dummy(dummyElement);
      
        
    

Via jQuery

Note: By default, MDB does not include jQuery and you have to add it to the project on your own.

        
            
        $(document).ready(() => { 
          $('#dummy-element').dummy();
        });
      
        
    

Options

Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-mdb-, as in data-mdb-dummy-text="".

Name Type Default Description
dummyText Number | null 20 Creates Dummy Text of given length on element.
dummyImg String | null '150' Creates Dummy Img of given size.
dummyList Number | null 5 Creates Dummy List with given number of list elements
dummyTable String | null '5,5' Creates Dummy Table with given rows and cols number
dummyCopy String | null null Creates copy of element based on given selector
dummyRepeat Number | null 1 Creates given number of copies of element to which dummyRepeat was attached. Allows to repeat elements created by other Dummy methods.
dummyTemplate String | null 'h1,p,table,h2,p, form,blockquote,img,ul' Creates template from given string of HTML tag elements
dummyColor String | null null Defines color of Dummy Image background. Allows colours only in hex format
dummyTextColor String | null null Defines color of Dummy Text
dummyImgText String | null null Defines text of Dummy Text inside Dummy Image

Methods

Name Parameters Description Example
dispose Disposes a Dummy instance. instance.dispose()
init Initializes dummy for dynamically added element. instance.init()
getInstance element Static method which allows to get the dummy instance associated with a DOM element. Dummy.getInstance(dummyElement)
        
            
        const dummyElement = document.getElementById('dummy-element');
        const instance = Dummy.getInstance(dummyElement);
        instance.init();