Drupal的组成部分 8.主题(模板)系统

Functions and templates that present output to the user, and can be implemented by themes.

Drupal's presentation layer is a pluggable system known as the theme layer. Each theme can take control over most of Drupal's output, and has complete control over the CSS.

Inside Drupal, the theme layer is utilized by the use of the theme() function, which is passed the name of a component (the theme hook) and several arguments. For example, theme('table', $header, $rows); Additionally, the theme() function can take an array of theme hooks, which can be used to provide 'fallback' implementations to allow for more specific control of output. For example, the function:theme(array('table__foo', 'table'), $header, $rows) would look to see if 'table__foo' is registered anywhere; if it is not, it would 'fall back' to the generic 'table' implementation. This can be used to attach specific theme functions to named objects, allowing the themer more control over specific types of output.

As of Drupal 6, every theme hook is required to be registered by the module that owns it, so that Drupal can tell what to do with it and to make it simple for themes to identify and override the behavior for these calls.

The theme hooks are registered via hook_theme(), which returns an array of arrays with information about the hook. It describes the arguments the function or template will need, and provides defaults for the template in case they are not filled in. If the default implementation is a function, by convention it is named theme_HOOK().

Each module should provide a default implementation for theme_hooks that it registers. This implementation may be either a function or a template; if it is a function it must be specified via hook_theme(). By convention, default implementations of theme hooks are named theme_HOOK. Default template implementations are stored in the module directory.

