attrs.xml revision cc489cd904db41ba9f8efaec0fde0b2d259123d7
1<?xml version="1.0" encoding="utf-8"?> 2<!-- Copyright (C) 2012 The Android Open Source Project 3 4 Licensed under the Apache License, Version 2.0 (the "License"); 5 you may not use this file except in compliance with the License. 6 You may obtain a copy of the License at 7 8 http://www.apache.org/licenses/LICENSE-2.0 9 10 Unless required by applicable law or agreed to in writing, software 11 distributed under the License is distributed on an "AS IS" BASIS, 12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 See the License for the specific language governing permissions and 14 limitations under the License. 15--> 16 17<resources> 18 <!-- Many app-specific attributes are declared in this file. 19 Unless otherwise specified, they are intended to be set within 20 the context of a theme declaration. 21 22 Each cluster of attributes below states whether it is meant to 23 be set by the app and read by the system, or set by the system and 24 read by the app. --> 25 <eat-comment/> 26 27 28 <attr name="title" format="string"/> 29 <attr name="height" format="dimension"/> 30 <!-- Specifies whether the theme is light, otherwise it is dark. --> 31 <attr name="isLightTheme" format="boolean" /> 32 33 <!-- These are the standard attributes that make up a complete theme. --> 34 <declare-styleable name="Theme"> 35 36 <!-- ============= --> 37 <!-- Window styles --> 38 <!-- ============= --> 39 <eat-comment /> 40 41 <!-- Flag indicating whether this window should have an Action Bar 42 in place of the usual title bar. --> 43 <attr name="windowActionBar" format="boolean" /> 44 45 <!-- Flag indicating whether this window's Action Bar should overlay 46 application content. Does nothing if the window would not 47 have an Action Bar. --> 48 <attr name="windowActionBarOverlay" format="boolean" /> 49 50 <!-- Flag indicating whether action modes should overlay window content 51 when there is not reserved space for their UI (such as an Action Bar). --> 52 <attr name="windowActionModeOverlay" format="boolean" /> 53 54 <!-- A fixed width for the window along the major axis of the screen, 55 that is, when in landscape. Can be either an absolute dimension 56 or a fraction of the screen size in that dimension. --> 57 <attr name="windowFixedWidthMajor" format="dimension|fraction" /> 58 <!-- A fixed height for the window along the minor axis of the screen, 59 that is, when in landscape. Can be either an absolute dimension 60 or a fraction of the screen size in that dimension. --> 61 <attr name="windowFixedHeightMinor" format="dimension|fraction" /> 62 63 <!-- A fixed width for the window along the minor axis of the screen, 64 that is, when in portrait. Can be either an absolute dimension 65 or a fraction of the screen size in that dimension. --> 66 <attr name="windowFixedWidthMinor" format="dimension|fraction" /> 67 <!-- A fixed height for the window along the major axis of the screen, 68 that is, when in portrait. Can be either an absolute dimension 69 or a fraction of the screen size in that dimension. --> 70 <attr name="windowFixedHeightMajor" format="dimension|fraction" /> 71 72 <attr name="android:windowIsFloating" /> 73 <attr name="android:windowAnimationStyle" /> 74 75 <!-- =================== --> 76 <!-- Action bar styles --> 77 <!-- =================== --> 78 <eat-comment /> 79 <!-- Default style for tabs within an action bar --> 80 <attr name="actionBarTabStyle" format="reference" /> 81 <attr name="actionBarTabBarStyle" format="reference" /> 82 <attr name="actionBarTabTextStyle" format="reference" /> 83 <attr name="actionOverflowButtonStyle" format="reference" /> 84 <attr name="actionOverflowMenuStyle" format="reference" /> 85 <!-- Reference to a theme that should be used to inflate popups 86 shown by widgets in the action bar. --> 87 <attr name="actionBarPopupTheme" format="reference" /> 88 <!-- Reference to a style for the Action Bar --> 89 <attr name="actionBarStyle" format="reference" /> 90 <!-- Reference to a style for the split Action Bar. This style 91 controls the split component that holds the menu/action 92 buttons. actionBarStyle is still used for the primary 93 bar. --> 94 <attr name="actionBarSplitStyle" format="reference" /> 95 <!-- Reference to a theme that should be used to inflate the 96 action bar. This will be inherited by any widget inflated 97 into the action bar. --> 98 <attr name="actionBarTheme" format="reference" /> 99 <!-- Reference to a theme that should be used to inflate widgets 100 and layouts destined for the action bar. Most of the time 101 this will be a reference to the current theme, but when 102 the action bar has a significantly different contrast 103 profile than the rest of the activity the difference 104 can become important. If this is set to @null the current 105 theme will be used.--> 106 <attr name="actionBarWidgetTheme" format="reference" /> 107 <!-- Size of the Action Bar, including the contextual 108 bar used to present Action Modes. --> 109 <attr name="actionBarSize" format="dimension" > 110 <enum name="wrap_content" value="0" /> 111 </attr> 112 <!-- Custom divider drawable to use for elements in the action bar. --> 113 <attr name="actionBarDivider" format="reference" /> 114 <!-- Custom item state list drawable background for action bar items. --> 115 <attr name="actionBarItemBackground" format="reference" /> 116 <!-- TextAppearance style that will be applied to text that 117 appears within action menu items. --> 118 <attr name="actionMenuTextAppearance" format="reference" /> 119 <!-- Color for text that appears within action menu items. --> 120 <!-- Color for text that appears within action menu items. --> 121 <attr name="actionMenuTextColor" format="color|reference"/> 122 123 124 <!-- =================== --> 125 <!-- Action mode styles --> 126 <!-- =================== --> 127 <eat-comment/> 128 <attr name="actionModeStyle" format="reference"/> 129 <attr name="actionModeCloseButtonStyle" format="reference"/> 130 <!-- Background drawable to use for action mode UI --> 131 <attr name="actionModeBackground" format="reference"/> 132 <!-- Background drawable to use for action mode UI in the lower split bar --> 133 <attr name="actionModeSplitBackground" format="reference"/> 134 <!-- Drawable to use for the close action mode button --> 135 <attr name="actionModeCloseDrawable" format="reference"/> 136 <!-- Drawable to use for the Cut action button in Contextual Action Bar --> 137 <attr name="actionModeCutDrawable" format="reference"/> 138 <!-- Drawable to use for the Copy action button in Contextual Action Bar --> 139 <attr name="actionModeCopyDrawable" format="reference"/> 140 <!-- Drawable to use for the Paste action button in Contextual Action Bar --> 141 <attr name="actionModePasteDrawable" format="reference"/> 142 <!-- Drawable to use for the Select all action button in Contextual Action Bar --> 143 <attr name="actionModeSelectAllDrawable" format="reference"/> 144 <!-- Drawable to use for the Share action button in WebView selection action modes --> 145 <attr name="actionModeShareDrawable" format="reference"/> 146 <!-- Drawable to use for the Find action button in WebView selection action modes --> 147 <attr name="actionModeFindDrawable" format="reference"/> 148 <!-- Drawable to use for the Web Search action button in WebView selection action modes --> 149 <attr name="actionModeWebSearchDrawable" format="reference"/> 150 151 <!-- PopupWindow style to use for action modes when showing as a window overlay. --> 152 <attr name="actionModePopupWindowStyle" format="reference"/> 153 154 155 <!-- =================== --> 156 <!-- Text styles --> 157 <!-- =================== --> 158 <eat-comment /> 159 <!-- Text color, typeface, size, and style for the text inside of a popup menu. --> 160 <attr name="textAppearanceLargePopupMenu" format="reference"/> 161 <!-- Text color, typeface, size, and style for small text inside of a popup menu. --> 162 <attr name="textAppearanceSmallPopupMenu" format="reference"/> 163 164 165 <!-- =================== --> 166 <!-- Other widget styles --> 167 <!-- =================== --> 168 <eat-comment /> 169 170 <!-- Default ActionBar dropdown style. --> 171 <attr name="actionDropDownStyle" format="reference"/> 172 <!-- The preferred item height for dropdown lists. --> 173 <attr name="dropdownListPreferredItemHeight" format="dimension"/> 174 175 <!-- Default Spinner style. --> 176 <attr name="spinnerStyle" format="reference" /> 177 <!-- Default Spinner style. --> 178 <attr name="spinnerDropDownItemStyle" format="reference" /> 179 <!-- Specifies a drawable to use for the 'home as up' indicator. --> 180 <attr name="homeAsUpIndicator" format="reference"/> 181 182 <!-- Default action button style. --> 183 <attr name="actionButtonStyle" format="reference"/> 184 185 <!-- A style that may be applied to horizontal LinearLayouts 186 to form a button bar. --> 187 <attr name="buttonBarStyle" format="reference"/> 188 <!-- A style that may be applied to Buttons placed within a 189 LinearLayout with the style buttonBarStyle to form a button bar. --> 190 <attr name="buttonBarButtonStyle" format="reference"/> 191 <!-- A style that may be applied to buttons or other selectable items 192 that should react to pressed and focus states, but that do not 193 have a clear visual border along the edges. --> 194 <attr name="selectableItemBackground" format="reference"/> 195 <!-- Background drawable for borderless standalone items that need focus/pressed states. --> 196 <attr name="selectableItemBackgroundBorderless" format="reference" /> 197 <!-- A drawable that may be used as a vertical divider between visual elements. --> 198 <attr name="dividerVertical" format="reference"/> 199 <!-- A drawable that may be used as a horizontal divider between visual elements. --> 200 <attr name="dividerHorizontal" format="reference"/> 201 <!-- Default ActivityChooserView style. --> 202 <attr name="activityChooserViewStyle" format="reference" /> 203 204 <!-- Default Toolbar style. --> 205 <attr name="toolbarStyle" format="reference" /> 206 <!-- Default Toolar NavigationButtonStyle --> 207 <attr name="toolbarNavigationButtonStyle" format="reference" /> 208 209 <!-- Default PopupMenu style. --> 210 <attr name="popupMenuStyle" format="reference"/> 211 <!-- Default PopupWindow style. --> 212 <attr name="popupWindowStyle" format="reference" /> 213 214 <!-- EditText text foreground color. --> 215 <attr name="editTextColor" format="reference|color" /> 216 <!-- EditText background drawable. --> 217 <attr name="editTextBackground" format="reference" /> 218 219 <!-- Default style for the Switch widget. --> 220 <attr name="switchStyle" format="reference" /> 221 222 <!-- ============================ --> 223 <!-- SearchView styles and assets --> 224 <!-- ============================ --> 225 <eat-comment /> 226 <!-- Text color, typeface, size, and style for system search result title. Defaults to primary inverse text color. --> 227 <attr name="textAppearanceSearchResultTitle" format="reference" /> 228 <!-- Text color, typeface, size, and style for system search result subtitle. Defaults to primary inverse text color. --> 229 <attr name="textAppearanceSearchResultSubtitle" format="reference" /> 230 <!-- Text color for urls in search suggestions, used by things like global search --> 231 <attr name="textColorSearchUrl" format="reference|color" /> 232 <!-- Style for the search query widget. --> 233 <attr name="searchViewStyle" format="reference" /> 234 235 <!-- =========== --> 236 <!-- List styles --> 237 <!-- =========== --> 238 <eat-comment /> 239 240 <!-- The preferred list item height. --> 241 <attr name="listPreferredItemHeight" format="dimension"/> 242 <!-- A smaller, sleeker list item height. --> 243 <attr name="listPreferredItemHeightSmall" format="dimension"/> 244 <!-- A larger, more robust list item height. --> 245 <attr name="listPreferredItemHeightLarge" format="dimension"/> 246 247 <!-- The preferred padding along the left edge of list items. --> 248 <attr name="listPreferredItemPaddingLeft" format="dimension"/> 249 <!-- The preferred padding along the right edge of list items. --> 250 <attr name="listPreferredItemPaddingRight" format="dimension"/> 251 252 <!-- ListPopupWindow compatibility --> 253 <attr name="dropDownListViewStyle" format="reference"/> 254 <attr name="listPopupWindowStyle" format="reference"/> 255 256 <!-- The preferred TextAppearance for the primary text of list items. --> 257 <attr name="textAppearanceListItem" format="reference"/> 258 <!-- The preferred TextAppearance for the primary text of small list items. --> 259 <attr name="textAppearanceListItemSmall" format="reference"/> 260 261 262 <!-- ============ --> 263 <!-- Panel styles --> 264 <!-- ============ --> 265 <eat-comment /> 266 267 <!-- The background of a panel when it is inset from the left and right edges of the screen. --> 268 <attr name="panelBackground" format="reference" /> 269 <!-- Default Panel Menu width. --> 270 <attr name="panelMenuListWidth" format="dimension" /> 271 <!-- Default Panel Menu style. --> 272 <attr name="panelMenuListTheme" format="reference" /> 273 <!-- Drawable used as a background for selected list items. --> 274 <attr name="listChoiceBackgroundIndicator" format="reference" /> 275 276 <!-- ============= --> 277 <!-- Color palette --> 278 <!-- ============= --> 279 <eat-comment /> 280 281 <!-- The primary branding color for the app. By default, this is the color applied to the 282 action bar background. --> 283 <attr name="colorPrimary" format="color" /> 284 285 <!-- Dark variant of the primary branding color. By default, this is the color applied to 286 the status bar (via statusBarColor) and navigation bar (via navigationBarColor). --> 287 <attr name="colorPrimaryDark" format="color" /> 288 289 <!-- Bright complement to the primary branding color. By default, this is the color applied 290 to framework controls (via colorControlActivated). --> 291 <attr name="colorAccent" format="color" /> 292 293 <!-- The color applied to framework controls in their normal state. --> 294 <attr name="colorControlNormal" format="color" /> 295 296 <!-- The color applied to framework controls in their activated (ex. checked) state. --> 297 <attr name="colorControlActivated" format="color" /> 298 299 <!-- The color applied to framework control highlights (ex. ripples, list selectors). --> 300 <attr name="colorControlHighlight" format="color" /> 301 302 <!-- The color applied to framework buttons in their normal state. --> 303 <attr name="colorButtonNormal" format="color" /> 304 305 <!-- The color applied to framework switch thumbs in their normal state. --> 306 <attr name="colorSwitchThumbNormal" format="color" /> 307 308 </declare-styleable> 309 310 311 <!-- ============================================ --> 312 313 <!-- Attributes used to style the Action Bar. 314 These should be set on your theme; the default actionBarStyle will 315 propagate them to the correct elements as needed. 316 317 Please Note: when overriding attributes for an ActionBar style 318 you must specify each attribute twice: once with the "android:" 319 namespace prefix and once without. --> 320 <declare-styleable name="ActionBar"> 321 <!-- The type of navigation to use. --> 322 <attr name="navigationMode"> 323 <!-- Normal static title text --> 324 <enum name="normal" value="0"/> 325 <!-- The action bar will use a selection list for navigation. --> 326 <enum name="listMode" value="1"/> 327 <!-- The action bar will use a series of horizontal tabs for navigation. --> 328 <enum name="tabMode" value="2"/> 329 </attr> 330 <!-- Options affecting how the action bar is displayed. --> 331 <attr name="displayOptions"> 332 <flag name="none" value="0" /> 333 <flag name="useLogo" value="0x1"/> 334 <flag name="showHome" value="0x2"/> 335 <flag name="homeAsUp" value="0x4"/> 336 <flag name="showTitle" value="0x8"/> 337 <flag name="showCustom" value="0x10"/> 338 <flag name="disableHome" value="0x20"/> 339 </attr> 340 <!-- Specifies title text used for navigationMode="normal" --> 341 <attr name="title"/> 342 <!-- Specifies subtitle text used for navigationMode="normal" --> 343 <attr name="subtitle" format="string"/> 344 <!-- Specifies a style to use for title text. --> 345 <attr name="titleTextStyle" format="reference"/> 346 <!-- Specifies a style to use for subtitle text. --> 347 <attr name="subtitleTextStyle" format="reference"/> 348 <!-- Specifies the drawable used for the application icon. --> 349 <attr name="icon" format="reference"/> 350 <!-- Specifies the drawable used for the application logo. --> 351 <attr name="logo" format="reference"/> 352 <!-- Specifies the drawable used for item dividers. --> 353 <attr name="divider" format="reference"/> 354 <!-- Specifies a background drawable for the action bar. --> 355 <attr name="background" format="reference"/> 356 <!-- Specifies a background drawable for a second stacked row of the action bar. --> 357 <attr name="backgroundStacked" format="reference|color"/> 358 <!-- Specifies a background drawable for the bottom component of a split action bar. --> 359 <attr name="backgroundSplit" format="reference|color"/> 360 <!-- Specifies a layout for custom navigation. Overrides navigationMode. --> 361 <attr name="customNavigationLayout" format="reference"/> 362 <!-- Specifies a fixed height. --> 363 <attr name="height"/> 364 <!-- Specifies a layout to use for the "home" section of the action bar. --> 365 <attr name="homeLayout" format="reference"/> 366 <!-- Specifies a style resource to use for an embedded progress bar. --> 367 <attr name="progressBarStyle" format="reference"/> 368 <!-- Specifies a style resource to use for an indeterminate progress spinner. --> 369 <attr name="indeterminateProgressStyle" format="reference"/> 370 <!-- Specifies the horizontal padding on either end for an embedded progress bar. --> 371 <attr name="progressBarPadding" format="dimension"/> 372 <!-- Up navigation glyph --> 373 <attr name="homeAsUpIndicator" /> 374 <!-- Specifies padding that should be applied to the left and right sides of 375 system-provided items in the bar. --> 376 <attr name="itemPadding" format="dimension"/> 377 <!-- Set true to hide the action bar on a vertical nested scroll of content. --> 378 <attr name="hideOnContentScroll" format="boolean"/> 379 <!-- Minimum inset for content views within a bar. Navigation buttons and 380 menu views are excepted. Only valid for some themes and configurations. --> 381 <attr name="contentInsetStart" format="dimension"/> 382 <!-- Minimum inset for content views within a bar. Navigation buttons and 383 menu views are excepted. Only valid for some themes and configurations. --> 384 <attr name="contentInsetEnd" format="dimension"/> 385 <!-- Minimum inset for content views within a bar. Navigation buttons and 386 menu views are excepted. Only valid for some themes and configurations. --> 387 <attr name="contentInsetLeft" format="dimension"/> 388 <!-- Minimum inset for content views within a bar. Navigation buttons and 389 menu views are excepted. Only valid for some themes and configurations. --> 390 <attr name="contentInsetRight" format="dimension"/> 391 <!-- Elevation for the action bar itself --> 392 <attr name="elevation" format="dimension" /> 393 <!-- Reference to a theme that should be used to inflate popups 394 shown by widgets in the action bar. --> 395 <attr name="popupTheme" format="reference" /> 396 </declare-styleable> 397 398 <!-- Valid LayoutParams for views placed in the action bar as custom views. --> 399 <declare-styleable name="ActionBarLayout"> 400 <attr name="android:layout_gravity"/> 401 </declare-styleable> 402 403 <declare-styleable name="ActionMenuItemView"> 404 <attr name="android:minWidth"/> 405 </declare-styleable> 406 407 <declare-styleable name="ActionMode"> 408 <!-- Specifies a style to use for title text. --> 409 <attr name="titleTextStyle"/> 410 <!-- Specifies a style to use for subtitle text. --> 411 <attr name="subtitleTextStyle"/> 412 <!-- Specifies a background for the action mode bar. --> 413 <attr name="background"/> 414 <!-- Specifies a background for the split action mode bar. --> 415 <attr name="backgroundSplit"/> 416 <!-- Specifies a fixed height for the action mode bar. --> 417 <attr name="height"/> 418 <!-- Specifies a layout to use for the "close" item at the starting edge. --> 419 <attr name="closeItemLayout" format="reference" /> 420 </declare-styleable> 421 422 <declare-styleable name="View"> 423 <!-- Sets the padding, in pixels, of the start edge; see {@link android.R.attr#padding}. --> 424 <attr name="paddingStart" format="dimension"/> 425 <!-- Sets the padding, in pixels, of the end edge; see {@link android.R.attr#padding}. --> 426 <attr name="paddingEnd" format="dimension"/> 427 428 <!-- Boolean that controls whether a view can take focus. By default the user can not 429 move focus to a view; by setting this attribute to true the view is 430 allowed to take focus. This value does not impact the behavior of 431 directly calling {@link android.view.View#requestFocus}, which will 432 always request focus regardless of this view. It only impacts where 433 focus navigation will try to move focus. --> 434 <attr name="android:focusable" /> 435 436 <!-- Deprecated. --> 437 <attr name="theme" format="reference" /> 438 439 <!-- Specifies a theme override for a view. When a theme override is set, the 440 view will be inflated using a {@link android.content.Context} themed with 441 the specified resource. --> 442 <attr name="android:theme" /> 443 444 </declare-styleable> 445 446 <declare-styleable name="MenuView"> 447 <!-- Default appearance of menu item text. --> 448 <attr name="android:itemTextAppearance"/> 449 <!-- Default horizontal divider between rows of menu items. --> 450 <attr name="android:horizontalDivider"/> 451 <!-- Default vertical divider between menu items. --> 452 <attr name="android:verticalDivider"/> 453 <!-- Default background for the menu header. --> 454 <attr name="android:headerBackground"/> 455 <!-- Default background for each menu item. --> 456 <attr name="android:itemBackground"/> 457 <!-- Default animations for the menu. --> 458 <attr name="android:windowAnimationStyle"/> 459 <!-- Default disabled icon alpha for each menu item that shows an icon. --> 460 <attr name="android:itemIconDisabledAlpha"/> 461 <!-- Whether space should be reserved in layout when an icon is missing. --> 462 <attr name="preserveIconSpacing" format="boolean" /> 463 </declare-styleable> 464 <declare-styleable name="ActionMenuView"> 465 <!-- Size of padding on either end of a divider. --> 466 </declare-styleable> 467 468 <!-- Base attributes that are available to all groups. --> 469 <declare-styleable name="MenuGroup"> 470 471 <!-- The ID of the group. --> 472 <attr name="android:id" /> 473 474 <!-- The category applied to all items within this group. 475 (This will be or'ed with the orderInCategory attribute.) --> 476 <attr name="android:menuCategory" /> 477 478 <!-- The order within the category applied to all items within this group. 479 (This will be or'ed with the category attribute.) --> 480 <attr name="android:orderInCategory" /> 481 482 <!-- Whether the items are capable of displaying a check mark. --> 483 <attr name="android:checkableBehavior" /> 484 485 <!-- Whether the items are shown/visible. --> 486 <attr name="android:visible" /> 487 488 <!-- Whether the items are enabled. --> 489 <attr name="android:enabled" /> 490 491 </declare-styleable> 492 493 <!-- Base attributes that are available to all Item objects. --> 494 <declare-styleable name="MenuItem"> 495 496 <!-- The ID of the item. --> 497 <attr name="android:id" /> 498 499 <!-- The category applied to the item. 500 (This will be or'ed with the orderInCategory attribute.) --> 501 <attr name="android:menuCategory" /> 502 503 <!-- The order within the category applied to the item. 504 (This will be or'ed with the category attribute.) --> 505 <attr name="android:orderInCategory" /> 506 507 <!-- The title associated with the item. --> 508 <attr name="android:title" /> 509 510 <!-- The condensed title associated with the item. This is used in situations where the 511 normal title may be too long to be displayed. --> 512 <attr name="android:titleCondensed" /> 513 514 <!-- The icon associated with this item. This icon will not always be shown, so 515 the title should be sufficient in describing this item. --> 516 <attr name="android:icon" /> 517 518 <!-- The alphabetic shortcut key. This is the shortcut when using a keyboard 519 with alphabetic keys. --> 520 <attr name="android:alphabeticShortcut" /> 521 522 <!-- The numeric shortcut key. This is the shortcut when using a numeric (e.g., 12-key) 523 keyboard. --> 524 <attr name="android:numericShortcut" /> 525 526 <!-- Whether the item is capable of displaying a check mark. --> 527 <attr name="android:checkable" /> 528 529 <!-- Whether the item is checked. Note that you must first have enabled checking with 530 the checkable attribute or else the check mark will not appear. --> 531 <attr name="android:checked" /> 532 533 <!-- Whether the item is shown/visible. --> 534 <attr name="android:visible" /> 535 536 <!-- Whether the item is enabled. --> 537 <attr name="android:enabled" /> 538 539 <!-- Name of a method on the Context used to inflate the menu that will be 540 called when the item is clicked. --> 541 <attr name="android:onClick" /> 542 543 <!-- How this item should display in the Action Bar, if present. --> 544 <attr name="showAsAction"> 545 <!-- Never show this item in an action bar, show it in the overflow menu instead. 546 Mutually exclusive with "ifRoom" and "always". --> 547 <flag name="never" value="0" /> 548 <!-- Show this item in an action bar if there is room for it as determined 549 by the system. Favor this option over "always" where possible. 550 Mutually exclusive with "never" and "always". --> 551 <flag name="ifRoom" value="1" /> 552 <!-- Always show this item in an actionbar, even if it would override 553 the system's limits of how much stuff to put there. This may make 554 your action bar look bad on some screens. In most cases you should 555 use "ifRoom" instead. Mutually exclusive with "ifRoom" and "never". --> 556 <flag name="always" value="2" /> 557 <!-- When this item is shown as an action in the action bar, show a text 558 label with it even if it has an icon representation. --> 559 <flag name="withText" value="4" /> 560 <!-- This item's action view collapses to a normal menu 561 item. When expanded, the action view takes over a 562 larger segment of its container. --> 563 <flag name="collapseActionView" value="8" /> 564 </attr> 565 566 <!-- An optional layout to be used as an action view. 567 See {@link android.view.MenuItem#setActionView(android.view.View)} 568 for more info. --> 569 <attr name="actionLayout" format="reference" /> 570 571 <!-- The name of an optional View class to instantiate and use as an 572 action view. See {@link android.view.MenuItem#setActionView(android.view.View)} 573 for more info. --> 574 <attr name="actionViewClass" format="string" /> 575 576 <!-- The name of an optional ActionProvider class to instantiate an action view 577 and perform operations such as default action for that menu item. 578 See {@link android.view.MenuItem#setActionProvider(android.view.ActionProvider)} 579 for more info. --> 580 <attr name="actionProviderClass" format="string" /> 581 582 </declare-styleable> 583 584 <declare-styleable name="Spinner"> 585 <!-- The prompt to display when the spinner's dialog is shown. --> 586 <attr name="prompt" format="reference" /> 587 <!-- Display mode for spinner options. --> 588 <attr name="spinnerMode" format="enum"> 589 <!-- Spinner options will be presented to the user as a dialog window. --> 590 <enum name="dialog" value="0" /> 591 <!-- Spinner options will be presented to the user as an inline dropdown 592 anchored to the spinner widget itself. --> 593 <enum name="dropdown" value="1" /> 594 </attr> 595 <!-- List selector to use for spinnerMode="dropdown" display. --> 596 <attr name="android:dropDownSelector" /> 597 <!-- Background drawable to use for the dropdown in spinnerMode="dropdown". --> 598 <attr name="android:popupBackground" /> 599 <!-- Vertical offset from the spinner widget for positioning the dropdown in 600 spinnerMode="dropdown". --> 601 <attr name="android:dropDownVerticalOffset" /> 602 <!-- Horizontal offset from the spinner widget for positioning the dropdown 603 in spinnerMode="dropdown". --> 604 <attr name="android:dropDownHorizontalOffset" /> 605 <!-- Width of the dropdown in spinnerMode="dropdown". --> 606 <attr name="android:dropDownWidth" /> 607 <!-- Reference to a layout to use for displaying a prompt in the dropdown for 608 spinnerMode="dropdown". This layout must contain a TextView with the id 609 {@code @android:id/text1} to be populated with the prompt text. --> 610 <attr name="popupPromptView" format="reference" /> 611 <!-- Gravity setting for positioning the currently selected item. --> 612 <attr name="android:gravity" /> 613 <!-- Whether this spinner should mark child views as enabled/disabled when 614 the spinner itself is enabled/disabled. --> 615 <attr name="disableChildrenWhenDisabled" format="boolean" /> 616 <attr name="android:background" /> 617 </declare-styleable> 618 619 <declare-styleable name="SearchView"> 620 <!-- The layout to use for the search view. --> 621 <attr name="layout" format="reference" /> 622 <!-- The default state of the SearchView. If true, it will be iconified when not in 623 use and expanded when clicked. --> 624 <attr name="iconifiedByDefault" format="boolean" /> 625 <!-- An optional maximum width of the SearchView. --> 626 <attr name="android:maxWidth" /> 627 <!-- An optional query hint string to be displayed in the empty query field. --> 628 <attr name="queryHint" format="string" /> 629 <!-- The IME options to set on the query text field. --> 630 <attr name="android:imeOptions" /> 631 <!-- The input type to set on the query text field. --> 632 <attr name="android:inputType" /> 633 <!-- Close button icon --> 634 <attr name="closeIcon" format="reference" /> 635 <!-- Go button icon --> 636 <attr name="goIcon" format="reference" /> 637 <!-- Search icon --> 638 <attr name="searchIcon" format="reference" /> 639 <!-- Search icon displayed as a text field hint --> 640 <attr name="searchHintIcon" format="reference" /> 641 <!-- Voice button icon --> 642 <attr name="voiceIcon" format="reference" /> 643 <!-- Commit icon shown in the query suggestion row --> 644 <attr name="commitIcon" format="reference" /> 645 <!-- Layout for query suggestion rows --> 646 <attr name="suggestionRowLayout" format="reference" /> 647 <!-- Background for the section containing the search query --> 648 <attr name="queryBackground" format="reference" /> 649 <!-- Background for the section containing the action (e.g. voice search) --> 650 <attr name="submitBackground" format="reference" /> 651 <attr name="android:focusable" /> 652 </declare-styleable> 653 654 <!-- Attrbitutes for a ActivityChooserView. --> 655 <declare-styleable name="ActivityChooserView"> 656 <!-- The maximal number of items initially shown in the activity list. --> 657 <attr name="initialActivityCount" format="string" /> 658 <!-- The drawable to show in the button for expanding the activities overflow popup. 659 <strong>Note:</strong> Clients would like to set this drawable 660 as a clue about the action the chosen activity will perform. For 661 example, if share activity is to be chosen the drawable should 662 give a clue that sharing is to be performed. 663 --> 664 <attr name="expandActivityOverflowButtonDrawable" format="reference" /> 665 </declare-styleable> 666 667 <declare-styleable name="CompatTextView"> 668 <!-- Present the text in ALL CAPS. This may use a small-caps form when available. --> 669 <attr name="textAllCaps" format="reference|boolean" /> 670 </declare-styleable> 671 672 <declare-styleable name="LinearLayoutCompat"> 673 <!-- Should the layout be a column or a row? Use "horizontal" 674 for a row, "vertical" for a column. The default is 675 horizontal. --> 676 <attr name="android:orientation" /> 677 <attr name="android:gravity" /> 678 <!-- When set to false, prevents the layout from aligning its children's 679 baselines. This attribute is particularly useful when the children 680 use different values for gravity. The default value is true. --> 681 <attr name="android:baselineAligned" /> 682 <!-- When a linear layout is part of another layout that is baseline 683 aligned, it can specify which of its children to baseline align to 684 (that is, which child TextView).--> 685 <attr name="android:baselineAlignedChildIndex" /> 686 <!-- Defines the maximum weight sum. If unspecified, the sum is computed 687 by adding the layout_weight of all of the children. This can be 688 used for instance to give a single child 50% of the total available 689 space by giving it a layout_weight of 0.5 and setting the weightSum 690 to 1.0. --> 691 <attr name="android:weightSum" /> 692 <!-- When set to true, all children with a weight will be considered having 693 the minimum size of the largest child. If false, all children are 694 measured normally. --> 695 <attr name="measureWithLargestChild" format="boolean" /> 696 <!-- Drawable to use as a vertical divider between buttons. --> 697 <attr name="divider" /> 698 <!-- Setting for which dividers to show. --> 699 <attr name="showDividers"> 700 <flag name="none" value="0" /> 701 <flag name="beginning" value="1" /> 702 <flag name="middle" value="2" /> 703 <flag name="end" value="4" /> 704 </attr> 705 <!-- Size of padding on either end of a divider. --> 706 <attr name="dividerPadding" format="dimension" /> 707 </declare-styleable> 708 709 <declare-styleable name="LinearLayoutCompat_Layout"> 710 <attr name="android:layout_width" /> 711 <attr name="android:layout_height" /> 712 <attr name="android:layout_weight" /> 713 <attr name="android:layout_gravity" /> 714 </declare-styleable> 715 716 <declare-styleable name="Toolbar"> 717 <attr name="titleTextAppearance" format="reference" /> 718 <attr name="subtitleTextAppearance" format="reference" /> 719 <attr name="title" /> 720 <attr name="subtitle" /> 721 <attr name="android:gravity" /> 722 <attr name="titleMargins" format="dimension" /> 723 <attr name="titleMarginStart" format="dimension" /> 724 <attr name="titleMarginEnd" format="dimension" /> 725 <attr name="titleMarginTop" format="dimension" /> 726 <attr name="titleMarginBottom" format="dimension" /> 727 <attr name="contentInsetStart" /> 728 <attr name="contentInsetEnd" /> 729 <attr name="contentInsetLeft" /> 730 <attr name="contentInsetRight" /> 731 <attr name="maxButtonHeight" format="dimension" /> 732 733 <attr name="collapseIcon" format="reference" /> 734 <!-- Text to set as the content description for the collapse button. --> 735 <attr name="collapseContentDescription" format="string" /> 736 <!-- Reference to a theme that should be used to inflate popups 737 shown by widgets in the toolbar. --> 738 <attr name="popupTheme" /> 739 <!-- Icon drawable to use for the navigation button located at 740 the start of the toolbar. --> 741 <attr name="navigationIcon" format="reference" /> 742 <!-- Text to set as the content description for the navigation button 743 located at the start of the toolbar. --> 744 <attr name="navigationContentDescription" format="string" /> 745 746 <!-- Allows us to read in the minHeight attr pre-v16 --> 747 <attr name="android:minHeight" /> 748 </declare-styleable> 749 750 <declare-styleable name="PopupWindowBackgroundState"> 751 <!-- State identifier indicating the popup will be above the anchor. --> 752 <attr name="state_above_anchor" format="boolean" /> 753 </declare-styleable> 754 755 <declare-styleable name="ListPopupWindow"> 756 <!-- Amount of pixels by which the drop down should be offset vertically. --> 757 <attr name="android:dropDownVerticalOffset" /> 758 <!-- Amount of pixels by which the drop down should be offset horizontally. --> 759 <attr name="android:dropDownHorizontalOffset" /> 760 </declare-styleable> 761 762 <declare-styleable name="PopupWindow"> 763 <!-- Whether the popup window should overlap its anchor view. --> 764 <attr name="overlapAnchor" format="boolean" /> 765 <attr name="android:popupBackground" /> 766 </declare-styleable> 767 768 <declare-styleable name="DrawerArrowToggle"> 769 <!-- The drawing color for the bars --> 770 <attr name="color" format="color"/> 771 <!-- Whether bars should rotate or not during transition --> 772 <attr name="spinBars" format="boolean"/> 773 <!-- The total size of the drawable --> 774 <attr name="drawableSize" format="dimension"/> 775 <!-- The max gap between the bars when they are parallel to each other --> 776 <attr name="gapBetweenBars" format="dimension"/> 777 <!-- The size of the top and bottom bars when they merge to the middle bar to form an arrow --> 778 <attr name="topBottomBarArrowSize" format="dimension"/> 779 <!-- The size of the middle bar when top and bottom bars merge into middle bar to form an arrow --> 780 <attr name="middleBarArrowSize" format="dimension"/> 781 <!-- The size of the bars when they are parallel to each other --> 782 <attr name="barSize" format="dimension"/> 783 <!-- The thickness (stroke size) for the bar paint --> 784 <attr name="thickness" format="dimension"/> 785 </declare-styleable> 786 787 <attr name="drawerArrowStyle" format="reference" /> 788 789 <declare-styleable name="ViewStubCompat"> 790 <!-- Supply an identifier for the layout resource to inflate when the ViewStub 791 becomes visible or when forced to do so. The layout resource must be a 792 valid reference to a layout. --> 793 <attr name="android:layout" /> 794 <!-- Overrides the id of the inflated View with this value. --> 795 <attr name="android:inflatedId" /> 796 <attr name="android:id" /> 797 </declare-styleable> 798 799 <declare-styleable name="SwitchCompat"> 800 <!-- Drawable to use as the "thumb" that switches back and forth. --> 801 <attr name="android:thumb" /> 802 <!-- Drawable to use as the "track" that the switch thumb slides within. --> 803 <attr name="track" format="reference" /> 804 <!-- Text to use when the switch is in the checked/"on" state. --> 805 <attr name="android:textOn" /> 806 <!-- Text to use when the switch is in the unchecked/"off" state. --> 807 <attr name="android:textOff" /> 808 <!-- Amount of padding on either side of text within the switch thumb. --> 809 <attr name="thumbTextPadding" format="dimension" /> 810 <!-- TextAppearance style for text displayed on the switch thumb. --> 811 <attr name="switchTextAppearance" format="reference" /> 812 <!-- Minimum width for the switch component --> 813 <attr name="switchMinWidth" format="dimension" /> 814 <!-- Minimum space between the switch and caption text --> 815 <attr name="switchPadding" format="dimension" /> 816 <!-- Whether to split the track and leave a gap for the thumb drawable. --> 817 <attr name="splitTrack" format="boolean" /> 818 <!-- Whether to draw on/off text. --> 819 <attr name="showText" format="boolean" /> 820 </declare-styleable> 821 822 <declare-styleable name="SwitchCompatTextAppearance"> 823 <attr name="android:textSize" /> 824 <attr name="android:textColor" /> 825 <attr name="textAllCaps" /> 826 </declare-styleable> 827 828</resources> 829