キーワードやカテゴリで絵文字を検索・一覧表示する方法

絵文字を探すときの使い分け

このツールは、内蔵された絵文字の一覧から、名前に含まれる文字列やカテゴリを使って候補を探すためのものです。入力を省略して一覧を確認する使い方にも対応しており、検索結果の件数も指定できます。絵文字の候補を名前から絞り込みたい場合と、食べ物や動物などの分類から探したい場合で、入力方法を選べます。

検索と一覧表示の手順

1. 検索したい文字列をクエリ欄に入力します。クエリを入力すると、認識済みカテゴリを選んでいない場合は、入力が前後の空白を除いて小文字化され、絵文字名にその文字列を含む候補が検索されます。
2. 分類から探す場合は、カテゴリを選択します。利用できるカテゴリは smileys、gestures、hearts、food、animals、nature、travel、symbols です。認識済みカテゴリを指定すると、クエリも入力している場合を含め、カテゴリによる絞り込みが先に適用されます。
3. 必要に応じて、表示件数の上限を入力します。正の数を指定した場合、検索結果の先頭からその件数までに絞られます。入力を省略した場合の上限は20です。
4. 検索を実行し、返された絵文字と名前を確認します。クエリを空欄にし、認識済みカテゴリも選ばない場合は、内蔵コレクションの項目を起点に一覧を確認できます。

結果の読み取り方

結果には、選ばれた絵文字の項目と検索に関するメタデータを含む成功結果が返ります。クエリ検索では、名前に入力文字列を含む候補が対象です。カテゴリ検索では、絵文字名を小文字化した文字列に、そのカテゴリのキーワードのいずれかが含まれる項目が対象になります。

表示件数を比較するときは、正の上限を指定した結果だけが先頭から切り詰められる点に注意してください。0または負の数を指定した場合は、結果の切り詰めは行われません。また、カテゴリとクエリを同時に指定した結果は、クエリだけで探した場合とは異なることがあります。

使用例

料理に関する絵文字を少数の候補から確認したい場合に、foodカテゴリと正の表示件数を使います。

カテゴリに food を指定し、表示件数に 5 を入力して検索します。

成功結果として、foodカテゴリの条件に合う絵文字の項目と検索メタデータが返り、limitに正の数を指定した場合は先頭からその件数までの項目になります。

制限事項

• 検索対象は内蔵された有限の絵文字コレクションです。表示される項目を超えて、絵文字全体の収録状況や標準への対応範囲を判断することはできません。

よくある間違い

• カテゴリ名を自由な日本語や一覧にない値で入力すると、認識済みカテゴリによる絞り込みは適用されません。food や animals など、対応しているカテゴリ名を使ってから検索してください。

よくある質問

クエリを空欄にするとどうなりますか？

クエリを空欄にし、認識済みカテゴリを選ばなければ、内蔵コレクションの項目を起点に一覧を確認できます。

カテゴリとキーワードを同時に指定できますか？

認識済みカテゴリを指定した場合はカテゴリ検索が優先されます。クエリも入力していても、カテゴリのキーワードに基づく絞り込みが先に適用されます。

表示件数の上限はどのように指定しますか？

正の数なら結果は先頭から指定件数までに切り詰められます。0または負の数では切り詰められず、省略時の上限は20です。