Expo Svelte
GitHub
src/routes/+mobile.svelte
<script lang="ts">
	import { Image, Screen, Text, View } from 'expo-svelte';
	import photo from '../../assets/images/photo.png';

	let status = $state('loading');
</script>

<Screen title="Images">
	<View style={{ padding: 20, gap: 12 }}>
		<Image source={photo} resizeMode="cover" accessibilityLabel="A sunset over hills" style={{ height: 160, borderRadius: 12 }} />
		<Image
			source={{ uri: 'https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=600&h=400&fit=crop&fm=jpg&q=70' }}
			resizeMode="cover"
			accessibilityLabel="A river between mountains"
			onLoad={() => (status = 'loaded')}
			onError={() => (status = 'failed')}
			style={{ height: 160, borderRadius: 12, backgroundColor: '#e5e7eb' }}
		/>
		<Text>The second image is {status}.</Text>
	</View>
</Screen>

Sources

  • A bundled file. Import it, or require() it: import photo from '../assets/photo.png'. Metro bundles the file with the app, picks the @2x or @3x file for the screen when you have them, and the image takes the file's size unless the style says otherwise.
  • A URL. { uri: 'https://...' }, with headers when the server needs them: { uri, headers: { Authorization: 'Bearer ...' } }. A network image has no size until it loads, so give it a width and a height (or a height and let alignSelf: 'stretch' set the width).
  • A file or data URI. { uri: 'file:///...' }, or { uri: 'data:image/png;base64,...' }.

Props

Prop Type Default Description
source ImageSource What to show: an imported file, { uri, headers?, width?, height? }, or an array of sources at different sizes.
resizeMode 'cover' | 'contain' | 'stretch' | 'repeat' | 'center' 'cover' How the picture fills the image's box.
style ImageStyle Size, border, border radius, tintColor and the layout keys.
class ClassValue A list of classes: a string, an array or an object, as on a DOM element in Svelte. Their style goes under style, which wins. Needs the css option (Classes).
defaultSource ImageSource A bundled image shown while a network one loads.
blurRadius number Blurs the picture.
onLoadStart, onLoad, onLoadEnd (event) => void Loading started, succeeded, finished either way.
onError (event) => void The picture couldn't be loaded.
accessibilityLabel string What a screen reader says. Leave it out, with accessible={false}, for a purely decorative image.
gesture Gesture A gesture to recognise on the image. See gestures.

It also takes the other props of React Native's Image.

For placeholders (blurhash, thumbhash), transitions between pictures and control over caching, use ExpoImage from expo-svelte/foreign, which is expo-image: turn it on with libraries: { 'expo-image': true } in the plugin's options.

Type to search the guide.