Options
All
  • Public
  • Public/Protected
  • All
Menu

PrimeFaces Splitter Widget

Splitter represents entities using icons, labels and images.

Type Parameters

  • TCfg extends SplitterCfg = SplitterCfg

    Defaults to SplitterCfg. Type of the configuration object for this widget.

Hierarchy

Index

Constructors

  • Creates a new instance of this widget. Please note that you should NOT override this constructor. Instead, override the init method, which is called at the end of the constructor once the instance is created.

    Type Parameters

    Parameters

    • cfg: PartialWidgetCfg<TCfg>

      The widget configuration to be used for this widget instance. This widget configuration is usually created on the server by the javax.faces.render.Renderer for this component.

    Returns PrimeFaces.widget.Splitter<TCfg>

Properties

cfg: PartialWidgetCfg<TCfg>

The configuration of this widget instance. Please note that no property is guaranteed to be present, you should always check for undefined before accessing a property. This is partly because the value of a property is not transmitted from the server to the client when it equals the default.

Array of registered listeners invoked when this widget is destroyed. You should normally not use modify this directly, use addDestroyListener instead.

dragging?: boolean

Whether the splitter is currently being dragged, i.e. whether an element is being resized.

gutterElement?: null | JQuery<HTMLElement>

When resizing, the DOM elements of the gutter used for resizing.

gutterHandle?: null | JQuery<HTMLElement>

DOM element of the gutter handle for keyboard events.

gutters: JQuery<HTMLElement>

DOM elements of the gutter elements in splitter.

horizontal: boolean

Whether splitter element is horizontal.

id: string | string[]

The client-side ID of this widget, with all parent naming containers, such as myForm:myWidget. This is also the ID of the container HTML element for this widget. In case the widget needs multiple container elements (such as Paginator), this may also be an array if IDs.

jq: JQuery<HTMLElement>

The jQuery instance of the container element of this widget. In case id is an array, it will contain multiple elements. Please note that some widgets have got not DOM elements at all, in this case this will be an empty jQuery instance.

jqId: string

A CSS selector for the container element (or elements, in case id is an array) of this widget, This is usually an ID selector (that is properly escaped). You can select the container element or elements like this: $(widget.jqId).

nextPanelElement?: null | JQuery<HTMLElement>

When resizing, the DOM element of the panel after the panel being resized.

nextPanelSize?: null | number

When resizing, the width or height (depending on the resize direction) of the panel after the panel being resized.

panelSizes: number[]

Array of the panels size for save and restore state.

panels: JQuery<HTMLElement>

DOM elements of the splitter panels in splitter.

prevPanelElement?: null | JQuery<HTMLElement>

When resizing, the DOM element of the panel before the panel being resized.

prevPanelIndex?: null | number

When resizing, the index of the panel before the panel being resized.

prevPanelSize?: null | number

When resizing, the width or height (depending on the resize direction) of the panel before the panel being resized.

Array of registered listeners invoked when this widget is refreshed. You should normally not use modify this directly, use addRefreshListener instead.

size?: null | number

Initial width or height of the splitter (depending on the resize direction) when resizing started.

startPos?: null | number

Start position in pixels when resizing.

timeout: number

The interval for repeating key events.

vertical: boolean

Whether splitter element is vertical.

widgetVar: string

The name of the widget variables of this widget. The widget variable can be used to access a widget instance by calling PF('myWidgetVar').

