Merge pull request #3579 from edx/andya/container-add-buttons

Allow creation of components on container page

CHANGELOG.rst

@@ -7,6 +7,8 @@ the top.  Include a label indicating the component affected.
 
 Blades: Tolerance expressed in percentage now computes correctly. BLD-522.
 
+Studio: Support add, delete and duplicate on the container page. STUD-1490.
+
 Studio: Add drag-and-drop support to the container page. STUD-1309.
 
 Common: Add extensible third-party auth module.
@@ -20,7 +22,8 @@ LMS: Switch default instructor dashboard to the new (formerly "beta")
 Blades: Handle situation if no response were sent from XQueue to LMS in Matlab
 problem after Run Code button press. BLD-994.
 
-Blades: Set initial video quality to large instead of default to avoid automatic switch to HD when iframe resizes. BLD-981.
+Blades: Set initial video quality to large instead of default to avoid automatic
+switch to HD when iframe resizes. BLD-981.
 
 Blades: Add an upload button for authors to provide students with an option to
 download a handout associated with a video (of arbitrary file format). BLD-1000.

cms/djangoapps/contentstore/tests/test_contentstore.py

@@ -490,12 +490,10 @@ class ContentStoreToyCourseTest(ModuleStoreTestCase):
         Tests the ajax callback to render an XModule
         """
         resp = self._test_preview(Location('i4x', 'edX', 'toy', 'vertical', 'vertical_test', None), 'container_preview')
-        # These are the data-ids of the xblocks contained in the vertical.
-        # Ultimately, these must be converted to new locators.
-        self.assertContains(resp, 'i4x://edX/toy/video/sample_video')
-        self.assertContains(resp, 'i4x://edX/toy/video/separate_file_video')
-        self.assertContains(resp, 'i4x://edX/toy/video/video_with_end_time')
-        self.assertContains(resp, 'i4x://edX/toy/poll_question/T1_changemind_poll_foo_2')
+        self.assertContains(resp, '/branch/draft/block/sample_video')
+        self.assertContains(resp, '/branch/draft/block/separate_file_video')
+        self.assertContains(resp, '/branch/draft/block/video_with_end_time')
+        self.assertContains(resp, '/branch/draft/block/T1_changemind_poll_foo_2')
 
     def _test_preview(self, location, view_name):
         """ Preview test case. """

cms/djangoapps/contentstore/views/component.py

@@ -164,70 +164,7 @@ def unit_handler(request, tag=None, package_id=None, branch=None, version_guid=N
         except ItemNotFoundError:
             return HttpResponseBadRequest()
 
-        component_templates = defaultdict(list)
-        for category in COMPONENT_TYPES:
-            component_class = _load_mixed_class(category)
-            # add the default template
-            # TODO: Once mixins are defined per-application, rather than per-runtime,
-            # this should use a cms mixed-in class. (cpennington)
-            if hasattr(component_class, 'display_name'):
-                display_name = component_class.display_name.default or 'Blank'
-            else:
-                display_name = 'Blank'
-            component_templates[category].append((
-                display_name,
-                category,
-                False,  # No defaults have markdown (hardcoded current default)
-                None  # no boilerplate for overrides
-            ))
-            # add boilerplates
-            if hasattr(component_class, 'templates'):
-                for template in component_class.templates():
-                    filter_templates = getattr(component_class, 'filter_templates', None)
-                    if not filter_templates or filter_templates(template, course):
-                        component_templates[category].append((
-                            template['metadata'].get('display_name'),
-                            category,
-                            template['metadata'].get('markdown') is not None,
-                            template.get('template_id')
-                        ))
-
-        # Check if there are any advanced modules specified in the course policy.
-        # These modules should be specified as a list of strings, where the strings
-        # are the names of the modules in ADVANCED_COMPONENT_TYPES that should be
-        # enabled for the course.
-        course_advanced_keys = course.advanced_modules
-
-        # Set component types according to course policy file
-        if isinstance(course_advanced_keys, list):
-            for category in course_advanced_keys:
-                if category in ADVANCED_COMPONENT_TYPES:
-                    # Do I need to allow for boilerplates or just defaults on the
-                    # class? i.e., can an advanced have more than one entry in the
-                    # menu? one for default and others for prefilled boilerplates?
-                    try:
-                        component_class = _load_mixed_class(category)
-
-                        component_templates['advanced'].append(
-                            (
-                                component_class.display_name.default or category,
-                                category,
-                                False,
-                                None  # don't override default data
-                            )
-                        )
-                    except PluginMissingError:
-                        # dhm: I got this once but it can happen any time the
-                        # course author configures an advanced component which does
-                        # not exist on the server. This code here merely
-                        # prevents any authors from trying to instantiate the
-                        # non-existent component type by not showing it in the menu
-                        pass
-        else:
-            log.error(
-                "Improper format for course advanced keys! %s",
-                course_advanced_keys
-            )
+        component_templates = _get_component_templates(course)
 
         xblocks = item.get_children()
         locators = [
@@ -274,7 +211,7 @@ def unit_handler(request, tag=None, package_id=None, branch=None, version_guid=N
             'unit': item,
             'unit_locator': locator,
             'locators': locators,
-            'component_templates': component_templates,
+            'component_templates': json.dumps(component_templates),
             'draft_preview_link': preview_lms_link,
             'published_preview_link': lms_link,
             'subsection': containing_subsection,
@@ -312,6 +249,7 @@ def container_handler(request, tag=None, package_id=None, branch=None, version_g
         except ItemNotFoundError:
             return HttpResponseBadRequest()
 
+        component_templates = _get_component_templates(course)
         ancestor_xblocks = []
         parent = get_parent_xblock(xblock)
         while parent and parent.category != 'sequential':
@@ -329,11 +267,106 @@ def container_handler(request, tag=None, package_id=None, branch=None, version_g
             'unit': unit,
             'unit_publish_state': unit_publish_state,
             'ancestor_xblocks': ancestor_xblocks,
+            'component_templates': json.dumps(component_templates),
         })
     else:
         return HttpResponseBadRequest("Only supports html requests")
 
 
+def _get_component_templates(course):
+    """
+    Returns the applicable component templates that can be used by the specified course.
+    """
+    def create_template_dict(name, cat, boilerplate_name=None, is_common=False):
+        """
+        Creates a component template dict.
+
+        Parameters
+            display_name: the user-visible name of the component
+            category: the type of component (problem, html, etc.)
+            boilerplate_name: name of boilerplate for filling in default values. May be None.
+            is_common: True if "common" problem, False if "advanced". May be None, as it is only used for problems.
+
+        """
+        return {
+            "display_name": name,
+            "category": cat,
+            "boilerplate_name": boilerplate_name,
+            "is_common": is_common
+        }
+
+    component_templates = []
+    # The component_templates array is in the order of "advanced" (if present), followed
+    # by the components in the order listed in COMPONENT_TYPES.
+    for category in COMPONENT_TYPES:
+        templates_for_category = []
+        component_class = _load_mixed_class(category)
+        # add the default template
+        # TODO: Once mixins are defined per-application, rather than per-runtime,
+        # this should use a cms mixed-in class. (cpennington)
+        if hasattr(component_class, 'display_name'):
+            display_name = component_class.display_name.default or 'Blank'
+        else:
+            display_name = 'Blank'
+        templates_for_category.append(create_template_dict(display_name, category))
+
+        # add boilerplates
+        if hasattr(component_class, 'templates'):
+            for template in component_class.templates():
+                filter_templates = getattr(component_class, 'filter_templates', None)
+                if not filter_templates or filter_templates(template, course):
+                    templates_for_category.append(
+                        create_template_dict(
+                            template['metadata'].get('display_name'),
+                            category,
+                            template.get('template_id'),
+                            template['metadata'].get('markdown') is not None
+                        )
+                    )
+        component_templates.append({"type": category, "templates": templates_for_category})
+
+    # Check if there are any advanced modules specified in the course policy.
+    # These modules should be specified as a list of strings, where the strings
+    # are the names of the modules in ADVANCED_COMPONENT_TYPES that should be
+    # enabled for the course.
+    course_advanced_keys = course.advanced_modules
+    advanced_component_templates = {"type": "advanced", "templates": []}
+    # Set component types according to course policy file
+    if isinstance(course_advanced_keys, list):
+        for category in course_advanced_keys:
+            if category in ADVANCED_COMPONENT_TYPES:
+                # boilerplates not supported for advanced components
+                try:
+                    component_class = _load_mixed_class(category)
+
+                    advanced_component_templates['templates'].append(
+                        create_template_dict(
+                            component_class.display_name.default or category,
+                            category
+                        )
+                    )
+                except PluginMissingError:
+                    # dhm: I got this once but it can happen any time the
+                    # course author configures an advanced component which does
+                    # not exist on the server. This code here merely
+                    # prevents any authors from trying to instantiate the
+                    # non-existent component type by not showing it in the menu
+                    log.warning(
+                        "Advanced component %s does not exist. It will not be added to the Studio new component menu.",
+                        category
+                    )
+                    pass
+    else:
+        log.error(
+            "Improper format for course advanced keys! %s",
+            course_advanced_keys
+        )
+    if len(advanced_component_templates['templates']) > 0:
+        component_templates.insert(0, advanced_component_templates)
+
+    return component_templates
+
+
 @login_required
 def _get_item_in_course(request, locator):
     """

cms/djangoapps/contentstore/views/helpers.py

@@ -8,7 +8,9 @@ from xmodule.modulestore.django import loc_mapper, modulestore
 __all__ = ['edge', 'event', 'landing']
 
 EDITING_TEMPLATES = [
-    "basic-modal", "modal-button", "edit-xblock-modal", "editor-mode-button", "upload-dialog", "image-modal"
+    "basic-modal", "modal-button", "edit-xblock-modal", "editor-mode-button", "upload-dialog", "image-modal",
+    "add-xblock-component", "add-xblock-component-button", "add-xblock-component-menu",
+    "add-xblock-component-menu-problem"
 ]
 
 # points to the temporary course landing page with log in and sign up
@@ -57,40 +59,54 @@ def get_parent_xblock(xblock):
     return modulestore().get_item(parent_locations[0])
 
 
-def _xblock_has_studio_page(xblock):
+def is_unit(xblock):
+    """
+    Returns true if the specified xblock is a vertical that is treated as a unit.
+    A unit is a vertical that is a direct child of a sequential (aka a subsection).
+    """
+    if xblock.category == 'vertical':
+        parent_xblock = get_parent_xblock(xblock)
+        parent_category = parent_xblock.category if parent_xblock else None
+        return parent_category == 'sequential'
+    return False
+
+
+def xblock_has_own_studio_page(xblock):
     """
     Returns true if the specified xblock has an associated Studio page. Most xblocks do
     not have their own page but are instead shown on the page of their parent. There
     are a few exceptions:
       1. Courses
-      2. Verticals
+      2. Verticals that are either:
+        - themselves treated as units (in which case they are shown on a unit page)
+        - a direct child of a unit (in which case they are shown on a container page)
       3. XBlocks with children, except for:
-          - subsections (aka sequential blocks)
-          - chapters
+        - sequentials (aka subsections)
+        - chapters (aka sections)
     """
     category = xblock.category
-    if category in ('course', 'vertical'):
+
+    if is_unit(xblock):
         return True
+    elif category == 'vertical':
+        parent_xblock = get_parent_xblock(xblock)
+        return is_unit(parent_xblock) if parent_xblock else False
     elif category in ('sequential', 'chapter'):
         return False
-    elif xblock.has_children:
-        return True
-    else:
-        return False
+
+    # All other xblocks with children have their own page
+    return xblock.has_children
 
 
 def xblock_studio_url(xblock, course=None):
     """
     Returns the Studio editing URL for the specified xblock.
     """
-    if not _xblock_has_studio_page(xblock):
+    if not xblock_has_own_studio_page(xblock):
         return None
     category = xblock.category
     parent_xblock = get_parent_xblock(xblock)
-    if parent_xblock:
-        parent_category = parent_xblock.category
-    else:
-        parent_category = None
+    parent_category = parent_xblock.category if parent_xblock else None
     if category == 'course':
         prefix = 'course'
     elif category == 'vertical' and parent_category == 'sequential':

cms/djangoapps/contentstore/views/item.py

@@ -33,7 +33,7 @@ from util.string_utils import str_to_bool
 from ..utils import get_modulestore
 
 from .access import has_course_access
-from .helpers import _xmodule_recurse
+from .helpers import _xmodule_recurse, xblock_has_own_studio_page
 from contentstore.utils import compute_publish_state, PublishState
 from xmodule.modulestore.draft import DIRECT_ONLY_CATEGORIES
 from contentstore.views.preview import get_preview_fragment
