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.248

Latest news

  • ProcessWire Weekly #581
    The 581st issue of ProcessWire Weekly brings in all the latest news from the ProcessWire community. Modules, sites, and more. Read on!
    Weekly.pw / 28 June 2025
  • New ProcessWire admin redesign
    When you upgrade to ProcessWire 3.0.248 or newer (currently the dev branch), you’ll immediately notice something new and beautiful…
    Blog / 9 May 2025
  • Subscribe to weekly ProcessWire news

“I am currently managing a ProcessWire site with 2 million+ pages. It’s admirably fast, and much, much faster than any other CMS we tested.” —Nickie, Web developer