diff --git a/docs/docs/core/useAnimatedStyle.mdx b/docs/docs/core/useAnimatedStyle.mdx
index 5fe22c1d7dd..d0046740bf3 100644
--- a/docs/docs/core/useAnimatedStyle.mdx
+++ b/docs/docs/core/useAnimatedStyle.mdx
@@ -8,6 +8,8 @@ sidebar_position: 2
Styles defined using `useAnimatedStyle` have to be passed to `style` property of an [Animated component](/docs/fundamentals/glossary#animated-component). Styles are automatically updated whenever an associated shared value or React state changes.
+In contrast to the [inline styling](/docs/fundamentals/glossary#animations-in-inline-styling), `useAnimatedStyle` allows to [access values stored in shared values](/docs/fundamentals/animating-styles-and-props/#animating-styles) in the styles object it defines.
+
For animating properties use [`useAnimatedProps`](/docs/core/useAnimatedProps) instead.
## Reference
diff --git a/docs/docs/fundamentals/animating-styles-and-props.mdx b/docs/docs/fundamentals/animating-styles-and-props.mdx
index ba40699133c..ccfd333ed56 100644
--- a/docs/docs/fundamentals/animating-styles-and-props.mdx
+++ b/docs/docs/fundamentals/animating-styles-and-props.mdx
@@ -11,6 +11,8 @@ In [the last section](/docs/fundamentals/your-first-animation), we learned how t
As we learned in the previous section we can animate styles by [passing shared values inline](/docs/fundamentals/glossary#animations-in-inline-styling) to the elements' `style` property:
```jsx
+import Animated, { useSharedValue } from 'react-native-reanimated';
+
function App() {
const width = useSharedValue(100);
@@ -26,16 +28,21 @@ In basic cases, this syntax works well but it has one big downside. It doesn't a
Let's suppose we have an example with a box which moves to the right on every button press:
-```jsx {5,10}
+```jsx
+import { View, Button } from 'react-native';
+import Animated, { useSharedValue, withSpring } from 'react-native-reanimated';
+
function App() {
const translateX = useSharedValue(0);
const handlePress = () => {
+ // highlight-next-line
translateX.value = withSpring(translateX.value + 50);
};
return (
+ {/* highlight-next-line */}
@@ -83,12 +90,16 @@ const AnimatedCircle = Animated.createAnimatedComponent(Circle);
To animate the radius of the SVG circle we can simply pass the shared value as a prop:
-```jsx {6}
+```jsx
+import { useSharedValue } from 'react-native-reanimated';
+import { Svg } from 'react-native-svg';
+
function App() {
const r = useSharedValue(10);
return (
);