README.txt in Form Placeholder 7
Installation ------------------ 1. Install Form Placeholder (form_placeholder) module as usual. 2. Go to configuration page at "admin/config/user-interface/form-placeholder". 3. Specify CSS selectors for textfields you want to add a placeholder. 4. For older browsers not supporting "placeholder" attribute you have to: 1. Install the Libraries module 2. Download jQuery Placeholder plugin with one of following methods: Via Drush command: drush download-placeholder-library Using Drush Make: Example usage of makefile can be found in form_placeholder.make.example Manually: Download jQuery Placeholder plugin from https://github.com/mathiasbynens/jquery-placeholder Rename downloaded directory to "jquery.placeholder" and place it under "sites/all/libraries" so the file "sites/all/libraries/jquery.placeholder/jquery.placeholder.js" will be accessible Usage ------------------ // Convert all children in given form function MY_MODULE_form_FORM_ID_alter(&$form, &$form_state, $form_id) { $form['#form_placeholder'] = TRUE; } // Convert single form element function MY_MODULE_form_FORM_ID_alter(&$form, &$form_state, $form_id) { $form['my_element']['#form_placeholder'] = TRUE; } It's also possible to convert form elements by classes: 1. form-placeholder-[include/exclude]-children Include/exclude all children of given class. 2. form-placeholder-[include/exclude] Include/exclude single element.
File
README.txtView source
- Installation
- ------------------
- 1. Install Form Placeholder (form_placeholder) module as usual.
- 2. Go to configuration page at "admin/config/user-interface/form-placeholder".
- 3. Specify CSS selectors for textfields you want to add a placeholder.
- 4. For older browsers not supporting "placeholder" attribute you have to:
- 1. Install the Libraries module
- 2. Download jQuery Placeholder plugin with one of following methods:
- Via Drush command:
- drush download-placeholder-library
- Using Drush Make:
- Example usage of makefile can be found in form_placeholder.make.example
- Manually:
- Download jQuery Placeholder plugin from https://github.com/mathiasbynens/jquery-placeholder
- Rename downloaded directory to "jquery.placeholder" and place it under "sites/all/libraries"
- so the file "sites/all/libraries/jquery.placeholder/jquery.placeholder.js" will be accessible
-
-
- Usage
- ------------------
- // Convert all children in given form
- function MY_MODULE_form_FORM_ID_alter(&$form, &$form_state, $form_id) {
- $form['#form_placeholder'] = TRUE;
- }
-
- // Convert single form element
- function MY_MODULE_form_FORM_ID_alter(&$form, &$form_state, $form_id) {
- $form['my_element']['#form_placeholder'] = TRUE;
- }
-
- It's also possible to convert form elements by classes:
- 1. form-placeholder-[include/exclude]-children
- Include/exclude all children of given class.
- 2. form-placeholder-[include/exclude]
- Include/exclude single element.