スクリプト開発 / 関数ページ DFF.FUNC_PAGE

DFF.FUNC_PAGE() は、自動生成されたシンプルな Func 呼び出しページを返すために使用され、少数の Func を操作ページに組み合わせるのに適しており、フロントエンドページを個別に開発する必要はありません。

例

@DFF.API(...) でデコレートされた Func 内でページオブジェクトを返すだけです：

@DFF.API('挨拶')
def greeting(name='World'):
    return f'Hello, {name}!'

@DFF.API('Func Page')
def func_page():
    page = DFF.FUNC_PAGE()
    page.set_title('My Func Page')
    page.add_html('h1', 'My Func Page', color='#409EFF', bold=True)
    page.add_func(greeting, default_kwargs={'name': 'User'})
    page.add_split()
    page.add_space(20)
    return page

func_page に対して関数 API を作成すると、ブラウザで開くだけでアクセスできます。ページのスタイルは DataFlux Func のバージョンによって更新される場合があります。

API

方法	説明
page = DFF.FUNC_PAGE()	ページオブジェクトを作成；タイトルはデフォルトで現在の Func のタイトル
page.set_title(title)	ページタイトルを設定
page.add_html(tag, text=None, indent=None, space=None, color=None, bold=False, italic=False, style=None, buttons=None)	HTML ブロックとオプションのスタイルおよびボタンを追加；tag は h1、p、span、hr などに指定可能
page.add_func(func, default_kwargs=None)	呼び出し可能な Func ブロックとオプションのデフォルト引数を追加
page.add_split()	区切りブロックを追加
page.add_space(size=10)	垂直方向の間隔を追加

add_func(...) の func パラメータと buttons 内の各ボタンの func は、Func ID でも、@DFF.API(...) でデコレートされた関数でも構いません。default_kwargs は対象の Func のパラメータと一致している必要があります。

レスポンスをレンダリングする際、Func ブロックとボタンは公開済み Func メタデータから解決されます。不明または未公開の Func ID は解決できず、ページのレンダリングが失敗する可能性があるため、参照されるすべての Func は公開済みである必要があります。

ページを返すと一時的な呼び出し権限が付与されます

ページに呼び出し可能な Func が含まれる場合、解決済みの Func ID のみに限定された一時的なブラウザ認可トークンが作成されます。ページ訪問者が実際に実行すべき Func のみをページに追加し、そのページを返すことを一時的な呼び出し権限の付与とみなしてください。

style、ボタンデータ、表示テキストはすべてページコンテンツに含まれるため、信頼できない HTML や秘密の値を挿入しないでください。複雑なインタラクションを持つページは、独自に実装した HTML を返すか、リソースファイルと併用してください。