Drupal
/
drupal
mirror of https://git.drupalcode.org/project/drupal.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

- Patch #952768 by jhodgdon: () parameter in drupal_add_library() and drupal_process_attached() undocumented.

merge-requests/26/head
Dries Buytaert 2010-10-28 00:08:24 +00:00
parent 7af1ab590f
commit 7c95deecb1
1 changed files with 18 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
includes/common.inc
View File

@ -4129,12 +4129,12 @@ function drupal_get_js($scope = 'header', $javascript = NULL, $skip_alter = FALS
} }
/** /**
* Add to the page all structures attached to a render() structure. * Adds attachments to a render() structure.
* *
* Libraries, JavaScript, CSS and other types of custom structures are attached * Libraries, JavaScript, CSS and other types of custom structures are attached
* to elements using the #attached property. The #attached property contains an * to elements using the #attached property. The #attached property is an
* associative array, where the keys are the the types of the structure, and * associative array, where the keys are the the attachment types and the values
* the value the attached data. For example: * are the attached data. For example:
* @code * @code
* $build['#attached'] = array( * $build['#attached'] = array(
* 'js' => array(drupal_get_path('module', 'taxonomy') . '/taxonomy.js'), * 'js' => array(drupal_get_path('module', 'taxonomy') . '/taxonomy.js'),
@ -4145,7 +4145,6 @@ function drupal_get_js($scope = 'header', $javascript = NULL, $skip_alter = FALS
* 'js', 'css', and 'library' are types that get special handling. For any * 'js', 'css', and 'library' are types that get special handling. For any
* other kind of attached data, the array key must be the full name of the * other kind of attached data, the array key must be the full name of the
* callback function and each value an array of arguments. For example: * callback function and each value an array of arguments. For example:
*
* @code * @code
* $build['#attached']['drupal_add_http_header'] = array( * $build['#attached']['drupal_add_http_header'] = array(
* array('Content-Type', 'application/rss+xml; charset=utf-8'), * array('Content-Type', 'application/rss+xml; charset=utf-8'),
@ -4160,12 +4159,16 @@ function drupal_get_js($scope = 'header', $javascript = NULL, $skip_alter = FALS
* assigned to them. * assigned to them.
* @param $dependency_check * @param $dependency_check
* When TRUE, will exit if a given library's dependencies are missing. When * When TRUE, will exit if a given library's dependencies are missing. When
* set to FALSE, will continue to add the libraries, even though one of the * set to FALSE, will continue to add the libraries, even though one or more
* dependencies are missing. Defaults to FALSE. * dependencies are missing. Defaults to FALSE.
* @param $every_page
* Set to TRUE to indicate that the attachments are added to every page on the
* site. Only attachments with the every_page flag set to TRUE can participate
* in JavaScript/CSS aggregation.
* *
* @return * @return
* Will return FALSE if there were any missing library dependencies. TRUE will * FALSE if there were any missing library dependencies; TRUE if all library
* be returned if all library dependencies were met. * dependencies were met.
* *
* @see drupal_add_library() * @see drupal_add_library()
* @see drupal_add_js() * @see drupal_add_js()
@ -4377,16 +4380,20 @@ function drupal_process_states(&$elements) {
* settings, and optionally requiring another library. For example, a library * settings, and optionally requiring another library. For example, a library
* can be a jQuery plugin, a JavaScript framework, or a CSS framework. This * can be a jQuery plugin, a JavaScript framework, or a CSS framework. This
* function allows modules to load a library defined/shipped by itself or a * function allows modules to load a library defined/shipped by itself or a
* depending module; without having to add all files of the library separately. * depending module, without having to add all files of the library separately.
* Each library is only loaded once. * Each library is only loaded once.
* *
* @param $module * @param $module
* The name of the module that registered the library. * The name of the module that registered the library.
* @param $name * @param $name
* The name of the library to add. * The name of the library to add.
* @param $every_page
* Set to TRUE if this library is added to every page on the site. Only items
* with the every_page flag set to TRUE can participate in aggregation.
*
* @return * @return
* TRUE when the library was successfully added or FALSE if the library or one * TRUE if the library was successfully added; FALSE if the library or one of
* of its dependencies could not be added. * its dependencies could not be added.
* *
* @see drupal_get_library() * @see drupal_get_library()
* @see hook_library() * @see hook_library()