Go to: Synopsis. Flags. Return value. Related. Python examples.
listAttr(
[objects]
, [array=boolean], [caching=boolean], [changedSinceFileOpen=boolean], [channelBox=boolean], [connectable=boolean], [hasData=boolean], [keyable=boolean], [leaf=boolean], [locked=boolean], [multi=boolean], [output=boolean], [read=boolean], [readOnly=boolean], [scalar=boolean], [scalarAndArray=boolean], [settable=boolean], [shortNames=boolean], [string=string], [unlocked=boolean], [userDefined=boolean], [visible=boolean], [write=boolean])
Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.
listAttr is undoable, queryable, and editable.
This command lists the attributes of a node. If no flags are specified
all attributes are listed.
array, caching, changedSinceFileOpen, channelBox, connectable, hasData, keyable, leaf, locked, multi, output, read, readOnly, scalar, scalarAndArray, settable, shortNames, string, unlocked, userDefined, visible, write
| Long name (short name) |
[argument types] |
Properties |
read(r)
|
boolean
|
|
|
list only attributes which are readable
|
|
write(w)
|
boolean
|
|
|
list only attributes which are writable
|
|
scalar(s)
|
boolean
|
|
|
only list scalar numerical attributes
|
|
array(a)
|
boolean
|
|
|
only list array (not multi) attributes
|
|
scalarAndArray(sa)
|
boolean
|
|
|
only list scalar and array attributes
|
|
visible(v)
|
boolean
|
|
|
only show visible or non-hidden attributes
|
|
connectable(c)
|
boolean
|
|
|
only show connectable attributes
|
|
keyable(k)
|
boolean
|
|
|
only show attributes that can be keyframed
|
|
channelBox(cb)
|
boolean
|
|
|
only show non-keyable attributes that appear in the channelbox
|
|
caching(ca)
|
boolean
|
|
|
only show attributes that are cached internally
|
|
multi(m)
|
boolean
|
|
|
list each currently existing element of a multi-attribute
|
|
locked(l)
|
boolean
|
|
|
list only attributes which are locked
|
|
unlocked(u)
|
boolean
|
|
|
list only attributes which are unlocked
|
|
userDefined(ud)
|
boolean
|
|
|
list user-defined (dynamic) attributes
|
|
settable(se)
|
boolean
|
|
|
list attribute which are settable
|
|
shortNames(sn)
|
boolean
|
|
|
list short attribute names (default is to list long names)
|
|
string(st)
|
string
|
|
|
List only the attributes that match the other
criteria AND match the string(s) passed from this flag
|
|
readOnly(ro)
|
boolean
|
|
|
List only the attributes which are readable and not
writable.
|
|
output(o)
|
boolean
|
|
|
List only the attributes which are numeric or which
are compounds of numeric attributes.
|
|
hasData(hd)
|
boolean
|
|
|
list only attributes that have data (all attributes
except for message attributes)
|
|
leaf(lf)
|
boolean
|
|
|
Only list the leaf-level name of the attribute.
controlPoints[44].xValue would be listed as "xValue".
|
|
changedSinceFileOpen(cfo)
|
boolean
|
|
|
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.
|
|
|
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 have multiple arguments, passed either as a tuple or a list.
|
string[] : List of attributes matching criteria
addAttr, attributeInfo, attributeQuery, connectAttr, disconnectAttr, getAttr, setAttr
import maya.cmds as cmds
cmds.sphere()
cmds.listAttr( r=True, s=True )
# This will list the scalar readable attributes of the
# selected nodes. If more than one node is selected attributes
# may be listed several times.
cmds.listAttr( s=True, r=True, w=True, c=True, st=['centerX','centerY'] )
# This will list all scalar, readable, writable, and connectable
# attributes whose names are "centerX" or "centerY".
cmds.listAttr( 'nurbsSphere1', s=True, cfo=True )
# 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.