Methods

  • Lets you register a listener that is called before the component is destroyed.

    When an AJAX call is made and this component is updated, the DOM element is replaced with the newly rendered content. When the element is removed from the DOM by the update, the DOM element is detached from the DOM and all destroy listeners are called. This makes it possible to add listeners from outside the widget code.

    If you call this method twice with the same listener, it will be registered twice and later also called twice.

    Note that for this to work, you must not override the destroy method; or if you do, call super.

    Also, after this widget was detached is done, all destroy listeners will be unregistered.

    since

    7.0

    Parameters

    Returns void

  • When an AJAX call is made and this component is updated, the DOM element is replaced with the newly rendered content. However, no new instance of the widget is created. Instead, after the DOM element was replaced, all refresh listeners are called. This makes it possible to add listeners from outside the widget code.

    If you call this method twice with the same listener, it will be registered twice and later also called twice.

    Note that for this to work, you must not override the refresh method; or if you do, call super.

    Also, after the refresh is done, all refresh listeners will be deregistered. If you added the listeners from within this widget, consider adding the refresh listeners not only in the init method, but also again in the refresh method after calling super.

    since

    7.0.0

    Parameters

    Returns void

  • bindDocumentEvents(): void
  • Bind document events

    Returns void

  • bindGutterEvent(): void
  • Set up event for the gutters.

    Returns void

  • Each widget may have one or several behaviors attached to it. This method calls all attached behaviors for the given event name. In case no such behavior exists, this method does nothing and returns immediately.

    A behavior is a way for associating client-side scripts with UI components that opens all sorts of possibilities, including client-side validation, DOM and style manipulation, keyboard handling, and more. When the behavior is triggered, the configured JavaScript gets executed.

    Behaviors are often, but not necessarily, AJAX behavior. When triggered, it initiates a request the server and processes the response once it is received. This enables several features such as updating or replacing elements dynamically. You can add an AJAX behavior via <p:ajax event="name" actionListener="#{...}" onstart="..." />.

    since

    7.0

    Parameters

    • event: string

      The name of an event to call.

    • Optional ext: Partial<ConfigurationExtender>

      Additional configuration that is passed to the AJAX request for the server-side callback.

    Returns void

  • clear(): void
  • Clear all variables

    Returns void

  • clearTimer(): void
  • Clears the current interval for repeating keyboard events.

    Returns void

  • destroy(): void
  • Will be called after an AJAX request if the widget container will be detached.

    When an AJAX call is made and this component is updated, the DOM element is replaced with the newly rendered content. When the element is removed from the DOM by the update, the DOM element is detached from the DOM and this method gets called.

    Please note that instead of overriding this method, you should consider adding a destroy listener instead via addDestroyListener. This has the advantage of letting you add multiple listeners, and makes it possible to add additional listeners from code outside this widget.

    By default, this method just calls all destroy listeners.

    Returns void

  • getBehavior(name: string): null | Behavior
  • Each widget may have one or several behaviors attached to it. This method returns the callback function for the given event.

    Note: Do not call the method directly, the recommended way to invoke a behavior is via callBehavior.

    A behavior is a way for associating client-side scripts with UI components that opens all sorts of possibilities, including client-side validation, DOM and style manipulation, keyboard handling, and more. When the behavior is triggered, the configured JavaScript gets executed.

    Behaviors are often, but not necessarily, AJAX behavior. When triggered, it initiates a request the server and processes the response once it is received. This enables several features such as updating or replacing elements dynamically. You can add an AJAX behavior via <p:ajax event="name" actionListener="#{...}" onstart="..." />.

    Parameters

    • name: string

      The name of an event for which to retrieve the behavior.

    Returns null | Behavior

    The behavior with the given name, or null if no such behavior exists.

  • Each widget has got a container element, this method returns that container. This container element is usually also the element whose ID is the client-side ID of the JSF component.

    Returns JQuery<HTMLElement>

    The jQuery instance representing the main HTML container element of this widget.

  • getParentForm(): JQuery<HTMLElement>
  • Gets the closest parent form for this widget.

    since

    10.0.0

    Returns JQuery<HTMLElement>

    A JQuery instance that either contains the form when found, or an empty JQuery instance when the form could not be found.

  • getParentFormId(): undefined | string
  • Gets the closest parent form ID for this widget lazily so it can be used in AJAX requests.

    since

    10.0.0

    Returns undefined | string

    Either the form ID or undefined if no form can be found.

  • getStorage(): Storage
  • Returns either the local storage or session storage, depending on the current widget configuration.

    Returns Storage

    The storage to be used.

  • hasBehavior(event: string): boolean
  • Each widget may have one or several behaviors attached to it. This method checks whether this widget has got at least one behavior associated with given event name.

    A behavior is a way for associating client-side scripts with UI components that opens all sorts of possibilities, including client-side validation, DOM and style manipulation, keyboard handling, and more. When the behavior is triggered, the configured JavaScript gets executed.

    Behaviors are often, but not necessarily, AJAX behavior. When triggered, it initiates a request the server and processes the response once it is received. This enables several features such as updating or replacing elements dynamically. You can add an AJAX behavior via <p:ajax event="name" actionListener="#{...}" onstart="..." />.

    Parameters

    • event: string

      The name of an event to check.

    Returns boolean

    true if this widget has the given behavior, false otherwise.

  • A widget class should not declare an explicit constructor, the default constructor provided by this base widget should be used. Instead, override this initialize method which is called after the widget instance was constructed. You can use this method to perform any initialization that is required. For widgets that need to create custom HTML on the client-side this is also the place where you should call your render method.

    Please make sure to call the super method first before adding your own custom logic to the init method:

    PrimeFaces.widget.MyWidget = PrimeFaces.widget.BaseWidget.extend({
    init: function(cfg) {
    this._super(cfg);
    // custom initialization
    }
    });
    override

    Parameters

    • cfg: PartialWidgetCfg<TCfg>

      The widget configuration to be used for this widget instance. This widget configuration is usually created on the server by the javax.faces.render.Renderer for this component.

    Returns void

  • initPanelSize(): void
  • Initialize panels size.

    Returns void

  • isDetached(): boolean
  • Checks if this widget is detached, ie whether the HTML element of this widget is currently contained within the DOM (the HTML body element). A widget may become detached during an AJAX update, and it may remain detached in case the update removed this component from the component tree.

    Returns boolean

    true if this widget is currently detached, or false otherwise.

  • isStateful(): boolean
  • Whether the splitter keeps its dimensions between different page loads.

    Returns boolean

    Whether the splitter is retaining its state.

  • Event handler for key down events.

    Parameters

    • event: TriggeredEvent<any, any, any, any>

      Event triggered for the key down.

    Returns void

  • Event handler for key up events.

    Parameters

    • event: TriggeredEvent<any, any, any, any>

      Event triggered for the key up.

    Returns void

  • onResize(event: TriggeredEvent<any, any, any, any>, step?: number, isKeyDown?: boolean): void
  • The method called while the 'resize' event is running.

    Parameters

    • event: TriggeredEvent<any, any, any, any>

      Event triggered for the resize.

    • Optional step: number

      Defaults to 0. the step size

    • Optional isKeyDown: boolean

      Defaults to false. is key being held down

    Returns void

  • The method that is called when the 'resize' event ends and calls the server-side resizeEnd ajax behavior event if such a behavior exists and call user 'onResizeEnd' callback. Use <p:ajax event="resizeEnd" listener="#{splitterView.onResizeEnd}" /> on the component to define a behavior.

    Parameters

    • event: TriggeredEvent<any, any, any, any>

      Event triggered for the resize end.

    Returns void

  • onResizeStart(event: TriggeredEvent<any, any, any, any>, isKeyDown: boolean): void
  • The method that is called when the 'resize' event starts.

    Parameters

    • event: TriggeredEvent<any, any, any, any>

      Event triggered for the drag.

    • isKeyDown: boolean

      is key being held down

    Returns void

  • Used in ajax updates, reloads the widget configuration.

    When an AJAX call is made and this component is updated, the DOM element is replaced with the newly rendered content. However, no new instance of the widget is created. Instead, after the DOM element was replaced, this method is called with the new widget configuration from the server. This makes it possible to persist client-side state during an update, such as the currently selected tab.

    Please note that instead of overriding this method, you should consider adding a refresh listener instead via addRefreshListener. This has the advantage of letting you add multiple listeners, and makes it possible to add additional listeners from code outside this widget.

    By default, this method calls all refresh listeners, then reinitializes the widget by calling the init method.

    Parameters

    Returns unknown

    The value as returned by the init method, which is often undefined.

  • removeScriptElement(clientId: string | string[]): void
  • Removes the widget's script block from the DOM. Currently, the ID of this script block consists of the client-side ID of this widget with the prefix _s, but this is subject to change.

    Parameters

    • clientId: string | string[]

      The client-side ID of the widget.

    Returns void

  • Repeat the current key using a step.

    Parameters

    • event: TriggeredEvent<any, any, any, any>

      Event triggered for the repeat.

    • step: number

      the increment to step by

    Returns void

  • resizePanel(newPrevPanelSize: number, newNextPanelSize: number): void
  • Resizes the panel.

    Parameters

    • newPrevPanelSize: number

      the new size of the primary panel

    • newNextPanelSize: number

      the new size of the secondary panel

    Returns void

  • restoreState(): boolean
  • Restore panel sizes from (local or session) storage.

    Returns boolean

    true when the state restore operation was successful, false otherwise.

  • saveState(): void
  • Save current panel sizes to the (local or session) storage.

    Returns void

  • setTimer(event: TriggeredEvent<any, any, any, any>, step: number): void
  • Sets the current interval for repeating keyboard events.

    Parameters

    • event: TriggeredEvent<any, any, any, any>

      Event triggered for the repeat.

    • step: number

      the increment to step by

    Returns void

  • unbindDocumentEvents(): void
  • Removes document events

    Returns void

  • validateResize(newPrevPanelSize: number, newNextPanelSize: number): boolean
  • Checks the new values according to the size and minimum size values

    Parameters

    • newPrevPanelSize: number

      The new previous panel size.

    • newNextPanelSize: number

      The new next panel size.

    Returns boolean

    true if resized, false if not.

Generated using TypeDoc