Skip to content

Commit 0bc8640

Browse files
committed
docs: document last-wins behavior for duplicate transforms
1 parent d2771c3 commit 0bc8640

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

docs/src/content/docs/reference/transforms.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -149,10 +149,10 @@ Uses spacing scale (same as `m-*`, `p-*`):
149149

150150
## Multiple Transforms
151151

152-
Multiple transform classes on the same element are fully supported and will be combined into a single transform array:
152+
Multiple transform classes on the same element are fully supported. Different transform types are combined into a single transform array:
153153

154154
```tsx
155-
//Both transforms are applied
155+
//Different transform types are combined
156156
<View className="scale-110 rotate-45 w-16 h-16 bg-blue-500" />
157157
// Compiles to: { transform: [{ scale: 1.1 }, { rotate: '45deg' }], ... }
158158

@@ -161,20 +161,21 @@ Multiple transform classes on the same element are fully supported and will be c
161161
// Compiles to: { transform: [{ perspective: 500 }, { rotate: '45deg' }, { scale: 1.1 }, { translateX: 16 }] }
162162
```
163163

164-
:::note[Order Matters]
165-
Transform order is preserved from the className string. In React Native (and CSS), different orders produce different visual results:
164+
### Same Transform Type: Last Wins
165+
166+
When the same transform type appears multiple times, the last value wins (matching Tailwind CSS behavior):
166167

167168
```tsx
168-
// Rotate first, then scale
169-
<View className="rotate-45 scale-110" />
170-
// { transform: [{ rotate: '45deg' }, { scale: 1.1 }] }
169+
// Same type: last wins
170+
<View className="rotate-45 rotate-90" />
171+
// { transform: [{ rotate: '90deg' }] }
171172

172-
// Scale first, then rotate
173-
<View className="scale-110 rotate-45" />
174-
// { transform: [{ scale: 1.1 }, { rotate: '45deg' }] }
173+
// Mixed: different types combined, same types replaced
174+
<View className="rotate-45 scale-110 rotate-90" />
175+
// { transform: [{ rotate: '90deg' }, { scale: 1.1 }] }
175176
```
176177

177-
:::
178+
This is useful for responsive overrides or conditional styling where you want to override a base transform.
178179

179180
## What's Not Supported
180181

0 commit comments

Comments
 (0)