Interface IToolbarBuilder

The toolbar builder helps you create Toolbar configurations for the UI. Note that it has a fluid API, and each method/use returns a fresh object with the updated configuration.

📖 See Guide for the Toolbar Builder

Inherited Members

IHasLog.Log

Namespace: ToSic.Sxc.Edit.Toolbar

Assembly: ToSic.Sxc.dll

Syntax

[PublicApi]
public interface IToolbarBuilder : IHybridHtmlString, IHtmlString, IHasLog, INeedsDynamicCodeRoot

Remarks

Your code cannot construct this object by itself, as it usually needs additional information. To get a ToolbarBuilder, use the IToolbarService.

History

Added in 2sxc 13, just minimal API
massively enhanced in v14.04

Methods

| Improve this Doc View Source

Add(Object, String, String, Object, Object, String)

Create button to add a new entity to a list of entities. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Add(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", string contentType = null, object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target which is in a list of items in on a content-block, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.String	contentType
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

AddExisting(Object, String, String, Object, Object, String)

Create button to add an existing entity to the list. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder AddExisting(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", string contentType = null, object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target which is in a list of items in on a content-block, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.String	contentType
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

App(Object, String, Object, Object, String)

Create button to admin the app. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder App(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen. By default, the button will show based on conditions like permissions.

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

AppImport(Object, String, Object, Object, String)

Create button to open the import-app dialog. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder AppImport(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen. By default, the button will show based on conditions like permissions.

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

AppResources(Object, String, Object, Object, String)

Create button to edit the app resources if there are any. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder AppResources(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen. By default, the button will show based on conditions like permissions.

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Apps(Object, String, Object, Object, String)

Create button to open the apps management of the current site. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Apps(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen. By default, the button will show based on conditions like permissions.

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

AppSettings(Object, String, Object, Object, String)

Create button to edit the custom app settings if there are any. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder AppSettings(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen. By default, the button will show based on conditions like permissions.

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

AsAttributes(Object)

Get a toolbar builder which would render to HTML as attributes on an existing tag. Note that this is the default, so you will usually not need this.

Declaration

IToolbarBuilder AsAttributes(object target = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target, see target guide

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

AsTag(Object)

Get a toolbar builder which would render to HTML as a standalone tag.

Important: Toolbars created using this will behave differently from previous standalone toolbars. These standalone toolbars will not float automatically as previous ones did. You can still get them to float by adjusting the Settings as you need them.

This is because many years ago, standalone toolbars were configured floated automatically. As the APIs got better, this wasn't a great default any more, but we couldn't introduce a breaking change. Anything created now with this new API will be new, so this will behave more in line with expectations. See also issue

Declaration

IToolbarBuilder AsTag(object target = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target, see target guide

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Button(String, Object, String, Object, Object, String, String)

Add a custom button / command. Can also be used to do advanced remove operations or modify a button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Button(string name, object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null, string context = null)

Parameters

Type	Name	Description
System.String	name	The required name of the command. See CommandNames. Can also be a full rule-string containing parameters and more according to the conventions of the js toolbar
System.Object	target	optional entity-like target, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen
System.String	context

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Code(Object, String, Object, Object, String)

Create Button to run JS code. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Code(object target, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	Name of the function to call, without parameters.
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Condition(Boolean)

Condition to apply if the toolbar would show, but maybe shouldn't. For example, you can prevent the toolbar from appearing if it's the Demo-Item.

For expensive conditions, use the overload which accepts a function.

Declaration

IToolbarBuilder Condition(bool condition)

Parameters

Type	Name	Description
System.Boolean	condition	true/false

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

Remarks

New in v14.04

| Improve this Doc View Source

Condition(Func<Boolean>)

Condition to apply if the toolbar would show, but maybe shouldn't. For example, you can prevent the toolbar from appearing if it's the Demo-Item.

This accepts a function to check the condition. It will only run if the toolbar would already show.

Declaration

IToolbarBuilder Condition(Func<bool> condition)

Parameters

Type	Name	Description
System.Func<System.Boolean>	condition	function such as `() => true`

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

Remarks

New in v14.04

| Improve this Doc View Source

Copy(Object, String, String, Object, Object, Object, String, String)

Create button to copy an item. Can also be used to remove the same button on a toolbar which would have it by default. It needs the item which it will copy as a parameter.

Declaration

IToolbarBuilder Copy(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", string contentType = null, object ui = null, object parameters = null, object prefill = null, string operation = null, string context = null)

Parameters

Type	Name	Description
System.Object	target	an entity-like target, see target guide can also be a int (number) entityId. If you only supply the entity ID, you must also supply the `contentType`.
System.String	noParamOrder	see Convention: Named Parameters
System.String	contentType
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.Object	prefill	optional prefill for the edit-UI, see prefill guide
System.String	operation	optional change what should happen
System.String	context	EXPERIMENTAL - not final

Returns

Type	Description
IToolbarBuilder	A new toolbar builder which has been extended with this button

Remarks

Added in v14.02

| Improve this Doc View Source

Data(Object, String, Object, Object, Object, String)

Create button to show a data-admin dialog with all the data-items / entities of a specific content type. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Data(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object filter = null, object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	3 Options: an entity-like target, see target guide a `string` containing the type name a modifier keyword such as `remove` or `-` to remove the button
System.String	noParamOrder	see Convention: Named Parameters
System.Object	filter	object or string with the filters for the data view see filter
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Delete(Object, String, Object, Object, String)

Create (or reconfigure) the button to delete an item.

This has a special behavior. The default toolbar already includes a delete-button in the third group. So if the toolbar is is a default this will just modify it to force-show. But it will still be in the third group of buttons.

For the empty toolbar it will just add the button in the normal way.

To change this automatic behavior, use a operation = modify or add

Declaration

IToolbarBuilder Delete(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Edit(Object, String, Object, Object, Object, String)

Create button to edit an item. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Edit(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, object prefill = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.Object	prefill	optional prefill for the edit-UI, see prefill guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Fields(Object, String, Object, Object, String)

Create Button to open a dialog to manage the fields/attributes of the content type. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Fields(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

For(Object)

Set the main target of this toolbar.

Declaration

[InternalApi_DoNotUse_MayChangeWithoutNotice("WIP - still choosing name for/target")]
IToolbarBuilder For(object target)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target, see target guide

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

Remarks

New in v14.04

| Improve this Doc View Source

Group(String)

Adds a button group to the toolbar. All following buttons will be in this group automatically.

Can also be used to remove a group of buttons on the default toolbar, such as the group view. See list of groups on default

Declaration

IToolbarBuilder Group(string name = null)

Parameters

Type	Name	Description
System.String	name	optional - name of new group or `-name` to remove an existing group.

Returns

Type	Description
IToolbarBuilder

Remarks

New in v14.08

| Improve this Doc View Source

Insights(Object, String, Object, Object, String)

Create button to open the insights for debugging. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Insights(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen. By default, the button will show based on conditions like permissions.

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Layout(Object, String, Object, Object, String)

Create Button to change the view/layout of the data shown on the page. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Layout(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

List(Object, String, Object, Object, String)

Create button to manage the list of entities shown here. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder List(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target which is in a list of items in on a content-block, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Metadata(Object, String, String, Object, Object, Object, String, String)

Create button to add or edit metadata to the specified object and using the content-type specified here. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Metadata(object target, string contentTypes = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, object prefill = null, string operation = null, string context = null)

Parameters

Type	Name	Description
System.Object	target	The target object which should receive metadata. Must support IHasMetadata. Often an entity-like target, see target guide, but can also other metadata supporting objects, like an Asset, Page, Site, etc.
System.String	contentTypes	Name of one or more content-types for which to generate the button(s). For many, use comma `,` to separate. If not specified, will try to lookup config (v14)
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.Object	prefill	optional prefill for the edit-UI, see prefill guide
System.String	operation	optional change what should happen
System.String	context	EXPERIMENTAL - not final

Returns

Type	Description
IToolbarBuilder	A new toolbar builder which has been extended with this button

Remarks

History

Added in 2sxc 13
contentTypes changed from one to many in v14
contentTypes can also have * or SomeType,* in v14
contentTypes can also be optional, in which case it behaves as if it was * in v14 - if no config is found, it will not add a metadata-button
parameter context added in 2sxc 14 - still WIP/experimental
changed ui and parameters to support object in v14.04

| Improve this Doc View Source

More(String, Object)

Add a more button. Not really useful to do, but included for completeness

Declaration

IToolbarBuilder More(string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null)

Parameters

Type	Name	Description
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

MoveDown(Object, String, Object, Object, String)

Create button to move an item down in a list. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder MoveDown(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target which is in a list of items in on a content-block, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

MoveUp(Object, String, Object, Object, String)

Create button to move an item up in a list. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder MoveUp(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target which is in a list of items in on a content-block, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

New(Object, String, Object, Object, Object, String)

Create button to create a new item. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder New(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, object prefill = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	X Options an entity-like target, see target guide a string with the content-type name
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.Object	prefill	optional prefill for the edit-UI, see prefill guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Parameters(Object, String, Object, Object, Object, String)

Adds / updates the params rule on the toolbar which contains information for all the buttons

Declaration

IToolbarBuilder Parameters(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, object prefill = null, string context = null)

Parameters

Type	Name	Description
System.Object	target	Many options An Entity-like thing which would be used to prepare default params like `entityId` A string, which would be the same as using the term on the `parameters` A object - especially an anonymous object like `new { id = 7, show = true }`
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.Object	prefill	optional prefill for the edit-UI, see prefill guide
System.String	context

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Publish(Object, String, Object, Object, String)

Create button to publish the current item. Can also be used to remove the same button on a toolbar which would have it by default. By default it will only appear if the current item is draft/unpublished. You can change this (but probably shouldn't) by setting an operation.

Declaration

IToolbarBuilder Publish(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Query(Object, String, Object, Object, String)

Create Button to open the design/edit query dialog. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Query(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Remove(Object, String, Object, Object, String)

Create button to remove an item from a list. Can also be used to remove the same button on a toolbar which would have it by default. This will not delete the item, just remove.

Declaration

IToolbarBuilder Remove(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target which is in a list of items in on a content-block, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Replace(Object, String, Object, Object, String)

Create button to replace the current item in the list with another existing item. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Replace(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	optional entity-like target which is in a list of items in on a content-block, see target guide
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Settings(String, String, String, String, String, String, Object, Object)

Add a settings rule to configure what the toolbar should look like. See Toolbar Settings

Declaration

IToolbarBuilder Settings(string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", string show = null, string hover = null, string follow = null, string classes = null, string autoAddMore = null, object ui = null, object parameters = null)

Parameters

Type	Name	Description
System.String	noParamOrder	see Convention: Named Parameters
System.String	show	`hover` (default), `always`
System.String	hover	`right` (default), `left`
System.String	follow
System.String	classes	css class names to add to the entire toolbar
System.String	autoAddMore	placement of the more ellipsis button, `auto` (default), `end`, `start`, `never`
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	Parameters for the command - doesn't really have an effect on Settings, but included for consistency

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

Remarks

History

Added in 2sxc 13
options auto and never on autoAddMore added in 14.08

| Improve this Doc View Source

System(Object, String, Object, Object, String)

Create button to open the system admin dialog. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder System(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target	not used ATM just here for API consistency
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen. By default, the button will show based on conditions like permissions.

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

Template(Object, String, Object, Object, String)

Create Button to open the edit-template (source-code) dialog. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder Template(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide

| Improve this Doc View Source

View(Object, String, Object, Object, String)

Create Button to open the edit view settings dialog. Can also be used to remove the same button on a toolbar which would have it by default.

Declaration

IToolbarBuilder View(object target = null, string noParamOrder = "Rule: All params must be named (https://r.2sxc.org/named-params)", object ui = null, object parameters = null, string operation = null)

Parameters

Type	Name	Description
System.Object	target
System.String	noParamOrder	see Convention: Named Parameters
System.Object	ui	optional configuration how to show, see ui guide
System.Object	parameters	optional parameters for the command, see parameters guide
System.String	operation	optional change what should happen

Returns

Type	Description
IToolbarBuilder	a new toolbar builder - see guide