Merge pull request #9071 from 3Dgoo/patch-1

Requirements_Backend.php API documentation fix
This commit is contained in:
Robbie Averill 2019-06-15 20:10:13 +12:00 committed by GitHub
commit 1fc94ec88f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -82,14 +82,14 @@ class Requirements_Backend
protected $customScript = array(); protected $customScript = array();
/** /**
* All custom CSS rules which are inserted directly at the bottom of the HTML <head> tag * All custom CSS rules which are inserted directly at the bottom of the HTML `<head>` tag
* *
* @var array * @var array
*/ */
protected $customCSS = array(); protected $customCSS = array();
/** /**
* All custom HTML markup which is added before the closing <head> tag, e.g. additional * All custom HTML markup which is added before the closing `<head>` tag, e.g. additional
* metatags. * metatags.
* *
* @var array * @var array
@ -148,8 +148,8 @@ class Requirements_Backend
protected $combinedFilesFolder = null; protected $combinedFilesFolder = null;
/** /**
* Put all JavaScript includes at the bottom of the template before the closing <body> tag, * Put all JavaScript includes at the bottom of the template before the closing `<body>` tag,
* rather than the default behaviour of placing them at the end of the <head> tag. This means * rather than the default behaviour of placing them at the end of the `<head>` tag. This means
* script downloads won't block other HTTP requests, which can be a performance improvement. * script downloads won't block other HTTP requests, which can be a performance improvement.
* *
* @var bool * @var bool
@ -522,7 +522,7 @@ class Requirements_Backend
/** /**
* Register the given JavaScript code into the list of requirements * Register the given JavaScript code into the list of requirements
* *
* @param string $script The script content as a string (without enclosing <script> tag) * @param string $script The script content as a string (without enclosing `<script>` tag)
* @param string $uniquenessID A unique ID that ensures a piece of code is only added once * @param string $uniquenessID A unique ID that ensures a piece of code is only added once
*/ */
public function customScript($script, $uniquenessID = null) public function customScript($script, $uniquenessID = null)
@ -547,7 +547,7 @@ class Requirements_Backend
/** /**
* Register the given CSS styles into the list of requirements * Register the given CSS styles into the list of requirements
* *
* @param string $script CSS selectors as a string (without enclosing <style> tag) * @param string $script CSS selectors as a string (without enclosing `<style>` tag)
* @param string $uniquenessID A unique ID that ensures a piece of code is only added once * @param string $uniquenessID A unique ID that ensures a piece of code is only added once
*/ */
public function customCSS($script, $uniquenessID = null) public function customCSS($script, $uniquenessID = null)
@ -570,7 +570,7 @@ class Requirements_Backend
} }
/** /**
* Add the following custom HTML code to the <head> section of the page * Add the following custom HTML code to the `<head>` section of the page
* *
* @param string $html Custom HTML code * @param string $html Custom HTML code
* @param string $uniquenessID A unique ID that ensures a piece of code is only added once * @param string $uniquenessID A unique ID that ensures a piece of code is only added once
@ -868,9 +868,9 @@ class Requirements_Backend
/** /**
* Given a block of HTML, insert the given scripts at the bottom before * Given a block of HTML, insert the given scripts at the bottom before
* the closing </body> tag * the closing `</body>` tag
* *
* @param string $jsRequirements String containing one or more javascript <script /> tags * @param string $jsRequirements String containing one or more javascript `<script />` tags
* @param string $content HTML body * @param string $content HTML body
* @return string Merged HTML * @return string Merged HTML
*/ */
@ -887,9 +887,9 @@ class Requirements_Backend
} }
/** /**
* Given a block of HTML, insert the given scripts inside the <body></body> * Given a block of HTML, insert the given scripts inside the `<body></body>`
* *
* @param string $jsRequirements String containing one or more javascript <script /> tags * @param string $jsRequirements String containing one or more javascript `<script />` tags
* @param string $content HTML body * @param string $content HTML body
* @return string Merged HTML * @return string Merged HTML
*/ */
@ -924,7 +924,7 @@ class Requirements_Backend
} }
/** /**
* Given a block of HTML, insert the given code inside the <head></head> block * Given a block of HTML, insert the given code inside the `<head></head>` block
* *
* @param string $jsRequirements String containing one or more html tags * @param string $jsRequirements String containing one or more html tags
* @param string $content HTML body * @param string $content HTML body