Fieldset.php 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259
  1. <?php
  2. /**
  3. * Copyright © Magento, Inc. All rights reserved.
  4. * See COPYING.txt for license details.
  5. */
  6. /**
  7. * Config form fieldset renderer
  8. */
  9. namespace Magento\Config\Block\System\Config\Form;
  10. use Magento\Framework\Data\Form\Element\AbstractElement;
  11. /**
  12. * @api
  13. * @since 100.0.2
  14. */
  15. class Fieldset extends \Magento\Backend\Block\AbstractBlock implements
  16. \Magento\Framework\Data\Form\Element\Renderer\RendererInterface
  17. {
  18. /**
  19. * @var \Magento\Backend\Model\Auth\Session
  20. */
  21. protected $_authSession;
  22. /**
  23. * @var \Magento\Framework\View\Helper\Js
  24. */
  25. protected $_jsHelper;
  26. /**
  27. * Whether is collapsed by default
  28. *
  29. * @var bool
  30. */
  31. protected $isCollapsedDefault = false;
  32. /**
  33. * @param \Magento\Backend\Block\Context $context
  34. * @param \Magento\Backend\Model\Auth\Session $authSession
  35. * @param \Magento\Framework\View\Helper\Js $jsHelper
  36. * @param array $data
  37. */
  38. public function __construct(
  39. \Magento\Backend\Block\Context $context,
  40. \Magento\Backend\Model\Auth\Session $authSession,
  41. \Magento\Framework\View\Helper\Js $jsHelper,
  42. array $data = []
  43. ) {
  44. $this->_jsHelper = $jsHelper;
  45. $this->_authSession = $authSession;
  46. parent::__construct($context, $data);
  47. }
  48. /**
  49. * Render fieldset html
  50. *
  51. * @param AbstractElement $element
  52. * @return string
  53. */
  54. public function render(AbstractElement $element)
  55. {
  56. $this->setElement($element);
  57. $header = $this->_getHeaderHtml($element);
  58. $elements = $this->_getChildrenElementsHtml($element);
  59. $footer = $this->_getFooterHtml($element);
  60. return $header . $elements . $footer;
  61. }
  62. /**
  63. * @param AbstractElement $element
  64. * @return string
  65. * @since 100.1.0
  66. */
  67. protected function _getChildrenElementsHtml(AbstractElement $element)
  68. {
  69. $elements = '';
  70. foreach ($element->getElements() as $field) {
  71. if ($field instanceof \Magento\Framework\Data\Form\Element\Fieldset) {
  72. $elements .= '<tr id="row_' . $field->getHtmlId() . '">'
  73. . '<td colspan="4">' . $field->toHtml() . '</td></tr>';
  74. } else {
  75. $elements .= $field->toHtml();
  76. }
  77. }
  78. return $elements;
  79. }
  80. /**
  81. * Return header html for fieldset
  82. *
  83. * @param AbstractElement $element
  84. * @return string
  85. */
  86. protected function _getHeaderHtml($element)
  87. {
  88. if ($element->getIsNested()) {
  89. $html = '<tr class="nested"><td colspan="4"><div class="' . $this->_getFrontendClass($element) . '">';
  90. } else {
  91. $html = '<div class="' . $this->_getFrontendClass($element) . '">';
  92. }
  93. $html .= '<div class="entry-edit-head admin__collapsible-block">' .
  94. '<span id="' .
  95. $element->getHtmlId() .
  96. '-link" class="entry-edit-head-link"></span>';
  97. $html .= $this->_getHeaderTitleHtml($element);
  98. $html .= '</div>';
  99. $html .= '<input id="' .
  100. $element->getHtmlId() .
  101. '-state" name="config_state[' .
  102. $element->getId() .
  103. ']" type="hidden" value="' .
  104. (int)$this->_isCollapseState(
  105. $element
  106. ) . '" />';
  107. $html .= '<fieldset class="' . $this->_getFieldsetCss() . '" id="' . $element->getHtmlId() . '">';
  108. $html .= '<legend>' . $element->getLegend() . '</legend>';
  109. $html .= $this->_getHeaderCommentHtml($element);
  110. // field label column
  111. $html .= '<table cellspacing="0" class="form-list"><colgroup class="label" /><colgroup class="value" />';
  112. if ($this->getRequest()->getParam('website') || $this->getRequest()->getParam('store')) {
  113. $html .= '<colgroup class="use-default" />';
  114. }
  115. $html .= '<colgroup class="scope-label" /><colgroup class="" /><tbody>';
  116. return $html;
  117. }
  118. /**
  119. * Get frontend class
  120. *
  121. * @param AbstractElement $element
  122. * @return string
  123. */
  124. protected function _getFrontendClass($element)
  125. {
  126. $group = $element->getGroup();
  127. $cssClass = isset($group['fieldset_css']) ? $group['fieldset_css'] : '';
  128. return 'section-config' . (empty($cssClass) ? '' : ' ' . $cssClass);
  129. }
  130. /**
  131. * Return header title part of html for fieldset
  132. *
  133. * @param AbstractElement $element
  134. * @return string
  135. */
  136. protected function _getHeaderTitleHtml($element)
  137. {
  138. return '<a id="' .
  139. $element->getHtmlId() .
  140. '-head" href="#' .
  141. $element->getHtmlId() .
  142. '-link" onclick="Fieldset.toggleCollapse(\'' .
  143. $element->getHtmlId() .
  144. '\', \'' .
  145. $this->getUrl(
  146. '*/*/state'
  147. ) . '\'); return false;">' . $element->getLegend() . '</a>';
  148. }
  149. /**
  150. * Return header comment part of html for fieldset
  151. *
  152. * @param AbstractElement $element
  153. * @return string
  154. */
  155. protected function _getHeaderCommentHtml($element)
  156. {
  157. return $element->getComment() ? '<div class="comment">' . $element->getComment() . '</div>' : '';
  158. }
  159. /**
  160. * Return full css class name for form fieldset
  161. *
  162. * @return string
  163. */
  164. protected function _getFieldsetCss()
  165. {
  166. /** @var \Magento\Config\Model\Config\Structure\Element\Group $group */
  167. $group = $this->getGroup();
  168. $configCss = $group->getFieldsetCss();
  169. return 'config admin__collapsible-block' . ($configCss ? ' ' . $configCss : '');
  170. }
  171. /**
  172. * Return footer html for fieldset
  173. * Add extra tooltip comments to elements
  174. *
  175. * @param AbstractElement $element
  176. * @return string
  177. */
  178. protected function _getFooterHtml($element)
  179. {
  180. $html = '</tbody></table>';
  181. foreach ($element->getElements() as $field) {
  182. if ($field->getTooltip()) {
  183. $html .= sprintf(
  184. '<div id="row_%s_comment" class="system-tooltip-box" style="display:none;">%s</div>',
  185. $field->getId(),
  186. $field->getTooltip()
  187. );
  188. }
  189. }
  190. $html .= '</fieldset>' . $this->_getExtraJs($element);
  191. if ($element->getIsNested()) {
  192. $html .= '</td></tr>';
  193. } else {
  194. $html .= '</div>';
  195. }
  196. return $html;
  197. }
  198. /**
  199. * Return js code for fieldset:
  200. * - observe fieldset rows;
  201. * - apply collapse;
  202. *
  203. * @param AbstractElement $element
  204. * @return string
  205. */
  206. protected function _getExtraJs($element)
  207. {
  208. $htmlId = $element->getHtmlId();
  209. $output = "require(['prototype'], function(){Fieldset.applyCollapse('{$htmlId}');});";
  210. return $this->_jsHelper->getScript($output);
  211. }
  212. /**
  213. * Collapsed or expanded fieldset when page loaded?
  214. *
  215. * @param AbstractElement $element
  216. * @return bool
  217. */
  218. protected function _isCollapseState($element)
  219. {
  220. if ($element->getExpanded() ||
  221. ($element->getForm() && $element->getForm()->getElements()->count() === 1)
  222. ) {
  223. return true;
  224. }
  225. $extra = $this->_authSession->getUser()->getExtra();
  226. if (isset($extra['configState'][$element->getId()])) {
  227. return $extra['configState'][$element->getId()];
  228. }
  229. return $this->isCollapsedDefault;
  230. }
  231. }