Skip to contents

設定與頁面

一個 app 一次:主題、樣式、頁首、版本。

kit_page()
KIT 的頁面:主題、樣式、頁首,一次設定好
kit_theme()
KIT 的 bslib 主題
use_kit()
KIT 的樣式與瀏覽器端小程式(htmltools 的 dependency)
kit_header()
KIT 頁首
kit_app_meta()
頁首的版本行,例如「kitJoin v0.6.0 · 2026-10-31」
kit_app_description()
讀取 app 的版本與日期(DESCRIPTION 的 Version、Date)
kit_versions()
版本:kitDesign 與 app 自己的
kit_logo_uri()
KIT 標誌(data URI)
kit_logo_file()
標誌檔的網址(頁面上用)
kit_logo_dependency()
標誌檔(inst/logo/)的 htmlDependency:頁首的 SVG 與分頁圖示用網址取得
kit_colors()
KIT 品牌色常數(供自訂 CSS 或圖表使用)
kit_new_app()
開一個新的 KIT Shiny app
kit_gallery()
元件樣張 app

品牌

換成別的計畫的標誌與顏色。

kit_brand()
品牌:標誌與顏色
kit_current_brand()
現在的品牌:options(kitDesign.brand = ),沒有設定時是 KIT

步驟分頁(NavTabs)

kit_step_tabs_ui() kit_step_tabs_server()
步驟分頁模組(NavTabs)
kit_navgroups()
分組的分頁列(不編號;kitJoin 的樣子)
kit_navgroup()
分頁列的一組(給 kit_navgroups())
kit_flow_tabs()
有順序的流程分頁(kitsUI 的樣子)
kit_tab_states()
每個分頁的狀態
kit_watch_tab_states()
分頁狀態一變就送到瀏覽器
kit_send_tab_states()
把分頁狀態送到瀏覽器

範圍選擇列(ScopeBar)

全 app 共用的一個選擇(例如用哪一份題庫),放在分頁列正下方。

kit_scope_bar()
範圍選擇列:分頁列下面、全 app 共用的選擇

頁面說明(PageGuide)

kit_tab_guide()
頁面說明:這一頁做什麼(PageGuide)
kit_steps()
編號的步驟清單(放在 kit_tab_guide() 的 steps)

狀態框(StatusBox)

kit_status() as.tags(<kit_status>) format(<kit_status>) print(<kit_status>)
狀態物件(StatusBox)
kit_done_status()
執行完的狀態:有要注意的事時是【完成,但請注意】,否則是【完成】
kit_error_status()
執行失敗的狀態(【停下來】)
kit_stale_status()
檔案或設定變更後,舊結果失效(【要重新執行】)
kit_status_ui()
狀態框(StatusBox)
kit_notify()
顯示通知(Shiny 的 showNotification)
kit_abort()
給使用者看的錯誤
kit_is_user_error()
是不是 kit_abort() 丟出的錯誤

按鈕(Button)

kit_button()
按鈕(Button)
kit_btn_class()
按鈕種類的 class

下載按鈕(DownloadButton)

kit_download_button()
下載按鈕(DownloadButton)
kit_test_download()
測試裡按下載按鈕

檔案的小工具

編碼、SPSS 變項名稱、壓縮檔路徑、開啟瀏覽器。

kit_fix_utf8_chr() kit_fix_utf8_df() kit_is_valid_utf8_df() kit_sav_safe_names() kit_truncate_bytes() kit_gz_path() kit_open_browser()
檔案的小工具:編碼、SPSS 變項名稱、壓縮檔路徑、開啟瀏覽器

提示框(Callout)

kit_callout()
提示框(Callout)
kit_cloud_banner()
雲端版的提醒橫幅(頁首下面一行)
kit_cloud_footer()
雲端版使用須知(頁面最下面,灰色小字)
kit_is_cloud()
是不是雲端版

資料表(DataTable)

