mirror of
https://github.com/kamilwylegala/cakephp2-php8.git
synced 2024-11-15 11:28:25 +00:00
676 lines
No EOL
16 KiB
PHP
676 lines
No EOL
16 KiB
PHP
<?php
|
|
/* SVN FILE: $Id$ */
|
|
/**
|
|
* Javascript Generator class file.
|
|
*
|
|
* PHP versions 4 and 5
|
|
*
|
|
* CakePHP : Rapid Development Framework (http://www.cakephp.org)
|
|
* Copyright 2006-2008, Cake Software Foundation, Inc.
|
|
*
|
|
* Licensed under The MIT License
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @filesource
|
|
* @copyright Copyright 2006-2008, Cake Software Foundation, Inc.
|
|
* @link http://www.cakefoundation.org/projects/info/cakephp CakePHP Project
|
|
* @package cake
|
|
* @subpackage cake.cake.libs.view.helpers
|
|
* @since CakePHP v 1.2
|
|
* @version $Revision$
|
|
* @modifiedby $LastChangedBy$
|
|
* @lastmodified $Date$
|
|
* @license http://www.opensource.org/licenses/mit-license.php The MIT License
|
|
*/
|
|
/**
|
|
* Javascript Generator helper class for easy use of JavaScript.
|
|
*
|
|
* JsHelper provides an abstract interface for authoring JavaScript with a
|
|
* given client-side library.
|
|
*
|
|
* @package cake
|
|
* @subpackage cake.cake.libs.view.helpers
|
|
*/
|
|
class JsHelper extends AppHelper {
|
|
/**
|
|
* Base URL
|
|
*
|
|
* @var string
|
|
*/
|
|
var $base = null;
|
|
/**
|
|
* Webroot path
|
|
*
|
|
* @var string
|
|
*/
|
|
var $webroot = null;
|
|
/**
|
|
* Theme name
|
|
*
|
|
* @var string
|
|
*/
|
|
var $themeWeb = null;
|
|
/**
|
|
* URL to current action.
|
|
*
|
|
* @var string
|
|
*/
|
|
var $here = null;
|
|
/**
|
|
* Parameter array.
|
|
*
|
|
* @var array
|
|
*/
|
|
var $params = array();
|
|
/**
|
|
* Current action.
|
|
*
|
|
* @var string
|
|
*/
|
|
var $action = null;
|
|
/**
|
|
* Plugin path
|
|
*
|
|
* @var string
|
|
*/
|
|
var $plugin = null;
|
|
/**
|
|
* POST data for models
|
|
*
|
|
* @var array
|
|
*/
|
|
var $data = null;
|
|
/**
|
|
* helpers
|
|
*
|
|
* @var array
|
|
**/
|
|
var $helpers = array();
|
|
/**
|
|
* HTML tags used by this helper.
|
|
*
|
|
* @var array
|
|
* @access public
|
|
*/
|
|
var $tags = array(
|
|
'javascriptblock' => '<script type="text/javascript">%s</script>',
|
|
'javascriptstart' => '<script type="text/javascript">',
|
|
'javascriptlink' => '<script type="text/javascript" src="%s"></script>',
|
|
'javascriptend' => '</script>'
|
|
);
|
|
/**
|
|
* Current Javascript Engine that is being used
|
|
*
|
|
* @var string
|
|
* @access private
|
|
**/
|
|
var $__engineName;
|
|
/**
|
|
* Scripts that have already been included once, prevents duplicate script insertion
|
|
*
|
|
* @var array
|
|
* @access private
|
|
**/
|
|
var $__includedScripts = array();
|
|
/**
|
|
* __objects
|
|
*
|
|
* @var array
|
|
*/
|
|
var $__objects = array();
|
|
/**
|
|
* output
|
|
*
|
|
* @var string
|
|
*/
|
|
var $output = false;
|
|
/**
|
|
* Constructor - determines engine helper
|
|
*
|
|
* @param array $settings Settings array contains name of engine helper.
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function __construct($settings = array()) {
|
|
$className = 'jquery';
|
|
if (is_array($settings) && isset($settings[0])) {
|
|
$className = $settings[0];
|
|
} elseif (is_string($settings)) {
|
|
$className = $settings;
|
|
}
|
|
$engineName = $className;
|
|
if (strpos($className, '.') !== false) {
|
|
list($plugin, $className) = explode('.', $className);
|
|
}
|
|
$this->__engineName = $className . 'Engine';
|
|
$engineClass = $engineName . 'Engine';
|
|
$this->helpers = array($engineClass);
|
|
parent::__construct();
|
|
}
|
|
/**
|
|
* call__
|
|
*
|
|
* @param string $method Method to be called
|
|
* @param array $params Parameters for the method being called.
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function call__($method, $params) {
|
|
if (isset($this->{$this->__engineName}) && method_exists($this->{$this->__engineName}, $method)) {
|
|
return $this->{$this->__engineName}->dispatchMethod($method, $params);
|
|
}
|
|
if (method_exists($this, $method . '_')) {
|
|
return $this->dispatchMethod($method . '_', $params);
|
|
}
|
|
trigger_error(sprintf(__('JsHelper:: Missing Method %s is undefined', true), $method), E_USER_WARNING);
|
|
}
|
|
/**
|
|
* Returns one or many <script> tags depending on the number of scripts given.
|
|
*
|
|
* If the filename is prefixed with "/", the path will be relative to the base path of your
|
|
* application. Otherwise, the path will be relative to your JavaScript path, usually webroot/js.
|
|
*
|
|
* Can include one or many Javascript files. If there are .min.js or .pack.js files
|
|
* and your debug level == 0 these files will be used instead of the non min/pack files.
|
|
*
|
|
* @param mixed $url String or array of javascript files to include
|
|
* @param boolean $inline Whether script should be output inline or into scripts_for_layout.
|
|
* @param boolean $once Whether or not the script should be checked for uniqueness. If true scripts will only be
|
|
* included once, use false to allow the same script to be included more than once per request.
|
|
* @return mixed
|
|
**/
|
|
function uses($url, $inline = true, $once = true) {
|
|
if (is_array($url)) {
|
|
$out = '';
|
|
foreach ($url as $i) {
|
|
$out .= "\n\t" . $this->uses($i, $inline);
|
|
}
|
|
if ($inline) {
|
|
return $out . "\n";
|
|
}
|
|
return;
|
|
}
|
|
|
|
if ($once && isset($this->__includedScripts[$url])) {
|
|
return null;
|
|
}
|
|
$this->__includedScripts[$url] = true;
|
|
|
|
if (strpos($url, '://') === false) {
|
|
if ($url[0] !== '/') {
|
|
$url = JS_URL . $url;
|
|
}
|
|
$url = $this->webroot($url);
|
|
|
|
if (strpos($url, '?') === false) {
|
|
if (Configure::read('debug') == 0) {
|
|
$suffixes = array('.min.js', '.pack.js');
|
|
foreach ($suffixes as $suffix) {
|
|
if (file_exists(WWW_ROOT . $url . $suffix)) {
|
|
$url .= $suffix;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
if (strpos($url, '.js') === false) {
|
|
$url .= '.js';
|
|
}
|
|
}
|
|
|
|
$timestampEnabled = (
|
|
(Configure::read('Asset.timestamp') === true && Configure::read() > 0) ||
|
|
Configure::read('Asset.timestamp') === 'force'
|
|
);
|
|
|
|
if (strpos($url, '?') === false && $timestampEnabled) {
|
|
$url .= '?' . @filemtime(WWW_ROOT . str_replace('/', DS, $url));
|
|
}
|
|
|
|
if (Configure::read('Asset.filter.js')) {
|
|
$url = str_replace(JS_URL, 'cjs/', $url);
|
|
}
|
|
}
|
|
$out = $this->output(sprintf($this->tags['javascriptlink'], $url));
|
|
|
|
if ($inline) {
|
|
return $out;
|
|
} else {
|
|
$view =& ClassRegistry::getObject('view');
|
|
$view->addScript($out);
|
|
}
|
|
}
|
|
/**
|
|
* Loads a remote URL
|
|
*
|
|
* @param string $url
|
|
* @param array $options
|
|
* @return string
|
|
*/
|
|
function load_($url = null, $options = array()) {
|
|
if (isset($options['update'])) {
|
|
if (!is_array($options['update'])) {
|
|
$func = "new Ajax.Updater('{$options['update']}',";
|
|
} else {
|
|
$func = "new Ajax.Updater(document.createElement('div'),";
|
|
}
|
|
if (!isset($options['requestHeaders'])) {
|
|
$options['requestHeaders'] = array();
|
|
}
|
|
if (is_array($options['update'])) {
|
|
$options['update'] = join(' ', $options['update']);
|
|
}
|
|
$options['requestHeaders']['X-Update'] = $options['update'];
|
|
} else {
|
|
$func = "new Ajax.Request(";
|
|
}
|
|
|
|
$func .= "'" . Router::url($url) . "'";
|
|
$ajax =& new AjaxHelper();
|
|
$func .= ", " . $ajax->__optionsForAjax($options) . ")";
|
|
|
|
if (isset($options['before'])) {
|
|
$func = "{$options['before']}; $func";
|
|
}
|
|
if (isset($options['after'])) {
|
|
$func = "$func; {$options['after']};";
|
|
}
|
|
if (isset($options['condition'])) {
|
|
$func = "if ({$options['condition']}) { $func; }";
|
|
}
|
|
if (isset($options['confirm'])) {
|
|
$func = "if (confirm('" . $this->Javascript->escapeString($options['confirm'])
|
|
. "')) { $func; } else { return false; }";
|
|
}
|
|
return $func;
|
|
}
|
|
|
|
|
|
/* function get__($name) {
|
|
return $this->__object($name, 'id');
|
|
}
|
|
*/
|
|
function select($pattern) {
|
|
return $this->__object($pattern, 'pattern');
|
|
}
|
|
|
|
function real($var) {
|
|
return $this->__object($var, 'real');
|
|
}
|
|
|
|
function __object($name, $var) {
|
|
if (!isset($this->__objects[$name])) {
|
|
$this->__objects[$name] = new JsHelperObject($this);
|
|
$this->__objects[$name]->{$var} = $name;
|
|
}
|
|
return $this->__objects[$name];
|
|
}
|
|
|
|
}
|
|
|
|
/**
|
|
* JsEngineBaseClass
|
|
*
|
|
* Abstract Base Class for All JsEngines to extend. Provides generic methods.
|
|
*
|
|
* @package cake.view.helpers
|
|
*/
|
|
class JsBaseEngineHelper extends AppHelper {
|
|
/**
|
|
* Determines whether native JSON extension is used for encoding. Set by object constructor.
|
|
*
|
|
* @var boolean
|
|
* @access public
|
|
*/
|
|
var $useNative = false;
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @return void
|
|
**/
|
|
function __construct() {
|
|
$this->useNative = function_exists('json_encode');
|
|
}
|
|
/**
|
|
* Create an alert message in Javascript
|
|
*
|
|
* @param string $message Message you want to alter.
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function alert($message) {
|
|
return 'alert("' . $this->escape($message) . '");';
|
|
}
|
|
/**
|
|
* Redirects to a URL
|
|
*
|
|
* @param mixed $url
|
|
* @param array $options
|
|
* @return string
|
|
*/
|
|
function redirect($url = null) {
|
|
return 'window.location = "' . Router::url($url) . '";';
|
|
}
|
|
/**
|
|
* Create a confirm() message
|
|
*
|
|
* @param string $message Message you want confirmed.
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function confirm($message) {
|
|
return 'confirm("' . $this->escape($message) . '");';
|
|
}
|
|
/**
|
|
* Create a prompt() Javascript function
|
|
*
|
|
* @param string $message Message you want to prompt.
|
|
* @param string $default Default message
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
function prompt($message, $default = '') {
|
|
return 'prompt("' . $this->escape($message) . '", "' . $this->escape($default) . '");';
|
|
}
|
|
/**
|
|
* Generates a JavaScript object in JavaScript Object Notation (JSON)
|
|
* from an array. Will use native JSON encode method if available, and $useNative == true
|
|
*
|
|
* Options:
|
|
*
|
|
* - prefix - String prepended to the returned data.
|
|
* - postfix - String appended to the returned data.
|
|
* - stringKeys - A list of array keys to be treated as a string
|
|
* - quoteKeys - If false treats $options['stringKeys'] as a list of keys **not** to be quoted.
|
|
* - q - Type of quote to use.
|
|
*
|
|
* @param array $data Data to be converted.
|
|
* @param array $options Set of options, see above.
|
|
* @return string A JSON code block
|
|
*/
|
|
function object($data = array(), $options = array()) {
|
|
$defaultOptions = array(
|
|
'block' => false, 'prefix' => '', 'postfix' => '',
|
|
'stringKeys' => array(), 'quoteKeys' => true, 'q' => '"'
|
|
);
|
|
$options = array_merge($defaultOptions, $options);
|
|
|
|
if (is_object($data)) {
|
|
$data = get_object_vars($data);
|
|
}
|
|
|
|
$out = $keys = array();
|
|
$numeric = true;
|
|
|
|
if ($this->useNative) {
|
|
$rt = json_encode($data);
|
|
} else {
|
|
if (is_array($data)) {
|
|
$keys = array_keys($data);
|
|
}
|
|
|
|
if (!empty($keys)) {
|
|
$numeric = (array_values($keys) === array_keys(array_values($keys)));
|
|
}
|
|
|
|
foreach ($data as $key => $val) {
|
|
if (is_array($val) || is_object($val)) {
|
|
$val = $this->object($val, array_merge($options, array('block' => false)));
|
|
} else {
|
|
$quoteStrings = (
|
|
!count($options['stringKeys']) ||
|
|
($options['quoteKeys'] && in_array($key, $options['stringKeys'], true)) ||
|
|
(!$options['quoteKeys'] && !in_array($key, $options['stringKeys'], true))
|
|
);
|
|
$val = $this->value($val, $quoteStrings);
|
|
}
|
|
if (!$numeric) {
|
|
$val = $options['q'] . $this->value($key, false) . $options['q'] . ':' . $val;
|
|
}
|
|
$out[] = $val;
|
|
}
|
|
|
|
if (!$numeric) {
|
|
$rt = '{' . join(',', $out) . '}';
|
|
} else {
|
|
$rt = '[' . join(',', $out) . ']';
|
|
}
|
|
}
|
|
$rt = $options['prefix'] . $rt . $options['postfix'];
|
|
|
|
if ($options['block']) {
|
|
$rt = $this->codeBlock($rt, array_diff_key($options, $defaultOptions));
|
|
}
|
|
return $rt;
|
|
}
|
|
/**
|
|
* Converts a PHP-native variable of any type to a JSON-equivalent representation
|
|
*
|
|
* @param mixed $val A PHP variable to be converted to JSON
|
|
* @param boolean $quoteStrings If false, leaves string values unquoted
|
|
* @return string a JavaScript-safe/JSON representation of $val
|
|
*/
|
|
function value($val, $quoteStrings = true) {
|
|
switch (true) {
|
|
case (is_array($val) || is_object($val)):
|
|
$val = $this->object($val);
|
|
break;
|
|
case ($val === null):
|
|
$val = 'null';
|
|
break;
|
|
case (is_bool($val)):
|
|
$val = ($val === true) ? 'true' : 'false';
|
|
break;
|
|
case (is_int($val)):
|
|
$val = $val;
|
|
break;
|
|
case (is_float($val)):
|
|
$val = sprintf("%.11f", $val);
|
|
break;
|
|
default:
|
|
$val = $this->escape($val);
|
|
if ($quoteStrings) {
|
|
$val = '"' . $val . '"';
|
|
}
|
|
break;
|
|
}
|
|
return $val;
|
|
}
|
|
/**
|
|
* Escape a string to be JavaScript friendly.
|
|
*
|
|
* List of escaped ellements:
|
|
* + "\r\n" => '\n'
|
|
* + "\r" => '\n'
|
|
* + "\n" => '\n'
|
|
* + '"' => '\"'
|
|
* + "'" => "\\'"
|
|
*
|
|
* @param string $script String that needs to get escaped.
|
|
* @return string Escaped string.
|
|
*/
|
|
function escape($string) {
|
|
$escape = array("\r\n" => '\n', "\r" => '\n', "\n" => '\n', '"' => '\"', "'" => "\\'");
|
|
return str_replace(array_keys($escape), array_values($escape), $string);
|
|
}
|
|
|
|
}
|
|
|
|
|
|
class JsHelperObject {
|
|
var $__parent = null;
|
|
|
|
var $id = null;
|
|
|
|
var $pattern = null;
|
|
|
|
var $real = null;
|
|
|
|
function __construct(&$parent) {
|
|
if (is_object($parent)) {
|
|
$this->setParent($parent);
|
|
}
|
|
}
|
|
|
|
function toString() {
|
|
return $this->__toString();
|
|
}
|
|
|
|
function __toString() {
|
|
return $this->literal;
|
|
}
|
|
|
|
function ref($ref = null) {
|
|
if ($ref == null) {
|
|
foreach (array('id', 'pattern', 'real') as $ref) {
|
|
if ($this->{$ref} !== null) {
|
|
return $this->{$ref};
|
|
}
|
|
}
|
|
} else {
|
|
return ($this->{$ref} !== null);
|
|
}
|
|
return null;
|
|
}
|
|
|
|
function literal($append = null) {
|
|
if (!empty($this->id)) {
|
|
$data = '$("' . $this->id . '")';
|
|
}
|
|
if (!empty($this->pattern)) {
|
|
$data = '$$("' . $this->pattern . '")';
|
|
}
|
|
if (!empty($this->real)) {
|
|
$data = $this->real;
|
|
}
|
|
if (!empty($append)) {
|
|
$data .= '.' . $append;
|
|
}
|
|
return $data;
|
|
}
|
|
|
|
function __call($name, $args) {
|
|
$data = '';
|
|
|
|
if (isset($this->__parent->effectMap[strtolower($name)])) {
|
|
array_unshift($args, $this->__parent->effectMap[strtolower($name)]);
|
|
$name = 'effect';
|
|
}
|
|
|
|
switch ($name) {
|
|
case 'effect':
|
|
case 'visualEffect':
|
|
|
|
if (strpos($args[0], '_') || $args[0]{0} != strtoupper($args[0]{0})) {
|
|
$args[0] = Inflector::camelize($args[0]);
|
|
}
|
|
|
|
if (strtolower($args[0]) == 'highlight') {
|
|
$data .= 'new ';
|
|
}
|
|
if ($this->pattern == null) {
|
|
$data .= 'Effect.' . $args[0] . '(' . $this->literal();
|
|
} else {
|
|
$data .= 'Effect.' . $args[0] . '(item';
|
|
}
|
|
|
|
if (isset($args[1]) && is_array($args[1])) {
|
|
$data .= ', {' . $this->__options($args[1]) . '}';
|
|
}
|
|
$data .= ');';
|
|
|
|
if ($this->pattern !== null) {
|
|
$data = $this->each($data);
|
|
}
|
|
break;
|
|
case 'remove':
|
|
case 'toggle':
|
|
case 'show':
|
|
case 'hide':
|
|
if (empty($args)) {
|
|
$obj = 'Element';
|
|
$params = '';
|
|
} else {
|
|
$obj = 'Effect';
|
|
$params = ', "' . $args[0] . '"';
|
|
}
|
|
|
|
if ($this->pattern != null) {
|
|
$data = $this->each($obj . ".{$name}(item);");
|
|
} else {
|
|
$data = $obj . ".{$name}(" . $this->literal() . ');';
|
|
}
|
|
break;
|
|
case 'visible':
|
|
$data = $this->literal() . '.visible();';
|
|
break;
|
|
case 'update':
|
|
$data = $this->literal() . ".update({$args[0]});";
|
|
break;
|
|
case 'load':
|
|
$data = 'new Ajax.Updater("' . $this->id . '", "' . $args[0] . '"';
|
|
if (isset($args[1]) && is_array($args[1])) {
|
|
$data .= ', {' . $this->__options($args[1]) . '}';
|
|
}
|
|
$data .= ');';
|
|
break;
|
|
case 'each':
|
|
case 'all':
|
|
case 'any':
|
|
case 'detect':
|
|
case 'findAll':
|
|
if ($this->pattern != null) {
|
|
$data = $this->__iterate($name, $args[0]);
|
|
}
|
|
break;
|
|
case 'addClass':
|
|
case 'removeClass':
|
|
case 'hasClass':
|
|
case 'toggleClass':
|
|
$data = $this->literal() . ".{$name}Name(\"{$args[0]}\");";
|
|
break;
|
|
case 'clone':
|
|
case 'inspect':
|
|
case 'keys':
|
|
case 'values':
|
|
$data = "Object.{$name}(" . $this->literal() . ");";
|
|
break;
|
|
case 'extend':
|
|
$data = "Object.extend(" . $this->literal() . ", {$args[0]});";
|
|
break;
|
|
case '...':
|
|
// Handle other methods here
|
|
// including interfaces to load other files on-the-fly
|
|
// that add support for additional methods/replacing existing methods
|
|
break;
|
|
default:
|
|
$data = $this->literal() . '.' . $name . '();';
|
|
break;
|
|
}
|
|
|
|
if ($this->__parent->output) {
|
|
echo $data;
|
|
} else {
|
|
return $data;
|
|
}
|
|
}
|
|
|
|
function __iterate($method, $data) {
|
|
return '$$("' . $this->pattern . '").' . $method . '(function(item) {' . $data . '});';
|
|
}
|
|
|
|
function setParent(&$parent) {
|
|
$this->__parent =& $parent;
|
|
}
|
|
|
|
function __options($opts) {
|
|
$options = array();
|
|
foreach ($opts as $key => $val) {
|
|
if (!is_int($val)) {
|
|
$val = '"' . $val . '"';
|
|
}
|
|
$options[] = $key . ':' . $val;
|
|
}
|
|
return join(', ', $options);
|
|
}
|
|
}
|
|
?>
|