首页 > 代码库 > Drupal的$messages是怎么显示的?
Drupal的$messages是怎么显示的?
Drupal的默认主题bartik会在页面顶部显示系统信息,例如警告、状态等。这个过程是如何实现的?
首先,在bartik目录下找到page.tpl.php,这是bartik主题的页面显示模板。其中有一段是处理$messages的:
<?php if ($messages): ?> <div id="messages"><div class="section clearfix"> <?php print $messages; ?> </div></div> <!-- /.section, /#messages --> <?php endif; ?>
这里的$messages变量从哪里来的呢?在includes/theme.inc文件中找到system_process_page()函数,这是对page hook的处理函数,调用了theme(‘status_messages‘)输出系统信息HTML。
function template_process_page(&$variables) { ... ... // Generate messages last in order to capture as many as possible for the // current page. if (!isset($variables[‘messages‘])) { $variables[‘messages‘] = $variables[‘show_messages‘] ? theme(‘status_messages‘) : ‘‘; } }
status_messages是另外一个theme hook,在system模块的hook_theme钩子中定义:
function system_theme() { return array_merge(drupal_common_theme(), array(... ...}); } function drupal_common_theme() { return array( ‘status_messages‘ => array( ‘variables‘ => array(‘display‘ => NULL), ), }; }
status_messages hook是用theme_status_messages()函数输出的,在theme.inc里面:
function theme_status_messages($variables) { $display = $variables[‘display‘]; $output = ‘‘; $status_heading = array( ‘status‘ => t(‘Status message‘), ‘error‘ => t(‘Error message‘), ‘warning‘ => t(‘Warning message‘), ); foreach (drupal_get_messages($display) as $type => $messages) { $output .= "<div class=\"messages $type\">\n"; if (!empty($status_heading[$type])) { $output .= ‘<h2 class="element-invisible">‘ . $status_heading[$type] . "</h2>\n"; } if (count($messages) > 1) { $output .= " <ul>\n"; foreach ($messages as $message) { $output .= ‘ <li>‘ . $message . "</li>\n"; } $output .= " </ul>\n"; } else { $output .= $messages[0]; } $output .= "</div>\n"; } return $output; }
theme_status_messages()函数调用drupal_get_message()获取系统信息,与此对应地设置系统信息的函数是drupal_set_message()。
function drupal_set_message($message = NULL, $type = ‘status‘, $repeat = TRUE) { if ($message) { if (!isset($_SESSION[‘messages‘][$type])) { $_SESSION[‘messages‘][$type] = array(); } if ($repeat || !in_array($message, $_SESSION[‘messages‘][$type])) { $_SESSION[‘messages‘][$type][] = $message; } // Mark this page as being uncacheable. drupal_page_is_cacheable(FALSE); } // Messages not set when DB connection fails. return isset($_SESSION[‘messages‘]) ? $_SESSION[‘messages‘] : NULL; } function drupal_get_messages($type = NULL, $clear_queue = TRUE) { if ($messages = drupal_set_message()) { if ($type) { if ($clear_queue) { unset($_SESSION[‘messages‘][$type]); } if (isset($messages[$type])) { return array($type => $messages[$type]); } } else { if ($clear_queue) { unset($_SESSION[‘messages‘]); } return $messages; } } return array(); }
从theme_status_messages()可知,系统信息有三类:status、error、warning。每一类系统信息对应一个css样式,在system.messages.css中定义。换句话说,不同类别的系统信息,显示的图标和字体都在system.messages.css中控制。
div.messages { background-position: 8px 8px; /* LTR */ background-repeat: no-repeat; border: 1px solid; margin: 6px 0; padding: 10px 10px 10px 50px; /* LTR */ } div.status { background-image: url(../../misc/message-24-ok.png); border-color: #be7; } div.warning { background-image: url(../../misc/message-24-warning.png); border-color: #ed5; } div.error { background-image: url(../../misc/message-24-error.png); border-color: #ed541d; }
声明:以上内容来自用户投稿及互联网公开渠道收集整理发布,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任,若内容有误或涉及侵权可进行投诉: 投诉/举报 工作人员会在5个工作日内联系你,一经查实,本站将立刻删除涉嫌侵权内容。