- md5
- c43a4393b3cecc924d9262dc0f9a9c5b
- sha1
- bb9e72d589628570fbd893114e21ec2251b24875
- sha256
- 512046ef98cab1df46157f0c5221968bc8ec5dd541ae373ae9e8d47e62d4ff3d
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2016 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\HTML\Helpers;
use Joomla\CMS\Factory;
use Joomla\CMS\Session\Session;
// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* 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 = [];
/**
* 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 155 releases, Joomla 5.0.0-alpha1 to 6.2.1-rc1. See them all, or every version of this file.