@@ -56,16 +56,6 @@ description: |
56
56
57
57
#### iOS Platform Notes
58
58
59
- iOS buttons have two special properties, `style` and `systemButton`.
60
-
61
- The `style` property specifies the type of button decoration, and can be set to one
62
- of the values described in <Titanium.UI.iOS.SystemButtonStyle>.
63
-
64
- To use a custom button style, such as a background gradient, you may need to explicitly set
65
- the button's `style` property to `PLAIN`, to prevent the button style from overriding any background color or gradient.
66
-
67
- Also note:
68
-
69
59
* When assigning a custom image to the `backgroundImage` property, the image must be
70
60
partially or wholly transparent for the background color or background gradient to be visible.
71
61
* Similarly, for an assigned background gradient to show through, the `backgroundColor` may need to be
@@ -114,7 +104,7 @@ description: |
114
104
iOS supplies a built-in effect for pressed buttons. For most iOS buttons, the effect
115
105
dims the entire button (except for the text) while the button is being pressed.
116
106
117
- For toolbar buttons that use the [PLAIN](Titanium.UI.iOS.SystemButtonStyle.PLAIN ) style
107
+ For toolbar buttons that use the [PLAIN](Titanium.UI.BUTTON_STYLE_OPTION_NEUTRAL ) style
118
108
or use system icons such as [CAMERA](Titanium.UI.iOS.SystemButton.CAMERA), a glow effect is
119
109
used. The glow effect shows as a white circular glow or highlight at the center of the button
120
110
when the button is pressed.
@@ -231,6 +221,20 @@ properties:
231
221
since : " 3.2.0"
232
222
platforms : [iphone, ipad, macos]
233
223
224
+ - name : configuration
225
+ summary : Button configuration for modern button styling.
226
+ description : |
227
+ A <Titanium.UI.iOS.ButtonConfiguration> object that defines the appearance and behavior
228
+ of the button. This provides a modern way to configure buttons with support for titles,
229
+ subtitles, images, and various styling options.
230
+
231
+ When using a button configuration, it takes precedence over individual styling properties
232
+ like `title`, `color`, and `backgroundColor`.
233
+ type : Titanium.UI.iOS.ButtonConfiguration
234
+ since : " 13.0.0"
235
+ platforms : [iphone, ipad, macos]
236
+ osver : {ios: {min: "15.0"}}
237
+
234
238
- name : enabled
235
239
summary : Set to `true` to enable the button, `false` to disable the button.
236
240
type : Boolean
@@ -294,9 +298,6 @@ properties:
294
298
summary : The border and fill style the button will use.
295
299
description : |
296
300
On Android, this is a creation-only property and cannot be changed dynamically.
297
-
298
- For Titanium versions older than 10.0.0, this is an iOS only property and must be assigned
299
- a constant from <Titanium.UI.iOS.SystemButtonStyle> which is now deprecated.
300
301
type : Number
301
302
constants : Titanium.UI.BUTTON_STYLE_*
302
303
platforms : [android, iphone, ipad, macos]
0 commit comments