%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* This file is part of the Nette Framework (https://nette.org)
* Copyright (c) 2004 David Grudl (https://davidgrudl.com)
*/
declare(strict_types=1);
namespace Nette\Forms;
use Nette;
use Nette\Utils\Html;
use Nette\Utils\Strings;
/**
* Forms helpers.
*/
class Helpers
{
use Nette\StaticClass;
private const UnsafeNames = [
'attributes', 'children', 'elements', 'focus', 'length', 'reset', 'style', 'submit', 'onsubmit', 'form',
'presenter', 'action',
];
/**
* Extracts and sanitizes submitted form data for single control.
* @param int $type type Form::DataText, DataLine, DataFile, DataKeys
* @return string|string[]
* @internal
*/
public static function extractHttpData(array $data, string $htmlName, int $type)
{
$name = explode('[', str_replace(['[]', ']', '.'], ['', '', '_'], $htmlName));
$data = Nette\Utils\Arrays::get($data, $name, null);
$itype = $type & ~Form::DataKeys;
if (substr($htmlName, -2) === '[]') {
if (!is_array($data)) {
return [];
}
foreach ($data as $k => $v) {
$data[$k] = $v = static::sanitize($itype, $v);
if ($v === null) {
unset($data[$k]);
}
}
if ($type & Form::DataKeys) {
return $data;
}
return array_values($data);
} else {
return static::sanitize($itype, $data);
}
}
private static function sanitize(int $type, $value)
{
if ($type === Form::DataText) {
return is_scalar($value)
? Strings::normalizeNewLines($value)
: null;
} elseif ($type === Form::DataLine) {
return is_scalar($value)
? Strings::trim(strtr((string) $value, "\r\n", ' '))
: null;
} elseif ($type === Form::DataFile) {
return $value instanceof Nette\Http\FileUpload ? $value : null;
} else {
throw new Nette\InvalidArgumentException('Unknown data type');
}
}
/**
* Converts control name to HTML name.
*/
public static function generateHtmlName(string $id): string
{
$name = str_replace(Nette\ComponentModel\IComponent::NAME_SEPARATOR, '][', $id, $count);
if ($count) {
$name = substr_replace($name, '', strpos($name, ']'), 1) . ']';
}
if (is_numeric($name) || in_array($name, self::UnsafeNames, true)) {
$name = '_' . $name;
}
return $name;
}
public static function exportRules(Rules $rules): array
{
$payload = [];
foreach ($rules as $rule) {
if (!$rule->canExport()) {
if ($rule->branch) {
continue;
}
break;
}
$op = $rule->validator;
if (!is_string($op)) {
$op = Nette\Utils\Callback::toString($op);
}
if ($rule->branch) {
$item = [
'op' => ($rule->isNegative ? '~' : '') . $op,
'rules' => static::exportRules($rule->branch),
'control' => $rule->control->getHtmlName(),
];
if ($rule->branch->getToggles()) {
$item['toggle'] = $rule->branch->getToggles();
} elseif (!$item['rules']) {
continue;
}
} else {
$msg = Validator::formatMessage($rule, false);
if ($msg instanceof Nette\HtmlStringable) {
$msg = html_entity_decode(strip_tags((string) $msg), ENT_QUOTES | ENT_HTML5, 'UTF-8');
}
$item = ['op' => ($rule->isNegative ? '~' : '') . $op, 'msg' => $msg];
}
if (is_array($rule->arg)) {
$item['arg'] = [];
foreach ($rule->arg as $key => $value) {
$item['arg'][$key] = $value instanceof Control
? ['control' => $value->getHtmlName()]
: $value;
}
} elseif ($rule->arg !== null) {
$item['arg'] = $rule->arg instanceof Control
? ['control' => $rule->arg->getHtmlName()]
: $rule->arg;
}
$payload[] = $item;
}
return $payload;
}
public static function createInputList(
array $items,
?array $inputAttrs = null,
?array $labelAttrs = null,
$wrapper = null
): string
{
[$inputAttrs, $inputTag] = self::prepareAttrs($inputAttrs, 'input');
[$labelAttrs, $labelTag] = self::prepareAttrs($labelAttrs, 'label');
$res = '';
$input = Html::el();
$label = Html::el();
[$wrapper, $wrapperEnd] = $wrapper instanceof Html ? [$wrapper->startTag(), $wrapper->endTag()] : [(string) $wrapper, ''];
foreach ($items as $value => $caption) {
foreach ($inputAttrs as $k => $v) {
$input->attrs[$k] = $v[$value] ?? null;
}
foreach ($labelAttrs as $k => $v) {
$label->attrs[$k] = $v[$value] ?? null;
}
$input->value = $value;
$res .= ($res === '' && $wrapperEnd === '' ? '' : $wrapper)
. $labelTag . $label->attributes() . '>'
. $inputTag . $input->attributes() . (isset(Html::$xhtml) && Html::$xhtml ? ' />' : '>')
. ($caption instanceof Nette\HtmlStringable ? $caption : htmlspecialchars((string) $caption, ENT_NOQUOTES, 'UTF-8'))
. '</label>'
. $wrapperEnd;
}
return $res;
}
public static function createSelectBox(array $items, ?array $optionAttrs = null, $selected = null): Html
{
if ($selected !== null) {
$optionAttrs['selected?'] = $selected;
}
[$optionAttrs, $optionTag] = self::prepareAttrs($optionAttrs, 'option');
$option = Html::el();
$res = $tmp = '';
foreach ($items as $group => $subitems) {
if (is_array($subitems)) {
$res .= Html::el('optgroup')->label($group)->startTag();
$tmp = '</optgroup>';
} else {
$subitems = [$group => $subitems];
}
foreach ($subitems as $value => $caption) {
$option->value = $value;
foreach ($optionAttrs as $k => $v) {
$option->attrs[$k] = $v[$value] ?? null;
}
if ($caption instanceof Html) {
$caption = clone $caption;
$res .= $caption->setName('option')->addAttributes($option->attrs);
} else {
$res .= $optionTag . $option->attributes() . '>'
. htmlspecialchars((string) $caption, ENT_NOQUOTES, 'UTF-8')
. '</option>';
}
if ($selected === $value) {
unset($optionAttrs['selected'], $option->attrs['selected']);
}
}
$res .= $tmp;
$tmp = '';
}
return Html::el('select')->setHtml($res);
}
private static function prepareAttrs(?array $attrs, string $name): array
{
$dynamic = [];
foreach ((array) $attrs as $k => $v) {
if ($k[-1] === '?' || $k[-1] === ':') {
$p = substr($k, 0, -1);
unset($attrs[$k], $attrs[$p]);
if ($k[-1] === '?') {
$dynamic[$p] = array_fill_keys((array) $v, true);
} elseif (is_array($v) && $v) {
$dynamic[$p] = $v;
} else {
$attrs[$p] = $v;
}
}
}
return [$dynamic, '<' . $name . Html::el(null, $attrs)->attributes()];
}
/** @internal */
public static function iniGetSize(string $name): int
{
$value = ini_get($name);
$units = ['k' => 10, 'm' => 20, 'g' => 30];
return isset($units[$ch = strtolower(substr($value, -1))])
? (int) $value << $units[$ch]
: (int) $value;
}
/** @internal */
public static function getSingleType($reflection): ?string
{
$type = Nette\Utils\Type::fromReflection($reflection);
if (!$type) {
return null;
} elseif ($res = $type->getSingleName()) {
return $res;
} else {
throw new Nette\InvalidStateException(
Nette\Utils\Reflection::toString($reflection) . " has unsupported type '$type'."
);
}
}
}
Zerion Mini Shell 1.0