link.newRecord¶

Use this ViewHelper to provide 'create new record' links. The ViewHelper will pass the command to FormEngine.

The table argument is mandatory, it decides what record is to be created.

The pid argument will put the new record on this page, if 0 given it will be placed to the root page.

The uid argument accepts only negative values. If this is given, the new record will be placed (by sorting field) behind the record with the uid. It will end up on the same pid as this given record, so the pid must not be given explicitly by pid argument.

An exception will be thrown, if both uid and pid are given. An exception will be thrown, if the uid argument is not a negative integer.

To edit records, use the <be:link.editRecordViewHelper>.

Examples¶

Link to create a new record of a_table after record 17 on the same pid:

<be:link.newRecord table="a_table" returnUrl="foo/bar" uid="-17"/>

Output:

<a href="/typo3/record/edit?edit[a_table][-17]=new&returnUrl=foo/bar">
    Edit record
</a>

Link to create a new record of a_table on root page:

<be:link.newRecord table="a_table" returnUrl="foo/bar""/>

Output:

<a href="/typo3/record/edit?edit[a_table][]=new&returnUrl=foo/bar">
    Edit record
</a>

Link to create a new record of a_table on page 17:

<be:link.newRecord table="a_table" returnUrl="foo/bar" pid="17"/>

Output:

<a href="/typo3/record/edit?edit[a_table][17]=new&returnUrl=foo/bar">
    Edit record
</a>

Link to create a new record then return back to the BE module "web_MyextensionList":

<be:link.newRecord table="a_table" returnUrl="{f:be.uri(route: 'web_MyextensionList')}" pid="17">

Output:

<a href="/typo3/record/edit?edit[a_table][17]=new&returnUrl=/typo3/module/web/MyextensionList">
    Edit record
</a>

Link to create a new record of a_table on page 17 with a default value:

<be:link.newRecord table="a_table" returnUrl="foo/bar" pid="17" defaultValues="{a_table: {a_field: 'value'}}">

Output:

<a href="/typo3/record/edit?edit[a_table][17]=new&returnUrl=foo/bar&defVals[a_table][a_field]=value">
    Edit record
</a>

Arguments¶

additionalAttributes¶

DataType: mixed
Required: false
Description: Additional tag attributes. They will be added directly to the resulting HTML tag.

data¶

DataType: mixed
Required: false
Description: Additional data-* attributes. They will each be added with a "data-" prefix.

aria¶

DataType: mixed
Required: false
Description: Additional aria-* attributes. They will each be added with a "aria-" prefix.

class¶

DataType: string
Required: false
Description: CSS class(es) for this element

dir¶

DataType: string
Required: false
Description: Text direction for this HTML element. Allowed strings: "ltr" (left to right), "rtl" (right to left)

id¶

DataType: string
Required: false
Description: Unique (in this file) identifier for this HTML element.

lang¶

DataType: string
Required: false
Description: Language for this element. Use short names specified in RFC 1766

style¶

DataType: string
Required: false
Description: Individual CSS styles for this element

title¶

DataType: string
Required: false
Description: Tooltip text of element

accesskey¶

DataType: string
Required: false
Description: Keyboard shortcut to access this element

tabindex¶

DataType: integer
Required: false
Description: Specifies the tab order of this element

onclick¶

DataType: string
Required: false
Description: JavaScript evaluated for the onclick event

uid¶

DataType: mixed
Required: false
Description: Uid < 0 will insert the record after the given uid

pid¶

DataType: mixed
Required: false
Description: The page id where the record will be created

table¶

DataType: string
Required: true
Description: Target database table

returnUrl¶

DataType: string
Required: false
Description: Return to this URL after closing the edit dialog

defaultValues¶

DataType: mixed
Default: array ()
Required: false
Description: Default values for fields of the new record