Added the ability to automatically output language items as form labels in the Language class.
diff --git a/system/libraries/Language.php b/system/libraries/Language.php
index f97db35..a1f73d0 100644
--- a/system/libraries/Language.php
+++ b/system/libraries/Language.php
@@ -108,12 +108,20 @@
* Fetch a single line of text from the language array
*
* @access public
- * @param string the language line
+ * @param string $line the language line
+ * @param string $label optional label
* @return string
*/
- function line($line = '')
+ function line($line = '', $label = '')
{
- return ($line == '' OR ! isset($this->language[$line])) ? FALSE : $this->language[$line];
+ $line = ($line == '' OR ! isset($this->language[$line])) ? FALSE : $this->language[$line];
+
+ if ($label != '')
+ {
+ $line = '<label for="'.$label.'">'.$line."</label>";
+ }
+
+ return $line;
}
}
diff --git a/user_guide/changelog.html b/user_guide/changelog.html
index 39568b9..e078290 100644
--- a/user_guide/changelog.html
+++ b/user_guide/changelog.html
@@ -74,6 +74,7 @@
<li>Added support for query strings to the <a href="libraries/pagination.html">Pagination class</a>, automatically detected or explicitly declared.</li>
<li>Added <kbd>get_post()</kbd> to the <a href="libraries/input.html">Input class</a>.</li>
<li>Documented <kbd>get()</kbd> in the <a href="libraries/input.html">Input class</a>.</li>
+ <li>Added the ability to automatically output language items as form labels in the <a href="libraries/language.html">Language class</a>.</li>
</ul>
</li>
<li>Helpers
diff --git a/user_guide/libraries/language.html b/user_guide/libraries/language.html
index eff7d32..aa07743 100644
--- a/user_guide/libraries/language.html
+++ b/user_guide/libraries/language.html
@@ -110,6 +110,16 @@
<p>Where <samp>language_key</samp> is the array key corresponding to the line you wish to show.</p>
<p>Note: This function simply returns the line. It does not echo it for you.</p>
+
+<h3>Using language lines as form labels</h3>
+
+<p>If your application requires it, a language line can automatically be output as a <label> by specifying a second parameter, which will become the "for" attribute of the label.</p>
+
+<code>
+$this->lang->line('<samp>language_key</samp>', '<samp>form_item_id</samp>'); <br />
+// becomes <label for="form_item_id">language_key</label>
+</code>
+
<h2>Auto-loading Languages</h2>
<p>If you find that you need a particular language globally throughout your application, you can tell CodeIgniter to <a href="../general/autoloader.html">auto-load</a> it during system initialization. This is done by opening the application/config/autoload.php file and adding the language(s) to the autoload array.</p>
<p> </p>