Documentation

Class: Container

wp.customize~ Container

new Container(id, options)

Base class for Panel and Section.
Parameters:
Name Type Description
id string The ID for the container.
options object Object containing one property: params.
Properties
Name Type Argument Default Description
title string Title shown when panel is collapsed and expanded.
description string <optional>
 Description shown at the top of the panel.
priority number <optional>
 100 The sort priority for the panel.
templateId string <optional>
 Template selector for container.
type string <optional>
 default The type of the panel. See wp.customize.panelConstructor.
content string <optional>
 The markup to be used for the panel container. If empty, a JS template is used.
active boolean <optional>
 true Whether the panel is active or not.
params object <optional>
 Deprecated wrapper for the above properties.
Since:
  • 4.1.0
Source:

Extends

  • wp.customize.Class

Methods

<static> focus( [params])

Expand a panel, section, or control and focus on the first focusable element.
Parameters:
Name Type Argument Description
params Object <optional>
Properties
Name Type Argument Description
completeCallback function <optional>
Since:
  • 4.1.0
Source:

<private> _animateChangeExpanded(completeCallback)

Animate container state change if transitions are supported by the browser.
Parameters:
Name Type Description
completeCallback function Function to be called after transition is completed.
Since:
  • 4.7.0
Source:
Returns:
Type
void

_children(parentType, childType)

Get the child models associated with this parent, sorting them by their priority Value.
Parameters:
Name Type Description
parentType String
childType String
Since:
  • 4.1.0
Source:
Returns:
Type
Array

_toggleActive(active [, params])

Parameters:
Name Type Argument Description
active Boolean
params Object <optional>
Since:
  • 4.1.0
Source:
Returns:
False if state already applied.
Type
Boolean

_toggleExpanded(expanded [, params])

Handle the toggle logic for expand/collapse.
Parameters:
Name Type Argument Description
expanded Boolean The new state to apply.
params Object <optional>
 Object containing options for expand/collapse.
Properties
Name Type Argument Description
completeCallback function <optional>
 Function to call when expansion/collapse is complete.
Source:
Returns:
False if state already applied or active state is false.
Type
Boolean

activate( [params])

Parameters:
Name Type Argument Description
params Object <optional>
Source:
Returns:
False if already active.
Type
Boolean

collapse( [params])

Parameters:
Name Type Argument Description
params Object <optional>
Source:
Returns:
False if already collapsed.
Type
Boolean

deactivate( [params])

Parameters:
Name Type Argument Description
params Object <optional>
Source:
Returns:
False if already inactive.
Type
Boolean

expand( [params])

Parameters:
Name Type Argument Description
params Object <optional>
Source:
Returns:
False if already expanded or if inactive.
Type
Boolean

getContainer()

Return the container html, generated from its JS template, if it exists.
Since:
  • 4.3.0
Source:

getContent()

Find content element which is displayed when the section is expanded. After a construct is initialized, the return value will be available via the `contentContainer` property. By default the element will be related it to the parent container with `aria-owns` and detached. Custom panels and sections (such as the `NewMenuSection`) that do not have a sliding pane should just return the content element without needing to add the `aria-owns` element or detach it from the container. Such non-sliding pane custom sections also need to override the `onChangeExpanded` method to handle animating the panel/section into and out of view.
Since:
  • 4.7.0
Source:
Returns:
Detached content element.
Type
jQuery

getNotificationsContainerElement()

Get the element that will contain the notifications.
Since:
  • 4.9.0
Source:
Returns:
Notification container element.
Type
jQuery

<abstract> isContextuallyActive()

To override by subclass, to return whether the container has active children.
Since:
  • 4.1.0
Source:

onChangeActive(active [, args])

Active state change handler. Shows the container if it is active, hides it if not. To override by subclass, update the container's UI to reflect the provided active state.
Parameters:
Name Type Argument Description
active boolean The active state to transiution to.
args Object <optional>
 Args.
Properties
Name Type Argument Description
duration Object <optional>
 The duration for the slideUp/slideDown animation.
unchanged boolean <optional>
 Whether the state is already known to not be changed, and so short-circuit with calling completeCallback early.
completeCallback function <optional>
 Function to call when the slideUp/slideDown has completed.
Since:
  • 4.1.0
Source:

<abstract> onChangeExpanded()

To override by subclass, update the container's UI to reflect the provided active state.
Source:

<abstract> ready()

Since:
  • 4.1.0
Source:

setupNotifications()

Set up notifications.
Since:
  • 4.9.0
Source:
Returns:
Type
void