Buy Licenses Contact Support Login/Register
v 1.5.9
Overview Survey Creator Examples Docs Source Download
v 1.5.9

Survey Toolbox categories

Separate your toolbox items by different categories


                        

    
        SurveyCreator.StylesManager.applyTheme("bootstrap");
    


var creatorOptions = { };
var creator = new SurveyCreator.SurveyCreator("creatorElement", creatorOptions);
creator.showToolbox = "right";
creator.showPropertyGrid = "right";
creator.rightContainerActiveItem("toolbox");

        creator.toolbox.addItem({
                name: "countries",
                isCopied: true,
                iconName: "icon-default",
                title: "All countries",
                category: "Custom",
                json: {
                    "type": "dropdown",
                    optionsCaption: "Select a country...",
                    choicesByUrl: {
                        url: "https://restcountries.eu/rest/v2/all"
                    }
                }
            });
        creator.toolbox.changeCategories([{ name: "panel", category: "Panels" }, { name: "paneldynamic", category: "Panels" }, { name: "matrix", category: "Matrix" }, { name: "matrixdropdown", category: "Matrix" }, { name: "matrixdynamic", category: "Matrix" }]);

                    
<!DOCTYPE html>
<html lang="en">
<head>
    <title>Separate your toolbox items by different categories, Survey Creator Example</title>


    <meta name="viewport" content="width=device-width, initial-scale=1">
    <script src="https://cdnjs.cloudflare.com/ajax/libs/knockout/3.4.0/knockout-min.js"></script>
<script src="https://surveyjs.azureedge.net/1.5.9/survey.ko.js"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/ace/1.2.0/ace.min.js" type="text/javascript" charset="utf-8"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/ace/1.2.0/ext-language_tools.js" type="text/javascript" charset="utf-8"></script>
    <!-- Uncomment to enable Select2
    <script src="https://unpkg.com/jquery"></script>
    <link href="https://cdnjs.cloudflare.com/ajax/libs/select2/4.0.3/css/select2.min.css" rel="stylesheet" />
    <script src="https://cdnjs.cloudflare.com/ajax/libs/select2/4.0.3/js/select2.min.js"></script>
    -->
    <link href="https://surveyjs.azureedge.net/1.5.9/survey-creator.css" type="text/css" rel="stylesheet" />
    <script src="https://surveyjs.azureedge.net/1.5.9/survey-creator.js"></script>
    <link rel="stylesheet" href="https://unpkg.com/bootstrap@3.3.7/dist/css/bootstrap.min.css">
    <link rel="stylesheet" href="./index.css">

</head>
<body>
        <div id="surveyContainer">
        <div id="creatorElement"></div>
    </div>

<script type="text/javascript" src="./index.js"></script>

</body>
</html>

Question Toolbox API

By default there is one category in the Toolbox (General) and its title is not shown.

You may change the category of the default question types by calling changeCategory function
creator.toolbox.changeCategory("panel", "Panels");
creator.toolbox.changeCategory("paneldynamic", "Panels");
The better way is to use changeCategories function. It will rebuild toolbox presentation model just one time:
creator.toolbox.changeCategories([{ name: "panel", category: "Panels" }, { name: "paneldynamic", category: "Panels" }, { name: "matrix", category: "Matrix" }]);

You may change the name of the default (General) category as any other localizable string. Please make sure to run this code before creating the Editor.
SurveyCreator.defaultStrings.ed.toolboxGeneralCategory = "Common";