TYPO3 Logo
Fluid ViewHelper Reference
Release: 10.4

Loading data.

  • typo3/backend
    • link
      • link.editRecord
      • link.newRecord
    • moduleLayout
      • button
        • moduleLayout.button.linkButton
        • moduleLayout.button.shortcutButton
      • moduleLayout.menuItem
      • moduleLayout.menu
    • uri
      • uri.editRecord
      • uri.newRecord
    • arrayBrowser
    • avatar
    • languageColumn
    • moduleLayout
    • moduleLink
    • thumbnail
  • typo3/core
    • form
      • form.typoScriptConstants
    • iconForRecord
    • iconForResource
    • icon
  • typo3/fluid
    • asset
      • asset.css
      • asset.script
    • be
      • buttons
        • be.buttons.csh
        • be.buttons.shortcut
      • labels
        • be.labels.csh
      • menus
        • be.menus.actionMenuItemGroup
        • be.menus.actionMenuItem
        • be.menus.actionMenu
      • security
        • be.security.ifAuthenticated
        • be.security.ifHasRole
      • widget
        • be.widget.paginate
      • be.container
      • be.infobox
      • be.link
      • be.pageInfo
      • be.pagePath
      • be.pageRenderer
      • be.tableList
      • be.uri
    • debug
      • debug.render
    • form
      • select
        • form.select.optgroup
        • form.select.option
      • form.button
      • form.checkbox
      • form.hidden
      • form.password
      • form.radio
      • form.select
      • form.submit
      • form.textarea
      • form.textfield
      • form.upload
      • form.validationResults
    • format
      • format.bytes
      • format.case
      • format.crop
      • format.currency
      • format.date
      • format.html
      • format.htmlentitiesDecode
      • format.htmlentities
      • format.json
      • format.nl2br
      • format.number
      • format.padding
      • format.stripTags
      • format.urlencode
    • link
      • link.action
      • link.email
      • link.external
      • link.page
      • link.typolink
    • sanitize
      • sanitize.html
    • security
      • security.ifAuthenticated
      • security.ifHasRole
    • uri
      • uri.action
      • uri.email
      • uri.external
      • uri.image
      • uri.page
      • uri.resource
      • uri.typolink
    • widget
      • widget.autocomplete
      • widget.link
      • widget.paginate
      • widget.uri
    • base
    • cObject
    • debug
    • flashMessages
    • form
    • image
    • media
    • renderChildren
    • render
    • translate
  • typo3fluid/fluid
    • cache
      • cache.disable
      • cache.static
      • cache.warmup
    • format
      • format.cdata
      • format.htmlspecialchars
      • format.printf
      • format.raw
    • alias
    • case
    • comment
    • count
    • cycle
    • debug
    • defaultCase
    • else
    • for
    • groupedFor
    • if
    • inline
    • layout
    • or
    • render
    • section
    • spaceless
    • switch
    • then
    • variable
  • Contribution
  • Sitemap
  • Index

PAGE CONTENTS

  • link.newRecord
    • Examples
    • Arguments
      • additionalAttributes
      • data
      • class
      • dir
      • id
      • lang
      • style
      • title
      • accesskey
      • tabindex
      • onclick
      • uid
      • pid
      • table
      • returnUrl
  1. Start
  2. typo3/backend
  3. link
  4. link.newRecord
View source

Display settings


Color scheme of code blocks:


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/index.php?route=/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/index.php?route=/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/index.php?route=/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">

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.

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

false

Description

Target database table

returnUrl¶

DataType

string

Required

false

Description

Return to this URL after closing the edit dialog

  • Previous
  • Next
  • Home
  • Contact
  • Issues
  • Repository

Last updated: Nov 11, 2022 17:07

Last rendered: Nov 14, 2022 12:17

  • TYPO3 Theme 4.7.9
  • DRC v3.0.dev30
© Copyright since 2018 by the TYPO3 contributors
  • Legal Notice
  • Privacy Policy
  • Code of Conduct