- md5
- 93eacee4dc250b081f06c76c3cd0949e
- sha1
- ac1a50334bc77f8676d2b619fd8591a11d3cd985
- sha256
- 3b912a9dda8935cb78b9960094b8d4c655e123acb81680e12e9b816f131559ad
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
<?php
/**
* Joomla! Content Management System
*
* @copyright Copyright (C) 2005 - 2020 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\HTML\Helpers;
defined('JPATH_PLATFORM') or die;
use Joomla\CMS\Factory;
use Joomla\CMS\Session\Session;
/**
* HTML utility class for creating a sortable table list
*
* @since 4.0.0
*/
abstract class DraggableList
{
/**
* Array containing information for loaded files
*
* @var array
* @since 4.0.0
*/
protected static $loaded = array();
/**
* Method to load the Dragula script and make table sortable
*
* @param string $tableId DOM id of the table
* @param string $formId DOM id of the form
* @param string $sortDir Sort direction
* @param string $saveOrderingUrl Save ordering url, ajax-load after an item dropped
* @param string $redundant Not used
* @param boolean $nestedList Set whether the list is a nested list
*
* @return void
*
* @since 4.0.0
*/
public static function draggable(string $tableId = '', string $formId = '', string $sortDir = 'asc', string $saveOrderingUrl = '',
$redundant = null, bool $nestedList = false
)
{
// Only load once
if (isset(static::$loaded[__METHOD__]))
{
return;
}
$doc = Factory::getDocument();
// Please consider using data attributes instead of passing arguments here!
if (!empty($tableId) && !empty($saveOrderingUrl) && !empty($formId) && !empty($sortDir))
{
$doc->addScriptOptions(
'draggable-list',
[
'id' => '#' . $tableId . ' tbody',
'formId' => $formId,
'direction' => $sortDir,
'url' => $saveOrderingUrl . '&' . Session::getFormToken() . '=1',
'nested' => $nestedList,
]
);
}
$doc->getWebAssetManager()
->usePreset('dragula')
->useScript('joomla.draggable');
// Set static array
static::$loaded[__METHOD__] = true;
}
}
The same content is in 5 releases, Joomla 4.0.0-beta to 4.0.0-beta5. See them all, or every version of this file.