@@ -193,46 +193,56 @@ def xblock_view_handler(request, package_id, view_name, tag=None, branch=None, v
 
     if 'application/json' in accept_header:
         store = get_modulestore(old_location)
-        component = store.get_item(old_location)
-        is_read_only = _xblock_is_read_only(component)
+        xblock = store.get_item(old_location)
+        is_read_only = _is_xblock_read_only(xblock)
+        container_views = ['container_preview', 'reorderable_container_child_preview']
+        unit_views = ['student_view']
 
         # wrap the generated fragment in the xmodule_editor div so that the javascript
         # can bind to it correctly
-        component.runtime.wrappers.append(partial(wrap_xblock, 'StudioRuntime'))
+        xblock.runtime.wrappers.append(partial(wrap_xblock, 'StudioRuntime'))
 
         if view_name == 'studio_view':
             try:
-                fragment = component.render('studio_view')
+                fragment = xblock.render('studio_view')
             # catch exceptions indiscriminately, since after this point they escape the
             # dungeon and surface as uneditable, unsaveable, and undeletable
             # component-goblins.
             except Exception as exc:                          # pylint: disable=w0703
-                log.debug("unable to render studio_view for %r", component, exc_info=True)
+                log.debug("unable to render studio_view for %r", xblock, exc_info=True)
                 fragment = Fragment(render_to_string('html_error.html', {'message': str(exc)}))
 
             # change not authored by requestor but by xblocks.
-            store.update_item(component, None)
+            store.update_item(xblock, None)
 
-        elif view_name == 'student_view' and component.has_children:
+        elif view_name == 'student_view' and xblock_has_own_studio_page(xblock):
             context = {
                 'runtime_type': 'studio',
                 'container_view': False,
                 'read_only': is_read_only,
-                'root_xblock': component,
+                'root_xblock': xblock,
             }
             # For non-leaf xblocks on the unit page, show the special rendering
             # which links to the new container page.
             html = render_to_string('container_xblock_component.html', {
                 'xblock_context': context,
-                'xblock': component,
+                'xblock': xblock,
                 'locator': locator,
             })
             return JsonResponse({
                 'html': html,
                 'resources': [],
             })
-        elif view_name in ('student_view', 'container_preview'):
-            is_container_view = (view_name == 'container_preview')
+        elif view_name in (unit_views + container_views):
+            is_container_view = (view_name in container_views)
+
+            # Determine the items to be shown as reorderable. Note that the view
+            # 'reorderable_container_child_preview' is only rendered for xblocks that
+            # are being shown in a reorderable container, so the xblock is automatically
+            # added to the list.
+            reorderable_items = set()
+            if view_name == 'reorderable_container_child_preview':
+                reorderable_items.add(xblock.location)
 
             # Only show the new style HTML for the container view, i.e. for non-verticals
             # Note: this special case logic can be removed once the unit page is replaced
@@ -241,10 +251,11 @@ def xblock_view_handler(request, package_id, view_name, tag=None, branch=None, v
                 'runtime_type': 'studio',
                 'container_view': is_container_view,
                 'read_only': is_read_only,
-                'root_xblock': component,
+                'root_xblock': xblock if (view_name == 'container_preview') else None,
+                'reorderable_items': reorderable_items
             }
 
-            fragment = get_preview_fragment(request, component, context)
+            fragment = get_preview_fragment(request, xblock, context)
             # For old-style pages (such as unit and static pages), wrap the preview with
             # the component div. Note that the container view recursively adds headers
             # into the preview fragment, so we don't want to add another header here.
@@ -252,7 +263,7 @@ def xblock_view_handler(request, package_id, view_name, tag=None, branch=None, v
                 fragment.content = render_to_string('component.html', {
                     'xblock_context': context,
                     'preview': fragment.content,
-                    'label': component.display_name or component.scope_ids.block_type,
+                    'label': xblock.display_name or xblock.scope_ids.block_type,
                 })
         else:
             raise Http404
@@ -270,7 +281,7 @@ def xblock_view_handler(request, package_id, view_name, tag=None, branch=None, v
         return HttpResponse(status=406)
 
 
-def _xblock_is_read_only(xblock):
+def _is_xblock_read_only(xblock):
     """
     Returns true if the specified xblock is read-only, meaning that it cannot be edited.
     """
@@ -411,7 +422,7 @@ def _create_item(request):
     metadata = {}
     data = None
     template_id = request.json.get('boilerplate')
-    if template_id is not None:
+    if template_id:
         clz = parent.runtime.load_block_type(category)
         if clz is not None:
             template = clz.get_template(template_id)

cms/djangoapps/contentstore/views/preview.py

@@ -28,7 +28,7 @@ from util.sandboxing import can_execute_unsafe_code
 
 import static_replace
 from .session_kv_store import SessionKeyValueStore
-from .helpers import render_from_lms
+from .helpers import render_from_lms, xblock_has_own_studio_page
 from ..utils import get_course_for_item
 
 from contentstore.views.access import get_user_role
@@ -166,6 +166,13 @@ def _load_preview_module(request, descriptor):
     return descriptor
 
 
+def _is_xblock_reorderable(xblock, context):
+    """
+    Returns true if the specified xblock is in the set of reorderable xblocks.
+    """
+    return xblock.location in context['reorderable_items']
+
+
 # pylint: disable=unused-argument
 def _studio_wrap_xblock(xblock, view, frag, context, display_name_only=False):
     """
@@ -173,17 +180,21 @@ def _studio_wrap_xblock(xblock, view, frag, context, display_name_only=False):
     """
     # Only add the Studio wrapper when on the container page. The unit page will remain as is for now.
     if context.get('container_view', None) and view == 'student_view':
+        root_xblock = context.get('root_xblock')
+        is_root = root_xblock and xblock.location == root_xblock.location
         locator = loc_mapper().translate_location(xblock.course_id, xblock.location, published=False)
+        is_reorderable = _is_xblock_reorderable(xblock, context)
         template_context = {
             'xblock_context': context,
             'xblock': xblock,
             'locator': locator,
             'content': frag.content,
+            'is_root': is_root,
+            'is_reorderable': is_reorderable,
         }
-        if xblock.category == 'vertical':
-            template = 'studio_vertical_wrapper.html'
-        elif xblock.location != context.get('root_xblock').location and xblock.has_children:
-            template = 'container_xblock_component.html'
+        # For child xblocks with their own page, render a link to the page
+        if xblock_has_own_studio_page(xblock) and not is_root:
+            template = 'studio_container_wrapper.html'
         else:
             template = 'studio_xblock_wrapper.html'
         html = render_to_string(template, template_context)

cms/djangoapps/contentstore/views/tests/test_tabs.py

@@ -189,7 +189,7 @@ class TabsPageTests(CourseTestCase):
         self.assertIn('<span class="action-button-text">Edit</span>', html)
         self.assertIn('<span class="sr">Duplicate this component</span>', html)
         self.assertIn('<span class="sr">Delete this component</span>', html)
-        self.assertIn('<span data-tooltip="Drag to reorder" class="drag-handle"></span>', html)
+        self.assertIn('<span data-tooltip="Drag to reorder" class="drag-handle action"></span>', html)
 
 
 

cms/djangoapps/contentstore/views/tests/test_unit_page.py

+"""
+Unit tests for the unit page.
+"""
+
+from contentstore.views.tests.utils import StudioPageTestCase
+from xmodule.modulestore.django import modulestore
+from xmodule.modulestore.tests.factories import ItemFactory
+
+
+class UnitPageTestCase(StudioPageTestCase):
+    """
+    Unit tests for the unit page.
+    """
+
+    def setUp(self):
+        super(UnitPageTestCase, self).setUp()
+        self.vertical = ItemFactory.create(parent_location=self.sequential.location,
+                                           category='vertical', display_name='Unit')
+        self.video = ItemFactory.create(parent_location=self.vertical.location,
+                                        category="video", display_name="My Video")
+
+    def test_public_unit_page_html(self):
+        """
+        Verify that an xblock returns the expected HTML for a public unit page.
+        """
+        html = self.get_page_html(self.vertical)
+        self.validate_html_for_add_buttons(html)
+
+    def test_draft_unit_page_html(self):
+        """
+        Verify that an xblock returns the expected HTML for a draft unit page.
+        """
+        draft_unit = modulestore('draft').convert_to_draft(self.vertical.location)
+        html = self.get_page_html(draft_unit)
+        self.validate_html_for_add_buttons(html)
+
+    def test_public_component_preview_html(self):
+        """
+        Verify that a public xblock's preview returns the expected HTML.
+        """
+        self.validate_preview_html(self.video, 'student_view',
+                                   can_edit=True, can_reorder=True, can_add=False)
+
+    def test_draft_component_preview_html(self):
+        """
+        Verify that a draft xblock's preview returns the expected HTML.
+        """
+        modulestore('draft').convert_to_draft(self.vertical.location)
+        draft_video = modulestore('draft').convert_to_draft(self.video.location)
+        self.validate_preview_html(draft_video, 'student_view',
+                                   can_edit=True, can_reorder=True, can_add=False)
+
+    def test_public_child_container_preview_html(self):
+        """
+        Verify that a public child container rendering on the unit page (which shows a View arrow
+        to the container page) returns the expected HTML.
+        """
+        child_container = ItemFactory.create(parent_location=self.vertical.location,
+                                             category='split_test', display_name='Split Test')
+        ItemFactory.create(parent_location=child_container.location,
+                           category='html', display_name='grandchild')
+        self.validate_preview_html(child_container, 'student_view',
+                                   can_reorder=True, can_edit=False, can_add=False)
+
+    def test_draft_child_container_preview_html(self):
+        """
+        Verify that a draft child container rendering on the unit page (which shows a View arrow
+        to the container page) returns the expected HTML.
+        """
+        child_container = ItemFactory.create(parent_location=self.vertical.location,
+                                             category='split_test', display_name='Split Test')
+        ItemFactory.create(parent_location=child_container.location,
+                           category='html', display_name='grandchild')
+        modulestore('draft').convert_to_draft(self.vertical.location)
+        draft_child_container = modulestore('draft').get_item(child_container.location)
+        self.validate_preview_html(draft_child_container, 'student_view',
+                                   can_reorder=True, can_edit=False, can_add=False)

cms/djangoapps/contentstore/views/tests/utils.py

+"""
+Utilities for view tests.
+"""
+
+import json
+
+from contentstore.tests.utils import CourseTestCase
+from contentstore.views.helpers import xblock_studio_url
+from xmodule.modulestore.django import loc_mapper
+from xmodule.modulestore.tests.factories import ItemFactory
+
+
+class StudioPageTestCase(CourseTestCase):
+    """
+    Base class for all tests of Studio pages.
+    """
+
+    def setUp(self):
+        super(StudioPageTestCase, self).setUp()
+        self.chapter = ItemFactory.create(parent_location=self.course.location,
+                                          category='chapter', display_name="Week 1")
+        self.sequential = ItemFactory.create(parent_location=self.chapter.location,
+                                             category='sequential', display_name="Lesson 1")
+
+    def get_page_html(self, xblock):
+        """
+        Returns the HTML for the page representing the xblock.
+        """
+        url = xblock_studio_url(xblock, self.course)
+        self.assertIsNotNone(url)
+        resp = self.client.get_html(url)
+        self.assertEqual(resp.status_code, 200)
+        return resp.content
+
+    def get_preview_html(self, xblock, view_name):
+        """
+        Returns the HTML for the xblock when shown within a unit or container page.
+        """
+        locator = loc_mapper().translate_location(self.course.id, xblock.location, published=False)
+        preview_url = '/xblock/{locator}/{view_name}'.format(locator=locator, view_name=view_name)
+        resp = self.client.get_json(preview_url)
+        self.assertEqual(resp.status_code, 200)
+        resp_content = json.loads(resp.content)
+        return resp_content['html']
+
+    def validate_preview_html(self, xblock, view_name, can_edit=True, can_reorder=True, can_add=True):
+        """
+        Verify that the specified xblock's preview has the expected HTML elements.
+        """
+        html = self.get_preview_html(xblock, view_name)
+        self.validate_html_for_add_buttons(html, can_add=can_add)
+
+        # Verify that there are no drag handles for public blocks
+        drag_handle_html = '<span data-tooltip="Drag to reorder" class="drag-handle action"></span>'
+        if can_reorder:
+            self.assertIn(drag_handle_html, html)
+        else:
+            self.assertNotIn(drag_handle_html, html)
+
+        # Verify that there are no action buttons for public blocks
+        expected_button_html = [
+            '<a href="#" class="edit-button action-button">',
+            '<a href="#" data-tooltip="Delete" class="delete-button action-button">',
+            '<a href="#" data-tooltip="Duplicate" class="duplicate-button action-button">'
+        ]
+        for button_html in expected_button_html:
+            if can_edit:
+                self.assertIn(button_html, html)
+            else:
+                self.assertNotIn(button_html, html)
+
+    def validate_html_for_add_buttons(self, html, can_add=True):
+        """
+        Validate that the specified HTML has the appropriate add actions for the current publish state.
+        """
+        # Verify that there are no add buttons for public blocks
+        add_button_html = '<div class="add-xblock-component new-component-item adding"></div>'
+        if can_add:
+            self.assertIn(add_button_html, html)
+        else:
+            self.assertNotIn(add_button_html, html)

cms/envs/common.py

@@ -102,12 +102,6 @@ FEATURES = {
 
     # Turn off Advanced Security by default
     'ADVANCED_SECURITY': False,
-
-    # Temporary feature flag for duplicating xblock leaves
-    'ENABLE_DUPLICATE_XBLOCK_LEAF_COMPONENT': False,
-
-    # Temporary feature flag for deleting xblock leaves
-    'ENABLE_DELETE_XBLOCK_LEAF_COMPONENT': False,
 }
 ENABLE_JASMINE = False
 

cms/static/coffee/spec/views/module_edit_spec.coffee

@@ -19,7 +19,7 @@ define ["jquery", "js/spec_helpers/edit_helpers", "coffee/src/views/module_edit"
             <a href="#" class="edit-button"><span class="edit-icon white"></span>Edit</a>
             <a href="#" class="delete-button"><span class="delete-icon white"></span>Delete</a>
           </div>
-          <span class="drag-handle"></span>
+          <span class="drag-handle action"></span>
           <section class="xblock xblock-student_view xmodule_display xmodule_stub" data-type="StubModule">
             <div id="stub-module-content"/>
           </section>

cms/static/js/collections/component_template.js

+define(["backbone", "js/models/component_template"], function(Backbone, ComponentTemplate) {
+    return Backbone.Collection.extend({
+        model : ComponentTemplate
+    });
+});

cms/static/js/models/component_template.js

+/**
+ * Simple model for adding a component of a given type (for example, "video" or "html").
+ */
+define(["backbone"], function (Backbone) {
+    return Backbone.Model.extend({
+        defaults: {
+            type: "",
+            // Each entry in the template array is an Object with the following keys:
+            // display_name
+            // category (may or may not match "type")
+            // boilerplate_name (may be null)
+            // is_common (only used for problems)
+            templates: []
+        },
+        parse: function (response) {
+            this.type = response.type;
+            this.templates = response.templates;
+
+            // Sort the templates.
+            this.templates.sort(function (a, b) {
+                // The entry without a boilerplate always goes first
+                if (!a.boilerplate_name || (a.display_name < b.display_name)) {
+                    return -1;
+                }
+                else {
+                    return (a.display_name > b.display_name) ? 1 : 0;
+                }
+            });
+        }
+    });
+});

cms/static/js/spec/views/baseview_spec.js

-define(["jquery", "underscore", "js/views/baseview", "js/utils/handle_iframe_binding", "sinon"],
-    function ($, _, BaseView, IframeBinding, sinon) {
+define(["jquery", "underscore", "js/views/baseview", "js/utils/handle_iframe_binding", "sinon",
+    "js/spec_helpers/edit_helpers"],
+    function ($, _, BaseView, IframeBinding, sinon, view_helpers) {
 
         describe("BaseView", function() {
             var baseViewPrototype;
@@ -79,8 +80,7 @@ define(["jquery", "underscore", "js/views/baseview", "js/utils/handle_iframe_bin
 
             describe("disabled element while running", function() {
                 it("adds 'is-disabled' class to element while action is running and removes it after", function() {
-                    var viewWithLink,
-                        link,
+                    var link,
                         deferred = new $.Deferred(),
                         promise = deferred.promise(),
                         view = new BaseView();
@@ -89,11 +89,37 @@ define(["jquery", "underscore", "js/views/baseview", "js/utils/handle_iframe_bin
 
                     link = $("#link");
                     expect(link).not.toHaveClass("is-disabled");
-                    view.disableElementWhileRunning(link, function(){return promise});
+                    view.disableElementWhileRunning(link, function() { return promise; });
                     expect(link).toHaveClass("is-disabled");
                     deferred.resolve();
                     expect(link).not.toHaveClass("is-disabled");
                 });
             });
+
+            describe("progress notification", function() {
+                it("shows progress notification and removes it upon success", function() {
+                    var testMessage = "Testing...",
+                        deferred = new $.Deferred(),
+                        promise = deferred.promise(),
+                        view = new BaseView(),
+                        notificationSpy = view_helpers.createNotificationSpy();
+                    view.runOperationShowingMessage(testMessage, function() { return promise; });
+                    view_helpers.verifyNotificationShowing(notificationSpy, /Testing/);
+                    deferred.resolve();
+                    view_helpers.verifyNotificationHidden(notificationSpy);
+                });
+
+                it("shows progress notification and leaves it showing upon failure", function() {
+                    var testMessage = "Testing...",
+                        deferred = new $.Deferred(),
+                        promise = deferred.promise(),
+                        view = new BaseView(),
+                        notificationSpy = view_helpers.createNotificationSpy();
+                    view.runOperationShowingMessage(testMessage, function() { return promise; });
+                    view_helpers.verifyNotificationShowing(notificationSpy, /Testing/);
+                    deferred.fail();
+                    view_helpers.verifyNotificationShowing(notificationSpy, /Testing/);
+                });
+            });
         });
     });

cms/static/js/spec/views/container_spec.js

 define([ "jquery", "js/spec_helpers/create_sinon", "js/spec_helpers/view_helpers",
-    "js/views/container", "js/models/xblock_info", "js/views/feedback_notification", "jquery.simulate",
+    "js/views/container", "js/models/xblock_info", "jquery.simulate",
     "xmodule", "coffee/src/main", "xblock/cms.runtime.v1"],
-    function ($, create_sinon, view_helpers, ContainerView, XBlockInfo, Notification) {
+    function ($, create_sinon, view_helpers, ContainerView, XBlockInfo) {
 
         describe("Container View", function () {
 
@@ -9,7 +9,7 @@ define([ "jquery", "js/spec_helpers/create_sinon", "js/spec_helpers/view_helpers
 
                 var model, containerView, mockContainerHTML, respondWithMockXBlockFragment, init, getComponent,
                     getDragHandle, dragComponentVertically, dragComponentAbove,
-                    verifyRequest, verifyNumReorderCalls, respondToRequest,
+                    verifyRequest, verifyNumReorderCalls, respondToRequest, notificationSpy,
 
                     rootLocator = 'testCourse/branch/draft/split_test/splitFFF',
                     containerTestUrl = '/xblock/' + rootLocator,
@@ -35,7 +35,8 @@ define([ "jquery", "js/spec_helpers/create_sinon", "js/spec_helpers/view_helpers
 
                 beforeEach(function () {
                     view_helpers.installViewTemplates();
-                    appendSetFixtures('<div class="wrapper-xblock level-page" data-locator="' + rootLocator + '"></div>');
+                    appendSetFixtures('<div class="wrapper-xblock level-page studio-xblock-wrapper" data-locator="' + rootLocator + '"></div>');
+                    notificationSpy = view_helpers.createNotificationSpy();
                     model = new XBlockInfo({
                         id: rootLocator,
                         display_name: 'Test AB Test',
@@ -63,16 +64,29 @@ define([ "jquery", "js/spec_helpers/create_sinon", "js/spec_helpers/view_helpers
                     });
 
                     $('body').append(containerView.$el);
+
+                    // Give the whole container enough height to contain everything.
+                    $('.xblock[data-locator=locator-container]').css('height', 2000);
+
+                    // Give the groups enough height to contain their child vertical elements.
+                    $('.is-draggable[data-locator=locator-group-A]').css('height', 800);
+                    $('.is-draggable[data-locator=locator-group-B]').css('height', 800);
+
+
+                    // Give the leaf elements some height to mimic actual components. Otherwise
+                    // drag and drop fails as the elements on bunched on top of each other.
+                    $('.level-element').css('height', 200);
+
                     return requests;
                 };
 
                 getComponent = function(locator) {
-                    return containerView.$('[data-locator="' + locator + '"]');
+                    return containerView.$('.studio-xblock-wrapper[data-locator="' + locator + '"]');
                 };
 
                 getDragHandle = function(locator) {
                     var component = getComponent(locator);
-                    return component.prev();
+                    return $(component.find('.drag-handle')[0]);
                 };
 
                 dragComponentVertically = function (locator, dy) {
@@ -166,31 +180,17 @@ define([ "jquery", "js/spec_helpers/create_sinon", "js/spec_helpers/view_helpers
                 });
 
                 describe("Shows a saving message", function () {
-                    var savingSpies;
-
-                    beforeEach(function () {
-                        savingSpies = spyOnConstructor(Notification, "Mini",
-                            ["show", "hide"]);
-                        savingSpies.show.andReturn(savingSpies);
-                    });
-
                     it('hides saving message upon success', function () {
                         var requests, savingOptions;
                         requests = init(this);
 
                         // Drag the first component in Group B to the first group.
                         dragComponentAbove(groupBComponent1, groupAComponent1);
-
-                        expect(savingSpies.constructor).toHaveBeenCalled();
-                        expect(savingSpies.show).toHaveBeenCalled();
-                        expect(savingSpies.hide).not.toHaveBeenCalled();
-                        savingOptions = savingSpies.constructor.mostRecentCall.args[0];
-                        expect(savingOptions.title).toMatch(/Saving/);
-
+                        view_helpers.verifyNotificationShowing(notificationSpy, 'Saving');
                         respondToRequest(requests, 0, 200);
-                        expect(savingSpies.hide).not.toHaveBeenCalled();
+                        view_helpers.verifyNotificationShowing(notificationSpy, 'Saving');
                         respondToRequest(requests, 1, 200);
-                        expect(savingSpies.hide).toHaveBeenCalled();
+                        view_helpers.verifyNotificationHidden(notificationSpy);
                     });
 
                     it('does not hide saving message if failure', function () {
@@ -198,13 +198,9 @@ define([ "jquery", "js/spec_helpers/create_sinon", "js/spec_helpers/view_helpers
 
                         // Drag the first component in Group B to the first group.
                         dragComponentAbove(groupBComponent1, groupAComponent1);
-
-                        expect(savingSpies.constructor).toHaveBeenCalled();
-                        expect(savingSpies.show).toHaveBeenCalled();
-                        expect(savingSpies.hide).not.toHaveBeenCalled();
-
+                        view_helpers.verifyNotificationShowing(notificationSpy, 'Saving');
                         respondToRequest(requests, 0, 500);
-                        expect(savingSpies.hide).not.toHaveBeenCalled();
+                        view_helpers.verifyNotificationShowing(notificationSpy, 'Saving');
 
                         // Since the first reorder call failed, the removal will not be called.
                         verifyNumReorderCalls(requests, 1);

cms/static/js/spec/views/xblock_editor_spec.js

@@ -29,7 +29,7 @@ define([ "jquery", "underscore", "js/spec_helpers/create_sinon", "js/spec_helper
                 var mockXBlockEditorHtml;
 
                 beforeEach(function () {
-                    edit_helpers.installMockXBlock(mockSaveResponse);
+                    edit_helpers.installMockXBlock();
                 });
 
                 afterEach(function() {

cms/static/js/spec_helpers/create_sinon.js

-define(["sinon"], function(sinon) {
+define(["sinon", "underscore"], function(sinon, _) {
     var fakeServer, fakeRequests, respondWithJson, respondWithError;
 
     /* These utility methods are used by Jasmine tests to create a mock server or
@@ -46,14 +46,18 @@ define(["sinon"], function(sinon) {
     };
 
     respondWithJson = function(requests, jsonResponse, requestIndex) {
-        requestIndex = requestIndex || requests.length - 1;
+        if (_.isUndefined(requestIndex)) {
+            requestIndex = requests.length - 1;
+        }
         requests[requestIndex].respond(200,
             { "Content-Type": "application/json" },
             JSON.stringify(jsonResponse));
     };
 
     respondWithError = function(requests, requestIndex) {
-        requestIndex = requestIndex || requests.length - 1;
+        if (_.isUndefined(requestIndex)) {
+            requestIndex = requests.length - 1;
+        }
         requests[requestIndex].respond(500,
             { "Content-Type": "application/json" },
             JSON.stringify({ }));

cms/static/js/spec_helpers/edit_helpers.js

@@ -2,22 +2,14 @@
  * Provides helper methods for invoking Studio editors in Jasmine tests.
  */
 define(["jquery", "underscore", "js/spec_helpers/create_sinon", "js/spec_helpers/modal_helpers",
-    "js/views/modals/edit_xblock", "xmodule", "coffee/src/main", "xblock/cms.runtime.v1"],
-    function($, _, create_sinon, modal_helpers, EditXBlockModal) {
+    "js/views/modals/edit_xblock", "js/collections/component_template",
+    "xmodule", "coffee/src/main", "xblock/cms.runtime.v1"],
+    function($, _, create_sinon, modal_helpers, EditXBlockModal, ComponentTemplates) {
 
-        var editorTemplate = readFixtures('metadata-editor.underscore'),
-            numberEntryTemplate = readFixtures('metadata-number-entry.underscore'),
-            stringEntryTemplate = readFixtures('metadata-string-entry.underscore'),
-            editXBlockModalTemplate = readFixtures('edit-xblock-modal.underscore'),
-            editorModeButtonTemplate = readFixtures('editor-mode-button.underscore'),
-            installMockXBlock,
-            uninstallMockXBlock,
-            installMockXModule,
-            uninstallMockXModule,
-            installEditTemplates,
-            showEditModal;
+        var installMockXBlock, uninstallMockXBlock, installMockXModule, uninstallMockXModule,
+            mockComponentTemplates, installEditTemplates, showEditModal, verifyXBlockRequest;
 
-        installMockXBlock = function(mockResult) {
+        installMockXBlock = function() {
             window.MockXBlock = function(runtime, element) {
                 return {
                     runtime: runtime
@@ -41,17 +33,52 @@ define(["jquery", "underscore", "js/spec_helpers/create_sinon", "js/spec_helpers
             window.MockDescriptor = null;
         };
 
+        mockComponentTemplates = new ComponentTemplates([
+            {
+                templates: [
+                    {
+                        category: 'discussion',
+                        display_name: 'Discussion'
+                    }],
+                type: 'discussion'
+            }, {
+                "templates": [
+                    {
+                        "category": "html",
+                        "boilerplate_name": null,
+                        "display_name": "Text"
+                    }, {
+                        "category": "html",
+                        "boilerplate_name": "announcement.yaml",
+                        "display_name": "Announcement"
+                    }, {
+                        "category": "html",
+                        "boilerplate_name": "raw.yaml",
+                        "display_name": "Raw HTML"
+                    }],
+                "type": "html"
+            }],
+            {
+                parse: true
+            });
+
         installEditTemplates = function(append) {
             modal_helpers.installModalTemplates(append);
 
+            // Add templates needed by the add XBlock menu
+            modal_helpers.installTemplate('add-xblock-component');
+            modal_helpers.installTemplate('add-xblock-component-button');
+            modal_helpers.installTemplate('add-xblock-component-menu');
+            modal_helpers.installTemplate('add-xblock-component-menu-problem');
+
             // Add templates needed by the edit XBlock modal
-            appendSetFixtures($("<script>", { id: "edit-xblock-modal-tpl", type: "text/template" }).text(editXBlockModalTemplate));
-            appendSetFixtures($("<script>", { id: "editor-mode-button-tpl", type: "text/template" }).text(editorModeButtonTemplate));
+            modal_helpers.installTemplate('edit-xblock-modal');
+            modal_helpers.installTemplate('editor-mode-button');
 
             // Add templates needed by the settings editor
-            appendSetFixtures($("<script>", {id: "metadata-editor-tpl", type: "text/template"}).text(editorTemplate));
-            appendSetFixtures($("<script>", {id: "metadata-number-entry", type: "text/template"}).text(numberEntryTemplate));
-            appendSetFixtures($("<script>", {id: "metadata-string-entry", type: "text/template"}).text(stringEntryTemplate));
+            modal_helpers.installTemplate('metadata-editor');
+            modal_helpers.installTemplate('metadata-number-entry');
+            modal_helpers.installTemplate('metadata-string-entry');
         };
 
         showEditModal = function(requests, xblockElement, model, mockHtml, options) {
@@ -64,12 +91,22 @@ define(["jquery", "underscore", "js/spec_helpers/create_sinon", "js/spec_helpers
             return modal;
         };
 
+        verifyXBlockRequest = function (requests, expectedJson) {
+            var request = requests[requests.length - 1],
+                actualJson = JSON.parse(request.requestBody);
+            expect(request.url).toEqual("/xblock");
+            expect(request.method).toEqual("POST");
+            expect(actualJson).toEqual(expectedJson);
+        };
+
         return $.extend(modal_helpers, {
             'installMockXBlock': installMockXBlock,
             'uninstallMockXBlock': uninstallMockXBlock,
             'installMockXModule': installMockXModule,
             'uninstallMockXModule': uninstallMockXModule,
+            'mockComponentTemplates': mockComponentTemplates,
             'installEditTemplates': installEditTemplates,
-            'showEditModal': showEditModal
+            'showEditModal': showEditModal,
+            'verifyXBlockRequest': verifyXBlockRequest
         });
     });

cms/static/js/spec_helpers/modal_helpers.js

@@ -3,10 +3,7 @@
  */
 define(["jquery", "js/spec_helpers/view_helpers"],
     function($, view_helpers) {
-        var basicModalTemplate = readFixtures('basic-modal.underscore'),
-            modalButtonTemplate = readFixtures('modal-button.underscore'),
-            feedbackTemplate = readFixtures('system-feedback.underscore'),
-            installModalTemplates,
+        var installModalTemplates,
             getModalElement,
             isShowingModal,
             hideModalIfShowing,
@@ -15,8 +12,8 @@ define(["jquery", "js/spec_helpers/view_helpers"],
 
         installModalTemplates = function(append) {
             view_helpers.installViewTemplates(append);
-            appendSetFixtures($("<script>", { id: "basic-modal-tpl", type: "text/template" }).text(basicModalTemplate));
-            appendSetFixtures($("<script>", { id: "modal-button-tpl", type: "text/template" }).text(modalButtonTemplate));
+            view_helpers.installTemplate('basic-modal');
+            view_helpers.installTemplate('modal-button');
         };
 
         getModalElement = function(modal) {

cms/static/js/spec_helpers/view_helpers.js

 /**
  * Provides helper methods for invoking Studio modal windows in Jasmine tests.
  */
-define(["jquery"],
-    function($) {
-        var feedbackTemplate = readFixtures('system-feedback.underscore'),
-            installViewTemplates;
+define(["jquery", "js/views/feedback_notification", "js/spec_helpers/create_sinon"],
+    function($, NotificationView, create_sinon) {
+        var installTemplate, installViewTemplates, createNotificationSpy, verifyNotificationShowing,
+            verifyNotificationHidden;
 
-        installViewTemplates = function(append) {
-            if (append) {
-                appendSetFixtures($("<script>", { id: "system-feedback-tpl", type: "text/template" }).text(feedbackTemplate));
+        installTemplate = function(templateName, isFirst) {
+            var template = readFixtures(templateName + '.underscore'),
+                templateId = templateName + '-tpl';
+            if (isFirst) {
+                setFixtures($("<script>", { id: templateId, type: "text/template" }).text(template));
             } else {
-                setFixtures($("<script>", { id: "system-feedback-tpl", type: "text/template" }).text(feedbackTemplate));
+                appendSetFixtures($("<script>", { id: templateId, type: "text/template" }).text(template));
             }
         };
 
+        installViewTemplates = function(append) {
+            installTemplate('system-feedback', !append);
+            appendSetFixtures('<div id="page-notification"></div>');
+        };
+
+        createNotificationSpy = function() {
+            var notificationSpy = spyOnConstructor(NotificationView, "Mini", ["show", "hide"]);
+            notificationSpy.show.andReturn(notificationSpy);
+            return notificationSpy;
+        };
+
+        verifyNotificationShowing = function(notificationSpy, text) {
+            expect(notificationSpy.constructor).toHaveBeenCalled();
+            expect(notificationSpy.show).toHaveBeenCalled();
+            expect(notificationSpy.hide).not.toHaveBeenCalled();
+            var options = notificationSpy.constructor.mostRecentCall.args[0];
+            expect(options.title).toMatch(text);
+        };
+
+        verifyNotificationHidden = function(notificationSpy) {
+            expect(notificationSpy.hide).toHaveBeenCalled();
+        };
+
         return {
-            'installViewTemplates': installViewTemplates
+            'installTemplate': installTemplate,
+            'installViewTemplates': installViewTemplates,
+            'createNotificationSpy': createNotificationSpy,
+            'verifyNotificationShowing': verifyNotificationShowing,
+            'verifyNotificationHidden': verifyNotificationHidden
         };
     });

cms/static/js/utils/module.js

@@ -7,11 +7,11 @@
  * getUpdateUrl: a utility method that returns the xblock update URL, appending
  *               the location if passed in.
  */
-define([], function () {
+define(["underscore"], function (_) {
     var urlRoot = '/xblock';
 
     var getUpdateUrl = function (locator) {
-        if (locator === undefined) {
+        if (_.isUndefined(locator)) {
             return urlRoot;
         }
         else {

cms/static/js/utils/templates.js

+define(["jquery", "underscore"], function($, _) {
+
+    /**
+     * Loads the named template from the page, or logs an error if it fails.
+     * @param name The name of the template.
+     * @returns The loaded template.
+     */
+    var loadTemplate = function(name) {
+        var templateSelector = "#" + name + "-tpl",
+            templateText = $(templateSelector).text();
+        if (!templateText) {
+            console.error("Failed to load " + name + " template");
+        }
+        return _.template(templateText);
+    };
+
+    return {
+        loadTemplate: loadTemplate
+    };
+});

cms/static/js/views/baseview.js

-define(["jquery", "underscore", "backbone", "js/utils/handle_iframe_binding"],
-    function ($, _, Backbone, IframeUtils) {
+define(["jquery", "underscore", "backbone", "gettext", "js/utils/handle_iframe_binding", "js/utils/templates",
+    "js/views/feedback_notification", "js/views/feedback_prompt"],
+    function ($, _, Backbone, gettext, IframeUtils, TemplateUtils, NotificationView, PromptView) {
         /*
          This view is extended from backbone to provide useful functionality for all Studio views.
          This functionality includes:
@@ -61,15 +62,59 @@ define(["jquery", "underscore", "backbone", "js/utils/handle_iframe_binding"],
             },
 
             /**
+             * Confirms with the user whether to run an operation or not, and then runs it if desired.
+             */
+            confirmThenRunOperation: function(title, message, actionLabel, operation) {
+                var self = this;
+                return new PromptView.Warning({
+                    title: title,
+                    message: message,
+                    actions: {
+                        primary: {
+                            text: actionLabel,
+                            click: function(prompt) {
+                                prompt.hide();
+                                operation();
+                            }
+                        },
+                        secondary: {
+                            text: gettext('Cancel'),
+                            click: function(prompt) {
+                                return prompt.hide();
+                            }
+                        }
+                    }
+                }).show();
+            },
+
+            /**
+             * Shows a progress message for the duration of an asynchronous operation.
+             * Note: this does not remove the notification upon failure because an error
+             * will be shown that shouldn't be removed.
+             * @param message The message to show.
+             * @param operation A function that returns a promise representing the operation.
+             */
+            runOperationShowingMessage: function(message, operation) {
+                var notificationView;
+                notificationView = new NotificationView.Mini({
+                    title: gettext(message)
+                });
+                notificationView.show();
+                return operation().done(function() {
+                    notificationView.hide();
+                });
+            },
+
+            /**
              * Disables a given element when a given operation is running.
              * @param {jQuery} element: the element to be disabled.
              * @param operation: the operation during whose duration the
              * element should be disabled. The operation should return
-             * a jquery promise.
+             * a JQuery promise.
              */
             disableElementWhileRunning: function(element, operation) {
                 element.addClass("is-disabled");
-                operation().always(function() {
+                return operation().always(function() {
                     element.removeClass("is-disabled");
                 });
             },
@@ -80,12 +125,38 @@ define(["jquery", "underscore", "backbone", "js/utils/handle_iframe_binding"],
              * @returns The loaded template.
              */
             loadTemplate: function(name) {
-                var templateSelector = "#" + name + "-tpl",
-                    templateText = $(templateSelector).text();
-                if (!templateText) {
-                    console.error("Failed to load " + name + " template");
-                }
-                return _.template(templateText);
+                return TemplateUtils.loadTemplate(name);
+            },
+
+            /**
+             * Returns the relative position that the element is scrolled from the top of the view port.
+             * @param element The element in question.
+             */
+            getScrollOffset: function(element) {
+                var elementTop = element.offset().top;
+                return elementTop - $(window).scrollTop();
+            },
+
+            /**
+             * Scrolls the window so that the element is scrolled down to the specified relative position
+             * from the top of the view port.
+             * @param element The element in question.
+             * @param offset The amount by which the element should be scrolled from the top of the view port.
+             */
+            setScrollOffset: function(element, offset) {
+                var elementTop = element.offset().top,
+                    newScrollTop = elementTop - offset;
+                this.setScrollTop(newScrollTop);
+            },
+
+            /**
+             * Performs an animated scroll so that the window has the specified scroll top.
+             * @param scrollTop The desired scroll top for the window.
+             */
+            setScrollTop: function(scrollTop) {
+                $('html, body').animate({
+                    scrollTop: scrollTop
+                }, 500);
             }
         });
 

cms/static/js/views/components/add_xblock.js

+/**
+ * This is a simple component that renders add buttons for all available XBlock template types.
+ */
+define(["jquery", "underscore", "gettext", "js/views/baseview", "js/views/components/add_xblock_button",
+    "js/views/components/add_xblock_menu"],
+    function ($, _, gettext, BaseView, AddXBlockButton, AddXBlockMenu) {
+        var AddXBlockComponent = BaseView.extend({
+            events: {
+                'click .new-component .new-component-type a.multiple-templates': 'showComponentTemplates',
+                'click .new-component .new-component-type a.single-template': 'createNewComponent',
+                'click .new-component .cancel-button': 'closeNewComponent',
+                'click .new-component-templates .new-component-template a': 'createNewComponent',
+                'click .new-component-templates .cancel-button': 'closeNewComponent'
+            },
+
+            initialize: function(options) {
+                BaseView.prototype.initialize.call(this, options);
+                this.template = this.loadTemplate('add-xblock-component');
+            },
+
+            render: function () {
+                if (!this.$el.html()) {
+                    var that = this;
+                    this.$el.html(this.template({}));
+                    this.collection.each(
+                        function (componentModel) {
+                            var view, menu;
+
+                            view = new AddXBlockButton({model: componentModel});
+                            that.$el.find('.new-component-type').append(view.render().el);
+
+                            menu = new AddXBlockMenu({model: componentModel});
+                            that.$el.append(menu.render().el);
+                        }
+                    );
+                }
+            },
+
+            showComponentTemplates: function(event) {
+                var type;
+                event.preventDefault();
+                event.stopPropagation();
+                type = $(event.currentTarget).data('type');
+                this.$('.new-component').slideUp(250);
+                this.$('.new-component-' + type).slideDown(250);
+            },
+
+            closeNewComponent: function(event) {
+                event.preventDefault();
+                event.stopPropagation();
+                this.$('.new-component').slideDown(250);
+                this.$('.new-component-templates').slideUp(250);
+            },
+
+            createNewComponent: function(event) {
+                var self = this,
+                    element = $(event.currentTarget),
+                    saveData = element.data(),
+                    oldOffset = this.getScrollOffset(this.$el);
+                event.preventDefault();
+                this.closeNewComponent(event);
+                this.runOperationShowingMessage(
+                    gettext('Adding…'),
+                    _.bind(this.options.createComponent, this, saveData, element)
+                ).always(function() {
+                    // Restore the scroll position of the buttons so that the new
+                    // component appears above them.
+                    self.setScrollOffset(self.$el, oldOffset);
+                });
+            }
+        });
+
+        return AddXBlockComponent;
+    }); // end define();

cms/static/js/views/components/add_xblock_button.js

+define(["js/views/baseview"],
+    function (BaseView) {
+
+        return BaseView.extend({
+            tagName: "li",
+            initialize: function () {
+                BaseView.prototype.initialize.call(this);
+                this.template = this.loadTemplate("add-xblock-component-button");
+                this.$el.html(this.template({type: this.model.type, templates: this.model.templates}));
+            }
+        });
+
+    }); // end define();

cms/static/js/views/components/add_xblock_menu.js

+define(["jquery", "js/views/baseview"],
+    function ($, BaseView) {
+
+        return BaseView.extend({
+            className: function () {
+                return "new-component-templates new-component-" + this.model.type;
+            },
+            initialize: function () {
+                BaseView.prototype.initialize.call(this);
+                var template_name = this.model.type === "problem" ? "add-xblock-component-menu-problem" :
+                    "add-xblock-component-menu";
+                this.template = this.loadTemplate(template_name);
+                this.$el.html(this.template({type: this.model.type, templates: this.model.templates}));
+                // Make the tabs on problems into "real tabs"
+                this.$('.tab-group').tabs();
+            }
+        });
+
+    }); // end define();
\ No newline at end of file

cms/static/js/views/container.js

 define(["jquery", "underscore", "js/views/xblock", "js/utils/module", "gettext", "js/views/feedback_notification"],
     function ($, _, XBlockView, ModuleUtils, gettext, NotificationView) {
+        var reorderableClass = '.reorderable-container',
+            studioXBlockWrapperClass = '.studio-xblock-wrapper';
+
         var ContainerView = XBlockView.extend({
 
             xblockReady: function () {
                 XBlockView.prototype.xblockReady.call(this);
-                var verticalContainer = this.$('.vertical-container'),
+                var reorderableContainer = this.$(reorderableClass),
                     alreadySortable = this.$('.ui-sortable'),
                     newParent,
                     oldParent,
@@ -12,13 +15,13 @@ define(["jquery", "underscore", "js/views/xblock", "js/utils/module", "gettext",
 
                 alreadySortable.sortable("destroy");
 
-                verticalContainer.sortable({
+                reorderableContainer.sortable({
                     handle: '.drag-handle',
 
                     stop: function (event, ui) {
                         var saving, hideSaving, removeFromParent;
 
-                        if (oldParent === undefined) {
+                        if (_.isUndefined(oldParent)) {
                             // If no actual change occurred,
                             // oldParent will never have been set.
                             return;
@@ -55,7 +58,7 @@ define(["jquery", "underscore", "js/views/xblock", "js/utils/module", "gettext",
                         // be null if the change is related to the list the element
                         // was originally in (the case of a move within the same container
                         // or the deletion from a container when moving to a new container).
-                        var parent = $(event.target).closest('.wrapper-xblock');
+                        var parent = $(event.target).closest(studioXBlockWrapperClass);
                         if (ui.sender) {
                             // Move to a new container (the addition part).
                             newParent = parent;
@@ -69,8 +72,8 @@ define(["jquery", "underscore", "js/views/xblock", "js/utils/module", "gettext",
                     placeholder: 'component-placeholder',
                     forcePlaceholderSize: true,
                     axis: 'y',
-                    items: '> .vertical-element',
-                    connectWith: ".vertical-container",
+                    items: '> .is-draggable',
+                    connectWith: reorderableClass,
                     tolerance: "pointer"
 
                 });
@@ -79,10 +82,10 @@ define(["jquery", "underscore", "js/views/xblock", "js/utils/module", "gettext",
             reorder: function (targetParent, successCallback) {
                 var children, childLocators;
 
-                // Find descendants with class "wrapper-xblock" whose parent == targetParent.
+                // Find descendants with class "studio-xblock-wrapper" whose parent === targetParent.
                 // This is necessary to filter our grandchildren, great-grandchildren, etc.
-                children = targetParent.find('.wrapper-xblock').filter(function () {
-                    var parent = $(this).parent().closest('.wrapper-xblock');
+                children = targetParent.find(studioXBlockWrapperClass).filter(function () {
+                    var parent = $(this).parent().closest(studioXBlockWrapperClass);
                     return parent.data('locator') === targetParent.data('locator');
                 });
 
@@ -107,7 +110,10 @@ define(["jquery", "underscore", "js/views/xblock", "js/utils/module", "gettext",
                         }
                     }
                 });
+            },
 
+            refresh: function() {
+                this.$(reorderableClass).sortable('refresh');
             }
         });
 

cms/static/js/views/xblock.js

@@ -74,13 +74,24 @@ define(["jquery", "underscore", "js/views/baseview", "xblock/runtime.v1"],
                 if (!element) {
                     element = this.$el;
                 }
-                // First render the HTML as the scripts might depend upon it
-                element.html(html);
-                // Now asynchronously add the resources to the page
+
+                // Render the HTML first as the scripts might depend upon it, and then
+                // asynchronously add the resources to the page.
+                this.updateHtml(element, html);
                 return this.addXBlockFragmentResources(resources);
             },
 
             /**
+             * Updates an element to have the specified HTML. The default method sets the HTML
+             * as child content, but this can be overridden.
+             * @param element The element to be updated
+             * @param html The desired HTML.
+             */
+            updateHtml: function(element, html) {
+                element.html(html);
+            },
+
+            /**
              * Dynamically loads all of an XBlock's dependent resources. This is an asynchronous
              * process so a promise is returned.
              * @param resources The resources to be rendered

cms/static/sass/elements/_system-feedback.scss

@@ -190,7 +190,7 @@
   @include transition(all $tmg-f3 ease-in-out  0s);
   position: fixed;
   top: 0;
-  background: $black-t0;
+  background: $black-t1;
   width: 100%;
   height: 100%;
   text-align: center;
@@ -676,11 +676,6 @@
   // prompt showing
   &.prompt-is-shown {
 
-    .wrapper-view {
-      -webkit-filter: blur(($baseline/10)) grayscale(25%);
-      filter: blur(($baseline/10)) grayscale(25%);
-    }
-
     .wrapper-prompt.is-shown {
       visibility: visible;
       pointer-events: auto;
@@ -694,11 +689,6 @@
   // prompt hiding
   &.prompt-is-hiding {
 
-    .wrapper-view {
-      -webkit-filter: blur(($baseline/10)) grayscale(25%);
-      filter: blur(($baseline/10)) grayscale(25%);
-    }
-
     .wrapper-prompt {
 
       .prompt {

cms/static/sass/elements/_xblocks.scss

@@ -48,13 +48,18 @@
 // UI: xblocks - calls-to-action
 .wrapper-xblock .header-actions {
   @extend %actions-header;
+
+  .action-button [class^="icon-"] {
+    font-style: normal;
+  }
 }
 
 // UI: xblock is collapsible
-.wrapper-xblock.is-collapsible, .wrapper-xblock.xblock-type-container {
+.wrapper-xblock.is-collapsible,
+.wrapper-xblock.xblock-type-container {
 
   [class^="icon-"] {
-  font-style: normal;
+    font-style: normal;
   }
 
   .expand-collapse {

cms/static/sass/views/_container.scss

@@ -116,40 +116,6 @@ body.view-container .content-primary {
     border: 2px dashed $gray-l2;
   }
 
-  .vert-mod {
-
-    // min-height to allow drop when empty
-    .vertical-container {
-      min-height: ($baseline*2.5);
-    }
-
-    .vert {
-      position: relative;
-
-      .drag-handle {
-        display: none; // only show when vert is draggable
-        position: absolute;
-        top: 0;
-        right: ($baseline/2); // equal to margin on component
-        width: ($baseline*1.5);
-        height: ($baseline*2.5);
-        margin: 0;
-        background: transparent url("../img/drag-handles.png") no-repeat scroll center center;
-      }
-    }
-
-    .is-draggable {
-
-      .xblock-header {
-        padding-right: ($baseline*1.5); // make room for drag handle
-      }
-
-      .drag-handle {
-        display: block;
-      }
-    }
-  }
-
   .wrapper-xblock {
     @extend %wrap-xblock;
 
@@ -165,18 +131,17 @@ body.view-container .content-primary {
     // CASE: nesting level xblock rendering
     &.level-nesting {
       @include transition(all $tmg-f2 linear 0s);
-      border: none;
+      border: 1px solid $gray-l3;
       padding-bottom: $baseline;
-      box-shadow: none;
 
-      &:hover {
-        background-color: $gray-l6;
-        box-shadow: 0 0 1px $shadow-d2 inset;
+      // min-height to allow drop when empty
+      .reorderable-container {
+        min-height: $baseline;
       }
 
       .xblock-header {
         @include ui-flexbox();
-        margin-bottom: ($baseline/2);
+        margin-bottom: 0;
         border-bottom: none;
         background: none;
       }
@@ -230,6 +195,24 @@ body.view-container .content-primary {
       }
     }
   }
+
+  // add a new component menu override - most styles currently live in _unit.scss
+  .new-component-item {
+    margin: $baseline ($baseline/2);
+    border: 1px solid $gray-l3;
+    border-radius: ($baseline/4);
+    box-shadow: 0 1px 3px $shadow inset;
+    background-color: $gray-l5;
+    padding: ($baseline/2);
+
+    h5 {
+      margin-bottom: ($baseline*.75);
+    }
+
+    .new-component-type a {
+      margin-bottom: ($baseline/2);
+    }
+  }
 }
 
 // ====================

cms/templates/component.html

@@ -26,7 +26,5 @@
       </li>
     </ul>
 </div>
-% if not xblock_context['read_only']:
-    <span data-tooltip="${_("Drag to reorder")}" class="drag-handle"></span>
-% endif
+<span data-tooltip="${_("Drag to reorder")}" class="drag-handle action"></span>
 ${preview}

cms/templates/container.html

@@ -31,15 +31,18 @@ main_xblock_info = {
 %>
 <script type='text/javascript'>
     require(["domReady!", "jquery", "js/models/xblock_info", "js/views/pages/container",
-            "xmodule", "coffee/src/main", "xblock/cms.runtime.v1"],
-            function(doc, $, XBlockInfo, ContainerPage) {
+        "js/collections/component_template", "xmodule", "coffee/src/main", "xblock/cms.runtime.v1"],
+            function(doc, $, XBlockInfo, ContainerPage, ComponentTemplates) {
                 var view, mainXBlockInfo;
 
+                var templates = new ComponentTemplates(${component_templates | n}, {parse: true});
+
                 mainXBlockInfo = new XBlockInfo(${json.dumps(main_xblock_info) | n});
 
                 view = new ContainerPage({
                     el: $('#content'),
-                    model: mainXBlockInfo
+                    model: mainXBlockInfo,
+                    templates: templates
                 });
                 view.render();
             });
@@ -80,7 +83,7 @@ main_xblock_info = {
         <section class="content-area">
 
             <article class="content-primary window">
-                <section class="wrapper-xblock level-page is-hidden" data-locator="${xblock_locator}">
+                <section class="wrapper-xblock level-page is-hidden studio-xblock-wrapper" data-locator="${xblock_locator}">
                 </section>
                 <div class="no-container-content is-hidden">
                     <p>${_("This page has no content yet.")}</p>

cms/templates/container_xblock_component.html

@@ -18,10 +18,10 @@ from contentstore.views.helpers import xblock_studio_url
                         <i class="icon-arrow-right"></i>
                     </a>
                 </li>
+                <li class="action-item action-drag">
+                    <span data-tooltip="${_('Drag to reorder')}" class="drag-handle action"></span>
+                </li>
             </ul>
         </div>
     </header>
-    % if not xblock_context['read_only']:
-        <span data-tooltip="${_("Drag to reorder")}" class="drag-handle"></span>
-    % endif
 </section>

cms/templates/edit-tabs.html

@@ -125,7 +125,7 @@
                       </div>
 
                       % if tab.is_movable:
-                        <div class="drag-handle" data-tooltip="${_('Drag to reorder')}">
+                        <div class="drag-handle action" data-tooltip="${_('Drag to reorder')}">
                           <span class="sr">${_("Drag to reorder")}</span>
                         </div>
                       % else:

cms/templates/js/add-xblock-component-button.underscore

+<% if (type === 'advanced' || templates.length > 1) { %>
+<a href="#" class="multiple-templates" data-type="<%= type %>">
+<% } else { %>
+<a href="#" class="single-template" data-type="<%= type %>" data-category="<%= templates[0].category %>">
+<% } %>
+  <span class="large-template-icon large-<%= type %>-icon"></span>
+  <span class="name"><%= type %></span>
+</a>

cms/templates/js/add-xblock-component-menu-problem.underscore

+<div class="tab-group tabs">
+    <ul class="problem-type-tabs nav-tabs">
+        <li class="current">
+            <a class="link-tab" href="#tab1"><%= gettext("Common Problem Types") %></a>
+        </li>
+        <li>
+            <a class="link-tab" href="#tab2"><%= gettext("Advanced") %></a>
+        </li>
+    </ul>
+    <div class="tab current" id="tab1">
+        <ul class="new-component-template">
+            <% for (var i = 0; i < templates.length; i++) { %>
+                <% if (templates[i].is_common) { %>
+                    <% if (!templates[i].boilerplate_name) { %>
+                    <li class="editor-md empty">
+                        <a href="#" data-category="<%= templates[i].category %>">
+                            <span class="name"><%= templates[i].display_name %></span>
+                        </a>
+                    </li>
+                    <% } else { %>
+                    <li class="editor-md">
+                        <a href="#" data-category="<%= templates[i].category %>"
+                           data-boilerplate="<%= templates[i].boilerplate_name %>">
+                            <span class="name"><%= templates[i].display_name %></span>
+                        </a>
+                    </li>
+                    <% } %>
+                <% } %>
+            <% } %>
+        </ul>
+    </div>
+    <div class="tab" id="tab2">
+        <ul class="new-component-template">
+            <% for (var i = 0; i < templates.length; i++) { %>
+                <% if (!templates[i].is_common) { %>
+                <li class="editor-manual">
+                    <a href="#" data-category="<%= templates[i].category %>"
+                       data-boilerplate="<%= templates[i].boilerplate_name %>">
+                        <span class="name"><%= templates[i].display_name %></span>
+                    </a>
+                </li>
+                <% } %>
+            <% } %>
+        </ul>
+    </div>
+</div>
+<a href="#" class="cancel-button"><%= gettext("Cancel") %></a>

cms/templates/js/add-xblock-component-menu.underscore

+<% if (type === 'advanced' || templates.length > 1) { %>
+    <div class="tab current" id="tab1">
+        <ul class="new-component-template">
+            <% for (var i = 0; i < templates.length; i++) { %>
+                <% if (!templates[i].boilerplate_name) { %>
+                <li class="editor-md empty">
+                    <a href="#" data-category="<%= templates[i].category %>">
+                        <span class="name"><%= templates[i].display_name %></span>
+                    </a>
+                </li>
+                <% } else { %>
+                <li class="editor-md">
+                    <a href="#" data-category="<%= templates[i].category %>"
+                       data-boilerplate="<%= templates[i].boilerplate_name %>">
+                        <span class="name"><%= templates[i].display_name %></span>
+                    </a>
+                </li>
+                <% } %>
+            <% } %>
+        </ul>
+    </div>
+    <a href="#" class="cancel-button"><%= gettext("Cancel") %></a>
+<% } %>

cms/templates/js/add-xblock-component.underscore

+<div class="new-component">
+    <h5><%= gettext("Add New Component") %></h5>
+    <ul class="new-component-type">
+    </ul>
+</div>

cms/templates/js/mock/mock-container-page.underscore

@@ -4,7 +4,6 @@
         <header class="mast has-actions has-navigation">
             <h1 class="page-header">
                 <small class="navigation navigation-parents">
-
                     <a href="/unit/TestCourse/branch/draft/block/vertical8eb" class="navigation-link navigation-parent">Unit 1</a>
                     <a href="#" class="navigation-link navigation-current">Nested Vertical Test</a>
                 </small>
@@ -23,7 +22,7 @@
             <section class="content-area">
 
                 <article class="content-primary window">
-                    <section class="wrapper-xblock level-page" data-locator="TestCourse/branch/draft/block/vertical131">
+                    <section class="wrapper-xblock level-page studio-xblock-wrapper" data-locator="TestCourse/branch/draft/block/vertical131">
                     </section>
                     <div class="no-container-content is-hidden">
                         <p>This page has no content yet.</p>
@@ -37,6 +36,4 @@
             </section>
         </div>
     </div>
-
-    <div id="page-notification"></div>
-</div>
+</div>
\ No newline at end of file

cms/templates/js/mock/mock-empty-container-xblock.underscore

@@ -14,9 +14,7 @@
 </header>
 <article class="xblock-render">
     <div class="xblock xblock-student_view xmodule_display xmodule_VerticalModule xblock-initialized" data-runtime-class="PreviewRuntime" data-init="XBlockToXModuleShim" data-runtime-version="1" data-usage-id="i4x:;_;_AndyA;_ABT101;_vertical;_131a499ddaa3474194c1aa2eced34455" data-type="None" data-block-type="vertical">
-        <div class="vert-mod">
-            <div class="vert vert-0" data-id="i4x://AndyA/ABT101/vertical/2758bbc495dd40d59050da15b40bd9a5">
-            </div>
-        </div>
+        <ol class="reorderable-container">
+        </ol>
     </div>
 </article>

cms/templates/js/mock/mock-unit-page-xblock.underscore

+<div class="wrapper wrapper-component-action-header">
+    <div class="component-header">Mock Component</div>
+    <ul class="component-actions">
+        <li class="action-item action-edit">
+            <a href="#" class="edit-button action-button">
+                <i class="icon-pencil"></i>
+                <span class="action-button-text">Edit</span>
+            </a>
+        </li>
+        <li class="action-item action-duplicate">
+            <a href="#" data-tooltip="Duplicate" class="duplicate-button action-button">
+                <i class="icon-copy"></i>
+                <span class="sr">Duplicate this component</span>
+            </a>
+        </li>
+        <li class="action-item action-delete">
+            <a href="#" data-tooltip="Delete" class="delete-button action-button">
+                <i class="icon-trash"></i>
+                <span class="sr">Delete this component</span>
+            </a>
+        </li>
+    </ul>
+</div>
+<div class="xblock xblock-student_view" data-runtime-version="1" data-usage-id="i4x:;_;_edX;_mock"
+     data-init="MockXBlock" data-runtime-class="StudioRuntime" data-block-type="mock" tabindex="0">
+    <h2>Mock Component</h2>
+</div>

cms/templates/js/mock/mock-unit-page.underscore

+<div id="content">
+
+    <div class="main-wrapper edit-state-draft" data-locator="unit_locator">
+        <div class="inner-wrapper">
+            <div class="alert editing-draft-alert">
+                <p class="alert-message"><strong>You are editing a draft.</strong></p>
+                <a href="#" target="_blank" class="alert-action secondary">View the Live Version</a>
+            </div>
+
+            <div class="main-column">
+                <article class="unit-body window">
+                    <p class="unit-name-input"><label for="unit-display-name-input">Display Name:</label><input type="text" value="Mock Unit" id="unit-display-name-input" class="unit-display-name-input"></p>
+                    <ol class="components ui-sortable">
+                        <li class="component" data-locator="loc_1"></li>
+                        <li class="component" data-locator="loc_2"></li>
+                        <li class="add-xblock-component new-component-item adding"></li>
+                    </ol>
+                </article>
+            </div>
+
+            <div class="sidebar">
+                <div class="unit-settings window">
+                    <h4 class="header">Unit Settings</h4>
+                    <div class="window-contents">
+                        <div class="row visibility">
+                            <label for="visibility-select" class="inline-label">Visibility:</label>
+                            <select name="visibility-select" id="visibility-select" class="visibility-select">
+                                <option value="public">Public</option>
+                                <option value="private">Private</option>
+                            </select>
+                        </div>
+                        <div class="row published-alert">
+                            <p class="edit-draft-message">This unit has been published. To make changes, you must <a href="#" class="create-draft">edit a draft</a>.</p>
+                            <p class="publish-draft-message">This is a draft of the published unit. To update the live version, you must <a href="#" class="publish-draft">replace it with this draft</a>.</p>
+                        </div>
+                        <div class="row status">
+                            <p>
+                                This unit is scheduled to be released to <strong>students</strong> on <strong>Jan 01, 2030 at 00:00 UTC</strong> with the subsection <a href="/subsection/AndyA.EBT1.EBT1/branch/draft/block/sequential544">Lesson 1</a>
+                            </p>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+
+</div>

cms/templates/js/mock/mock-updated-xblock.underscore

-<header class="xblock-header">
-    <div class="header-details">
-        <span>Mock XBlock</span>
-    </div>
-    <div class="header-actions">
-        <ul class="actions-list">
-            <li class="sr action-item">No Actions</li>
-        </ul>
-    </div>
-</header>
-<article class="xblock-render">
-    <div class="xblock xblock-student_view xmodule_display xmodule_VerticalModule"
-         data-runtime-class="PreviewRuntime" data-init="XBlockToXModuleShim" data-runtime-version="1"
-         data-type="None">
-        <div class="mock-updated-content">Mock Update</div>
-    </div>
-</article>
+<li class="studio-xblock-wrapper is-draggable">
+    <header class="xblock-header">
+        <div class="header-details">
+            <span>Mock XBlock</span>
+        </div>
+        <div class="header-actions">
+            <ul class="actions-list">
+                <li class="sr action-item">No Actions</li>
+            </ul>
+        </div>
+    </header>
+    <article class="xblock-render">
+        <div class="xblock xblock-student_view xmodule_display xmodule_VerticalModule"
+             data-runtime-class="PreviewRuntime" data-init="XBlockToXModuleShim" data-runtime-version="1"
+             data-type="None">
+            <div class="mock-updated-content">Mock Update</div>
+        </div>
+    </article>
+</li>

cms/templates/js/mock/mock-xblock.underscore

-<header class="xblock-header">
-    <div class="header-details">
-        <span>Mock XBlock</span>
-    </div>
-    <div class="header-actions">
-        <ul class="actions-list">
-            <li class="sr action-item">No Actions</li>
-        </ul>
-    </div>
-</header>
-<article class="xblock-render">
-    <div class="xblock xblock-student_view xmodule_display xmodule_VerticalModule"
-         data-runtime-class="PreviewRuntime" data-init="XBlockToXModuleShim" data-runtime-version="1"
-         data-type="None">
-        <p>Mock XBlock</p>
-    </div>
-</article>
+<li class="studio-xblock-wrapper is-draggable">
+    <header class="xblock-header">
+        <div class="header-details">
+            <span>Mock XBlock</span>
+        </div>
+        <div class="header-actions">
+            <ul class="actions-list">
+                <li class="action-item action-drag">
+                    <span data-tooltip="Drag to reorder" class="drag-handle action"></span>
+                </li>
+            </ul>
+        </div>
+    </header>
+    <article class="xblock-render">
+        <div class="xblock xblock-student_view xmodule_display xmodule_VerticalModule"
+             data-runtime-class="PreviewRuntime" data-init="XBlockToXModuleShim" data-runtime-version="1"
+             data-type="None">
+            <p>Mock XBlock</p>
+        </div>
+    </article>
+</li>

cms/templates/overview.html

@@ -84,7 +84,7 @@ require(["domReady!", "jquery", "js/models/location", "js/models/section", "js/v
       </div>
       <div class="item-actions">
         <a href="#" data-tooltip="${_('Delete this section')}" class="delete-button delete-section-button"><span class="delete-icon"></span></a>
-        <span data-tooltip="${_('Drag to re-order')}" class="drag-handle"></span>
+        <span data-tooltip="${_('Drag to re-order')}" class="drag-handle action"></span>
       </div>
     </header>
   </section>
@@ -198,7 +198,7 @@ require(["domReady!", "jquery", "js/models/location", "js/models/section", "js/v
                         <a href="#" data-tooltip="${_('Delete this section')}" class="action delete-section-button"><i class="icon-trash"></i> <span class="sr">${_('Delete section')}</span></a>
                       </li>
                       <li class="actions-item drag">
-                        <span data-tooltip="${_('Drag to reorder')}" class="drag-handle section-drag-handle action"><span class="sr"> ${_("Drag to reorder section")}</span></span>
+                        <span data-tooltip="${_('Drag to reorder')}" class="drag-handle section-drag-handle"><span class="sr"> ${_("Drag to reorder section")}</span></span>
                       </li>
                     </ul>
                   </div>
@@ -235,7 +235,7 @@ require(["domReady!", "jquery", "js/models/location", "js/models/section", "js/v
                               <a href="#" data-tooltip="${_('Delete this subsection')}" class="action delete-subsection-button"><i class="icon-trash"></i> <span class="sr">${_("Delete subsection")}</span></a>
                             </li>
                             <li class="actions-item drag">
-                              <span data-tooltip="${_('Drag to reorder')}" class="drag-handle subsection-drag-handle action"></span>
+                              <span data-tooltip="${_('Drag to reorder')}" class="drag-handle subsection-drag-handle"></span>
                             </li>
                           </ul>
                         </div>

cms/templates/studio_container_wrapper.html

+<%!
+from django.utils.translation import ugettext as _
+from contentstore.views.helpers import xblock_studio_url
+%>
+<%namespace name='static' file='static_content.html'/>
+
+% if is_reorderable:
+<li class="studio-xblock-wrapper is-draggable" data-locator="${locator}">
+% else:
+<div class="studio-xblock-wrapper">
+% endif
+<section class="wrapper-xblock xblock-type-container level-element" data-locator="${locator}">
+    <header class="xblock-header">
+        <div class="header-details">
+            ${xblock.display_name_with_default}
+        </div>
+        <div class="header-actions">
+            <ul class="actions-list">
+                <li class="action-item action-view">
+                    <a href="${xblock_studio_url(xblock)}" class="action-button">
+                        ## Translators: this is a verb describing the action of viewing more details
+                        <span class="action-button-text">${_('View')}</span>
+                        <i class="icon-arrow-right"></i>
+                    </a>
+                </li>
+                % if not xblock_context['read_only'] and is_reorderable:
+                <li class="action-item action-drag">
+                    <span data-tooltip="${_('Drag to reorder')}" class="drag-handle action"></span>
+                </li>
+                % endif
+            </ul>
+        </div>
+    </header>
+</section>
+% if is_reorderable:
+</li>
+% else:
+</div>
+% endif

cms/templates/studio_vertical_wrapper.html

-<%! from django.utils.translation import ugettext as _ %>
-% if xblock.location != xblock_context['root_xblock'].location:
-<section class="wrapper-xblock level-nesting is-collapsible" data-locator="${locator}">
-% endif
-    <header class="xblock-header">
-        <div class="header-details">
-            <a href="#" data-tooltip="${_('Expand or Collapse')}" class="action expand-collapse collapse">
-                <i class="icon-caret-down ui-toggle-expansion"></i>
-                <span class="sr">${_('Expand or Collapse')}</span>
-            </a>
-            <span>${xblock.display_name_with_default | h}</span>
-        </div>
-        <div class="header-actions">
-            <ul class="actions-list">
-                <li class="sr action-item">${_('No Actions')}</li>
-            </ul>
-        </div>
-    </header>
-    <article class="xblock-render">
-${content}
-    </article>
-% if xblock.location != xblock_context['root_xblock'].location:
-</section>
-% endif

cms/templates/studio_xblock_wrapper.html

 <%! from django.utils.translation import ugettext as _ %>
-<%! from django.conf import settings %>
 
-% if xblock.location != xblock_context['root_xblock'].location:
-  <% section_class = "level-nesting" if xblock.has_children else "level-element" %>
-<section class="wrapper-xblock ${section_class}" data-locator="${locator}" data-display-name="${xblock.display_name_with_default | h}" data-category="${xblock.category | h}">
+% if not is_root:
+    % if is_reorderable:
+    <li class="studio-xblock-wrapper is-draggable" data-locator="${locator}">
+    % else:
+    <div class="studio-xblock-wrapper" data-locator="${locator}">
+    % endif
+
+    <%
+    section_class = "level-nesting" if xblock.has_children else "level-element"
+    collapsible_class = "is-collapsible" if xblock.has_children else ""
+    %>
+    <section class="wrapper-xblock ${section_class} ${collapsible_class}">
 % endif
 
     <header class="xblock-header">
         <div class="header-details">
-            ${xblock.display_name_with_default | h}
+            % if xblock.has_children:
+            <a href="#" data-tooltip="${_('Expand or Collapse')}" class="action expand-collapse collapse">
+                <i class="icon-caret-down ui-toggle-expansion"></i>
+                <span class="sr">${_('Expand or Collapse')}</span>
+            </a>
+            % endif
+            <span>${xblock.display_name_with_default | h}</span>
         </div>
         <div class="header-actions">
             <ul class="actions-list">
                 % if not xblock_context['read_only']:
+                    % if not xblock.has_children:
                     <li class="action-item action-edit">
                         <a href="#" class="edit-button action-button">
                             <i class="icon-pencil"></i>
                             <span class="action-button-text">${_("Edit")}</span>
                         </a>
                     </li>
-                % endif
-                %if settings.FEATURES.get('ENABLE_DUPLICATE_XBLOCK_LEAF_COMPONENT'):
                     <li class="action-item action-duplicate">
                         <a href="#" data-tooltip="${_("Duplicate")}" class="duplicate-button action-button">
                             <i class="icon-copy"></i>
                             <span class="sr">${_("Duplicate")}</span>
                         </a>
                     </li>
-                % endif
-                %if settings.FEATURES.get('ENABLE_DELETE_XBLOCK_LEAF_COMPONENT'):
                     <li class="action-item action-delete">
                         <a href="#" data-tooltip="${_("Delete")}" class="delete-button action-button">
                             <i class="icon-trash"></i>
                             <span class="sr">${_("Delete")}</span>
                         </a>
                     </li>
+                    % endif
+                    % if not is_root and is_reorderable:
+                    <li class="action-item action-drag">
+                        <span data-tooltip="${_('Drag to reorder')}" class="drag-handle action"></span>
+                    </li>
+                    % endif
                 % endif
             </ul>
         </div>
@@ -43,6 +60,11 @@
 ${content}
     </article>
 
-% if xblock.location != xblock_context['root_xblock'].location:
-</section>
+% if not is_root:
+    </section>
+    % if is_reorderable:
+        </li>
+    % else:
+        </div>
+    % endif
 % endif

cms/templates/unit.html

@@ -21,13 +21,12 @@ from xmodule.modulestore.django import loc_mapper
 
 <%block name="jsextra">
   <script type='text/javascript'>
-require(["domReady!", "jquery", "js/models/module_info", "coffee/src/views/unit", "jquery.ui",
-        "xmodule", "coffee/src/main", "xblock/cms.runtime.v1"],
-    function(doc, $, ModuleModel, UnitEditView, ui) {
+require(["domReady!", "jquery", "js/models/module_info", "coffee/src/views/unit", "js/collections/component_template",
+    "jquery.ui", "xmodule", "coffee/src/main", "xblock/cms.runtime.v1"],
+    function(doc, $, ModuleModel, UnitEditView, ComponentTemplates) {
   window.unit_location_analytics = '${unit_locator}';
 
-  // tabs
-  $('.tab-group').tabs();
+  var templates = new ComponentTemplates(${component_templates | n}, {parse: true});
 
   new UnitEditView({
     el: $('.main-wrapper'),
@@ -35,7 +34,8 @@ require(["domReady!", "jquery", "js/models/module_info", "coffee/src/views/unit"
     model: new ModuleModel({
       id: '${unit_locator}',
       state: '${unit_state}'
-    })
+    }),
+    templates: templates
   });
 
   $('.new-component-template').each(function(){
@@ -64,87 +64,8 @@ require(["domReady!", "jquery", "js/models/module_info", "coffee/src/views/unit"
             % for locator in locators:
             <li class="component" data-locator="${locator}"/>
             % endfor
-            <li class="new-component-item adding">
-              <div class="new-component">
-                <h5>${_("Add New Component")}</h5>
-                <ul class="new-component-type">
-                  % for type, templates in sorted(component_templates.items()):
-                  <li>
-                  % if type == 'advanced' or len(templates) > 1:
-                    <a href="#" class="multiple-templates" data-type="${type}">
-                  % else:
-                    % for __, category, __, __ in templates:
-                    <a href="#" class="single-template" data-type="${type}" data-category="${category}">
-                    % endfor
-                  % endif
-                      <span class="large-template-icon large-${type}-icon"></span>
-                      <span class="name">${type}</span>
-                    </a>
-                  </li>
-                  % endfor
-                </ul>
-              </div>
-                % for type, templates in sorted(component_templates.items()):
-                  % if len(templates) > 1 or type == 'advanced':
-                <div class="new-component-templates new-component-${type}">
-                    % if type == "problem":
-                    <div class="tab-group tabs">
-                            <ul class="problem-type-tabs nav-tabs">
-                              <li class="current">
-                                <a class="link-tab" href="#tab1">${_("Common Problem Types")}</a>
-                              </li>
-                              <li>
-                                <a class="link-tab" href="#tab2">${_("Advanced")}</a>
-                              </li>
-                            </ul>
-                    % endif
-                    <div class="tab current" id="tab1">
-                      <ul class="new-component-template">
-                          % for name, category, has_markdown, boilerplate_name in sorted(templates):
-                            % if has_markdown or type != "problem":
-                                % if boilerplate_name is None:
-                                  <li class="editor-md empty">
-                                    <a href="#" data-category="${category}">
-                                      <span class="name">${name}</span>
-                                    </a>
-                                  </li>
-
-                                % else:
-                                  <li class="editor-md">
-                                    <a href="#" data-category="${category}"
-                                       data-boilerplate="${boilerplate_name}">
-                                      <span class="name">${name}</span>
-                                    </a>
-                                  </li>
-                                % endif
-                            % endif
-
-                          %endfor
-                      </ul>
-                    </div>
-                    % if type == "problem":
-                        <div class="tab" id="tab2">
-                          <ul class="new-component-template">
-                              % for name, category, has_markdown, boilerplate_name in sorted(templates):
-                                % if not has_markdown:
-                                  <li class="editor-manual">
-                                    <a href="#" data-category="${category}"
-                                       data-boilerplate="${boilerplate_name}">
-                                      <span class="name">${name}</span>
-                                    </a>
-                                  </li>
-                                % endif
-                              % endfor
-                          </ul>
-                        </div>
-                    </div>
-                    % endif
-                    <a href="#" class="cancel-button">Cancel</a>
-                </div>
-                % endif
-                % endfor
-            </li>
           </ol>
+          <div class="add-xblock-component new-component-item adding"></div>
         </article>
       </div>
 

cms/templates/ux/reference/unit.html

@@ -127,7 +127,7 @@ from django.utils.translation import ugettext as _
                 </li>
             </ul>
         </div>
-        <span data-tooltip="Drag to reorder" class="drag-handle"></span>
+        <span data-tooltip="Drag to reorder" class="drag-handle action"></span>
         <section class="xblock xblock-student_view xmodule_display xmodule_HtmlModule" data-runtime-version="1" data-init="XBlockToXModuleShim" data-handler-prefix="/preview/xblock/i4x:;_;_andya;_AA101;_html;_c8fb4780eb554aec95c6231680eb82cf/handler" data-type="HTMLModule" data-block-type="html">
             <ol>
                 <li>
@@ -306,7 +306,7 @@ from django.utils.translation import ugettext as _
         </li>
     </ul>
 </div>
-<span data-tooltip="Drag to reorder" class="drag-handle"></span>
+<span data-tooltip="Drag to reorder" class="drag-handle action"></span>
 <section class="xblock xblock-student_view xmodule_display xmodule_VideoModule" data-runtime-version="1" data-init="XBlockToXModuleShim" data-handler-prefix="/preview/xblock/i4x:;_;_andya;_AA101;_video;_da30d8c1da6d43268152e19089ecc2fa/handler" data-type="Video" data-block-type="video">
 
 
@@ -561,7 +561,7 @@ from django.utils.translation import ugettext as _
         </li>
     </ul>
 </div>
-<span data-tooltip="Drag to reorder" class="drag-handle"></span>
+<span data-tooltip="Drag to reorder" class="drag-handle action"></span>
 <section class="xblock xblock-student_view xmodule_display xmodule_CapaModule" data-runtime-version="1" data-init="XBlockToXModuleShim" data-handler-prefix="/preview/xblock/i4x:;_;_andya;_AA101;_problem;_2fa3ab8048514b73b36e8807a42b3525/handler" data-type="Problem" data-block-type="problem">
     <section id="problem_i4x-andya-AA101-problem-2fa3ab8048514b73b36e8807a42b3525" class="problems-wrapper" data-problem-id="i4x://andya/AA101/problem/2fa3ab8048514b73b36e8807a42b3525" data-url="/preview/xblock/i4x:;_;_andya;_AA101;_problem;_2fa3ab8048514b73b36e8807a42b3525/handler/xmodule_handler" data-progress_status="0" data-progress_detail="0">
 

cms/templates/widgets/units.html

@@ -42,7 +42,7 @@ This def will enumerate through a passed in subsection and list all of the units
             <a href="#" data-tooltip="${_("Delete this unit")}" class="delete-unit-button action" data-locator="${unit_locator}"><i class="icon-trash"></i><span class="sr">${_("Delete unit")}</span></a>
           </li>
           <li class="actions-item drag">
-            <span data-tooltip="${_("Drag to sort")}" class="drag-handle unit-drag-handle action"><span class="sr"> ${_("Drag to reorder unit")}</span></span>
+            <span data-tooltip="${_("Drag to sort")}" class="drag-handle unit-drag-handle"><span class="sr"> ${_("Drag to reorder unit")}</span></span>
           </li>
         </ul>
       </div>
@@ -61,6 +61,3 @@ This def will enumerate through a passed in subsection and list all of the units
   </li>
 </ol>
 </%def>
-
-
-

common/lib/xmodule/xmodule/studio_editable.py

+"""
+Mixin to support editing in Studio.
+"""
+
+
+class StudioEditableModule(object):
+    """
+    Helper methods for supporting Studio editing of xblocks.
+    """
+
+    def render_reorderable_children(self, context, fragment):
+        """
+        Renders children with the appropriate HTML structure for drag and drop.
+        """
+        contents = []
+
+        for child in self.get_display_items():
+            context['reorderable_items'].add(child.location)
+            rendered_child = child.render('student_view', context)
+            fragment.add_frag_resources(rendered_child)
+
+            contents.append({
+                'id': child.id,
+                'content': rendered_child.content
+            })
+
+        fragment.add_content(self.system.render_template("studio_render_children_view.html", {
+            'items': contents,
+            'xblock_context': context,
+        }))

common/lib/xmodule/xmodule/tests/test_studio_editable.py

+"""
+Tests for StudioEditableModule.
+"""
+
+from xmodule.tests.test_vertical import BaseVerticalModuleTest
+
+
+class StudioEditableModuleTestCase(BaseVerticalModuleTest):
+    def test_render_reorderable_children(self):
+        """
+        Test the behavior of render_reorderable_children.
+        """
+        reorderable_items = set()
+        context = {
+            'runtime_type': 'studio',
+            'container_view': True,
+            'reorderable_items': reorderable_items,
+            'read_only': False,
+            'root_xblock': self.vertical,
+        }
+
+        # Both children of the vertical should be rendered as reorderable
+        self.module_system.render(self.vertical, 'student_view', context).content
+        self.assertIn(self.vertical.get_children()[0].location, reorderable_items)
+        self.assertIn(self.vertical.get_children()[1].location, reorderable_items)

common/lib/xmodule/xmodule/tests/test_vertical.py

+"""
+Tests for vertical module.
+"""
+
+from fs.memoryfs import MemoryFS
+from xmodule.tests import get_test_system
+from xmodule.tests.xml import XModuleXmlImportTest
+from xmodule.tests.xml import factories as xml
+
+
+class BaseVerticalModuleTest(XModuleXmlImportTest):
+    test_html_1 = 'Test HTML 1'
+    test_html_2 = 'Test HTML 2'
+
+    def setUp(self):
+        self.course_id = 'test_org/test_course_number/test_run'
+        # construct module
+        course = xml.CourseFactory.build()
+        sequence = xml.SequenceFactory.build(parent=course)
+        vertical = xml.VerticalFactory.build(parent=sequence)
+
+        self.course = self.process_xml(course)
+        xml.HtmlFactory(parent=vertical, url_name='test-html-1', text=self.test_html_1)
+        xml.HtmlFactory(parent=vertical, url_name='test-html-2', text=self.test_html_2)
+
+        self.course = self.process_xml(course)
+        course_seq = self.course.get_children()[0]
+        self.module_system = get_test_system()
+
+        def get_module(descriptor):
+            """Mocks module_system get_module function"""
+            module_system = get_test_system()
+            module_system.get_module = get_module
+            descriptor.bind_for_student(module_system, descriptor._field_data)  # pylint: disable=protected-access
+            return descriptor
+
+        self.module_system.get_module = get_module
+        self.module_system.descriptor_system = self.course.runtime
+        self.course.runtime.export_fs = MemoryFS()
+
+        self.vertical = course_seq.get_children()[0]
+        self.vertical.xmodule_runtime = self.module_system
+
+
+class VerticalModuleTestCase(BaseVerticalModuleTest):
+    def test_render_student_view(self):
+        """
+        Test the rendering of the student view.
+        """
+        html = self.module_system.render(self.vertical, 'student_view', {}).content
+        self.assertIn(self.test_html_1, html)
+        self.assertIn(self.test_html_2, html)
+
+    def test_render_studio_view(self):
+        """
+        Test the rendering of the Studio view
+        """
+        reorderable_items = set()
+        context = {
+            'runtime_type': 'studio',
+            'reorderable_items': reorderable_items,
+        }
+        html = self.module_system.render(self.vertical, 'student_view', context).content
+        self.assertIn(self.test_html_1, html)
+        self.assertIn(self.test_html_2, html)

common/lib/xmodule/xmodule/vertical_module.py

@@ -2,6 +2,7 @@ from xblock.fragment import Fragment
 from xmodule.x_module import XModule
 from xmodule.seq_module import SequenceDescriptor
 from xmodule.progress import Progress
+from xmodule.studio_editable import StudioEditableModule
 from pkg_resources import resource_string
 from copy import copy
 
@@ -14,7 +15,7 @@ class VerticalFields(object):
     has_children = True
 
 
-class VerticalModule(VerticalFields, XModule):
+class VerticalModule(VerticalFields, XModule, StudioEditableModule):
     ''' Layout module for laying out submodules vertically.'''
 
     def student_view(self, context):
@@ -28,7 +29,9 @@ class VerticalModule(VerticalFields, XModule):
         """
         Renders the Studio preview view, which supports drag and drop.
         """
-        return self.render_view(context, 'vert_module_studio_view.html')
+        fragment = Fragment()
+        self.render_reorderable_children(context, fragment)
+        return fragment
 
     def render_view(self, context, template_name):
         """

common/test/acceptance/pages/studio/container.py

@@ -8,6 +8,9 @@ from . import BASE_URL
 
 from selenium.webdriver.common.action_chains import ActionChains
 
+from utils import click_css, wait_for_notification
+
+
 class ContainerPage(PageObject):
     """
     Container page in Studio
@@ -45,23 +48,49 @@ class ContainerPage(PageObject):
         return self.q(css=XBlockWrapper.BODY_SELECTOR).map(
             lambda el: XBlockWrapper(self.browser, el.get_attribute('data-locator'))).results
 
-    def drag(self, source_index, target_index, after=True):
+    def drag(self, source_index, target_index):
         """
         Gets the drag handle with index source_index (relative to the vertical layout of the page)
         and drags it to the location of the drag handle with target_index.
 
-        This should drag the element with the source_index drag handle AFTER the
-        one with the target_index drag handle, unless 'after' is set to False.
+        This should drag the element with the source_index drag handle BEFORE the
+        one with the target_index drag handle.
         """
         draggables = self.q(css='.drag-handle')
         source = draggables[source_index]
         target = draggables[target_index]
         action = ActionChains(self.browser)
-        action.click_and_hold(source).perform()  # pylint: disable=protected-access
-        action.move_to_element_with_offset(
-            target, 0, target.size['height'] / 2 if after else 0
-        ).perform()  # pylint: disable=protected-access
-        action.release().perform()
+        # When dragging before the target element, must take into account that the placeholder
+        # will appear in the place where the target used to be.
+        placeholder_height = 40
+        action.click_and_hold(source).move_to_element_with_offset(
+            target, 0, placeholder_height
+        ).release().perform()
+        wait_for_notification(self)
+
+    def add_discussion(self, menu_index):
+        """
+        Add a new instance of the discussion category.
+
+        menu_index specifies which instance of the menus should be used (based on vertical
+        placement within the page).
+        """
+        click_css(self, 'a>span.large-discussion-icon', menu_index)
+
+    def duplicate(self, source_index):
+        """
+        Duplicate the item with index source_index (based on vertical placement in page).
+        """
+        click_css(self, 'a.duplicate-button', source_index)
+
+    def delete(self, source_index):
+        """
+        Delete the item with index source_index (based on vertical placement in page).
+        """
+        click_css(self, 'a.delete-button', source_index, require_notification=False)
+        # Click the confirmation dialog button
+        click_css(self, 'a.button.action-primary', 0)
+
 
 
 class XBlockWrapper(PageObject):
@@ -69,7 +98,7 @@ class XBlockWrapper(PageObject):
     A PageObject representing a wrapper around an XBlock child shown on the Studio container page.
     """
     url = None
-    BODY_SELECTOR = '.wrapper-xblock'
+    BODY_SELECTOR = '.studio-xblock-wrapper'
     NAME_SELECTOR = '.header-details'
 
     def __init__(self, browser, locator):

common/test/acceptance/pages/studio/utils.py

+"""
+Utility methods useful for Studio page tests.
+"""
+from bok_choy.promise import Promise
+from selenium.webdriver.common.action_chains import ActionChains
+
+
+def click_css(page, css, source_index, require_notification=True):
+    """
+    Click the button/link with the given css and index on the specified page (subclass of PageObject).
+
+    If require_notification is False (default value is True), the method will return immediately.
+    Otherwise, it will wait for the "mini-notification" to appear and disappear.
+    """
+    buttons = page.q(css=css)
+    target = buttons[source_index]
+    ActionChains(page.browser).click(target).release().perform()
+    if require_notification:
+        wait_for_notification(page)
+
+
+def wait_for_notification(page):
+    """
+    Waits for the "mini-notification" to appear and disappear on the given page (subclass of PageObject).
+    """
+    def _is_saving():
+        num_notifications = len(page.q(css='.wrapper-notification-mini.is-shown'))
+        return (num_notifications == 1, num_notifications)
+
+    def _is_saving_done():
+        num_notifications = len(page.q(css='.wrapper-notification-mini.is-hiding'))
+        return (num_notifications == 1, num_notifications)
+
+    Promise(_is_saving, 'Notification showing.').fulfill()
+    Promise(_is_saving_done, 'Notification hidden.').fulfill()

lms/templates/studio_render_children_view.html

+<ol class="reorderable-container">
+    % for item in items:
+    ${item['content']}
+    % endfor
+</ol>
+% if not xblock_context['read_only']:
+<div class="add-xblock-component new-component-item adding"></div>
+% endif

lms/templates/vert_module_studio_view.html

-<%!
-from django.utils.translation import ugettext as _
-%>
-<div class="vert-mod">
-    <ol class="vertical-container">
-        % for idx, item in enumerate(items):
-        <li class="vertical-element is-draggable">
-            <div class="vert vert-${idx}" data-id="${item['id']}">
-                % if not xblock_context['read_only']:
-                <span data-tooltip="${_('Drag to reorder')}" class="drag-handle action"></span>
-                % endif
-                ${item['content']}
-            </div>
-        </li>
-        % endfor
-    </ol>
-</div>