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 #558
    In the 558th issue of ProcessWire Weekly we'll check out the blog post that introduces ProcessWire 3.0.244, share some recent ProcessWire highlights, and more. Read on!
    Weekly.pw / 18 January 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

“ProcessWire is like a breath of fresh air. So powerful yet simple to build with and customise, and web editors love it too.” —Margaret Chatwin, Web developer