ok
Direktori : /home2/selectio/public_html/fms-worksuite/vendor/laravelcollective/html/src/ |
Current File : /home2/selectio/public_html/fms-worksuite/vendor/laravelcollective/html/src/HtmlBuilder.php |
<?php namespace Collective\Html; use BadMethodCallException; use Illuminate\Support\HtmlString; use Illuminate\Contracts\View\Factory; use Illuminate\Support\Traits\Macroable; use Illuminate\Contracts\Routing\UrlGenerator; class HtmlBuilder { use Macroable, Componentable { Macroable::__call as macroCall; Componentable::__call as componentCall; } /** * The URL generator instance. * * @var \Illuminate\Contracts\Routing\UrlGenerator */ protected $url; /** * The View Factory instance. * * @var \Illuminate\Contracts\View\Factory */ protected $view; /** * Create a new HTML builder instance. * * @param \Illuminate\Contracts\Routing\UrlGenerator $url * @param \Illuminate\Contracts\View\Factory $view */ public function __construct(UrlGenerator $url = null, Factory $view) { $this->url = $url; $this->view = $view; } /** * Convert an HTML string to entities. * * @param string $value * * @return string */ public function entities($value) { return htmlentities($value, ENT_QUOTES, 'UTF-8', false); } /** * Convert entities to HTML characters. * * @param string $value * * @return string */ public function decode($value) { return html_entity_decode($value, ENT_QUOTES, 'UTF-8'); } /** * Generate a link to a JavaScript file. * * @param string $url * @param array $attributes * @param bool $secure * * @return \Illuminate\Support\HtmlString */ public function script($url, $attributes = [], $secure = null) { $attributes['src'] = $this->url->asset($url, $secure); return $this->toHtmlString('<script' . $this->attributes($attributes) . '></script>'); } /** * Generate a link to a CSS file. * * @param string $url * @param array $attributes * @param bool $secure * * @return \Illuminate\Support\HtmlString */ public function style($url, $attributes = [], $secure = null) { $defaults = ['media' => 'all', 'type' => 'text/css', 'rel' => 'stylesheet']; $attributes = array_merge($defaults, $attributes); $attributes['href'] = $this->url->asset($url, $secure); return $this->toHtmlString('<link' . $this->attributes($attributes) . '>'); } /** * Generate an HTML image element. * * @param string $url * @param string $alt * @param array $attributes * @param bool $secure * * @return \Illuminate\Support\HtmlString */ public function image($url, $alt = null, $attributes = [], $secure = null) { $attributes['alt'] = $alt; return $this->toHtmlString('<img src="' . $this->url->asset($url, $secure) . '"' . $this->attributes($attributes) . '>'); } /** * Generate a link to a Favicon file. * * @param string $url * @param array $attributes * @param bool $secure * * @return \Illuminate\Support\HtmlString */ public function favicon($url, $attributes = [], $secure = null) { $defaults = ['rel' => 'shortcut icon', 'type' => 'image/x-icon']; $attributes = array_merge($defaults, $attributes); $attributes['href'] = $this->url->asset($url, $secure); return $this->toHtmlString('<link' . $this->attributes($attributes) . '>'); } /** * Generate a HTML link. * * @param string $url * @param string $title * @param array $attributes * @param bool $secure * @param bool $escape * * @return \Illuminate\Support\HtmlString */ public function link($url, $title = null, $attributes = [], $secure = null, $escape = true) { $url = $this->url->to($url, [], $secure); if (is_null($title) || $title === false) { $title = $url; } if ($escape) { $title = $this->entities($title); } return $this->toHtmlString('<a href="' . $this->entities($url) . '"' . $this->attributes($attributes) . '>' . $title . '</a>'); } /** * Generate a HTTPS HTML link. * * @param string $url * @param string $title * @param array $attributes * @param bool $escape * * @return \Illuminate\Support\HtmlString */ public function secureLink($url, $title = null, $attributes = [], $escape = true) { return $this->link($url, $title, $attributes, true, $escape); } /** * Generate a HTML link to an asset. * * @param string $url * @param string $title * @param array $attributes * @param bool $secure * @param bool $escape * * @return \Illuminate\Support\HtmlString */ public function linkAsset($url, $title = null, $attributes = [], $secure = null, $escape = true) { $url = $this->url->asset($url, $secure); return $this->link($url, $title ?: $url, $attributes, $secure, $escape); } /** * Generate a HTTPS HTML link to an asset. * * @param string $url * @param string $title * @param array $attributes * @param bool $escape * * @return \Illuminate\Support\HtmlString */ public function linkSecureAsset($url, $title = null, $attributes = [], $escape = true) { return $this->linkAsset($url, $title, $attributes, true, $escape); } /** * Generate a HTML link to a named route. * * @param string $name * @param string $title * @param array $parameters * @param array $attributes * @param bool $secure * @param bool $escape * * @return \Illuminate\Support\HtmlString */ public function linkRoute($name, $title = null, $parameters = [], $attributes = [], $secure = null, $escape = true) { return $this->link($this->url->route($name, $parameters), $title, $attributes, $secure, $escape); } /** * Generate a HTML link to a controller action. * * @param string $action * @param string $title * @param array $parameters * @param array $attributes * @param bool $secure * @param bool $escape * * @return \Illuminate\Support\HtmlString */ public function linkAction($action, $title = null, $parameters = [], $attributes = [], $secure = null, $escape = true) { return $this->link($this->url->action($action, $parameters), $title, $attributes, $secure, $escape); } /** * Generate a HTML link to an email address. * * @param string $email * @param string $title * @param array $attributes * @param bool $escape * * @return \Illuminate\Support\HtmlString */ public function mailto($email, $title = null, $attributes = [], $escape = true) { $email = $this->email($email); $title = $title ?: $email; if ($escape) { $title = $this->entities($title); } $email = $this->obfuscate('mailto:') . $email; return $this->toHtmlString('<a href="' . $email . '"' . $this->attributes($attributes) . '>' . $title . '</a>'); } /** * Obfuscate an e-mail address to prevent spam-bots from sniffing it. * * @param string $email * * @return string */ public function email($email) { return str_replace('@', '@', $this->obfuscate($email)); } /** * Generates non-breaking space entities based on number supplied. * * @param int $num * * @return string */ public function nbsp($num = 1) { return str_repeat(' ', $num); } /** * Generate an ordered list of items. * * @param array $list * @param array $attributes * * @return \Illuminate\Support\HtmlString|string */ public function ol($list, $attributes = []) { return $this->listing('ol', $list, $attributes); } /** * Generate an un-ordered list of items. * * @param array $list * @param array $attributes * * @return \Illuminate\Support\HtmlString|string */ public function ul($list, $attributes = []) { return $this->listing('ul', $list, $attributes); } /** * Generate a description list of items. * * @param array $list * @param array $attributes * * @return \Illuminate\Support\HtmlString */ public function dl(array $list, array $attributes = []) { $attributes = $this->attributes($attributes); $html = "<dl{$attributes}>"; foreach ($list as $key => $value) { $value = (array) $value; $html .= "<dt>$key</dt>"; foreach ($value as $v_key => $v_value) { $html .= "<dd>$v_value</dd>"; } } $html .= '</dl>'; return $this->toHtmlString($html); } /** * Create a listing HTML element. * * @param string $type * @param array $list * @param array $attributes * * @return \Illuminate\Support\HtmlString|string */ protected function listing($type, $list, $attributes = []) { $html = ''; if (count($list) === 0) { return $html; } // Essentially we will just spin through the list and build the list of the HTML // elements from the array. We will also handled nested lists in case that is // present in the array. Then we will build out the final listing elements. foreach ($list as $key => $value) { $html .= $this->listingElement($key, $type, $value); } $attributes = $this->attributes($attributes); return $this->toHtmlString("<{$type}{$attributes}>{$html}</{$type}>"); } /** * Create the HTML for a listing element. * * @param mixed $key * @param string $type * @param mixed $value * * @return string */ protected function listingElement($key, $type, $value) { if (is_array($value)) { return $this->nestedListing($key, $type, $value); } else { return '<li>' . e($value, false) . '</li>'; } } /** * Create the HTML for a nested listing attribute. * * @param mixed $key * @param string $type * @param mixed $value * * @return string */ protected function nestedListing($key, $type, $value) { if (is_int($key)) { return $this->listing($type, $value); } else { return '<li>' . $key . $this->listing($type, $value) . '</li>'; } } /** * Build an HTML attribute string from an array. * * @param array $attributes * * @return string */ public function attributes($attributes) { $html = []; foreach ((array) $attributes as $key => $value) { $element = $this->attributeElement($key, $value); if (! is_null($element)) { $html[] = $element; } } return count($html) > 0 ? ' ' . implode(' ', $html) : ''; } /** * Build a single attribute element. * * @param string $key * @param string $value * * @return string */ protected function attributeElement($key, $value) { // For numeric keys we will assume that the value is a boolean attribute // where the presence of the attribute represents a true value and the // absence represents a false value. // This will convert HTML attributes such as "required" to a correct // form instead of using incorrect numerics. if (is_numeric($key)) { return $value; } // Treat boolean attributes as HTML properties if (is_bool($value) && $key !== 'value') { return $value ? $key : ''; } if (is_array($value) && $key === 'class') { return 'class="' . implode(' ', $value) . '"'; } if (! is_null($value)) { return $key . '="' . e($value, false) . '"'; } } /** * Obfuscate a string to prevent spam-bots from sniffing it. * * @param string $value * * @return string */ public function obfuscate($value) { $safe = ''; foreach (str_split($value) as $letter) { if (ord($letter) > 128) { return $letter; } // To properly obfuscate the value, we will randomly convert each letter to // its entity or hexadecimal representation, keeping a bot from sniffing // the randomly obfuscated letters out of the string on the responses. switch (rand(1, 3)) { case 1: $safe .= '&#' . ord($letter) . ';'; break; case 2: $safe .= '&#x' . dechex(ord($letter)) . ';'; break; case 3: $safe .= $letter; } } return $safe; } /** * Generate a meta tag. * * @param string $name * @param string $content * @param array $attributes * * @return \Illuminate\Support\HtmlString */ public function meta($name, $content, array $attributes = []) { $defaults = compact('name', 'content'); $attributes = array_merge($defaults, $attributes); return $this->toHtmlString('<meta' . $this->attributes($attributes) . '>'); } /** * Generate an html tag. * * @param string $tag * @param mixed $content * @param array $attributes * * @return \Illuminate\Support\HtmlString */ public function tag($tag, $content, array $attributes = []) { $content = is_array($content) ? implode('', $content) : $content; return $this->toHtmlString('<' . $tag . $this->attributes($attributes) . '>' . $this->toHtmlString($content) . '</' . $tag . '>'); } /** * Transform the string to an Html serializable object * * @param $html * * @return \Illuminate\Support\HtmlString */ protected function toHtmlString($html) { return new HtmlString($html); } /** * Dynamically handle calls to the class. * * @param string $method * @param array $parameters * * @return \Illuminate\Contracts\View\View|mixed * * @throws \BadMethodCallException */ public function __call($method, $parameters) { if (static::hasComponent($method)) { return $this->componentCall($method, $parameters); } if (static::hasMacro($method)) { return $this->macroCall($method, $parameters); } throw new BadMethodCallException("Method {$method} does not exist."); } }