整合營銷服務商
電腦端+手機端+微信端=數據同步管理
免費咨詢熱線：
電腦端+手機端+微信端=數據同步管理
免費咨詢熱線：
選、多選、多選框組組件。
這節課來講一下單選、多選還有多選框組組件是怎么使用的。先來看一下效果。
·首先單選就是在多個組件中最多只能選擇一個，多選是可以選擇多個全選的。多選框組有多一個全選，這個是相當一個group，下面是它的直項，就是這邊指向只要有一個選中，上面全選按鈕就會變成一個杠。如果下面只選項全部選，全選就會變成打勾，就代表全選。如果下面全部都沒有選，這邊就會跟著沒掉，就是它相關聯的。同樣上面也是可以控制下面的內容。
·來看一下代碼是怎么實現的。首先來看一下單選，單選實際上這邊很簡單，是直接用一個ready有這個組件，因為是只能選一個，就需要有個它相關聯的group。這邊是不是有三個組件？就是這三個radio就設置的group都要一樣的，這邊設置group都叫radio group，它就可以關聯起來弄成單選的模式。這個點jig是它的選中狀態。
·來看一下多選，第二個是多選，勾選是直接用切boss這個組件，因為是沒有跟其他group相關聯的，所以直接也不用設置group，這樣一個不用設置group，直接用就可以了。這邊也是三個切boss把它名稱配置一下就可以，然后sleek color是它的群眾顏色。
·最后再來看一下多選框組，多選框組相對于多選就相當于它有一個global的組件，可以統一管理它的直組件。這邊就用checkbox global系統的組件，要配置它的global，就這邊把它命名叫做checkbox global。
·下面的直組件有三個直組件，選項一、選項二的選項三，同樣要去設置group了，設置的group的名稱就跟上面定義的group的名稱是一樣的，才能就上面group才能控制下面這三個直組件，實現多選框組的效果。其他就跟多選組件一樣，就選中顏色，這樣就可以實現效果了。
這節課就整到這邊。
起幫助文檔，想必大家都會想到 VuePress等，我也體驗了一下，但是感覺和我的思路不太一樣，我希望的是那種可以直接在線編輯文檔，然后無需編譯就可以直接發布的方式，另外可以在線寫（修改）代碼并且運行的效果。
VuePress 是“靜態網站生成器”，需要我們自行編寫文檔，然后交給VuePress變成網站，VuePress 并沒有提供編寫環境，我知道有很多編寫 Markdown 的方式，但是我還是喜歡編寫、瀏覽合為“一體”的方式。
似乎沒有，那么 —— 自己動手豐衣足食吧，開干！
首先使用 vite2 建立一個 Vue3 的項目：
注意：庫項目需要安裝以上插件，幫助文檔項目只需要安裝 @naturefw/press-edit 即可。
基本功能就是這樣，心急的可以先看在線演示和源碼。
在線編寫幫助文檔
https://nfpress.gitee.io/nf-press-edit/
nf-press-edit_幫助文檔的管理平臺: 在線文檔的編輯環境，可以編寫文檔。
https://gitee.com/nfpress/nf-press-edit
一開始做了兩個項目，分別實現編輯文檔和顯示文檔的功能，但是后來發現，內部代碼大部分是相同的，維護的時候有點麻煩，所以改為在編輯文檔的項目里加入“瀏覽”的狀態，然后設置切換的功能，這樣便于內部代碼的維護，以后成熟了可能會分為兩個單獨的項目。
我喜歡在線編輯的方式，這樣更省心，于是我用 el-menu 實現導航和左側的菜單，然后加上了維護功能。使用 v-md-editor 實現 Markdown 的編輯和顯示。然后用node寫了一個后端API，實現保存 json文件的功能，這樣就完美了。
就是在編輯狀態的功能的基礎上，去掉一些功能。或者其實可以反過來思考。
首先參考 VuePress 設置一個json文件，用于加載和保存網站信息、導航信息。
/public/docs/.nfpress/project.json
{
"projectId": "1000",
"title": "nf-press-edit ！",
"description": "這是一個在線編輯、展示文檔的小工具",
"navi": [
{
"naviId": "1010",
"text": "指南",
"link": "menu"
},
{
"naviId": "1020",
"text": "組件",
"link": "menu"
},
{
"naviId": "1380",
"text": "Gitee",
"link": "幫助文檔/nf-press-edit_幫助文檔的管理平臺"
},
{
"naviId": "1390",
"text": "在線演示",
"link": "在線編寫幫助文檔"
},
{
"naviId": "1395",
"text": "我要提意見",
"link": "Issues · 幫助文檔/nf-press-edit_幫助文檔的管理平臺 - Gitee.com"
}
]
}然后做一個組件，用 el-menu 綁定數據渲染出來即可實現導航效果。
/lib/navi/navi.vue
<el-menu
:default-active="activeIndex2"
class="el-menu-demo"
mode="horizontal"
v-bind="$attrs"
:background-color="backgroundColor"
@select="handleSelect"
>
<el-menu-item
v-for="(item, index) in naviList"
:key="index"
:index="item.naviId"
>
{{item.text}}
</el-menu-item>
</el-menu>可以是多級的導航，暫時沒有實現在線維護功能。
import { ref } from 'vue'
import { ElMenu, ElMenuItem } from 'element-plus'
import { state } from '@naturefw/nf-state'
const props=defineProps({
'background-color': { // 默認背景色
type: String,
default: '#ece5d9'
},
itemProps: Object
})
// 獲取狀態和導航內容
const { current, naviList }=state
// 激活第一個導航項
const activeIndex2=ref(naviList[0].naviId)
const handleSelect=(key, keyPath)=> {
const navi=naviList.find((item)=> item.naviId===key)
if (navi.link==='menu') {
// 打開菜單
current.naviId=key
} else {
// 打開連接
window.open(Navi Link, '_blank')
}
}
自己寫的一個輕量級狀態管理，可以當做大號 reactive 來使用，通過狀態管理加載 project.json 然后綁定渲染。
導航列表，由狀態管理加載。
當前激活的各種信息，比如“current.naviId”表示激活的導航項。
和導航類似，只是需要增加兩個功能：n級分組和維護。
首先參考 VuePress 設置一個json文件，保存菜單信息。
/public/docs/.nfpress/menu.json
[
{
"naviId": "1010",
"menus": [
{
"menuId": "110100",
"text": "介紹",
"description": "描述",
"icon": "FolderOpened",
"children": []
},
{
"menuId": "111100",
"text": "快速上手",
"description": "描述",
"icon": "FolderOpened",
"children": [
{
"menuId": 111120,
"text": "編輯文檔項目",
"description": "",
"icon": "UserFilled",
"children": []
},
{
"menuId": 111130,
"text": "展示文檔項目",
"description": "",
"icon": "UserFilled"
}
]
}
],
"ver": 1.6
},
{
"naviId": "1020",
"menus": [
{
"menuId": "21000",
"text": "導航（docNavi）",
"description": "描述",
"icon": "Star",
"children": []
}
],
"ver": 1.5
}
]然后用 el-menu 綁定數據渲染，因為要實現n級分組，所以做一個遞歸組件實現n級菜單的效果。
做一個遞歸組件實現n級分組的功能：
/lib/menu/menu-sub-edit.vue
<template v-for="(item, index) in subMenu">
<!--樹枝-->
<template v-if="item.children && item.children.length > 0">
<el-sub-menu
:key="item.menuId + '_' + index"
:index="item.menuId"
style="vertical-align: middle;"
>
<template #title>
<div style="display:inline;width: 100%;">
<component
:is="$icon[item.icon]"
style="width: 1.5em; height: 1.5em; margin-right: 8px;vertical-align: middle;"
>
</component>
<span>{{item.text}}</span>
</div>
</template>
<!--遞歸子菜單-->
<my-sub-menu2
:subMenu="item.children"
:dialogAddInfo="dialogAddInfo"
:dialogModInfo="dialogModInfo"
/>
</el-sub-menu>
</template>
<!--樹葉-->
<el-menu-item v-else
:index="item.menuId"
:key="item.menuId + 'son_' + index"
>
<template #title>
<div style="display:inline;width: 100%;">
<span style="float: left;">
<component
:is="$icon[item.icon]"
style="width: 1.5em; height: 1.5em; margin-right: 8px;vertical-align: middle;"
>
</component>
<span >{{item.text}}</span>
</span>
</div>
</template>
</el-menu-item>
</template> import { ElMenuItem, ElSubMenu } from 'element-plus'
// 展示子菜單 - 遞歸
import mySubMenu2 from './menu-sub.vue'
const props=defineProps({
subMenu: Array, // 要顯示的菜單，可以n級
dialogAddInfo: Object, // 添加菜單
dialogModInfo: Object // 修改菜單
})
這個就比較簡單了，做個表單實現菜單的增刪改即可，篇幅有限跳過。
使用 v-md-editor 實現 Markdown 的編輯和展示，首先該插件非常好用，其次支持VuePress的主題。
建立 /lib/md/md-edit.vue 實現編輯 Markdown 的功能：
<v-md-editor
:toolbar="toolbar"
left-toolbar="undo redo clear | tip emoji code | h bold italic strikethrough quote | ul ol table hr | link image | save | customToolbar"
:include-level="[1, 2, 3, 4]"
v-model="current.docInfo.md"
:height="editHeight + 'px'"
@save="mySave"
>
</v-md-editor> import { watch,ref } from 'vue'
import { ElMessage, ElRadioGroup, ElRadioButton } from 'element-plus'
import mdController from '../service/md.js'
// 狀態
import { state } from '@naturefw/nf-state'
// 獲取當前激活的信息
const current=state.current
// 文檔的加載和保存
const { loadDocById, saveDoc }=mdController()
// 可見的高度
const editHeight=document.documentElement.clientHeight - 200
// 單擊 保存 按鈕，實現保存功能
const mySave=(text, html)=> {
saveDoc(current)
}
// 定時保存
let timeout=null
let isSaved=true
const timeSave=()=> {
if (isSaved) {
// 保存過了，重新計時
isSaved=false
} else {
return // 有計時，退出
}
timeout=setTimeout(()=> {
// 保存文檔
saveDoc(current).then(()=> {
ElMessage({
message: '自動保存文檔成功！',
type: 'success',
})
})
isSaved=true
}, 10000)
}
// 定時保存文檔
watch(()=> current.docInfo.md, ()=> {
timeSave()
})
// 根據激活的菜單項，加載對應的文檔
watch( ()=> current.menuId, async (id)=> {
const ver=current.ver
loadDocById(id, ver).then((res)=> {
// 找到了文檔
Object.assign(current.docInfo, res)
}).catch((res)=> {
// 沒有文檔
Object.assign(current.docInfo, res)
})
})
是不是挺簡單的。
因為是基于Vue3建立的項目，而且也是為了寫vue3相關的幫助文檔，那么就有一個很實用的要求：在線寫代碼并且可以運行。
個人感覺這個功能還是很實用的，我知道有第三方網站提供了這種功能，但是網速有點慢，另外有一種大炮打蚊子的感覺，我只需要實現簡單的代碼演示。
于是我基于 vue 的 defineAsyncComponent 寫了一個簡單版的在線編寫代碼且運行的功能：
/lib/runCode/run.vue
<div style="padding: 5px; border: 1px solid #ccc!important;">
<async-comp></async-comp>
</div> import {
defineAsyncComponent,
ref, reactive,...
// 其他常用的vue內置指令
} from 'vue'
// 使用 eval編譯js代碼
const mysetup=`
(function setup () {
{{code}}
})
`
// 通過屬性傳入需要運行的代碼和模板
const props=defineProps({
code: {
type: Object,
default: ()=> {
return {
js: '',
template: '',
style: ''
}
}
}
})
const code=props.code
// 使用 defineAsyncComponent 讓代碼運行起來
const AsyncComp=defineAsyncComponent(
()=> new Promise((resolve, reject)=> {
resolve({
template: code.template, // 設置模板
style: [code.style], // 大概是樣式設置，但是好像沒啥效果
setup: (props, ctx)=> {
const tmpJs=code.js // 獲取js代碼
let fun=null // 轉換后的函數
try {
if (tmpJs)
fun=eval(mysetup.replace('{{code}}', tmpJs)) // 用 eval 把 字符串 變成 函數
} catch (error) {
console.error('轉換出現異常：', error)
}
const re=typeof fun==='function' ? fun : ()=> {}
return {
...re(props, ctx) // 運行函數，解構返回對象
}
}
})
})
)
實用 defineAsyncComponent 加載組件，需要設置三個部分：模板、setup和style。
這樣即可讓在線編寫的代碼運行起來，當然功能有限，只能用于一些簡單的代碼演示。
以上這些功能都是基于 indexedDB 進行的，想要發布的話，需要先導出為json文件。
因為瀏覽器里不能直接寫文件，所以需要使用折中的方式：
這個簡單，用文本域顯示json即可。
使用 chrome 瀏覽器提供的下載功能下載文件。
const uri='data:text/json;charset=utf-8,\ufeff' + encodeURIComponent(show.navi)
//通過創建a標簽實現
var link=document.createElement("a")
link.href=uri
//對下載的文件命名
link.download=fileName
document.body.appendChild(link)
link.click()
document.body.removeChild(link)
以上介紹的是內部原理，如果只是想簡單使用的話，可以跳過，直接看下面的介紹。
以上兩種都不太方便，于是用node做了個簡單的后端API，用于實現寫入json文件的功能。
代碼放在了 api文件夾里，可以使用 ```yarn api```運行。當然需要在 package.json 里做一下設置。
"scripts": {
"dev": "vite",
"build": "vite build --mode project",
"lib": "vite build --mode lib",
"serve": "vite preview",
"api": "node api/server.js"
},上面介紹的是庫項目的基本原理，我們要做幫助文檔的時候，并不需要那么復雜。
使用 vite2 建立一個vue3的項目，然后安裝 @naturefw/press-edit，使用提供的組件即可方便的實現。
首先需要在 main.js 里面做一些設置。
import { createApp } from 'vue'
import App from './App.vue'
// 設置 axios 的 baseUrl
const baseUrl=(document.location.host.includes('.gitee.io')) ?
'/doc-ui-core/' : '/'
// 輕量級狀態
// 設置 indexedDB 數據庫，存放文檔的各種信息。
import { setupIndexedDB, setupStore } from '@naturefw/press-edit'
// 初始化 indexedDB 數據庫
setupIndexedDB(baseUrl)
// UI庫
import ElementPlus from 'element-plus'
// import 'element-plus/lib/theme-chalk/index.css'
// import 'dayjs/locale/zh-cn'
import zhCn from 'element-plus/es/locale/lang/zh-cn'
// 二次封裝
import { nfElementPlus } from '@naturefw/ui-elp'
// 設置icon
import installIcon from './icon/index.js'
// 設置 Markdown 的配置函數
import setMarkDown from './main-md.js'
// 主題
import vuepressTheme from '@kangc/v-md-editor/lib/theme/vuepress.js'
const {
VueMarkdownEditor, // Markdown 的編輯器
VMdPreview // Markdown 的瀏覽器
}=setMarkDown(vuepressTheme)
const app=createApp(App)
app.config.globalProperties.$ELEMENT={
locale: zhCn,
size: 'small'
}
app.use(setupStore) // 狀態管理
.use(nfElementPlus) // 二次封裝的組件
.use(installIcon) // 注冊全局圖標
.use(ElementPlus, { locale: zhCn, size: 'small' }) // UI庫
.use(VueMarkdownEditor) // markDown編輯器
.use(VMdPreview) // markDown 顯示
.mount('#app')
因為 v-md-editor 相關設置比較多，所以設置了一個單獨文件進行管理：
/src/main-md.js
// Markdown 編輯器
import VueMarkdownEditor from '@kangc/v-md-editor'
import '@kangc/v-md-editor/lib/style/base-editor.css'
// 在這里引入，不被識別？
// import vuepressTheme from '@kangc/v-md-editor/lib/theme/vuepress.js'
import '@kangc/v-md-editor/lib/theme/style/vuepress.css'
// 代碼高亮
import Prism from 'prismjs'
// emoji
import createEmojiPlugin from '@kangc/v-md-editor/lib/plugins/emoji/index'
import '@kangc/v-md-editor/lib/plugins/emoji/emoji.css'
// 流程圖
// import createMermaidPlugin from '@kangc/v-md-editor/lib/plugins/mermaid/cdn'
// import '@kangc/v-md-editor/lib/plugins/mermaid/mermaid.css'
// todoList
import createTodoListPlugin from '@kangc/v-md-editor/lib/plugins/todo-list/index'
import '@kangc/v-md-editor/lib/plugins/todo-list/todo-list.css'
// 代碼行號
import createLineNumbertPlugin from '@kangc/v-md-editor/lib/plugins/line-number/index';
// 高亮代碼行
import createHighlightLinesPlugin from '@kangc/v-md-editor/lib/plugins/highlight-lines/index'
import '@kangc/v-md-editor/lib/plugins/highlight-lines/highlight-lines.css'
// 復制代碼
import createCopyCodePlugin from '@kangc/v-md-editor/lib/plugins/copy-code/index'
import '@kangc/v-md-editor/lib/plugins/copy-code/copy-code.css'
// markdown 顯示器
import VMdPreview from '@kangc/v-md-editor/lib/preview'
// import '@kangc/v-md-editor/lib/style/preview.css'
/**
* 設置 Markdown 編輯器 和瀏覽器
* @param {*} vuepressTheme
* @returns
*/
export default function setMarkDown (vuepressTheme) {
// 設置 vuePress 主題
VueMarkdownEditor.use(vuepressTheme,
{
Prism,
extend(md) {
// md為 markdown-it 實例，可以在此處進行修改配置,并使用 plugin 進行語法擴展
// md.set(option).use(plugin);
},
}
)
// 預覽
VMdPreview.use(vuepressTheme,
{
Prism,
extend(md) {
// md為 markdown-it 實例，可以在此處進行修改配置,并使用 plugin 進行語法擴展
// md.set(option).use(plugin);
},
}
)
// emoji
VueMarkdownEditor.use(createEmojiPlugin())
// 流程圖
// VueMarkdownEditor.use(createMermaidPlugin())
// todoList
VueMarkdownEditor.use(createTodoListPlugin())
// 代碼行號
VueMarkdownEditor.use(createLineNumbertPlugin())
// 高亮代碼行
VueMarkdownEditor.use(createHighlightLinesPlugin())
// 復制代碼
VueMarkdownEditor.use(createCopyCodePlugin())
// 預覽的插件
VMdPreview.use(createEmojiPlugin())
VMdPreview.use(createTodoListPlugin())
VMdPreview.use(createLineNumbertPlugin())
VMdPreview.use(createHighlightLinesPlugin())
VMdPreview.use(createCopyCodePlugin())
return {
VueMarkdownEditor,
VMdPreview
}
}
不多介紹了，可以根據需要選擇插件。
在App.vue文件里面進行整體布局
<el-container>
<el-header>
<!--導航-->
<div style="float: left;">
<!--寫網站logo、標題等-->
<h1>nf-press</h1>
</div>
<div style="float: right;min-width: 100px;height: 60px;padding-top: 13px;">
<!--寫網站logo、標題等-->
<el-switch v-model="$state.current.isView" v-bind="itemProps"></el-switch>
</div>
<div style="float: right;min-width: 600px;height: 60px;">
<!--網站導航-->
<doc-navi ></doc-navi>
</div>
</el-header>
<el-container>
<!--左側邊欄-->
<el-aside width="330px">
<!--菜單-->
<doc-menu ></doc-menu>
</el-aside>
<el-main>
<!--文檔區域-->
<component
:is="docControl[$state.current.isView]"
/>
</el-main>
</el-container>
</el-container> import { reactive, defineAsyncComponent } from 'vue'
import { ElHeader, ElContainer ,ElAside, ElMain } from 'element-plus'
import { docMenu, docNavi, config } from '@naturefw/press-edit' // 菜單 導航
import docView from './views/doc.vue' // 顯示文檔
// 加載菜單子控件
const docControl={
true: docView,
false: defineAsyncComponent(()=> import('./views/main.vue')) // 修改文檔
}
const itemProps=reactive({
'inline-prompt': true,
'active-text': '看',
'inactive-text': '寫',
'active-color': '#378FEB',
'inactive-color': '#EA9712'
})
這種方式雖然有點麻煩，但是比較靈活，可以根據需要進行各種靈活設置，比如添加版權信息、備案信息、廣告等內容。
直接使用組件實現，比較簡單不搬運了，直接看源碼即可。
需要打包的情況分為兩種：第一次打包、修改代碼（非在線編輯的代碼）后打包。
如果只是文檔內容有變化的話，只需要直接上傳json文件即可，不需要再次打包。
內置了一個簡單的版本管理功能，可以通過 ver.json文件里的版本號實現更新功能。
要
GroupBox 控件用于為其他控件提供可識別的分組。 通常，可使用分組框按功能細分窗體。 例如，你可能有一個指定了郵件選項的訂單窗體，例如指定使用哪家夜間運營商。 對分組框中的所有選項進行分組可為用戶提供邏輯視覺提示。 GroupBox 控件類似于 Panel 控件；但只有 GroupBox 控件才可顯示標題，而只有 Panel 控件可以擁有滾動條。
正文
顯示 GroupBox 一組包含或不帶標題的控件周圍的框架。 使用 a GroupBox 在邏輯上對窗體上的控件集合進行分組。 組框是一個容器控件，可用于定義控件組。
組框的典型用途是包含一組 RadioButton 邏輯控件。 如果有兩個組框，其中每個框包含多個選項按鈕 (也稱為單選按鈕) ，每個按鈕組互斥，每個組設置一個選項值。
設計界面
這個控件就有一個屬性常用
private void FrmMain_Load(object sender, EventArgs e)
{
this.grpMain.Text="系統登錄";
}Radio在GroupBox布局
*請認真填寫需求信息，我們會在24小時內與您取得聯系。
