-
Notifications
You must be signed in to change notification settings - Fork 3.4k
/
IdGeneratorTrait.php
89 lines (79 loc) · 2.24 KB
/
IdGeneratorTrait.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
<?php
/**
* CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
* Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
*
* Licensed under The MIT License
* For full copyright and license information, please see the LICENSE.txt
* Redistributions of files must retain the above copyright notice.
*
* @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
* @link https://cakephp.org CakePHP(tm) Project
* @since 3.0.0
* @license https://opensource.org/licenses/mit-license.php MIT License
*/
namespace Cake\View\Helper;
use Cake\Utility\Text;
/**
* A trait that provides id generating methods to be
* used in various widget classes.
*/
trait IdGeneratorTrait
{
/**
* Prefix for id attribute.
*
* @var string|null
*/
protected $_idPrefix;
/**
* A list of id suffixes used in the current rendering.
*
* @var array
*/
protected $_idSuffixes = [];
/**
* Clear the stored ID suffixes.
*
* @return void
*/
protected function _clearIds()
{
$this->_idSuffixes = [];
}
/**
* Generate an ID attribute for an element.
*
* Ensures that id's for a given set of fields are unique.
*
* @param string $name The ID attribute name.
* @param string $val The ID attribute value.
* @return string Generated id.
*/
protected function _id($name, $val)
{
$name = $this->_domId($name);
$idSuffix = mb_strtolower(str_replace(['/', '@', '<', '>', ' ', '"', '\''], '-', $val));
$count = 1;
$check = $idSuffix;
while (in_array($check, $this->_idSuffixes)) {
$check = $idSuffix . $count++;
}
$this->_idSuffixes[] = $check;
return trim($name . '-' . $check, '-');
}
/**
* Generate an ID suitable for use in an ID attribute.
*
* @param string $value The value to convert into an ID.
* @return string The generated id.
*/
protected function _domId($value)
{
$domId = mb_strtolower(Text::slug($value, '-'));
if ($this->_idPrefix) {
$domId = $this->_idPrefix . '-' . $domId;
}
return $domId;
}
}