InputfieldWrapper::insertBefore() method

Insert one Inputfield before one that’s already there.

Note: string or array values for either argument require 3.0.196+.

Example

// example 1: Get existing Inputfields and insert first_name before last_name
$firstName = $form->getByName('first_name');
$lastName = $form->getByName('last_name');
$form->insertBefore($firstName, $lastName);

// example 2: Same as above but use Inputfield names (3.0.196+)
$form->insertBefore('first_name', 'last_name');

// example 3: Create new Inputfield and insert before last_name (3.0.196+)
$form->insertBefore([ 'type' => 'text', 'name' => 'first_name' ], 'last_name'); 

Usage

$inputfieldWrapper->insertBefore($item, $existingItem);

Arguments

NameType(s)Description
itemInputfield, array, string

Item to insert

existingItemInputfield, string

Existing item you want to insert before.

Return value

$this

Object instance it was called from (method supports fluent interface).


InputfieldWrapper methods and properties

API reference based on ProcessWire core version 3.0.244

Latest news

  • ProcessWire Weekly #568
    The 568th issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 30 March 2025
  • ProcessWire 3.0.244 new main/master version
    ProcessWire 3.0.244 is our newest main/master/stable version. It's been more than a year in the making and is packed with tons of new features, issue fixes, optimizations and more. This post covers all the details.
    Blog / 18 January 2025
  • Subscribe to weekly ProcessWire news

“To Drupal, or to ProcessWire? The million dollar choice. We decided to make an early switch to PW. And in retrospect, ProcessWire was probably the best decision we made. Thanks are due to ProcessWire and the amazing system and set of modules that are in place.” —Unni Krishnan, Founder of PigtailPundits