({{, (RefLink[Manipulator, paclet:ref/Manipulator])[x]
represents a manipulator with setting x in the range 0 to 1. }, {, (RefLink[Manipulator, paclet:ref/Manipulator])[(RefLink[Dynamic, paclet:ref/Dynamic])[x]]
takes the setting to be the dynamically updated current value of x, with the value of x being reset if the manipulator is moved. }, {, (RefLink[Manipulator, paclet:ref/Manipulator])[x,{(Subscript[x, min]),(Subscript[x, max])}]
represents a manipulator with range (Subscript[x, min]) to (Subscript[x, max]). }, {, (RefLink[Manipulator, paclet:ref/Manipulator])[x,{(Subscript[x, min]),(Subscript[x, max]),dx}]
represents a manipulator that jumps in steps dx. }})

OpenersNotesSection(Spacer1)Details and Options

(RefLink[Manipulator, paclet:ref/Manipulator])[…] displays in a notebook as a horizontal slider and a collection of additional controls that can be manipulated interactively.

(RefLink[Manipulator, paclet:ref/Manipulator])[(RefLink[Dynamic, paclet:ref/Dynamic])[x]] will reset the value of x when the manipulator setting is changed; (RefLink[Manipulator, paclet:ref/Manipulator])[x] will not. »

(RefLink[Manipulate, paclet:ref/Manipulate]) by default generates (RefLink[Manipulator, paclet:ref/Manipulator]) objects for variables that are specified to have ranges of possible values.

The following options can be given:

Possible settings for (RefLink[Appearance, paclet:ref/Appearance]) include (RefLink[Tiny, paclet:ref/Tiny]), (RefLink[Small, paclet:ref/Small]), (RefLink[Medium, paclet:ref/Medium]), and (RefLink[Large, paclet:ref/Large]). Other possible settings include "Open" and "Closed", or combinations such as {"Open",(RefLink[Small, paclet:ref/Small])}.

(RefLink[Appearance, paclet:ref/Appearance])->"Labeled" displays the current value of the manipulator as an editable label.

The following elements are included in a default manipulator: "InputField", "StepLeftButton", "PlayPauseButton", "StepRightButton", "FasterSlowerButtons", "DirectionButton", "InlineInputField". These elements can be specified in any order in a list given as the setting for (RefLink[AppearanceElements, paclet:ref/AppearanceElements]).

(RefLink[Manipulator, paclet:ref/Manipulator])[] is equivalent to (RefLink[Manipulator, paclet:ref/Manipulator])[0].

OpenersPrimaryExamplesSection(Spacer1)Examples  (26)

OpenersExampleSection0(Spacer1)Basic Examples  (4)

Default and nondefault initial states:

{Manipulator[],Manipulator[0.8]}

Dynamically change the value of x:

{Manipulator[Dynamic[x]],Dynamic[x]}

Specify a range:

{Manipulator[Dynamic[x],{3,7}],Dynamic[x]}

Specify a step size and range:

{Manipulator[Dynamic[x],{3,7,0.5}],Dynamic[x]}

OpenersExampleSection1(Spacer1)Scope  (4)

Use only integer values:

{Manipulator[Dynamic[x],{0,100,1}],Dynamic[x]}

Use symbolic range:

{Manipulator[Dynamic[x],{0,t,0.2t}],Dynamic[x]}

View the animation controls:

Manipulator[0.8,Appearance->"Open"]

Parameters that are neither numeric nor (RefLink[Dynamic, paclet:ref/Dynamic]) do not display as a manipulator:

Manipulator[x]

OpenersExampleSection2(Spacer1)Options  (16)

OpenersExampleSubsection0(Spacer1)AnimationDirection  (1)

Specify the direction for animation when the play button is clicked:

Table[Manipulator[0.4,Appearance->"Open",AnimationDirection->d],{d,{Forward,Backward,ForwardBackward}}]

OpenersExampleSubsection1(Spacer1)AnimationRate  (1)

Change the rate of animation when the play button is clicked:

Table[Manipulator[0.4,Appearance->"Open",AnimationRate->r],{r,{0.01,0.1,0.5,1}}]

OpenersExampleSubsection2(Spacer1)Appearance  (3)

