canvas-component-utils
Use utility components to render formatted text and media correctly. Use when (1) Rendering HTML text content from props, (2) Displaying images, (3) Working with formatted text or media. Covers FormattedText and Image utilities.
Savant verdict: Analyzed
Scanned or evaluated by Savant; not yet both passing.
Live evaluation
Not evaluated yet. Workspaces can request a live evaluation.
Security assessment
Risk score
0/100
Recommendation
CAUTION
Severity
LOW
Savant decision
Passed (low risk)
The assessment recommended caution, but its risk score is below 20/100, so Savant's policy passes it. Its findings are still listed for review. Static security analysis completed.
0 patterns found
Structure
- No license declaredConfirm you may reuse this skill before importing it into your repository.
SKILL.md
---
name: canvas-component-utils
description:
Use utility components to render formatted text and media correctly. Use when
(1) Rendering HTML text content from props, (2) Displaying images, (3) Working
with formatted text or media. Covers FormattedText and Image utilities.
---
## Project type
Before applying this skill, check `package.json` for a dependency named
`@drupal-canvas/headless` or starting with `@drupal-canvas/headless-`. If one is
present, this is a Canvas Headless codebase — read
[`canvas-headless`](../canvas-headless/SKILL.md) first. Portable React
components can use `FormattedText` and `Image` at their existing public import
paths; `FormattedText` requires trusted or sanitized HTML. Native Vue, Astro and
Angular components use framework-native alternatives instead of React utilities.
If no such dependency is present, this is a Canvas-rendered React codebase:
components are React (`index.jsx`/`.tsx`) and everything in this skill applies
as written. These are the only two project types.
Import utilities from the `drupal-canvas` package:
```jsx
import { FormattedText, Image } from 'drupal-canvas';
```
## FormattedText
Use `FormattedText` to render HTML content from props. This is required for any
prop with `contentMediaType: text/html` in component.yml.
```yaml
# component.yml
props:
properties:
text:
title: Text
type: string
contentMediaType: text/html
x-formatting-context: block
examples:
- <p>This is <strong>formatted</strong> text.</p>
```
```jsx
import { FormattedText } from 'drupal-canvas';
const Text = ({ text, className }) => (
<FormattedText className={className}>{text}</FormattedText>
);
```
**When to use FormattedText:**
- Props that accept rich text/HTML content
- Any prop with `contentMediaType: text/html`
- Content that may contain `<p>`, `<strong>`, `<em>`, `<a>`, or other HTML tags
**Do NOT use FormattedText for:**
- Plain text props (type: string without contentMediaType)
- Headings or titles (use regular elements)
## Image
Use `Image` for responsive image rendering. It handles responsive behavior and
optimization automatically. The component contract should accept a single image
object prop that matches `$ref: json-schema-definitions://canvas.module/image`;
do not split that data into separate `imageUrl`/`imageAlt` props.
```yaml
# component.yml
props:
properties:
image:
title: Image
type: object
$ref: json-schema-definitions://canvas.module/image
examples:
- src: https://example.com/photo.jpg
alt: Description of image
width: 800
height: 600
```
```jsx
import { Image } from 'drupal-canvas';
const Card = ({ image }) => {
if (!image?.src) return null;
const { src, alt, width, height } = image;
return (
<Image
src={src}
alt={alt}
width={width}
height={height}
className="w-full rounded-lg object-cover"
/>
);
};
```
**Image props:**
- `src` - Image URL (required)
- `alt` - Alt text for accessibility (required)
- `width` - Original image width
- `height` - Original image height
- `className` - Tailwind classes for styling