Edit File by line

<?php

[0] Fix | Delete

[1] Fix | Delete

namespace Nextend\Framework\View;

[2] Fix | Delete

[3] Fix | Delete

use Nextend\Framework\Platform\Platform;

[4] Fix | Delete

use Nextend\Framework\Settings;

[5] Fix | Delete

[6] Fix | Delete

class Html {

[7] Fix | Delete

[8] Fix | Delete

private static $closeSingleTags = true;

[9] Fix | Delete

[10] Fix | Delete

/**

[11] Fix | Delete

* @var boolean whether to render special attributes value. Defaults to true. Can be set to false for HTML5.

[12] Fix | Delete

* @since 1.1.13

[13] Fix | Delete

[14] Fix | Delete

private static $renderSpecialAttributesValue = true;

[15] Fix | Delete

[16] Fix | Delete

/**

[17] Fix | Delete

* Generates an HTML element.

[18] Fix | Delete

[19] Fix | Delete

* @param string $tag the tag name

[20] Fix | Delete

* @param array $htmlOptions the element attributes. The values will be HTML-encoded using

[21] Fix | Delete

* {@link encodeAttribute()}. If an 'encode' attribute is given and its value is false,

[22] Fix | Delete

* the rest of the attribute values will NOT be HTML-encoded. Since version 1.1.5,

[23] Fix | Delete

* attributes whose value is null will not be rendered.

[24] Fix | Delete

* @param mixed $content the content to be enclosed between open and close element tags. It will not be

[25] Fix | Delete

* HTML-encoded. If false, it means there is no body content.

[26] Fix | Delete

* @param boolean $closeTag whether to generate the close tag.

[27] Fix | Delete

[28] Fix | Delete

* @return string the generated HTML element tag

[29] Fix | Delete

[30] Fix | Delete

public static function tag($tag, $htmlOptions = array(), $content = "", $closeTag = true) {

[31] Fix | Delete

$html = '<' . $tag . self::renderAttributes($htmlOptions);

[32] Fix | Delete

if ($content === false) return $closeTag && self::$closeSingleTags ? $html . ' />' : $html . '>'; else

[33] Fix | Delete

return $closeTag ? $html . '>' . $content . '</' . $tag . '>' : $html . '>' . $content;

[34] Fix | Delete

}

[35] Fix | Delete

[36] Fix | Delete

/**

[37] Fix | Delete

* Generates an open HTML element.

[38] Fix | Delete

[39] Fix | Delete

* @param string $tag the tag name

[40] Fix | Delete

* @param array $htmlOptions the element attributes. The values will be HTML-encoded using

[41] Fix | Delete

* {@link encodeAttribute()}.

[42] Fix | Delete

* If an 'encode' attribute is given and its value is false,

[43] Fix | Delete

* the rest of the attribute values will NOT be HTML-encoded.

[44] Fix | Delete

* Since version 1.1.5, attributes whose value is null will not be rendered.

[45] Fix | Delete

[46] Fix | Delete

* @return string the generated HTML element tag

[47] Fix | Delete

[48] Fix | Delete

public static function openTag($tag, $htmlOptions = array()) {

[49] Fix | Delete

return '<' . $tag . self::renderAttributes($htmlOptions) . '>';

[50] Fix | Delete

}

[51] Fix | Delete

[52] Fix | Delete

/**

[53] Fix | Delete

* Generates a close HTML element.

[54] Fix | Delete

[55] Fix | Delete

* @param string $tag the tag name

[56] Fix | Delete

[57] Fix | Delete

* @return string the generated HTML element tag

[58] Fix | Delete

[59] Fix | Delete

public static function closeTag($tag) {

[60] Fix | Delete

return '</' . $tag . '>';

[61] Fix | Delete

}

[62] Fix | Delete

[63] Fix | Delete

/**

[64] Fix | Delete

* Generates an image tag.

[65] Fix | Delete

[66] Fix | Delete

* @param string $src the image URL

[67] Fix | Delete

* @param string $alt the alternative text display

[68] Fix | Delete

* @param array $htmlOptions additional HTML attributes (see {@link tag}).

[69] Fix | Delete

[70] Fix | Delete

* @return string the generated image tag

[71] Fix | Delete

[72] Fix | Delete

public static function image($src, $alt = '', $htmlOptions = array()) {

[73] Fix | Delete

$htmlOptions['src'] = $src;

[74] Fix | Delete

$htmlOptions['alt'] = $alt;

[75] Fix | Delete

[76] Fix | Delete

return self::tag('img', $htmlOptions, false, false);

[77] Fix | Delete

}

[78] Fix | Delete

[79] Fix | Delete

/**

[80] Fix | Delete

* Renders the HTML tag attributes.

[81] Fix | Delete

* Since version 1.1.5, attributes whose value is null will not be rendered.

[82] Fix | Delete

* Special attributes, such as 'checked', 'disabled', 'readonly', will be rendered

[83] Fix | Delete

* properly based on their corresponding boolean value.

[84] Fix | Delete

[85] Fix | Delete

* @param array $htmlOptions attributes to be rendered

[86] Fix | Delete

[87] Fix | Delete

* @return string the rendering result

[88] Fix | Delete

[89] Fix | Delete

public static function renderAttributes($htmlOptions = array()) {

[90] Fix | Delete

static $specialAttributes = array(

[91] Fix | Delete

'autofocus' => 1,

[92] Fix | Delete

'autoplay' => 1,

[93] Fix | Delete

'controls' => 1,

[94] Fix | Delete

'declare' => 1,

[95] Fix | Delete

'default' => 1,

[96] Fix | Delete

'disabled' => 1,

[97] Fix | Delete

'ismap' => 1,

[98] Fix | Delete

'loop' => 1,

[99] Fix | Delete

'muted' => 1,

[100] Fix | Delete

'playsinline' => 1,

[101] Fix | Delete

'webkit-playsinline' => 1,

[102] Fix | Delete

'nohref' => 1,

[103] Fix | Delete

'noresize' => 1,

[104] Fix | Delete

'novalidate' => 1,

[105] Fix | Delete

'open' => 1,

[106] Fix | Delete

'reversed' => 1,

[107] Fix | Delete

'scoped' => 1,

[108] Fix | Delete

'seamless' => 1,

[109] Fix | Delete

'selected' => 1,

[110] Fix | Delete

'typemustmatch' => 1,

[111] Fix | Delete

'lazyload' => 1,

[112] Fix | Delete

), $specialAttributesNoValue = array(

[113] Fix | Delete

'defer' => 1,

[114] Fix | Delete

'async' => 1

[115] Fix | Delete

);

[116] Fix | Delete

[117] Fix | Delete

if (empty($htmlOptions)) {

[118] Fix | Delete

return '';

[119] Fix | Delete

}

[120] Fix | Delete

[121] Fix | Delete

if (isset($htmlOptions['style']) && empty($htmlOptions['style'])) {

[122] Fix | Delete

unset($htmlOptions['style']);

[123] Fix | Delete

}

[124] Fix | Delete

[125] Fix | Delete

$html = '';

[126] Fix | Delete

if (isset($htmlOptions['encode'])) {

[127] Fix | Delete

$raw = !$htmlOptions['encode'];

[128] Fix | Delete

unset($htmlOptions['encode']);

[129] Fix | Delete

} else

[130] Fix | Delete

$raw = false;

[131] Fix | Delete

[132] Fix | Delete

foreach ($htmlOptions as $name => $value) {

[133] Fix | Delete

if (isset($specialAttributes[$name])) {

[134] Fix | Delete

if ($value) {

[135] Fix | Delete

$html .= ' ' . $name;

[136] Fix | Delete

if (self::$renderSpecialAttributesValue) $html .= '="' . $name . '"';

[137] Fix | Delete

}

[138] Fix | Delete

} else if (isset($specialAttributesNoValue[$name])) {

[139] Fix | Delete

$html .= ' ' . $name;

[140] Fix | Delete

} else if ($value !== null) $html .= ' ' . $name . '="' . ($raw ? $value : self::encodeAttribute($value)) . '"';

[141] Fix | Delete

}

[142] Fix | Delete

[143] Fix | Delete

return $html;

[144] Fix | Delete

}

[145] Fix | Delete

[146] Fix | Delete

/**

[147] Fix | Delete

* @param $text

[148] Fix | Delete

[149] Fix | Delete

* @return string

[150] Fix | Delete

[151] Fix | Delete

public static function encode($text) {

[152] Fix | Delete

return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');

[153] Fix | Delete

}

[154] Fix | Delete

[155] Fix | Delete

/**

[156] Fix | Delete

* @param $text

[157] Fix | Delete

[158] Fix | Delete

* @return string

[159] Fix | Delete

[160] Fix | Delete

public static function encodeAttribute($text) {

[161] Fix | Delete

[162] Fix | Delete

/**

[163] Fix | Delete

* Do not encode: '

[164] Fix | Delete

[165] Fix | Delete

return htmlspecialchars($text, ENT_COMPAT | ENT_HTML5, 'UTF-8');

[166] Fix | Delete

}

[167] Fix | Delete

[168] Fix | Delete

public static function link($name, $url = '#', $htmlOptions = array()) {

[169] Fix | Delete

$htmlOptions["href"] = $url;

[170] Fix | Delete

[171] Fix | Delete

$url = self::openTag("a", $htmlOptions);

[172] Fix | Delete

if (isset($htmlOptions["encode"]) && $htmlOptions["encode"]) {

[173] Fix | Delete

$url .= self::encode($name);

[174] Fix | Delete

} else {

[175] Fix | Delete

$url .= $name;

[176] Fix | Delete

}

[177] Fix | Delete

[178] Fix | Delete

$url .= self::closeTag("a");

[179] Fix | Delete

[180] Fix | Delete

return $url;

[181] Fix | Delete

}

[182] Fix | Delete

[183] Fix | Delete

/**

[184] Fix | Delete

* Insert stylesheet

[185] Fix | Delete

[186] Fix | Delete

* @param string $script

[187] Fix | Delete

* @param bool $file

[188] Fix | Delete

* @param array $scriptOptions

[189] Fix | Delete

[190] Fix | Delete

* @return string

[191] Fix | Delete

[192] Fix | Delete

public static function style($script, $file = false, $scriptOptions = array()) {

[193] Fix | Delete

if ($file) {

[194] Fix | Delete

$options = array(

[195] Fix | Delete

"rel" => "stylesheet",

[196] Fix | Delete

"type" => "text/css",

[197] Fix | Delete

"href" => $script

[198] Fix | Delete

);

[199] Fix | Delete

$options = array_merge($options, $scriptOptions);

[200] Fix | Delete

[201] Fix | Delete

return self::tag('link', $options, false, false);

[202] Fix | Delete

}

[203] Fix | Delete

[204] Fix | Delete

return self::tag("style", $scriptOptions, $script);

[205] Fix | Delete

}

[206] Fix | Delete

[207] Fix | Delete

/**

[208] Fix | Delete

* Insert script

[209] Fix | Delete

[210] Fix | Delete

* @param string $script

[211] Fix | Delete

[212] Fix | Delete

* @return string

[213] Fix | Delete

[214] Fix | Delete

public static function script($script) {

[215] Fix | Delete

[216] Fix | Delete

return self::tag('script', array(

[217] Fix | Delete

'encode' => false

[218] Fix | Delete

), $script);

[219] Fix | Delete

}

[220] Fix | Delete

[221] Fix | Delete

public static function scriptFile($script, $attributes = array()) {

[222] Fix | Delete

return self::tag('script', array(

[223] Fix | Delete

'src' => $script

[224] Fix | Delete

) + self::getScriptAttributes() + $attributes, '');

[225] Fix | Delete

}

[226] Fix | Delete

[227] Fix | Delete

private static function getScriptAttributes() {

[228] Fix | Delete

static $attributes = null;

[229] Fix | Delete

[230] Fix | Delete

if (Platform::isAdmin()) {

[231] Fix | Delete

return array();

[232] Fix | Delete

}

[233] Fix | Delete

[234] Fix | Delete

if ($attributes === null) {

[235] Fix | Delete

if (class_exists('\\Nextend\\Framework\\Settings', false)) {

[236] Fix | Delete

$value = trim(html_entity_decode(strip_tags(Settings::get('scriptattributes', ''))));

[237] Fix | Delete

$_attributes = explode(' ', str_replace(array(

[238] Fix | Delete

'\'',

[239] Fix | Delete

"\""

[240] Fix | Delete

), "", str_replace(array(

[241] Fix | Delete

"onload",

[242] Fix | Delete

"onerror"

[243] Fix | Delete

), "not-allowed", $value)));

[244] Fix | Delete

if (!empty($value) && !empty($_attributes)) {

[245] Fix | Delete

foreach ($_attributes as $attr) {

[246] Fix | Delete

if (strpos($attr, '=') !== false) {

[247] Fix | Delete

$atts = explode("=", $attr);

[248] Fix | Delete

if (count($atts) <= 2) {

[249] Fix | Delete

$attributes[$atts[0]] = $atts[1];

[250] Fix | Delete

} else {

[251] Fix | Delete

$attributes[$attr] = $attr;

[252] Fix | Delete

}

[253] Fix | Delete

} else {

[254] Fix | Delete

$attributes[$attr] = $attr;

[255] Fix | Delete

}

[256] Fix | Delete

}

[257] Fix | Delete

} else {

[258] Fix | Delete

$attributes = array();

[259] Fix | Delete

}

[260] Fix | Delete

} else {

[261] Fix | Delete

return array();

[262] Fix | Delete

}

[263] Fix | Delete

}

[264] Fix | Delete

[265] Fix | Delete

return $attributes;

[266] Fix | Delete

}

[267] Fix | Delete

[268] Fix | Delete

/**

[269] Fix | Delete

* @param array $array1

[270] Fix | Delete

* @param array $array2 [optional]

[271] Fix | Delete

* @param array $_ [optional]

[272] Fix | Delete

[273] Fix | Delete

* @return array the resulting array.

[274] Fix | Delete

* @since 4.0

[275] Fix | Delete

* @since 5.0

[276] Fix | Delete

[277] Fix | Delete

public static function mergeAttributes($array1, $array2 = null, $_ = null) {

[278] Fix | Delete

$arguments = func_get_args();

[279] Fix | Delete

$target = array_shift($arguments);

[280] Fix | Delete

foreach ($arguments as $array) {

[281] Fix | Delete

if (isset($array['style'])) {

[282] Fix | Delete

if (!isset($target['style'])) $target['style'] = '';

[283] Fix | Delete

$target['style'] .= $array['style'];

[284] Fix | Delete

unset($array['style']);

[285] Fix | Delete

}

[286] Fix | Delete

if (isset($array['class'])) {

[287] Fix | Delete

if (empty($target['class'])) {

[288] Fix | Delete

$target['class'] = $array['class'];

[289] Fix | Delete

} else {

[290] Fix | Delete

$target['class'] .= ' ' . $array['class'];

[291] Fix | Delete

}

[292] Fix | Delete

unset($array['class']);

[293] Fix | Delete

}

[294] Fix | Delete

[295] Fix | Delete

$target = array_merge($target, $array);

[296] Fix | Delete

}

[297] Fix | Delete

[298] Fix | Delete

return $target;

[299] Fix | Delete

}

[300] Fix | Delete

[301] Fix | Delete

public static function addExcludeLazyLoadAttributes($target = array()) {

[302] Fix | Delete

[303] Fix | Delete

return self::mergeAttributes($target, self::getExcludeLazyLoadAttributes());

[304] Fix | Delete

}

[305] Fix | Delete

[306] Fix | Delete

public static function getExcludeLazyLoadAttributes() {

[307] Fix | Delete

static $attrs;

[308] Fix | Delete

if ($attrs === null) {

[309] Fix | Delete

$attrs = array(

[310] Fix | Delete

'class' => 'skip-lazy',

[311] Fix | Delete

'data-skip-lazy' => 1

[312] Fix | Delete

);

[313] Fix | Delete

[314] Fix | Delete

if (defined('JETPACK__VERSION')) {

[315] Fix | Delete

$attrs['class'] .= ' jetpack-lazy-image';

[316] Fix | Delete

}

[317] Fix | Delete

[318] Fix | Delete

if (defined('PERFMATTERS_VERSION')) {

[319] Fix | Delete

$attrs['class'] .= ' no-lazy';

[320] Fix | Delete

}

[321] Fix | Delete

}

[322] Fix | Delete

[323] Fix | Delete

return $attrs;

[324] Fix | Delete

}

[325] Fix | Delete

}

[326] Fix | Delete