最近在做自动化 Shell 脚本，用到一些 TUI 的内容。Linux 下的 Dialog 可以完成这个功能，正好在网上发现一篇 Linux Shell 图形化脚本文件，于是转过来并做了下整理。原文在这里：Linux dialog 详解(图形化shell)
Liunx 下的 Dialog 工具是一个可以和 Shell 脚本配合使用的文本界面下的创建对话框的工具。
每个对话框提供的输出有两种形式：
1、将所有输出到 stderr 输出，不显示到屏幕。
2、使用退出状态码：
| 选项 | 值 |
|---|---|
OK |
0 |
NO |
1 |
ESC |
255 |
一、通用选项 Common Options
这个选项来设置 Dialog Box 的背景、颜色和标题等
--title <title> | 指定将在对话框的上方显示的标题字符串
--colors | 解读嵌入式“\ Z”的对话框中的特殊文本序列，序列由下面的字符 0-7, b B, u, U等，恢复正常的设置使用“\Zn”。
--no-shadow | 禁止阴影出现在每个对话框的底部
--shadow | 应该是出现阴影效果
--insecure | 输入部件的密码时，明文显示不安全，使用星号来代表每个字符
--no-cancel | 设置在输入框，菜单，和复选框中，不显示“cancel”项
--clear | 完成清屏操作。在框体显示结束后，清除框体。这个参数只能单独使用，不能和别的参数联合使用。
--ok-label <str> | 覆盖使用“OK”按钮的标签，换做其他字符。
--cancel-label <str> | 功能同上
--backtitle <backtitle> | 指定的backtitle字符串显示在背景顶端。
--begin <y> <x> | 指定对话框左上角在屏幕的上的做坐标
--timeout <secs> | 超时（返回的错误代码），如果用户在指定的时间内没有给出相应动作，就按超时处理
--defaultno | 使的是默认值 yes/no，使用no
--sleep <secs> | zz
--stderr | 以标准错误方式输出
--stdout | 以标准方式输出
--default-item <str> | 设置在一份清单，表格或菜单中的默认项目。通常在框中的第一项是默认
二、窗体类型
常见的对话框控件选项有：
--calendar | 提供了一个日历，让你可以选择日期
--checklist | 允许你显示一个选项列表，每个选项都可以被单独的选择 (复选框)
--from | 允许您建立一个带标签的文本字段，并要求填写
--fselect | 提供一个路径，让你选择浏览的文件
--gauge | 显示一个表，呈现出完成的百分比，就是显示出进度。
--infobox | 显示消息后，（没有等待响应）对话框立刻返回，但不清除屏幕 (信息框)
--inputbox | 让用户输入文本 (输入框 )
--inputmenu | 提供一个可供用户编辑的菜单 （可编辑的菜单框）
--menu | 显示一个列表供用户选择 (菜单框)
--msgbox | 显示一条消息，并要求用户选择一个确定按钮 (消息框 )
--pause | 显示一个表格用来显示一个指定的暂停期的状态
--passwordbox | 显示一个输入框，它隐藏文本
--passwordfrom | 显示一个来源于标签并且隐藏的文本字段
--radiolist | 提供一个菜单项目组，只有一个项目，可以选择 (单选框 )
--tailbox | 在一个滚动窗口文件中使用tail命令来显示文本
--tailboxbg | 跟tailbox类似，但是在background模式下操作
--textbox | 在带有滚动条的文本框中显示文件的内容 (文本框)
--timebox | 提供一个窗口，选择小时，分钟，秒
--yesno | 提供一个带有yes和no按钮的简单信息框 (是/否框)
如果没有此包请先安装
yum install -y dialog
三、命令示例
1、消息框（--msgbox）
格式：dialog --msgbox text height width
例子：
$ dialog --title "TESTING" --msgbox "this is a test" 10 20
--msgbox
2、yesno 框（--yesno）
格式：dialog --yesno text height width
例子：
$ dialog --title "yes/no" --no-shadow --yesno \
"Delete the file /tmp/chensiyao.txt?" 10 30
--yesno
3、输入框（--inputbox）
格式：dialog --inputbox text height width
例子：
$ dialog --title "Input your name" \
--inputbox "Please input your name:" 10 30 2> /tmp/name.txt
# (这里的2>是将错误信息输出重定向到了/tmp/name.txt文件中)
--inputbox
4、密码框（--passwordbox）
格式：dialog --passwordbox text height width [init]
例子：
$ dialog --title "Password" --passwordbox \
"Please give a password for the new user:" 10 35
--passwordbox
这样我们的密码就暴露出来了，是不是很不安全，所以通常我们会加上一个安全选项
--insecure 将每个字符用 * 来显示出来
$ dialog --title "Password" --insecure \
--passwordbox "Please give a password for the new user:" 10 30
--insecure --passwordbox
5、文本框（--textbox）
格式：dialog --textbox file height width
例子：
$ dialog --title "The fstab" --textbox /etc/fstab 17 40
--textbox
6、菜单框（--menu）
格式：dialog --menu text height width menu-height tag1 item1 tag2 item2 …
例子：
$ dialog --title "Pick a choice" --menu "Choose one" 12 35 5 \
1 "say hello to everyone" 2 "thanks for your support" 3 "exit"
--menu
7、文件选择框（--fselect）
格式：dialog --fselect filepath height width
例子：
$ dialog --title "Pick one file" --fselect /root/ 7 40
--fselect
8、复选框（--checklist）
格式：dialog --checklist "Test" height width menu-height tag1 item1 tag2 item2 …
例子：
$ dialog --backtitle "Checklist" --checklist "Test" 20 50 10 \
Memory Memory_Size 1 Dsik Disk_Size 2
--checklist
9、显示日历（--calendar）
格式：dialog --calendar "Date" height width day month year
例子：
- 显示当前日期
$ dialog --title "Calendar" --calendar "Date" 5 50
--calendar
- 显示指定日期
$ dialog --title "Calendar" --calendar "Date" 5 50 1 2 2013
--calendar 指定日期
10、进度框架（--gauge）
格式：dialog --gauge text height width [<percent>]
例子：
- 固定进度显示
$ dialog --title "installation pro" --gauge "installation" 10 30 10
--gauge
- 实时动态进度
$ for i in {1..100} ;do echo $i;done | dialog --title \
"installation pro" --gauge "installation" 10 30
--gauge 实时动态进度
-
编辑到脚本中
编辑一个
gauge.sh的脚本内容如下：
#!/bin/bash
# vim gauge.sh
declare -i PERCENT=0
(
for I in /etc/*;do
if [ $PERCENT -le 100 ];then
cp -r $I /tmp/test 2> /dev/null
echo "XXX"
echo "Copy the file $I ..."
echo "XXX"
echo $PERCENT
fi
let PERCENT+=1
sleep 0.1
done
) | dialog --title "coping" --gauge "starting to copy files..." 6 50 0
bash gauge.sh (执行脚本的时候注意修改权限)
脚本演示动态进度
11、表单框架（--form）
格式：dialog --form text height width formheight [ label y x item y x flen ilen ] ...
其中，
flen表示 Field Length，定义了：选定字段中显示的长度ilen表示 Input Length，定义了：输入的数据允许的长度
使用 Up/Down（或 Ctrl - N，Ctrl - P）在使用领域之间移动。使用 Tab 键在窗口之间切换。
例子：
$ dialog --title "Add a user" --form "Please input the infomation of new user:" 12 40 4 \
"Username:" 1 1 "" 1 15 15 0 \
"Full name:" 2 1 "" 2 15 15 0 \
"Home Dir:" 3 1 "" 3 15 15 0 \
"Shell:" 4 1 "" 4 15 15 0
--form
综合应用示例：
#!bin/bash
yesno() {
dialog --title "First screen" --backtitle "Test Program" --clear --yesno \
"Start this test program or not ? \nThis decesion have to make by you. " 16 51
# yes is 0, no is 1 , esc is 255
result=$?
if [ $result -eq 1 ] ; then
exit 1;
elif [ $result -eq 255 ]; then
exit 255;
fi
username
}
username() {
cat /dev/null >/tmp/test.username
dialog --title "Second screen" --backtitle "Test Program" --clear --inputbox \
"Please input your username (default: hello) " 16 51 "hello" 2>/tmp/test.username
result=$?
if [ $result -eq 1 ] ; then
yesno
elif [ $result -eq 255 ]; then
exit 255;
fi
password
}
password() {
cat /dev/null >/tmp/test.password
dialog --insecure --title "Third screen" --backtitle "Test Program" --clear --passwordbox \
"Please input your password (default: 123456) " 16 51 "123456" 2>/tmp/test.password
result=$?
if [ $result -eq 1 ] ; then
username
elif [ $result -eq 255 ]; then
exit 255;
fi
occupation
}
occupation() {
cat /dev/null >/tmp/test.occupation
dialog --title "Forth screen" --backtitle "Test Program" --clear --menu \
"Please choose your occupation: (default: IT)" 16 51 3 \
IT "The worst occupation" \
CEO "The best occupation" \
Teacher "Not the best or worst" 2>/tmp/test.occupation
result=$?
if [ $result -eq 1 ] ; then
password
elif [ $result -eq 255 ]; then
exit 255;
fi
finish
}
finish() {
dialog --title "Fifth screen" --backtitle "Test Program" --clear --msgbox \
"Congratulations! The test program has finished!\n Username: $(cat /tmp/test.username)\n Password: $(cat /tmp/test.password)\n Occupation: $(cat /tmp/test.occupation)" 16 51
result=$?
if [ $result -eq 1 ] ; then
occupation
elif [ $result -eq 255 ]; then
exit 255;
fi
}
yesno
综合应用示例 - 第 1 屏
综合应用示例 - 第 2 屏
综合应用示例 - 第 3 屏
综合应用示例 - 第 4 屏
综合应用示例 - 第 5 屏
文中脚本详见：GitHub - 使用 Linux Dialog 图形化 Shell
四、获取返回值
1、按钮操作
执行 dialog 执行之后，可以通过 $? 来获取用户操作的按钮：
0 .......... OK / Yes
1 .......... Cancel / No
255 ........ ESC
判断返回值：
case $? in
0)
echo -n "Yes / OK"
;;
1)
echo -n "No / Cancel"
;;
255)
echo -n "ESC"
;;
*)
echo -n "unknown"
;;
esac
case 语句的使用：Bash Case Statement
2、用户输入
对于用户输入，需要通过变量接收 dialog 的执行结果，这要求必须通过 --output-fd 1 指定输出方式。如果返回内容包含多项，默认以 \n 分割。
这里分别以获取表单输入和多选示例：
- 表单输入
# 指定分隔符
IFS=','
# 使用 USER_INPUT 存放返回值
USER_INPUT=$(dialog --title "Add a user" \
--output-fd 1 \
--output-separator "${IFS}" \
--form "Please input the infomation of new user:" 12 40 4 \
"Username:" 1 1 "aa 11" 1 15 15 0 \
"Full name:" 2 1 "bb 22" 2 15 15 0 \
"Home Dir:" 3 1 "cc 33" 3 15 15 0 \
"Shell:" 4 1 "dd 44" 4 15 15 0)
# 将 用户输入 拆分为数组，将以指定的 $IFS 进行分割
RET_ARRAY=($USER_INPUT)
# 显示得到的 数组
echo =========================
echo --- ${RET_ARRAY[0]}
echo --- ${RET_ARRAY[1]}
echo --- ${RET_ARRAY[2]}
echo --- ${RET_ARRAY[3]}
echo =========================
- 多选
# 指定分隔符
IFS=','
# 使用 USER_INPUT 存放返回值
USER_INPUT=$(dialog --backtitle 'Checklist' \
--output-fd 1 \
--output-separator "${IFS}" \
--checklist "Test" 20 50 10 \
'Memory mmm' Memory_Size 1 \
'Dsik ddd' Disk_Size 2)
# 将 用户输入 拆分为数组，将以指定的 $IFS 进行分割
RET_ARRAY=($USER_INPUT)
# 显示得到的 数组
echo =========================
echo --- ${RET_ARRAY[0]}
echo --- ${RET_ARRAY[1]}
echo --- ${RET_ARRAY[2]}
echo --- ${RET_ARRAY[3]}
echo =========================
五、颜色配置
创建 ~/.dialogrc 文件样例：
$ dialog --create-rc ~/.dialogrc
常用配置项说明：
# Turn on shadow dialog boxes
use_shadow = ON
# Turn on color support ON
use_colors = ON
# Change default blue background color to BLACK
screen_color = (CYAN,BLACK,ON)
配置样例：
#
# Run-time configuration file for dialog
#
# Automatically generated by "dialog --create-rc <file>"
#
#
# Types of values:
#
# Number - <number>
# String - "string"
# Boolean - <ON|OFF>
# Attribute - (foreground,background,highlight?)
# Set aspect-ration.
aspect = 0
# Set separator (for multiple widgets output).
separate_widget = ""
# Set tab-length (for textbox tab-conversion).
tab_len = 0
# Make tab-traversal for checklist, etc., include the list.
visit_items = OFF
# Shadow dialog boxes? This also turns on color.
use_shadow = ON
# Turn color support ON or OFF
use_colors = ON
# Screen color
screen_color = (CYAN,GREEN,ON)
# Shadow color
shadow_color = (BLACK,BLACK,ON)
# Dialog box color
dialog_color = (BLACK,WHITE,OFF)
# Dialog box title color
title_color = (BLUE,WHITE,ON)
# Dialog box border color
border_color = (WHITE,WHITE,ON)
# Active button color
button_active_color = (WHITE,BLUE,ON)
# Inactive button color
button_inactive_color = (BLACK,WHITE,OFF)
# Active button key color
button_key_active_color = (WHITE,BLUE,ON)
# Inactive button key color
button_key_inactive_color = (RED,WHITE,OFF)
# Active button label color
button_label_active_color = (YELLOW,BLUE,ON)
# Inactive button label color
button_label_inactive_color = (BLACK,WHITE,ON)
# Input box color
inputbox_color = (BLACK,WHITE,OFF)
# Input box border color
inputbox_border_color = (BLACK,WHITE,OFF)
# Search box color
searchbox_color = (BLACK,WHITE,OFF)
# Search box title color
searchbox_title_color = (BLUE,WHITE,ON)
# Search box border color
searchbox_border_color = (WHITE,WHITE,ON)
# File position indicator color
position_indicator_color = (BLUE,WHITE,ON)
# Menu box color
menubox_color = (BLACK,WHITE,OFF)
# Menu box border color
menubox_border_color = (WHITE,WHITE,ON)
# Item color
item_color = (BLACK,WHITE,OFF)
# Selected item color
item_selected_color = (WHITE,BLUE,ON)
# Tag color
tag_color = (BLUE,WHITE,ON)
# Selected tag color
tag_selected_color = (YELLOW,BLUE,ON)
# Tag key color
tag_key_color = (RED,WHITE,OFF)
# Selected tag key color
tag_key_selected_color = (RED,BLUE,ON)
# Check box color
check_color = (BLACK,WHITE,OFF)
# Selected check box color
check_selected_color = (WHITE,BLUE,ON)
# Up arrow color
uarrow_color = (GREEN,WHITE,ON)
# Down arrow color
darrow_color = (GREEN,WHITE,ON)
# Item help-text color
itemhelp_color = (WHITE,BLACK,OFF)
# Active form text color
form_active_text_color = (WHITE,BLUE,ON)
# Form text color
form_text_color = (WHITE,CYAN,ON)
# Readonly form item color
form_item_readonly_color = (CYAN,WHITE,ON)
六、参考资料
- Linux Command Line Adventure: Dialog
- Linux dialog详解(图形化shell)
- Text-based user interface
- Dialog customization with configuration file
- Bash Case Statement
- shell 分割字符串存至数组
- shell - IFS分隔符
- Shell中的IFS解惑
- 详细解析Shell中的IFS变量
- 在Bash中将字符串拆分成数组
- Bash数组操作教程
- linux shell 图形界面之dialog小结
（完）
