Appearance
マークアップページの要素(メディア)
画像などを表示する要素。
すべての要素に共通するルール(構造の表記、配置の属性、デザイントークン)は、要素一覧を参照してください。
Image
URL で指定した画像を表示します。商品のサムネイルなど、SQL の結果の URL が指す画像を、行ごとに表示できます。画像をクリックすると、拡大して表示されます。
構造
| 項目 | 内容 |
|---|---|
| 区分 | block |
| 親 | 子に block を取る要素 |
| 子 | なし(/> で閉じる) |
SqlView の子孫 | 可 |
使い方
srcの書き方は、<Link>のhrefと同じです。http・https 以外の URL のときや、画像を読み込めないときは、代わりにアイコンを表示します- 画像は、閲覧者のブラウザが URL から直接読み込みます。認証が必要な URL など、閲覧者のブラウザから参照できない URL は表示できません
- 行ごとに画像を並べるときは、
widthとheightを指定して大きさをそろえます - URL ではなく、画像のファイルをアップロードして表示するときは、
<UploadedImage>を使います
属性
| 属性 | 値 | 内容 |
|---|---|---|
src(必須) | http・https の URL 式:文字+式 | 画像の URL |
alt | 文字列 式:文字+式 | 画像の代替テキスト |
width | px(例:320px) | 幅。未指定時は、親の幅いっぱいです |
height | px(例:320px) | 高さ。未指定時は、画像の縦横比に合わせた高さです |
objectFit | fill / contain / cover / none / scale-down既定: contain | width・height で決めた領域への、画像の収め方。contain は、縦横比を保って画像の全体を表示します |
objectPosition | center / top / right / bottom / left / top right / bottom left / bottom right / top left既定: center | width・height で決めた領域の中での、画像の位置 |
radius | none / md / lg既定: none | 角丸 |
例
html
<Image src="https://example.com/logo.png" alt="ロゴ" width="120px" />html
<SqlView id="…" page="…" sql="…">
<Grid cols="4">
<For as="r">
<Card>
<Image src="{{ r.thumbnail_url }}" alt="{{ r.name }}" height="120px" objectFit="cover" radius="md" />
<Text weight="bold">{{ r.name }}</Text>
</Card>
</For>
</Grid>
</SqlView>UploadedImage
アップロードした画像を、枠の中に表示します。画像のアップロードと差し替えは、Web版で要素のメニューから行います。
構造
| 項目 | 内容 |
|---|---|
| 区分 | block |
| 親 | 子に block を取る要素 |
| 子 | なし(/> で閉じる) |
SqlView の子孫 | 不可 |
使い方
- 画像は要素の
idに結び付くため、idを書けない<SqlView>の中には書けません。SQL の結果にある URL の画像を表示するときは、<Image>を使います
属性
| 属性 | 値 | 内容 |
|---|---|---|
id(必須) | ObjectId | 要素の ID(記法の「要素の ID」) |
objectFit | fill / contain / cover / none / scale-down既定: contain | 表示領域への画像の収め方。contain は、縦横比を保って画像の全体を表示します |
objectPosition | center / top / right / bottom / left / top right / bottom left / bottom right / top left既定: center | 表示領域の中での画像の位置 |
name | 文字列 式:文字+式 | 枠のタイトル |
hideFrame | 真偽値 | 枠を非表示にします |
hideName | 真偽値 | 枠のタイトルを非表示にします |
height | px(例:320px)既定: 180px | 高さ |