注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
テキストウィジェット カテゴリーは、以下のウィジェットで構成されています:
Image ウィジェットは、テキストウィジェットのシンプルな拡張です。このウィジェットは、HTMLのイメージタグを使用してイメージを作成します。イメージはまず Foundry にアップロードするか、Slate からアクセス可能な他の場所にホストする必要があります。その後、イメージタグの src
プロパティをイメージのURLに設定します。Foundry でホストされているイメージの場合、イメージのURLは https://<FOUNDRY_URL>/blobster/api/salt/<RID>
です。このURLには、Foundry でイメージを開き、イメージを右クリックしてから、イメージのアドレスをコピーすることでアクセスできます。イメージウィジェットの設定には、以下の例を参考にしてください:
<img src="https://<FOUNDRY_URL>/blobster/api/salt/<RID>">
Card ウィジェットは、テキストウィジェットの拡張です。このウィジェットは、HTMLのdivを使用してカードを作成し、each ステートメントを使用してそれらを埋めます。Cardウィジェットをユーザーのアプリケーションに追加すると、カードをカスタマイズするために置き換えることができるスケルトンコードが事前に入力されています。
/each
のコメントを外す必要もあります。this
を設定することで、カードが選択されるようにします。lookup
クエリ.value
@index
の構文を使用できます。完成したCardウィジェットは、次のようになるかもしれません:
以下は、Cardウィジェットに適用できる共通のCSSオーバーライドです。
カードの色:
Copied!1
sl-text .cards .card {background: #f5f9fa;} /* sl-textクラス、cardsクラス、cardクラスを持つ要素の背景色を#f5f9faに設定します。 */
選択色:
Copied!1 2
/* sl-textクラス、cardsクラス、selectedクラスが適用されたcardクラスの背景色を白に設定します。 */ sl-text .cards .card.selected {background: #fff;}
ホバーカラー:
Copied!1 2 3 4 5 6 7 8 9
// sl-text クラス内の .cards クラス内の .card クラスがホバーされた場合のスタイルを定義します。 sl-text .cards .card:hover { background: #fff; // 背景色を白に設定します。 } // sl-text クラス内の .cards クラス内の .card クラスが選択され、かつホバーされた場合のスタイルを定義します。 sl-text .cards .card.selected:hover { background: #f5f9fa; // 背景色を薄い青色に設定します。 }
リスト ウィジェットは、Cardと非常に似ていますが、div class=cards
の代わりに divmclass=lists
を使用します。
以下の例では、Selection を Multiple に設定すると、リスト内の複数のアイテムを一度に選択できることに注意してください。
以下に、リストウィジェットに適用できる共通のCSSオーバーライドを示します。
リストの色:
Copied!1
sl-text .lists .lists {background: #f5f9fa;} /* sl-textクラスとlistsクラスが両方適用された要素の背景色を#f5f9fa(薄い青色)に設定します。 */
選択色:
Copied!1 2
/* sl-text内のlistsクラスとlistsクラス内の選択された要素の背景色を白に設定 */ sl-text .lists .lists.selected {background: #fff;}
ホバーカラー:
Copied!1 2 3 4 5 6 7 8 9
/* sl-textのクラス内のlistsクラスと、listsクラスがマウスオーバー時のスタイル設定 */ sl-text .lists .lists:hover { background: #fff; /* 背景色を白に設定 */ } /* sl-textのクラス内のlistsクラスで、selectedクラスが適用されている要素がマウスオーバー時のスタイル設定 */ sl-text .lists .lists.selected:hover { background: #f5f9fa; /* 背景色を薄い青に設定 */ }
テキストウィジェットは、最も多機能なSlateウィジェットの一つです。また、HTML、イメージ、カード、リストなど、他の多くのウィジェットの基盤でもあります。これらのウィジェットは、正しいオプションを提供するためのデフォルトコードで始まるテキストウィジェットに過ぎません。
テキストウィジェットには二つのモードがあります: Markdownモード と HTMLモード です。Markdownは、HTMLにレンダリングする軽量マークアップ言語なので、HTMLモードでできることは何でもMarkdownモードで行うことができます。Markdownモードを使用すると、シンプルで非常に読みやすいMarkdown構文を活用できます。例えば、テキストを見出し(H1)に設定するには、その前に #
記号を追加するだけです:
他のMarkdown構文については、Markdown documentation を参照してください。
テキストウィジェット内でハンドルバーを使用して、動的テキスト(例えば、他のウィジェットやクエリで選択した何か)を表示できます。
テキストウィジェットは、ユーザー定義のツールチップをサポートしています。ユーザーがウィジェットのコンテンツ内のsl-tooltip
HTMLエレメントにホバーすると、ツールチップが表示されます。
sl-tooltip
エレメントの内部テキストコンテンツを使用したツールチップ:属性 | 説明 | タイプ | 必須 | 変更者 |
---|---|---|---|---|
markupLanguage | ウィジェットのマークアップ言語を指定します。Markdown または HTML のいずれか。 | string | Yes | 直接編集 |
selectedValues | 選択モードにある場合のすべての選択項目の選択値 | string[] | Yes | ユーザーの操作 |
selectionType | 選択のタイプを決定します - ‘none’、‘single’、または ‘multiple’ | string | Yes | 直接編集 |
selectionRequired | すべての値の選択を解除できるかどうかを指定します。有効にすると、このフラグはユーザーがウィジェットの最後の選択値の選択を解除するのを防ぎます。ウィジェットが選択値なしで始まる場合、ユーザーが初期選択を行った後にのみ選択解除を防ぎます。 | boolean | Yes | 直接編集 |
text | ユーザーにレンダリングして表示する内容 | string | Yes | 直接編集 |
tooltipText | <sl-tooltip> 要素のツールチップ内に表示されるテキスト。HTMLをサポートします。 | string | Yes | 直接編集 |
tooltipsEnabled | ツールチップが有効かどうかを指定します。ツールチップは、<sl-tooltip> タグの内容に適用されます。 | boolean | Yes | 直接編集 |
clickEvents | このテキストウィジェットが公開するクリックイベントの名前のリスト。 | boolean | Yes | 直接編集 |
属性 | 説明 | タイプ | 必須 | 変更者 |
---|---|---|---|---|
hoverValue | ツールチップに関連付けるユーザー定義の値。この値は、ツールチップタグにホバー属性を追加することで定義されます。 | string | Yes | ユーザーの操作 |
textContent | ツールチップタグの内容を指定します。 | string | Yes | ユーザーの操作 |