Go to: Synopsis. Return value. Related. Flags. MEL examples.

Synopsis

listAttr [-array] [-caching] [-changedSinceFileOpen] [-channelBox] [-connectable] [-hasData] [-hasNullData] [-keyable] [-leaf] [-locked] [-multi] [-output] [-ramp] [-read] [-readOnly] [-scalar] [-scalarAndArray] [-settable] [-shortNames] [-string string] [-unlocked] [-usedAsFilename] [-userDefined] [-visible] [-write] [objects]

listAttr is undoable, NOT queryable, and NOT editable.

This command lists the attributes of a node. If no flags are specified all attributes are listed.

Return value

string[] : List of attributes matching criteria

Related

addAttr, attributeInfo, attributeQuery, connectAttr, disconnectAttr, getAttr, setAttr

Flags

array, caching, changedSinceFileOpen, channelBox, connectable, hasData, hasNullData, keyable, leaf, locked, multi, output, ramp, read, readOnly, scalar, scalarAndArray, settable, shortNames, string, unlocked, usedAsFilename, userDefined, visible, write
Long name (short name) Argument types Properties
-read(-r) create
list only attributes which are readable
-write(-w) create
list only attributes which are writable
-scalar(-s) create
only list scalar numerical attributes
-array(-a) create
only list array (not multi) attributes
-scalarAndArray(-sa) create
only list scalar and array attributes
-visible(-v) create
only show visible or non-hidden attributes
-connectable(-c) create
only show connectable attributes
-keyable(-k) create
only show attributes that can be keyframed
-channelBox(-cb) create
only show non-keyable attributes that appear in the channelbox
-caching(-ca) create
only show attributes that are cached internally
-multi(-m) create
list each currently existing element of a multi-attribute
-locked(-l) create
list only attributes which are locked
-unlocked(-u) create
list only attributes which are unlocked
-userDefined(-ud) create
list user-defined (dynamic) attributes
-settable(-se) create
list attribute which are settable
-shortNames(-sn) create
list short attribute names (default is to list long names)
-string(-st) string createmultiuse
List only the attributes that match the other criteria AND match the string(s) passed from this flag
-readOnly(-ro) create
List only the attributes which are readable and not writable.
-output(-o) create
List only the attributes which are numeric or which are compounds of numeric attributes.
-hasData(-hd) create
list only attributes that have data (all attributes except for message attributes)
-hasNullData(-hnd) create
list only attributes that have null data. This will list all attributes that have data (see hasData flag) but the data value is uninitialized. A common example where an attribute may have null data is when a string attribute is created but not yet assigned an initial value. Similarly array attribute data is often null until it is initialized.
-leaf(-lf) create
Only list the leaf-level name of the attribute. controlPoints[44].xValue would be listed as "xValue".
-changedSinceFileOpen(-cfo) create
Only list the attributes that have been changed since the file they came from was opened. Typically useful only for objects/attributes coming from referenced files.
-ramp(-ra) create
list only attributes which are ramps
-usedAsFilename(-uf) create
list only attributes which are designated to be treated as filenames

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can be used more than once in a command.

MEL examples

listAttr -r -s;
     // This will list the scalar readable attributes of the
     // selected nodes.  If more than one node is selected attributes
     // may be listed several times.

listAttr -s -r -w -c -st centerX -st centerY;
     // This will list all scalar, readable, writable, and connectable
     // attributes whose names are "centerX" or "centerY".

listAttr -s -cfo nurbsSphere1;
     // This will list all scalar attributes of
     // nurbsSphere1 that have been changed since the
     // file in which nurbsSphere1 is defined has been
     // opened.  If nurbsSphere1 comes from a referenced file,
     // the result will be all the attributes that have changed
       // since the referenced file was opened.