system.xml의“힌트”태그와의 거래는 무엇입니까?

파일 에서 <hint/>태그에 대한 불투명 한 참조를 찾았습니다 system.xml. 이 태그와의 거래는 무엇입니까? 어디에서나 사용합니까?

나는 EE에 대해 확신하지 못하지만 CE에서는 결코 완성되지 않은 도움말 시스템의 흔적 태그입니다. 의도는 시스템 구성 섹션의 각 양식 필드에 작은 "힌트"또는 도움말 텍스트를 제공하는 것으로 보입니다.

필드 요소가 작성 될 때 도움말 텍스트가 추가됩니다.

#File: app/code/core/Mage/Adminhtml/Block/System/Config/Form.php
$hint  = (string)$element->hint ? Mage::helper($helperName)->__((string)$element->hint) : '';

//...

$field = $fieldset->addField($id, $fieldType, array(
    'name'                  => $name,
    'label'                 => $label,
    'comment'               => $comment,
    'tooltip'               => $tooltip,
    'hint'                  => $hint,
    'value'                 => $data,
    'inherit'               => $inherit,
    'class'                 => $element->frontend_class . $sharedClass . $requiresClass,
    'field_config'          => $element,
    'scope'                 => $this->getScope(),
    'scope_id'              => $this->getScopeId(),
    'scope_label'           => $this->getScopeLabel($element),
    'can_use_default_value' => $this->canUseDefaultValue((int)$element->show_in_default),
    'can_use_website_value' => $this->canUseWebsiteValue((int)$element->show_in_website),
));

첫 줄은 <hint/>in 값을 읽습니다 system.xml.

다음으로 Magento가 필드를 HTML로 렌더링 할 때 마지막으로하는 일은 중첩 된 div에 힌트를 추가하는 것입니다.

#File: app/code/core/Mage/Adminhtml/Block/System/Config/Form/Field.php
$html.= '<td class="">';
if ($element->getHint()) {
    $html.= '<div class="hint" >';
    $html.= '<div style="display: none;">' . $element->getHint() . '</div>';
    $html.= '</div>';
}
$html.= '</td>';

마지막으로 관리자 페이지로드에서 호출되는 약간의 자바 스크립트가 있습니다.

#File: app/design/adminhtml/default/default/template/system/config/js.phtml
function showHint() {    
    $$('.hint').each(function(element){
        Event.observe(element, 'mouseover', function(){            
            element.down().show()
        });
        Event.observe(element, 'mouseout', function(){
            element.down().hide()
        });
    });
}

이 자바 스크립트는 도움말 텍스트 안팎으로 마우스를 가져 가서 이벤트 핸들러를 표시하도록 이벤트 핸들러를 설정합니다. 이 "힌트"의도는 사용자가 각 필드의 기능을 이해하는 데 도움이됩니다.

문제? 백엔드의 HTML / CSS는 힌트 td를 단일 픽셀 너비로 만듭니다. 이를 통해 힌트를 보는 사람이 힌트를 볼 수 없습니다. 필드 구성에 힌트를 추가 한 다음 브라우저의 자바 스크립트 콘솔에서 다음을 실행하십시오.

$$('.hint').each(function(el){
    el.down().show();
});

이와 같은 것을 보게 될 것입니다.

( 이것은 힌트 텍스트입니다).

나는 항상 이것을 Magento가 출시 된 후 내려진 "최고의 계획"중 하나로 꼽았습니다.