Movatterモバイル変換

[0]ホーム
URL:

API Docs for: v0.8.0

APIs

Show:

Gridster Class

Constructor

Gridster

(
  • el
  • [options]
  • [options.autogenerate_stylesheet] If true, all the CSS required to position all widgets in their respective columns and rows will be generated automatically and injected to the `<head>` of the document. You can set this to false, and write your own CSS targeting rows and cols via data-attributes like so: `[data-col="1"]
  • [options.resize.axes] Axes in which widgets can be resized. Possible values: ['x', 'y', 'both']
  • [options.resize.max_size] Limit widget dimensions when resizing. Array values should be integers: `[max_cols_occupied, max_rows_occupied]
  • [options.resize.min_size] Limit widget dimensions when resizing. Array values should be integers: `[min_cols_occupied, min_rows_occupied]
)

Parameters:

  • elHTMLElement

    The HTMLelement that contains all the widgets.

  • [options]Objectoptional

    An Object with all options you want to overwrite:

    • [widget_selector]HTMLElement | Stringoptional

      Define who will be the draggable widgets. Can be a CSS Selector String or a collection of HTMLElements

    • [widget_margins]Arrayoptional

      Margin between widgets. The first index for the horizontal margin (left, right) and the second for the vertical margin (top, bottom).

    • [widget_base_dimensions]Arrayoptional

      Base widget dimensions in pixels. The first index for the width and the second for the height.

    • [extra_cols]Numberoptional

      Add more columns in addition to those that have been calculated.

    • [extra_rows]Numberoptional

      Add more rows in addition to those that have been calculated.

    • [min_cols]Numberoptional

      The minimum required columns.

    • [max_cols]Numberoptional

      The maximum columns possible (set to null for no maximum).

    • [min_rows]Numberoptional

      The minimum required rows.

    • [avoid_overlapped_widgets]Booleanoptional

      Avoid that widgets loaded from the DOM can be overlapped. It is helpful if the positions were bad stored in the database or if there was any conflict.

    • [auto_init]Booleanoptional

      Automatically call gridster init method or not when the plugin is instantiated.

    • [serialize_params]Functionoptional

      Return the data you want for each widget in the serialization. Two arguments are passed:$w: the jQuery wrapped HTMLElement, andwgd: the grid coords object (col,row,size_x,size_y).

    • [shift_larger_widgets_down]Booleanoptional

      Determines if how widgets get pushes out of the way of the player. If set to false smaller widgets will not move larger widgets out of their way . Defaults to true.

    • [shift_widgets_up]Booleanoptional

      Determines if the player will automatically condense the grid and not allow a widget to have space above it. Defaults to true.

    • [show_element]Functionoptional

      Makes the given element visible. Two arguments are passed:$el: the jQuery wrapped HTMLElement, andcallback: a function that is executed after the element is made visible. The callback parameter is optional.

    • [hide_element]Functionoptional

      Hides the given element. Two arguments are passed:$el: the jQuery wrapped HTMLElement, andcallback: a function that is executed after the element is hidden. The callback parameter is optional.

    • [collision]Objectoptional

      An Object with all options for Collision class you want to overwrite. See Collision docs for more info.

      • [wait_for_mouseup]Booleanoptional
        Default is false. If true then it will not move colliding widgets during drag, but only on mouseup.
    • [draggable]Objectoptional

      An Object with all options for Draggable class you want to overwrite. See Draggable docs for more info.

      • [ignore_dragging]Object | Functionoptional
        Note that if you use a Function, and resize is enabled, you should ignore the resize handlers manually (options.resize.handle_class).
    • [resize]Objectoptional

      An Object with resize config options.

      • [enabled]Booleanoptional
        Set to true to enable resizing.
      • [handle_append_to]Stringoptional
        Set a valid CSS selector to append resize handles to.
      • [handle_class]Stringoptional
        CSS class name used by resize handles.
      • [start]Functionoptional
        Function executed when resizing starts.
      • [resize]Functionoptional
        Function executed during the resizing.
      • [stop]Functionoptional
        Function executed when resizing stops.
  • [options.autogenerate_stylesheet] If true, all the CSS required to position all widgets in their respective columns and rows will be generated automatically and injected to the `<head>` of the document. You can set this to false, and write your own CSS targeting rows and cols via data-attributes like so: `[data-col="1"]Boolean

    { left: 10px; }`

  • [options.resize.axes] Axes in which widgets can be resized. Possible values: ['x', 'y', 'both']Array

    .

  • [options.resize.max_size] Limit widget dimensions when resizing. Array values should be integers: `[max_cols_occupied, max_rows_occupied]Array

    `

  • [options.resize.min_size] Limit widget dimensions when resizing. Array values should be integers: `[min_cols_occupied, min_rows_occupied]Array

    `

Item Index

Methods

Methods

add_faux_cell

(
  • row
  • col
)
Object

Add cell to the faux grid.

Parameters:

  • rowNumber

    The row for the new faux cell.

  • colNumber

    The col for the new faux cell.

Returns:

Object:

Returns the instance of the Gridster class.

add_faux_cols

(
  • cols
)
Object

Add cols to the faux grid.

Parameters:

  • colsNumber

    The number of cols you want to add to the faux grid.

Returns:

Object:

Returns the instance of the Gridster class.

add_faux_rows

(
  • rows
)
Object

Add rows to the faux grid.

Parameters:

  • rowsNumber

    The number of rows you want to add to the faux grid.

Returns:

Object:

Returns the instance of the Gridster class.

add_resize_handle representing the widget.

(
  • $w
)
HTMLElement

Append the resize handle into a widget.

Parameters:

  • $wObject

Returns:

HTMLElement:

Returns instance of gridster Class.

add_style_tag

(
  • css
)
Object

Injects the given CSS as string to the head of the document.

Parameters:

  • cssString

    The styles to apply.

Returns:

Object:

Returns the instance of the Gridster class.

add_to_gridmap

(
  • grid_data
  • [value]
)
Gridster

Add a widget to the mapped array of positions.

Parameters:

  • grid_dataObject

    The grid coords object representing the cells to update in the mapped array.

  • [value]HTMLElement | Booleanoptional

    The value to set in the specified position .

Returns:

Gridster:

Returns the instance of the Gridster Class.

add_widget

(
  • html
  • [size_x]
  • [size_y]
  • [col]
  • [row]
  • [max_size]
  • [min_size]
  • [callback]
)
HTMLElement

Add a new widget to the grid.

Parameters:

  • htmlString | HTMLElement

    The string representing the HTML of the widget or the HTMLElement.

  • [size_x]Numberoptional

    The nº of rows the widget occupies horizontally.

  • [size_y]Numberoptional

    The nº of columns the widget occupies vertically.

  • [col]Numberoptional

    The column the widget should start in.

  • [row]Numberoptional

    The row the widget should start in.

  • [max_size]Arrayoptional

    max_size Maximun size (in units) for width and height.

  • [min_size]Arrayoptional

    min_size Minimum size (in units) for width and height.

  • [callback]Functionoptional

    Function executed after the widget is shown.

Returns:

HTMLElement:

Returns the jQuery wrapped HTMLElement representing. the widget that was just created.

can_go_player_up

(
  • widget_grid_data
)
Number | Boolean

Determines whether the player can move to a position above.

Parameters:

  • widget_grid_dataObject

    The actual grid coords object of the player.

Returns:

Number | Boolean:

If the player can be moved to an upper row returns the row number, else returns false.

can_go_up_to_row

(
  • widget_grid_data
  • col
  • row
)
Boolean | Number

Check if the widget can move to the specified row, else returns theupper row possible.

Parameters:

  • widget_grid_dataNumber

    The current grid coords object of the widget.

  • colNumber

    The target column.

  • rowNumber

    The target row.

Returns:

Boolean | Number:

Returns the row number if the widget can move to the target position, else returns false.

can_go_widget_up

(
  • widget_grid_data
)
Number | Boolean

Determines whether a widget can move to a position above.

Parameters:

  • widget_grid_dataObject

    The actual grid coords object of the widget we want to check.

Returns:

Number | Boolean:

If the widget can be moved to an upper row returns the row number, else returns false.

can_move_to

(
  • widget_grid_data
  • col
  • row
)
Boolean

Check if it's possible to move a widget to a specific col/row. It takesinto account the dimensions (size_y andsize_x attrs. of the grid coords object) the widget occupies.

Parameters:

  • widget_grid_dataObject

    The grid coords object that represents the widget.

  • colObject

    The col to check.

  • rowObject

    The row to check.

Returns:

Boolean:

Returns true if all cells are empty, else return false.

center_widgets

()

Centers widgets in grid

collapse_widget

(
  • $widget
  • [callback]
)
HTMLElement

Collapse the widget to it's pre-expanded size

Parameters:

  • $widgetHTMLElement

    The jQuery wrapped HTMLElement representing the widget.

  • [callback]Functionoptional

    Function executed when the widget is collapsed.

Returns:

HTMLElement:

Returns $widget.

destroy

(
  • remove
)
Object

Destroy this gridster by removing any sign of its presence, making it easy to avoid memory leaks

Parameters:

  • removeBoolean

    If true, remove gridster from DOM.

Returns:

Object:

Returns the instance of the Gridster class.

disable

()Gridster

Disables dragging.

Returns:

Gridster:

Returns the instance of the Gridster Class.

disable

()Gridster

Disables drag-and-drop widget resizing.

Returns:

Gridster:

Returns instance of gridster Class.

dom_to_coords

(
  • $widget
)

Convert widgets from DOM elements to "widget grid data" Objects.

Parameters:

  • $widgetHTMLElement

    The widget to be converted.

draggable

()Gridster

Make widgets draggable.

Returns:

Gridster:

Returns the instance of the Gridster Class.

empty_cells

(
  • col
  • row
  • size_x
  • size_y
  • [$exclude]
)
Class

Move down widgets in cells represented by the arguments col, row, size_x,size_y

Parameters:

  • colNumber

    The column where the group of cells begin.

  • rowNumber

    The row where the group of cells begin.

  • size_xNumber

    The number of columns that the group of cellsoccupy.

  • size_yNumber

    The number of rows that the group of cellsoccupy.

  • [$exclude]HTMLElementoptional

    Exclude widgets from being moved.

Returns:

Class:

Returns the instance of the Gridster Class.

empty_cells_player_occupies

()Gridster

Remove from the array of mapped positions the reference to the player.

Returns:

Gridster:

Returns the instance of the Gridster Class.

enable

()Gridster

Enables dragging.

Returns:

Gridster:

Returns the instance of the Gridster Class.

enable

()Gridster

Enables drag-and-drop widget resizing.

Returns:

Gridster:

Returns instance of gridster Class.

expand_widget

(
  • $widget
  • size_x
  • size_y
  • col
  • [callback]
)
HTMLElement

Expand the widget. Width is set to the current grid width.

Parameters:

  • $widgetHTMLElement

    The jQuery wrapped HTMLElement representing the widget.

  • size_xNumber

    The number of cols that will occupy the widget.

  • size_yNumber

    The number of rows that will occupy the widget.

  • colNumber

    The column to resize the widget from.

  • [callback]Functionoptional

    Function executed when the widget is expanded.

Returns:

HTMLElement:

Returns $widget.

fit_to_content

(
  • $widget
  • max_cols
  • max_rows
  • [callback]
)
HTMLElement

Fit the size of a widget to its content (best guess)

Parameters:

  • $widgetHTMLElement

    $widget The jQuery wrapped HTMLElement

  • max_colsNumber

    max number of columns a widget can take up

  • max_rowsNumber

    max number of rows a widget can take up

  • [callback]Functionoptional

    Function executed when the widget is fit to content.

Returns:

HTMLElement:

Returns $widget.

for_each_cell_occupied widget.

(
  • grid_data
  • callback
)
Gridster

Iterate over the cells occupied by a widget executing a function foreach one.

Parameters:

  • grid_dataObject
  • callbackFunction

    The function to execute on each column iteration. Column and row are passed as arguments.

Returns:

Gridster:

Returns the instance of the Gridster Class.

for_each_column_occupied

(
  • el_grid_data
  • callback
)
Gridster

Iterate over the columns occupied by a widget executing a function foreach one.

Parameters:

  • el_grid_dataObject

    The grid coords object that represents the widget.

  • callbackFunction

    The function to execute on each column iteration. The column number is passed as first argument.

Returns:

Gridster:

Returns the instance of the Gridster Class.

for_each_row_occupied

(
  • el_grid_data
  • callback
)
Gridster

Iterate over the rows occupied by a widget executing a function foreach one.

Parameters:

  • el_grid_dataObject

    The grid coords object that represents the widget.

  • callbackFunction

    The function to execute on each column iteration. The row number is passed as first argument.

Returns:

Gridster:

Returns the instance of the Gridster Class.

for_each_widget_above

(
  • col
  • row
  • callback
)
Gridster

Iterate over each widget above the column and row specified.

Parameters:

  • colNumber

    The column to start iterating.

  • rowNumber

    The row to start iterating.

  • callbackFunction

    The function to execute on each widget iteration. The value ofthis inside the function is the jQuery wrapped HTMLElement.

Returns:

Gridster:

Returns the instance of the Gridster Class.

for_each_widget_below

(
  • col
  • row
  • callback
)
Gridster

Iterate over each widget below the column and row specified.

Parameters:

  • colNumber

    The column to start iterating.

  • rowNumber

    The row to start iterating.

  • callbackFunction

    The function to execute on each widget iteration. The value ofthis inside the function is the jQuery wrapped HTMLElement.

Returns:

Gridster:

Returns the instance of the Gridster Class.

generate_faux_grid

(
  • rows
  • cols
)
Object

Generates a faux grid to collide with it when a widget is dragged anddetect row or column that we want to go.

Parameters:

  • rowsNumber

    Number of columns.

  • colsNumber

    Number of rows.

Returns:

Object:

Returns the instance of the Gridster class.

generate_grid_and_stylesheet

()Object

Calculate columns and rows to be set based on the configuration parameters, grid dimensions, etc ...

Returns:

Object:

Returns the instance of the Gridster class.

generate_stylesheet

(
  • [opts]
)
Object

It generates the necessary styles to position the widgets.

Parameters:

  • [opts]Objectoptional
    • set of gridster config options to generate stylessheets based on

Returns:

Object:

Returns the instance of the Gridster class.

get_cells_occupied

(
  • el_grid_data
)
Object

Get all columns and rows that a widget occupies.

Parameters:

  • el_grid_dataObject

    The grid coords object of the widget.

Returns:

Object:

Returns an object like{ cols: [], rows: []}.

get_highest_occupied_cell

()Object

Returns the highest occupied cell in the grid.

Returns:

Object:

Returns an object withcol androw numbers.

get_targeted_columns

(
  • [from_col]
)
Array

Given the leftmost column returns all columns that are overlapping with the player.

Parameters:

  • [from_col]Numberoptional

    The leftmost column.

Returns:

Array:

Returns an array with column numbers.

get_targeted_rows

(
  • [from_row]
)
Array

Given the upper row returns all rows that are overlapping with the player.

Parameters:

  • [from_row]Numberoptional

    The upper row.

Returns:

Array:

Returns an array with row numbers.

get_valid_rows

(
  • widget_grid_data
  • upper_rows
  • min_row
)
Number | Boolean

Search a valid row for the widget represented bywidget_grid_data' intheupper_rowsarray. Iteration starts from row specified inmin_row`.

Parameters:

  • widget_grid_dataObject

    The actual grid coords object of the player.

  • upper_rowsArray

    An array with columns as index and arrays of valid rows as values.

  • min_rowNumber

    The upper row from which the iteration will start.

Returns:

Number | Boolean:

Returns the upper row valid from theupper_rows for the widget in question.

get_widgets_from_DOM

()Object

Get all widgets in the DOM and register them.

Returns:

Object:

Returns the instance of the Gridster class.

get_widgets_overlapped

()JQuery

Get widgets overlapping with the player.

Returns:

JQuery:

Returns a jQuery collection of HTMLElements.

get_widgets_under_player

()HTMLElement

Get widgets overlapping with the player or with the object passedrepresenting the grid cells.

Returns:

HTMLElement:

Returns a jQuery collection of HTMLElements

is_empty

(
  • col
  • row
)
Boolean

Determines if the cell represented by col and row params is empty.

Parameters:

  • colNumber

    The column to check.

  • rowNumber

    The row to check.

Returns:

Boolean:

Returns true or false.

is_occupied

(
  • col
  • row
)
Boolean

Determines if the cell represented by col and row params is occupied.

Parameters:

  • colNumber

    The column to check.

  • rowNumber

    The row to check.

Returns:

Boolean:

Returns true or false.

is_placeholder_in

(
  • col
  • row
)
Boolean

Determines if the placeholder is currently over the row and col given.

Parameters:

  • colNumber

    The column to check.

  • rowNumber

    The row to check.

Returns:

Boolean:

Returns true or false.

is_placeholder_in_col

(
  • col
)
Boolean

Determines if the placeholder is currently over the column given.

Parameters:

  • colNumber

    The column to check.

Returns:

Boolean:

Returns true or false.

is_player

(
  • col_or_el
  • [row]
)
Boolean

Determines if there is a widget in the row and col given. Or if theHTMLElement passed as first argument is the player.

Parameters:

  • col_or_elNumber | HTMLElement

    A jQuery wrapped collection ofHTMLElements.

  • [row]Numberoptional

    The column to which we want to move the widgets.

Returns:

Boolean:

Returns true or false.

is_player_in

(
  • col
  • row
)
Boolean

Determines if the widget that is being dragged is currently over the rowand col given.

Parameters:

  • colNumber

    The column to check.

  • rowNumber

    The row to check.

Returns:

Boolean:

Returns true or false.

is_static

(
  • col
  • row
)
Boolean

Determines if widget is supposed to be static.WARNING: as of 0.6.6 this feature is buggy whenused with resizable widgets, as resizing widgetsabove and below a static widgit can cause it to move.This feature is considered experimental at this time

Parameters:

  • colNumber

    The column to check.

  • rowNumber

    The row to check.

Returns:

Boolean:

Returns true if widget exists and has static class,else returns false

is_widget

(
  • col
  • row
)
Boolean | HTMLElement

Determines if there is a widget in the cell represented by col/row params.

Parameters:

  • colNumber

    The column to check.

  • rowNumber

    The row to check.

Returns:

Boolean | HTMLElement:

Returns false if there is no widget,else returns the jQuery HTMLElement

is_widget_under_player

(
  • col
  • row
)
Boolean

Determines if there is a widget in the cell represented by col/rowparams and if this is under the widget that is being dragged.

Parameters:

  • colNumber

    The column to check.

  • rowNumber

    The row to check.

Returns:

Boolean:

Returns true or false.

manage_movements

(
  • $widgets
  • to_col
  • to_row
)
Gridster

Sorts an Array of grid coords objects (representing the grid coords ofeach widget) in descending way.

Depreciated.

Parameters:

  • $widgetsJQuery

    A jQuery collection of HTMLElements representing the widgets you want to move.

  • to_colNumber

    The column to which we want to move the widgets.

  • to_rowNumber

    The row to which we want to move the widgets.

Returns:

Gridster:

Returns the instance of the Gridster Class.

move_widget

(
  • $widget
  • new_col
  • new_row
  • callback
)
Gridster

Move a widget to a specific row and column.If the widget has widgets below, all of these widgets will be moved also

Parameters:

  • $widgetHTMLElement

    The jQuery wrapped HTMLElement of thewidget is going to be moved.

  • new_colNumber

    the column number to be set in widget

  • new_rowNumber

    the row number to be set in widget

  • callbackFunction

    is called when whole process is done.

Returns:

Gridster:

Returns the instance of the Gridster Class.

move_widget_down

(
  • $widget
  • y_units
)
Gridster

Move down the specified widget and all below it.

Parameters:

  • $widgetJQuery

    The jQuery object representing the widget you want to move.

  • y_unitsNumber

    The number of cells that the widget has to move.

Returns:

Gridster:

Returns the instance of the Gridster Class.

move_widget_to

(
  • $widget
  • row
)
Gridster

Move a widget to a specific row. The cell or cells must be empty.If the widget has widgets below, all of these widgets will be moved alsoif they can.

Parameters:

  • $widgetHTMLElement

    The jQuery wrapped HTMLElement of thewidget is going to be moved.

  • rowObject
    • row to move the widget to

Returns:

Gridster:

Returns the instance of the Gridster Class.

move_widget_up

(
  • $widget
  • [y_units]
)
Boolean

Move up the specified widget and all below it.

Parameters:

  • $widgetHTMLElement

    The widget you want to move.

  • [y_units]Numberoptional

    The number of cells that the widget has to move.

Returns:

Boolean:

Returns if the widget moved

mutate_widget_in_gridmap

(
  • $widget
  • wgd
  • new_wgd
)
HTMLElement

Mutate widget dimensions and position in the grid map.

Parameters:

  • $widgetHTMLElement

    The jQuery wrapped HTMLElement representing the widget to mutate.

  • wgdObject

    Current widget grid data (col, row, size_x, size_y).

  • new_wgdObject

    New widget grid data.

Returns:

HTMLElement:

Returns instance of gridster Class.

next_position

(
  • size_x
  • size_y
)
Object

Get the most left column below to add a new widget.

Parameters:

  • size_xNumber

    The nº of rows the widget occupies horizontally.

  • size_yNumber

    The nº of columns the widget occupies vertically.

Returns:

Object:

Returns a grid coords object representing the future widget coords.

on_drag

(
  • event
  • ui
)

This function is executed when the player is being dragged.

Parameters:

  • eventEvent

    The original browser event

  • uiObject

    A prepared ui object with useful drag-related data

on_overlapped_column_change

(
  • start_callback
  • stop_callback
)
Gridster

Executes the callbacks passed as arguments when a column begins to beoverlapped or stops being overlapped.

Parameters:

  • start_callbackFunction

    Function executed when a new column begins to be overlapped. The column is passed as first argument.

  • stop_callbackFunction

    Function executed when a column stops being overlapped. The column is passed as first argument.

Returns:

Gridster:

Returns the instance of the Gridster Class.

on_overlapped_row_change

(
  • start_callback
  • end_callback
)
Gridster

Executes the callbacks passed as arguments when a row starts to beoverlapped or stops being overlapped.

Parameters:

  • start_callbackFunction

    Function executed when a new row begins to be overlapped. The row is passed as first argument.

  • end_callbackFunction

    Function executed when a row stops being overlapped. The row is passed as first argument.

Returns:

Gridster:

Returns the instance of the Gridster Class.

on_resize

(
  • event
  • ui
)

This function is executed when a widget is being resized.

Parameters:

  • eventEvent

    The original browser event

  • uiObject

    A prepared ui object with useful drag-related data

on_start_drag

(
  • event
  • ui
)

This function is executed when the player begins to be dragged.

Parameters:

  • eventEvent

    The original browser event

  • uiObject

    A prepared ui object with useful drag-related data

on_start_overlapping_column

(
  • col
)
JQuery

This callback is executed when the player begins to collide with a column.

Parameters:

  • colNumber

    The collided column.

Returns:

JQuery:

Returns a jQuery collection of HTMLElements.

on_start_overlapping_row

(
  • row
)
JQuery

A callback executed when the player begins to collide with a row.

Parameters:

  • rowNumber

    The collided row.

Returns:

JQuery:

Returns a jQuery collection of HTMLElements.

on_start_resize

(
  • event
  • ui
)

This function is executed every time a widget starts to be resized.

Parameters:

  • eventEvent

    The original browser event

  • uiObject

    A prepared ui object with useful drag-related data

on_stop_drag

(
  • event
  • ui
)

This function is executed when the player stops being dragged.

Parameters:

  • eventEvent

    The original browser event

  • uiObject

    A prepared ui object with useful drag-related data

on_stop_overlapping_column

(
  • col
)
JQuery

A callback executed when the the player ends to collide with a column.

Parameters:

  • colNumber

    The collided row.

Returns:

JQuery:

Returns a jQuery collection of HTMLElements.

on_stop_overlapping_row

(
  • row
)
JQuery

This callback is executed when the player ends to collide with a row.

Parameters:

  • rowNumber

    The collided row.

Returns:

JQuery:

Returns a jQuery collection of HTMLElements.

on_stop_resize

(
  • event
  • ui
)

This function is executed every time a widget stops being resized.

Parameters:

  • eventEvent

    The original browser event

  • uiObject

    A prepared ui object with useful drag-related data

recalculate_faux_grid

()Object

Recalculates the offsets for the faux grid. You need to use it whenthe browser is resized.

Returns:

Object:

Returns the instance of the Gridster class.

register_widget

(
  • $el
)
Boolean

Creates the grid coords object representing the widget an add it to themapped array of positions.

Parameters:

  • $elHTMLElement | Object

    jQuery wrapped HTMLElement representing the widget, or an "widget grid data" Object with (col, row, el ...).

Returns:

Boolean:

Returns true if the widget final position is different than the original.

remove_all_widgets

(
  • callback
)
Gridster

Remove all widgets from the grid.

Parameters:

  • callbackFunction

    Function executed for each widget removed.

Returns:

Gridster:

Returns the instance of the Gridster Class.

remove_empty_cells

(
  • col
  • row
  • size_x
  • size_y
  • exclude
)
Gridster

Move up widgets below cells represented by the arguments col, row, size_x,size_y.

Parameters:

  • colNumber

    The column where the group of cells begin.

  • rowNumber

    The row where the group of cells begin.

  • size_xNumber

    The number of columns that the group of cellsoccupy.

  • size_yNumber

    The number of rows that the group of cellsoccupy.

  • excludeHTMLElement

    Exclude widgets from being moved.

Returns:

Gridster:

Returns the instance of the Gridster Class.

remove_from_gridmap

(
  • grid_data
)
Gridster

Remove a widget from the mapped array of positions.

Parameters:

  • grid_dataObject

    The grid coords object representing the cells to update in the mapped array.

Returns:

Gridster:

Returns the instance of the Gridster Class.

remove_style_tag

()Object

Remove the style tag with the associated id from the head of the document

Returns:

Object:

Returns the instance of the Gridster class.

remove_widget

(
  • el
  • [silent]
  • [callback]
)
Gridster

Remove a widget from the grid.

Parameters:

  • elHTMLElement

    The jQuery wrapped HTMLElement you want to remove.

  • [silent]Boolean | Functionoptional

    If true, widgets below the removed onewill not move up. If a Function is passed it will be used as callback.

  • [callback]Functionoptional

    Function executed after the widget is removed.

Returns:

Gridster:

Returns the instance of the Gridster Class.

resizable

()Gridster

Bind resize events to get resize working.

Returns:

Gridster:

Returns instance of gridster Class.

resize_widget

(
  • $widget
  • [size_x]
  • [size_y]
  • [callback]
)
HTMLElement

Change the size of a widget. Width is limited to the current grid width.

Parameters:

  • $widgetHTMLElement

    The jQuery wrapped HTMLElement representing the widget.

  • [size_x]Numberoptional

    The number of columns that will occupy the widget. By defaultsize_x is limited to the space available from the column where the widget begins, until the last column to the right.

  • [size_y]Numberoptional

    The number of rows that will occupy the widget.

  • [callback]Functionoptional

    Function executed when the widget is removed.

Returns:

HTMLElement:

Returns $widget.

resize_widget_dimensions

(
  • options
)
Gridster

Resize dimensions of widgets in grid based on given options

Parameters:

  • optionsObject

Returns:

serialize

(
  • [$widgets]
)
Array

Returns a serialized array of the widgets in the grid.

Parameters:

  • [$widgets]HTMLElementoptional

    The collection of jQuery wrapped HTMLElements you want to serialize. If no argument is passed all widgets will be serialized.

Returns:

Array:

Returns an Array of Objects with the data specified in the serialize_params option.

serialize_changed

()Array

Returns a serialized array of the widgets that have changed their position.

Returns:

Array:

Returns an Array of Objects with the data specified in the serialize_params option.

set_cells_player_occupies

(
  • col
  • col
  • row
)
Gridster

Update the array of mapped positions with the new player position.

Parameters:

  • colNumber

    The new player col.

  • colNumber

    The new player row.

  • rowObject

Returns:

Gridster:

Returns the instance of the Gridster Class.

set_dom_grid_height

()Object

Set the current height of the parent grid.

Returns:

Object:

Returns the instance of the Gridster class.

set_dom_grid_width

()Object

Set the current width of the parent grid.

Returns:

Object:

Returns the instance of the Gridster class.

set_placeholder

(
  • col
  • row
)
Gridster

Put placeholder at the row and column specified.

Parameters:

  • colNumber

    The column to which we want to move the placeholder.

  • rowNumber

    The row to which we want to move the placeholder.

Returns:

Gridster:

Returns the instance of the Gridster Class.

set_player

(
  • col
  • row
  • no_player
)
Object

Sets the current position of the player

Parameters:

  • colNumber
  • rowNumber
  • no_playerBoolean

Returns:

Object:

set_widget_max_size

(
  • $widget
  • max_size
)
Gridster

Change widget size limits.

Parameters:

  • $widgetHTMLElement | Number

    The jQuery wrapped HTMLElement representing the widget or an index representing the desired widget.

  • max_sizeArray

    Maximun size (in units) for width and height.

Returns:

Gridster:

Returns instance of gridster Class.

set_widget_min_size

(
  • $widget
  • min_size
)
Gridster

Change widget size limits.

Parameters:

  • $widgetHTMLElement | Number

    The jQuery wrapped HTMLElement representing the widget or an index representing the desired widget.

  • min_sizeArray

    Minimum size (in grid units) for width and height.

Returns:

Gridster:

Returns instance of gridster Class.

setup_resize

()Gridster

Setup things required for resizing. Like build templates for drag handles.

Returns:

Gridster:

Returns instance of gridster Class.

sort_by_col_asc

(
  • widgets
)
Array

Sorts an Array of grid coords objects by column (representing the gridcoords of each widget) in ascending way.

Parameters:

  • widgetsArray

    Array of grid coords objects

Returns:

Array:

Returns the array sorted.

sort_by_row_and_col_asc

(
  • widgets
)
Array

Sorts an Array of grid coords objects (representing the grid coords ofeach widget) placing first the empty cells upper left.

Parameters:

  • widgetsArray

    Array of grid coords objects

Returns:

Array:

Returns the array sorted.

sort_by_row_asc

(
  • widgets
)
Array

Sorts an Array of grid coords objects (representing the grid coords ofeach widget) in ascending way.

Parameters:

  • widgetsArray

    Array of grid coords objects

Returns:

Array:

Returns the array sorted.

sort_by_row_desc

(
  • widgets
)
Array

Sorts an Array of grid coords objects (representing the grid coords ofeach widget) in descending way.

Parameters:

  • widgetsArray

    Array of grid coords objects

Returns:

Array:

Returns the array sorted.

update_widget_dimensions

(
  • $widget
  • wgd
)
Gridster

Update the width and height for a widgets coordinate data.

Parameters:

  • $widgetHTMLElement

    The widget to update.

  • wgdObject

    wgd Current widget grid data (col, row, size_x, size_y).

Returns:

Gridster:

Returns the instance of the Gridster Class.

update_widget_position

(
  • grid_data
  • value
)
Gridster

Update in the mapped array of positions the value of cells represented bythe grid coords object passed in thegrid_data param.

Parameters:

  • grid_dataObject

    The grid coords object representing the cells to update in the mapped array.

  • valueHTMLElement | Boolean

    Passfalse or the jQuery wrapped HTMLElement, depends if you want to delete an existing position or add a new one.

Returns:

Gridster:

Returns the instance of the Gridster Class.

update_widgets_dimensions

()Gridster

Update dimensions for all widgets in the grid.

Returns:

Gridster:

Returns the instance of the Gridster Class.

widgets_below

(
  • $el
)
JQuery

Get widgets below a widget.

Parameters:

  • $elObject

    The jQuery wrapped HTMLElement.

Returns:

JQuery:

A jQuery collection of HTMLElements.

widgets_contraints

(
  • $widgets
)
Object

See which of the widgets in the $widgets param collection can go toa upper row and which not.

Parameters:

  • $widgetsJQuery

    A jQuery wrapped collection ofHTMLElements.

Returns:

Object:

Returns a literal Object with two keys:can_go_up &can_not_go_up. Each contains a set of HTMLElements.

[8]ページ先頭
©2009-2025 Movatter.jp