Drupal's default template renderer is a simple PHP parsing engine that includes the template and stores the output. Drupal's theme engines can provide alternate template engines, such as XTemplate, Smarty and PHPTal. The most common template engine is PHPTemplate (included with Drupal and implemented in phptemplate.engine, which uses Drupal's default template renderer.

In order to create theme-specific implementations of these hooks, themes can implement their own version of theme hooks, either as functions or templates. These implementations will be used instead of the default implementation. If using a pure .theme without an engine, the .theme is required to implement its own version ofhook_theme() to tell Drupal what it is implementing; themes utilizing an engine will have their well-named theming functions automatically registered for them. While this can vary based upon the theme engine, the standard set by phptemplate is that theme functions should be named either phptemplate_HOOK or THEMENAME_HOOK. For example, for Drupal's default theme (Garland) to implement the 'table' hook, thephptemplate.engine would find phptemplate_table() or garland_table(). The ENGINE_HOOK() syntax is preferred, as this can be used by sub-themes (which are themes that share code but use different stylesheets).

The theme system is described and defined in theme.inc.

See also

theme()

@see hook_theme()

函数

名称	位置	描述
theme_admin_block	modules/system/system.admin.inc	This function formats an administrative block for display.
theme_admin_block_content	modules/system/system.admin.inc	This function formats the content of an administrative block.
theme_admin_page	modules/system/system.admin.inc	This function formats an administrative page for viewing.
theme_aggregator_page_opml	modules/aggregator/aggregator.pages.inc	Theme the OPML feed output.
theme_aggregator_page_rss	modules/aggregator/aggregator.pages.inc	Theme the RSS output.
theme_blocks	includes/theme.inc	Return a set of blocks available for the current user.
theme_book_admin_table	modules/book/book.admin.inc	Theme function for the book administration page form. See alsobook_admin_table()
theme_book_title_link	modules/book/book.module	Generate the HTML output for a link to a book title when used as a block title.
theme_box	includes/theme.inc	Return a themed box.
theme_breadcrumb	includes/theme.inc	Return a themed breadcrumb trail.
theme_button	includes/form.inc	Theme a form button.
theme_checkbox	includes/form.inc	Format a checkbox.
theme_checkboxes	includes/form.inc	Format a set of checkboxes.
theme_closure	includes/theme.inc	Execute hook_footer() which is run at the end of the page right before the close of the body tag.
theme_comment_admin_overview	modules/comment/comment.admin.inc	Theme the comment admin form.
theme_comment_flat_collapsed	modules/comment/comment.module	Theme comment flat collapsed view.
theme_comment_flat_expanded	modules/comment/comment.module	Theme comment flat expanded view.
theme_comment_post_forbidden	modules/comment/comment.module	Theme a "you can't post comments" notice.
theme_comment_submitted	modules/comment/comment.module	Theme a "Submitted by ..." notice.
theme_comment_thread_collapsed	modules/comment/comment.module	Theme comment thread collapsed view.
theme_comment_thread_expanded	modules/comment/comment.module	Theme comment thread expanded view.
theme_comment_view	modules/comment/comment.module	Theme a single comment block.
theme_date	includes/form.inc	Format a date selection element.
theme_dblog_filters	modules/dblog/dblog.module	Theme dblog administration filter selector.
theme_feed_icon	includes/theme.inc	Return code that emits an feed icon.
theme_fieldset	includes/form.inc	Format a group of form items.
theme_file	includes/form.inc	Format a file upload field.
theme_filter_admin_order	modules/filter/filter.admin.inc	Theme filter order configuration form.
theme_filter_admin_overview	modules/filter/filter.admin.inc	Theme the admin overview form.
theme_filter_tips	modules/filter/filter.pages.inc	Render HTML for a set of filter tips.
theme_filter_tips_more_info	modules/filter/filter.module	Format a link to the more extensive filter tips.
theme_form	includes/form.inc	Format a form.
theme_form_element	includes/form.inc	Return a themed form element.
theme_help	includes/theme.inc	Return a themed help message.
theme_hidden	includes/form.inc	Format a hidden form field.
theme_image	includes/theme.inc	Return a themed image.
theme_image_button	includes/form.inc	Theme a form image button.
theme_indentation	includes/theme.inc	Create a standard indentation div. Used for drag and drop tables.
theme_item	includes/form.inc	Format a form item.
theme_item_list	includes/theme.inc	Return a themed list of items.
theme_links	includes/theme.inc	Return a themed set of links.
theme_locale_languages_overview_form	includes/locale.inc	Theme the language overview form.
theme_mark	includes/theme.inc	Return a themed marker, useful for marking new or updated content.
theme_menu_item	includes/menu.inc	Generate the HTML output for a menu item and submenu.
theme_menu_item_link	includes/menu.inc	Generate the HTML output for a single menu link.
theme_menu_local_task	includes/menu.inc	Generate the HTML output for a single local task link.
theme_menu_local_tasks	includes/menu.inc	Returns the rendered local tasks. The default implementation renders them as tabs.
theme_menu_overview_form	modules/menu/menu.admin.inc	Theme the menu overview form into a table.
theme_menu_tree	includes/menu.inc	Generate the HTML output for a menu tree
theme_meta_generator_header	modules/system/system.module	Send Drupal and the major version number in the HTTP headers.
theme_meta_generator_html	modules/system/system.module	Send Drupal and the major version number in the META GENERATOR HTML.
theme_more_help_link	includes/theme.inc	Returns code that emits the 'more help'-link.
theme_more_link	includes/theme.inc	Returns code that emits the 'more' link used on blocks.
theme_node_add_list	modules/node/node.pages.inc	Display the list of available node types for node creation.
theme_node_admin_nodes	modules/node/node.admin.inc	Theme node administration overview.
theme_node_filters	modules/node/node.admin.inc	Theme node administration filter selector.
theme_node_filter_form	modules/node/node.admin.inc	Theme node administration filter form.
theme_node_form	modules/node/node.pages.inc	Present a node submission form.
theme_node_links	modules/node/node.module	Format a set of node links.
theme_node_list	modules/node/node.module	Format a listing of links to nodes.
theme_node_log_message	modules/node/node.module	Theme a log message.
theme_node_preview	modules/node/node.pages.inc	Display a node preview for display during node creation and editing.
theme_node_search_admin	modules/node/node.module	Theme the content ranking part of the search settings admin page.
theme_node_submitted	modules/node/node.module	Format the "Submitted by username on date/time" for each node
theme_pager	includes/pager.inc	Format a query pager.
theme_pager_first	includes/pager.inc	Format a "first page" link.
theme_pager_last	includes/pager.inc	Format a "last page" link.
theme_pager_link	includes/pager.inc	Format a link to a specific query result page.
theme_pager_next	includes/pager.inc	Format a "next page" link.
theme_pager_previous	includes/pager.inc	Format a "previous page" link.
theme_password	includes/form.inc	Format a password field.
theme_password_confirm	includes/form.inc	Format a password_confirm item.
theme_placeholder	includes/theme.inc	Formats text for emphasized display in a placeholder inside a sentence. Used automatically by t().
theme_poll_choices	modules/poll/poll.module	Theme the admin poll form for choices.
theme_profile_admin_overview	modules/profile/profile.admin.inc	Theme the profile field overview into a drag and drop enabled table. See alsoprofile_admin_overview()
theme_progress_bar	includes/theme.inc	Return a themed progress bar.
theme_radio	includes/form.inc	Format a radio button.
theme_radios	includes/form.inc	Format a set of radio buttons.
theme_scaffolding_example_overview_form	developer/examples/scaffolding_example/scaffolding_example.admin.inc	Theme the drag-and-drop overview form.
theme_scaffolding_example_record	developer/examples/scaffolding_example/scaffolding_example.pages.inc	Theme a single record.
theme_select	includes/form.inc	Format a dropdown menu or scrolling selection box.
theme_status_messages	includes/theme.inc	Return a themed set of status and/or error messages. The messages are grouped by type.
theme_status_report	modules/system/system.admin.inc	Theme requirements status report.
theme_submenu	includes/theme.inc	Return a themed submenu, typically displayed under the tabs.
theme_submit	includes/form.inc	Theme a form submit button.
theme_syslog_format	modules/syslog/syslog.module	Format a system log entry.
theme_system_admin_by_module	modules/system/system.admin.inc	Theme output of the dashboard page.
theme_system_compact_link	modules/system/system.module	Display the link to show or hide inline help descriptions.
theme_system_modules_fieldset	modules/system/system.admin.inc	Theme callback for the modules form.
theme_system_modules_incompatible	modules/system/system.admin.inc	Themes an incompatible message.
theme_system_modules_uninstall	modules/system/system.admin.inc	Themes a table of currently disabled modules.
theme_system_powered_by	modules/system/system.module	Format the Powered by Drupal text.
theme_system_themes_form	modules/system/system.admin.inc	Theme function for the system themes form.
theme_system_theme_select_form	modules/system/system.admin.inc	Theme the theme select form.
theme_table	includes/theme.inc	Return a themed table.
theme_tablesort_indicator	includes/theme.inc	Return a themed sort icon.
theme_table_select_header_cell	includes/theme.inc	Returns a header cell for tables that have a select all functionality.
theme_task_list	includes/theme.maintenance.inc	Return a themed list of maintenance tasks to perform.
theme_taxonomy_overview_terms	modules/taxonomy/taxonomy.admin.inc	Theme the terms overview as a sortable list of terms. See alsotaxonomy_overview_terms()
theme_taxonomy_overview_vocabularies	modules/taxonomy/taxonomy.admin.inc	Theme the vocabulary overview as a sortable list of vocabularies. See alsotaxonomy_overview_vocabularies()
theme_taxonomy_term_page	modules/taxonomy/taxonomy.pages.inc	Render a taxonomy term page HTML output.
theme_taxonomy_term_select	modules/taxonomy/taxonomy.module	Format the selection field for choosing terms (by default the default selection field is used).
theme_textarea	includes/form.inc	Format a textarea.
theme_textfield	includes/form.inc	Format a textfield.
theme_token	includes/form.inc	Format a form token.
theme_trigger_display	modules/trigger/trigger.admin.inc	Display actions assigned to this hook-op combination in a table.
theme_update_report	modules/update/update.report.inc	Theme project status report.
theme_update_version	modules/update/update.report.inc	Theme the version display of a project.
theme_upload_attachments	modules/upload/upload.module	Displays file attachments in table
theme_upload_form_current	modules/upload/upload.module	Theme the attachments list.
theme_upload_form_new	modules/upload/upload.module	Theme the attachment form. Note: required to output prefix/suffix.
theme_username	includes/theme.inc	Format a username.
theme_user_admin_account	modules/user/user.admin.inc	Theme user administration overview.
theme_user_admin_new_role	modules/user/user.admin.inc	Theme the new-role form.
theme_user_admin_perm	modules/user/user.admin.inc	Theme the administer permissions page.
theme_user_filters	modules/user/user.admin.inc	Theme user administration filter selector.
theme_user_filter_form	modules/user/user.admin.inc	Theme user administration filter form.
theme_user_list	modules/user/user.module	Make a list of users.
theme_user_signature	modules/user/user.module	Theme output of user signature.
theme_xml_icon	includes/theme.inc	Return code that emits an XML icon.