前言
TextView组件在android开发中使用频率是非常高的了,如果对它的属性很了解的话,开发中无疑可以节省很多时间和精力。要查看它的属性,正确的姿势自然是refer to官方文档了。但是官方文档不仅被墙而且是英文的,怎么看都有些蛋疼。下面整理了一篇别人的劳动成果(见文章末尾)。
属性解析
android:autoLink设置是否当文本为URL链接/email/电话号码/map时,文本显示为可点击的链接。可选值(none/web/email/phone/map/all)
android:autoText如果设置,将自动执行输入值的拼写纠正。此处无效果,在显示输入法并输入的时候起作用。
android:bufferType指定getText()方式取得的文本类别。选项editable 类似于StringBuilder可追加字符,
也就是说getText后可调用append方法设置文本内容。spannable 则可在给定的字符区域使用样式。
android:capitalize设置英文字母大写类型。此处无效果,需要弹出输入法才能看得到,参见EditView此属性说明。
android:cursorVisible设定光标为显示/隐藏,默认显示。
android:digits设置允许输入哪些字符。如“1234567890.+-*/% ()”
android:drawableBottom在text的下方输出一个drawable,如图片。如果指定一个颜色的话会把text的背景设为该颜色,并且同时和background使用时覆盖后者。
android:drawableLeft在text的左边输出一个drawable,如图片。
android:drawablePadding设置text与drawable(图片)的间隔,与drawableLeft、drawableRight、drawableTop、drawableBottom一起使用,可设置为负数,单独使用没有效果。
android:drawableRight在text的右边输出一个drawable。
android:drawableTop在text的正上方输出一个drawable。
android:editable设置是否可编辑。
android:editorExtras设置文本的额外的输入数据。
android:ellipsize设置当文字过长时,该控件该如何显示。有如下值设置:
- ”start”—省略号显示在开头;
- ”end”——省略号显示在结尾;
- ”middle”—-省略号显示在中间;
- ”marquee” ——以跑马灯的方式显示(动画横向移动)
android:marqueeRepeatLimit在ellipsize指定marquee的情况下,设置重复滚动的次数,当设置为marquee_forever时表示无限次。
android:freezesText设置保存文本的内容以及光标的位置。
android:gravity设置文本位置,如设置成“center”,文本将居中显示。
android:hintText为空时显示的文字提示信息,可通过textColorHint设置提示信息的颜色。此属性在EditView中使用,但是这里也可以用。
android:imeOptions附加功能,设置右下角IME动作与编辑框相关的动作,如actionDone右下角将显示一个“完成”,而不设置默认是一个回车符号。这个在EditView中再详细
说明。
android:imeActionId设置IME动作ID。
android:imeActionLabel设置IME动作标签。
android:includeFontPadding设置文本是否包含顶部和底部额外空白,默认为true。
android:inputMethod为文本指定输入法,需要完全限定名(完整的包名)。例如:com.google.android.inputmethod.pinyin,但是有时会报错找不到。
android:inputType设置文本的类型,用于帮助输入法显示合适的键盘类型。在EditView中再详细说明,这里无效果。
android:linksClickable设置链接是否点击连接,若设置为false,即使设置了autoLink也不可链接。
android:ems设置TextView的宽度为N个字符的宽度。这里测试为一个汉字字符宽度
android:maxEms设置TextView的宽度为最长为N个字符的宽度。与ems同时使用时覆盖ems选项。
android:minEms设置TextView的宽度为最短为N个字符的宽度。与ems同时使用时覆盖ems选项。
android:maxLength限制显示的文本长度,超出部分不显示。
android:lines设置文本的行数,设置两行就显示两行,即使第二行没有数据。
android:maxLines设置文本的最大显示行数,与width或者layout_width结合使用,超出部分自动换行,超出行数将不显示。
android:minLines设置文本的最小行数,与lines类似。
android:lineSpacingExtra设置行间距。
android:lineSpacingMultiplier设置行间距的倍数。如”1.2”
android:numeric如果被设置,该TextView有一个数字输入法。此处无用,设置后唯一效果是TextView有点击效果,此属性在EdtiView将详细说明。
android:password以小点”.”显示文本
android:phoneNumber设置为电话号码的输入方式。
android:privateImeOptions设置输入法选项,此处无用,在EditText将进一步讨论。
android:scrollHorizontally设置文本超出TextView的宽度的情况下,是否出现横拉条。
android:selectAllOnFocus如果文本是可选择的,让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。TextView中设置后无效果。
android:shadowColor指定文本阴影的颜色,需要与shadowRadius一起使用。
android:shadowDx设置阴影横向坐标开始位置。
android:shadowDy设置阴影纵向坐标开始位置。
android:shadowRadius设置阴影的半径。设置为0.1就变成字体的颜色了,一般设置为3.0的效果比较好。
android:singleLine设置单行显示。如果和layoutwidth一起使用,当文本不能全部显示时,后面用“…”来表示。如android:text=”test singleLine “
- android:singleLine=”true” android:layout_width=”20dp”将只显示“t…”。如果不设置singleLine或者设置为false,文本将自动换行
android:text设置显示文本.
android:textAppearance设置文字外观。如“?android:attr/textAppearanceLargeInverse”这里引用的是系统自带的一个外观,?表示系统是否有这种外观,否则使用默认的外观。可设置的值如下: - textAppearanceButton
- textAppearanceInverse
- textAppearanceLarge
- textAppearanceLargeInverse
- textAppearanceMedium
- textAppearanceMediumInverse
- textAppearanceSmall
- textAppearanceSmallInverse
android:textColor设置文本颜色
android:textColorHighlight被选中文字的底色,默认为蓝色
android:textColorHint设置提示信息文字的颜色,默认为灰色。与hint一起使用。
android:textColorLink文字链接的颜色.
android:textScaleX设置文字之间间隔,默认为1.0f。
android:textSize设置文字大小,推荐度量单位”sp”,如”15sp”
android:textStyle设置字形[bold(粗体) 0, italic(斜体) 1, bolditalic(又粗又斜) 2] 可以设置一个或多个,用“|”隔开
android:typeface设置文本字体,必须是以下常量值之一:normal 0, sans 1, serif 2, monospace(等宽字体) 3]
android:height设置文本区域的高度,支持度量单位:px(像素)/dp/sp/in/mm(毫米)
android:maxHeight设置文本区域的最大高度
android:minHeight设置文本区域的最小高度
android:width设置文本区域的宽度,支持度量单位:px(像素)/dp/sp/in/mm(毫米),与layout_width的区别看这里。
android:maxWidth设置文本区域的最大宽度
android:minWidth设置文本区域的最小宽度
使用示例
1.单行显示,超出到部分用省略号显示,需要设置到属性如下:
2.设置超出11个长度时显示省略号:
颜色码参考
颜色名 | 十六进制颜色值 | 颜色 |
---|---|---|
AliceBlue | #F0F8FF | rgb(240, 248, 255) |
AntiqueWhite | #FAEBD7 | rgb(250, 235, 215) |
Aqua | #00FFFF | rgb(0, 255, 255) |
Aquamarine | #7FFFD4 | rgb(127, 255, 212) |
Azure | #F0FFFF | rgb(240, 255, 255) |
Beige | #F5F5DC | rgb(245, 245, 220) |
Bisque | #FFE4C4 | rgb(255, 228, 196) |
Black | #000000 | rgb(0, 0, 0) |
BlanchedAlmond | #FFEBCD | rgb(255, 235, 205) |
Blue | #0000FF | rgb(0, 0, 255) |
BlueViolet | #8A2BE2 | rgb(138, 43, 226) |
Brown | #A52A2A | rgb(165, 42, 42) |
BurlyWood | #DEB887 | rgb(222, 184, 135) |
CadetBlue | #5F9EA0 | rgb(95, 158, 160) |
Chartreuse | #7FFF00 | rgb(127, 255, 0) |
Chocolate | #D2691E | rgb(210, 105, 30) |
Coral | #FF7F50 | rgb(255, 127, 80) |
CornflowerBlue | #6495ED | rgb(100, 149, 237) |
Cornsilk | #FFF8DC | rgb(255, 248, 220) |
Crimson | #DC143C | rgb(220, 20, 60) |
Cyan | #00FFFF | rgb(0, 255, 255) |
DarkBlue | #00008B | rgb(0, 0, 139) |
DarkCyan | #008B8B | rgb(0, 139, 139) |
DarkGoldenRod | #B8860B | rgb(184, 134, 11) |
DarkGray | #A9A9A9 | rgb(169, 169, 169) |
DarkGreen | #006400 | rgb(0, 100, 0) |
DarkKhaki | #BDB76B | rgb(189, 183, 107) |
DarkMagenta | #8B008B | rgb(139, 0, 139) |
DarkOliveGreen | #556B2F | rgb(85, 107, 47) |
Darkorange | #FF8C00 | rgb(255, 140, 0) |
DarkOrchid | #9932CC | rgb(153, 50, 204) |
DarkRed | #8B0000 | rgb(139, 0, 0) |
DarkSalmon | #E9967A | rgb(233, 150, 122) |
DarkSeaGreen | #8FBC8F | rgb(143, 188, 143) |
DarkSlateBlue | #483D8B | rgb(72, 61, 139) |
DarkSlateGray | #2F4F4F | rgb(47, 79, 79) |
DarkTurquoise | #00CED1 | rgb(0, 206, 209) |
DarkViolet | #9400D3 | rgb(148, 0, 211) |
DeepPink | #FF1493 | rgb(255, 20, 147) |
DeepSkyBlue | #00BFFF | rgb(0, 191, 255) |
DimGray | #696969 | rgb(105, 105, 105) |
DodgerBlue | #1E90FF | rgb(30, 144, 255) |
Feldspar | #D19275 | rgb(209, 146, 117) |
FireBrick | #B22222 | rgb(178, 34, 34) |
FloralWhite | #FFFAF0 | rgb(255, 250, 240) |
ForestGreen | #228B22 | rgb(34, 139, 34) |
Fuchsia | #FF00FF | rgb(255, 0, 255) |
Gainsboro | #DCDCDC | rgb(220, 220, 220) |
GhostWhite | #F8F8FF | rgb(248, 248, 255) |
Gold | #FFD700 | rgb(255, 215, 0) |
GoldenRod | #DAA520 | rgb(218, 165, 32) |
Gray | #808080 | rgb(128, 128, 128) |
Green | #008000 | rgb(0, 128, 0) |
GreenYellow | #ADFF2F | rgb(173, 255, 47) |
HoneyDew | #F0FFF0 | rgb(240, 255, 240) |
HotPink | #FF69B4 | rgb(255, 105, 180) |
IndianRed | #CD5C5C | rgb(205, 92, 92) |
Indigo | #4B0082 | rgb(75, 0, 130) |
Ivory | #FFFFF0 | rgb(255, 255, 240) |
Khaki | #F0E68C | rgb(240, 230, 140) |
Lavender | #E6E6FA | rgb(230, 230, 250) |
LavenderBlush | #FFF0F5 | rgb(255, 240, 245) |
LawnGreen | #7CFC00 | rgb(124, 252, 0) |
LemonChiffon | #FFFACD | rgb(255, 250, 205) |
LightBlue | #ADD8E6 | rgb(173, 216, 230) |
LightCoral | #F08080 | rgb(240, 128, 128) |
LightCyan | #E0FFFF | rgb(224, 255, 255) |
LightGoldenRodYellow | #FAFAD2 | rgb(250, 250, 210) |
LightGrey | #D3D3D3 | rgb(211, 211, 211) |
LightGreen | #90EE90 | rgb(144, 238, 144) |
LightPink | #FFB6C1 | rgb(255, 182, 193) |
LightSalmon | #FFA07A | rgb(255, 160, 122) |
LightSeaGreen | #20B2AA | rgb(32, 178, 170) |
LightSkyBlue | #87CEFA | rgb(135, 206, 250) |
LightSlateBlue | #8470FF | rgb(132, 112, 255) |
LightSlateGray | #778899 | rgb(119, 136, 153) |
LightSteelBlue | #B0C4DE | rgb(176, 196, 222) |
LightYellow | #FFFFE0 | rgb(255, 255, 224) |
Lime | #00FF00 | rgb(0, 255, 0) |
LimeGreen | #32CD32 | rgb(50, 205, 50) |
Linen | #FAF0E6 | rgb(250, 240, 230) |
Magenta | #FF00FF | rgb(255, 0, 255) |
Maroon | #800000 | rgb(128, 0, 0) |
MediumAquaMarine | #66CDAA | rgb(102, 205, 170) |
MediumBlue | #0000CD | rgb(0, 0, 205) |
MediumOrchid | #BA55D3 | rgb(186, 85, 211) |
MediumPurple | #9370D8 | rgb(147, 112, 216) |
MediumSeaGreen | #3CB371 | rgb(60, 179, 113) |
MediumSlateBlue | #7B68EE | rgb(123, 104, 238) |
MediumSpringGreen | #00FA9A | rgb(0, 250, 154) |
MediumTurquoise | #48D1CC | rgb(72, 209, 204) |
MediumVioletRed | #C71585 | rgb(199, 21, 133) |
MidnightBlue | #191970 | rgb(25, 25, 112) |
MintCream | #F5FFFA | rgb(245, 255, 250) |
MistyRose | #FFE4E1 | rgb(255, 228, 225) |
Moccasin | #FFE4B5 | rgb(255, 228, 181) |
NavajoWhite | #FFDEAD | rgb(255, 222, 173) |
Navy | #000080 | rgb(0, 0, 128) |
OldLace | #FDF5E6 | rgb(253, 245, 230) |
Olive | #808000 | rgb(128, 128, 0) |
OliveDrab | #6B8E23 | rgb(107, 142, 35) |
Orange | #FFA500 | rgb(255, 165, 0) |
OrangeRed | #FF4500 | rgb(255, 69, 0) |
Orchid | #DA70D6 | rgb(218, 112, 214) |
PaleGoldenRod | #EEE8AA | rgb(238, 232, 170) |
PaleGreen | #98FB98 | rgb(152, 251, 152) |
PaleTurquoise | #AFEEEE | rgb(175, 238, 238) |
PaleVioletRed | #D87093 | rgb(216, 112, 147) |
PapayaWhip | #FFEFD5 | rgb(255, 239, 213) |
PeachPuff | #FFDAB9 | rgb(255, 218, 185) |
Peru | #CD853F | rgb(205, 133, 63) |
Pink | #FFC0CB | rgb(255, 192, 203) |
Plum | #DDA0DD | rgb(221, 160, 221) |
PowderBlue | #B0E0E6 | rgb(176, 224, 230) |
Purple | #800080 | rgb(128, 0, 128) |
Red | #FF0000 | rgb(255, 0, 0) |
RosyBrown | #BC8F8F | rgb(188, 143, 143) |
RoyalBlue | #4169E1 | rgb(65, 105, 225) |
SaddleBrown | #8B4513 | rgb(139, 69, 19) |
Salmon | #FA8072 | rgb(250, 128, 114) |
SandyBrown | #F4A460 | rgb(244, 164, 96) |
SeaGreen | #2E8B57 | rgb(46, 139, 87) |
SeaShell | #FFF5EE | rgb(255, 245, 238) |
Sienna | #A0522D | rgb(160, 82, 45) |
Silver | #C0C0C0 | rgb(192, 192, 192) |
SkyBlue | #87CEEB | rgb(135, 206, 235) |
SlateBlue | #6A5ACD | rgb(106, 90, 205) |
SlateGray | #708090 | rgb(112, 128, 144) |
Snow | #FFFAFA | rgb(255, 250, 250) |
SpringGreen | #00FF7F | rgb(0, 255, 127) |
SteelBlue | #4682B4 | rgb(70, 130, 180) |
Tan | #D2B48C | rgb(210, 180, 140) |
Teal | #008080 | rgb(0, 128, 128) |
Thistle | #D8BFD8 | rgb(216, 191, 216) |
Tomato | #FF6347 | rgb(255, 99, 71) |
Turquoise | #40E0D0 | rgb(64, 224, 208) |
Violet | #EE82EE | rgb(238, 130, 238) |
VioletRed | #D02090 | rgb(208, 32, 144) |
Wheat | #F5DEB3 | rgb(245, 222, 179) |
White | #FFFFFF | rgb(255, 255, 255) |
WhiteSmoke | #F5F5F5 | rgb(245, 245, 245) |
Yellow | #FFFF00 | rgb(255, 255, 0) |
YellowGreen | #9ACD32 | rgb(154, 205, 50) |