kit_static_table()
小表格(直接放在 renderUI() 裡,不用另開 output)
kit_dt()
互動資料表(DT),KIT 的樣子
kit_preview_table()
預覽表的資料(交給 shiny::renderTable())
kit_rows_note()
長表的說明:「共 3,418 列 × 25 欄,以下前 10 列、前 20 欄。」
kit_table_scroll()
寬的表放在這裡面:在自己的框裡左右捲,不撐破版面
kit_num()
整數加千分位
kit_dims()
維度描述:「5 列 × 7 欄」

圖(Chart)

kit_plotly_style()
plotly 圖套上 KIT 的樣子(Chart)
kit_plotly_fonts()
plotly 圖附上 app 的字型(下載的 HTML 用)
kit_chart_colors()
圖的類別色(Chart)
kit_chart_neutral()
圖裡不分類別的中性色
kit_chart_sequential()
連續數值的色階(Chart)

細節列(Details)

kit_details_row()
一排細節(Details)
kit_detail()
一個細節:預設收起,標題一行小字
kit_advanced()
進階設定:預設收起
kit_settings_line()
設定摘要:主要按鈕或結果上面一行小字

用 R 怎麼做(CodePanel)

kit_code_panel_ui() kit_code_panel_server()
「用 R 怎麼做」模組(CodePanel)
kit_code() as.tags(<kit_code>) format(<kit_code>) print(<kit_code>)
一個版本的程式碼(CodePanel)
kit_code_wrap()
把一段程式碼換行成每行最多 70 欄
kit_code_cols()
每行的顯示寬度(中日韓字、全形字算 2 欄)
kit_code_panel()
「用 R 怎麼做」的位置(CodePanel)
kit_render_code_panel()
server 端:把程式碼畫進 kit_code_panel()
kit_code_blocks()
「用 R 怎麼做」的內容:說明+一個或幾個版本的程式碼(附「複製」)

步驟卡(StepCard)

kit_stepcards_ui() kit_stepcards_server()
步驟卡模組(StepCard)
kit_step_card()
步驟卡(StepCard)
kit_step_head()
步驟卡的標頭
kit_step_body()
步驟卡的內容

檢查清單(Checklist)

kit_checklist() as.tags(<kit_checklist>) format(<kit_checklist>) print(<kit_checklist>)
檢查清單(Checklist)
kit_check() as.tags(<kit_check>) format(<kit_check>) print(<kit_check>)
檢查清單的一列(Checklist)
kit_problems()
表格或清單裡的問題(深橘紅的字)

還差什麼(ReadyLine)

kit_run_gate_ui() kit_run_gate_server()
主要按鈕+「還差:…」模組(ReadyLine)
kit_ready_line()
還差什麼(ReadyLine)
kit_run_gate()
主要按鈕還不能按時:停用它,上面一行寫還差什麼
kit_need_files()
「還差」:檔案不夠時的那一句

下一步(NextStep)

kit_next_step()
下一步(NextStep)
kit_app_link()
連到別的網站或 app 的連結(開新分頁)

圖解(Diagram)

kit_diagram()
圖解:處理前的小表 → 處理後的小表,下面一行白話說明(Diagram)
kit_dg_table()
圖解用的小表格(2–3 欄、2–4 列)

執行分頁(RunTab)

一頁一個主要按鈕的分頁骨架:頁面骨架的順序與狀態流。

kit_run_tab_ui() kit_run_tab_server()
執行分頁(RunTab)

模組

有狀態的元件:*_ui(id) + *_server(id),一頁一行。

kit_step_tabs_ui() kit_step_tabs_server()
步驟分頁模組(NavTabs)
kit_stepcards_ui() kit_stepcards_server()
步驟卡模組(StepCard)
kit_run_gate_ui() kit_run_gate_server()
主要按鈕+「還差:…」模組(ReadyLine)
kit_code_panel_ui() kit_code_panel_server()
「用 R 怎麼做」模組(CodePanel)

頁面行為

捲到結果、打開收合、離開前提醒。

kit_scroll_to()
執行完把狀態框捲到畫面上方
kit_open_details()
打開一個收合區塊(例如套用預設後打開進階設定)
kit_unload_guard()
離開頁面前的提醒