Studio Editor: Using Multi-State Boxes

4 min read
Multi-state boxes let you show different content for different situations in the same container box, displaying one state at a time. Choose the amount of states your box should have, design them completely and give them IDs that you will later use in your code.
Your code defines when each state should be displayed. You can create conditions for each state to appear automatically, or let visitors navigate on their own. 
A GIF showing a multi-state box on a live state changing states.

Step 1 | Add a multi-state box

The first step is adding a multi-state box to your site directly from the Add panel. Drag the box to the desired location on your page. 

To add a multi-state box:

  1. クリック エレメントの追加  エディターの左側にある
  2. Click Layout Tools.
  3. Click Multi-state Boxes.
  4. Drag a multi-state box to the relevant location on your page. 
The Add Elements panel is open. The multi-state box element is highlighted.
Use multi-state boxes inside repeaters:
Once you add a multi-state box to a repeater item, it's automatically added to the rest of the items with the exact same design. This is useful for lists with repeating items like FAQs or product galleries.

Step 2 | Add and design the states

Once you've added the box, design the states that it displays. You can customize these states however you choose: Use them for small badges like product availability (e.g., "New", "Out of Stock"), or create a completely different design for each state. 
Click below to learn how to: 
The Manage States element of a multi-state box is open in the Studio Editor, showing the options.
Design tip:
The states can have different height properties, which allow you to reveal additional info for example. However, the width of your states always stays the same.

Step 3 | Add code

The last step to make the multi-state box functional is adding code that controls when each state appears. 
Using the functions and events available in the Velo API for multi-state boxes, you can define and implement rules for displaying and navigating your states.
重要だ:
While adding the relevant code, make sure you wrote the state IDs correctly, with the exact same spelling and capitalization. 
A GIF showing the states of a multi-state box, and their relevant codes to the left.

これは役に立ったか?

|