Use preset values:

Table[Manipulator[0.5,Appearance->a],{a,{Tiny,Small,Medium,Large}}]

Open or close the element area:

Table[Manipulator[0.5,Appearance->a],{a,{"Open","Closed"}}]

Combine the two appearance options:

Manipulator[0.5,Appearance->{"Open",Tiny}]

OpenersExampleSubsection3(Spacer1)AppearanceElements  (3)

Specify which control elements should appear below the slider:

Manipulator[0.8,Appearance->"Open",AppearanceElements->{"StepRightButton","PlayPauseButton","FasterSlowerButtons"}]

All possible appearance elements:

Table[Manipulator[0.8,Appearance->"Open",AppearanceElements->{ae}],{ae,{"InputField","StepLeftButton","PlayPauseButton","StepRightButton","FasterSlowerButtons","DirectionButton"}}]

A random choice of appearance elements:

Manipulator[0.8,Appearance->"Open",AppearanceElements->RandomChoice[{"InputField","StepLeftButton","PlayPauseButton","StepRightButton","FasterSlowerButtons","DirectionButton"},2]]

OpenersExampleSubsection4(Spacer1)AutoAction  (2)

By default, the manipulator responds to mouse clicks:

Manipulator[]

By setting (RefLink[AutoAction, paclet:ref/AutoAction]), values will change when the mouse moves over the manipulator:

Manipulator[AutoAction->True]

OpenersExampleSubsection5(Spacer1)ContinuousAction  (2)

By default, variables are continuously updated:

{Manipulator[Dynamic[x]],Dynamic[x]}

Make variables update only when the mouse is released:

{Manipulator[Dynamic[x],ContinuousAction->False],Dynamic[x]}

OpenersExampleSubsection6(Spacer1)Enabled  (1)

By default (RefLink[Manipulator, paclet:ref/Manipulator]) is enabled:

Manipulator[0.5]

By setting (RefLink[Enabled, paclet:ref/Enabled])->(RefLink[False, paclet:ref/False]), the manipulator is disabled but visible in its current state:

Manipulator[0.3,Enabled->False]

OpenersExampleSubsection7(Spacer1)Exclusions  (1)

Exclude values from the range:

{Manipulator[Dynamic[x],{0,5,1},Exclusions->{2,4}],Dynamic[x]}

OpenersExampleSubsection8(Spacer1)ImageSize  (2)

Control the size using preset values only:

Table[Manipulator[.3,ImageSize->s],{s,{Tiny,Small,Medium,Large}}]//Column

Or use any values:

Column[Table[Manipulator[0.5,ImageSize->i],{i,{50,150,300,500}}]]

OpenersExampleSection3(Spacer1)Applications  (1)

Modulate the frequency:

DynamicModule[{f=1},{Manipulator[Dynamic[f],{0.25,5}],Dynamic[Plot[Sin[f x],{x,-2π,2π}]]}]

OpenersExampleSection4(Spacer1)Properties & Relations  (1)

(RefLink[Manipulate, paclet:ref/Manipulate]) automatically uses (RefLink[Manipulator, paclet:ref/Manipulator]) controls:

{Manipulate[a,{a,0,10}],
Column[{Manipulator[Dynamic[b],{0,10}],Dynamic[b]}]}

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[Slider, paclet:ref/Slider])  ▪  (RefLink[Animator, paclet:ref/Animator])  ▪  (RefLink[Manipulate, paclet:ref/Manipulate])  ▪  (RefLink[Control, paclet:ref/Control])}})}})

({{DocumentationFooterIconsRelatedTutorial.png, ({{Tutorials}, {▪(RefLinkPlain[Introduction to Dynamic, paclet:tutorial/IntroductionToDynamic])}, {▪(RefLinkPlain[Introduction to Control Objects, paclet:tutorial/IntroductionToControlObjects])}, {▪(RefLinkPlain[Advanced Dynamic Functionality, paclet:tutorial/AdvancedDynamicFunctionality])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Control Objects, paclet:guide/ControlObjects])}, {▪(RefLinkPlain[Dynamic Interactivity Language, paclet:guide/DynamicInteractivityLanguage])}})}})